docs: 更新 API 与后端文档,对齐已实现功能

- api.md: 标记 register/login 接口为已完成(handler + User model)
- backend.md: 分层结构标注已有文件,与实际代码对齐
This commit is contained in:
2026-05-24 13:34:44 +08:00
parent afb33d4d5d
commit cba24349cb
2 changed files with 12 additions and 10 deletions
+2 -2
View File
@@ -59,8 +59,8 @@ Token 过期或无效时返回:
| 状态 | 方法 | 路径 | 说明 |
|------|------|------|------|
| [ ] | POST | `/api/v1/auth/register` | 用户注册 |
| [ ] | POST | `/api/v1/auth/login` | 用户登录 |
| [x] | POST | `/api/v1/auth/register` | 用户注册 |
| [x] | POST | `/api/v1/auth/login` | 用户登录 |
| [ ] | GET | `/api/v1/auth/me` | 获取当前用户信息 |
| [ ] | PUT | `/api/v1/auth/password` | 修改密码 |
+10 -8
View File
@@ -11,21 +11,23 @@
```
backend/internal/
├── handler/ # HTTP handlers(薄层,只做参数绑定 + 调用 service)
│ ├── auth.go # 用户注册 / 登录 / 当前用户 / 修改密码
│ ├── health.go # [已有] 健康检查
│ ├── register.go # [已有] 用户注册(handler 骨架 + 参数校验)
│ ├── login.go # [已有] 用户登录(handler 骨架 + 参数校验)
│ ├── project.go # 工程 CRUD + 任务列表
│ ├── generate.go # 生成任务提交 / 查询 / WebSocket
│ ├── project_style.go # 工程风格 CRUD
│ └── health.go # [已有] 健康检查
│ └── project_style.go # 工程风格 CRUD
├── service/ # 业务逻辑层
│ ├── pipeline.go # [已有] Eino compose.Graph 编排:PromptBuilder → AssetGenerator → QualitySupervisor → FormatAdapter
│ ├── nodes.go # [已有] 管线四个节点的实现(每个节点单一职责)
│ ├── types.go # [已有] 管线输入/状态/输出的显式结构体定义
│ ├── inference.go # [已有] AI 推理 API 调用封装(当前为 mock 实现)
│ ├── pipeline_test.go # [已有] 管线测试(happy path / 重试 / 降级 / 风格合并)
│ ├── auth.go # 用户认证:注册、登录、JWT 签发与校验
│ ├── pipeline.go # Eino compose.Graph 编排:PromptBuilder → AssetGenerator → QualitySupervisor → FormatAdapter
│ ├── nodes.go # 管线四个节点的实现(每个节点单一职责)
│ ├── types.go # 管线输入/状态/输出的显式结构体定义
│ ├── inference.go # AI 推理 API 调用封装(Eino model 组件)
│ └── project_style.go # 工程风格管理 & 风格合并逻辑
├── model/ # 数据模型 / DTO
│ ├── response.go # [已有] 统一响应
│ ├── user.go # 用户模型
│ ├── user.go # [已有] 用户模型
│ ├── task.go # 生成任务 & 素材
│ └── style.go # 工程风格 & 任务风格覆盖
├── middleware/ # 中间件