巫溪县安全评价在线监管一件事 — 数据库设计文档
版本：v1.2
依据：产品原型 PDF（设计文件 1–12）
数据库：MySQL 8.0+ / InnoDB / utf8mb4_unicode_ci
ORM：MyBatis-Plus（通用字段与 @TableLogic 对齐）
1. 文档说明
1.1 设计目标
| 业务域 |
原型模块 |
核心表 |
| 机构认证 |
认证信息（填写→审核中→通过） |
org_info、org_certification_audit |
| 企业信息管理 |
机构信息、资质、人员、部门岗位、装备 |
org_*、staff_*、equip_info |
| 人员异动 |
人员变更、离职申请 |
staff_change_log、staff_resignation_apply |
| 资质备案 |
备案申请（4步）、变更、已备案 |
filing_* |
| 系统支撑 |
用户、附件、审核、字典、区划 |
sys_*、audit_record |
阅读指引：§2 ER 图与关联矩阵 → §3 每张表作用与关系（核心） → §4–§8 字段明细 → §11 表清单总览
1.2 命名规范
| 项 |
规范 |
| 表名 |
小写 + 下划线；前缀 sys_ / org_ / staff_ / filing_ / equip_ |
| 字段 |
Java 驼峰 → 数据库下划线，如 createTime → create_time |
| 主键 |
id BIGINT UNSIGNED |
| 外键 |
{实体}_id，逻辑外键，应用层约束 |
| 日期 |
DATE：仅年月日（出生日期、证书有效期、签署日期等） |
| 时间 |
DATETIME：年月日时分秒（创建、提交、审核、登录等） |
| 逻辑删除 |
字段名固定 deleted（不转下划线），0 未删 / 1 已删 |
1.3 通用字段（与 MyBatis-Plus BaseEntity 对齐）
业务表（可增删改）均包含以下 5 个字段：
/** 创建时间 */
@TableField(fill = FieldFill.INSERT)
private LocalDateTime createTime;
/** 创建人 */
@TableField(fill = FieldFill.INSERT)
private String createBy;
/** 更新时间 */
@TableField(fill = FieldFill.INSERT_UPDATE)
private LocalDateTime updateTime;
/** 更新人 */
@TableField(fill = FieldFill.INSERT_UPDATE)
private String updateBy;
/** 删除标识 0-否 1-是 */
@TableLogic(value = "0", delval = "1")
@TableField(fill = FieldFill.INSERT)
private Integer deleted;
对应 DDL：
create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
create_by VARCHAR(64) DEFAULT NULL COMMENT '创建人',
update_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
update_by VARCHAR(64) DEFAULT NULL COMMENT '更新人',
deleted TINYINT NOT NULL DEFAULT 0 COMMENT '删除标识0-否1-是'
例外（只增不改的流水表） 仅保留 create_time、create_by（及业务时间字段）：
audit_record — 审核流水org_certification_audit — 认证审核历史staff_change_log — 人员变更记录filing_change_detail — 备案变更明细
1.4 附件设计
证书图片、材料扫描件、离职报告、单位介绍附件等 不单独建业务字段存 URL，统一走 sys_attachment：
| biz_type |
关联 biz_id |
原型场景 |
| org_intro |
filing_application.id / org_info.id |
单位基本情况介绍上传 |
| org_cert |
org_qualification_cert.id |
机构资质证书图片 |
| staff_cert |
staff_certificate.id |
人员证书附件 |
| filing_material |
filing_application_material.id |
申请材料扫描件 |
| filing_commitment_sign |
filing_commitment.id |
法人签名 |
| filing_commitment_seal |
filing_commitment.id |
单位盖章 |
| resign_report |
staff_resignation_apply.id |
离职通知报告 PDF |
| staff_ability_proof |
staff_info.id |
申报专业能力证明材料 |
2. ER 关系总览
以下为全局 ER 与关联矩阵；每张表的业务职责、上游引用、下游被引用 见 §3 数据表作用与关系说明。
erDiagram
org_info ||--o{ org_department : "org_id"
org_department ||--o{ org_position : "dept_id"
org_info ||--o{ staff_info : "org_id"
org_department ||--o{ staff_info : "dept_id"
org_position ||--o{ staff_info : "position_id"
staff_info ||--o{ staff_certificate : "staff_id"
org_info ||--o{ org_qualification_cert : "org_id"
org_info ||--o{ org_certification_audit : "org_id"
org_info ||--o{ equip_info : "org_id"
org_info ||--o{ filing_application : "org_id"
filing_application ||--o{ filing_application_material : "application_id"
filing_application ||--o{ filing_application_staff : "application_id"
filing_application_staff ||--o{ filing_application_staff_cert : "application_staff_id"
filing_application ||--o| filing_commitment : "application_id"
filing_application ||--o| filing_record : "application_id"
filing_record ||--o{ filing_change_record : "filing_record_id"
filing_change_record ||--o{ filing_change_detail : "change_record_id"
staff_info ||--o{ staff_change_log : "staff_id"
staff_info ||--o{ staff_resignation_apply : "staff_id"
sys_user ||--o| staff_info : "user_id"
sys_user }o--|| org_info : "org_id"
sys_region ||--o{ filing_record : "filing_region_id"
sys_region ||--o{ org_info : "region_*_id"
2.1 关联矩阵
| 主表 |
从表 |
关系 |
关联字段 |
说明 |
| org_info |
org_department |
1:N |
org_id |
部门树 |
| org_department |
org_position |
1:N |
dept_id |
部门下岗位 |
| org_info |
staff_info |
1:N |
org_id |
机构人员 |
| org_department |
staff_info |
1:N |
dept_id |
人员所属部门 |
| org_position |
staff_info |
1:N |
position_id |
人员岗位 |
| staff_info |
staff_certificate |
1:N |
staff_id |
人员证书 |
| staff_info |
staff_change_log |
1:N |
staff_id |
变更追溯 |
| staff_info |
staff_resignation_apply |
1:N |
staff_id |
离职申请 |
| org_info |
org_qualification_cert |
1:N |
org_id |
机构资质 |
| org_info |
equip_info |
1:N |
org_id |
装备 |
| org_info |
filing_application |
1:N |
org_id |
备案申请 |
| filing_application |
filing_application_material |
1:N |
application_id |
步骤2材料 |
| filing_application |
filing_application_staff |
1:N |
application_id |
步骤3人员 |
| filing_application_staff |
filing_application_staff_cert |
1:N |
application_staff_id |
步骤3人员证书 |
| filing_application |
filing_commitment |
1:1 |
application_id |
步骤4承诺书 |
| filing_application |
filing_record |
1:1 |
application_id |
审核通过后生成 |
| filing_record |
filing_change_record |
1:N |
filing_record_id |
备案变更 |
| filing_change_record |
filing_change_detail |
1:N |
change_record_id |
变更明细 |
| filing_change_record |
filing_application |
N:1 |
change_application_id |
变更类申请 |
| sys_user |
staff_info |
1:1 |
user_id |
可选绑定 |
| sys_attachment |
各业务 |
N:1 |
biz_type + biz_id |
附件 |
| sys_region |
org_info |
1:N |
region_county_id 等 |
机构所属区划 |
| sys_region |
filing_application / filing_record |
1:N |
filing_region_id |
备案属地 |
| sys_dict |
sys_dict_item |
1:N |
dict_id |
字典项 |
| audit_record |
各审核业务 |
N:1 |
biz_type + biz_id |
审核流水 |
| org_info |
org_certification_audit |
1:N |
org_id |
认证审核历史 |
| org_info |
sys_user |
1:N |
org_id |
机构用户 |
| staff_info |
filing_application_staff |
1:N |
staff_id |
备案时引用人员（可选） |
| staff_certificate |
filing_application_staff_cert |
1:N |
staff_cert_id |
备案时引用证书（可选） |
3. 数据表作用与关系说明
本节按业务域列出 全部 24 张表 的职责及与其他表的关联，便于开发理解数据流向。
箭头含义：A → B 表示 A 表通过外键字段引用 B 表（或多对一归属 B）。
3.1 系统支撑域
sys_user — 系统用户
| 项 |
说明 |
| 作用 |
存储平台登录账号，支撑机构端、监管端身份认证；人员开通账号、重置密码均操作此表。 |
| 对应原型 |
人员信息管理（账号列、重置密码）；认证/备案各模块的操作主体。 |
| 引用（上游） |
org_info（org_id，机构用户必填；监管用户为空） |
| 被引用（下游） |
staff_info.user_id（人员与账号 1:1 可选绑定） |
| 关联方式 |
机构用户：sys_user.org_id = org_info.id；人员账号：staff_info.user_id = sys_user.id |
sys_region — 行政区划
| 项 |
说明 |
| 作用 |
维护省→市→区县→街道→社区树形区划，供机构地址、备案属地下拉选择与列表展示。 |
| 对应原型 |
机构信息「所属县区/镇街道/村社区」；备案列表「备案属地」。 |
| 引用（上游） |
自关联 parent_id → sys_region.id（树形结构） |
| 被引用（下游） |
org_info.region_county_id / region_street_id / region_community_id；filing_application.filing_region_id；filing_record.filing_region_id |
| 关联方式 |
树查询：parent_id；机构/备案：filing_region_id = sys_region.id |
sys_dict — 数据字典
| 项 |
说明 |
| 作用 |
字典类型主表，定义下拉选项分类（备案状态、审核状态、设备状态等）。 |
| 对应原型 |
各页面「请选择」类筛选项、状态标签的后端枚举来源。 |
| 引用（上游） |
无 |
| 被引用（下游） |
sys_dict_item.dict_id |
| 关联方式 |
sys_dict_item.dict_id = sys_dict.id |
sys_dict_item — 字典项
| 项 |
说明 |
| 作用 |
字典具体选项值与展示标签，如「已备案」「未审核」「启用/禁用」。 |
| 对应原型 |
备案状态、离职审核状态、设备状态等下拉框选项。 |
| 引用（上游） |
sys_dict（dict_id） |
| 被引用（下游） |
业务表通过 dict_code + item_value 逻辑引用，无物理外键 |
| 关联方式 |
查询：sys_dict.dict_code = 'filing_status' JOIN sys_dict_item |
sys_attachment — 通用附件
| 项 |
说明 |
| 作用 |
统一管理各业务上传文件（PDF 扫描件、证书图片、签名盖章等），避免各表重复存 URL。 |
| 对应原型 |
资质证书图片、申请材料上传、离职通知报告、承诺书签章、单位介绍附件等。 |
| 引用（上游） |
无物理 FK；通过 biz_type + biz_id 逻辑关联各业务主键 |
| 被引用（下游） |
见 §1.4 biz_type 映射表 |
| 关联方式 |
WHERE biz_type = 'org_cert' AND biz_id = org_qualification_cert.id |
audit_record — 审核流水
| 项 |
说明 |
| 作用 |
记录各类业务的提交、通过、驳回、退回操作及意见，用于审计追溯与状态机还原。 |
| 对应原型 |
机构认证审核、备案审核、离职审核、备案变更审核的状态流转历史。 |
| 引用（上游） |
无；biz_type + biz_id 指向具体业务记录 |
| 被引用（下游） |
无（只增不改的流水表） |
| 关联方式 |
biz_type='filing_application' AND biz_id=filing_application.id |
3.2 机构与企业域
org_info — 机构基本信息
| 项 |
说明 |
| 作用 |
核心主数据表。存储安全评价机构主体信息，承载首次「认证信息」填报、日常「机构信息管理」维护，并为备案申请提供基础数据。 |
| 对应原型 |
认证信息（填写→审核中→通过）；机构信息管理；备案申请第一步单位信息。 |
| 引用（上游） |
sys_region（三区划 ID） |
| 被引用（下游） |
sys_user、org_department、org_position、staff_info、org_qualification_cert、equip_info、filing_application、filing_record、org_certification_audit、staff_change_log、staff_resignation_apply（均含 org_id） |
| 关联方式 |
机构维度数据隔离：*.org_id = org_info.id |
org_certification_audit — 机构认证审核记录
| 项 |
说明 |
| 作用 |
每次提交机构认证时生成一条审核记录，保留提交快照与审核结果，支持「认证审核中/通过/驳回」历史查询。 |
| 对应原型 |
认证信息步骤条：填写信息 → 认证审核中 → 认证通过。 |
| 引用（上游） |
org_info（org_id） |
| 被引用（下游） |
无；可与 audit_record（biz_type=org_certification）并行写入 |
| 关联方式 |
org_certification_audit.org_id = org_info.id |
org_qualification_cert — 机构资质证书
| 项 |
说明 |
| 作用 |
维护机构持有的安全评价等资质证书（等级、编号、有效期、发证机关），证书图片走 sys_attachment。 |
| 对应原型 |
企业信息管理 → 资质信息管理（新增/编辑/禁用/删除证书）。 |
| 引用（上游） |
org_info（org_id）；附件 sys_attachment（biz_type=org_cert） |
| 被引用（下游） |
备案变更：资质变更时触发 filing_change_record（change_type=qualification） |
| 关联方式 |
org_qualification_cert.org_id = org_info.id |
3.3 组织与人员域
org_department — 部门
| 项 |
说明 |
| 作用 |
机构内部组织架构，支持多级部门树（原型左侧过滤树：第一级别、第二级别…）。 |
| 对应原型 |
企业信息管理 → 部门岗位管理 → 部门列表/新增/编辑。 |
| 引用（上游） |
org_info（org_id）；自关联 parent_id |
| 被引用（下游） |
org_position.dept_id；staff_info.dept_id |
| 关联方式 |
树：parent_id = 0 为根；人员：staff_info.dept_id = org_department.id |
org_position — 岗位
| 项 |
说明 |
| 作用 |
定义部门下的岗位及职责，人员录入时选择岗位。 |
| 对应原型 |
部门岗位管理 → 添加岗位/编辑岗位（岗位名称、岗位职责、备注）。 |
| 引用（上游） |
org_info（org_id）；org_department（dept_id） |
| 被引用（下游） |
staff_info.position_id |
| 关联方式 |
org_position.dept_id = org_department.id；staff_info.position_id = org_position.id |
staff_info — 人员信息
| 项 |
说明 |
| 作用 |
机构从业人员主数据，含基本信息、学历经历、专业能力；列表展示部门/岗位/证照摘要；变更时写 staff_change_log。 |
| 对应原型 |
人员信息管理（列表、新增、查看、编辑）；备案向导第三步人员（可引用本表）。 |
| 引用（上游） |
org_info、org_department、org_position、sys_user（均可空） |
| 被引用（下游） |
staff_certificate、staff_change_log、staff_resignation_apply；filing_application_staff.staff_id（可选） |
| 关联方式 |
staff_info.org_id = org_info.id；证书：staff_certificate.staff_id = staff_info.id |
staff_certificate — 人员证书
| 项 |
说明 |
| 作用 |
人员持有的各类执业/作业证书，含类别、编号、有效期；证书附件走 sys_attachment。 |
| 对应原型 |
人员信息管理 → 添加证书/编辑证书/查看证书详情。 |
| 引用（上游） |
staff_info（staff_id）；org_info（org_id 冗余便于按机构查）；sys_attachment（biz_type=staff_cert） |
| 被引用（下游） |
filing_application_staff_cert.staff_cert_id（备案快照可选来源） |
| 关联方式 |
staff_certificate.staff_id = staff_info.id |
staff_change_log — 人员变更记录
| 项 |
说明 |
| 作用 |
人员信息修改时逐字段记录变更前后值，支撑「人员变更管理」列表的变更次数与变更明细查看。 |
| 对应原型 |
人员变更管理（变更事项、变更时间、操作人）；变更内容如「法人：张三→李四」。 |
| 引用（上游） |
staff_info（staff_id）；org_info（org_id） |
| 被引用（下游） |
无；变更可能间接触发 filing_change_record（机构已有备案时） |
| 关联方式 |
staff_change_log.staff_id = staff_info.id；同步更新 staff_info.change_count |
staff_resignation_apply — 人员离职申请
| 项 |
说明 |
| 作用 |
人员离职申请单，含离职原因、预计离职日期、离职通知报告；机构管理员审核后更新人员就职状态。 |
| 对应原型 |
人员离职申请（新增/查看）；人员变更管理 → 离职审核（通过/退回）。 |
| 引用（上游） |
staff_info（staff_id）；org_info（org_id）；sys_attachment（biz_type=resign_report） |
| 被引用（下游） |
audit_record（biz_type=staff_resignation）；审核通过 → 更新 staff_info.employment_status=2 |
| 关联方式 |
staff_resignation_apply.staff_id = staff_info.id |
3.4 装备域
equip_info — 装备信息
| 项 |
说明 |
| 作用 |
评价机构检测仪器设备台账，含分类、型号、流量、校准信息及启用/禁用状态。 |
| 对应原型 |
企业信息管理 → 装备信息管理（新增/编辑/查看/启用禁用/删除）。 |
| 引用（上游） |
org_info（org_id） |
| 被引用（下游） |
无（独立主数据；二期监控模块可引用） |
| 关联方式 |
equip_info.org_id = org_info.id |
3.5 资质备案域
filing_application — 备案申请主表
| 项 |
说明 |
| 作用 |
备案业务流程主表，驱动 4 步向导（基本→材料→人员→承诺书），管理草稿/提交/审核状态；新备案与变更备案共用，通过后生成 filing_record。 |
| 对应原型 |
资质申请管理 → 资质备案申请；备案变更管理中的编辑表单。 |
| 引用（上游） |
org_info（org_id）；sys_region（filing_region_id）；filing_record（parent_filing_record_id，变更备案时） |
| 被引用（下游） |
filing_application_material、filing_application_staff、filing_commitment；审核通过 → filing_record；filing_change_record.change_application_id |
| 关联方式 |
子表均 application_id = filing_application.id；通过后 filing_record.application_id = filing_application.id |
filing_application_material — 备案申请材料
| 项 |
说明 |
| 作用 |
备案向导第 2 步「申请材料清单」行数据，每条材料对应扫描件附件。 |
| 对应原型 |
资质备案申请 → 申请材料清单（内容、格式 pdf、注释、上传附件）。 |
| 引用（上游） |
filing_application（application_id）；sys_attachment（biz_type=filing_material） |
| 被引用（下游） |
无 |
| 关联方式 |
filing_application_material.application_id = filing_application.id |
filing_application_staff — 备案申请人员快照
| 项 |
说明 |
| 作用 |
备案向导第 3 步人员列表；申请提交时从 staff_info 复制或手工录入，与主数据隔离，保证备案历史不受后续人员变更影响。 |
| 对应原型 |
资质备案申请 → 人员信息（姓名、类型、职务、职称、查看证书）。 |
| 引用（上游） |
filing_application（application_id）；staff_info（staff_id，可选） |
| 被引用（下游） |
filing_application_staff_cert（application_staff_id） |
| 关联方式 |
filing_application_staff.application_id = filing_application.id |
filing_application_staff_cert — 备案申请人员证书快照
| 项 |
说明 |
| 作用 |
备案人员关联证书的时点快照，字段对齐 staff_certificate，支持「查看证书」而不回查已变更的主数据。 |
| 对应原型 |
备案人员信息 → 查看证书（证书类型、作业类别、编号、有效期等）。 |
| 引用（上游） |
filing_application（application_id）；filing_application_staff（application_staff_id）；staff_certificate（staff_cert_id，可选） |
| 被引用（下游） |
sys_attachment（biz_type=filing_staff_cert） |
| 关联方式 |
application_staff_id = filing_application_staff.id |
filing_commitment — 法定代表人承诺书
| 项 |
说明 |
| 作用 |
备案向导第 4 步，记录法人签署信息；签名、盖章文件存 sys_attachment。 |
| 对应原型 |
资质备案申请 → 申请单位法定代表人承诺书（签名、盖章、日期）。 |
| 引用（上游） |
filing_application（application_id，1:1） |
| 被引用（下游） |
sys_attachment（filing_commitment_sign / filing_commitment_seal） |
| 关联方式 |
filing_commitment.application_id = filing_application.id（唯一） |
filing_record — 已备案资质记录
| 项 |
说明 |
| 作用 |
备案审核通过后的正式备案台账，含备案编号、属地、业务范围、状态、变更次数；列表即「已备案资质管理」。 |
| 对应原型 |
已备案资质管理；资质备案/变更列表中的「已备案」状态行。 |
| 引用（上游） |
org_info（org_id）；filing_application（application_id）；sys_region（filing_region_id） |
| 被引用（下游） |
filing_application.filing_record_id；filing_change_record.filing_record_id；filing_application.parent_filing_record_id（变更备案） |
| 关联方式 |
filing_record.application_id = filing_application.id；变更：filing_change_record.filing_record_id = filing_record.id |
filing_change_record — 备案变更记录
| 项 |
说明 |
| 作用 |
已备案机构发生人员/资质/单位信息变更时的变更批次主记录，对应「备案变更管理」与「历史变更记录」。 |
| 对应原型 |
备案变更管理（变更次数、备案状态）；说明：人员或资质变更后备案数据进入变更管理。 |
| 引用（上游） |
filing_record（filing_record_id）；org_info（org_id）；filing_application（change_application_id，变更类申请） |
| 被引用（下游） |
filing_change_detail（change_record_id）；完成后 filing_record.change_count + 1 |
| 关联方式 |
filing_change_record.filing_record_id = filing_record.id |
filing_change_detail — 备案变更明细
| 项 |
说明 |
| 作用 |
单次备案变更的字段级明细，展示「由 A 变更为 B」，如法人、联系电话变更。 |
| 对应原型 |
备案变更查看 → 变更内容（由张三变更为李四、由152…变更为187…）。 |
| 引用（上游） |
filing_change_record（change_record_id） |
| 被引用（下游） |
无（只增不改） |
| 关联方式 |
filing_change_detail.change_record_id = filing_change_record.id |
3.6 表关系分层图
【租户根】 org_info
├── sys_user 登录账号
├── org_certification_audit 认证审核历史
├── org_qualification_cert ──→ sys_attachment(org_cert)
├── org_department
│ └── org_position
├── staff_info ──→ sys_user
│ ├── staff_certificate ──→ sys_attachment(staff_cert)
│ ├── staff_change_log
│ └── staff_resignation_apply ──→ sys_attachment(resign_report)
├── equip_info
└── filing_application ──→ sys_region(备案属地)
├── sys_attachment(org_intro)
├── filing_application_material ──→ sys_attachment(filing_material)
├── filing_application_staff ──→ staff_info(可选)
│ └── filing_application_staff_cert ──→ staff_certificate(可选)
├── filing_commitment ──→ sys_attachment(sign/seal)
└── [审核通过] filing_record ──→ sys_region
└── filing_change_record ──→ filing_application(变更类)
└── filing_change_detail
【全局】 sys_region / sys_dict / sys_dict_item / sys_attachment / audit_record
4. 系统与基础表（字段明细）
4.1 sys_user — 系统用户
作用：平台登录账号，机构用户绑定机构，人员可关联账号。
关系：org_id → org_info；被 staff_info.user_id 引用。
原型：人员列表「账号」、重置密码；机构/监管登录主体。
| 字段 |
类型 |
说明 |
| id |
BIGINT |
PK |
| org_id |
BIGINT |
所属机构，监管用户 NULL |
| username |
VARCHAR(64) |
登录账号，UK(username, deleted) |
| password_hash |
VARCHAR(255) |
密码 |
| real_name |
VARCHAR(64) |
姓名 |
| phone |
VARCHAR(20) |
手机 |
| user_type |
TINYINT |
1机构 2监管 3管理员 |
| status |
TINYINT |
0禁用 1正常 |
| last_login_time |
DATETIME |
最后登录 |
| + 通用字段 |
|
|
4.2 sys_region — 行政区划
作用：省市区街道社区树形区划，支撑机构地址与备案属地下拉。
关系：自关联 parent_id；被 org_info、filing_application、filing_record 引用。
原型：备案属地列表（省市区）、机构「所属县区/镇街道/村社区」。
| 字段 |
类型 |
说明 |
| id |
BIGINT |
PK |
| parent_id |
BIGINT |
父级 |
| region_code |
VARCHAR(12) |
国标码 |
| region_name |
VARCHAR(64) |
名称 |
| region_level |
TINYINT |
1省2市3区县4街道5社区 |
| sort_order |
INT |
排序 |
| + 通用字段 |
|
|
4.3 sys_dict / sys_dict_item — 数据字典
作用：sys_dict 定义字典类型；sys_dict_item 存储具体选项值，供各业务状态下拉与展示。
关系：sys_dict_item.dict_id → sys_dict.id；业务表通过 dict_code 逻辑引用。
| dict_code |
用途 |
| filing_status |
未备案 / 已备案 / 驳回 |
| cert_audit_status |
草稿 / 审核中 / 已通过 / 已驳回 |
| org_business_status |
开业 / 停业等 |
| staff_employment_status |
在职 / 离职 |
| resign_audit_status |
未审核 / 已审核 / 已退回 |
| equip_enable_status |
启用 / 禁用 |
| material_format |
pdf 等 |
4.4 sys_attachment — 通用附件
作用：各业务上传文件的统一存储入口，通过 biz_type + biz_id 关联业务记录。
关系：逻辑关联多表，无物理外键；详见 §1.4。
见 §1.4。
4.5 audit_record — 审核流水（无 deleted）
作用：跨业务审核操作流水，记录提交/通过/驳回/退回及意见。
关系：biz_type + biz_id 指向 org_certification / filing_application / staff_resignation / filing_change 等业务记录。
| 字段 |
类型 |
说明 |
| biz_type |
VARCHAR(32) |
org_certification / filing_application / staff_resignation / filing_change |
| biz_id |
BIGINT |
业务ID |
| action |
VARCHAR(16) |
submit / approve / reject / return |
| from_status / to_status |
VARCHAR(32) |
状态流转 |
| opinion |
TEXT |
意见 |
| operate_time |
DATETIME |
操作时间 |
| create_time |
DATETIME |
|
| create_by |
VARCHAR(64) |
操作人 |
5. 机构与企业信息（字段明细）
5.1 org_info — 机构基本信息
作用：机构核心主数据，承载认证填报与日常维护，是多数业务表的租户根。
关系：region_*_id → sys_region；被 org/staff/filing/equip 等全部 org_id 子表引用。详见 §3.2。
原型：认证信息、机构信息管理、备案申请第一步字段。
| 字段 |
类型 |
原型字段 |
| org_name |
VARCHAR(200) |
生产经营单位名称 |
| credit_code |
VARCHAR(18) |
统一社会信用代码 |
| register_address |
VARCHAR(500) |
注册地址 |
| business_address |
VARCHAR(500) |
经营地址 / 办公地址 |
| longitude / latitude |
DECIMAL |
所在地坐标 |
| region_county_id / region_street_id / region_community_id |
BIGINT |
所属县区、镇街道、村社区 |
| safety_industry_category |
VARCHAR(100) |
安全生产监管行业类别 |
| ownership_type |
VARCHAR(32) |
归属类型 |
| gb_industry_code |
VARCHAR(20) |
国民经济行业分类 |
| legal_representative / legal_rep_phone |
|
法定代表人及电话 |
| principal / principal_phone |
|
主要负责人 |
| safety_dept_head / safety_dept_phone |
|
安全管理部门负责人 |
| safety_vp / safety_vp_phone |
|
主管安全副总 |
| production_date |
DATE |
投产日期 |
| business_status |
VARCHAR(16) |
企业经营状态 |
| disclosure_url |
VARCHAR(500) |
信息公开网址 |
| workplace_area / archive_room_area |
DECIMAL |
工作场所/档案室面积 |
| full_time_evaluator_count |
INT |
专职安全评价师数量 |
| registered_safety_engineer_count |
INT |
注册安全工程师数量 |
| fixed_asset_total |
DECIMAL |
固定资产总值（万元） |
| org_intro |
TEXT |
单位基本情况介绍 |
| cert_status |
TINYINT |
0草稿1审核中2已通过3已驳回 |
| cert_submit_time |
DATETIME |
认证提交 |
| cert_approve_time |
DATETIME |
认证通过 |
| + 通用字段 |
|
|
5.2 org_certification_audit — 机构认证审核
作用：记录每次机构认证提交与审核结果，保留提交快照。
关系：org_id → org_info；可与 audit_record（biz_type=org_certification）并行。
| 字段 |
类型 |
说明 |
| org_id |
BIGINT |
机构 |
| audit_status |
TINYINT |
1审核中2通过3驳回 |
| submit_snapshot |
JSON |
提交快照 |
| audit_opinion |
TEXT |
意见 |
| audit_by |
VARCHAR(64) |
审核人 |
| audit_time |
DATETIME |
审核时间 |
| create_time / create_by |
|
仅创建字段 |
5.3 org_qualification_cert — 机构资质证书
作用：机构持有的资质证书台账，变更时可触发备案变更流程。
关系：org_id → org_info；附件 sys_attachment(biz_type=org_cert)。
原型：资质信息管理（证照类型、证书名称、编号、有效期、发证机关、证书图片）。
| 字段 |
类型 |
说明 |
| org_id |
BIGINT |
机构 |
| cert_type |
VARCHAR(64) |
证照类型 |
| cert_name |
VARCHAR(128) |
证书名称 |
| cert_no |
VARCHAR(64) |
证明编号 |
| issue_org |
VARCHAR(128) |
发证机关 |
| issue_date |
DATE |
发证日期 |
| valid_start_date / valid_end_date |
DATE |
有效期 |
| remark |
VARCHAR(500) |
备注 |
| enable_status |
TINYINT |
1正常0禁用（原型「禁用」） |
| 附件 |
sys_attachment |
biz_type=org_cert |
| + 通用字段 |
|
|
6. 组织与人员（字段明细）
6.1 org_department — 部门
作用：机构组织架构树，支撑部门岗位管理与人员部门归属。
关系：org_id → org_info；parent_id 自关联；被 org_position、staff_info 引用。
原型：部门岗位管理，树形筛选（第一级别、第二级别…）。
| 字段 |
类型 |
说明 |
| org_id |
BIGINT |
机构 |
| parent_id |
BIGINT |
父部门，0根 |
| dept_name |
VARCHAR(64) |
部门名称 |
| dept_level |
VARCHAR(32) |
部门级别 |
| leader_name |
VARCHAR(64) |
负责人 |
| sort_order |
INT |
排序 |
| tree_path |
VARCHAR(256) |
物化路径 |
| + 通用字段 |
|
|
6.2 org_position — 岗位
作用：部门下岗位定义，含岗位职责说明。
关系：org_id → org_info；dept_id → org_department；被 staff_info.position_id 引用。
| 字段 |
类型 |
说明 |
| org_id / dept_id |
BIGINT |
机构、部门 |
| position_name |
VARCHAR(64) |
岗位名称 |
| duty_desc |
VARCHAR(500) |
岗位职责 |
| remark |
VARCHAR(255) |
备注 |
| + 通用字段 |
|
|
6.3 staff_info — 人员信息
作用：机构从业人员主数据，关联部门岗位与账号，是证书/变更/离职的上游。
关系：org_id → org_info；dept_id → org_department；position_id → org_position；user_id → sys_user；下游见 staff_* / filing_application_staff。
原型：人员列表（用户名称、账号、部门、岗位、证照名称）；详情（出生日期、性别、身份证、学历、资质范围、专业能力等）。
| 字段 |
类型 |
原型 |
| staff_name |
VARCHAR(64) |
姓名 |
| gender |
TINYINT |
性别 |
| id_card_no |
VARCHAR(18) |
身份证号 |
| birth_date |
DATE |
出生日期 |
| account |
VARCHAR(32) |
账号 |
| dept_id / position_id |
BIGINT |
部门、岗位 |
| education / graduate_school / major |
|
学历、院校、专业 |
| home_address / office_address |
|
现住/办公地址 |
| person_type |
VARCHAR(32) |
人员类型 |
| job_title / professional_title |
|
职务、职称 |
| qualification_scope |
VARCHAR(255) |
资质范围 |
| career_level_cert_no |
VARCHAR(64) |
职业等级及证书编号 |
| is_registered_safety_engineer |
TINYINT |
是否注册安全工程师 |
| self_declared_ability |
TEXT |
自我申报专业能力 |
| work_experience |
TEXT |
主要学习工作经历 |
| publications |
TEXT |
专著专利论文等 |
| employment_status |
TINYINT |
1在职2离职 |
| change_count |
INT |
信息变更数（列表冗余） |
| user_id |
BIGINT |
关联 sys_user |
| + 通用字段 |
|
|
6.4 staff_certificate — 人员证书
作用：人员执业/作业证书明细，列表「证照名称」数据来源。
关系：staff_id → staff_info；org_id → org_info；附件 sys_attachment(staff_cert)；可被 filing_application_staff_cert 快照引用。
原型：证书类型、作业类别、编号、有效期、复核日期、证书图片。
| 字段 |
类型 |
说明 |
| staff_id / org_id |
BIGINT |
人员、机构 |
| cert_name / cert_category / cert_work_category |
|
证照名称、类别、作业类别 |
| cert_no |
VARCHAR(64) |
证书编号 |
| issue_org |
VARCHAR(128) |
发证机关 |
| valid_start_date / valid_end_date / review_date |
DATE |
有效期、复核 |
| 附件 |
sys_attachment |
biz_type=staff_cert |
| + 通用字段 |
|
|
6.5 staff_change_log — 人员变更记录
作用：人员字段变更的审计日志，驱动「信息变更数」统计。
关系：staff_id → staff_info；org_id → org_info；只增不改，无 deleted。
原型：变更事项、变更时间、操作人；人员变更管理列表「信息变更数」。
| 字段 |
类型 |
说明 |
| staff_id / org_id |
BIGINT |
|
| change_item |
VARCHAR(64) |
变更事项 |
| field_name |
VARCHAR(64) |
程序字段名 |
| old_value / new_value |
VARCHAR(500) |
变更前后 |
| change_time |
DATETIME |
变更时间 |
| create_time / create_by |
|
操作人 |
6.6 staff_resignation_apply — 人员离职申请
作用：离职申请与审核，通过后更新 staff_info.employment_status。
关系：staff_id → staff_info；org_id → org_info；附件 sys_attachment(resign_report)；可写 audit_record。
原型：申请人、申请时间、离职原因、备注、预计离职日期、离职通知报告；审核状态、退回原因。
| 字段 |
类型 |
说明 |
| staff_id / org_id |
BIGINT |
|
| applicant_name |
VARCHAR(64) |
申请人 |
| apply_time |
DATETIME |
申请时间 |
| expected_leave_date |
DATE |
预计离职日期 |
| leave_reason / remark |
TEXT |
离职原因、备注 |
| audit_status |
TINYINT |
0未审核1已审核2已退回 |
| reject_reason |
TEXT |
退回原因 |
| audit_by / audit_time |
|
审核人、审核时间 |
| 附件 |
sys_attachment |
biz_type=resign_report |
| + 通用字段 |
|
|
7. 装备管理（字段明细）
7.1 equip_info — 装备信息
作用：评价机构仪器设备台账，独立主数据。
关系：org_id → org_info；无下游业务表（二期监控可引用）。
原型：仪器分类、设备类型、设备名称、型号、流量、厂家、校准单位/初值、现场校验类型、是否双路、启用/禁用。
| 字段 |
类型 |
说明 |
| instrument_category / instrument_type / device_type |
VARCHAR |
分类 |
| device_name / model |
|
名称、型号 |
| flow_desc / min_flow / max_flow |
|
流量说明 |
| manufacturer |
VARCHAR(128) |
厂家 |
| calibration_unit / calibration_initial_value |
|
校准 |
| on_site_calibration_type |
VARCHAR(64) |
现场校验类型 |
| is_dual_channel |
TINYINT |
是否双路 |
| enable_status |
TINYINT |
1启用0禁用 |
| purchase_date |
DATE |
登记日期 |
| + 通用字段 |
|
|
8. 资质备案（字段明细）
8.1 filing_application — 备案申请主表
作用：备案 4 步向导流程主表，串联材料/人员/承诺书子表，审核通过后生成 filing_record。
关系：org_id → org_info；filing_region_id → sys_region；子表 application_id；详见 §3.5。
原型：4 步向导 + 备案变更编辑；列表筛选项（备案编号、备案属地、备案状态、备案单位）。
| 字段 |
类型 |
步骤/说明 |
| application_no |
VARCHAR(32) |
申请编号 |
| application_type |
TINYINT |
1新备案2变更备案 |
| filing_region_id |
BIGINT |
备案属地 |
| filing_unit_name / filing_unit_type |
|
备案单位、类型 |
| register_address / office_address |
|
注册/办公地址 |
| credit_code / qualification_cert_no |
|
信用代码、资质证书编号 |
| legal_rep_and_phone / contact_and_phone |
|
法人及电话、联系人及电话 |
| disclosure_url |
|
信息公开网址 |
| fixed_asset_total / archive_room_area |
|
固定资产、档案室面积 |
| full_time_evaluator_count / registered_safety_engineer_count |
|
评价师、注安师数量 |
| workplace_area / org_intro |
|
建筑面积、单位介绍 |
| business_scope |
VARCHAR(500) |
备案安全评价业务范围 |
| current_step |
TINYINT |
1基本2材料3人员4承诺书 |
| apply_status |
TINYINT |
0草稿1提交2审核中3通过4驳回 |
| filing_record_id |
BIGINT |
通过后关联 |
| parent_filing_record_id |
BIGINT |
变更备案原记录 |
| submit_time / approve_time |
DATETIME |
提交、通过时间 |
| 附件 |
sys_attachment |
biz_type=org_intro |
| + 通用字段 |
|
|
8.2 filing_application_material — 申请材料（步骤2）
作用：备案向导第 2 步材料清单行。
关系：application_id → filing_application；附件 sys_attachment(filing_material)。
| 字段 |
类型 |
原型 |
| material_content |
VARCHAR(255) |
申请材料目录 |
| material_type |
VARCHAR(32) |
纸质版扫描件 |
| file_format |
VARCHAR(16) |
pdf |
| remark |
VARCHAR(500) |
注释 |
| sort_order |
INT |
内容序号 |
| 附件 |
sys_attachment |
biz_type=filing_material |
| + 通用字段 |
|
|
8.3 filing_application_staff — 备案人员快照（步骤3）
作用：备案时点人员快照，与 staff_info 隔离。
关系：application_id → filing_application；staff_id → staff_info（可选）；下游 filing_application_staff_cert。
| 字段 |
类型 |
原型 |
| staff_id |
BIGINT |
可选，来自 staff_info |
| staff_name |
VARCHAR(64) |
人员姓名 |
| person_type / job_title / professional_title |
|
类型、职务、职称 |
| sort_order |
INT |
序号 |
| + 通用字段 |
|
|
8.4 filing_application_staff_cert — 备案人员证书快照
作用：备案人员证书时点快照，支持「查看证书」。
关系：application_staff_id → filing_application_staff；staff_cert_id → staff_certificate（可选）。
原型：人员信息步骤「查看证书」— 与 staff_certificate 字段对齐，申请时独立快照。
| 字段 |
类型 |
说明 |
| application_id |
BIGINT |
备案申请 |
| application_staff_id |
BIGINT |
备案人员 |
| staff_cert_id |
BIGINT |
来源证书，可空 |
| cert_name / cert_category / cert_work_category / cert_no |
|
同 staff_certificate |
| valid_start_date / valid_end_date / review_date |
DATE |
|
| 附件 |
sys_attachment |
biz_type=filing_staff_cert |
| + 通用字段 |
|
|
8.5 filing_commitment — 法定代表人承诺书（步骤4）
作用：备案第 4 步法人承诺签署记录。
关系：application_id → filing_application（1:1）；签章附件走 sys_attachment。
| 字段 |
类型 |
说明 |
| application_id |
BIGINT |
1:1 |
| legal_rep_name |
VARCHAR(64) |
法定代表人 |
| sign_date |
DATE |
签署日期 |
| content_version |
VARCHAR(16) |
模板版本 |
| 签名/盖章 |
sys_attachment |
filing_commitment_sign / seal |
| + 通用字段 |
|
|
8.6 filing_record — 已备案资质
作用：备案通过后正式台账，「已备案资质管理」列表数据源。
关系：org_id → org_info；application_id → filing_application；filing_region_id → sys_region；下游 filing_change_record。
原型列表：备案属地、备案单位、备案编号、备案业务范围、备案状态、变更次数。
| 字段 |
类型 |
说明 |
| org_id |
BIGINT |
机构 |
| application_id |
BIGINT |
来源申请 |
| filing_no |
VARCHAR(32) |
备案编号 |
| filing_region_id |
BIGINT |
备案属地 |
| filing_unit_name |
VARCHAR(200) |
备案单位 |
| business_scope |
VARCHAR(500) |
备案业务范围 |
| filing_status |
VARCHAR(16) |
未备案/已备案/驳回 |
| change_count |
INT |
变更次数 |
| filing_time |
DATETIME |
备案时间 |
| snapshot_json |
JSON |
通过时全量快照 |
| + 通用字段 |
|
|
8.7 filing_change_record — 备案变更
作用：已备案机构变更批次主记录，含变更次数统计。
关系：filing_record_id → filing_record；change_application_id → filing_application；下游 filing_change_detail。
原型：备案变更管理；人员/资质变更后进入；历史变更记录。
| 字段 |
类型 |
说明 |
| filing_record_id / org_id |
BIGINT |
|
| change_application_id |
BIGINT |
变更类 filing_application |
| change_type |
VARCHAR(32) |
personnel / qualification / org_info / mixed |
| change_summary |
VARCHAR(500) |
摘要 |
| change_status |
TINYINT |
0进行中1完成2驳回 |
| change_time |
DATETIME |
完成时间 |
| + 通用字段 |
|
|
8.8 filing_change_detail — 备案变更明细
作用：备案变更字段级前后值对比明细。
关系：change_record_id → filing_change_record；只增不改。
原型：「由张三变更为李四」「由152…变更为187…」。
| 字段 |
类型 |
说明 |
| change_record_id |
BIGINT |
变更记录 |
| change_field / change_field_label |
|
字段、展示名 |
| old_value / new_value |
VARCHAR(500) |
变更前后 |
| create_time / create_by |
|
仅创建 |
9. 业务流程与状态
9.1 机构认证（org_info.cert_status）
0草稿 --暂存/提交--> 1审核中 --通过--> 2已通过
└──驳回--> 3已驳回 --再提交--> 1审核中
9.2 备案申请向导
| current_step |
页面 |
表 |
| 1 |
基本信息 + 上传附件 |
filing_application + sys_attachment(org_intro) |
| 2 |
申请材料清单 |
filing_application_material + sys_attachment |
| 3 |
人员信息 + 证书 |
filing_application_staff + filing_application_staff_cert |
| 4 |
法定代表人承诺书 |
filing_commitment + sys_attachment |
提交后 apply_status → 1/2；监管审核通过 → 写入 filing_record，filing_application.filing_record_id 回写。
9.3 备案变更触发
机构存在有效 filing_record 时，以下变更应生成 filing_change_record + filing_change_detail，并 change_count + 1：
staff_info / staff_certificate 增删改org_qualification_cert 变更org_info 法人、联系方式等关键字段变更
9.4 人员离职
staff_resignation_apply.audit_status:
0未审核 --通过--> 1已审核 → staff_info.employment_status = 2
└──退回--> 2已退回
10. 索引与查询建议
- 列表：
org_id + deleted + 状态字段 + create_time DESC
- 唯一键与逻辑删除：业务唯一键使用
(code, deleted) 组合，避免软删后无法重建
- MyBatis-Plus 全局：
@TableLogic 自动追加 deleted = 0
- 流水表不加
deleted，不做更新
- 大 JSON（snapshot_json）可按年归档
11. 表清单总览（共 24 张）
| # |
表名 |
作用 |
主要关联 |
通用字段 |
| 1 |
sys_user |
登录账号与权限主体 |
org_info ← org_id；→ staff_info |
完整 |
| 2 |
sys_region |
行政区划树 |
自关联 parent_id；→ org_info / filing_* |
完整 |
| 3 |
sys_dict |
字典类型 |
→ sys_dict_item |
完整 |
| 4 |
sys_dict_item |
字典选项值 |
sys_dict ← dict_id |
完整 |
| 5 |
sys_attachment |
统一文件存储 |
逻辑关联各业务 biz_type+biz_id |
完整 |
| 6 |
audit_record |
跨业务审核流水 |
逻辑关联各审核业务 |
仅 create |
| 7 |
org_info |
机构租户根、认证与主数据 |
→ 几乎全部 org_id 子表 |
完整 |
| 8 |
org_certification_audit |
机构认证审核历史 |
org_info ← org_id |
仅 create |
| 9 |
org_qualification_cert |
机构资质证书 |
org_info ← org_id；→ sys_attachment |
完整 |
| 10 |
org_department |
部门组织树 |
org_info ← org_id；→ org_position / staff_info |
完整 |
| 11 |
org_position |
部门岗位 |
org_department ← dept_id；→ staff_info |
完整 |
| 12 |
staff_info |
人员主数据 |
org_info / dept / position / sys_user；→ staff_* |
完整 |
| 13 |
staff_certificate |
人员证书 |
staff_info ← staff_id；→ filing_staff_cert 快照 |
完整 |
| 14 |
staff_change_log |
人员变更审计 |
staff_info ← staff_id |
仅 create |
| 15 |
staff_resignation_apply |
离职申请与审核 |
staff_info ← staff_id；→ sys_attachment |
完整 |
| 16 |
equip_info |
仪器设备台账 |
org_info ← org_id |
完整 |
| 17 |
filing_application |
备案流程主表 |
org_info / sys_region；→ filing_* 子表 / filing_record |
完整 |
| 18 |
filing_application_material |
备案材料（步骤2） |
filing_application ← application_id |
完整 |
| 19 |
filing_application_staff |
备案人员快照（步骤3） |
filing_application ← application_id；→ staff_cert 快照 |
完整 |
| 20 |
filing_application_staff_cert |
备案人员证书快照 |
filing_application_staff ← application_staff_id |
完整 |
| 21 |
filing_commitment |
法人承诺书（步骤4） |
filing_application ← application_id（1:1） |
完整 |
| 22 |
filing_record |
已备案正式台账 |
filing_application ← application_id；→ filing_change_record |
完整 |
| 23 |
filing_change_record |
备案变更批次 |
filing_record ← filing_record_id；→ change_detail |
完整 |
| 24 |
filing_change_detail |
备案变更字段明细 |
filing_change_record ← change_record_id |
仅 create |
各表详细说明见 §3 数据表作用与关系说明；字段定义见 §4–§8。
12. DDL 脚本
完整建表见 database-schema.sql。
13. 修订记录
| 版本 |
日期 |
说明 |
| v1.0 |
2026-06-17 |
初版 |
| v1.1 |
2026-06-17 |
对齐 MyBatis-Plus 通用字段；DATE/DATETIME 区分；新增 filing_application_staff_cert；附件统一 sys_attachment |
| v1.2 |
2026-06-17 |
补充每张表作用与关系说明（§3）、表清单关联列（§11）、字段节引用块 |