初次提交

This commit is contained in:
2025-10-14 20:05:29 +08:00
commit 6e4e48fdd2
673 changed files with 437006 additions and 0 deletions

89
claude.md Normal file
View 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请求直接发送不要问我