294 lines
7.8 KiB
Markdown
294 lines
7.8 KiB
Markdown
# 模板树状结构更新 - 使用说明
|
||
|
||
## 概述
|
||
|
||
本工具用于根据 `template_finish` 目录结构，更新数据库 `f_polic_file_config` 表中的 `parent_id` 字段，建立正确的树状层级结构。
|
||
|
||
## 数据库现状分析
|
||
|
||
根据检查，数据库中现有：
|
||
- **总记录数**: 32 条
|
||
- **有 parent_id**: 2 条
|
||
- **无 parent_id**: 30 条
|
||
|
||
需要更新的主要记录包括：
|
||
- 初步核实审批表
|
||
- 请示报告卡（各种类型）
|
||
- 初核方案
|
||
- 谈话通知书（第一联、第二联、第三联）
|
||
- XXX初核情况报告
|
||
- 走读式谈话审批相关文件
|
||
- 走读式谈话流程相关文件
|
||
- 等等...
|
||
|
||
## 脚本说明
|
||
|
||
### 1. `check_existing_data.py` - 检查现有数据
|
||
|
||
**功能**: 查看数据库中的现有记录，分析缺少 parent_id 的情况
|
||
|
||
**使用方法**:
|
||
```bash
|
||
python check_existing_data.py
|
||
```
|
||
|
||
**输出**:
|
||
- 列出所有无 parent_id 的记录
|
||
- 显示有 parent_id 的记录及其树状关系
|
||
|
||
---
|
||
|
||
### 2. `improved_match_and_update.py` - 改进的匹配分析
|
||
|
||
**功能**: 使用改进的匹配逻辑分析目录结构和数据库，生成匹配报告
|
||
|
||
**特点**:
|
||
- **三级匹配策略**:
|
||
1. **template_code 精确匹配**（最高优先级）
|
||
2. **名称精确匹配**
|
||
3. **标准化名称匹配**（去掉编号和括号后的模糊匹配）
|
||
|
||
**使用方法**:
|
||
```bash
|
||
python improved_match_and_update.py
|
||
```
|
||
|
||
**输出**:
|
||
- 匹配报告（显示哪些记录已匹配，哪些需要创建）
|
||
- 可选择性生成 SQL 更新脚本
|
||
|
||
---
|
||
|
||
### 3. `update_template_tree.py` - 交互式更新工具（推荐）
|
||
|
||
**功能**: 完整的更新工具，包含预览、确认和执行功能
|
||
|
||
**特点**:
|
||
- 使用改进的匹配逻辑
|
||
- 支持预览模式（dry-run）
|
||
- 交互式确认
|
||
- 按层级顺序自动更新
|
||
- 安全的事务处理
|
||
|
||
**使用方法**:
|
||
```bash
|
||
python update_template_tree.py
|
||
```
|
||
|
||
**执行流程**:
|
||
1. 扫描目录结构
|
||
2. 获取数据库现有数据
|
||
3. 规划树状结构（使用改进的匹配逻辑）
|
||
4. 显示更新预览
|
||
5. 询问是否执行（输入 `yes`）
|
||
6. 执行模拟更新
|
||
7. 再次确认执行实际更新
|
||
|
||
---
|
||
|
||
### 4. `analyze_and_update_template_tree.py` - 生成 SQL 脚本
|
||
|
||
**功能**: 分析并生成 SQL 更新脚本（不直接修改数据库）
|
||
|
||
**使用方法**:
|
||
```bash
|
||
python analyze_and_update_template_tree.py
|
||
```
|
||
|
||
**输出**:
|
||
- `update_template_tree.sql` - SQL 更新脚本
|
||
|
||
**适用场景**:
|
||
- 生产环境
|
||
- 需要 DBA 审核的场景
|
||
- 需要手动执行的场景
|
||
|
||
---
|
||
|
||
### 5. `verify_tree_structure.py` - 验证更新结果
|
||
|
||
**功能**: 验证更新后的树状结构是否正确
|
||
|
||
**使用方法**:
|
||
```bash
|
||
python verify_tree_structure.py
|
||
```
|
||
|
||
**输出**:
|
||
- 树状结构可视化
|
||
- 统计信息
|
||
- 父子关系验证
|
||
|
||
---
|
||
|
||
## 匹配逻辑说明
|
||
|
||
### 三级匹配策略
|
||
|
||
1. **template_code 精确匹配**（最高优先级）
|
||
- 通过 `template_code` 字段精确匹配
|
||
- 例如: `REPORT_CARD` 匹配 `REPORT_CARD`
|
||
|
||
2. **名称精确匹配**
|
||
- 通过 `name` 字段精确匹配
|
||
- 例如: `"1.请示报告卡（XXX）"` 匹配 `"1.请示报告卡（XXX）"`
|
||
|
||
3. **标准化名称匹配**（模糊匹配）
|
||
- 去掉开头的编号（如 `"1."`、`"2."`、`"8-1"`）
|
||
- 去掉括号及其内容（如 `"（XXX）"`、`"（初核谈话）"`）
|
||
- 例如: `"1.请示报告卡（XXX）"` → `"请示报告卡"` → 匹配 `"请示报告卡"`
|
||
|
||
### 匹配示例
|
||
|
||
| 目录结构中的名称 | 数据库中的名称 | 匹配方式 |
|
||
|----------------|--------------|---------|
|
||
| `1.请示报告卡（XXX）` | `请示报告卡` | template_code: `REPORT_CARD` |
|
||
| `2.初步核实审批表（XXX）` | `初步核实审批表` | template_code: `PRELIMINARY_VERIFICATION_APPROVAL` |
|
||
| `谈话通知书第一联` | `谈话通知书第一联` | 名称精确匹配 |
|
||
| `走读式谈话审批` | `走读式谈话审批` | 名称精确匹配 |
|
||
|
||
## 树状结构规划
|
||
|
||
根据 `template_finish` 目录结构，规划的层级关系如下：
|
||
|
||
```
|
||
2-初核模版 (一级目录)
|
||
├── 1.初核请示 (二级目录)
|
||
│ ├── 1.请示报告卡（XXX）.docx
|
||
│ ├── 2.初步核实审批表（XXX）.docx
|
||
│ └── 3.附件初核方案(XXX).docx
|
||
├── 2.谈话审批 (二级目录)
|
||
│ ├── 谈话通知书 (三级目录)
|
||
│ │ ├── 谈话通知书第一联.docx
|
||
│ │ ├── 谈话通知书第二联.docx
|
||
│ │ └── 谈话通知书第三联.docx
|
||
│ ├── 走读式谈话审批 (三级目录)
|
||
│ │ ├── 1.请示报告卡（初核谈话）.docx
|
||
│ │ ├── 2谈话审批表.docx
|
||
│ │ ├── 3.谈话前安全风险评估表.docx
|
||
│ │ ├── 4.谈话方案.docx
|
||
│ │ └── 5.谈话后安全风险评估表.docx
|
||
│ └── 走读式谈话流程 (三级目录)
|
||
│ ├── 1.谈话笔录.docx
|
||
│ ├── 2.谈话询问对象情况摸底调查30问.docx
|
||
│ ├── 3.被谈话人权利义务告知书.docx
|
||
│ ├── 4.点对点交接单.docx
|
||
│ ├── 5.陪送交接单（新）.docx
|
||
│ ├── 6.1保密承诺书（谈话对象使用-非中共党员用）.docx
|
||
│ ├── 6.2保密承诺书（谈话对象使用-中共党员用）.docx
|
||
│ └── 7.办案人员-办案安全保密承诺书.docx
|
||
└── 3.初核结论 (二级目录)
|
||
├── 8-1请示报告卡（初核报告结论） .docx
|
||
└── 8.XXX初核情况报告.docx
|
||
```
|
||
|
||
## 执行步骤
|
||
|
||
### 推荐流程（使用交互式工具）
|
||
|
||
1. **检查现有数据**
|
||
```bash
|
||
python check_existing_data.py
|
||
```
|
||
|
||
2. **运行更新工具**
|
||
```bash
|
||
python update_template_tree.py
|
||
```
|
||
|
||
3. **查看预览信息**
|
||
- 检查匹配情况
|
||
- 确认更新计划
|
||
|
||
4. **确认执行**
|
||
- 输入 `yes` 确认
|
||
- 再次确认执行实际更新
|
||
|
||
5. **验证结果**
|
||
```bash
|
||
python verify_tree_structure.py
|
||
```
|
||
|
||
### 备选流程（使用 SQL 脚本）
|
||
|
||
1. **生成 SQL 脚本**
|
||
```bash
|
||
python improved_match_and_update.py
|
||
# 或
|
||
python analyze_and_update_template_tree.py
|
||
```
|
||
|
||
2. **检查 SQL 脚本**
|
||
```bash
|
||
# 查看 update_template_tree.sql
|
||
```
|
||
|
||
3. **备份数据库**（重要！）
|
||
|
||
4. **执行 SQL 脚本**
|
||
```sql
|
||
-- 在 MySQL 客户端中执行
|
||
source update_template_tree.sql;
|
||
```
|
||
|
||
5. **验证结果**
|
||
```bash
|
||
python verify_tree_structure.py
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. **备份数据库**: 执行更新前务必备份数据库
|
||
2. **检查匹配**: 确认匹配结果是否正确
|
||
3. **层级顺序**: 更新会按照层级顺序执行，确保父节点先于子节点
|
||
4. **重复执行**: 脚本支持重复执行，已正确设置的记录会被跳过
|
||
5. **目录节点**: 如果目录节点不存在，脚本会自动创建
|
||
|
||
## 匹配结果
|
||
|
||
根据最新分析，匹配情况如下：
|
||
|
||
- ✅ **已匹配**: 26 条记录
|
||
- ⚠️ **需创建**: 2 条记录（目录节点）
|
||
- `2-初核模版` (一级目录)
|
||
- `1.初核请示` (二级目录)
|
||
|
||
所有文件记录都已正确匹配到数据库中的现有记录。
|
||
|
||
## 问题排查
|
||
|
||
### 问题1: 某些记录无法匹配
|
||
|
||
**原因**: 名称或 template_code 不匹配
|
||
|
||
**解决**:
|
||
- 检查 `DOCUMENT_TYPE_MAPPING` 字典
|
||
- 确认数据库中的 `template_code` 是否正确
|
||
- 使用 `check_existing_data.py` 查看数据库中的实际数据
|
||
|
||
### 问题2: 匹配到错误的记录
|
||
|
||
**原因**: 标准化名称匹配时选择了错误的候选
|
||
|
||
**解决**:
|
||
- 检查匹配报告，确认匹配方式
|
||
- 如果 template_code 匹配失败，检查数据库中的 template_code 是否正确
|
||
- 可以手动调整匹配逻辑
|
||
|
||
### 问题3: parent_id 更新失败
|
||
|
||
**原因**: 父节点ID不存在或层级关系错误
|
||
|
||
**解决**:
|
||
- 使用 `verify_tree_structure.py` 验证父子关系
|
||
- 检查生成的 SQL 脚本，确认父节点ID是否正确
|
||
|
||
## 联系信息
|
||
|
||
如有问题，请检查：
|
||
1. 数据库连接配置是否正确
|
||
2. 目录结构是否与预期一致
|
||
3. 数据库中的记录是否完整
|
||
4. template_code 是否正确设置
|
||
|