数据库初始化

脚本顺序

后端仓库 sql/ 目录中的脚本分为主库和可选地区扩展数据。首次部署应先备份目标库，再导入主库脚本；地区扩展数据量较大，按实际业务选择。

不要把多个历史增量脚本无顺序重复执行到同一个库。对于已有环境，先阅读脚本用途并确认是否可重复执行。

核心表

分类	主要表	作用
用户权限	sys_user、sys_role、sys_res	用户、角色和资源主数据
授权关系	sys_user_role、sys_role_res	用户角色与角色资源关系
资源管理	sys_res_group、sys_res_mount	接口分组和视图接口挂载
组织岗位	sys_org、sys_post 及关联表	组织树、岗位和用户关系
基础数据	sys_dict、地区相关表	字典与行政区划
文件能力	sys_file、sys_storage	业务文件与底层存储记录
运维管理	sys_log、sys_config	系统日志和动态参数
App	app_user	App 用户信息

资源关系

sys_res 同时保存菜单、页面、按钮、接口和分组。接口资源通过 group_id 进入接口分组，通过 sys_res_mount 多对多挂载到视图资源。

角色授权最终仍落在 sys_role_res。其中视图资源直接保存资源 ID；通过挂载位置授权的接口资源还会记录挂载 ID，用于准确恢复授权树中的勾选位置。

逻辑删除

核心业务表使用 deleted 与 delete_time：

• deleted = 0：有效数据。
• deleted = 1：已逻辑删除。
• 删除时框架会同步填写 delete_time。

唯一约束如果需要允许“删除后重新创建相同业务编码”，必须结合当前数据库的索引设计验证，不能只依赖应用层校验。

初始化后检查

建议检查：

SELECT COUNT(*) FROM sys_user WHERE deleted = 0;
SELECT COUNT(*) FROM sys_role WHERE deleted = 0;
SELECT COUNT(*) FROM sys_res WHERE deleted = 0;
SELECT COUNT(*) FROM sys_role_res WHERE deleted = 0;
SELECT COUNT(*) FROM sys_config WHERE deleted = 0;

同时确认：

• 管理员用户已绑定管理员角色。
• 管理员角色拥有必要的视图与接口资源。
• 资源的 permission 全局唯一。
• 接口挂载不存在指向已删除资源的有效记录。
• 启用的动态参数可以在管理页面查询到。

操作建议

公开 Demo 和生产环境不要直接执行带 TRUNCATE 的重建脚本。全量清理只适合确认无保留数据的本地开发库。