SBrainCO/V3.0系统实现路径.md

V3.0 系统闭环版 — 对照本系统实现的完整路径

版本：V3.0-Impl-Path
基准文档：连锁企业数字化运营体系（系统闭环版）.md
对照系统：SBrainCO 当前代码库（client/ + server/ + shared/ + db/）
编制日期：2026-08-04

---

目录

1. 总体对照矩阵：V3.0五层架构 vs 系统现状
2. 三条主线实现路径
3. 五个闭环实现路径
4. 日/周/月系统自动流转实现路径
5. 权限与隔离实现路径
6. 系统核心模块架构实现路径
7. 关键系统接口实现路径
8. 分阶段实施路线图

---

一、总体对照矩阵

1.1 五层架构对照

V3.0 层级	V3.0 定位	系统现状	实现状态	差距与路径
第五层：战略层	老板/董事会，看"势"	BossPage.tsx（老板驾驶舱）、BankPage.tsx（银行授信）	部分实现	缺少季度战略看板、投资回报模型、行业对标；需新增战略驾驶舱模块
第四层：决策层	总部各中心，看"阵"	DashboardPage.tsx（总部驾驶舱）、SKUPage.tsx、CostPage.tsx、CentralKitchenPage.tsx、ProductionPlanPage.tsx、BomPenetrationPage.tsx、DistributionReconciliationPage.tsx	大部分实现	缺少产品PLM生命周期管理、营销MA模块；产品中心仅有SKU/菜单工程，无研发流程
第三层：管控层	区域/大区/督导，看"店"	RegionalPage.tsx、RegionComparisonPage.tsx、MonthlyReviewPage.tsx	部分实现	缺少门店自动分级（A/B/C/D）、红黄绿灯自动标色推送、辅导任务派发
第二层：执行层	门店/店长，看"事"	StorePage.tsx（店长工作台）、StoreDetailPage.tsx、TasksPage.tsx、TaskDetailPage.tsx	大部分实现	缺少日目标卡自动生成、时段目标拆解、扫码确认闭环
第一层：作业层	一线员工/设备，看"数"	EmployeePerformancePage.tsx、SmartSchedulingPage.tsx	初步实现	缺少个人数据看板、扫码/IoT自动采集、实时个人绩效推送

1.2 系统技术栈现状

维度	现状
前端	React 18 + TypeScript + Vite + TanStack Query + Tailwind CSS + shadcn/ui + Lucide Icons
后端	Express.js + TypeScript + PostgreSQL（多租户连接池）
认证	JWT（7天TTL）+ bcrypt + 角色路由守卫（RoleRoute组件）
多租户	tenant_configs 表 + 动态连接池切换（tenantContextStorage）
数据隔离	data-scope.ts 中间件 + SQL自动注入 store_code 过滤
API规范	统一 ApiResponse<T> 壳（{success, data, meta, error}）
数据库	PostgreSQL + analytics schema + 物化视图 + 自定义函数

---

二、三条主线实现路径

2.1 主线一：数据流（自下而上，自动汇聚）

现状

环节	V3.0要求	系统现状	状态
采集	POS、IoT、扫码枪、电子秤、人脸识别等多源自动接入	仅有手工导入 bill_records 表 + attendance_records + salary_detail_records；无实时API对接	未实现
清洗	异常数据自动标记 + 规则引擎 + ML异常检测	DataQualityPage.tsx 提供数据质量检查视图；无自动清洗管道	初步实现
聚合	按岗位/门店/区域/总部自动分层聚合	已实现多层物化视图（mv_overview_monthly、mv_store_risk_rating_monthly 等）；10_materialize_slow_views.sql	已实现
分析	自动计算同比/环比/达成率/偏差度/排名/趋势预测	analytics-enhanced.ts 提供会员LTV、菜单工程等分析；situational-awareness.ts 提供健康度评分	大部分实现
呈现	每层只看见权限内数据 + 自动推送	data-scope.ts 实现数据权限隔离；无自动推送机制（缺少消息推送引擎）	部分实现

实现路径

阶段	任务	优先级	依赖
P1	建立 POS 数据实时导入管道（API对接或定时ETL）	高	需POS系统配合
P1	建立数据清洗规则引擎：异常金额、缺失字段、温度异常自动标记	高	依赖采集层
P2	增加趋势预测算法：基于历史数据的简单线性回归/ARIMA	中	依赖聚合层历史数据
P2	建立消息推送引擎：WebSocket 或轮询 + 站内消息中心	中	独立模块
P3	IoT 温控探针对接：MQTT 协议接入冷链温度数据	低	需硬件支持
P3	扫码枪/电子秤对接：蓝牙/WiFi 接入出品扫码、验收扫码	低	需硬件支持

2.2 主线二：决策流（自上而下，目标拆解）

现状

层级	V3.0要求	系统现状	状态
战略层	年度战略目标 → 可行性测算	BossPage.tsx 展示全局指标；无目标拆解功能	未实现
决策层	年度目标 → 区域/品类/供应链目标	无目标管理系统	未实现
管控层	区域目标 → 门店月度目标（按分级差异化）	MonthlyReviewPage.tsx 支持月度验收；无自动目标拆解	未实现
执行层	月度目标 → 日目标卡/时段目标	StorePage.tsx 展示门店数据；无日目标卡自动生成	未实现
作业层	日目标 → 个人任务	EmployeePerformancePage.tsx 展示绩效；无个人任务派发	未实现

实现路径

