From cba24349cb7c39c529bdda0a5ea0d32bf9e849ea Mon Sep 17 00:00:00 2001 From: wonder Date: Sun, 24 May 2026 13:34:44 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20API=20=E4=B8=8E?= =?UTF-8?q?=E5=90=8E=E7=AB=AF=E6=96=87=E6=A1=A3=EF=BC=8C=E5=AF=B9=E9=BD=90?= =?UTF-8?q?=E5=B7=B2=E5=AE=9E=E7=8E=B0=E5=8A=9F=E8=83=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - api.md: 标记 register/login 接口为已完成（handler + User model） - backend.md: 分层结构标注已有文件，与实际代码对齐 --- docs/api.md | 4 ++-- docs/backend.md | 18 ++++++++++-------- 2 files changed, 12 insertions(+), 10 deletions(-) diff --git a/docs/api.md b/docs/api.md index 9a77646..85f447d 100644 --- a/docs/api.md +++ b/docs/api.md @@ -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` | 修改密码 | diff --git a/docs/backend.md b/docs/backend.md index 104b562..fb039c7 100644 --- a/docs/backend.md +++ b/docs/backend.md @@ -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/ # 中间件