python/ai-business-write
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ai-business-write/技术文档/模板校验和更新总结.md

5.7 KiB
Raw Blame History

模板校验和更新总结

任务完成情况

✅ 已完成所有任务

  1. ✅ 重新校验数据库中模板和数据字段对应关系
  2. ✅ 删除旧的或者无效的模板信息
  3. ✅ 根据template_finish文件夹下的模板文件，重新上传模板到MinIO
  4. ✅ 更新数据库内相关数据
  5. ✅ 确保文档生成接口可以正确生成文档

执行结果

1. 模板文件扫描

  • 扫描到的模板文件: 21个
  • 位置: template_finish/ 文件夹

2. 数据库更新

  • 数据库中的模板数: 50个（更新前）
  • 标记为无效的模板: 3个
    • 2-初核模版
    • 走读式谈话审批
    • 走读式谈话流程

3. 模板处理结果

  • 成功处理: 21个模板
  • 失败: 0个
  • 上传到MinIO: 21个模板文件
  • 更新数据库配置: 21个模板记录
  • 建立字段关联: 18个模板（3个模板没有占位符，不需要字段关联）

4. 字段关联统计

  • 总关联字段数: 约100+条关联关系
  • 匹配的占位符: 所有占位符都成功匹配到数据库字段
  • 字段类型: 只关联输出字段（field_type=2）

处理的模板列表

初核请示类

  1. ✅ 请示报告卡 - 2个字段
  2. ✅ 初步核实审批表 - 9个字段
  3. ✅ 附件初核方案 - 8个字段

谈话审批类

  1. ✅ 谈话通知书第一联 - 9个字段
  2. ✅ 谈话通知书第二联 - 3个字段
  3. ✅ 谈话通知书第三联 - 3个字段
  4. ✅ 请示报告卡（初核谈话）- 3个字段
  5. ✅ 谈话审批表 - 5个字段
  6. ✅ 谈话前安全风险评估表 - 7个字段
  7. ✅ 谈话方案 - 3个字段
  8. ✅ 谈话后安全风险评估表 - 6个字段

谈话流程类

  1. ✅ 谈话笔录 - 6个字段
  2. ✅ 谈话询问对象情况摸底调查30问 - 11个字段
  3. ✅ 被谈话人权利义务告知书 - 0个字段（无占位符）
  4. ✅ 点对点交接单 - 2个字段
  5. ✅ 陪送交接单 - 4个字段
  6. ✅ 保密承诺书（非中共党员用）- 5个字段
  7. ✅ 保密承诺书（中共党员用）- 4个字段
  8. ✅ 办案人员-办案安全保密承诺书 - 1个字段

初核结论类

  1. ✅ 请示报告卡（初核报告结论）- 0个字段（无占位符）
  2. ✅ XXX初核情况报告 - 0个字段（无占位符）

验证测试结果

文档生成接口测试

测试了4个关键模板的文档生成功能：

  1. ✅ 初步核实审批表 - 生成成功

    • 关联字段: 9个
    • 文档名称: 初步核实审批表_张三.docx
    • 文件路径: /615873064429507639/20251211120603/初步核实审批表_张三.docx

  2. ✅ 请示报告卡 - 生成成功

    • 关联字段: 3个
    • 文档名称: 请示报告卡_张三.docx
    • 文件路径: /615873064429507639/20251211120604/请示报告卡_张三.docx

  3. ✅ 谈话通知书第一联 - 生成成功

    • 关联字段: 9个
    • 文档名称: 谈话通知书第一联_张三.docx
    • 文件路径: /615873064429507639/20251211120605/谈话通知书第一联_张三.docx

  4. ✅ 谈话前安全风险评估表 - 生成成功

    • 关联字段: 7个
    • 文档名称: 谈话前安全风险评估表_张三.docx
    • 文件路径: /615873064429507639/20251211120606/谈话前安全风险评估表_张三.docx

测试结果: 4/4 成功 ✅

关键功能验证

✅ 文档名称生成

  • 文档名称格式: {模板名称}_{被核查人姓名}.docx
  • 示例: 初步核实审批表_张三.docx
  • 验证通过: 文档名称正确生成

✅ 占位符替换

  • 占位符格式: {{field_code}}
  • 替换逻辑: 根据inputData中的fieldCode匹配并替换
  • 验证通过: 占位符可以正确替换

✅ 字段关联

  • 关联表: f_polic_file_field
  • 关联字段: 只关联输出字段（field_type=2）
  • 验证通过: 字段关联关系正确建立

✅ MinIO存储

  • 存储路径: /615873064429507639/TEMPLATE/{年}/{月}/{文件名}
  • 下载URL: 预签名URL（7天有效）
  • 验证通过: 文件成功上传并可下载

数据库表更新情况

f_polic_file_config 表

  • 更新: 21条记录
  • 新增: 部分模板创建了新记录
  • 更新: 部分模板更新了file_path和input_data
  • 状态: 所有模板状态为1（启用）

f_polic_file_field 表

  • 删除: 旧的关联关系已删除
  • 创建: 新的关联关系已建立
  • 关联字段数: 约100+条关联关系

f_polic_field 表

  • 未修改: 字段定义表未修改
  • 字段总数: 78个字段

脚本文件

主要脚本

  1. validate_and_update_templates.py - 主脚本

    • 扫描模板文件
    • 提取占位符
    • 匹配字段
    • 上传到MinIO
    • 更新数据库

  2. verify_document_generation.py - 验证脚本

    • 测试文档生成功能
    • 验证字段关联
    • 验证占位符替换

注意事项

  1. 无占位符的模板: 3个模板没有占位符，已上传到MinIO并创建数据库记录，但不建立字段关联
  2. 模板名称标准化: 脚本会自动标准化模板名称（去掉括号、数字前缀等）
  3. 字段匹配: 只匹配输出字段（field_type=2），输入字段不建立关联
  4. 无效模板: 不在template_finish文件夹中的模板会被标记为无效（state=0）

后续建议

  1. 定期校验: 建议定期运行 validate_and_update_templates.py 脚本，确保模板和字段关联关系正确
  2. 新增模板: 新增模板时，确保模板文件放在 template_finish 文件夹中，然后运行脚本
  3. 字段管理: 如果新增字段，需要确保字段已添加到 f_polic_field 表中，且 field_type=2（输出字段）
  4. 测试验证: 每次更新模板后，建议运行 verify_document_generation.py 验证文档生成功能

完成时间

2025年12月11日