SBrainCO/菜品成本分析前端方案.md

菜品成本分析前端展现方案

基于现有架构：侧边栏分组（Layout.tsx） + 路由（App.tsx） + 页面组件（pages/） + 折叠面板（CollapsibleSection） + 数据表格（DataTable） + 图表（recharts）

---

整体架构

新增页面路由

在 App.tsx 中新增1个页面路由，在 Layout.tsx 中新增1个菜单项：

/cost-analysis  →  CostAnalysisPage  →  "菜品成本分析"  →  业务模块组

页面结构

采用单页面 + Tab切换的方式，避免新增过多路由。页面顶部为Tab栏，每个Tab对应一个分析维度：

菜品成本分析
├── Tab: 成本总览        → 模块1 + 模块10 + 模块25
├── Tab: 菜品盈利分析     → 模块3 + 模块12
├── Tab: 原料差异分析     → 模块2 + 模块11
├── Tab: BOM与配方        → 模块4 + 模块23 + 模块20 + 模块21 + 模块22
├── Tab: 供应链与精简     → 模块5 + 模块6 + 模块7 + 模块13
├── Tab: 包装耗材         → 模块8
├── Tab: 数据质量         → 模块9 + 模块14
├── Tab: 门店成本         → 模块15 + 模块16 + 模块17 + 模块26
└── Tab: 可视化探索       → 模块24 + 散点图 + 热力图

---

各Tab详细设计

Tab 1: 成本总览

包含模块：模块1（SKU理论与实际成本）、模块10（品类成本对比）、模块25（毛利率偏差分布）

布局：

┌─────────────────────────────────────────────────────────┐
│  成本总览                                                │
├─────────────────────────────────────────────────────────┤
│  [MetricCard] 理论成本    [MetricCard] 实际成本          │
│  [MetricCard] 成本差异    [MetricCard] 差异率            │
│  [MetricCard] 平均理论毛利率  [MetricCard] 平均实际毛利率  │
│  [MetricCard] 超理论菜品数   [MetricCard] 低毛利菜品数    │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 品类成本对比（柱状图 + 表格）       │
│  ┌──────────────────────────────────────────┐           │
│  │ BarChart: X轴=品类, Y轴=毛利率            │           │
│  │ 双柱: 理论毛利率 vs 实际毛利率             │           │
│  └──────────────────────────────────────────┘           │
│  DataTable: 品类 | 菜品数 | 理论毛利率 | 实际毛利率       │
│             | 销售额 | 成本差异 | 成本率                  │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 毛利率偏差分布（饼图 + 表格）       │
│  ┌──────────────────────────────────────────┐           │
│  │ PieChart: 严重偏低/偏低/略低/略高/高于理论  │           │
│  └──────────────────────────────────────────┘           │
│  DataTable: 偏差区间 | 菜品数 | 占比                      │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 成本差异TOP榜（表格，默认展开）     │
│  DataTable: 菜品 | 品类 | 理论毛利率 | 实际毛利率         │
│             | 成本差异 | 成本分层 | 销售额                │
│  成本分层用 Badge 着色: 正常(绿) / 关注(黄) / 整改(橙)    │
│                        / 紧急(红) / 数据异常(灰)         │
└─────────────────────────────────────────────────────────┘

API端点：

• GET /api/cost-analysis/overview → 总览指标
• GET /api/cost-analysis/category-comparison → 品类对比
• GET /api/cost-analysis/margin-deviation → 偏差分布
• GET /api/cost-analysis/variance-top?limit=50&order=desc → 成本差异TOP

---

Tab 2: 菜品盈利分析

包含模块：模块3（菜品盈利与菜单工程）、模块12（菜品定价合理性）

布局：