阶段	任务	优先级	依赖
P1	新建 target_management 表族：annual_target、regional_target、store_monthly_target、daily_target、personal_task	高	无
P1	实现目标自动拆解算法：按历史增速 + 门店分级（A/B/C/D）差异化拆解	高	依赖门店分级模型
P1	店长端日目标卡：每日 09:00 自动生成日目标卡（营收/客单/套餐/损耗/到货）	高	依赖目标拆解
P2	时段目标拆解：按"高峰/平峰/低谷"模型将日目标拆解为时段目标	中	依赖 smart-scheduling.ts 客流热力图数据
P2	个人任务派发：按岗位系数拆解为个人目标（套餐推荐数/出餐时效/会员注册数）	中	依赖 EmployeePerformancePage 扩展
P3	AI 辅助目标测算：基于多因子模型（天气/节假日/商圈活动）自动调整日目标	低	依赖外部数据源

2.3 主线三：执行流（横向协同，闭环跟踪）

现状

环节	V3.0要求	系统现状	状态
目标下达	目标 → 任务池 → 岗位待办	tasks.ts 支持 CRUD + 状态流转；TasksPage.tsx 展示任务列表	已实现
执行记录	扫码/确认 → 数据回传	TaskDetailPage.tsx 支持填写执行证据（process_evidence）；无扫码确认	部分实现
偏差预警	实时比对 → 自动预警 → 纠偏任务	situational-awareness.ts 提供健康度评分 + 红黄绿灯；无自动预警推送	部分实现
纠偏行动	自动生成纠偏任务 → 入池	tasks.ts 支持手动创建任务；无自动触发机制	未实现
结果验证	系统自动检测达成率回升 → 闭环完成	MonthlyReviewPage.tsx 支持月度验收（达标/改善中/未改善）；无实时验证	部分实现

实现路径

阶段	任务	优先级	依赖
P1	任务自动生成引擎：基于指标偏差自动生成整改任务（当前 05_backfill_task_values.sql 为手工批量生成）	高	依赖指标阈值
P1	实时预警推送：当指标突破红/黄灯阈值时，自动推送至对应责任人	高	依赖消息推送引擎
P2	纠偏任务自动入池：预警触发后自动生成纠偏任务，关联原任务	中	依赖预警推送
P2	扫码确认闭环：出品扫码、验收扫码、巡检扫码 → 数据自动回传 → 任务状态自动更新	中	需扫码硬件
P3	闭环自动验证：系统定时检测指标变化，自动判定"闭环完成"或"需升级"	低	依赖实时数据

---

三、五个闭环实现路径

3.1 闭环一：目标闭环（Target Loop）

现状

环节	V3.0要求	系统现状	状态
目标设定	战略输入 → 系统自动拆解	无目标管理系统	未实现
执行跟踪	实时执行跟踪 → 每小时比对达成率	situational-awareness.ts 提供月度健康度；无小时级比对	未实现
偏差分析	归因模型（客流/客单/成本/损耗）	cost-analysis.ts 提供成本偏差分析；无综合归因模型	部分实现
目标校准	下月目标自动调整	无自动校准机制	未实现
强制节点	未达成门店锁定预算 + 根因分析审批	无锁定机制	未实现

实现路径

阶段	任务	优先级
P1	新建 target_loop 表族：annual_target、store_monthly_target、target_deviation_analysis	高
P1	实现目标拆解算法（按门店分级差异化：A店110%、B店100%、C店90%爬坡、D店整改）	高
P1	月末自动比对达成率 + 自动生成偏差分析报告	高
P2	强制锁定机制：达成率<90%的门店，下月预算锁定，必须填写《根因分析》并通过审批	中
P2	连续3个月未达成 → 自动触发"D级预警"推送至决策层	中
P3	目标自动校准：基于历史达成率 + 外部因子自动调整下月目标	低

3.2 闭环二：数据闭环（Data Loop）

现状

环节	V3.0要求	系统现状	状态
采集	多源数据自动接入	手工导入 bill_records；无实时API	未实现
清洗	异常数据自动标记	DataQualityPage.tsx 提供质量检查视图；无自动清洗	初步实现
聚合	数据仓库自动ETL	物化视图 + data_refresh_log 表记录刷新；需手工执行SQL	部分实现
分析	BI引擎自动运算	多个分析路由（analytics-enhanced.ts、cost-analysis.ts、situational-awareness.ts）	已实现
呈现	权限矩阵 + 消息推送	权限隔离已实现；无消息推送	部分实现
决策	看板嵌入"一键下达任务"按钮	SituationalAwarenessPage.tsx 有健康度评分；无一键下达	未实现
执行	任务执行后扫码确认	手工填写 process_evidence；无扫码	部分实现
再采集	执行数据成为新数据源	任务状态变更记录在 store_task_log；未回流为分析数据	初步实现

实现路径

阶段	任务	优先级
P1	建立定时ETL管道：cron job 定期执行物化视图刷新 + 数据导入	高
P1	数据清洗规则引擎：自动标记异常数据（金额异常、时间异常、缺失字段）	高
P2	看板嵌入"一键下达任务"按钮：在 SituationalAwarenessPage 健康度评分异常项旁添加"生成整改任务"按钮	中
P2	消息推送引擎：异常数据自动推送至对应责任人	中
P3	实时数据流：从T+1升级为T+0实时看板（WebSocket推送）	低

3.3 闭环三：业务闭环（Business Loop）

现状

环节	V3.0要求	系统现状	状态
产品上架 → SOP推送	产品中心上架新品 → 自动推送配方SOP至中央厨房	CentralKitchenPage.tsx 展示中央厨房数据；无PLM系统对接	未实现
中央厨房排产	MRP系统自动排产	ProductionPlanPage.tsx 展示生产要货计划；无自动排产算法	部分实现
物流配送	配送系统自动调度	DistributionReconciliationPage.tsx 展示配送对账；无TMS调度	部分实现
门店销售	POS记录	bill_records 表有销售数据；非实时导入	部分实现
顾客反馈	NLP自动归因	无评价分析模块	未实现
产品生命周期	上市7天首周战报、90天存活判定	MenuEngineeringPage.tsx 有菜单工程分析；无生命周期自动追踪	部分实现

