6bab0ad84a1619cbd0ced2b3715928047d46c952
- 热力图每门店增加在岗人员行(前厅/后厨/管理/其他),从考勤打卡记录解析 - 新增traffic-heatmap-staffing API,解析考勤打卡时间计算每小时在岗人数 - 人员预测tab新增可折叠规则引擎面板,展示全部规则和触发条件 - 后端API返回ruleEngine字段(动态标准+优化规则+招聘规则+决策逻辑) - R9/R11/R12/R13增加占比超配约束,过滤不合理招聘建议 - 菜单项'菜品成本分析'→'菜品成本','门店费用分析'→'门店费用' - 热力图横向滚动条始终可见
马兰拉面数字化运营管理平台
连锁餐饮数字化运营管理系统 — 任务闭环驱动门店改善
闭环目标
数据发现问题 → 自动分级 → 生成门店任务 → 现场执行 → 周度检查 → 月度验收 → 有效经验标准化
技术栈
- 后端: 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% |
Description
Languages
TypeScript
91.9%
PLpgSQL
7%
Python
0.7%
Shell
0.3%
CSS
0.1%