chore: 文档与 IDE 配置整理

- .kiro/specs/ → docs/specs/(41 个历史需求 spec 迁移,移除 .config.kiro)
- CLAUDE.md 三层拆分:根文件精简 + apps/backend/CLAUDE.md + .claude/commands/
- 新增 /spec-close、/pre-change 两个工作流命令
- DDL 基线刷新(从测试库重新导出 11 个文件,dws 35→38 表,biz 18→21 表)
- BD_Manual → BD_manual 命名统一(48 个文件)
- 修复 3 处文档与数据库不一致(auth.users.status 默认值、scheduled_tasks 字段、RLS 视图数)
- 新增 BD_manual_public_rbac_tables.md(public schema 8 张 RBAC/工作流表)
- 合并 biz.trigger_jobs 文档(10→12 字段,归档独立文档)
- docs/database/README.md 索引更新

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Neo
2026-04-06 00:02:37 +08:00
parent 8228b3fa37
commit 70324d8542
185 changed files with 13595 additions and 1219 deletions

View File

@@ -1,11 +1,11 @@
# db/ — 数据库资产目录
## 当前状态2026-03-15 更新)
## 当前状态2026-04-05 更新)
完整 DDL 基线已迁移至 `docs/database/ddl/`(按 schema 分文件,从测试库自动导出)。
本目录保留运行时资产迁移脚本、种子数据、FDW 配置、建库脚本
2026-02-22 基线重置前的旧迁移已归档至 `_archived/`;之后的新迁移仍在 `migrations/` 中。
DDL 基线最近一次刷新2026-03-15(合并了截至 2026-03-09 的全部迁移)。
完整 DDL 基线 `docs/database/ddl/`(按 schema 分文件,从测试库自动导出)。
本目录保留运行时资产迁移脚本、FDW 配置、建库脚本。
DDL 基线最近一次刷新:**2026-04-05**(合并了截至 2026-03-31 的全部迁移)。
## 目录结构
@@ -13,44 +13,57 @@ DDL 基线最近一次刷新2026-03-15合并了截至 2026-03-09 的全部
db/
├── etl_feiqiu/
│ ├── schemas/ — 已清空DDL 基线见 docs/database/ddl/etl_feiqiu__*.sql
│ ├── migrations/ — 已清空(全部合并进 DDL 基线,2026-03-15
│ ├── migrations/ — 11 个活跃迁移2026-03-19 ~ 2026-03-31
│ ├── seeds/ — 已清空(合并进对应 DDL 文件末尾)
│ └── scripts/
│ └── create_test_db.sql
├── zqyy_app/
│ ├── schemas/ — 已清空
│ ├── migrations/ — 已清空(全部合并进 DDL 基线2026-03-15
│ ├── seeds/ — 已清空(合并进对应 DDL 文件末尾)
│ ├── migrations/ — 8 个活跃迁移2026-03-20 ~ 2026-03-31+ _archived/
│ ├── seeds/ — 已清空
│ └── 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 + 基线重置前的迁移脚本,仅供历史参考)
├── fdw/ — FDW 跨库映射配置
│ ├── setup_fdw.sql — 正向zqyy_app → etl_feiqiu.app
│ ├── setup_fdw_test.sql — 正向(测试环境)
│ ├── setup_fdw_reverse.sql — 反向etl_feiqiu → zqyy_app.member_retention_clue
│ └── setup_fdw_reverse_test.sql — 反向(测试环境)
└── _archived/ — 归档(2026-02-22 基线重置前的迁移,仅供历史参考)
└── 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`
新建库或 schema diff 请使用 `docs/database/ddl/` 下的文件
重新生成:`python scripts/ops/gen_consolidated_ddl.py`
| 文件 | 数据库 | Schema | 对象数 |
|------|--------|--------|--------|
| `etl_feiqiu__meta.sql` | etl_feiqiu | meta | 3 表 |
| `etl_feiqiu__ods.sql` | etl_feiqiu | ods | 23 表 |
| `etl_feiqiu__dwd.sql` | etl_feiqiu | dwd | 42 表 |
| `etl_feiqiu__core.sql` | etl_feiqiu | core | 7 表 |
| `etl_feiqiu__dws.sql` | etl_feiqiu | dws | 38 表 |
| `etl_feiqiu__app.sql` | etl_feiqiu | app | 仅视图 |
| `zqyy_app__public.sql` | zqyy_app | public | 12 表 |
| `zqyy_app__auth.sql` | zqyy_app | auth | 9 表 |
| `zqyy_app__biz.sql` | zqyy_app | biz | 21 表 |
| `fdw.sql` | — | — | 正向 FDW 映射 |
| `fdw_reverse.sql` | — | — | 反向 FDW 映射 |
重新生成:`PYTHONUTF8=1 python tools/db/gen_consolidated_ddl.py`
## 迁移管理
项目 1.0 尚未上线DDL 基线已统一到 `docs/database/ddl/`(含种子数据)。
后续新增迁移脚本放 `migrations/`,文件名格式 `YYYY-MM-DD__描述.sql`
每次迁移执行后,重新运行 DDL 生成脚本刷新基线`python scripts/ops/gen_consolidated_ddl.py`
每次迁移执行后,重新运行 DDL 生成脚本刷新基线
种子数据已合并进对应 DDL 文件末尾,不再单独维护 `seeds/` 目录。
## 文档分工
| 位置 | 管辖范围 |
|------|---------|
| `docs/database/` | 业务库(zqyy_app) BD_Manual + 跨模块(FDW/RLS) + DDL 基线 |
| `apps/etl/connectors/feiqiu/docs/database/` | ETL 专属(ODS/DWD/DWS 表级文档) |
| `db/`(本目录) | 运行时资产(迁移脚本/FDW 配置/建库脚本) |
| `tools/db/` | 数据库工具(DDL 生成/验证/一致性检查) |