Neo
b3ad4b8325
Neo 反馈: 我把百炼 8 APP 的 system prompt 更新到了 ai_system_prompt_by_app.md, 帮我整理成单独 8+1 个文件, 加说明, 放合适目录, 妥善保管。 新增 docs/ai/system-prompts/ 目录: - _INDEX.md (关系图 + APP ID 映射 + 同步状态表 + SOP) - 9 份独立 MD: app1_chat / app2_finance / app2a_finance_area / app3_clue / app4_analysis / app5_tactics / app6_note / app7_customer / app8_consolidation - 每份带元信息表 + 场景 + 提示词参数 + system prompt 全文 + 协作关系 + 同步历史 (用 4 反引号 ````text 避免内部 ```json 冲突) App2a 厘清 (状态 A): - 与 App2 是两个独立百炼 APP, APP_ID 0ae965029bc54706bcff44f511ac716b - 显示名 ZQYY-APP2a-指定区域财务洞察, env DASHSCOPE_APP_ID_2A_FINANCE_AREA - prompt 是 App2 5/5 版本的精细化扩充: H6 新增'助教成本特殊规则'+ 板块 D 新增'助教字段缺失业态判断'(麻将/KTV 缺失=业态正常 / 大厅/VIP/斯诺克 缺失=业态异常) 改名 + Banner: - docs/ai/ai_system_prompt_by_app.md -> docs/ai/system-prompts/_snapshot-20260505-source.md (git mv 保留历史; 文件头加 Banner 说明已被拆分) A 处置 docs/prd/ai-app-prompts.md (Neo 同意): - 727 行 -> 110 行 (减 84.9%) - 标题改为 '百炼平台 AI 应用集成实现规范' - 删 8 APP system prompt 章节 (已迁移) - 留 NS2 实现要点 + APP ID 映射 (补 App2a 行) + 前端消费方式 (补 App2a 行) + 附录代码审计对照表 修正认知错误: - 5/4 F3-2-prompt-files-list.md 给的对照逻辑 (对照 .py 与云端) 是错的 - .py 是 user message 拼装代码, 不是 system prompt 备份 - 5/5 重写该文件: 对照对象改为 docs/ai/system-prompts/*.md 详见 docs/audit/changes/2026-05-05__wave1_f3_2c_system_prompts_split.md
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）