Neo
e60cfc037c
Neo 在 F1-6 Sprint 2 收尾后反思"项目全局控制度不够,到处没收口"。 经 5 问追溯调研(2 个子代理 + Bash 实证),识别 5 个未收口洞口 + 1 个 未明确登记的大工程,本次完成"登记 + 修订",实际收口动作待逐项推进。 5 个未收口洞口(已登记 backlog §七): - P0 #3 F1-6 Sprint 3 范围描述误导(本次已修订 F1-6-tasks.md §4 拆分 3a/3b) - P0 #5 Sprint 3/4 衔接判断错误(本次已纠正) - P1 #1 3 项迁移后功能验证未做(IDE slash / 8 subagent / MCP 测试库) - P1 #2 2026-04-15~05-02 累积基线 17 天工作待验证 - P2 #4 etl-coupon-detail 30+ 待调研 4 个月未定 文档规范化大工程立项(已登记 backlog §八): - Neo 明确目标:规范化 / 归档 / 对账 / 去重 / 重构 / 零信息损失 - 范围 11 个 docs/ 子目录 + 各模块本地 docs - 工程量 L+(数十小时,需多 sprint) - 状态:立项,详细 spec 待 Neo 调度时立 落地修订: - docs/_overview/architecture-evolution-backlog.md 追加 §七 §八 - docs/_overview/wave1-findings/F1-6-tasks.md §4 Sprint 3 拆分 3a/3b - docs/audit/changes/2026-05-06__global_closure_reflection.md 反思全文 承认:Claude 在跨 sprint 衔接判断上有盲区,本次反思已纠正,未来 sprint 转换 前必须读完整 §4 范围描述,不靠记忆推断。 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）