在前后端开发联调前 的提交20260223

This commit is contained in:
Neo
2026-02-23 23:02:20 +08:00
parent 254ccb1e77
commit fafc95e64c
1142 changed files with 10366960 additions and 36957 deletions

View File

@@ -4,29 +4,19 @@ inclusion: always
# 产品概述
NeoZQYY Monorepo — 面向台球门店业务的全栈数据平台,包含 ETL Connector、后端 API、管理后台、微信小程序
NeoZQYY Monorepo — 面向台球门店业务的全栈数据平台。
## 子系统
- ETL Connector上游 SaaS API 抽取运营数据,经 ODS → DWD → DWS 三层处理
- FastAPI 后端:业务 API 服务
- 微信小程序C 端用户界面
- 管理后台(`apps/admin-web/`任务管理、调度配置、数据查看、ETL 状态监控(已替代原 PySide6 桌面 GUI
- 共享包:枚举、金额精度、时间工具
> 各子系统路径见 `structure-lite.md`
## ETL 功能
- 从上游 SaaS API 抽取运营数据(订单、支付、会员、助教、库存等)
- 原始数据落地 ODS保留源 payload 便于回溯
- 清洗装载至 DWD维度走 SCD2事实按时间增量
- 汇总至 DWS助教业绩、财务日报、会员分析、工资计算、自定义指数算法WBI/NCI/RS/OS/MS/ML
- 支持在线API 抓取和离线JSON 回放)两种模式
- ETL Connector`apps/etl/connectors/feiqiu/`:上游 SaaS API ODS → DWD → DWS 三层处理
- FastAPI 后端`apps/backend/`:业务 API 服务
- 微信小程序`apps/miniprogram/`C 端用户界面
- 管理后台(`apps/admin-web/`任务管理、调度配置、数据查看、ETL 监控
- MCP Server`apps/mcp-server/`AI 工具集成服务
- 共享包(`packages/shared/`):枚举、金额精度、时间工具
## 业务上下文
- 多门店隔离:通过 `site_id` + RLS 实现
- 多门店隔离:`site_id` + RLS
- 核心实体:会员、助教、台桌、订单、支付、退款、团购套餐、库存
- 领域语言中文为主代码注释、文档、UI 文案均为中文
- 货币人民币CNY金额以 numeric(2) 存储
- 领域语言中文;货币 CNY金额 numeric(2)
## 主要入口
详见 `tech.md` 常用命令节。
> ETL 功能细节、指数算法等见 `product-full.md`fileMatch读到 ETL 任务/模型/业务规则文件时自动加载,也可 `#product-full` 手动加载)。