freedakgmail
4b3a48976d
新增 MonthPicker 的页面(6个): - CostPage: 成本与库存管理 - SKUPage: 商品SKU管理 - PlatformPage: 平台与优惠管理 - MemberPage: 会员与复购管理 - SiteSelectionPage: 门店选址分析 - DataQualityPage: 数据质量看板 容器+子组件添加 MonthPicker(2个页面, 11个子组件): - StoreExpensePage: 门店营业费用分析(10个子组件全部传month) - CostAnalysisPage/StoreTab: 门店成本tab 跳过(后端不支持month参数): - RiskPage: 风险管理(全量视图, 不按月过滤) - TimePage: 时间段分析(全量视图, 不按月过滤)
马兰拉面数字化运营管理平台
连锁餐饮数字化运营管理系统 — 任务闭环驱动门店改善
闭环目标
数据发现问题 → 自动分级 → 生成门店任务 → 现场执行 → 周度检查 → 月度验收 → 有效经验标准化
技术栈
- 后端: Node.js + Express + TypeScript + PostgreSQL (pg)
- 前端: React 18 + TypeScript + Vite + TailwindCSS + Recharts + React Query
- 认证: JWT (角色: hq / regional / store / dept)
- 数据库: PostgreSQL 15,
bill_query@ localhost:5432
项目结构
SBrainCO/
├── package.json # monorepo 根配置
├── server/ # 后端
│ ├── src/
│ │ ├── config/database.ts
│ │ ├── middleware/auth.ts, error.ts
│ │ ├── routes/data.ts, tasks.ts, auth.ts
│ │ ├── types/index.ts
│ │ └── index.ts
│ ├── sql/
│ │ ├── 01_create_tables.sql
│ │ ├── 02_create_functions.sql
│ │ ├── 03_create_views.sql
│ │ └── 04_init_data.sql
│ └── .env
├── client/ # 前端
│ ├── src/
│ │ ├── components/ # Layout, MetricCard, Badge, DataTable
│ │ ├── pages/ # Dashboard, Tasks, StoreDetail, MonthlyReview, Indicators, Regional, Store, Login
│ │ ├── lib/ # api.ts, utils.ts
│ │ ├── App.tsx
│ │ └── main.tsx
│ └── vite.config.ts
└── shared/types.ts
快速启动
1. 安装依赖
# 根目录安装
npm run install:all
2. 初始化数据库
# 按顺序执行SQL脚本
psql -d bill_query -f server/sql/01_create_tables.sql
psql -d bill_query -f server/sql/02_create_functions.sql
psql -d bill_query -f server/sql/03_create_views.sql
psql -d bill_query -f server/sql/04_init_data.sql
3. 启动开发服务器
# 根目录一键启动
npm run dev
# 或分别启动
cd server && npm run dev # 后端 http://localhost:3001
cd client && npm run dev # 前端 http://localhost:5173
4. 访问系统
- 前端: http://localhost:5173
- 后端API: http://localhost:3001/api
- 默认账号:
- 总部管理员 / 123 (hq)
- 区域经理 / 123 (regional)
- 潘家园店长 / 123 (store)
- 商品部 / 123 (dept)
API 接口
数据查询 (25个)
GET /api/overview— 公司概览GET /api/overview/daily— 日度趋势GET /api/stores— 门店列表GET /api/stores/:code— 门店详情GET /api/stores/risk— 风险分级GET /api/stores/priority— 整改优先级GET /api/stores/quadrant— 经营象限GET /api/cost/*— 成本分析GET /api/platform/economics— 平台经济性GET /api/member/*— 会员分析GET /api/sku/*— SKU分析GET /api/risk/*— 风险分析GET /api/time/*— 时间规律GET /api/channel— 渠道结构
任务闭环 (23个)
GET /api/tasks— 任务列表GET /api/tasks/:id— 任务详情POST /api/tasks— 创建任务PUT /api/tasks/:id— 更新任务PUT /api/tasks/:id/execute— 执行反馈PUT /api/tasks/:id/weekly-check— 周度检查PUT /api/tasks/:id/verify— 月度验收POST /api/tasks/:id/rollback— 任务回滚POST /api/tasks/auto-generate— 自动生成任务GET /api/tasks/loop-health— 闭环健康度GET|POST /api/tasks/practices— 经验标准化GET|POST /api/tasks/indicators— 指标字典GET /api/tasks/stores/:code/daily-card— 店长日卡
闭环健康度
| 指标 | 当前值 | 目标 |
|---|---|---|
| 任务生成率 | 100% | ≥95% |
| 店长执行率 | 0% | ≥80% |
| 区域周检率 | 0% | ≥80% |
| 月度验收率 | 0% | ≥80% |
| 经验推广率 | 0% | ≥80% |