本文档由 g2rain-department 的 docs/development/database-conventions.md 自动同步生成。

# 数据库与数据模型

数据库初始化脚本为 scripts/g2rain-department.sql，当前包含：

• department
• department_user_relation
• department_idp_mapping
• data_permission_model
• data_permission_field
• data_permission_meta
• data_permission_group
• data_permission_group_user_relation
• data_permission_other

租户表必须在查询、写入、索引和业务校验中保持 organ_id 一致。使用 WithoutIsolation 查询时，受信 Service 必须显式验证机构边界。

逻辑删除唯一键必须声明语义：

• 删除后允许重建：使用 (IF(delete_flag = 0, 0, NULL)) 函数唯一索引。
• 删除后永久占位：唯一键不包含 delete_flag。

当前 department_idp_mapping 的普通 UNIQUE (..., delete_flag) 尚待整改，见架构差异。初始化脚本与生产增量迁移必须分离，结构变化需说明历史数据、执行顺序、验证和回滚。