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