# project-database-warehouse **Repository Path**: yzj-developer/project-database-warehouse ## Basic Information - **Project Name**: project-database-warehouse - **Description**: 项目数据库仓库 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-03-19 - **Last Updated**: 2026-11-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: warehouse, 汇总 ## README # project-database-warehouse Drug Supply 三库(erp / mall / datacenter)+ `yzj_framework` 的 DDL 版本仓。 > ⚠️ **三个库的管理方式已不一致**,动手前先看清下表。 ## 各库当前的管理方式 | 库 | 管理方式 | 事实来源 | 版本仓的角色 | |----|----------|----------|--------------| | `drug_supply_erp_template` 及客户端云库 | **Flyway**(客户端,2026-10 起)+ 运维按本仓批量处理(云端各库) | **erp 仓** `src/main/resources/db/migration/` | 云端各库的批量执行源(与 Flyway 脚本双写) | | `drug_supply_mall` | **Flyway**(2026-09-19 起) | **mall 仓** `src/main/resources/db/migration/` | 只读参考快照 | | `drug_supply_datacenter` | **Flyway**(2026-09-19 起) | **datacenter 仓** `src/main/resources/db/migration/` | 只读参考快照 | ## erp:怎么加一条 DDL(双写,以 Flyway 脚本为准) erp 客户端(门店 / 总部本机库)由 erp-service 内嵌的 Flyway 启动时迁移;**云端各库(模板库、客户端云库)仍由运维按本仓批量处理**。所以每条变更写两处: 1. 先在 erp 仓新增 `drug-supply-erp-service/src/main/resources/db/migration/V{n}__<描述>.sql`——**唯一事实来源**,发布后不可再改。 2. 把**同一段 SQL** 放进本仓 `drug_supply/v<版本>/erp/`(`<前缀>-structure.sql` 建表 / `<前缀>-alter.sql` 改表),供运维批量执行;同样不再回头改。 3. **运维先处理完云端各库,再发布 ERP 版本给客户端**(数据中心落库不过滤列,云端缺列会打断门店上报的同步)。 4. 用 `sql-version-merge` skill 合并进 `drug_supply_erp_template-latest.sql`,源文件改名为含 `(done)`。 约束同 Flyway:只加不删、新增参与同步的字段须可空或带默认值、DDL 与 DML 分开。细则见 erp 仓 `docs/ddl/README.md`。 `drug_supply_erp_template-latest.sql` 现为 2026-10-02 生产模板导出,也是 erp `V1__baseline.sql` 的来源。 ## datacenter / mall:怎么加一条 DDL **不要在本仓操作。** 到对应仓库新增一个迁移脚本: ``` drug-supply-datacenter-server/drug-supply-datacenter-server/src/main/resources/db/migration/V{n}__<描述>.sql drug-supply-mall-service/drug-supply-mall-service/src/main/resources/db/migration/V{n}__<描述>.sql ``` 应用启动时 Flyway 自动执行并记账到各库的 `flyway_schema_history` 表。三条硬规矩: - **已发布的迁移脚本不可再改**——Flyway 校验 checksum,改了会让所有已应用的库启动失败,修正一律新增 `V{n+1}`。 - **只能 additive**(加列 / 加表 / 加索引),不删列、不改类型。prod / conakry 是滚动更新、新旧容器同时在跑(mall 还是 `replicas: 2`),破坏性变更会打挂还没换掉的旧容器;确需破坏性变更走两阶段(先加新列双写 → 下个版本再删旧列)。 - **DDL 与 DML 要拆成两个迁移**:MySQL 的 DDL 自动提交会截断 Flyway 的事务,混写脚本中途失败会留下 「DDL 已生效、DML 已回滚」的半吊子状态(已实测)。纯 DML 脚本失败则整体回滚,干净。 - 本仓的 `drug_supply-datacenter-latest.sql` 与 `drug_supply_mall-latest.sql` 是快照,**改它们不会生效**。 ## 目录说明 | 路径 | 内容 | |------|------| | `drug_supply/v<版本>/<库>/` | 按版本组织的增量 SQL(`-structure` 建表 / `-alter` 改表 / `-process` 存储过程) | | `drug_supply/*-latest.sql` | 三库基线(**只有 erp 那份是活的**;datacenter 与 mall 两份是只读快照) | | `drug_supply/procedureStructure/` | 存储过程 | | `yzj_framework/` | 框架基础表定义(`datetime` / `timestamp` 两个变体) | | `quartz.sql` / `quartz-linux.sql` | Quartz 调度表 | | `copy-table-execute.sql` | 表复制辅助脚本 | ## 相关背景 - datacenter 改用 Flyway 的完整推理见团队 `.docs/adr/` 的对应 ADR。 - 版本仓手工基线曾整份失准(datacenter 旧基线 14 张表结构准确率为 0),见团队 `.docs/developer/memory/tech-db-warehouse-datacenter-baseline-stale.md`——这是 datacenter 改用 Flyway 的直接动因。