chore: v1 整理 — 清理历史文件、DDL 合并、文档归档

- 清理 1155 个已删除的历史文件(废弃 prompt_logs、tmp、旧 ops 脚本)
- export/ 数据文件从 git 移除(已在 .gitignore)
- demo-miniprogram 从 tmp/ 移入 apps/,添加 CLAUDE.md 注解
- DDL 合并:完整 schema 定义填充到 db/*/schemas/(从 docs/database/ddl/ 复制)
- 39 个 v1 迁移脚本归档到 db/_archived/migrations_v1_merged/
- 4 个迁移变更类 BD_Manual 文档归档到 docs/database/_archived/
- .gitignore 补充 .vite/ 和 apps/*.zip
- settings.json 添加 effortLevel 默认配置
- scripts/ops/ 新增运维脚本入库

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Neo
2026-04-06 00:39:27 +08:00
parent 6f8f12314f
commit 779b2f6d52
1340 changed files with 9124 additions and 132087 deletions

View File

@@ -1,26 +1,23 @@
# db/ — 数据库资产目录
## 当前状态2026-04-05 更新)
## 当前状态2026-04-06 更新)
完整 DDL 基线在 `docs/database/ddl/`(按 schema 分文件,从测试库自动导出)。
本目录保留运行时资产迁移脚本、FDW 配置、建库脚本
DDL 基线最近一次刷新:**2026-04-05**(合并了截至 2026-03-31 的全部迁移)。
项目 v1DDL 不存在迭代更新。完整 schema 定义在 `schemas/` 目录(按 schema 分文件,从测试库导出)。
同一份 DDL 也保留在 `docs/database/ddl/`(文档视角)
## 目录结构
```
db/
├── etl_feiqiu/
│ ├── schemas/ — 已清空DDL 基线见 docs/database/ddl/etl_feiqiu__*.sql
│ ├── migrations/ — 11 个活跃迁移2026-03-19 ~ 2026-03-31
│ ├── seeds/ — 已清空(合并进对应 DDL 文件末尾)
│ ├── schemas/ — 六层完整 DDLmeta/ods/dwd/core/dws/app
│ ├── migrations/ — 未来增量迁移v1 已全部归档
│ ├── ods/ — ODS 补充脚本
│ └── scripts/
│ └── create_test_db.sql
├── zqyy_app/
│ ├── schemas/ — 已清空
│ ├── migrations/ — 8 个活跃迁移2026-03-20 ~ 2026-03-31+ _archived/
│ ├── seeds/ — 已清空
│ ├── schemas/ — 三层完整 DDLpublic/auth/biz
│ ├── migrations/ — 未来增量迁移v1 已全部归档)
│ └── scripts/
│ └── create_test_db.sql
├── fdw/ — FDW 跨库映射配置
@@ -28,42 +25,43 @@ db/
│ ├── 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/
└── _archived/ — 归档
── ddl_baseline_2026-02-22/ — 旧基线
└── migrations_v1_merged/ — v1 全部迁移39 个,已合并进 schemas/
├── etl_feiqiu/ — 11 个迁移
└── zqyy_app/ — 28 个迁移
```
## DDL 基线
## Schema 文件
新建库或 schema diff 请使用 `docs/database/ddl/` 下的文件:
`db/etl_feiqiu/schemas/``db/zqyy_app/schemas/` 是权威的完整 DDL包含建表、索引、约束、种子数据。
| 文件 | 数据库 | 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 映射 |
| `etl_feiqiu/schemas/meta.sql` | etl_feiqiu | meta | 3 表 |
| `etl_feiqiu/schemas/ods.sql` | etl_feiqiu | ods | 23 表 |
| `etl_feiqiu/schemas/dwd.sql` | etl_feiqiu | dwd | 42 表 |
| `etl_feiqiu/schemas/core.sql` | etl_feiqiu | core | 7 表 |
| `etl_feiqiu/schemas/dws.sql` | etl_feiqiu | dws | 38 表 |
| `etl_feiqiu/schemas/app.sql` | etl_feiqiu | app | 仅视图 |
| `zqyy_app/schemas/public.sql` | zqyy_app | public | 12 表 |
| `zqyy_app/schemas/auth.sql` | zqyy_app | auth | 9 表 |
| `zqyy_app/schemas/biz.sql` | zqyy_app | biz | 21 表 |
重新生成:`PYTHONUTF8=1 python tools/db/gen_consolidated_ddl.py`
## 迁移管理
项目 1.0 尚未上线DDL 基线已统一到 `docs/database/ddl/`(含种子数据)
后续新增迁移脚本放 `migrations/`,文件名格式 `YYYY-MM-DD__描述.sql`
每次迁移执行后,重新运行 DDL 生成脚本刷新基线
种子数据已合并进对应 DDL 文件末尾,不再单独维护 `seeds/` 目录
v1 阶段的 39 个迁移已全部合并进 `schemas/` 完整 DDL原文件归档在 `_archived/migrations_v1_merged/`
后续新增迁移放 `migrations/`,文件名格式 `YYYY-MM-DD__描述.sql`
执行后重新运行 DDL 生成脚本刷新 `schemas/` 基线
## 文档分工
| 位置 | 管辖范围 |
|------|---------|
| `docs/database/` | 业务库(zqyy_app) BD_Manual + 跨模块(FDW/RLS) + DDL 基线 |
| `docs/database/` | 业务库(zqyy_app) BD_Manual + 跨模块(FDW/RLS) + DDL 基线副本 |
| `apps/etl/connectors/feiqiu/docs/database/` | ETL 专属(ODS/DWD/DWS 表级文档) |
| `db/`(本目录) | 运行时资产(迁移脚本/FDW 配置/建库脚本) |
| `db/`(本目录) | 权威 DDL + 运行时资产(迁移/FDW/建库脚本) |
| `tools/db/` | 数据库工具(DDL 生成/验证/一致性检查) |