# 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/` 目录。
