st/docs/重构进度管理.md

云酒馆项目重构进度管理

项目目标：将 web-app 从 Node.js 后端改造为纯前端，所有接口由 Go 后端提供
开始日期：2026-02-10
预计完成：40-58 天
当前状态：阶段三进行中 - 角色卡管理模块已完成（含导入导出功能）

---

📊 总体进度

阶段	进度	状态	开始日期	完成日期
阶段一：数据库设计	100%	🟢 已完成	2026-02-10	2026-02-10
阶段二：Go后端API开发	40%	🔵 进行中	2026-02-10	-
阶段三：Vue3前台开发	45%	🔵 进行中	2026-02-10	-
阶段四：前端改造（旧版）	0%	⚪ 暂停	-	-
阶段五：数据迁移	0%	⚪ 未开始	-	-
阶段六：测试与优化	0%	⚪ 未开始	-	-
阶段七：部署上线	0%	⚪ 未开始	-	-

图例：

• ⚪ 未开始
• 🟡 待开始（已规划）
• 🔵 进行中
• 🟢 已完成
• 🔴 受阻

---

🎯 阶段一：数据库设计（预计 3-5 天）

1.1 环境准备

• T1.1.1 安装 PostgreSQL 14+

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 备注：

• T1.1.2 安装 pgvector 扩展

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.1.1
  • 状态：⚪ 未开始
  • 备注：

• T1.1.3 配置 PostgreSQL 连接

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.1.1
  • 状态：⚪ 未开始
  • 备注：修改 server/config.yaml

• T1.1.4 安装 Redis 7+（可选）

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 备注：

1.2 数据表设计与创建

• T1.2.1 创建前台用户表（app_users）

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.1.2
  • 状态：⚪ 未开始
  • SQL 文件：server/initialize/sql/app_users.sql
  • 验证方式：查询表结构

• T1.2.2 创建用户会话表（app_user_sessions）

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.2.1
  • 状态：⚪ 未开始

• T1.2.3 创建 AI 角色表（ai_characters）

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.2.1
  • 状态：⚪ 未开始

• T1.2.4 创建对话表（ai_chats）

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.2.3
  • 状态：⚪ 未开始

• T1.2.5 创建消息表（ai_messages）

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.2.4
  • 状态：⚪ 未开始

• T1.2.6 创建消息变体表（ai_message_swipes）

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 依赖：T1.2.5
  • 状态：⚪ 未开始

• T1.2.7 创建群聊成员表（ai_chat_members）

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：0.5天
  • 依赖：T1.2.3, T1.2.4
  • 状态：⚪ 未开始

• T1.2.8 创建向量记忆表（ai_memory_vectors）

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 依赖：T1.1.2, T1.2.1
  • 状态：⚪ 未开始
  • 备注：需要 pgvector 扩展

• T1.2.9 创建 AI 提供商配置表（ai_providers）

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.2.1
  • 状态：⚪ 未开始

• T1.2.10 创建 AI 模型配置表（ai_models）

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 依赖：T1.2.9
  • 状态：⚪ 未开始

• T1.2.11 创建文件表（ai_files）

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 依赖：T1.2.1
  • 状态：⚪ 未开始

• T1.2.12 创建预设表（ai_presets）

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：0.5天
  • 依赖：T1.2.1
  • 状态：⚪ 未开始

• T1.2.13 创建世界书表（ai_world_info）

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：0.5天
  • 依赖：T1.2.1
  • 状态：⚪ 未开始

• T1.2.14 创建使用统计表（ai_usage_stats）

  • 负责人：
  • 优先级：P3（可选）
  • 预计时间：0.5天
  • 依赖：T1.2.1
  • 状态：⚪ 未开始

• T1.2.15 创建用户收藏表（app_user_favorite_characters）

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：0.5天
  • 依赖：T1.2.1, T1.2.3
  • 状态：⚪ 未开始

1.3 Gorm 模型创建

• T1.3.1 创建 AppUser 模型

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.2.1
  • 状态：⚪ 未开始
  • 文件：server/model/app/user.go