┌─────────────────────────────────────────────────────────┐
│  菜品盈利分析                                             │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 菜单工程矩阵（四象限图）            │
│  ┌──────────────────────────────────────────┐           │
│  │ ScatterChart:                             │           │
│  │   X轴=销量, Y轴=实际毛利率                 │           │
│  │   气泡大小=销售额, 颜色=品类               │           │
│  │   四象限: 明星/高销低利/低销高利/低销低利   │           │
│  │   点击气泡 → 弹出菜品详情                  │           │
│  └──────────────────────────────────────────┘           │
│  图例: 🟢明星盈利  🟡高销低利  🔵低销高利  🔴低销低利     │
│        ⚪数据异常                                          │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 菜品盈利明细（表格）               │
│  DataTable: 菜品 | 品类 | 销量 | 销售额 | 理论毛利        │
│             | 实际毛利 | 毛利贡献度 | 菜单类型(Badge)     │
│  支持排序: 按销售额/毛利/毛利率                           │
│  支持筛选: 品类下拉 / 菜单类型下拉                        │
│  Pagination                                               │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 定价合理性（毛利率分布图）          │
│  ┌──────────────────────────────────────────┐           │
│  │ BarChart: X轴=毛利率区间, Y轴=菜品数       │           │
│  │ 区间: <0% / 0-30% / 30-50% / 50-70%       │           │
│  │       / 70-90% / >90%                     │           │
│  └──────────────────────────────────────────┘           │
│  DataTable: 低毛利菜品清单（理论<50%且销售额>1000）       │
│  菜品 | 售价 | 理论成本 | 理论毛利率 | 实际毛利率         │
│        | 定价偏离度 | 建议                                │
└─────────────────────────────────────────────────────────┘

API端点：

• GET /api/cost-analysis/menu-engineering → 菜单工程矩阵数据
• GET /api/cost-analysis/profitability?page=1&category=&type= → 盈利明细
• GET /api/cost-analysis/pricing?threshold=50 → 定价合理性

---

Tab 3: 原料差异分析

包含模块：模块2（SKU原料差异贡献）、模块11（物料损耗率分布）

布局：

┌─────────────────────────────────────────────────────────┐
│  原料差异分析                                             │
├─────────────────────────────────────────────────────────┤
│  [搜索框] 输入菜品名称 → 查看该菜品的原料差异分解         │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 菜品原料差异分解（选中菜品后展示）  │
│  ┌──────────────────────────────────────────┐           │
│  │ 水平BarChart: 原料名 vs 金额差异           │           │
│  │ 红色=超耗, 绿色=节约                       │           │
│  └──────────────────────────────────────────┘           │
│  DataTable: 原料 | 理论用量 | 实际用量 | 数量差异          │
│             | 损耗率 | 金额差异 | 差异贡献度 | 原因分类    │
│  原因分类(Badge): 份量超标/替代原料/分摊遗漏/门店错位     │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 物料损耗率分布（饼图）              │
│  ┌──────────────────────────────────────────┐           │
│  │ PieChart: 无损耗/轻微/轻度/中度/严重/极重/正向│        │
│  └──────────────────────────────────────────┘           │
│  DataTable: 损耗区间 | 明细数 | 占比                      │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 超耗物料TOP榜（表格）              │
│  DataTable: 物料 | 类型(原料/半成品) | 涉及菜品数         │
│             | 总损耗量 | 平均损耗率 | 最大损耗率           │
│  支持排序: 按损耗量/损耗率                                │
│  Pagination                                               │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 物料类型损耗对比（柱状图）          │
│  ┌──────────────────────────────────────────┐           │
│  │ BarChart: 原材料 vs 半成品                 │           │
│  │ 双柱: 平均损耗率 | 涉及菜品数              │           │
│  └──────────────────────────────────────────┘           │
└─────────────────────────────────────────────────────────┘

API端点：

• GET /api/cost-analysis/material-variance?dish_code=66920 → 菜品原料差异分解
• GET /api/cost-analysis/loss-distribution → 损耗率分布
• GET /api/cost-analysis/material-loss-top?limit=50&order=desc → 超耗物料TOP
• GET /api/cost-analysis/material-type-loss → 物料类型损耗对比

---

Tab 4: BOM与配方

包含模块：模块4（BOM复杂度）、模块23（菜品物料构成）、模块20（BOM覆盖率）、模块21（适用门店覆盖）、模块22（高损耗BOM预警）