实现路径

阶段	任务	优先级
P1	新建 product_lifecycle 表：SKU上市日期、生命周期阶段（爬坡/成熟/衰退）、存活判定	高
P1	顾客评价归因：对接外卖平台评价API + NLP自动分类（口味/服务/环境/异物）	高
P2	产品生命周期自动追踪：上市第7天自动生成"首周战报"、第90天生成"存活判定报告"	中
P2	中央厨房排产算法：基于门店销量预测 + 配方BOM自动计算生产计划	中
P3	全链路自动流转：产品上架 → SOP推送 → 排产 → 配送 → 门店收货 → 销售 → 评价 → 产品决策	低

3.4 闭环四：协同闭环（Collaboration Loop）

现状

协同场景	V3.0要求	系统现状	状态
产销协同	门店销量预测 → 中央厨房MRP → 采购需求 → 供应商接单	ProductionPlanPage.tsx 有生产要货计划；无自动预测和供应商接单	部分实现
营采协同	营销方案 → 物料计算 → 供应链备货 → 门店执行 → ROI	PlatformPage.tsx 有平台优惠分析；无营销-供应链协同	部分实现
产研协同	研发立项 → 试制排期 → 成本测算 → 盲测 → 上市决策	无研发管理系统	未实现
人才盘点	绩效聚合 → 九宫格 → 晋升推荐 → 培训计划	EmployeePerformancePage.tsx 有绩效展示；无九宫格/晋升推荐	部分实现
供应链质量协同	验收异常 → 供应商整改 → 复验 → 评分更新	DistributionReconciliationPage.tsx 有配送对账；无供应商SRM	部分实现

实现路径

阶段	任务	优先级
P1	门店销量预测：基于历史数据的简单预测模型（移动平均/指数平滑）	高
P2	人才九宫格：绩效 × 潜力二维矩阵，自动推荐晋升名单	中
P2	供应商评分卡：交货准时率/质量/价格/服务/食安五维度自动评分	中
P3	产销协同全链路：销量预测 → MRP → 采购 → 到货 → 验收 → 数据回传	低
P3	营采协同：营销方案 → 物料需求计算 → 供应链备货 → ROI追踪	低

3.5 闭环五：迭代闭环（Improvement Loop）

现状

环节	V3.0要求	系统现状	状态
执行	全链路数据留痕	store_task_log 记录任务状态变更；task_weekly_check 记录周检查	已实现
复盘	月度/季度自动复盘报告	MonthlyReviewPage.tsx 支持月度验收；无自动复盘报告生成	部分实现
知识沉淀	优秀案例自动归档 + NLP提取要素	standardized_practice 表 + practice_replication 表已建；无NLP自动提取	部分实现
标准更新	案例库触发SOP更新流程	无变更管理流程	未实现
培训下发	新标准 → 培训课件 → 推送至落后门店	无LMS系统	未实现
再执行	巡检验证 + 数据比对验证	task_weekly_check 有周度验证；无培训后验证	部分实现

实现路径

阶段	任务	优先级
P1	自动复盘报告：月末自动生成月度经营分析报告（损益/对标/根因/建议）	高
P2	案例库NLP标签：对 standardized_practice 表的 key_actions 自动提取标签分类	中
P2	变更管理流程：SOP更新申请 → 审批 → 下发 → 确认	中
P3	LMS系统对接：新标准自动转化为培训课件 + 推送 + 追踪完成率	低
P3	培训锁定机制：未完成培训的员工自动锁定排班权限	低

---

四、日/周/月系统自动流转实现路径

4.1 时间驱动（Time-Driven）

现状

触发时间	V3.0要求	系统现状	状态
每日 08:30	自动生成昨日日报	无自动日报生成；StorePage.tsx 展示数据但需手工查看	未实现
每日 09:00	自动生成今日目标卡	无目标卡系统	未实现
每日 12:00/18:00	推送时段达成率	无时段达成率推送	未实现
每日 22:30	生成日复盘模板	无日复盘模板	未实现
每周一 09:00	生成上周数据包	无自动周报	未实现
每月1日 09:00	生成上月经营分析报告	MonthlyReviewPage.tsx 支持月度验收；无自动报告生成	部分实现
每月15日 14:00	生成月中进度报告	无月中进度报告	未实现
每季度首月1日	生成季度战略复盘数据包	无季度报告	未实现

实现路径

阶段	任务	优先级	技术方案
P1	引入定时任务调度器（node-cron）	高	server/src/scheduler/ 新建调度模块
P1	每日 08:30 自动生成昨日日报（SQL聚合 + 模板渲染 + 推送）	高	复用 data.ts 聚合逻辑 + 报告模板
P1	每日 09:00 自动生成日目标卡	高	依赖目标拆解算法
P2	每日 12:00/18:00 推送时段达成率	中	依赖实时数据采集
P2	每周一 09:00 生成上周数据包	中	复用 analytics-enhanced.ts
P2	每月1日 09:00 自动生成月度经营分析报告	中	复用 MonthlyReviewPage 逻辑
P3	每月15日 14:00 月中进度报告	低	依赖目标系统
P3	每季度首月1日 季度战略复盘数据包	低	依赖战略驾驶舱

4.2 事件驱动（Event-Driven）

现状