• T1.3.2 创建 AppUserSession 模型

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.2.2
  • 状态：⚪ 未开始

• T1.3.3 创建 Character 模型

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.2.3
  • 状态：⚪ 未开始
  • 文件：server/model/app/character.go

• T1.3.4 创建 Chat 模型

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.2.4
  • 状态：⚪ 未开始
  • 文件：server/model/app/chat.go

• T1.3.5 创建 Message 模型

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.2.5
  • 状态：⚪ 未开始
  • 文件：server/model/app/message.go

• T1.3.6 创建其他辅助模型（Provider、File、Preset 等）

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始

1.4 数据库初始化

• T1.4.1 编写数据库自动迁移脚本

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.3.*
  • 状态：⚪ 未开始
  • 文件：server/initialize/gorm_app.go

• T1.4.2 测试数据库表创建

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T1.4.1
  • 状态：⚪ 未开始
  • 验证：所有表成功创建，外键关系正确

---

🎯 阶段二：Go 后端 API 开发（预计 15-20 天）

2.1 基础设施搭建

• T2.1.1 安装 Go 依赖包

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 命令：

    go get github.com/sashabaranov/go-openai@latest
    go get github.com/gorilla/websocket@latest
    go get github.com/pgvector/pgvector-go@latest
    go get github.com/pkoukk/tiktoken-go@latest
    

• T2.1.2 创建项目目录结构

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 目录：api/v1/app/, service/app/, router/app/, pkg/

• T2.1.3 配置文件扩展

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：server/config.yaml
  • 内容：AI API Keys、向量数据库配置等

2.2 前台用户认证模块

• T2.2.1 实现前台用户 JWT 中间件（AppJWTAuth）

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：
    • server/middleware/app_jwt.go（中间件）
    • server/utils/app_jwt.go（JWT工具函数）

• T2.2.2 实现用户注册 API

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T2.2.1, T1.3.1
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 接口：POST /app/auth/register
  • 文件：
    • server/api/v1/app/auth.go
    • server/service/app/auth.go
    • server/model/app/request/auth.go

• T2.2.3 实现用户登录 API

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T2.2.1
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 接口：POST /app/auth/login

• T2.2.4 实现用户登出 API

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T2.2.1
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 接口：POST /app/auth/logout

• T2.2.5 实现 Token 刷新 API

  • 负责人：AI助手
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T2.2.1
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 接口：POST /app/auth/refresh

• T2.2.6 实现获取用户信息 API

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T2.2.1
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 接口：GET /app/auth/userinfo

• T2.2.7 实现用户信息更新 API

  • 负责人：AI助手
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 接口：PUT /app/user/profile

• T2.2.8 实现密码修改 API

  • 负责人：AI助手
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 接口：POST /app/user/change-password

2.3 AI 服务集成

• T2.3.1 封装 OpenAI SDK

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 文件：server/pkg/ai/openai.go
  • 功能：对话补全、流式输出、向量嵌入

• T2.3.2 封装 Anthropic SDK（Claude）

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 文件：server/pkg/ai/anthropic.go

• T2.3.3 封装 Google AI SDK（Gemini）

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 文件：server/pkg/ai/google.go

• T2.3.4 实现 AI 服务统一接口

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T2.3.1
  • 状态：⚪ 未开始
  • 文件：server/service/app/ai_service.go

• T2.3.5 实现向量嵌入服务

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T2.3.1
  • 状态：⚪ 未开始
  • 文件：server/service/app/embedding.go

2.4 AI 提供商配置管理

• T2.4.1 实现创建提供商配置 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：POST /app/provider/create

• T2.4.2 实现获取提供商列表 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：GET /app/provider/list

• T2.4.3 实现更新提供商配置 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：PUT /app/provider/:id

• T2.4.4 实现删除提供商配置 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：DELETE /app/provider/:id

• T2.4.5 实现测试提供商连接 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T2.3.1
  • 状态：⚪ 未开始
  • 接口：POST /app/provider/test

• T2.4.6 实现获取可用模型列表 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：GET /app/provider/:id/models

2.5 AI 角色管理

