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:
Neo
2026-04-06 00:48:07 +08:00
parent 4ab8822848
commit 82c321ef0a
2 changed files with 23 additions and 7 deletions

View File

@@ -32,7 +32,8 @@ NeoZQYY Monorepo — 面向台球门店业务的全栈数据平台。多门店
| `apps/tenant-admin/` | 租户管理后台React+Vite+AntD— 门店管理员视角,操作业务库 |
| `apps/mcp-server/` | MCP ServerPostgreSQL 只读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 监控、数据回填、导出等) |

View File

@@ -30,15 +30,30 @@ CREATE VIEW app.v_xxx AS SELECT ... WHERE site_id = current_setting('app.current
```
db/
├── etl_feiqiu/
│ ├── schemas/ # 六层 Schema DDLmeta/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`),禁止连正式库