触发条件	V3.0要求	系统现状	状态
营收达成率 < 80%	红灯预警 → 推送 → 生成促销建议	situational-awareness.ts 有红黄绿灯评分；无自动预警推送	部分实现
差评出现	NLP归因 → 推送对应责任人	无评价分析	未实现
临期品 > 10%	推送促销建议 → 生成促销任务	无临期品监控	未实现
中央厨房产能 > 90%	预警至供应链总监	CentralKitchenPage.tsx 展示产能；无自动预警	部分实现
员工离职率 > 15%	红灯预警 → 推送区域经理 + HR	无离职率自动监控	未实现
食安巡检 < 90分	红灯预警 → 推送 + 停业建议	无巡检系统	未实现
供应链到货准时率 < 95%	黄灯预警 → 启动备选供应商	DistributionReconciliationPage.tsx 有对账；无自动预警	部分实现
新品好评率 < 70%	推送产品中心 → 配方复核	无新品评价追踪	未实现
设备故障 > 2小时	自动派单维修	无IoT设备监控	未实现
库存缺货	推送缺货预警 → 生成调拨建议	无实时库存监控	未实现

实现路径

阶段	任务	优先级	技术方案
P1	建立预警规则引擎：alert_rules 表（指标/阈值/推送对象/升级路径）	高	通用规则配置
P1	营收达成率实时预警：每小时比对日目标 → 红/黄灯 → 推送	高	依赖目标系统 + 推送引擎
P1	差评自动归因：对接外卖平台评价API + NLP分类	高	外部API + AI模型
P2	临期品预警：库存系统实时计算临期比例 → 推送促销建议	中	依赖WMS
P2	供应商到货准时率预警：物流GPS + 温控实时监控	中	依赖TMS
P2	员工离职率预警：HR系统月度聚合 → 红灯 → 推送	中	依赖HR系统
P3	设备故障预警：IoT设备监控 → 自动派单维修	低	依赖IoT硬件
P3	库存缺货预警：实时库存比对 → 生成调拨建议	低	依赖WMS

---

五、权限与隔离实现路径

5.1 纵向权限矩阵（层级隔离）

现状

规则	V3.0要求	系统现状	状态
上级看下级透明	区域经理可查看辖区所有门店明细	data-scope.ts 实现：hq/dept 无限制，regional 按 region 过滤，store 按 storeCode 过滤	已实现
下级不可看上级	店长不可查看区域排名明细	RoleRoute 组件限制路由访问；data-scope.ts 限制数据范围	已实现
平级看排名不看明细	A店店长可查看区域均值和排名，不可看B店明细	data-scope.ts 按 storeCode 过滤；前端展示区域均值	已实现
数据脱敏	区域均值不暴露具体门店名称	前端展示"区域平均"；未做系统级脱敏	部分实现

实现路径

阶段	任务	优先级
P2	系统级数据脱敏：API响应层对 PII 数据（手机/身份证/邮箱）自动脱敏	中
P2	匿名排名机制：平级门店排名显示为"TOP10%"而非具体名次	中
P3	审计日志：所有数据访问记录 audit_logs 表（who/what/when）	低

5.2 横向权限矩阵（职能隔离）

现状

角色	V3.0要求	系统现状	状态
供应链经理	可见采购成本/供应商/库存/物流；不可见单店利润/员工绩效	系统角色仅有 hq/regional/store/dept/platform_admin；无职能角色	未实现
产品经理	可见菜品销量/好评率/配方SOP；不可见门店营收/供应链采购价	同上	未实现
营销经理	可见活动ROI/会员数据/平台评分；不可见单店成本/供应链数据	同上	未实现
HR/培训经理	可见员工档案/绩效/培训；不可见门店营收/成本	同上	未实现
店长	可见本店全部数据/区域匿名均值；不可见其他门店明细/采购价格	data-scope.ts 已实现 store 角色按 storeCode 过滤	已实现
服务员/厨师	可见个人绩效/本店匿名排名；不可见门店营收/成本/利润	无员工级角色	未实现

实现路径

阶段	任务	优先级
P1	扩展角色体系：新增 supply（供应链）、product（产品）、marketing（营销）、hr（HR）职能角色	高
P1	职能数据隔离：按角色限制可见的 API 路由和数据字段	高
P2	员工级角色：新增 employee 角色，仅可见个人绩效看板	中
P2	字段级权限控制：API响应按角色过滤敏感字段（如采购价格对非供应链角色隐藏）	中

5.3 审批流矩阵

现状

操作	V3.0要求	系统现状	状态
门店调薪	店长申请 → 区域经理审批 → 超额升级总部HR	无审批流系统	未实现
门店临时采购	店长申请 → 区域经理审批 → 超额升级供应链总监	无审批流系统	未实现
促销活动	店长申请 → 区域经理审批 → 超额升级营销总监	无审批流系统	未实现
员工晋升	店长申请 → 区域经理+HR审批 → 晋升店长升级总部	无审批流系统	未实现
配方微调	产品经理申请 → 产品总监审批 → 成本变动>5%升级CEO	无审批流系统	未实现
供应商汰换	供应链经理申请 → 供应链总监审批 → 战略供应商升级CEO	无审批流系统	未实现
门店关停	区域经理申请 → 运营总监+财务总监审批 → 连续亏损升级董事会	无审批流系统	未实现

实现路径

阶段	任务	优先级
P2	新建 approval_flow 表族：approval_request、approval_step、approval_rule	中
P2	实现通用审批流引擎：支持多级审批 + 超额升级 + 通知推送	中
P3	各业务场景接入审批流：调薪/采购/促销/晋升/配方/供应商/关停	低

---

六、系统核心模块架构实现路径

6.1 模块对照总览