• T2.5.1 实现创建角色 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 接口：POST /app/character/create
  • 文件：
    • server/api/v1/app/character.go
    • server/service/app/character.go

• T2.5.2 实现获取角色列表 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 接口：GET /app/character/list
  • 功能：支持分页、搜索、筛选

• T2.5.3 实现获取角色详情 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：GET /app/character/:id

• T2.5.4 实现更新角色 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 接口：PUT /app/character/:id

• T2.5.5 实现删除角色 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：DELETE /app/character/:id

• T2.5.6 实现导入角色 API（Character Card）

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 接口：POST /app/character/import
  • 功能：解析 PNG、JSON 格式的角色卡片

• T2.5.7 实现导出角色 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 接口：GET /app/character/export/:id

• T2.5.8 实现角色收藏/取消收藏 API

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：POST /app/character/:id/favorite

2.6 对话管理

• T2.6.1 实现创建对话 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 接口：POST /app/chat/create
  • 文件：
    • server/api/v1/app/chat.go
    • server/service/app/chat.go

• T2.6.2 实现获取对话列表 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 接口：GET /app/chat/list
  • 功能：支持分页、筛选、排序

• T2.6.3 实现获取对话详情 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：GET /app/chat/:id

• T2.6.4 实现更新对话 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：PUT /app/chat/:id

• T2.6.5 实现删除对话 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：DELETE /app/chat/:id

• T2.6.6 实现获取对话消息历史 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 接口：GET /app/chat/:id/messages
  • 功能：支持分页、倒序加载

2.7 消息管理与 AI 对话

• T2.7.1 实现发送消息 API（调用 AI）

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：3天
  • 依赖：T2.3.4
  • 状态：⚪ 未开始
  • 接口：POST /app/chat/:id/send
  • 功能：
    • 调用 AI API
    • 保存用户消息和 AI 回复
    • 支持流式输出
    • Token 计数

• T2.7.2 实现流式消息推送（SSE）

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：2天
  • 依赖：T2.7.1
  • 状态：⚪ 未开始
  • 接口：GET /app/chat/:id/stream

• T2.7.3 实现重新生成消息 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T2.7.1
  • 状态：⚪ 未开始
  • 接口：POST /app/chat/:id/regenerate/:messageId

• T2.7.4 实现编辑消息 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 接口：PUT /app/chat/:id/message/:messageId

• T2.7.5 实现删除消息 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：DELETE /app/chat/:id/message/:messageId

• T2.7.6 实现消息变体（Swipe）功能

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 接口：
    • POST /app/chat/:id/message/:messageId/swipe（创建变体）
    • GET /app/chat/:id/message/:messageId/swipes（获取所有变体）
    • PUT /app/chat/:id/message/:messageId/swipe/:swipeId（切换变体）

2.8 向量记忆管理

• T2.8.1 实现创建记忆 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：2天
  • 依赖：T2.3.5
  • 状态：⚪ 未开始
  • 接口：POST /app/memory/create
  • 功能：自动生成向量嵌入

• T2.8.2 实现搜索相似记忆 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：2天
  • 依赖：T2.8.1
  • 状态：⚪ 未开始
  • 接口：POST /app/memory/search
  • 功能：向量相似度搜索

• T2.8.3 实现获取记忆列表 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：GET /app/memory/list

• T2.8.4 实现删除记忆 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：DELETE /app/memory/:id

• T2.8.5 对话时自动检索相关记忆

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T2.7.1, T2.8.2
  • 状态：⚪ 未开始
  • 集成到发送消息流程

2.9 文件管理

• T2.9.1 实现文件上传 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 接口：POST /app/file/upload
  • 功能：支持本地存储和对象存储

• T2.9.2 实现文件列表 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：GET /app/file/list

• T2.9.3 实现文件删除 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 接口：DELETE /app/file/:id

• T2.9.4 实现头像上传专用接口

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 接口：POST /app/file/upload/avatar

2.10 WebSocket 实时通信

• T2.10.1 实现 WebSocket Hub

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 文件：server/pkg/websocket/hub.go

