# 玄谋智脑实际版建设方案

> 基于 RestaurantChainBrainDemo 概念原型，在 SBrainCO 生产系统中构建"经营决策操作系统"实际版。

## 一、背景与目标

### 1.1 背景

当前工作区有两个项目：

| 项目 | 定位 | 代码量 | 数据 | 部署 |
|------|------|--------|------|------|
| **RestaurantChainBrainDemo** | 概念演示原型 | 75行（5个文件） | 硬编码Mock数据 | 静态文件 |
| **SBrainCO** | 生产级全栈应用 | 32,643行（99前端+30后端） | 真实PostgreSQL | dm.all8ai.top |

Demo 展示了"玄谋智脑"的6大模块产品概念（经营指挥舱、决策中心、AI员工组织、任务闭环、经营本体、知识资产），但全部基于Mock数据。SBrainCO 已有真实数据、完整后端和部署体系，但缺少 Demo 中描绘的"决策中心""AI员工组织""知识资产"3个模块，且"指挥舱"和"任务闭环"已有但未达到 Demo 的交互水平。

### 1.2 目标

在 SBrainCO 中构建 Demo 的6大模块**实际版**，用真实数据和API替代Mock数据，实现"信号→决策→任务→验收→知识"的完整管理闭环。

### 1.3 原则

- **在SBrainCO中改**，不在Demo中改——数据、后端、部署都在SBrainCO
- **复用现有基础设施**——不重建已有的API、表、组件
- **Demo作为UI参考**——借鉴交互设计和信息架构，不复用代码
- **分阶段交付**——先MVP再增强，每阶段可独立上线

## 二、现状分析

### 2.1 SBrainCO 现有路由（45个页面）

```
/                  DashboardPage          仪表盘
/boss              BossPage               老板驾驶舱（利润机会池+风险态势+瀑布图）
/revenue           RevenuePage            营收分析
/bank              BankPage               银行流水
/central-kitchen   CentralKitchenPage     中央厨房
/distribution-reconciliation            配送对账
/bom-penetration   BomPenetrationPage    BOM穿透
/production-plan   ProductionPlanPage    生产计划
/regional          RegionalPage           区域分析
/store             StorePage              门店列表
/stores/:code      StoreDetailPage       门店详情（深度诊断）
/tasks             TasksPage             任务列表
/tasks/:id         TaskDetailPage        任务详情
/monthly-review    MonthlyReviewPage     月度验收
/sku               SKUPage               SKU分析
/cost              CostPage              成本总览
/cost-analysis     CostAnalysisPage      成本分析（9个Tab）
/store-expense     StoreExpensePage      门店费用
/platform          PlatformPage          平台经济
/member            MemberPage            会员分析
/risk              RiskPage              风险态势
/time              TimePage              时段分析
/data-quality      DataQualityPage       数据质量
/indicators        IndicatorsPage        指标管理
/ontology          OntologyPage          经营本体
/site-selection    SiteSelectionPage     选址分析
/smart-scheduling  SmartSchedulingPage   智能排班
/situational-awareness                   态势感知
/member-ltv        MemberLTVPage         会员LTV
/menu-engineering  MenuEngineeringPage   菜单工程
/region-comparison RegionComparisonPage  区域对比
/employee-performance                    员工绩效
/inventory-turnover                      库存周转
/tenant-management                       租户管理
/tenant-users                            租户用户
/target            TargetManagementPage  目标管理
/alert             AlertManagementPage   告警管理
/scheduler         SchedulerManagementPage 调度管理
/store-grade       StoreGradePage        门店分级
/product-lifecycle ProductLifecyclePage  产品生命周期
/data-import       DataImportPage        数据导入
/enterprise        EnterprisePage        企业看板
/intelligence      IntelligencePage      智能中心
/promotion         PromotionPage         促销分析
```

### 2.2 SBrainCO 现有后端路由（18个文件）

