在前后端开发联调前 的提交20260223

db/README.md

@@ -1,21 +1,55 @@
-# db/
+# db/ — 数据库资产目录
 
-## 作用说明
+## 当前状态（2026-02-22 基线重置后）
 
-数据库资产目录，集中管理所有数据库的 DDL、迁移脚本和种子数据。每个数据库实例对应一个子目录。
+完整 DDL 基线已迁移至 `docs/database/ddl/`（按 schema 分文件，从测试库自动导出）。
+本目录保留运行时资产（种子数据、FDW 配置、建库脚本），历史文件已归档。
 
-## 内部结构
+## 目录结构
 
-- `etl_feiqiu/` — ETL 数据库（六层 schema：meta/ods/dwd/core/dws/app）
-  - `schemas/` — DDL 定义（每个 schema 一个文件）
-  - `migrations/` — 迁移脚本（日期前缀命名）
-  - `seeds/` — 种子数据
-- `zqyy_app/` — 业务应用数据库（用户/权限/任务/审批）
-  - `schemas/` / `migrations/` / `seeds/`
-- `fdw/` — PostgreSQL FDW 跨库映射配置
+```
+db/
+├── etl_feiqiu/
+│   ├── schemas/          — 已清空（DDL 基线见 docs/database/ddl/etl_feiqiu__*.sql）
+│   ├── migrations/       — 已归档（全部变更已吸收进新 DDL 基线）
+│   ├── seeds/            — 种子数据（运行时需要）
+│   │   ├── seed_ods_tasks.sql
+│   │   ├── seed_scheduler_tasks.sql
+│   │   ├── seed_dws_config.sql
+│   │   └── seed_index_parameters.sql
+│   └── scripts/
+│       └── create_test_db.sql
+├── zqyy_app/
+│   ├── schemas/          — 已清空
+│   ├── migrations/       — 已归档
+│   ├── seeds/
+│   │   └── admin_web_seed.sql
+│   └── 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/
+```
 
-## Roadmap
+## DDL 基线
 
-- FDW 演进：当前为单机 localhost 映射，未来支持跨主机远程 FDW 配置
-- 引入 schema diff 工具，自动检测生产与测试库结构偏差
-- 考虑 FDW 性能监控与查询下推优化
+新建库或 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/fdw.sql`
+
+重新生成：`python scripts/ops/gen_consolidated_ddl.py`
+
+## 未来迁移
+
+归档后，新的迁移脚本仍放 `migrations/`，文件名格式 `YYYY-MM-DD__描述.sql`。
+每次迁移执行后，建议重新运行 DDL 生成脚本刷新基线。