V3.0模块	系统对应	实现状态	差距
战略驾驶舱	BossPage.tsx + BankPage.tsx	30%	缺少投资回报模型、行业对标、季度战略看板
产品PLM	SKUPage.tsx + MenuEngineeringPage.tsx	25%	缺少研发流程、配方SOP管理、生命周期追踪
供应链SRM	DistributionReconciliationPage.tsx	15%	缺少供应商管理、采购下单、比价议价、绩效评估
中央厨房MES	CentralKitchenPage.tsx + ProductionPlanPage.tsx + BomPenetrationPage.tsx	40%	缺少生产排程算法、工艺监控、食安留样管理
WMS仓储	InventoryTurnoverPage.tsx	15%	缺少库存管理、临期预警、分拣调度、盘点差异
TMS物流	DistributionReconciliationPage.tsx	15%	缺少配送路线、车辆调度、在途温控
门店POS	bill_records 表（手工导入）	20%	缺少实时POS对接、点单收银、会员注册
区域管理	RegionalPage.tsx + RegionComparisonPage.tsx	40%	缺少门店自动分级、红黄绿灯推送、辅导任务派发
门店终端	StorePage.tsx + StoreDetailPage.tsx + TasksPage.tsx	55%	缺少日目标卡、实时看板5分钟刷新、扫码确认
HR系统	EmployeePerformancePage.tsx + SmartSchedulingPage.tsx	20%	缺少招聘、考勤、薪酬、晋升、九宫格
培训LMS	无	0%	完全缺失
营销MA	PlatformPage.tsx + MemberPage.tsx + MemberLTVPage.tsx	30%	缺少活动管理、券码发放、营销自动化
财务ERP	CostPage.tsx + CostAnalysisPage.tsx + StoreExpensePage.tsx	40%	缺少预算管理、资金管控、财务报表
数据采集层	手工导入	10%	缺少POS API、IoT、扫码枪、电子秤、人脸识别
任务管理	tasks.ts + TasksPage.tsx + TaskDetailPage.tsx	65%	已实现CRUD+状态流转+周检查+月验收；缺自动生成+扫码确认
态势感知	situational-awareness.ts + SituationalAwarenessPage.tsx	50%	已实现健康度评分+红黄绿灯；缺实时预警+自动推送
智能排班	smart-scheduling.ts + SmartSchedulingPage.tsx	35%	已实现客流热力图+在岗人员分布；缺自动排班算法
指标字典	IndicatorsPage.tsx + indicator_dictionary 表	70%	已实现指标CRUD+阈值管理
本体标准	OntologyPage.tsx + db/ontology_standard.sql	60%	已实现本体标准展示
风险内控	RiskPage.tsx	40%	已实现风险评分；缺实时预警
选址分析	SiteSelectionPage.tsx	50%	已实现选址分析模型
租户管理	TenantManagementPage.tsx + TenantUsersPage.tsx + admin.ts	70%	已实现多租户+用户管理
TTS语音	tts.ts + BusinessReportDialog.tsx	80%	已实现千问TTS语音播报

6.2 各模块详细实现路径

6.2.1 战略驾驶舱（当前 30% → 目标 80%）

任务	优先级	依赖
新增投资回报模型：单店ROI计算 + 投资回收期 + 城市渗透率	高	依赖 BankPage 扩展
新增季度战略看板：同店增长趋势 + 行业对标 + 资本环境	中	依赖外部数据
新增品牌资产追踪：NPS + 品牌搜索指数 + 舆情健康度	中	依赖舆情监控
年度战略目标管理：目标设定 + 进度追踪 + 调整记录	高	依赖目标系统

6.2.2 产品PLM（当前 25% → 目标 70%）

任务	优先级	依赖
新建 product_lifecycle 表：SKU上市日期、生命周期阶段、存活判定	高	无
配方SOP管理：配方数字化（克重/温度/时间/步骤） + 版本控制	高	无
新品研发流程：立项 → 试制 → 盲测 → 成本测算 → 上市决策	中	依赖中央厨房MES
生命周期自动追踪：7天首周战报 + 90天存活判定	中	依赖 product_lifecycle 表
顾客评价归因：NLP自动分类（口味/分量/温度/异物）	中	依赖评价API

6.2.3 供应链SRM（当前 15% → 目标 60%）

任务	优先级	依赖
新建 supplier_master 表：供应商主数据 + 分级（战略/优选/合格/淘汰）	高	无
供应商评分卡：交货准时率/质量/价格/服务/食安五维度	高	依赖到货验收数据
采购订单管理：下单 → 审批 → 执行 → 到货 → 结算	中	依赖供应商主数据
比价议价：招标/比价/锁价/季节性备货	中	依赖采购订单
备选供应商管理：每品类至少1家备选	低	依赖供应商主数据

6.2.4 中央厨房MES（当前 40% → 目标 75%）

任务	优先级	依赖
生产排程算法：基于门店销量预测 + 配方BOM自动计算排产计划	高	依赖销量预测
工艺监控：关键参数自动记录（温度/时间/重量）	中	依赖IoT
出品管理：批次管理 + 出品抽检 + 盲测记录	中	无
食安留样管理：留样记录 + 检测报告 + 第三方检测	中	无
产能规划：淡旺季弹性 + 预留扩产空间 + 外包备选	低	依赖历史产能数据

6.2.5 区域管理驾驶舱（当前 40% → 目标 80%）

任务	优先级	依赖
门店自动分级：按营收达成+巡检得分+客诉率自动A/B/C/D分级	高	依赖 situational-awareness.ts 评分
红黄绿灯自动标色：实时指标监控 → 自动标色 → 推送	高	依赖预警引擎
辅导任务派发：C/D级门店自动生成辅导任务 → 指派区域经理	中	依赖任务系统
人才梯队表：店长储备 + 晋升通过率 + 储备池健康度	中	依赖HR系统
资源调配：区域营销预算 + 人员跨店调动 + 应急采购审批	中	依赖审批流