| 文件 | 主要功能 |
|------|---------|
| data.ts | 概览、瀑布图、利润机会池、风险评级、同比环比 |
| tasks.ts | 任务CRUD、自动生成、周检、月度验收、标杆实践、闭环健康度 |
| cost-analysis.ts | 成本总览、品类对比、毛利率偏差、门店成本（9个Tab） |
| intelligence.ts | IoT设备、AI预测、AI调整目标、MRP、ROI计算、品牌资产 |
| alert.ts | 告警规则、告警日志、告警总览 |
| situational-awareness.ts | 态势感知、门店诊断 |
| enterprise.ts | 企业看板、跨店对比 |
| product.ts | 产品生命周期、ABC分析 |
| promotion.ts | 促销分析、活动ROI |
| store-expense.ts | 门店费用、人工水电 |
| store-grade.ts | 门店分级 |
| target.ts | 目标管理、偏差分析 |
| smart-scheduling.ts | 智能排班 |
| scheduler.ts | 定时任务调度 |
| tts.ts | 语音合成 |
| auth.ts | 登录认证（多租户） |
| admin.ts | 平台管理、租户用户管理 |

### 2.3 已有数据库表（与6大模块相关）

```sql
-- 任务闭环相关（已存在）
analytics.store_task              -- 整改任务
analytics.store_task_log          -- 任务日志
analytics.task_template           -- 任务模板
analytics.task_weekly_check       -- 周度检查
analytics.task_monthly_review     -- 月度验收

-- 知识资产相关（已存在）
analytics.standardized_practice   -- 标杆实践
analytics.practice_replication    -- 经验推广

-- 告警相关（已存在）
analytics.v3_alert_rule           -- 告警规则
analytics.v3_alert_log            -- 告警日志

-- 目标管理（已存在）
analytics.v3_store_monthly_target -- 门店月度目标
analytics.v3_target_variance      -- 目标偏差
analytics.v3_store_grade          -- 门店分级
```

### 2.4 Demo 6大模块 vs SBrainCO 现有基础

| Demo模块 | SBrainCO现有基础 | 缺口 | 工作量 |
|---------|----------------|------|--------|
| 经营指挥舱 | BossPage（真实API、利润机会池、风险态势、瀑布图） | 缺少"待决策清单"和"闭环健康度"可视化 | 小 |
| 决策中心 | 利润机会API（6类机会）、风险评级、告警规则 | 缺少"决策卡"抽象：把机会/风险/告警统一为决策对象，加审批流 | 中 |
| AI员工组织 | scheduler/task-handlers、intelligence.ts（AI预测/调整） | 缺少"AI员工"定义表和配置UI | 中 |
| 任务闭环 | tasks.ts（完整CRUD+周检+月度验收+loop-health） | UI已有TasksPage，缺少闭环可视化 | 小 |
| 经营本体 | OntologyPage + docs/智脑实施方法论 + 数据库schema | 现有OntologyPage可能只是静态展示 | 小 |
| 知识资产 | standardized_practice表 + practice_replication表 | 缺少知识库浏览UI和统计面板 | 小 |

## 三、总体架构

### 3.1 模块关系图

```
                    ┌─────────────────────────────────────────┐
                    │           经营指挥舱 (/boss)              │
                    │  KPI · 利润机会 · 风险态势 · 闭环健康度     │
                    └──────────┬──────────────────────────────┘
                               │ 聚合
                    ┌──────────▼──────────────────────────────┐
                    │           决策中心 (/decisions)           │
                    │  决策卡 · 证据链 · 审批流 · 影响评估        │
                    └──────────┬──────────────────────────────┘
                               │ 审批后生成
                    ┌──────────▼──────────────────────────────┐
                    │           任务闭环 (/tasks)               │
                    │  信号→决策→任务→周检→验收→知识             │
                    └──────┬────────────┬─────────────────────┘
                           │            │ 验收后沉淀
                    ┌──────▼──┐   ┌─────▼──────────────────────┐
                    │ AI员工   │   │       知识资产 (/knowledge)  │
                    │ 组织     │   │  SOP · 标杆案例 · 规则 · 术语 │
                    │(/agents) │   └────────────────────────────┘
                    └─────────┘
                    ┌─────────────────────────────────────────┐
                    │           经营本体 (/ontology)            │
                    │  对象域 · 关系 · 指标 · 规则（底层语义层）    │
                    └─────────────────────────────────────────┘
```

### 3.2 数据流

