admin/sql/README.md

sql/

OMS / 共用库的建表脚本已统一到仓库根目录 db.sql。

职责边界

本目录只放 DDL / 存量迁移 / 字典种子等库结构与一次性数据脚本。

• 运行时业务查询与写入必须走 SqlSugar ORM（仓储），不要在 Application 里用手写 SQL 替代 CRUD。
• 完整编码标准见仓库根目录 README.md →「开发规范」。

使用说明

• 新环境：直接执行 db.sql（会 DROP 后重建，勿在有生产数据的库上执行）
• 已有库：用 diff 对比 db.sql 与现库结构后手工 ALTER；本目录 migrate_all.sql 为存量增量迁移合集（可重复执行段已做列/表存在判断；揽收 Direction / FeePush 为裸 ALTER，已执行过请跳过）
• 数据权限表（user_org_perm 等）若 RBAC 与 OMS 分库，请只在 RBAC 库执行 db.sql 末尾对应段落
• 单次增量迁移命名：migrate_<主题>_YYYYMMDD.sql（日期放在文件名末尾，如 migrate_sales_store_order_provider_fulfillment_20261016.sql）
• 尽量可重复执行（先判断列/表/字典是否已存在）
• 后续新增脚本一律带日期后缀；历史未带日期的脚本不强制改名