From 82c321ef0a4aa40657b7d6c575e725caa0ca01bc Mon Sep 17 00:00:00 2001 From: Neo Date: Mon, 6 Apr 2026 00:48:07 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E6=9B=B4=E6=96=B0=20CLAUDE.md=20?= =?UTF-8?q?=E2=80=94=20=E8=A1=A5=E5=85=85=20demo-miniprogram=E3=80=81?= =?UTF-8?q?=E6=9B=B4=E6=96=B0=20db/=20=E6=8F=8F=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 子系统表新增 apps/demo-miniprogram/（MOCK 小程序标杆校对） - db/ 描述从 "DDL/迁移/种子" 更新为 "权威DDL/迁移归档/FDW配置" - db/CLAUDE.md 目录结构对齐实际（schemas/ 为主、migrations 留空、种子已合并） Co-Authored-By: Claude Opus 4.6 --- CLAUDE.md | 3 ++- db/CLAUDE.md | 27 +++++++++++++++++++++------ 2 files changed, 23 insertions(+), 7 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 3ba66e2..e02f04e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -32,7 +32,8 @@ NeoZQYY Monorepo — 面向台球门店业务的全栈数据平台。多门店 | `apps/tenant-admin/` | 租户管理后台（React+Vite+AntD）— 门店管理员视角，操作业务库 | | `apps/mcp-server/` | MCP Server（PostgreSQL 只读，AI 工具集成） | | `packages/shared/` | 跨项目共享包（enums, money, datetime_utils） | -| `db/` | DDL / 迁移 / 种子数据 | +| `apps/demo-miniprogram/` | MOCK 小程序（假数据驱动，页面样式/展示格式标杆校对） | +| `db/` | 权威 DDL（`schemas/`）/ 迁移归档 / FDW 配置 | | `tools/` | 通用工具（db/reporting/health/h5-to-mp-checker） | | `scripts/ops/` | 日常运维脚本（ETL 监控、数据回填、导出等） | diff --git a/db/CLAUDE.md b/db/CLAUDE.md index 4272348..6a50ccc 100644 --- a/db/CLAUDE.md +++ b/db/CLAUDE.md @@ -30,15 +30,30 @@ CREATE VIEW app.v_xxx AS SELECT ... WHERE site_id = current_setting('app.current ``` db/ ├── etl_feiqiu/ -│ ├── schemas/ # 六层 Schema DDL（meta/ods/dwd/core/dws/app） -│ ├── migrations/ # 迁移脚本（日期前缀：YYYY-MM-DD__slug.sql） -│ ├── seeds/ # 种子数据 -│ └── scripts/ # 测试数据库脚本 +│ ├── schemas/ # 权威 DDL — 六层完整定义（meta/ods/dwd/core/dws/app） +│ ├── migrations/ # 未来增量迁移（v1 已全部归档） +│ ├── ods/ # ODS 补充脚本 +│ └── scripts/ # 测试数据库脚本 ├── zqyy_app/ -│ └── schemas/ # 业务数据库 DDL -└── fdw/ # FDW 跨库只读映射 +│ ├── schemas/ # 权威 DDL — 三层完整定义（public/auth/biz） +│ ├── migrations/ # 未来增量迁移（v1 已全部归档） +│ └── scripts/ # 测试数据库脚本 +├── fdw/ # FDW 跨库只读映射（正向 + 反向 + 测试环境） +└── _archived/ # 归档（v1 迁移 39 个、旧基线） ``` +v1 阶段种子数据已合并进 `schemas/` 对应 DDL 文件末尾，不再单独维护。 + +## DDL 刷新 + +修改 schema 后，重新生成完整 DDL： + +```bash +PYTHONUTF8=1 python tools/db/gen_consolidated_ddl.py +``` + +输出到 `docs/database/ddl/`，然后复制到 `db/*/schemas/` 保持同步。 + ## 测试规范 - 数据库操作使用测试库（`TEST_DB_DSN` / `TEST_APP_DB_DSN`），禁止连正式库