6.2.6 门店运营终端（当前 55% → 目标 85%）

任务	优先级	依赖
日目标卡自动生成：每日 09:00 推送日目标（营收/客单/套餐/损耗/到货）	高	依赖目标系统
实时看板 5 分钟刷新：当日营收进度/来客数/客单价/等位数/出餐时效	高	依赖实时数据
日报自动生成：闭店后自动生成日报（达成率/偏差/次日建议）	高	依赖定时调度
扫码确认：出品扫码/验收扫码/巡检扫码 → 数据自动回传	中	依赖扫码硬件
异常上报：门店一键上报异常 → 自动推送区域经理	中	依赖推送引擎

6.2.7 HR系统（当前 20% → 目标 60%）

任务	优先级	依赖
考勤管理：打卡记录 + 工时统计 + 排班匹配	高	依赖 attendance_records
薪酬管理：基本工资 + 绩效奖金 + 调薪审批	中	依赖 salary_detail_records
人才九宫格：绩效 × 潜力 → 自动推荐晋升名单	中	依赖 EmployeePerformancePage
离职预警：月度聚合离职率 → 红灯 → 推送	中	依赖预警引擎
招聘管理：岗位需求 + 候选人 + 面试流程	低	独立模块

6.2.8 培训LMS（当前 0% → 目标 50%）

任务	优先级	依赖
新建 training_course 表：课程管理 + 课件 + 考试	中	无
学习追踪：员工学习进度 + 完成率 + 考试成绩	中	依赖课程管理
SOP更新自动转培训：新SOP → 自动生成培训课件 → 推送	低	依赖SOP管理
培训锁定机制：未完成培训 → 锁定排班权限	低	依赖排班系统

6.2.9 营销MA（当前 30% → 目标 65%）

任务	优先级	依赖
活动管理：活动创建 + 预算分配 + 投放指令 + ROI追踪	中	无
券码发放：券码生成 + 核销追踪 + 防刷机制	中	依赖活动管理
会员运营：分层运营 + 召回策略 + 生命周期管理	中	依赖 MemberPage 扩展
营销自动化：触发条件 → 自动执行（如：沉睡会员自动发券）	低	依赖活动管理

6.2.10 财务ERP（当前 40% → 目标 70%）

任务	优先级	依赖
预算管理：年度预算 + 月度预算 + 执行率追踪	中	依赖目标系统
成本核算：按门店/品类/菜品的多维度成本分析	中	依赖 cost-analysis.ts 扩展
资金管控：现金流 + 账期管理 + 资金计划	低	依赖银行对接
财务报表：损益表 + 现金流量表 + 资产负债表	低	依赖全部业务数据

---

七、关键系统接口实现路径

7.1 接口对照

接口方向	V3.0要求	系统现状	状态
POS → 数据中台	销售流水实时上传	手工导入 bill_records；无实时API	未实现
外卖平台 → 数据中台	外卖订单/评价/退款实时同步	bill_records 有外卖字段（c150-c152）；手工导入	未实现
IoT温控 → 数据中台	温度/湿度/设备状态每5分钟	无IoT对接	未实现
扫码枪 → 数据中台	出品/验收/盘点扫码	无扫码对接	未实现
人脸识别 → HR系统	考勤/排班匹配/工时统计	attendance_records 手工导入	未实现
数据中台 → 区域管理	门店聚合数据/排名/预警/分级	situational-awareness.ts 提供健康度；data.ts 提供聚合数据	已实现
数据中台 → 战略驾驶舱	集团聚合/趋势/对标/预测	data.ts /overview 提供集团汇总；无趋势预测	部分实现
产品PLM → 中央厨房MES	配方SOP/上市计划/工艺参数	无PLM系统	未实现
中央厨房MES → WMS	生产计划/成品入库/配送需求	ProductionPlanPage 有生产要货；无自动对接	部分实现
WMS → TMS	配送订单/分拣清单/温度要求	无WMS/TMS	未实现
TMS → 门店验收APP	配送轨迹/预计到达/温度记录	DistributionReconciliationPage 有对账；无实时轨迹	部分实现
门店验收APP → 供应链SRM	验收结果/退货记录/质量评分	无验收APP	未实现
营销MA → 门店POS	活动方案/券码/推荐位配置	无营销自动化	未实现
HR系统 → 培训LMS	员工档案/岗位/技能等级/培训需求	无LMS	未实现
培训LMS → 门店终端	培训课程/考试任务/技能认证	无LMS	未实现
财务ERP ↔ 全部模块	预算/成本/利润/资金	cost-analysis.ts + store-expense.ts 提供成本费用分析	部分实现

7.2 接口实现路径

阶段	接口	优先级	协议
P1	POS → 数据中台（实时销售流水）	高	REST API
P1	外卖平台 → 数据中台（订单/评价/退款）	高	REST API
P2	数据中台 → 消息推送引擎（预警/任务/报告）	中	WebSocket
P2	产品PLM → 中央厨房MES（配方SOP）	中	内部API
P2	中央厨房MES → WMS（生产计划/配送需求）	中	内部API
P3	IoT温控 → 数据中台（温度/湿度/设备状态）	低	MQTT
P3	扫码枪 → 数据中台（出品/验收/盘点）	低	蓝牙/WiFi
P3	人脸识别 → HR系统（考勤/工时）	低	API
P3	TMS → 门店验收APP（配送轨迹/温度）	低	内部API

---

八、分阶段实施路线图

Phase 1：基础闭环（3-6个月）

