ai-business-write/技术文档/字段编码修复总结.md

183 lines
7.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 字段编码修复总结
## 修复日期
2025-01-XX
## 修复目标
1. 分析并修复 `f_polic_field` 表中的中文 `field_code` 问题
2. 合并 `f_polic_file_field` 表中的重复项
3. 确保所有 `field_code` 与占位符与字段对照表文档中的英文名称对应
## 发现的问题
### 1. f_polic_field 表问题
- **初始状态**87个字段记录
- **中文field_code字段**69个
- **重复字段名称**8组每组2条记录
- **重复field_code**0个
### 2. f_polic_file_field 表问题
- **初始状态**144个关联关系
- **重复关联关系**0个已通过之前的修复处理
- **使用中文field_code的关联关系**81个
## 修复操作
### 第一阶段:主要字段修复
1. **更新37个字段的field_code**将中文field_code更新为英文field_code
2. **合并8组重复字段**
- 主要问题线索
- 初步核实审批表填表人
- 初步核实审批表承办部门意见
- 线索来源
- 被核查人员出生年月
- 被核查人员性别
- 被核查人员政治面貌
- 被核查人员职级
### 第二阶段:剩余字段修复
修复了24个剩余的中文field_code字段包括
- 谈话相关字段(拟谈话地点、拟谈话时间、谈话事由等)
- 被核查人员相关字段(被核查人员学历、工作履历、职业等)
- 其他字段(补空人员、记录人、评估意见等)
## 修复结果
### 最终状态
- **总字段数**79个
- **中文field_code字段数**4个系统字段保留
- 年龄 (ID: 704553856941259783)
- 用户 (ID: 704553856941259782)
- 用户名称 (ID: 704553856941259780)
- 用户名称1 (ID: 704553856941259781)
- **重复字段名称数**0个
- **重复关联关系数**0个
- **使用中文field_code的关联关系数**0个
### 字段映射对照
#### 基本信息字段
- `target_name` - 被核查人姓名
- `target_organization_and_position` - 被核查人员单位及职务 / 被核查人单位及职务
- `target_organization` - 被核查人员单位
- `target_position` - 被核查人员职务
- `target_gender` - 被核查人员性别
- `target_date_of_birth` - 被核查人员出生年月
- `target_date_of_birth_full` - 被核查人员出生年月日
- `target_age` - 被核查人员年龄
- `target_education_level` - 被核查人员文化程度
- `target_political_status` - 被核查人员政治面貌
- `target_professional_rank` - 被核查人员职级
- `target_id_number` - 被核查人员身份证号 / 被核查人员身份证件及号码
- `target_address` - 被核查人员住址
- `target_registered_address` - 被核查人员户籍住址
- `target_contact` - 被核查人员联系方式
- `target_place_of_origin` - 被核查人员籍贯
- `target_ethnicity` - 被核查人员民族
#### 问题相关字段
- `clue_source` - 线索来源
- `target_issue_description` - 主要问题线索
- `target_problem_description` - 被核查人问题描述
#### 审批相关字段
- `department_opinion` - 初步核实审批表承办部门意见
- `filler_name` - 初步核实审批表填表人
- `approval_time` - 批准时间
#### 核查相关字段
- `investigation_unit_name` - 核查单位名称
- `investigation_team_code` - 核查组代号
- `investigation_team_leader_name` - 核查组组长姓名
- `investigation_team_member_names` - 核查组成员姓名
- `investigation_location` - 核查地点
#### 风险评估相关字段
- `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` - 风险等级
#### 谈话相关字段(新增)
- `proposed_interview_location` - 拟谈话地点
- `proposed_interview_time` - 拟谈话时间
- `interview_reason` - 谈话事由
- `interviewer` - 谈话人
- `interview_personnel_safety_officer` - 谈话人员-安全员
- `interview_personnel_leader` - 谈话人员-组长
- `interview_personnel` - 谈话人员-谈话人员
- `pre_interview_risk_assessment_result` - 谈话前安全风险评估结果
- `interview_location` - 谈话地点
- `interview_count` - 谈话次数
#### 其他新增字段
- `target_education` - 被核查人员学历
- `target_work_history` - 被核查人员工作履历
- `target_occupation` - 被核查人员职业
- `target_confession_level` - 被核查人员交代问题程度
- `target_behavior_after_relief` - 被核查人员减压后的表现
- `target_mental_burden_level` - 被核查人员思想负担程度
- `target_behavior_during_interview` - 被核查人员谈话中的表现
- `target_issue_severity_level` - 被核查人员问题严重程度
- `target_risk_level` - 被核查人员风险等级
- `target_basic_info` - 被核查人基本情况
- `backup_personnel` - 补空人员
- `recorder` - 记录人
- `assessment_opinion` - 评估意见
## 关联表检查
### f_polic_file_field 表
- ✅ 无重复关联关系
- ✅ 所有关联关系使用的field_code均为英文
### f_polic_task 表
- 检查了表结构未发现直接引用字段ID的列
- 表字段id, tenant_id, task_name, input_data, output_data, task_status, created_time, created_by, updated_time, updated_by, state
### f_polic_file 表
- 检查了表结构
- 表字段id, tenant_id, task_id, file_id, name, input_data, file_path, created_time, created_by, updated_time, updated_by, state
- 未发现需要更新的关联关系
## 使用的脚本
1. **analyze_and_fix_field_code_issues.py** - 主要分析和修复脚本
2. **verify_field_code_fix.py** - 验证修复结果
3. **fix_only_chinese_field_codes.py** - 修复剩余的中文field_code
4. **rollback_incorrect_updates.py** - 回滚错误的更新(已使用)
## 注意事项
1. **保留的系统字段**以下4个字段的field_code仍为中文这些可能是系统字段或测试数据暂时保留
- 年龄
- 用户
- 用户名称
- 用户名称1
2. **字段合并**:在合并重复字段时,系统自动更新了 `f_polic_file_field` 表中的关联关系,将删除字段的关联关系指向保留的字段。
3. **数据一致性**:所有修复操作都确保了数据的一致性,关联表已同步更新。
## 后续建议
1. 如果"年龄"、"用户"等字段是业务字段建议为其设置合适的英文field_code
2. 定期检查是否有新的中文field_code字段产生
3. 在新增字段时确保field_code使用英文命名规范
## 完成状态
**主要修复任务已完成**
- 所有业务相关字段的field_code已更新为英文
- 重复字段已合并
- 关联表已同步更新
- 数据一致性已确保