Neo
254ccb1e77
- admin-web: TaskSelector 重构为按域+层全链路展示，新增同步检查功能 - admin-web: TaskConfig 动态加载 Flow/处理模式定义，DWD 表过滤内嵌域面板 - admin-web: App hydrate 完成前显示 loading，避免误跳 /login - backend: 新增 /tasks/sync-check 对比后端与 ETL 真实注册表 - backend: 新增 /tasks/flows 返回 Flow 和处理模式定义 - apps/mcp-server: 新增 MCP Server 模块（百炼 AI PostgreSQL 只读查询） - scripts/server: 新增 setup-server-git.py + server-exclude.txt - docs: 更新 LAUNCH-CHECKLIST 添加 Git 排除配置步骤 - pyproject.toml: workspace members 新增 mcp-server
NeoZQYY Monorepo
台球门店运营助手一体化平台，整合 ETL 数据 Connector、微信小程序后端、小程序前端与管理后台。
项目结构
| 目录 | 说明 |
|---|---|
| apps/etl/connectors/feiqiu/ | 飞球 Connector（数据源连接器） |
| apps/backend/ | FastAPI 后端（小程序 API） |
| apps/miniprogram/ | 微信小程序（Donut + TDesign） |
| apps/admin-web/ | 管理后台（React + Vite + Ant Design） |
| packages/shared/ | 跨项目共享包（枚举、金额精度、时间工具） |
| db/ | 数据库 DDL、迁移、种子脚本 |
| docs/ | 文档（PRD、契约、权限矩阵、架构等） |
| infra/ | 基础设施配置 |
| scripts/ | 运维/工具脚本 |
| samples/ | 示例数据与配置 |
| 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
- PostgreSQL（六层 Schema：meta/ods/dwd/core/dws/app）
- FastAPI + uvicorn
- React + Vite + Ant Design（管理后台）
- Donut + TDesign（微信小程序）