docs(rag): 补全知识资产与解析设计

后端实现文档/2.知识资产与文件解析模块后端实现.md

@@ -0,0 +1,39 @@
+# 知识资产与文件解析模块后端实现
+
+## 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. 校验规则
+
+- 知识库编码唯一。
+- 文档必须绑定存在的知识库和附件。
+- 只有解析成功的文档允许切片。
+- 向量化必须读取知识库生效模型配置。
+- 重新切片或模型变更后，索引状态必须回到待索引或索引中。