selfrelease
d373fb5f0c
- 新增 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>
649 lines
29 KiB
Markdown
649 lines
29 KiB
Markdown
# 玄谋智脑实际版建设方案
|
||
|
||
> 基于 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 将承载实际落地。
|