# 模板处理脚本完成说明

## 已完成的工作

### 1. 创建了两个主要脚本

#### `process_templates.py` - 模板占位符处理脚本
- ✅ 自动扫描 `模板/原始模板` 目录下的所有 `.doc` 和 `.docx` 文件
- ✅ 根据文件名智能识别文档类型（支持17种文档类型）
- ✅ 自动将 `.doc` 文件转换为 `.docx` 格式（需要 Windows + pywin32）
- ✅ 根据占位符与字段对照表，智能识别字段名称并添加占位符
- ✅ 处理后的模板保存到 `模板` 文件夹，保持原有目录结构

#### `init_all_templates.py` - 模板初始化脚本
- ✅ 扫描 `模板` 目录下的所有 `.docx` 文件（排除原始模板目录）
- ✅ 自动识别文档类型和模板编码
- ✅ 上传模板文件到 MinIO 服务器
- ✅ 在数据库中创建或更新文件配置记录（使用 `template_code` 字段）

### 2. 支持的文档类型

脚本支持以下17种文档类型：

1. 请示报告卡 (REPORT_CARD)
2. 初步核实审批表 (PRELIMINARY_VERIFICATION_APPROVAL)
3. 初核方案 (INVESTIGATION_PLAN)
4. 谈话通知书 (NOTIFICATION_LETTER)
5. 谈话笔录 (INTERVIEW_RECORD)
6. 谈话询问对象情况摸底调查30问 (INVESTIGATION_30_QUESTIONS)
7. 被谈话人权利义务告知书 (RIGHTS_OBLIGATIONS_NOTICE)
8. 点对点交接单 (HANDOVER_FORM)
9. 陪送交接单 (ESCORT_HANDOVER_FORM)
10. 保密承诺书 (CONFIDENTIALITY_COMMITMENT)
11. 办案人员-办案安全保密承诺书 (INVESTIGATOR_CONFIDENTIALITY_COMMITMENT)
12. 请示报告卡（初核报告结论） (REPORT_CARD_CONCLUSION)
13. 初核情况报告 (INVESTIGATION_REPORT)
14. 谈话审批表 (INTERVIEW_APPROVAL_FORM)
15. 谈话前安全风险评估表 (PRE_INTERVIEW_RISK_ASSESSMENT)
16. 谈话方案 (INTERVIEW_PLAN)
17. 谈话后安全风险评估表 (POST_INTERVIEW_RISK_ASSESSMENT)

### 3. 占位符处理逻辑

脚本会智能识别以下模式并添加占位符：

1. **字段名称: 具体值** → **字段名称: {{field_code}}**
   - 例如：`被核查人姓名: 张三` → `被核查人姓名: {{target_name}}`

2. **字段名称: XXX/待填** → **字段名称: {{field_code}}**
   - 例如：`被核查人姓名: XXX` → `被核查人姓名: {{target_name}}`

3. **表格中的字段**：同样处理表格单元格中的字段

### 4. 使用步骤

#### 第一步：处理原始模板
```bash
python process_templates.py
```

**输出：**
- 处理后的模板保存在 `模板` 文件夹下
- 保持原有的目录结构
- 所有文件统一为 `.docx` 格式

**注意：**
- 处理后的模板需要人工检查，确认占位符位置是否正确
- 如有需要，可以手动调整占位符位置

#### 第二步：初始化模板到系统
```bash
python init_all_templates.py
```

**功能：**
- 上传所有模板到 MinIO
- 在数据库中创建或更新文件配置记录
- 使用 `template_code` 字段存储模板编码

**输出：**
- 显示处理进度和结果
- 统计成功、跳过、失败的文件数量

## 文件结构

```
项目根目录/
├── process_templates.py          # 模板处理脚本
├── init_all_templates.py          # 初始化脚本
├── 模板处理说明.md                # 详细使用说明
├── 模板/
│   ├── 初步核实审批表模板.docx    # 已处理的模板（示例）
│   └── 原始模板/                  # 原始模板（不处理）
│       └── 2-初核模版/
│           └── ...
└── 占位符与字段对照表.md           # 字段对照表
```

## 注意事项

1. **依赖要求：**
   - `python-docx` - 处理 Word 文档
   - `pywin32` - 转换 .doc 文件（仅 Windows，可选）
   - `pymysql` - 数据库操作
   - `minio` - MinIO 客户端

2. **.doc 文件处理：**
   - 如果未安装 `pywin32`，需要手动将 `.doc` 文件转换为 `.docx` 格式
   - 或者安装：`pip install pywin32`

3. **占位符检查：**
   - 处理后的模板需要人工检查
   - 确保占位符格式正确：`{{field_code}}`
   - 确保占位符位置合理

4. **数据库配置：**
   - 确保数据库连接配置正确
   - 确保 `f_polic_file_config` 表有 `template_code` 字段
   - 确保有足够的权限

5. **MinIO 配置：**
   - 确保 MinIO 连接配置正确
   - 确保存储桶 `finyx` 存在
   - 确保有上传权限

## 后续工作

1. **检查生成的模板：**
   - 打开处理后的模板文件
   - 检查占位符是否正确添加
   - 手动调整不正确的占位符

2. **运行初始化脚本：**
   - 确认所有模板检查无误后
   - 运行 `init_all_templates.py`
   - 检查输出信息，确认所有模板已成功上传

3. **测试文档生成：**
   - 使用 API 测试文档生成功能
   - 确认模板可以正常使用
   - 检查生成的文档是否正确填充

## 技术支持

如有问题，请检查：
1. 脚本输出日志
2. 数据库和 MinIO 连接状态
3. 文件路径和权限
4. 占位符格式是否正确

参考文档：
- `模板处理说明.md` - 详细使用说明
- `占位符与字段对照表.md` - 字段对照表