Neo
5d4da0ae8c
F1-5b 大量代码改动落地后,同步 P20 SPEC 反映现状,防止文档与代码偏差。 D1 §6 与 ETL 影子衔接: - 新增 §6.1 "F1-5b 收益":app 视图业务日上界裁剪范围 + 后端读取层 + 写入层 sandbox 隔离 + 业务架构边界(zqyy_app 永不建 RLS) + 跨连接器扩展性 D2 §10 跨模块覆盖矩阵更新: - §10.1 后端服务层:5 个 ? 项核实更新为 X 或 —,各项补 commit 引用 * task_generator / coach_service / customer_service / dispatcher / admin_service - §10.2 AI 提示词:app8_consolidate ? 标"F1-5b 范围外,Wave 2 / F1-6 audit" - §10.3 小程序页面:新增 coach-service-records 行(MP-5);board-* 系列 ? → —(后端走 board_service);customer-detail 备注补 MP-3 + MP-4 D3 §11 已知遗漏: - §11.1 设计共识:新增 zqyy_app 永不建 RLS(A4) + batch_id 命名规约(A5) - §11.2 已知 hack:补 F1-5b T3 间接覆盖说明 - 新增 §11.3 F1-5b 已收口的 11 项遗留 hack ✓ - 新增 §11.4 推迟到 F1-6 沙箱时光机阶段 B 的 4 项 ⏳ - 新增 §11.5 推迟到 F1-7+ 阶段 C 的 3 项 ⏳ D4 §15 变更记录 + §15.1 收益总结 + §12 任务清单: - §15 新增 4 行(F1-5a 走查 / F1-5b Wave A / Wave B / 沙箱时光机 spec) - 新增 §15.1 F1-5b 收益总结:7 大类已落地 + 业务价值 + 未落地指引 - §12 任务清单:T11/T12/T13 F1-5b 三批次摘要 + T18/T19 F1-6/F1-7+ 排期 - audit dashboard 自动刷新(scripts/audit/gen_audit_dashboard.py) 扫描 165 条审计记录(含本次 F1-5b 全部 commit) 无代码改动,纯文档同步。F1-6 启动可直接引用 sandbox-replay-engine-spec + P20 SPEC §11.4/§11.5 排期登记。 审计:docs/audit/changes/2026-05-05__wave1_f1_5b_d1234_spec_sync.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
NeoZQYY Monorepo
台球门店运营助手一体化平台，整合 ETL 数据 Connector、微信小程序后端、小程序前端与管理后台。
项目结构
| 目录 | 说明 | 文档 |
|---|---|---|
apps/etl/connectors/feiqiu/ |
飞球 Connector（API → ODS → DWD → DWS） | docs/ |
apps/backend/ |
FastAPI 后端（13 个路由 · JWT 双认证 · WebSocket） | README · API 参考 |
apps/miniprogram/ |
微信小程序（Donut + TDesign + TypeScript） | README |
apps/admin-web/ |
管理后台（React + Vite + Ant Design） | README |
apps/mcp-server/ |
MCP Server（AI 工具集成，PostgreSQL 只读查询） | README |
packages/shared/ |
共享包（枚举、金额精度、时间工具） | README |
db/etl_feiqiu/ |
ETL 数据库（6 层 Schema：meta/ods/dwd/core/dws/app） | README |
db/zqyy_app/ |
业务数据库（auth 认证 + 任务队列 + 调度） | README |
docs/ |
项目文档中心（架构、数据库、部署、审计） | README |
scripts/ |
运维/工具脚本 | — |
tests/ |
Monorepo 级属性测试 | — |
快速开始
# 安装全部依赖（需要 uv）
uv sync
# 运行 ETL
cd apps/etl/connectors/feiqiu
python -m cli.main --pg-dsn "$PG_DSN" --store-id "$STORE_ID" --api-token "$API_TOKEN"
# 启动后端 API
cd apps/backend
uvicorn app.main:app --reload
# 运行 ETL 单元测试
cd apps/etl/connectors/feiqiu
pytest tests/unit
配置
配置采用分层叠加：根 .env -> 应用 .env.local -> 环境变量 -> CLI 参数。
参见 .env.template 了解可用配置项。
技术栈
- Python 3.10+, uv workspace（4 个成员：etl、backend、mcp-server、shared）
- PostgreSQL 四库：
etl_feiqiu/test_etl_feiqiu（ETL）、zqyy_app/test_zqyy_app（业务） - FastAPI + Uvicorn（后端 API）
- React 19 + Vite 6 + Ant Design 5（管理后台，独立 pnpm）
- 微信小程序原生 + Donut + TDesign + TypeScript（C 端）
- JWT 双认证（管理后台用户名密码 + 小程序微信登录）
- 多门店隔离（
site_id+ RLS）