Neo-ZQYY/db/README.md

db/ — 数据库资产目录

当前状态（2026-03-15 更新）

完整 DDL 基线已迁移至 docs/database/ddl/（按 schema 分文件，从测试库自动导出）。 本目录保留运行时资产（迁移脚本、种子数据、FDW 配置、建库脚本）。 2026-02-22 基线重置前的旧迁移已归档至 _archived/；之后的新迁移仍在 migrations/ 中。 DDL 基线最近一次刷新：2026-03-15（合并了截至 2026-03-09 的全部迁移）。

目录结构

db/
├── etl_feiqiu/
│   ├── schemas/          — 已清空（DDL 基线见 docs/database/ddl/etl_feiqiu__*.sql）
│   ├── migrations/       — 已清空（全部合并进 DDL 基线，2026-03-15）
│   ├── seeds/            — 已清空（合并进对应 DDL 文件末尾）
│   └── scripts/
│       └── create_test_db.sql
├── zqyy_app/
│   ├── schemas/          — 已清空
│   ├── migrations/       — 已清空（全部合并进 DDL 基线，2026-03-15）
│   ├── seeds/            — 已清空（合并进对应 DDL 文件末尾）
│   └── scripts/
│       └── create_test_db.sql
├── fdw/                  — FDW 跨库映射配置（正式 + 测试 + 反向）
│   ├── setup_fdw.sql
│   ├── setup_fdw_test.sql
│   ├── setup_fdw_reverse.sql
│   └── setup_fdw_reverse_test.sql
└── _archived/            — 归档（旧 DDL + 基线重置前的迁移脚本，仅供历史参考）
    └── ddl_baseline_2026-02-22/

DDL 基线

新建库或 schema diff 请使用：

• docs/database/ddl/etl_feiqiu__meta.sql
• docs/database/ddl/etl_feiqiu__ods.sql
• docs/database/ddl/etl_feiqiu__dwd.sql
• docs/database/ddl/etl_feiqiu__core.sql
• docs/database/ddl/etl_feiqiu__dws.sql
• docs/database/ddl/etl_feiqiu__app.sql（仅视图）
• docs/database/ddl/zqyy_app__public.sql
• docs/database/ddl/zqyy_app__auth.sql
• docs/database/ddl/zqyy_app__biz.sql
• docs/database/ddl/fdw.sql（仅正向映射；反向映射见 db/fdw/setup_fdw_reverse*.sql）

重新生成：python scripts/ops/gen_consolidated_ddl.py

迁移管理

项目 1.0 尚未上线，DDL 基线已统一到 docs/database/ddl/（含种子数据）。 后续新增迁移脚本放 migrations/，文件名格式 YYYY-MM-DD__描述.sql。 每次迁移执行后，重新运行 DDL 生成脚本刷新基线：python scripts/ops/gen_consolidated_ddl.py 种子数据已合并进对应 DDL 文件末尾，不再单独维护 seeds/ 目录。