布局：

┌─────────────────────────────────────────────────────────┐
│  BOM与配方                                               │
├─────────────────────────────────────────────────────────┤
│  [MetricCard] BOM覆盖率   [MetricCard] 有BOM的SKU数      │
│  [MetricCard] 缺BOM的SKU  [MetricCard] 平均物料数/SKU    │
│  [MetricCard] 高损耗BOM数  [MetricCard] 极端损耗BOM数    │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] BOM复杂度分布（柱状图 + 表格）      │
│  ┌──────────────────────────────────────────┐           │
│  │ BarChart: X轴=物料数区间, Y轴=SKU数        │           │
│  │ ≤5 / 6-10 / 11-15 / 16-20 / >20           │           │
│  └──────────────────────────────────────────┘           │
│  DataTable: SKU编码 | 菜品名 | 品类 | 原料数              │
│             | 半成品数 | 独有原料数 | 单位数               │
│             | 高损耗原料数 | 复杂度评分 | 复杂度等级       │
│  复杂度等级(Badge): 低(绿) / 正常(蓝) / 较复杂(橙)        │
│                     / 重点评审(红)                        │
│  Pagination                                               │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 高损耗BOM预警（表格，默认展开）     │
│  DataTable: 菜品 | 物料 | 损耗率 | 出成率 | 标准毛用量     │
│             | 标准净用量 | 单位 | 预警级别(Badge)          │
│  预警级别: >20%(黄) / >50%(橙) / >100%(红)               │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 缺BOM的SKU清单（表格）             │
│  DataTable: SKU编码 | 菜品名 | 品类 | 销售额 | 销量       │
│  按销售额降序，优先补齐高销量SKU的BOM                     │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 菜品物料构成（点击菜品展开详情）    │
│  选中菜品后展示:                                          │
│  DataTable: 物料 | 类型 | 标准用量 | 标准金额 | 成本占比   │
│             | 损耗率 | 出成率                             │
│  饼图: 物料成本占比                                       │
└─────────────────────────────────────────────────────────┘

API端点：

• GET /api/cost-analysis/bom-overview → BOM总览指标
• GET /api/cost-analysis/bom-complexity?page=1 → 复杂度分布
• GET /api/cost-analysis/bom-high-loss?threshold=20 → 高损耗BOM预警
• GET /api/cost-analysis/bom-missing?page=1 → 缺BOM的SKU清单
• GET /api/cost-analysis/bom-composition?sku_code=66920 → 菜品物料构成

---

Tab 5: 供应链与精简

包含模块：模块5（独有原料风险）、模块6（SKU精简供应链影响）、模块7（原料共用度）、模块13（BOM驱动物料需求预测）

布局：

┌─────────────────────────────────────────────────────────┐
│  供应链与精简                                             │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 原料共用度网络（表格 + 图）         │
│  ┌──────────────────────────────────────────┐           │
│  │ 水平BarChart: TOP20物料被引用次数          │           │
│  │ 核心原料(>50个SKU)标红, 独有原料(=1)标灰   │           │
│  └──────────────────────────────────────────┘           │
│  DataTable: 物料 | 类型 | 被引用SKU数 | 分类              │
│             核心原料(Badge红) / 普通共用(蓝) / 独有(灰)   │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 独有原料风险（表格）               │
│  DataTable: SKU | 菜品名 | 销售额 | 独有原料数             │
│             | 独有原料成本 | 替代品 | 风险等级(Badge)      │
│  风险等级: 高(低收入+多独有原料,红) / 中(橙) / 低(绿)     │
│  按销售额升序（低收入优先），独有原料数降序                │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] SKU精简模拟器（交互式）             │
│  ┌──────────────────────────────────────────┐           │
│  │ [下拉] 选择要下架的SKU                     │           │
│  │ 或 [输入] 批量输入SKU编码                  │           │
│  │ [按钮] 模拟下架影响                        │           │
│  └──────────────────────────────────────────┘           │
│  模拟结果:                                                │
│  [MetricCard] 收入影响  [MetricCard] 毛利影响             │
│  [MetricCard] 可减少原料数  [MetricCard] 独有库存金额     │
│  [MetricCard] 仍需采购的共用原料  [MetricCard] 报损风险   │
│  DataTable: 可释放的独有原料清单                          │
│  物料 | 涉及菜品数(=1) | 库存金额 | 处置建议              │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] BOM驱动物料需求预测（表格）         │
│  DataTable: 物料 | 类型 | 单位 | 预计需求量                │
│             | 涉及菜品数 | 需求排名                        │
│  按需求量降序，TOP50                                      │
│  Pagination                                               │
└─────────────────────────────────────────────────────────┘

