Neo
8458cfaae2
回答 Neo 在 01-W1-findings-response.md 上写的 5 个新问题: 1. F1-3 Frozen >1 年 - 本地硬盘 tar.zst 即可, 不必对象存储 2. F2-1 OpenAPI 作用深入浅出 - "厨房菜单 vs 大堂菜单"比喻 + 5 个使用场景 (FastAPI 双层结构 + 28 天 stale 不破坏运行的原因) 3. F2-2 自建 Gitea 优化 - .gitea/workflows/ 替代 GitHub Actions, 默认仍 5 分钟版 (步骤 1+2+5), 启 Actions 可选 4. F3-2 system prompt 计费 - 100% 计入 (Qwen 无 caching 折扣) + 推荐方案 A 全 prompt 入 git 单源 (新增 Wave 5 prompt 治理任务) 5. F3-4 全 API 端点遍历 - ~25-30 端点 / 半天集中改造, 兑现 Wave 0 全览调研价值 (推荐 Wave 5 集中, 不分散) 最终 Wave 总分配: - Wave 1 (进行中): F1-5 - Wave 2 前 (立即): F2-1A 恢复脚本 - Wave 2: F1-1 / F2-1B hook / F3-1 / F3-2A / F3-3 - Wave 4: F1-2 / F1-3 三层归档 / F3-5 - Wave 5: F2-2 tests / F3-4 全 API 沙箱校验 / F3-2B prompt 治理 (新增) 待 Neo 拍板 3 项: - F2-2 是否启 Gitea Actions - F3-2B 全 App prompt 入 git 单源 是否启动 - F3-4 集中 Wave 5 vs 分散
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）