目标：建立目标管理 + 定时调度 + 预警引擎 + 数据自动采集

序号	任务	模块	工作量
1	新建目标管理表族 + 目标拆解算法	目标闭环	大
2	引入 node-cron 定时调度器 + 每日日报/目标卡自动生成	时间驱动	中
3	建立预警规则引擎 alert_rules + 红/黄灯自动推送	事件驱动	大
4	POS 数据实时导入管道（API对接或定时ETL）	数据采集	大
5	门店自动分级（A/B/C/D）+ 红黄绿灯自动标色	区域管理	中
6	产品生命周期表 + 顾客评价NLP归因	业务闭环	大
7	扩展角色体系（供应链/产品/营销/HR职能角色）	权限隔离	中
8	数据清洗规则引擎	数据闭环	中
9	看板嵌入"一键下达任务"按钮	数据闭环	小
10	自动复盘报告生成（月度经营分析报告）	迭代闭环	中

Phase 2：协同扩展（6-12个月）

目标：建立协同闭环 + 审批流 + LMS + 营销自动化

序号	任务	模块	工作量
1	供应商主数据 + 评分卡 + 采购订单管理	供应链SRM	大
2	生产排程算法（销量预测 + BOM计算）	中央厨房MES	大
3	通用审批流引擎 + 各场景接入	审批流	大
4	人才九宫格 + 晋升推荐 + 离职预警	HR系统	中
5	培训LMS（课程管理 + 学习追踪 + 考试认证）	培训LMS	大
6	营销活动管理 + 券码发放 + ROI追踪	营销MA	大
7	消息推送引擎（WebSocket + 站内消息中心）	基础设施	中
8	扫码确认闭环（出品/验收/巡检）	执行流	中
9	纠偏任务自动入池 + 闭环自动验证	执行流	中
10	预算管理 + 财务报表	财务ERP	大
11	系统级数据脱敏 + 审计日志	权限隔离	中
12	案例库NLP标签 + 变更管理流程	迭代闭环	中

Phase 3：智能升级（12-24个月）

目标：IoT接入 + AI辅助决策 + 全链路自动流转

序号	任务	模块	工作量
1	IoT温控探针对接（MQTT + 冷链温度实时监控）	数据采集	大
2	扫码枪/电子秤硬件对接	数据采集	大
3	人脸识别考勤对接	数据采集	中
4	AI辅助目标测算（多因子模型：天气/节假日/商圈活动）	决策流	大
5	产销协同全链路自动流转	协同闭环	大
6	营采协同全链路（营销 → 物料 → 备货 → 执行 → ROI）	协同闭环	大
7	实时数据流（T+0看板 + WebSocket推送）	数据闭环	大
8	培训锁定机制（未完成培训 → 锁定排班）	迭代闭环	中
9	资金管控 + 银行对接	财务ERP	大
10	季度战略复盘数据包自动生成 + 投资建议AI测算	战略驾驶舱	大

---

九、现有系统资产清单

9.1 前端页面（36个）

页面	路由	角色权限	对应V3.0模块
BossPage	/boss	hq, dept	战略驾驶舱
DashboardPage	/	hq, dept	决策层看板
SituationalAwarenessPage	/situational-awareness	hq, dept, regional, store	区域管理 + 门店终端
BankPage	/bank	hq	战略驾驶舱（银行授信）
RegionalPage	/regional	hq, dept, regional	区域管理驾驶舱
RegionComparisonPage	/region-comparison	hq, dept, regional	区域管理
StorePage	/store	hq, dept, store	门店运营终端
StoreDetailPage	/stores/:code	hq, regional, store, dept	门店详情
TasksPage	/tasks	hq, regional, store, dept	任务管理
TaskDetailPage	/tasks/:id	hq, regional, store, dept	任务详情
MonthlyReviewPage	/monthly-review	hq, dept, regional	月度验收
SKUPage	/sku	hq, dept	产品PLM
MenuEngineeringPage	/menu-engineering	hq, dept	产品PLM
CostPage	/cost	hq, dept	财务ERP
CostAnalysisPage	/cost-analysis	hq, dept	财务ERP
StoreExpensePage	/store-expense	hq, dept	财务ERP
PlatformPage	/platform	hq, dept	营销MA
MemberPage	/member	hq, dept	营销MA
MemberLTVPage	/member-ltv	hq, dept	营销MA
RiskPage	/risk	hq, dept	风险内控
TimePage	/time	hq, dept	运营分析
DataQualityPage	/data-quality	hq, dept	数据闭环
OntologyPage	/ontology	hq, dept	系统管理
SiteSelectionPage	/site-selection	hq, dept	战略驾驶舱
SmartSchedulingPage	/smart-scheduling	hq, dept, regional, store	HR系统
EmployeePerformancePage	/employee-performance	hq, dept	HR系统
InventoryTurnoverPage	/inventory-turnover	hq, dept	WMS仓储
CentralKitchenPage	/central-kitchen	hq, dept	中央厨房MES
DistributionReconciliationPage	/distribution-reconciliation	hq, dept	TMS物流
BomPenetrationPage	/bom-penetration	hq, dept	中央厨房MES
ProductionPlanPage	/production-plan	hq, dept	中央厨房MES
RevenuePage	/revenue	hq, dept	决策层看板
IndicatorsPage	/indicators	hq, dept, regional, store	系统管理
TenantManagementPage	/tenant-management	platform_admin	平台管理
TenantUsersPage	/tenant-users	hq	系统管理
LoginPage	/login	公开	认证

9.2 后端路由（10个）