API端点：

• GET /api/cost-analysis/material-sharing?limit=20 → 原料共用度
• GET /api/cost-analysis/unique-material-risk?page=1 → 独有原料风险
• POST /api/cost-analysis/sku-simplify-simulate → SKU精简模拟（传入SKU编码列表）
• GET /api/cost-analysis/material-demand?limit=50 → 物料需求预测

---

Tab 6: 包装耗材

包含模块：模块8（包装及耗材成本分析）

布局：

┌─────────────────────────────────────────────────────────┐
│  包装耗材成本                                             │
├─────────────────────────────────────────────────────────┤
│  [MetricCard] 包装物料种类  [MetricCard] 包装总成本       │
│  [MetricCard] 包装费用率   [MetricCard] 高损耗包装数      │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 包装物料明细（表格）               │
│  DataTable: 物料 | 涉及菜品数 | 每单用量 | 每单成本        │
│             | 费用率 | 损耗量 | 损耗率 | 状态(Badge)      │
│  状态: 正常(绿) / 关注(黄) / 核查(红)                    │
│  支持筛选: 物料类型（餐盒/餐具/打包袋/调味包/其他）       │
│  Pagination                                               │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 包装损耗TOP榜（柱状图）             │
│  ┌──────────────────────────────────────────┐           │
│  │ 水平BarChart: 物料名 vs 损耗量             │           │
│  └──────────────────────────────────────────┘           │
└─────────────────────────────────────────────────────────┘

API端点：

• GET /api/cost-analysis/packaging-overview → 包装总览
• GET /api/cost-analysis/packaging-detail?page=1&type= → 包装明细
• GET /api/cost-analysis/packaging-loss-top?limit=15 → 包装损耗TOP

---

Tab 7: 数据质量

包含模块：模块9（BOM数据质量）、模块14（物料匹配率）

布局：

┌─────────────────────────────────────────────────────────┐
│  数据质量                                                 │
├─────────────────────────────────────────────────────────┤
│  [MetricCard] BOM覆盖率   [MetricCard] 菜品匹配率         │
│  [MetricCard] 物料匹配率   [MetricCard] 异常菜品数        │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] BOM数据质量检查清单（表格）         │
│  DataTable: 检查项 | 异常数 | 异常率 | 状态(Badge)        │
│  检查项:                                                  │
│  - BOM缺失（168个SKU无BOM）                               │
│  - 零实际用量（standard_net_quantity=0）                  │
│  - 成本率异常（实际毛利率<0）                              │
│  - 理论毛利率为负                                          │
│  - 负数量记录                                              │
│  - 明细与汇总不一致                                        │
│  - 重复BOM记录                                            │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 未匹配菜品清单（表格）              │
│  DataTable: 菜品名 | 品类 | 销售额 | 匹配状态              │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 未匹配物料清单（表格）              │
│  DataTable: 物料名 | 涉及菜品数 | 损耗金额 | 匹配状态      │
└─────────────────────────────────────────────────────────┘

API端点：

• GET /api/cost-analysis/data-quality → 数据质量总览
• GET /api/cost-analysis/unmatched-dishes?page=1 → 未匹配菜品
• GET /api/cost-analysis/unmatched-materials?page=1 → 未匹配物料

---

Tab 8: 门店成本

