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系统闭环体系的落地。