```
真实数据源                    API层                    前端页面
───────────                ──────                   ─────────
mv_store_risk_rating  ──→  /overview/risk      ──→  指挥舱·风险态势
profit-opportunity    ──→  /overview/profit-opp ──→ 指挥舱·利润机会
v3_alert_log          ──→  /alert/overview     ──→  决策中心·告警决策
profit-opportunity    ──→  /overview/profit-opp ──→ 决策中心·机会决策
store_task            ──→  /tasks              ──→  任务闭环
loop-health           ──→  /tasks/loop-health  ──→  指挥舱·闭环健康度
standardized_practice ──→  /tasks/practices    ──→  知识资产
practice_replication  ──→  /tasks/practices/:id ──→ 知识资产·推广结果
（新增）decision       ──→  /decisions          ──→  决策中心
（新增）agent_config   ──→  /agents             ──→  AI员工组织
```

### 3.3 前端导航结构（方案A+：最小改动 + 关键归拢）

**设计原则**：不碰分析类分组（收入/成本/运营/风险4组共20项完全不动），新增"智脑决策"分组作为核心入口，把闭环相关的散落菜单归拢过来，解决"V3.0系统闭环"命名问题，经营本体独立成组。

**调整后菜单结构**：

```
经营总览（不动）              4项
  老板驾驶舱 (/boss)           ← 升级
  总部驾驶舱 (/)
  态势感知 (/situational-awareness)
  银行授信 (/bank)

智脑决策（新增）              7项 ← 核心入口，完整闭环
  决策中心 (/decisions)        ★新增
  AI员工组织 (/agents)         ★新增
  知识资产 (/knowledge)        ★新增
  任务管理 (/tasks)            ← 从"角色工作台"移入
  月度验收 (/monthly-review)   ← 从"角色工作台"移入
  预警管理 (/alert)            ← 从"V3.0系统闭环"移入
  目标管理 (/target)           ← 从"V3.0系统闭环"移入

角色工作台（瘦身）            3项 ← 去掉任务管理和月度验收
  区域经理 (/regional)
  区域对比 (/region-comparison)
  店长工作台 (/store)

收入分析（不动）              4项
成本与费用（不动）            8项
运营分析（不动）              6项
风险与选址（不动）            2项

系统配置（V3.0系统闭环改名）  6项 ← 只改名+移出2项
  门店分级 (/store-grade)
  调度管理 (/scheduler)
  产品生命周期 (/product-lifecycle)
  数据采集 (/data-import)
  企业协同 (/enterprise)
  智能升级 (/intelligence)

系统管理（瘦身）              3项 ← 去掉本体标准
  用户管理 (/tenant-users)
  数据质量 (/data-quality)
  指标字典 (/indicators)

经营本体（从系统管理提升）    1项 ← 独立成组，突出6大模块地位
  本体标准 (/ontology)

平台管理（不动）              1项
  租户管理 (/tenant-management)
```

**调整明细**：

| 操作 | 菜单项 | 原分组 | 目标分组 |
|------|--------|--------|---------|
| 新增 | 决策中心 | - | 智脑决策 |
| 新增 | AI员工组织 | - | 智脑决策 |
| 新增 | 知识资产 | - | 智脑决策 |
| 移动 | 任务管理 | 角色工作台 | 智脑决策 |
| 移动 | 月度验收 | 角色工作台 | 智脑决策 |
| 移动 | 预警管理 | V3.0系统闭环 | 智脑决策 |
| 移动 | 目标管理 | V3.0系统闭环 | 智脑决策 |
| 移动 | 本体标准 | 系统管理 | 经营本体（独立分组） |
| 改名 | V3.0系统闭环 → 系统配置 | - | - |

**不动的分组**：经营总览、收入分析、成本与费用、运营分析、风险与选址、平台管理（共6组25项完全不动）

## 四、分阶段建设方案

### 阶段一：MVP（3个新页面 + 2个升级）

**目标**：新增3个页面，复用现有API，让6大模块全部可见

#### 4.1.1 决策中心 (/decisions) — 新增

**数据来源**：聚合现有3类信号

| 信号源 | API | 决策类型 |
|--------|-----|---------|
| 利润机会 | `/overview/profit-opportunity` | 机会决策（6类改善方向） |
| 风险告警 | `/alert/overview` + `/overview/risk` | 风险决策（红黄门店） |
| 异常任务 | `/tasks?status=异常` | 执行决策（逾期/未改善） |