路由文件	路由前缀	功能	对应V3.0模块
auth.ts	/api/auth	登录认证	基础设施
admin.ts	/api/admin	租户管理 + 用户管理	平台管理
data.ts	/api	通用数据查询（概览/门店/区域/SKU/成本/平台/会员/风险/时间/指标/本体）	全模块
tasks.ts	/api/tasks	任务CRUD + 状态流转 + 周检查 + 月验收	任务管理
cost-analysis.ts	/api/cost-analysis	菜品成本分析（总览/品类/偏差/趋势/明细）	财务ERP
store-expense.ts	/api/store-expense	门店费用分析（总览/趋势/对比/明细）	财务ERP
smart-scheduling.ts	/api/smart-scheduling	智能排班（客流热力图/餐段/在岗人员/排班建议）	HR系统
situational-awareness.ts	/api/situational-awareness	态势感知（健康度评分/红黄绿灯/预警）	区域管理
analytics-enhanced.ts	/api/analytics-enhanced	增强分析（会员LTV/菜单工程/员工绩效/库存周转/区域对比）	全模块
tts.ts	/api/tts	TTS语音播报（千问CosyVoice）	基础设施

9.3 数据库表（11个SQL文件）

SQL文件	内容	对应V3.0模块
01_create_tables.sql	门店任务/日志/模板/指标字典/门店主数据/经验标准化/推广试点/升降级/周检查/月验收/数据刷新日志	任务管理 + 迭代闭环
02_create_functions.sql	SQL函数（任务生成/周检查/月验收等）	任务管理
03_create_views.sql	周检查视图/月度验收视图/闭环健康度视图/数据质量视图	任务管理 + 数据闭环
04_init_data.sql	初始化数据（指标字典/任务模板）	系统管理
05-06_backfill_task_values.sql	批量回填任务值	任务管理
07-08_simulate_monthly_review.sql	模拟月度验收 + 验收修复	月度验收
09_add_indexes.sql	性能索引	基础设施
10_materialize_slow_views.sql	慢视图物化（门店详情页性能优化）	基础设施
11_tenant_management.sql	多租户管理（租户配置/用户/平台管理员）	平台管理

9.4 中间件（4个）

中间件	功能	对应V3.0模块
auth.ts	JWT认证 + 角色守卫 + 门店访问控制	权限隔离
tenant-db.ts	多租户动态连接池切换	权限隔离
data-scope.ts	数据范围过滤（hq无限制/regional按区域/store按门店）	权限隔离
error.ts	统一响应壳 + 错误处理 + 分页/月份解析	基础设施

9.5 共享类型

类型	用途
UserRole	角色枚举（hq/regional/store/dept）
AuthUser	认证用户信息
ApiResponse<T>	统一API响应壳
StoreScorecard	门店记分卡
StoreRiskRating	门店风险评级（红/黄/绿）
StorePriority	门店优先级
StoreTask	门店整改任务
WeeklyCheck	周度检查记录
MonthlyReview	月度验收记录
LoopHealth	闭环健康度
IndicatorDict	指标字典
StandardizedPractice	经验标准化
PracticeReplication	经验推广试点

---

十、总结

整体实现度评估

V3.0模块	当前实现度	Phase 1 后	Phase 2 后	Phase 3 后
战略驾驶舱	30%	45%	60%	85%
产品PLM	25%	50%	60%	75%
供应链SRM	15%	30%	60%	75%
中央厨房MES	40%	55%	75%	85%
WMS仓储	15%	25%	50%	70%
TMS物流	15%	25%	45%	65%
门店POS	20%	50%	60%	80%
区域管理	40%	70%	80%	90%
门店终端	55%	75%	85%	90%
HR系统	20%	35%	60%	75%
培训LMS	0%	10%	50%	70%
营销MA	30%	40%	65%	80%
财务ERP	40%	50%	70%	85%
数据采集层	10%	40%	50%	80%
任务管理	65%	80%	90%	95%
态势感知	50%	75%	85%	90%
权限隔离	50%	70%	85%	90%
整体平均	29%	49%	67%	82%

关键差距总结

1. 目标管理系统完全缺失：V3.0核心是"目标自动拆解"，当前系统无目标管理表族和拆解算法
2. 定时调度引擎缺失：V3.0要求"时间驱动 + 事件驱动"双引擎，当前系统无 cron 调度器
3. 消息推送引擎缺失：V3.0要求"自动推送至对应责任人"，当前系统无 WebSocket/推送机制
4. 实时数据采集缺失：V3.0要求"POS/IoT/扫码枪实时上云"，当前系统依赖手工导入
5. 审批流系统缺失：V3.0要求7类审批流，当前系统无审批流引擎
6. LMS培训系统缺失：V3.0要求"培训下发 + 学习追踪 + 考试认证"，当前系统无LMS
7. 职能角色体系缺失：V3.0要求6类职能角色（供应链/产品/营销/HR/店长/员工），当前系统仅有4类层级角色

优先建议

立即启动 Phase 1 的前5项任务，这些是V3.0闭环体系的基石：

1. 目标管理表族 + 拆解算法 → 让系统"有目标可追踪"
2. 定时调度器 + 日报/目标卡自动生成 → 让系统"按节奏自运转"
3. 预警规则引擎 + 自动推送 → 让系统"自动发现问题"
4. POS数据实时导入 → 让系统"有实时数据可用"
5. 门店自动分级 + 红黄绿灯 → 让系统"自动区分优先级"

---

文档结语：当前系统已实现了V3.0五层架构中的数据聚合层、分析呈现层、任务管理层和权限隔离层，整体实现度约29%。核心差距在于"五个自动化"（目标自动拆解、数据自动采集、偏差自动预警、任务自动派发、结果自动验证）尚未建立。通过三阶段实施路线图，可在24个月内将整体实现度提升至82%，基本完成V3.0系统闭环体系的落地。