Neo
d269ee6401
1. docs/ai/app2a_finance_area_system_prompt_20260422_v1.md (新建 · v1.2 生产版): - 基于 app2_finance V5.1 派生 - 板块 C 改"业态收入结构" · 板块 E 改"业态定位与对比" - 新增 H7 硬约束：业态特征引用必须紧跟 payload 真实数据 - H6 扩展区域级 6 类字段缺失降级（储值卡/分渠道现金流/现金流出/会员占比/按星期/日异常） - 经 3 次修正：v1"稀疏" → v1.1 纠正为业务真实 0/非 0 → v1.2 纠正为字段存在/整块缺失 - 已同步百炼控制台 APP ID 0ae965029bc54706bcff44f511ac716b 2. docs/ai/app2_finance_multi_app_design.md (新建 · v2 定稿): - 6 章 + 3 附录 · Q1-Q7 全部决策 · 6 阶段 28 项 checklist - 72 组合数据源支持度三档梳理（必须 / 业务级全店 / 字段存在 vs 整块缺失） - 2 套 prompt 拼接方案 · 2 个派生百炼 APP 策略 3. docs/audit/changes/2026-04-23__app2a_finance_area_integrated.md (新建): - 完整审计记录 · 13 高风险文件逐项注解 - 数据库变更 + 风险与回滚 + 验证方式 + 合规检查 4. docs/audit/audit_dashboard.md (刷新 · 135 条记录) 5. scripts/ab_test_app2a_area.py (新建): - 8 业态 × 3 轮 = 24 次采样评估含金量 - 自动检测 H1/H2/H3/H7 硬约束通过率 + seq11 三色灯分布 6. scripts/ab_to_cache.py (新建): - 复用 A/B 结果直接写 ai_cache · 绕开百炼预算验证 UI 端到端 A/B 实测 24/24 成功 · 12 条齐整率 100% · H1/H3/H7 100% · 达生产级。 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）