41 lines
1.2 KiB
Markdown
41 lines
1.2 KiB
Markdown
# 知识资产与文件解析模块后端实现
|
|
|
|
## 1. 当前实现落点
|
|
|
|
当前实现位于 `com.bruce.rag`，包含知识库、文档、解析、切片和向量实体。
|
|
|
|
## 2. Controller
|
|
|
|
已落地接口继续保留：
|
|
|
|
- `/api/rag/store/list`
|
|
- `/api/rag/store/query`
|
|
- `/api/rag/store/detail`
|
|
- `/api/rag/store/overview`
|
|
- `/api/rag/store/documentOverview`
|
|
- `/api/rag/documents/query`
|
|
- `/api/rag/documents/batchUpload`
|
|
- `/api/rag/documents/parse`
|
|
- `/api/rag/documents/chunk`
|
|
|
|
Studio 聚合接口后续新增在知识资产模块，不替代旧接口。
|
|
|
|
## 3. Service
|
|
|
|
| Service | 职责 |
|
|
|---------|------|
|
|
| `IRagStoreService` | 知识库 CRUD、概览统计 |
|
|
| `IRagDocumentService` | 文档 CRUD、批量上传 |
|
|
| `IRagDocumentParseService` | 解析状态流转和解析快照 |
|
|
| `IRagDocumentChunkService` | 根据解析快照生成切片 |
|
|
| `IRagChunkEmbeddingService` | 向量写入和召回 |
|
|
|
|
## 4. 校验规则
|
|
|
|
- 知识库编码唯一。
|
|
- 文档必须绑定存在的知识库和附件。
|
|
- 只有解析成功的文档允许切片。
|
|
- 向量化必须读取知识库生效模型配置。
|
|
- 重新切片或模型变更后，索引状态必须回到待索引或索引中。
|
|
|