• T2.10.2 实现 WebSocket 连接认证

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T2.10.1, T2.2.1
  • 状态：⚪ 未开始

• T2.10.3 实现消息推送功能

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T2.10.1
  • 状态：⚪ 未开始
  • 功能：AI 回复实时推送

• T2.10.4 实现心跳检测和断线重连

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T2.10.1
  • 状态：⚪ 未开始

2.11 路由注册

• T2.11.1 注册认证路由

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：server/router/app/auth.go

• T2.11.2 注册角色路由

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：server/router/app/character.go

• T2.11.3 注册对话路由

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：server/router/app/chat.go

• T2.11.4 注册其他路由（Provider、File、Memory 等）

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T2.11.5 集成到主路由

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T2.11.1-4
  • 状态：⚪ 未开始
  • 文件：server/initialize/router.go

2.12 Swagger 文档

• T2.12.1 为所有 API 添加 Swagger 注释

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：2天
  • 状态：⚪ 未开始

• T2.12.2 生成 Swagger 文档

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：0.5天
  • 依赖：T2.12.1
  • 状态：⚪ 未开始
  • 命令：swag init

---

🎯 阶段三：Vue 3 前台开发（预计 15-20 天）

重要决策：使用 Vue 3 + TypeScript 重构前台，而非改造旧的 jQuery 代码
原因：旧代码过于混乱（index.html 7978行，226+ JS文件），维护成本极高
优势：与管理后台技术统一，易于维护，性能更好

3.1 Vue 项目初始化

• T3.1.1 创建 Vue 3 + TypeScript 项目

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 技术栈：Vue 3 + Vite + TypeScript + Element Plus
  • 项目目录：web-app-vue/

• T3.1.2 配置项目基础设施

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 内容：
    • Vite 配置（代理、别名、插件）
    • TypeScript 配置
    • Element Plus 自动导入
    • Pinia + Vue Router 配置

• T3.1.3 创建项目目录结构

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 目录：api/, stores/, types/, utils/, layouts/, views/, composables/

3.2 Vue 认证模块开发

• T3.2.1 创建 TypeScript 类型定义

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：
    • src/types/user.d.ts（用户、登录、注册类型）
    • src/types/api.d.ts（API响应类型）

• T3.2.2 封装 HTTP 请求工具

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：src/utils/request.ts
  • 功能：请求拦截、响应拦截、自动添加Token、统一错误处理

• T3.2.3 创建认证 API 接口

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：src/api/auth.ts
  • 接口：login, register, logout, getUserInfo, refreshToken

• T3.2.4 创建认证状态管理（Pinia）

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：src/stores/auth.ts
  • 功能：登录、注册、登出、Token管理、用户信息管理

• T3.2.5 创建认证布局组件

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：src/layouts/AuthLayout.vue
  • 特性：渐变背景动画、居中布局、响应式设计

• T3.2.6 创建默认布局组件

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：src/layouts/DefaultLayout.vue
  • 特性：顶部导航、用户菜单、主内容区

• T3.2.7 开发登录页面

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：src/views/auth/Login.vue
  • 功能：用户名密码登录、表单验证、回车登录

• T3.2.8 开发注册页面

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：src/views/auth/Register.vue
  • 功能：用户注册、确认密码、邮箱验证、表单验证

• T3.2.9 配置路由和路由守卫

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：src/router/index.ts
  • 功能：路由配置、认证守卫、自动跳转、页面标题

• T3.2.10 开发首页

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：src/views/home/Index.vue
  • 功能：欢迎信息、用户统计、快捷入口

3.3 Vue 角色管理模块

• T3.3.1 完善 AICharacter 数据模型

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 添加字段：totalChats, totalLikes, isPublic, creatorName 等

• T3.3.2 创建角色卡请求/响应结构体

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：server/model/app/request/character.go, response/character.go

• T3.3.3 创建角色卡 Service 层

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：2天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：server/service/app/character.go
  • 功能：CRUD、收藏、点赞、导入导出

• T3.3.4 创建角色卡 API 层

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：server/api/v1/app/character.go
  • 包含公开接口和需鉴权接口