**页面结构**：
```
决策中心
├── 筛选栏：全部 / 待审批 / 执行中 / 已验证
├── 决策卡列表（表格）
│   ├── 决策标题 + 依据
│   ├── 自治等级（L1人工审批 / L2受控 / L3自动）
│   ├── 预计影响（金额）
│   ├── 责任人 + 截止时间
│   └── 状态（待审批 / 执行中 / 已验证）
└── 决策详情抽屉（点击展开）
    ├── AI建议置信度
    ├── 为什么现在行动（原因）
    ├── 证据链（数据来源、基准对比、历史案例）
    ├── 影响评估（金额 + 等级）
    └── 审批操作（批准 / 退回）
```

**MVP实现方式**：
- 不新建 decision 表，前端聚合3类API数据为"决策卡"格式
- 审批操作暂存前端状态（localStorage），后续阶段再持久化
- 决策详情中的"证据链"从对应API的detail字段提取

#### 4.1.2 AI员工组织 (/agents) — 新增

**数据来源**：配置文件（10个AI员工角色定义）

**AI员工定义**（基于Demo + SBrainCO实际能力）：

| AI员工 | 岗位目标 | 对应SBrainCO能力 | 自治等级 |
|--------|---------|----------------|---------|
| 经营参谋长 | 消解目标冲突、生成老板决策清单 | BossPage聚合 | L1 |
| 门店经营分析师 | 门店分级、异常归因与增收机会 | 风险评级+利润机会 | L1 |
| 菜品利润优化师 | 菜品真实贡献与菜单工程 | cost-analysis + menu-engineering | L1 |
| 费用稽核员 | 门店损益、费用异常与追责 | store-expense | L1 |
| 需求预测员 | 菜品与原料日周需求预测 | intelligence.ts/ai/forecast | L1 |
| 智能补货员 | 订货量、调拨与最晚下单日 | intelligence.ts/mrp | L2 |
| 经营督办员 | 异常转任务、周检与月度验收 | tasks.ts + scheduler | L1 |
| 经营稽核员 | 退款、抹零与异常操作审查 | alert.ts | L1 |
| 会员运营师 | 复购、流失与下一最佳行动 | member + member-ltv | L2 |
| 知识管理员 | SOP、标杆门店与案例资产化 | standardized_practice | L1 |

**页面结构**：
```
AI员工组织
├── 经营参谋长（首席卡片）
│   ├── 今日生成决策数
│   └── 协调目标说明
├── AI员工网格（9个卡片）
│   ├── 员工名称 + 岗位
│   ├── 职责描述
│   ├── 自治等级
│   ├── 今日交付数
│   └── 状态（运行中 / 待审批 / 受控）
└── 点击展开：员工详情（配置、权限范围、SOP引用）
```

**MVP实现方式**：
- 前端配置文件定义10个AI员工（`src/data/agents.ts`）
- "今日交付数"从对应API动态获取（如经营参谋长→决策数，经营督办员→任务数）
- 不新建数据库表

#### 4.1.3 知识资产 (/knowledge) — 新增

**数据来源**：`/tasks/practices` API（已存在）

**页面结构**：
```
知识资产
├── 知识统计卡片
│   ├── 有效知识条目数（standardized_practice总数）
│   ├── 按模块分类（门店经营 / 商品利润 / 风险内控 / 组织效率）
│   └── 按状态分类（待推广 / 推广中 / 已验证）
├── 知识列表
│   ├── 实践标题 + 模块
│   ├── 标杆门店
│   ├── 关键行动
│   ├── 验证指标
│   ├── 引用次数 + 推广结果
│   └── 状态
└── 知识详情（点击展开）
    ├── 标杆门店信息
    ├── 关键行动详情
    ├── 验证指标与结果
    ├── 推广试点记录
    └── 推广操作（推广到指定门店）
```

**MVP实现方式**：
- 直接调用现有 `/tasks/practices` 和 `/tasks/practices/:id/replication-result` API
- 统计数据前端聚合计算
- 推广操作调用现有 `/tasks/practices/:id/replicate` API

#### 4.1.4 经营指挥舱升级 (/boss) — 升级现有

**新增内容**：
1. **待决策清单**：从决策中心聚合TOP3决策，显示在指挥舱顶部
2. **闭环健康度可视化**：调用 `/tasks/loop-health` API，展示"信号→决策→任务→验收→知识"5阶段转化率

**不改动**：现有KPI卡片、利润机会池、风险态势、瀑布图保持不变

#### 4.1.5 任务闭环升级 (/tasks) — 升级现有

