# AI 知识库系统 V2 工作区

这个目录用于承载新需求版本：**AI 企业知识库问答系统**。

它和旧的 `hy_qa_asset_backend/docs` 目录刻意分开。旧项目的目标是“答疑资产后台系统”，核心是把大本营答疑内容清洗、审核、沉淀成可调用问答；新需求的目标是“企业飞书知识库 AI 问答系统”，核心是登录、权限、知识库、聊天会话、实时飞书检索和 RAG 问答。

## 目录说明

- `source_documents/`：保存原始需求资料，包括 PRD、SRS、API、数据库、RAG、后台原型、实施计划、测试、验收、部署、字段字典、权限矩阵。
- `extracted/`：从原始 Word/Excel 中抽取出的 Markdown，主要用于开发检索和上下文阅读。
- `development_records/`：保存新项目开发过程记录、范围决策、架构决策、实施计划和阶段性说明。
- `reports/`：保存评估报告、方案报告和后续技术调研结论。

## 当前目标

按照已上传的 AI 知识库系统需求包，重新规划和开发一版新系统：

- 用户端：手机号验证码登录、学员名单准入、AI 聊天、多会话、历史聊天、流式回答、停止生成、Markdown 渲染、开放知识库过滤。
- 管理后台：管理员登录、用户管理、学员手动添加、学员批量导入、管理员管理、知识库管理、Prompt 管理、模型管理、聊天记录、数据统计、系统配置、操作日志。
- AI/RAG：一期以飞书知识库作为唯一知识来源；每次提问实时检索；按知识库开放状态过滤；已开放知识库默认所有用户可见；组装 Prompt；调用大模型；通过 SSE 流式输出；记录 AI 请求日志。
- 一期不做：文件上传、图片理解、OCR、联网搜索、向量数据库同步、支付系统、课程系统、自动授权、多租户、多 Prompt、重新生成、编辑消息。

## 工作原则

- V2 先作为独立工作区推进，避免和旧项目文档混在一起。
- 上传的原始文档是 V2 的需求依据。
- 给用户、团队、交接和评审看的文档统一使用中文。
- `extracted/` 里的机器抽取文档可以保留原始语言或工程化表达，优先服务开发检索。
- 旧代码只在领域边界匹配时复用，不把旧的“答疑资产审核模型”硬套到新的“开放知识库问答模型”上。

## 本地开发启动

阶段二已经提供本地开发编排：

```bash
cd ai_knowledge_base_v2
docker compose -f docker-compose.dev.yml up --build
```

默认访问地址：

- 统一入口：`http://127.0.0.1:8080/`
- 用户端 H5：`http://127.0.0.1:8080/`
- 管理后台：`http://127.0.0.1:8080/login`
- 后端 API：`http://127.0.0.1:8080/api/health`
- 用户端直连调试：`http://127.0.0.1:5173/`
- 管理后台直连调试：`http://127.0.0.1:5174/login/`
- 后端直连调试：`http://127.0.0.1:8100/api/health`
- MySQL：`127.0.0.1:3307`

开发阶段 mock 短信验证码为 `123456`。