包含模块：模块15（门店成本差异分布）、模块16（门店超耗排名）、模块17（理论vs实际成本率）、模块26（门店成本分级地图）

布局：

┌─────────────────────────────────────────────────────────┐
│  门店成本                                                 │
├─────────────────────────────────────────────────────────┤
│  [MetricCard] 门店总数    [MetricCard] 红色门店数         │
│  [MetricCard] 橙色门店数  [MetricCard] 绿色门店数         │
│  [MetricCard] 灰色门店数  [MetricCard] 总超耗金额         │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 门店成本分级地图                    │
│  ┌──────────────────────────────────────────┐           │
│  │ 地图组件（复用StoreMap或现有地图）          │           │
│  │ 标注: 红/橙/绿/灰 圆点                     │           │
│  │ 点击 → 弹出门店成本详情                    │           │
│  └──────────────────────────────────────────┘           │
│  图例: 🔴严重超耗 🟠明显超耗 🟢基本正常 ⚪口径异常        │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 门店成本差异分布（饼图）            │
│  ┌──────────────────────────────────────────┐           │
│  │ PieChart: 红35 / 橙40 / 绿8 / 灰6         │           │
│  └──────────────────────────────────────────┘           │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 门店超耗排名（表格，默认展开）      │
│  DataTable: 门店 | 理论成本率 | 实际成本率 | 偏差          │
│             | 超耗金额 | 负库存项数 | 分级(Badge)         │
│  分级(Badge): 红色-严重超耗(红) / 橙色-明显超耗(橙)       │
│              / 绿色-基本正常(绿) / 灰色-口径异常(灰)      │
│  支持排序: 按超耗金额/偏差率                              │
│  Pagination                                               │
└─────────────────────────────────────────────────────────┘

API端点：

• GET /api/cost-analysis/store-overview → 门店成本总览
• GET /api/cost-analysis/store-map → 门店地图数据（含经纬度+分级）
• GET /api/cost-analysis/store-ranking?page=1&order=desc → 门店超耗排名

---

Tab 9: 可视化探索

包含模块：模块24（成本差异vs销量散点图）+ 自由探索

布局：

┌─────────────────────────────────────────────────────────┐
│  可视化探索                                               │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 成本差异 vs 销量散点图              │
│  ┌──────────────────────────────────────────┐           │
│  │ ScatterChart:                             │           │
│  │   X轴=销量, Y轴=成本差异额                 │           │
│  │   气泡大小=销售额, 颜色=品类               │           │
│  │   四象限标注:                              │           │
│  │     右上=高销量高差异(优先整改)             │           │
│  │     右下=高销量低差异(保持)                 │           │
│  │     左上=低销量高差异(考虑下架)             │           │
│  │     左下=低销量低差异(观察)                 │           │
│  │   点击气泡 → 弹出菜品详情                  │           │
│  └──────────────────────────────────────────┘           │
├─────────────────────────────────────────────────────────┤
│  [CollapsibleSection] 品类成本热力图                      │
│  ┌──────────────────────────────────────────┐           │
│  │ 热力图: 行=品类, 列=成本指标               │           │
│  │ 指标: 理论毛利率/实际毛利率/差异率/成本率   │           │
│  │ 颜色: 红=差, 绿=好                         │           │
│  └──────────────────────────────────────────┘           │
├─────────────────────────────────────────────────────────┤
│  [筛选器]                                                 │
│  品类下拉 | 毛利率范围滑块 | 销量范围滑块                 │
│  [按钮] 应用筛选 → 更新散点图                             │
└─────────────────────────────────────────────────────────┘

API端点：

• GET /api/cost-analysis/scatter?x=sales_quantity&y=cost_variance&size=sales_amount&color=category_l1 → 散点图数据
• GET /api/cost-analysis/category-heatmap → 品类热力图

---

组件复用清单