**新增内容**：
1. **闭环流程条**：顶部展示"信号发现→决策审批→任务执行→周期检查→收益验收→经验标准化"流程条
2. **验收价值列**：在任务列表中增加"验收价值"列（从verification_result提取）

**不改动**：现有任务列表、筛选、详情页保持不变

### 阶段二：增强（决策持久化 + AI员工配置）

**目标**：让决策可持久化、可审计，AI员工可配置

#### 4.2.1 决策持久化

**新增数据库表**：
```sql
CREATE TABLE analytics.decision_card (
  decision_id SERIAL PRIMARY KEY,
  decision_no TEXT UNIQUE NOT NULL,        -- DEC-YYYYMMDD-NNN
  source_type TEXT NOT NULL,               -- profit_opportunity / risk_alert / task_anomaly
  source_id TEXT,                          -- 源数据ID
  level TEXT NOT NULL,                     -- L1人工审批 / L2受控 / L3自动
  domain TEXT NOT NULL,                    -- 门店经营 / 商品利润 / 供应链 / 风险内控
  title TEXT NOT NULL,
  reason TEXT,
  impact_amount NUMERIC,
  impact_description TEXT,
  confidence INT,                          -- AI建议置信度 0-100
  evidence JSONB,                          -- 证据链
  owner TEXT,
  agent_name TEXT,                         -- 责任AI员工
  deadline DATE,
  status TEXT DEFAULT '待审批',             -- 待审批 / 已批准 / 已退回 / 执行中 / 已验证
  approved_by TEXT,
  approved_at TIMESTAMPTZ,
  created_at TIMESTAMPTZ DEFAULT NOW(),
  updated_at TIMESTAMPTZ DEFAULT NOW()
);

CREATE TABLE analytics.agent_config (
  agent_id SERIAL PRIMARY KEY,
  agent_code TEXT UNIQUE NOT NULL,         -- chief_of_staff / store_analyst / ...
  agent_name TEXT NOT NULL,                -- 经营参谋长 / 门店经营分析师 / ...
  role_target TEXT NOT NULL,               -- 岗位目标
  domain TEXT NOT NULL,                    -- 负责领域
  autonomy_level TEXT NOT NULL,            -- L1 / L2 / L3
  scope_stores TEXT[],                     -- 负责门店范围
  permissions TEXT[],                      -- 权限列表
  sop_refs TEXT[],                         -- 引用SOP
  status TEXT DEFAULT '运行中',
  today_deliveries INT DEFAULT 0,
  config JSONB,                            -- 扩展配置
  created_at TIMESTAMPTZ DEFAULT NOW(),
  updated_at TIMESTAMPTZ DEFAULT NOW()
);
```

**新增后端API**：
```
GET    /decisions              -- 决策列表（支持筛选）
GET    /decisions/:id          -- 决策详情
POST   /decisions              -- 手动创建决策
POST   /decisions/:id/approve  -- 批准决策（生成任务）
POST   /decisions/:id/reject   -- 退回决策
GET    /agents                 -- AI员工列表
GET    /agents/:code           -- AI员工详情
PUT    /agents/:code           -- 更新AI员工配置
POST   /decisions/auto-generate -- 自动生成决策（从利润机会+风险+告警）
```

#### 4.2.2 决策自动生成

定时任务（scheduler）每日早晨自动扫描：
1. 利润机会池 → 生成"机会决策"（6类改善方向各1条）
2. 红色门店 → 生成"风险决策"（P0级门店各1条）
3. 逾期任务 → 生成"执行决策"（逾期>7天的任务）

#### 4.2.3 AI员工配置管理

- 支持配置每个AI员工的自治等级、门店范围、权限
- "今日交付数"从对应API动态统计
- 支持启用/停用AI员工

### 阶段三：深化（自动闭环 + 知识沉淀）

**目标**：实现"信号→决策→任务→验收→知识"全自动闭环

#### 4.3.1 决策审批后自动生成任务

决策批准后，自动调用 `/tasks/auto-generate` 生成整改任务，关联决策ID。

#### 4.3.2 任务验收后自动沉淀知识

任务月度验收通过且收益达标时，自动提取：
- 关键行动 → standardized_practice.key_actions
- 验证指标 → standardized_practice.verification_indicators
- 标杆门店 → standardized_practice.benchmark_store_code

#### 4.3.3 知识自动推荐

