memory-bank/systemPatterns.md

系统模式 (systemPatterns.md)

系统架构

• 后端框架: FastAPI
• 数据库: SQLite
• API 路由: 使用 APIRouter 进行模块化管理，所有 API 路径前缀为 /api。
• CORS: 使用 CORSMiddleware 处理跨域请求。
• 文件存储: upload/images 目录用于存储上传的图片文件，并通过 /upload 路径提供静态文件服务。

关键技术决策

• 用户 ID 生成: 采用 uuid.uuid4() 生成全局唯一的用户 ID。
• 密码存储: 当前直接存储明文密码（待改进：未来应使用哈希加密存储）。
• 错误处理:
  • 注册时用户名重复：返回 400 Bad Request。
  • 登录时用户名或密码错误：返回自定义业务错误码 401。
  • 其他内部服务器错误：返回 500 Internal Server Error。
• 数据库初始化: 在 FastAPI 应用启动时通过 @app.on_event("startup") 钩子函数初始化 SQLite 数据库和 users 表。

组件关系

• app.py: 包含 FastAPI 应用实例、CORS 配置、数据库初始化逻辑、API 路由定义。
• api_router: 负责定义 /api/auth/register, /api/auth/login, /api/course/add, /api/course/details/{course_id} 等接口。
• sqlite3: 用于与 ai_edu.db 数据库文件进行交互。
• pydantic.BaseModel: 用于定义请求体的模型（RegisterRequest, LoginRequest, Course）。

关键实现路径

• 用户注册: 接收 username 和 password -> 生成 user_id (UUID) -> 插入 users 表 -> 返回成功响应或错误。
• 用户登录: 接收 username 和 password -> 查询 users 表验证凭据 -> 返回成功响应（包含 user_id 和 username）或错误。
• 课程添加: 接收课程详情 (title, description, price, duration_hours, level, page_info) -> 插入 courses 表（page_info 存储为 JSON 字符串） -> 返回成功响应。
• 课程详情查询: 接收 course_id -> 查询 courses 表 -> 返回课程详情（page_info 反序列化为 JSON 对象）或 404 错误。