feat: 构建用户模块，实现用户对话历史持久化，完善接口文档 #96

huanghaosheng · 2026-06-14T18:08:10+08:00

huanghaosheng commented

2026-06-14 18:08:10 +08:00

No description provided.

huanghaosheng added 20 commits 2026-06-14 18:08:10 +08:00

feat: 新增认证相关错误码（USERNAME_TAKEN, INVALID_CREDENTIALS, INVALID_TOKEN, INVALID_INPUT） fdea3aa9d1

feat: 实现 AuthHandler（注册/登录/刷新/登出端点 + 输入校验 + 路由注册） 15b437043f

feat: main.go 接入认证服务（TokenManager + AuthService + AuthHandler 路由注册） 9aaed88cc1

feat: 编写 AuthHandler API 测试（httptest + mock AuthService，覆盖全部端点） c01ee1d14c

feat: 扩展 Session 模型，新增 UserID、Title、UpdatedAt 字段 9ff971fd89

feat: 扩展 Session Manager 接口，新增 ListByUser、UpdateTitle 方法 6487a8ecab

- Manager.Create 签名新增 userID 参数
- 新增 ConversationSummary 类型和 ListByUser 分页查询
- 新增 UpdateTitle 方法
- MemoryManager 实现：ListByUser 遍历+过滤+排序，UpdateTitle，自动标题生成
- RedisManager 实现：user:{id}:sessions 索引，ListByUser 通过 SMEMBERS 查询
- AppendMessage 自动更新标题（首条 user 消息时，取前 20 字符）
- 更新 ws handler、api/session.go、orchestrator mock 的 Create 调用

feat: 编写 Session Manager 新方法测试（ListByUser 分页、UpdateTitle、自动标题生成） ec8555d44b

feat: 实现 ConversationHandler（对话 CRUD + 消息查询 + 权限校验 + 路由注册） 62baa656ee

- List: GET /api/conversations 获取当前用户对话列表（分页）
- Create: POST /api/conversations 创建新对话
- Get: GET /api/conversations/:id 获取对话详情
- UpdateTitle: PATCH /api/conversations/:id 更新对话标题
- Delete: DELETE /api/conversations/:id 删除对话
- GetMessages: GET /api/conversations/:id/messages 获取消息列表
- 所有端点通过 AuthMiddleware 认证
- getSessionForUser 校验 session.UserID == claims.UserID
- 返回 404 而非 403 避免信息泄露

feat: main.go 接入 ConversationHandler 路由注册 f902e05e31

feat: 编写 ConversationHandler API 测试（httptest + mock SessionManager） d01aeaba68

- List: 成功、分页参数、未认证 401
- Create: 成功、自定义配置
- Get: 成功、404 未找到、404 权限不足（隐藏信息）
- UpdateTitle: 成功、空标题校验、超长标题校验
- Delete: 成功、权限不足
- GetMessages: 成功、limit 分页、before 偏移分页、权限不足
- 共 17 个 Conversation 测试用例，全部通过

feat: Phase 7.1 — 修改 ServeWS 签名，新增 tokenMgr 参数 2aa3c98ab6

- ServeWS 和 serveWS 函数新增 *auth.TokenManager 参数
- main.go 传入 tokenMgr 到 ServeWS
- handler_test.go 适配新签名

feat: Phase 7.2 — WS 连接 JWT 认证 905b56640e

- 从 ?token=xxx 查询参数提取 access_token
- 校验失败返回 401（missing token / invalid token）
- 校验成功后将 userID 用于创建会话
- 更新现有测试：setupTestServer 自动生成有效 token

feat: Phase 7.3 — WS conversation_id 处理 80c6b1b56e

- ?conversation_id=xxx 存在时校验 session 归属（UserID 匹配）
- 校验失败返回 401 SESSION_NOT_FOUND
- 校验通过则复用已有 session；否则创建新 session

feat: Phase 7.7 — 编写 WS 认证测试 3c5c4943e8

- TestWS_AuthMissingToken: 无 token 返回 401
- TestWS_AuthInvalidToken: 无效 token 返回 401
- TestWS_AuthExpiredToken: 过期 token 返回 401
- TestWS_AuthValidToken: 有效 token 成功连接
- TestWS_AuthConversationIDResume: conversation_id 恢复已有对话
- TestWS_AuthConversationIDNotFound: 不存在的 conversation_id 返回 401
- TestWS_AuthConversationIDOwnership: 非 owner 访问返回 401

feat: Phase 8.1 — 定义 MessageRepository 接口和消息表迁移脚本 dae5722945

feat: Phase 8.2 — 实现 PostgreSQL MessageRepository 96f4bc7abb

feat: Phase 8.3 — Session Manager 注入 MessageRepository，AppendMessage 启用 Write-Through f4515ce5e4

feat: Phase 8.4 — 实现 LoadSession 和 LoadSessionFromDB，支持从 PostgreSQL 恢复会话到内存 7b745018c5

feat: Phase 8.5 — ConversationSummary 查询优化，支持 SQL 聚合获取消息统计 c3a32ce276

docs: 补充用户模块 REST API 接口契约 b57adf153b

- PLAN_USER_MODULE.md 新增「前端 API 接口参考」章节
- 03-接口文档.md 同步认证接口、对话接口、WebSocket 认证变更
- 新增错误码 USERNAME_TAKEN / INVALID_CREDENTIALS / INVALID_TOKEN / INVALID_INPUT
- 数据模型补充 User / ConversationSummary / StoredMessage 及对应 TypeScript 类型
- 配置结构体补充 AuthConfig（JWTSecret / AccessTTL / RefreshTTL）

huanghaosheng merged commit a1ae7740f1 into develop

2026-06-14 18:08:14 +08:00

huanghaosheng referenced this issue from a commit

2026-06-14 18:08:15 +08:00

Merge pull request 'feat: 构建用户模块，实现用户对话历史持久化，完善接口文档' (#96) from build/backend into develop

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: XEngineers/CamTalk#96