• T3.3.5 创建角色卡路由

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：server/router/app/character.go

• T3.3.6 创建 Vue 角色卡类型定义

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：web-app-vue/src/types/character.d.ts

• T3.3.7 创建 Vue 角色卡 API 接口

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：web-app-vue/src/api/character.ts

• T3.3.8 创建 Vue 角色卡状态管理

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：web-app-vue/src/stores/character.ts

• T3.3.9 开发首页角色列表（瀑布流）

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：2天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：web-app-vue/src/views/home/CharacterList.vue
  • 特性：瀑布流布局、搜索、排序、收藏、点赞

• T3.3.10 开发角色详情页面

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：1.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：web-app-vue/src/views/character/Detail.vue
  • 功能：详情展示、编辑、删除、导出

• T3.3.11 开发"我的角色卡"页面

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：web-app-vue/src/views/character/MyCharacters.vue

• T3.3.12 开发角色卡编辑页面

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：2天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 文件：web-app-vue/src/views/character/Edit.vue
  • 功能：创建、编辑、表单验证

• T3.3.13 更新路由配置

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 添加角色卡相关路由

• T3.3.14 更新导航布局

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 添加主导航菜单、登录/注册按钮

• T3.3.15 实现角色卡导入导出功能

  • 负责人：AI助手
  • 优先级：P0（必须）
  • 预计时间：2天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 功能：
    • 支持 PNG 和 JSON 格式导入
    • 支持导出为 PNG（含嵌入数据）和 JSON
    • 兼容 SillyTavern CharacterCard V2 规范
    • 自动从 PNG 提取 tEXt chunk

• T3.3.16 优化 Token 有效期

  • 负责人：AI助手
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 修改：Token 有效期从配置文件控制改为固定 7 天

• T3.3.17 修复头像显示问题

  • 负责人：AI助手
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：🟢 已完成
  • 完成日期：2026-02-10
  • 优化：无头像时显示首字母占位符，不再请求不存在的文件

3.4 Vue 对话功能模块（待开发）

• T3.4.1 创建对话类型定义

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：src/types/chat.d.ts

• T3.4.2 创建对话 API 接口

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 文件：src/api/chat.ts

• T3.4.3 创建对话状态管理

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 文件：src/stores/chat.ts

• T3.4.4 封装 WebSocket 工具

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 文件：src/utils/websocket.ts

• T3.4.5 开发对话主界面

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：3天
  • 状态：⚪ 未开始
  • 文件：src/views/chat/Index.vue

• T3.4.6 开发消息组件

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 文件：src/components/chat/ChatMessage.vue

• T3.4.7 开发消息输入组件

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 文件：src/components/chat/ChatInput.vue

• T3.4.8 实现 Swipe 功能

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始

3.5 Vue 设置和其他页面（待开发）

• T3.5.1 开发设置页面

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 文件：src/views/settings/Index.vue

• T3.5.2 开发用户中心页面

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 文件：src/views/user/Profile.vue

---

🎯 阶段四：前端改造（旧版 jQuery）（暂停）

已决定：不再改造旧版 web-app，直接使用 Vue 3 重构
状态：本阶段暂停，优先完成阶段三（Vue 版本）

3.1 web-app 前端改造准备

• T3.1.1 备份原有 web-app 项目

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 备份位置：web-app-backup/

• T3.1.2 分析现有前端代码结构

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 输出：前端功能清单

• T3.1.3 规划前端目录结构

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

3.2 移除 Node.js 后端

• T3.2.1 删除 server.js 和后端相关文件

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 删除文件：
    • server.js
    • src/ 目录（所有后端代码）
    • webpack.config.js（如不需要）

• T3.2.2 保留必要的前端文件

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 保留：public/ 目录下所有文件

3.3 API 客户端封装

• T3.3.1 创建 HTTP 客户端基类

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 文件：public/scripts/api/client.js
  • 功能：
    • 统一的请求/响应处理
    • Token 管理
    • 错误处理

• T3.3.2 封装认证相关 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T3.3.1
  • 状态：⚪ 未开始
  • 文件：public/scripts/api/auth.js
  • 接口：注册、登录、登出、刷新Token

