feat: 新增智脑决策中心模块（决策中心/AI员工组织/知识资产）

- 新增 DecisionsPage、AgentsPage、KnowledgePage 三个页面 - 新增 DecisionCard、DecisionDrawer、DecisionSummary、KnowledgeCard、LoopHealthBar、AgentCard 组件 - 新增 decision-aggregator 决策聚合逻辑和 agents 数据 - Layout 导航重构：新增智脑决策分组，调整系统配置和经营本体分组 - BossPage 集成决策摘要和闭环健康度，利润机会池支持警告样式 - TasksPage 增强任务展示 - 抽屉式详情统一改为居中弹窗风格 - data.ts 后端调整 - run.md 更新数据库连接说明 - 新增玄谋智脑实际版建设方案文档 Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-08-14 19:34:04 +08:00
parent 8fd74fd78c
commit d373fb5f0c
19 changed files with 2231 additions and 22 deletions
@@ -0,0 +1,648 @@
+# 玄谋智脑实际版建设方案
+
+> 基于 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 将承载实际落地。
@@ -48,6 +48,7 @@
 |------|------|
 | [16-战略外脑实施方法论.md](16-战略外脑实施方法论.md) | 战略外脑七项能力、十二步工作法、治理规范、实施路径与验收标准 |
 | [17-SBrainCO战略外脑建设对照表.md](17-SBrainCO战略外脑建设对照表.md) | 将方法论映射为 SBrainCO 的领域模型、产品模块、API 和分阶段待办 |
+| [18-玄谋智脑实际版建设方案.md](18-玄谋智脑实际版建设方案.md) | 基于 Demo 概念原型，在 SBrainCO 中构建6大模块实际版的分阶段方案 |
 | [调查表/战略外脑能力验收Checklist.csv](调查表/战略外脑能力验收Checklist.csv) | 35项战略外脑能力与实施验收检查项 |

 ## 文档目录结构