safety-eval-service/docs/sql/database-design.md

巫溪县安全评价在线监管一件事 — 数据库设计文档

版本：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. 索引与查询建议

1. 列表：org_id + deleted + 状态字段 + create_time DESC
2. 唯一键与逻辑删除：业务唯一键使用 (code, deleted) 组合，避免软删后无法重建
3. MyBatis-Plus 全局：@TableLogic 自动追加 deleted = 0
4. 流水表不加 deleted，不做更新
5. 大 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）、字段节引用块