• T3.3.3 封装角色管理 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T3.3.1
  • 状态：⚪ 未开始
  • 文件：public/scripts/api/character.js

• T3.3.4 封装对话管理 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T3.3.1
  • 状态：⚪ 未开始
  • 文件：public/scripts/api/chat.js

• T3.3.5 封装消息管理 API

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T3.3.1
  • 状态：⚪ 未开始
  • 文件：public/scripts/api/message.js

• T3.3.6 封装 AI 提供商配置 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 依赖：T3.3.1
  • 状态：⚪ 未开始
  • 文件：public/scripts/api/provider.js

• T3.3.7 封装文件上传 API

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 依赖：T3.3.1
  • 状态：⚪ 未开始
  • 文件：public/scripts/api/file.js

3.4 WebSocket 客户端

• T3.4.1 实现 WebSocket 客户端

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 文件：public/scripts/utils/websocket.js
  • 功能：
    • 连接管理
    • 自动重连
    • 消息订阅/发布

• T3.4.2 集成 WebSocket 到对话界面

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T3.4.1
  • 状态：⚪ 未开始

3.5 前端页面适配

• T3.5.1 适配登录/注册页面

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T3.3.2
  • 状态：⚪ 未开始

• T3.5.2 适配角色列表页面

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T3.3.3
  • 状态：⚪ 未开始

• T3.5.3 适配角色详情/编辑页面

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T3.3.3
  • 状态：⚪ 未开始

• T3.5.4 适配对话列表页面

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T3.3.4
  • 状态：⚪ 未开始

• T3.5.5 适配对话界面

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：2天
  • 依赖：T3.3.5, T3.4.2
  • 状态：⚪ 未开始
  • 功能：
    • 消息发送
    • 流式显示
    • Swipe 功能
    • 消息编辑

• T3.5.6 适配设置页面

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T3.3.6
  • 状态：⚪ 未开始

• T3.5.7 适配个人中心页面

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

3.6 环境配置

• T3.6.1 创建配置文件

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：public/scripts/config.js
  • 内容：API 地址、WebSocket 地址等

• T3.6.2 配置开发环境

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 开发服务器：使用 live-server 或类似工具

• T3.6.3 配置生产环境

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：web-app/nginx.conf

3.7 web 管理后台扩展

• T3.7.1 创建 AI 管理模块目录

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 目录：web/src/view/aiManage/

• T3.7.2 添加角色管理页面

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 文件：web/src/view/aiManage/character/index.vue

• T3.7.3 添加对话管理页面

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 文件：web/src/view/aiManage/chat/index.vue

• T3.7.4 添加用户管理页面

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 文件：web/src/view/aiManage/user/index.vue

• T3.7.5 添加数据统计页面

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 文件：web/src/view/aiManage/statistics/index.vue

• T3.7.6 添加 API 接口

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 文件：web/src/api/ai.js

• T3.7.7 添加路由配置

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：web/src/router/index.js

---

🎯 阶段五：数据迁移（预计 3-5 天）

4.1 迁移准备

• T4.1.1 备份 SillyTavern 原始数据

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 备份位置：指定安全位置

• T4.1.2 创建测试用前台用户

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T2.2.2
  • 状态：⚪ 未开始
  • 用于数据迁移目标账号

4.2 角色数据迁移

• T4.2.1 编写角色迁移脚本

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 文件：server/utils/migrate/migrate_sillytavern.go
  • 功能：从文件系统读取角色 JSON，写入数据库

• T4.2.2 测试角色迁移

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T4.2.1
  • 状态：⚪ 未开始
  • 验证：数据完整性、关联关系

• T4.2.3 执行角色正式迁移

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T4.2.2
  • 状态：⚪ 未开始

4.3 对话数据迁移

• T4.3.1 编写对话迁移脚本

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 功能：从 JSONL 文件读取对话，写入数据库

• T4.3.2 测试对话迁移

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T4.3.1
  • 状态：⚪ 未开始

• T4.3.3 执行对话正式迁移

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T4.3.2
  • 状态：⚪ 未开始

