Files

T

selfrelease d373fb5f0c 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

29 KiB

Raw Blame History

玄谋智脑实际版建设方案

基于 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大模块相关）

-- 任务闭环相关（已存在）
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) — 升级现有

新增内容：

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

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

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

新增内容：

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

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

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

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

4.2.1 决策持久化

新增数据库表：

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）每日早晨自动扫描：

利润机会池 → 生成"机会决策"（6类改善方向各1条）
红色门店 → 生成"风险决策"（P0级门店各1条）
逾期任务 → 生成"执行决策"（逾期>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 将承载实际落地。

29 KiB Raw Blame History Unescape Escape

玄谋智脑实际版建设方案

一、背景与目标

1.1 背景

1.2 目标

1.3 原则

二、现状分析

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

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

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

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

三、总体架构

3.1 模块关系图

3.2 数据流

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

四、分阶段建设方案

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

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

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

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

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

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

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

4.2.1 决策持久化

4.2.2 决策自动生成

4.2.3 AI员工配置管理

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

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

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

4.3.3 知识自动推荐

五、技术方案

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

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

5.3 新增文件清单

5.4 复用现有API清单

六、UI/UX 设计参考

6.1 设计原则（借鉴Demo）

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

6.3 关键交互

七、工作量估算

阶段一：MVP

阶段二：增强

阶段三：深化

八、风险与应对

九、验收标准

阶段一验收

阶段二验收

阶段三验收

十、里程碑

29 KiB

Raw Blame History