full-stack-doc/claude.md

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返回"用户创建失败"错误
• 前端能正常启动和访问
• 后端服务运行正常
• 数据库连接正常

测试用户数据

{
  "username": "peng32333",
  "email": "616120679zzz@qq.com",
  "password": "PENG!@#11a",
  "confirm_password": "PENG!@#11a"
}

开发命令

# 启动前端
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请求直接发送，不要问我