safety-eval-service/docs/db/phase2/数据库设计文档-二期.md

7.1 KiB
Raw Blame History

安全评价系统二期数据库设计文档

日期 版本 说明
2026.07.17 v1.0.0 二期建表设计

脚本:docs/db/phase2/init-phase2.sql
节点引擎专项:docs/db/phase2/节点引擎设计与使用说明.md


一、设计约定

约定
字符集 utf8mb4 / utf8mb4_0900_ai_ci
命名 库表字段小写 + 下划线,表名 ≤32 字符
外键 禁止物理外键;逻辑关联由业务层维护
标识字段 xxx_flagtinyint1=是2=否)
字典字段 xxx_code + xxx_name
金额 单位:分,类型 bigint
文件 仅存 URL / 文件服务地址
逻辑删除 delete_enumtrue / false
业务主表公共字段 delete_enum、remarks、create_name、update_name、tenant_id、org_id、version、create_time、update_time、create_id、update_id、env
站内消息 复用 GBS jjb-saas-message(站内信 / 待办 / 催办 / 短信),本库不建消息表

本脚本仅新增二期表,不改建一期已有表与业务代码。


二、一期复用表

用途
org_info 机构主数据
org_qualification 资质证照
org_department / org_position 部门岗位
org_personnel / org_personnel_cert 人员与证书
org_equipment 装备
org_personnel_change / org_resign_apply 人员变更、离职
qual_filing 及材料/承诺/人员/装备/变更子表 资质申请、备案、变更
qual_filing_expert 专家库
account 账号

三、二期新建表30

序号 表名 作用
1 qual_review_task 资质审核 多阶段审核任务
2 qual_review_action 资质审核 审核/确认/反馈动作流水
3 qual_review_expert_assign 资质审核 专家指派与核验
4 qual_site_review_notice 资质审核 现场审查通知(含机构确认与反馈)
5 qual_publicity 资质审核 备案公示
6 biz_rule 规则 资质保持 / 风险预警规则domain_code 区分)
7 qual_keep_check 资质保持 机构维度校验结果头
8 qual_keep_check_item 资质保持 分项结论与来源快照
9 risk_warning 风险预警 预警主单
10 risk_warning_action 风险预警 处置流水
11 eval_customer 安评业务 安评客户
12 eval_project 安评业务 安评项目主表
13 eval_project_member 安评业务 项目成员
14 eval_project_doc 安评业务 项目资料协同
15 eval_project_doc_ver 安评业务 资料版本
16 eval_node_def 节点引擎 节点定义(可配置增删)
17 eval_node_inst 节点引擎 项目节点实例
18 eval_node_form 节点引擎 通用节点表单
19 eval_node_form_item 节点引擎 表单分项 / 参与人
20 eval_node_file 节点引擎 节点附件
21 eval_survey 踏勘专表 现场踏勘主单
22 eval_survey_checkin 踏勘专表 现场打卡(含 APP 任务状态)
23 eval_report_draft 报告专表 报告编制稿
24 eval_sign_task 签字 签字任务
25 eval_sign_record 签字 签字记录
26 eval_report 报告库 报告主表
27 eval_report_spotcheck 报告库 抽查与整改复核
28 org_profile_score 画像 机构画像得分(含 metric_json
29 insp_notice 监督检查 告知主单(含检查结果)
30 insp_notice_material 监督检查 材料清单与反馈

四、逻辑关联

org_info
  ├── qual_filing ── qual_review_task ──┬── qual_review_action
  │                                    ├── qual_review_expert_assign
  │                                    ├── qual_site_review_notice
  │                                    └── qual_publicity
  ├── biz_rule(KEEP) ── qual_keep_check ── qual_keep_check_item
  ├── biz_rule(WARNING) ── risk_warning ── risk_warning_action
  ├── eval_customer ── eval_project ──┬── eval_project_member
  │                                   ├── eval_project_doc ── eval_project_doc_ver
  │                                   ├── eval_node_inst ← eval_node_def
  │                                   │     ├── eval_node_form ── item / file
  │                                   │     ├── eval_survey ── eval_survey_checkin
  │                                   │     ├── eval_report_draft
  │                                   │     └── eval_sign_task ── eval_sign_record
  │                                   └── eval_report ── eval_report_spotcheck
  ├── org_profile_score
  └── insp_notice ── insp_notice_material
逻辑字段 指向
org_id org_info.id
filing_id qual_filing.id
expert_id qual_filing_expert.id
customer_id eval_customer.id
project_id eval_project.id
node_def_id / node_code eval_node_def
node_inst_id eval_node_inst.id
form_id eval_node_form.id
survey_id eval_survey.id
warning_id / source_warning_id risk_warning.id
sign_task_id eval_sign_task.id
report_id eval_report.id
rule_id biz_rule.id
personnel_id org_personnel.id
account_id account.id

五、业务数据流

5.1 资质审核与保持预警

机构填报 qual_filing → 生成 qual_review_task → 审核动作 / 专家核验 / 现场审查通知 → 公示 qual_publicity → 按 biz_rule(KEEP) 校验写入 qual_keep_check* → 异常生成 risk_warningrisk_warning_action 闭环。

5.2 安评项目

维护 eval_customer → 创建 eval_project 及成员、资料 → 按 eval_node_def 生成 eval_node_inst → 通用节点办理表单;踏勘 / 报告编辑 / 签字走专表 → 归档生成 eval_report → 抽查与画像计分。

5.3 监督检查

创建 insp_notice(可关联预警或项目)→ 机构确认与材料反馈 → 结果回写告知主表。

5.4 消息通知

业务状态变更后调用 GBS MessageFacade 发送站内信 / 待办 / 短信;本库不落消息实体。


六、状态字典

对象 字段 取值
审核任务 stage_code 1初审 2专家核验 3现场审查 4会审 5许可审批 6已办结
审核任务 result_code 1通过 2打回 3进行中
预警 category_code 1人员 2机构资质 3项目风险 4资质临期
预警 handle_stage_code 1未处理 2已发机构 3待复核 4已闭环
项目 status_code 1草稿 2进行中 3已归档 4已作废
节点实例 node_status_code 1未开始 2进行中 3已完成 4退回
监督检查 status_code 1已下发 2已确认 3已反馈 4已办结

默认项目节点编码见《节点引擎设计与使用说明》。


七、执行说明

mysql -u<user> -p <database> < docs/db/phase2/init-phase2.sql

在测试库验证后再用于正式环境;勿对一期生产表做破坏性变更。