Neo
ffe309e801
Neo 4 件并行收口指示完成: P1 #1 — 3 项迁移后功能验证 全部 PASS: - 5 个 slash 命令文件全在(audit/db-docs/doc-sync/pre-change/spec-close) - 8 个 subagent 文件全在(本会话已成功调用 Explore 4 次实证) - 双测试库 SELECT 1 通过(test_etl_feiqiu + test_zqyy_app) - 详见 2026-05-06__closure_p1_1_migration_post_verification.md P1 #2 — 2026-04-15~05-02 累积基线 33 项对账(子代理深度对账): - 23 项已完成(70%)+ 5 项部分完成 + 5 项真正未收口 - 大部分被 W1/F1 sprint 体系接管(F1-5a/5b/F1-6/W1-T2/W1-T7) - 5 项真正未收口转登记 backlog §七 #9~#13(各自归到具体后续节点) - 详见 2026-05-06__closure_p1_2_cumulative_baseline_reconciliation.md docs/roadmap/ 目录合并入 backlog §七: - BACKLOG.md(2026-03-27 更新,60+ 项 P0-P2 待办)登记 #6 - 2026-02-24__fdw-dwd-to-core-migration-plan.md 登记 #7 - Neo 指示重要:roadmap 大多数任务"乍一看都适用",但很多逻辑细节 值得再深入调研 — 有些已不适用 / 有些冲突 / 有些被更好方式实现了 - 不批量标已完成或待办,需独立"BACKLOG.md 复核 sprint"逐项细化对账 Wave 0 全栈产品文档体系正式登记 §九: - 已完成 Wave 0(2026-05-04):01-product-overview.md(380 行) + 02a/02b 指纹矩阵 + admin-api-prd 151 端点 + 04-doc-conflicts 39 条 - 完整覆盖 WEB + 小程序 + 数据库 + 后端 + AI 应用矩阵 - 与 §八 文档规范化大工程关系:Wave 0 是骨架,§八 是后续精化重构 backlog §七 13 项洞口现状: - ✅ 已收口 5 项(#1 #2 #3 #5 #8) - ⏳ 待 Neo 评估 1 项(#4 etl-coupon-detail) - ⏳ 待独立 sprint 1 项(#6 BACKLOG.md 复核) - ⏳ 待对照 1 项(#7 fdw migration plan) - ⏳ 累积基线遗留 5 项(#9~#13 各归后续节点) dev 分支领先 origin/dev 9 commit(本会话累计)。 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）