4.4 文件数据迁移

• T4.4.1 编写文件迁移脚本

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 功能：上传到对象存储，记录到数据库

• T4.4.2 迁移头像文件

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 依赖：T4.4.1
  • 状态：⚪ 未开始

• T4.4.3 迁移背景文件

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：0.5天
  • 依赖：T4.4.1
  • 状态：⚪ 未开始

• T4.4.4 迁移其他附件文件

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：0.5天
  • 依赖：T4.4.1
  • 状态：⚪ 未开始

4.5 数据验证

• T4.5.1 验证角色数据完整性

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T4.2.3
  • 状态：⚪ 未开始
  • 检查项：数量、字段完整性、关联关系

• T4.5.2 验证对话数据完整性

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T4.3.3
  • 状态：⚪ 未开始

• T4.5.3 验证文件数据完整性

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 依赖：T4.4.*
  • 状态：⚪ 未开始

---

🎯 阶段六：测试与优化（预计 7-10 天）

5.1 功能测试

5.1.1 用户认证测试

• T5.1.1 用户注册功能测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 测试用例：正常注册、重复用户名、无效邮箱等

• T5.1.2 用户登录功能测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 测试用例：正确密码、错误密码、不存在用户等

• T5.1.3 Token 刷新测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.4 登出功能测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

5.1.2 角色管理测试

• T5.1.5 创建角色测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.6 编辑角色测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.7 删除角色测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.8 导入导出角色测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 测试：PNG、JSON 格式

5.1.3 对话功能测试

• T5.1.9 创建对话测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.10 发送消息测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 测试：普通消息、长文本、特殊字符

• T5.1.11 AI 回复测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 测试：OpenAI、Claude 等不同模型

• T5.1.12 流式输出测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始

• T5.1.13 消息重新生成测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.14 消息编辑测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.15 Swipe 功能测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.16 对话历史加载测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 测试：分页、倒序加载

5.1.4 向量记忆测试

• T5.1.17 创建记忆测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.18 向量搜索测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 验证：搜索准确性、性能

• T5.1.19 记忆召回测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 测试：对话时自动召回相关记忆

5.1.5 WebSocket 测试

• T5.1.20 WebSocket 连接测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.21 消息推送测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.22 断线重连测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.23 多客户端测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

5.1.6 文件管理测试

• T5.1.24 文件上传测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 测试：大文件、不同格式

• T5.1.25 文件下载测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.1.26 文件删除测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

5.2 性能测试

• T5.2.1 登录接口压力测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 工具：Apache Bench / wrk

• T5.2.2 对话接口压力测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.2.3 数据库查询性能测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 检查：慢查询、索引优化

• T5.2.4 向量搜索性能测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始

• T5.2.5 WebSocket 并发测试

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

5.3 性能优化

• T5.3.1 添加 Redis 缓存

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：2天
  • 状态：⚪ 未开始
  • 缓存对象：角色数据、用户配置等

• T5.3.2 数据库索引优化

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T5.2.3
  • 状态：⚪ 未开始

• T5.3.3 SQL 查询优化

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 依赖：T5.2.3
  • 状态：⚪ 未开始

• T5.3.4 前端资源优化

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 内容：压缩、合并、懒加载

5.4 安全加固

• T5.4.1 实现 API 限流

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 文件：server/middleware/limiter.go

• T5.4.2 加密存储 API Keys

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 文件：server/utils/crypto/encrypt.go

• T5.4.3 SQL 注入防护验证

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.4.4 XSS 防护验证

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

• T5.4.5 CSRF 防护验证

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

---

🎯 阶段七：部署上线（预计 2-3 天）

6.1 Docker 部署

• T6.1.1 编写 Go 后端 Dockerfile

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：server/Dockerfile

• T6.1.2 编写 web-app Dockerfile

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：web-app/Dockerfile

• T6.1.3 编写 web 管理后台 Dockerfile

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：web/Dockerfile

• T6.1.4 编写 docker-compose.yml

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：docker-compose.yml
  • 服务：PostgreSQL、Redis、Server、Web、Web-App、Nginx

