docs: 重构仓库文档目录并迁移训练素材
按当前架构重组 docs 目录,统一中文命名与目录分层,并将训练原材料迁移到独立目录以保持架构文档边界清晰。
This commit is contained in:
@@ -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`
|
||||
Reference in New Issue
Block a user