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