新决策生成时，自动搜索 standardized_practice 匹配案例，作为证据链的一部分。

## 五、技术方案

### 5.1 前端技术栈（复用SBrainCO现有）

| 技术 | 用途 | 已有 |
|------|------|------|
| React + TypeScript | 框架 | ✅ |
| React Router | 路由 | ✅ |
| TanStack Query | 数据请求 | ✅ |
| Tailwind CSS | 样式 | ✅ |
| Recharts | 图表 | ✅ |
| Lucide React | 图标 | ✅ |

### 5.2 后端技术栈（复用SBrainCO现有）

| 技术 | 用途 | 已有 |
|------|------|------|
| Express + TypeScript | API框架 | ✅ |
| node-postgres | 数据库 | ✅ |
| JWT | 认证 | ✅ |
| 多租户中间件 | 租户隔离 | ✅ |

### 5.3 新增文件清单

```
client/src/
├── pages/
│   ├── DecisionsPage.tsx          -- 决策中心（新增）
│   ├── AgentsPage.tsx             -- AI员工组织（新增）
│   └── KnowledgePage.tsx          -- 知识资产（新增）
├── components/
│   ├── DecisionCard.tsx           -- 决策卡组件（新增）
│   ├── DecisionDrawer.tsx         -- 决策详情抽屉（新增）
│   ├── AgentCard.tsx              -- AI员工卡片（新增）
│   ├── KnowledgeCard.tsx          -- 知识条目卡片（新增）
│   ├── LoopHealthBar.tsx          -- 闭环健康度条（新增）
│   └── DecisionSummary.tsx        -- 指挥舱待决策摘要（新增）
├── data/
│   └── agents.ts                  -- AI员工配置定义（新增，阶段一）
└── lib/
    └── decision-aggregator.ts     -- 决策聚合逻辑（新增）

server/src/
├── routes/
│   ├── decisions.ts               -- 决策API（新增，阶段二）
│   └── agents.ts                  -- AI员工API（新增，阶段二）
└── sql/
    └── 18_decision_agent.sql      -- 决策卡+AI员工建表（新增，阶段二）

client/src/App.tsx                 -- 新增3条路由
client/src/components/Layout.tsx   -- 新增导航分组
```

### 5.4 复用现有API清单

| API | 复用于 | 状态 |
|-----|--------|------|
| `GET /overview/profit-opportunity` | 决策中心·机会决策 + 指挥舱 | ✅ 已存在 |
| `GET /overview/risk` | 决策中心·风险决策 + 指挥舱 | ✅ 已存在 |
| `GET /alert/overview` | 决策中心·告警决策 | ✅ 已存在 |
| `GET /tasks` | 决策中心·执行决策 + 任务闭环 | ✅ 已存在 |
| `GET /tasks/loop-health` | 指挥舱·闭环健康度 | ✅ 已存在 |
| `GET /tasks/practices` | 知识资产 | ✅ 已存在 |
| `GET /tasks/practices/:id/replication-result` | 知识资产·推广结果 | ✅ 已存在 |
| `POST /tasks/practices/:id/replicate` | 知识资产·推广操作 | ✅ 已存在 |
| `GET /tasks/auto-generate` | 决策审批后生成任务 | ✅ 已存在 |
| `POST /intelligence/ai/forecast` | AI员工·需求预测员 | ✅ 已存在 |
| `POST /intelligence/ai/adjust-target` | AI员工·经营参谋长 | ✅ 已存在 |
| `POST /intelligence/chain/mrp` | AI员工·智能补货员 | ✅ 已存在 |

## 六、UI/UX 设计参考

### 6.1 设计原则（借鉴Demo）

- **信息密度**：B端专业风格，信息密集但不拥挤
- **决策优先**：每个页面顶部都是"需要你做什么"，而不是"数据展示"
- **证据可追溯**：每个决策/结论都有证据链，可点击查看数据来源
- **闭环可视化**：用流程条展示"信号→决策→任务→验收→知识"的转化

### 6.2 色彩规范（复用SBrainCO现有）

| 用途 | 色值 | Tailwind类 |
|------|------|-----------|
| 主色 | indigo-600 | text-indigo-600 |
| 成功 | emerald-600 | text-emerald-600 |
| 警告 | amber-600 | text-amber-600 |
| 危险 | rose-600 | text-rose-600 |
| 决策中心专属 | purple-600 | text-purple-600 |
| AI员工专属 | blue-600 | text-blue-600 |
| 知识资产专属 | teal-600 | text-teal-600 |

