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 已实现并通过测试(约 122 个测试函数)。本文档保留作为历史参考。
## Context
后端当前是一个骨架:`main.go` 启动 Gin 服务器,`ws/handler.go` 实现了 WebSocket 连接生命周期和消息分发,`models/models.go` 定义了所有协议消息类型,`config/config.go` 实现了 Viper 配置加载。但所有业务逻辑都是 TODO 桩——没有 Session Manager、没有 AI 服务客户端、没有编排层、没有日志/错误工具、没有测试。前端已基本完成,正在等待后端提供真实的 AI 管道。
@@ -10,7 +12,7 @@
## 分阶段实施
### Phase 1基础设施logger、errors、config 接入、graceful shutdown
### Phase 1基础设施logger、errors、config 接入、graceful shutdown
**目标**:为后续模块提供日志、错误码、配置等基础能力,替换 `main.go` 中的硬编码值。
@@ -26,7 +28,7 @@
---
### Phase 2Session Manager
### Phase 2Session Manager
**目标**:实现会话生命周期管理,让 WS handler 能追踪会话、存储对话历史。
@@ -40,7 +42,7 @@
---
### Phase 3AI 服务层接口 + 实现
### Phase 3AI 服务层接口 + 实现
**目标**:定义并实现三个 AI 服务客户端,每个服务一个独立包。
@@ -62,7 +64,7 @@
---
### Phase 4AI Orchestrator核心编排
### Phase 4AI Orchestrator核心编排
**目标**:实现 STT → LLM → TTS 流式并行管道,这是后端最关键的业务逻辑。
@@ -78,7 +80,7 @@
---
### Phase 5WS Handler 完整接入
### Phase 5WS Handler 完整接入
**目标**:将 Session Manager + Orchestrator 串入 WebSocket handler实现端到端消息处理。
@@ -92,7 +94,7 @@
---
### Phase 6REST API 补全
### Phase 6REST API 补全
**目标**:补全设计文档中的 REST 端点。
@@ -104,7 +106,7 @@
---
### Phase 7Rate Limiter + Model Router可选/MVP 后)
### Phase 7Rate Limiter + Model Router可选/MVP 后) 📋
**目标**:防止滥用 + 智能模型选择MVP 可简化或跳过。
@@ -116,7 +118,7 @@
---
### Phase 8集成测试 + 文档同步
### Phase 8集成测试 + 文档同步
| # | 任务 | 文件 | 说明 |
|---|------|------|------|