python/ai-business-write

Fork 0

python 5830de355d 将所有.md技术文档统一移动到技术文档目录下，创建一个“test_scripts”目录，并将所有测试脚本统一移动到该目录下

2025-12-09 09:15:35 +08:00

12 KiB

Raw Permalink 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 输出字段（用于填充模板）

根据风险评估需求，设计了以下11个输出字段，所有字段都配置了默认值：

字段名称	字段编码 (field_code)	说明	默认值	示例
被核查人员家庭情况	target_family_situation	被核查人员家庭情况	家庭关系和谐稳定	家庭关系和谐稳定
被核查人员社会关系	target_social_relations	被核查人员社会关系	社会交往较多，人机关系基本正常	社会交往较多，人机关系基本正常
被核查人员健康状况	target_health_status	被核查人员健康状况	良好	良好
被核查人员性格特征	target_personality	被核查人员性格特征	开朗	开朗
被核查人员承受能力	target_tolerance	被核查人员承受能力	较强	较强
被核查人员涉及问题严重程度	target_issue_severity	被核查人员涉及问题严重程度	较轻	较轻
被核查人员涉及其他问题的可能性	target_other_issues_possibility	被核查人员涉及其他问题的可能性	较小	较小
被核查人员此前被审查情况	target_previous_investigation	被核查人员此前被审查情况	无	无
被核查人员社会负面事件	target_negative_events	被核查人员社会负面事件	无	无
被核查人员其他情况	target_other_situation	被核查人员其他情况	无	无
风险等级	risk_level	风险等级	低	低

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

该模板可以使用通用的输入字段：

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

3.3 Word模板占位符映射

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

{{target_family_situation}} → 被核查人员家庭情况
{{target_social_relations}} → 被核查人员社会关系
{{target_health_status}} → 被核查人员健康状况
{{target_personality}} → 被核查人员性格特征
{{target_tolerance}} → 被核查人员承受能力
{{target_issue_severity}} → 被核查人员涉及问题严重程度
{{target_other_issues_possibility}} → 被核查人员涉及其他问题的可能性
{{target_previous_investigation}} → 被核查人员此前被审查情况
{{target_negative_events}} → 被核查人员社会负面事件
{{target_other_situation}} → 被核查人员其他情况
{{risk_level}} → 风险等级

四、文件配置信息

4.1 文件配置记录

名称: 谈话前安全风险评估表
模板编码 (template_code): PRE_INTERVIEW_RISK_ASSESSMENT
业务类型 (business_type): INVESTIGATION（调查核实）
文件路径 (file_path): /templates/谈话前安全风险评估表模板.docx（MinIO相对路径）

4.2 配置存储

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

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

五、默认值机制

5.1 默认值配置

所有风险评估字段都配置了默认值，存储在 config/field_defaults.json 配置文件中。

5.2 默认值说明

重要说明：系统在AI提取阶段不会自动应用默认值。如果AI未提取到字段值，系统会返回空字符串。

默认值信息提供给前端开发人员，前端可以根据业务需求决定是否在界面上显示默认值或应用默认值。

5.3 默认值应用规则（前端参考）

AI提取阶段：如果AI从输入文本中提取到字段值，则使用提取的值
空值处理：如果AI提取的字段值为空或未提取到，系统返回空字符串
前端应用：前端可以根据业务需求，在用户界面中显示默认值提示，或允许用户选择应用默认值
默认值优先级：AI提取的值优先于默认值

5.3 默认值配置位置

默认值配置文件：config/field_defaults.json

{
  "field_defaults": {
    "target_family_situation": "家庭关系和谐稳定",
    "target_social_relations": "社会交往较多，人机关系基本正常",
    "target_health_status": "良好",
    "target_personality": "开朗",
    "target_tolerance": "较强",
    "target_issue_severity": "较轻",
    "target_other_issues_possibility": "较小",
    "target_previous_investigation": "无",
    "target_negative_events": "无",
    "target_other_situation": "无",
    "risk_level": "低"
  }
}

六、使用说明

6.1 初始化脚本

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

python init_pre_interview_risk_assessment_fields.py

脚本功能：

创建11个字段记录（输出字段）
创建文件配置记录
建立文件和字段的关联关系

6.2 接口调用示例

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

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

返回结果（如果AI未提取到值，返回空字符串，前端可根据需要应用默认值）：

{
    "code": 0,
    "data": {
        "outData": [
            {
                "fieldCode": "target_family_situation",
                "fieldValue": ""
            },
            {
                "fieldCode": "target_social_relations",
                "fieldValue": ""
            },
            {
                "fieldCode": "target_health_status",
                "fieldValue": ""
            },
            {
                "fieldCode": "target_personality",
                "fieldValue": ""
            },
            {
                "fieldCode": "target_tolerance",
                "fieldValue": ""
            },
            {
                "fieldCode": "target_issue_severity",
                "fieldValue": ""
            },
            {
                "fieldCode": "target_other_issues_possibility",
                "fieldValue": ""
            },
            {
                "fieldCode": "target_previous_investigation",
                "fieldValue": ""
            },
            {
                "fieldCode": "target_negative_events",
                "fieldValue": ""
            },
            {
                "fieldCode": "target_other_situation",
                "fieldValue": ""
            },
            {
                "fieldCode": "risk_level",
                "fieldValue": ""
            }
        ]
    },
    "msg": "ok",
    "isSuccess": true
}

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

{
    "templateCode": "PRE_INTERVIEW_RISK_ASSESSMENT",
    "businessType": "INVESTIGATION",
    "inputData": [
        {
            "fieldCode": "target_family_situation",
            "fieldValue": "家庭关系和谐稳定"
        },
        {
            "fieldCode": "target_social_relations",
            "fieldValue": "社会交往较多，人机关系基本正常"
        },
        {
            "fieldCode": "target_health_status",
            "fieldValue": "良好"
        },
        {
            "fieldCode": "target_personality",
            "fieldValue": "开朗"
        },
        {
            "fieldCode": "target_tolerance",
            "fieldValue": "较强"
        },
        {
            "fieldCode": "target_issue_severity",
            "fieldValue": "较轻"
        },
        {
            "fieldCode": "target_other_issues_possibility",
            "fieldValue": "较小"
        },
        {
            "fieldCode": "target_previous_investigation",
            "fieldValue": "无"
        },
        {
            "fieldCode": "target_negative_events",
            "fieldValue": "无"
        },
        {
            "fieldCode": "target_other_situation",
            "fieldValue": "无"
        },
        {
            "fieldCode": "risk_level",
            "fieldValue": "低"
        }
    ],
    "fpolicFieldParamFileList": [
        {
            "fileId": 1764656918061150,
            "fileName": "谈话前安全风险评估表.doc"
        }
    ]
}

七、注意事项

字段编码一致性: 确保Word模板中的占位符 {{field_code}} 与数据库中的 filed_code 字段值完全一致。
默认值机制:
- 系统在AI提取阶段不会自动应用默认值
- 如果AI提取到值，则使用AI提取的值
- 如果AI未提取到值或值为空，系统返回空字符串
- 默认值信息提供给前端，前端可根据业务需求决定是否应用
字段类型:
- 输入字段（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_pre_interview_risk_assessment_fields.py - 数据初始化脚本
config/field_defaults.json - 字段默认值配置文件
services/field_service.py - 字段服务（包含默认值逻辑）
app.py - API接口（包含默认值应用逻辑）
模板/谈话前安全风险评估表模板.docx - Word模板文件

12 KiB Raw Permalink Blame History Unescape Escape