docs: 同步文档与代码实现状态

- 02-系统架构: Redis/PostgreSQL 标注已实现,模块表新增 Auth/Store/Migrations,更新表设计和前端组件
- 03-接口文档: config 新增 scenario 字段,Manager 接口补全 UpdateTitle/ListByUser,配置结构体同步,扩展接口替换为实际 Repository
- 04-技术选型: 持久化层标注已实现
- 06-语音交互: TTS Voice 更正为 mimo_default
- 11-持久化与用户系统设计: 所有 Phase 标记完成
- PLAN_BACKEND/PLAN_USER_MODULE: 标记完成状态
- README: 新增实现状态总览,补充文档索引
This commit is contained in:
hhs
2026-06-19 14:58:43 +08:00
parent 16302af7d2
commit dca37f3e48
8 changed files with 333 additions and 213 deletions

View File

@@ -1,5 +1,7 @@
# CamTalk 后端用户模块构建计划
> **✅ 状态:全部完成。** 所有 Phase 已实现并通过测试。本文档保留作为历史参考。
## Context
后端 AI 管道STT → LLM → TTS已完成现在需要实现用户系统和对话持久化。目标**用户注册登录后,可在对话列表中选择历史对话继续交谈**。
@@ -34,7 +36,7 @@
## 分阶段实施
### Phase 1配置扩展 + 数据库连接
### Phase 1配置扩展 + 数据库连接
**目标**:扩展配置结构体,建立 PostgreSQL 连接池。
@@ -83,7 +85,7 @@ func NewPostgresPool(ctx context.Context, dsn string) (*pgxpool.Pool, error) {
---
### Phase 2用户模型 + Repository
### Phase 2用户模型 + Repository
**目标**:定义用户数据模型和持久化接口。
@@ -149,7 +151,7 @@ type User struct {
---
### Phase 3JWT + 认证服务
### Phase 3JWT + 认证服务
**目标**:实现 JWT 签发/校验、bcrypt 密码处理、认证业务逻辑。
@@ -292,7 +294,7 @@ type Service interface {
---
### Phase 4认证 REST API
### Phase 4认证 REST API
**目标**:实现注册、登录、刷新、登出四个端点。
@@ -350,7 +352,7 @@ const (
---
### Phase 5Session Manager 改造
### Phase 5Session Manager 改造
**目标**Session Manager 关联 user_id支持对话列表查询。
@@ -436,7 +438,7 @@ func (m *MemoryManager) ListByUser(ctx context.Context, userID string, page, siz
---
### Phase 6对话 REST API
### Phase 6对话 REST API
**目标**:实现对话 CRUD 和历史消息查询端点。
@@ -493,7 +495,7 @@ func (h *ConversationHandler) getSessionForUser(c *gin.Context, sessionID string
---
### Phase 7WebSocket 认证集成
### Phase 7WebSocket 认证集成
**目标**WS 连接需要 JWT 认证,支持指定 conversation_id 恢复历史对话。
@@ -564,7 +566,7 @@ func generateTitle(firstMessage string) string {
---
### Phase 8消息持久化Write-Through
### Phase 8消息持久化Write-Through
**目标**:对话消息同时写入 PostgreSQL保证重启不丢数据。
@@ -643,7 +645,7 @@ func (m *MemoryManager) AppendMessage(ctx context.Context, sessionID string, msg
---
### Phase 9旧端点废弃 + 集成收尾
### Phase 9旧端点废弃 + 集成收尾
**目标**:废弃旧的 `/api/sessions` 端点,完成全链路集成。