• T6.1.5 测试 Docker 部署

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T6.1.1-4
  • 状态：⚪ 未开始

6.2 Nginx 配置

• T6.2.1 编写 Nginx 配置文件

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：deploy/nginx/nginx.conf
  • 内容：反向代理、WebSocket 支持

• T6.2.2 配置 SSL 证书

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 使用 Let's Encrypt

• T6.2.3 测试 Nginx 配置

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T6.2.1
  • 状态：⚪ 未开始

6.3 环境配置

• T6.3.1 创建 .env 文件模板

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 文件：.env.example

• T6.3.2 配置生产环境变量

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 内容：数据库、Redis、AI API Keys 等

• T6.3.3 配置日志系统

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

6.4 数据库备份

• T6.4.1 设置数据库自动备份

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 状态：⚪ 未开始
  • 工具：pg_dump + crontab

• T6.4.2 测试数据库恢复

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：0.5天
  • 依赖：T6.4.1
  • 状态：⚪ 未开始

6.5 监控与日志

• T6.5.1 配置应用监控（可选）

  • 负责人：
  • 优先级：P3（可选）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 工具：Prometheus + Grafana

• T6.5.2 配置日志聚合（可选）

  • 负责人：
  • 优先级：P3（可选）
  • 预计时间：1天
  • 状态：⚪ 未开始
  • 工具：ELK Stack

• T6.5.3 配置告警系统（可选）

  • 负责人：
  • 优先级：P3（可选）
  • 预计时间：0.5天
  • 状态：⚪ 未开始

6.6 上线验证

• T6.6.1 生产环境部署

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：所有前置任务
  • 状态：⚪ 未开始

• T6.6.2 烟雾测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：0.5天
  • 依赖：T6.6.1
  • 状态：⚪ 未开始
  • 测试：核心功能可用性

• T6.6.3 性能监控

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T6.6.1
  • 状态：⚪ 未开始
  • 监控：响应时间、错误率、资源使用

• T6.6.4 用户验收测试

  • 负责人：
  • 优先级：P0（必须）
  • 预计时间：1天
  • 依赖：T6.6.1
  • 状态：⚪ 未开始

---

📝 文档完善

• TD.1 完善 API 文档

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：2天
  • 状态：⚪ 未开始

• TD.2 编写部署文档

  • 负责人：
  • 优先级：P1（重要）
  • 预计时间：1天
  • 状态：⚪ 未开始

• TD.3 编写用户使用手册

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：1天
  • 状态：⚪ 未开始

• TD.4 编写开发者文档

  • 负责人：
  • 优先级：P2（推荐）
  • 预计时间：1天
  • 状态：⚪ 未开始

---

🎉 项目完成

• Final.1 项目总结会议
• Final.2 经验教训总结
• Final.3 技术债务整理
• Final.4 后续优化规划

---

📊 优先级说明

• P0（必须）：核心功能，必须完成
• P1（重要）：重要功能，强烈建议完成
• P2（推荐）：增强功能，建议完成
• P3（可选）：可选功能，时间允许再做

---

📅 里程碑

里程碑	预期完成日期	实际完成日期	状态
M1: 数据库设计完成	-	-	⚪
M2: 核心 API 开发完成	-	-	⚪
M3: 前端改造完成	-	-	⚪
M4: 数据迁移完成	-	-	⚪
M5: 测试通过	-	-	⚪
M6: 生产环境上线	-	-	⚪

---

📌 注意事项

重要约束

1. ❌ 禁止修改 server/api/v1/system/ 下的任何文件
2. ❌ 禁止修改 sys_users 表结构
3. ✅ 所有新功能 都在 app/ 目录下实现
4. ✅ 所有新表 使用 app_ 或 ai_ 前缀
5. ✅ 所有新路由 使用 /app/ 前缀

开发建议

1. 每完成一个任务，及时更新状态
2. 遇到问题及时记录在备注中
3. 定期 review 进度，调整计划
4. 重要节点完成后进行备份

---

文档创建日期: 2026-02-10
最后更新: 2026-02-10
维护者: 开发团队