docs: 重构仓库文档目录并迁移训练素材

按当前架构重组 docs 目录,统一中文命名与目录分层,并将训练原材料迁移到独立目录以保持架构文档边界清晰。
This commit is contained in:
eaiadmin
2026-09-22 23:23:16 +08:00
parent 9288f0215a
commit 90031b75f3
9046 changed files with 23786 additions and 3483 deletions
@@ -0,0 +1,44 @@
# KB01 — 知识空间、摄入、检索与 FAQ
> 状态:当前有效
> 代码依据:`backend-go/internal/api/knowledge.go`
> 最后更新:2026-09-21
## 1. 当前定位
知识底座是组织级基础层。
它负责:
- 管理知识空间
- 扫描知识源
- 审批知识源
- 写入 chunk
- 提供 FAQ 与检索能力
## 2. 当前核心对象
- `knowledge_space`
- `knowledge_source`
- `knowledge_chunk`
- `knowledge_faq`
## 3. 当前核心流程
结构化知识当前按以下路径进入系统:
`scan -> audit -> ingest -> chunk -> index`
## 4. 当前接口
- `GET /api/knowledge/spaces`
- `GET /api/knowledge/search`
- `POST /api/knowledge/scan`
- `POST /api/knowledge/index/rebuild`
- `GET /api/knowledge/faqs`
- `POST /api/knowledge/audit/:source_id`
## 5. 当前判断
- knowledge 不是外围模块,而是系统底座
- 知识底座既服务对象中心,也服务运行中心和兼容业务域
@@ -0,0 +1,50 @@
# KB02 — 媒体上传、审批与预览
> 状态:当前有效
> 代码依据:`backend-go/internal/api/media.go`
> 最后更新:2026-09-21
## 1. 当前定位
媒体层是知识底座的上游入口。
它负责:
- 文件上传
- 分片上传
- 素材审批
- 已审批素材预览
- 触发后续提取流程
## 2. 当前状态流转
`pending -> approved / rejected`
审批通过后的素材进入知识接入链路。
## 3. 当前核心表
`media_file` 当前记录:
- 文件元数据
- 审批状态
- 绑定信息
- 知识空间归属
- 是否已提取
## 4. 当前接口
- `POST /api/media/upload`
- `POST /api/media/upload-init`
- `POST /api/media/upload-chunk`
- `POST /api/media/upload-complete`
- `GET /api/media/preview/:media_id`
- `GET /api/media/status/:media_id`
- `GET /api/media/audit-list`
- `POST /api/media/audit/:media_id`
## 5. 当前判断
- 媒体不是独立业务主轴
- 它在后端中的位置是知识底座入口链路
- 它继续兼容 company / product / course 等旧业务绑定
@@ -0,0 +1,16 @@
# 04_知识底座 — 目录说明
本目录描述当前后端中的知识底座。
当前核心对象包括:
- `knowledge_space`
- `knowledge_source`
- `knowledge_chunk`
- `knowledge_faq`
- `media_file`
建议阅读顺序:
1. `KB01_知识空间_摄入_检索与FAQ.md`
2. `KB02_媒体上传_审批_预览.md`