python/ai-business-write

Fork 0

python 2b6b76f694 Initial commit: 项目初始化

2025-12-04 14:41:20 +08:00

7.0 KiB

Raw Blame History

初步核实审批表数据设计说明

一、设计概述

本文档说明"初步核实审批表"模板相关的数据字段设计，以及如何将数据存入数据库。

二、数据表结构

2.1 相关数据表

f_polic_file_config - 文件模板配置表
- 存储文档模板的基本信息
- 字段：id, tenant_id, parent_id, name, input_data, file_path, created_time, created_by, updated_time, updated_by, state
f_polic_field - 字段表
- 存储字段定义信息
- 字段：id, tenant_id, name, filed_code, field_type, created_time, created_by, updated_time, updated_by, state
- 注意：表中字段名为 filed_code（拼写错误，但需保持一致）
f_polic_file_field - 文件和字段关联表
- 存储文件模板与字段的关联关系
- 字段：id, tenant_id, filed_id, file_id, created_time, created_by, updated_time, updated_by, state

2.2 字段类型说明

field_type = 1: 输入字段（用于AI解析的原始数据）
field_type = 2: 输出字段（AI解析后生成的结构化数据，用于填充模板）

三、初步核实审批表字段设计

3.1 输出字段（用于填充模板）

根据Excel数据字段汇总表和Word模板分析，设计了以下10个输出字段：

字段名称	字段编码 (field_code)	说明	示例
被核查人姓名	target_name	被核查人姓名	张三
被核查人员单位及职务	target_organization_and_position	被核查人员单位及职务（包括兼职）	某公司总经理
被核查人员性别	target_gender	被核查人员性别（男/女，不用男性和女性）	男
被核查人员出生年月	target_date_of_birth	被核查人员出生年月（YYYYMM格式，不需要日）	45972
被核查人员政治面貌	target_political_status	被核查人员政治面貌（中共党员、群众等）	中共党员
被核查人员职级	target_professional_rank	被核查人员职级（如：正处级）	正处级
线索来源	clue_source	线索来源	-
主要问题线索	target_issue_description	主要问题线索描述	违反国家计划生育有关政策规定，于2010年10月生育二胎。
初步核实审批表承办部门意见	department_opinion	初步核实审批表承办部门意见	-
初步核实审批表填表人	filler_name	初步核实审批表填表人	-

3.2 输入字段（用于AI解析）

字段名称	字段编码 (field_code)	说明
线索信息	clue_info	线索信息（用于AI解析）
被核查人员工作基本情况线索	target_basic_info_clue	被核查人员工作基本情况线索（用于AI解析）

3.3 Word模板占位符映射

Word模板中使用的占位符格式为 {{field_code}}，与字段编码的对应关系：

{{target_name}} → 被核查人姓名
{{target_organization_and_position}} → 被核查人员单位及职务
{{target_gender}} → 被核查人员性别
{{target_date_of_birth}} → 被核查人员出生年月
{{target_political_status}} → 被核查人员政治面貌
{{target_professional_rank}} → 被核查人员职级
{{target_issue_description}} → 主要问题线索

四、文件配置信息

4.1 文件配置记录

名称: 初步核实审批表
模板编码 (template_code): PRELIMINARY_VERIFICATION_APPROVAL
业务类型 (business_type): INVESTIGATION（调查核实）
文件路径 (file_path): /templates/初步核实审批表模板.docx（MinIO相对路径）

4.2 配置存储

文件配置的 input_data 字段存储JSON格式数据：

{
  "template_code": "PRELIMINARY_VERIFICATION_APPROVAL",
  "business_type": "INVESTIGATION"
}

五、使用说明

5.1 初始化脚本

使用 init_preliminary_verification_fields.py 脚本初始化数据：

python init_preliminary_verification_fields.py

脚本功能：

创建12个字段记录（10个输出字段 + 2个输入字段）
创建文件配置记录
建立文件和字段的关联关系（仅关联输出字段）

5.2 验证脚本

使用 verify_data.py 脚本验证数据是否正确写入：

python verify_data.py

5.3 接口调用示例

1. AI解析接口 (`/ai/extract`)

{
    "businessType": "INVESTIGATION",
    "inputData": [
        {
            "fieldCode": "clue_info",
            "fieldValue": "被举报用户名称是张三，年龄30岁"
        },
        {
            "fieldCode": "target_basic_info_clue",
            "fieldValue": "张三，男，汉族，1980年5月出生，山西太原人，本科学历，2000年参加工作，2005年加入中国共产党。"
        }
    ]
}

2. 文档生成接口 (`/ai/generate-document`)

{
    "templateCode": "PRELIMINARY_VERIFICATION_APPROVAL",
    "businessType": "INVESTIGATION",
    "inputData": [
        {
            "fieldCode": "target_name",
            "fieldValue": "张三"
        },
        {
            "fieldCode": "target_organization_and_position",
            "fieldValue": "某公司总经理"
        },
        {
            "fieldCode": "target_gender",
            "fieldValue": "男"
        },
        {
            "fieldCode": "target_date_of_birth",
            "fieldValue": "198005"
        },
        {
            "fieldCode": "target_political_status",
            "fieldValue": "中共党员"
        },
        {
            "fieldCode": "target_professional_rank",
            "fieldValue": "正处级"
        },
        {
            "fieldCode": "target_issue_description",
            "fieldValue": "违反国家计划生育有关政策规定，于2010年10月生育二胎。"
        }
    ],
    "fpolicFieldParamFileList": [
        {
            "fileId": 1764656918061150,
            "fileName": "初步核实审批表.doc"
        }
    ]
}

六、注意事项

字段编码一致性: 确保Word模板中的占位符 {{field_code}} 与数据库中的 filed_code 字段值完全一致。
字段类型:
- 输入字段（field_type=1）用于接收用户输入的原始数据，供AI解析使用
- 输出字段（field_type=2）用于存储AI解析后的结构化数据，用于填充模板
文件路径: f_polic_file_config 表中的 file_path 存储的是MinIO的相对路径，不是绝对路径。
状态字段:
- state = 0 表示未启用
- state = 1 表示启用
数据去重: 初始化脚本会自动检查数据是否已存在，避免重复创建。

七、数据库连接信息

IP地址: 152.136.177.240
端口: 5012
用户名: finyx
密码: 6QsGK6MpePZDE57Z
数据库名称: finyx

八、相关文件

init_preliminary_verification_fields.py - 数据初始化脚本
verify_data.py - 数据验证脚本
check_tables.py - 数据库表结构查看脚本
analyze_template.py - Word模板分析脚本
模板/初步核实审批表模板.docx - Word模板文件

7.0 KiB Raw Blame History Unescape Escape