📄 文书模块 (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 可使用临时目录）