89 lines
2.4 KiB
Markdown
89 lines
2.4 KiB
Markdown
# 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请求直接发送，不要问我 |