# 阶段一执行记录：需求和架构收口

日期：2026-07-06

## 本阶段目标

按照开发流程规划，阶段一的目标是把新需求从“文档集合”整理成可以指导开发的工程边界，包括：

1. 一期范围和不做范围。
2. V2 架构草案和模块边界。
3. 接口开发优先级。
4. 待确认问题清单。
5. 技术选型和关键决策记录。

## 已完成文档

| 文档 | 作用 |
| --- | --- |
| `2026-07-06-phase1-scope.md` | 锁定一期必须做、明确不做、后续扩展和验收重点。 |
| `2026-07-06-architecture-plan.md` | 说明 V2 推荐目录、技术栈、后端模块、核心链路和风险控制。 |
| `2026-07-06-api-priority.md` | 按 P0/P1/P2/P3 规划接口开发顺序。 |
| `2026-07-06-open-questions.md` | 记录必须确认、产品确认和技术验证问题。 |
| `2026-07-06-tech-decisions.md` | 记录当前建议采纳或待确认的技术决策。 |

## 阶段一暂定结论

1. V2 先在当前仓库的 `ai_knowledge_base_v2/` 下独立推进。
2. V2 后端建议使用 FastAPI + SQLAlchemy + Alembic。
3. V2 数据库建议严格对齐文档，使用 MySQL 8.x。
4. 用户端已确认直接使用 Vue 3 H5，不采用 uni-app。
5. 管理后台建议优先评估 Vue 3 + Element Plus。
6. 短信、飞书、大模型先做 mock provider，再逐步替换真实服务。
7. 开发顺序先跑通用户端主链路，再补后台完整管理能力。

## 进入阶段二前要确认的事

这些问题不一定全部阻塞代码开工，但越早确认越好：

1. 是否接受 V2 继续放在当前仓库的 `ai_knowledge_base_v2/` 下。
2. 是否确认 V2 使用 MySQL 8.x。
3. 后台是否采用 Vue 3 + Element Plus。
4. 飞书知识库实时检索 API 是否能满足需求，需要做技术验证。
5. 生产短信和大模型供应商待定，当前先按 mock + OpenAI 兼容接口推进。

## 建议下一步

下一步进入阶段二：**后端基础工程和数据模型**。

建议第一批开发任务：

1. 在 `ai_knowledge_base_v2/apps/backend/` 新建 V2 后端工程。
2. 建立 FastAPI、配置、日志、统一响应、异常处理和健康检查。
3. 配置 MySQL 8.x 和 Alembic 迁移。
4. 建立第一批核心表模型：用户、管理员、角色、知识库、会话、消息；`sys_user_kb` 已按早期文档预留，但 2026-07-07 新口径下不再作为一期主链路依赖。
5. 实现 mock 短信登录、Token 签发和当前用户接口。
