初次提交
This commit is contained in:
89
claude.md
Normal file
89
claude.md
Normal file
@@ -0,0 +1,89 @@
|
||||
# Claude Code 配置文件
|
||||
|
||||
## 项目背景
|
||||
这是一个全栈云盘应用项目,包含 React 前端和 FastAPI 后端。
|
||||
|
||||
## 开发环境
|
||||
- 前端:React + TypeScript + Vite,运行在 http://localhost:3003
|
||||
- 后端:FastAPI + SQLAlchemy + MySQL,运行在 http://localhost:8000
|
||||
- 数据库:MySQL (mytest_db@101.126.85.76:3306)
|
||||
|
||||
## 主要功能模块
|
||||
1. **用户认证系统**:注册、登录、JWT令牌管理
|
||||
2. **文件管理系统**:文件上传、下载、列表展示、删除
|
||||
3. **云存储界面**:基于原型的现代化UI设计
|
||||
|
||||
## 核心技术栈
|
||||
- 前端:React、TypeScript、Tailwind CSS、Lucide Icons
|
||||
- 后端:FastAPI、SQLAlchemy、Pydantic、JWT认证
|
||||
- 数据库:MySQL、Redis(可选)
|
||||
|
||||
## 开发指导原则
|
||||
|
||||
### 1. 代码风格
|
||||
- 使用中文注释和变量名(适当时)
|
||||
- 遵循 RESTful API 设计原则
|
||||
- 保持代码简洁、可读性高
|
||||
- 使用 TypeScript 严格类型检查
|
||||
|
||||
### 2. 错误处理
|
||||
- 前端使用统一的错误处理机制
|
||||
- 后端使用结构化的错误响应格式
|
||||
- 所有API调用都要有适当的错误处理
|
||||
|
||||
### 3. 安全考虑
|
||||
- 所有API端点需要适当的认证
|
||||
- 密码加密存储
|
||||
- 输入验证和清理
|
||||
- CORS配置正确
|
||||
|
||||
### 4. 性能优化
|
||||
- 前端组件懒加载
|
||||
- API响应适当缓存
|
||||
- 数据库查询优化
|
||||
- 文件上传进度显示
|
||||
|
||||
## 当前问题状态
|
||||
- 注册API返回"用户创建失败"错误
|
||||
- 前端能正常启动和访问
|
||||
- 后端服务运行正常
|
||||
- 数据库连接正常
|
||||
|
||||
## 测试用户数据
|
||||
```json
|
||||
{
|
||||
"username": "peng32333",
|
||||
"email": "616120679zzz@qq.com",
|
||||
"password": "PENG!@#11a",
|
||||
"confirm_password": "PENG!@#11a"
|
||||
}
|
||||
```
|
||||
|
||||
## 开发命令
|
||||
```bash
|
||||
# 启动前端
|
||||
cd frontend && npm run dev
|
||||
|
||||
# 启动后端
|
||||
cd backend && python main.py
|
||||
|
||||
# 测试API
|
||||
curl -X POST "http://localhost:8000/api/v1/auth/register" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"username":"test","email":"test@example.com","password":"Test123!","confirm_password":"Test123!"}'
|
||||
```
|
||||
|
||||
## 调试指南
|
||||
1. 检查前后端日志输出
|
||||
2. 使用浏览器开发者工具查看网络请求
|
||||
3. 验证数据库连接和表结构
|
||||
4. 检查CORS配置
|
||||
5. 验证JWT令牌生成和验证
|
||||
|
||||
## 注意事项
|
||||
- 保持开发环境的数据库和Redis服务运行
|
||||
- 修改代码后注意热重载是否正常工作
|
||||
- 定期检查依赖包版本更新
|
||||
- 保持代码仓库干净,及时提交重要更改
|
||||
- 全部用中文回答
|
||||
- 执行测试、发送curl请求直接发送,不要问我
|
||||
Reference in New Issue
Block a user