### 6.3 关键交互

- **决策卡**：点击展开右侧抽屉，显示证据链和审批操作
- **AI员工卡片**：hover显示职责详情，点击展开配置面板
- **闭环流程条**：5阶段横向展示，每阶段显示数量和转化率
- **知识条目**：点击展开推广结果，支持"推广到门店"操作

## 七、工作量估算

### 阶段一：MVP

| 任务 | 文件 | 工作量 |
|------|------|--------|
| 决策中心页面 | DecisionsPage.tsx + DecisionCard.tsx + DecisionDrawer.tsx | 中 |
| AI员工组织页面 | AgentsPage.tsx + AgentCard.tsx + agents.ts | 小 |
| 知识资产页面 | KnowledgePage.tsx + KnowledgeCard.tsx | 小 |
| 指挥舱升级 | BossPage.tsx + DecisionSummary.tsx + LoopHealthBar.tsx | 小 |
| 任务闭环升级 | TasksPage.tsx | 小 |
| 路由+导航 | App.tsx + Layout.tsx | 小 |
| 部署验证 | deploy.sh | 小 |

### 阶段二：增强

| 任务 | 文件 | 工作量 |
|------|------|--------|
| decision_card建表 | 18_decision_agent.sql | 小 |
| agent_config建表 | 18_decision_agent.sql | 小 |
| 决策API | decisions.ts | 中 |
| AI员工API | agents.ts | 小 |
| 决策自动生成 | scheduler/task-handlers.ts | 中 |
| 前端对接持久化 | DecisionsPage.tsx + AgentsPage.tsx | 中 |

### 阶段三：深化

| 任务 | 文件 | 工作量 |
|------|------|--------|
| 决策审批→自动生成任务 | decisions.ts + tasks.ts | 小 |
| 任务验收→自动沉淀知识 | tasks.ts | 中 |
| 知识自动推荐 | decisions.ts | 中 |

## 八、风险与应对

| 风险 | 影响 | 应对 |
|------|------|------|
| 利润机会API数据质量 | 决策中心展示的金额不准确 | 已修复门店级计算逻辑，后续持续监控 |
| 标杆实践表数据为空 | 知识资产页面无内容 | 阶段一先展示空状态，阶段三自动沉淀后逐步填充 |
| 决策聚合逻辑复杂 | 3类信号格式不统一 | 在 decision-aggregator.ts 中统一转换为决策卡格式 |
| AI员工"今日交付数"统计 | 需要调多个API | 阶段一用静态配置，阶段二从agent_config动态统计 |

## 九、验收标准

### 阶段一验收

- [ ] `/decisions` 页面可展示3类决策（机会/风险/执行），点击可展开详情
- [ ] `/agents` 页面可展示10个AI员工卡片，状态正确
- [ ] `/knowledge` 页面可展示标杆实践列表，支持推广操作
- [ ] `/boss` 指挥舱新增待决策清单和闭环健康度
- [ ] `/tasks` 任务页新增闭环流程条
- [ ] 侧边栏新增"智脑决策"导航分组
- [ ] 部署到 dm.all8ai.top 可正常访问

### 阶段二验收

- [ ] 决策审批后状态持久化，刷新页面不丢失
- [ ] AI员工配置可在页面修改并保存
- [ ] 定时任务每日自动生成决策卡
- [ ] 决策审批后自动生成整改任务

### 阶段三验收

- [ ] 任务验收通过后自动生成标杆实践条目
- [ ] 新决策生成时自动推荐匹配的历史案例
- [ ] "信号→决策→任务→验收→知识"全链路可追溯

## 十、里程碑

| 里程碑 | 内容 | 交付物 |
|--------|------|--------|
| M1 | 阶段一完成 | 3个新页面 + 2个升级页面，部署上线 |
| M2 | 阶段二完成 | 决策持久化 + AI员工配置 + 自动生成 |
| M3 | 阶段三完成 | 全自动闭环 + 知识自动沉淀 |

---

> 本方案基于 RestaurantChainBrainDemo 概念原型和 SBrainCO 生产系统现状编写。
> Demo 完成了产品概念验证，SBrainCO 将承载实际落地。