组件	用途	已有
CollapsibleSection	折叠面板	✅
MetricCard	指标卡片	✅
DataTable	数据表格	✅
Pagination	分页	✅
Badge	状态标签	✅
LoadingSpinner	加载中	✅
BarChart	柱状图	✅ recharts
PieChart	饼图	✅ recharts
ScatterChart	散点图	✅ recharts
StoreMap	地图	✅ 已有
Tab切换组件	Tab栏	❌ 需新建
搜索框组件	菜品搜索	❌ 用input实现
筛选器组件	下拉/滑块	❌ 用select/input实现

新增文件清单

文件	说明
client/src/pages/CostAnalysisPage.tsx	主页面（Tab容器）
client/src/components/Tabs.tsx	Tab切换组件
client/src/components/cost-analysis/OverviewTab.tsx	Tab1: 成本总览
client/src/components/cost-analysis/ProfitabilityTab.tsx	Tab2: 菜品盈利
client/src/components/cost-analysis/MaterialTab.tsx	Tab3: 原料差异
client/src/components/cost-analysis/BomTab.tsx	Tab4: BOM与配方
client/src/components/cost-analysis/SupplyTab.tsx	Tab5: 供应链精简
client/src/components/cost-analysis/PackagingTab.tsx	Tab6: 包装耗材
client/src/components/cost-analysis/QualityTab.tsx	Tab7: 数据质量
client/src/components/cost-analysis/StoreTab.tsx	Tab8: 门店成本
client/src/components/cost-analysis/ExploreTab.tsx	Tab9: 可视化探索
server/src/routes/cost-analysis.ts	API路由（所有端点）

API端点汇总

端点	Tab	说明
GET /api/cost-analysis/overview	1	成本总览指标
GET /api/cost-analysis/category-comparison	1	品类成本对比
GET /api/cost-analysis/margin-deviation	1	毛利率偏差分布
GET /api/cost-analysis/variance-top	1	成本差异TOP榜
GET /api/cost-analysis/menu-engineering	2	菜单工程矩阵
GET /api/cost-analysis/profitability	2	菜品盈利明细
GET /api/cost-analysis/pricing	2	定价合理性
GET /api/cost-analysis/material-variance	3	菜品原料差异分解
GET /api/cost-analysis/loss-distribution	3	损耗率分布
GET /api/cost-analysis/material-loss-top	3	超耗物料TOP
GET /api/cost-analysis/material-type-loss	3	物料类型损耗对比
GET /api/cost-analysis/bom-overview	4	BOM总览
GET /api/cost-analysis/bom-complexity	4	BOM复杂度
GET /api/cost-analysis/bom-high-loss	4	高损耗BOM预警
GET /api/cost-analysis/bom-missing	4	缺BOM的SKU
GET /api/cost-analysis/bom-composition	4	菜品物料构成
GET /api/cost-analysis/material-sharing	5	原料共用度
GET /api/cost-analysis/unique-material-risk	5	独有原料风险
POST /api/cost-analysis/sku-simplify-simulate	5	SKU精简模拟
GET /api/cost-analysis/material-demand	5	物料需求预测
GET /api/cost-analysis/packaging-overview	6	包装总览
GET /api/cost-analysis/packaging-detail	6	包装明细
GET /api/cost-analysis/packaging-loss-top	6	包装损耗TOP
GET /api/cost-analysis/data-quality	7	数据质量总览
GET /api/cost-analysis/unmatched-dishes	7	未匹配菜品
GET /api/cost-analysis/unmatched-materials	7	未匹配物料
GET /api/cost-analysis/store-overview	8	门店成本总览
GET /api/cost-analysis/store-map	8	门店地图数据
GET /api/cost-analysis/store-ranking	8	门店超耗排名
GET /api/cost-analysis/scatter	9	散点图数据
GET /api/cost-analysis/category-heatmap	9	品类热力图

共 31个API端点，覆盖27个分析模块。

落地顺序

与指标体系的4批对应：

批次	Tab	优先级	API数
第一批	Tab1 + Tab2 + Tab3	最高	11
第二批	Tab4 + Tab6 + Tab7	高	10
第三批	Tab8	中	3
第四批	Tab5 + Tab9	低	7