chore: 更新 CLAUDE.md — 补充 demo-miniprogram、更新 db/ 描述
- 子系统表新增 apps/demo-miniprogram/(MOCK 小程序标杆校对) - db/ 描述从 "DDL/迁移/种子" 更新为 "权威DDL/迁移归档/FDW配置" - db/CLAUDE.md 目录结构对齐实际(schemas/ 为主、migrations 留空、种子已合并) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -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 监控、数据回填、导出等) |
|
||||
|
||||
|
||||
25
db/CLAUDE.md
25
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/ # 种子数据
|
||||
│ ├── 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`),禁止连正式库
|
||||
|
||||
Reference in New Issue
Block a user