File size: 2,167 Bytes
b4f2238 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 | # 📄 文书模块 (Documents)
文书模块负责文书模板管理、占位符渲染、证据材料处理与导出、文件夹模板/目录结构规则，以及面向案件/合同/诉讼场景的文书生成流水线。
## 📚 模块概述
本模块提供：
- 文书模板与文件夹模板管理（Admin + API）
- 占位符体系（placeholder registry、提取、渲染、使用统计）
- 证据材料管理、合并、导出与清单生成
- 生成流水线：上下文构建 → 模板匹配 → 渲染 → 打包 → 输出存储
- Prompt 版本与文书生成任务编排（部分与 LLM/诉讼文书链路协作）
## 📁 目录结构（简要）
```
documents/
├── api/ # Ninja API：模板/生成/证据/占位符/文件夹模板
├── admin/ # Django Admin：模板、证据、占位符、审计日志等
├── models/ # 模型：template/evidence/generation/placeholder/prompt_version...
├── services/ # 业务服务：模板、证据、文件夹模板、生成流水线、占位符
├── usecases/ # 用例编排（例如 folder_template）
├── presenters/ # 展示层辅助（例如模板名呈现）
├── management/commands # 初始化与修复命令
└── docx_templates/ # 内置 docx 模板资源（含示例与默认模板）
```
## 🔑 核心入口
- API
- `api/document_api.py`、`api/generation_api.py`、`api/evidence_api.py`、`api/placeholder_api.py`
- 模板与占位符
- `services/document_template/*`、`services/placeholders/*`、`services/template_matching_service.py`
- 生成流水线
- `services/generation/pipeline/*`、`services/generation/*_generation_service.py`
- 证据与导出
- `services/evidence/*`、`services/evidence_export_service.py`
## 🧪 测试建议
- 生成链路：优先对 context_builder/template_matcher/renderer 做单元测试（不依赖外部网络）
- 占位符：对 registry 与 placeholder service 的输入输出做属性测试，保证幂等与可序列化
- 证据导出：对合并/导出流程做最小回归测试（文件 IO 可使用临时目录）
|