Files
makemd/docs/governance/console-collaboration-board.md
Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
2026-03-16 01:31:26 +08:00

237 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🎨 Console 前端专项协作看板 (Console Collaboration Board) - V32.0
> **协作定位**:本看板负责跟踪 `dashboard/` (Console) 与 `extension/` (Plugin) 的 UI/UX 实现、交互逻辑及 API 挂载进度。
> **关联后端**[collaboration-board.md](collaboration-board.md) | **实施清单**[frontend-dev-plan.md](../frontend-dev-plan.md)
---
### Batch 01 (2026-03-14) - [FE_CORE_CLOSURE] 核心业务闭环与策略中心
#### **[AI-FE] UI/UX 核心交互 (Core Interaction)**
- **[FE_ADV_01] 统一建议中心页面 (Advice Center Hub)**:
- **子任务**:
- [ ] 实现 `/strategy/advice` 统一列表页 (Card-based Layout).
- [ ] 接入 `AdviceService.getPendingAdvice` 接口,支持多维过滤.
- [ ] 实现批量审批 (Batch Approve) 工具条.
- **状态**: ⏳ `in_progress` | 🛡️ Pending (API Link)
- **[FE_ADV_02] AGI 建议审批弹窗与因果链 (XAI Dialog)**:
- **子任务**:
- [ ] 开发 `SuggestionCard` 原子组件 (含 Confidence, Impact).
- [ ] 实现 `CausalChainView` 可解释性视图 (联动 `getAdviceExplanation` API).
- [ ] 集成 `ActionAuditService` 审批动作存证.
- **状态**: ⏳ `in_progress` | 🛡️ Pending (Mock-Free)
#### **[AI-EXT] 插件端增强 (Extension Perks)**
- **[EXT_SUB_01] 商品页 Suggestion Bubble 弹出逻辑**:
- **任务**: 基于当前 URL 的 `productId` 实时拉取后端建议并弹出 Bubble.
- **状态**: ✅ `completed` | 🛡️ Verified (P0 OK)
- **[EXT_AUTH_01] Console-Plugin 身份自动同步 (Auth Sync)**:
- **任务**: 登录 Console 后通过 `chrome.storage` 自动同步 JWT 至插件.
- **状态**: ✅ `completed` | 🛡️ Verified (JWT OK)
---
### Batch 02 (2026-03-14) - [FE_SOVEREIGN_VIS] 主权网络可视化与遥测
#### **[AI-FE] 分布式交互 (Distributed UI)**
- **[FE_SOV_01] 全球节点拓扑遥测视图 (Network Topology)**:
- **任务**: 使用 AntV G6 实现 P2P 节点连接的可视化展示 (联动 `NetworkTopologyService`).
- **状态**: ⏳ `pending` | 🛡️ Pending (G6 Live)
- **[FE_SEC_01] ZKP 隐私声誉证明展示 (ZKP UI)**:
- **任务**: 展示节点的 ZKP 证明生成/校验状态与信用分等级 (Badge 体系).
- **状态**: ⏳ `pending` | 🛡️ Pending (ZKP UI)
---
### Batch 03 (2026-03-14) - [FE_FIN_BIZ] 财务自治与运营遥测
#### **[AI-FE] 业务看板 (Business Dashboard)**
- **[FE_FIN_01] 实时 P&L 穿透分析看板 (Order Profit)**:
- **任务**: 展示订单级利润构成,包含摊销、汇损、运费穿透.
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_INV_01] 全球库存分布热力图 (Inventory Hotmap)**:
- **任务**: 展示海外仓库存热度与调拨建议可视化.
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_KILL_01] SKU 淘汰建议视图 (Killer Report)**:
- **任务**: 联动 `SKUEfficiencyService` 展示亏损 SKU 排行与下架建议.
- **状态**: ⏳ `pending` | 🛡️ Pending
---
### Batch 04 (2026-03-14) - [FE_AGI_INTERACT] 高交互 AGI 控制中心 (V32.0)
> **核心目标**:打破“列表+详情”的传统管理模式,构建沉浸式的人机协作终端。
#### **[AI-FE] 沉浸式交互 (Immersive UI)**
- **[FE_CMD_01] AGI 指令终端 (Omni-Box Command)**:
- **任务**: 实现全局自然语言搜索与指令框,支持问答式查询数据与下达策略调整指令.
- **状态**: ⏳ `pending` | 🛡️ Pending (LLM Stream)
- **[FE_SIM_01] What-If 策略仿真沙盒 (Strategy Sandbox)**:
- **任务**: 提供交互式滑块(调价、成本、库存),实时模拟 P&L 曲线变动,支持“一键转建议”.
- **状态**: ⏳ `pending` | 🛡️ Pending (Real-time G2)
- **[FE_FLOW_01] 视觉化 AGI 逻辑编排器 (Pipeline Builder)**:
- **任务**: 基于 React Flow 实现简单的策略流配置 UI库存 < X 则触发 Y.
- **状态**: ⏳ `pending` | 🛡️ Pending (JSON Schema)
#### **[AI-EXT] 增强插件交互 (Extension Pro)**
- **[EXT_VIS_01] 跨站点视觉寻源画布 (Visual Sourcing Canvas)**:
- **任务**: 支持在插件端直接拖拽图片发起全网寻源,并在侧边栏展示成本对比图.
- **状态**: ⏳ `pending` | 🛡️ Pending (Vision API)
---
### Batch 05 (2026-03-14) - [FE_BIZ_CHANNELS] 多端业务管理中心 (TOC / Independent / TOB)
> **核心目标**:实现对 TOC 零售、独立站以及 TOB 批发的全场景管理闭环。
#### **[AI-FE] 业务中枢 (Business Hub)**
- **[FE_TOC_01] TOC 消费者运营工作台 (Consumer Ops)**:
- **任务**: 实现订单全生命周期追踪、多语种售后 RAG 交互界面.
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_SITE_01] 独立站 (Shopify/Direct) 管理矩阵**:
- **任务**: 站点健康度监控、SEO 关键词热力图、跨域名流量一键同步 UI.
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_TOB_01] TOB 批发与寻源询价 (Wholesale & RFQ)**:
- **任务**: 实现 RFQ 待办看板、阶梯报价矩阵编辑器、大客户信用分级视图.
- **状态**: ⏳ `pending` | 🛡️ Pending
---
### Batch 06 (2026-03-14) - [FE_ERP_CORE] ERP 执行中枢 (SKU / Sourcing / WMS / Logistics)
> **核心目标**:补全 ERP 核心执行模块,实现从“商品建模”到“物流交付”的全链路物理闭环。
#### **[AI-FE] 供应链执行 (Supply Chain Execution)**
- **[FE_ERP_SKU] 全球 SKU 主数据管理中心 (SKU Master)**:
- **任务**: 实现多维属性编辑器、平台级 SKU 映射矩阵、多媒体资产管理 (DAM).
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_ERP_SOURCING] 采购与寻源生命周期 (Procurement)**:
- **任务**: 实现从 AGI 建议一键转采购单 (PO)、到货质检 (QC) 入口、入库单同步.
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_ERP_WMS] AGI 驱动的智能仓储 (WMS Ops)**:
- **任务**: 实现可视化库位管理图、拣货波次进度条、拣货路径预览交互.
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_ERP_LOG] 跨境物流与面单中心 (Logistics Hub)**:
- **任务**: 实现多渠道运费实时比价列表、打单发货工作台、包裹轨迹实时地图.
- **状态**: ⏳ `pending` | 🛡️ Pending
---
### Batch 07 (2026-03-14) - [FE_ERP_WORKBENCH] ERP 高交互工作台 (OMS / CS / Finance)
> **核心目标**提供生产级订单处理、售后协作与财务对账视图实现“一站式”ERP 闭环体验。
#### **[AI-FE] 业务生产力 (Business Productivity)**
- **[FE_OMS_01] 统一订单工作台 (OMS Workbench)**:
- **任务**: 实现多渠道筛选、批量审核/发货工具条、异常标记与 AGI 改派建议联动.
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_CS_01] 售后与客服协同中心 (CS Dashboard)**:
- **任务**: 实现售后工单详情、AGI 生成的回复建议/协商方案预览、一键退款审批.
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_FIN_01] 财务对账与收支日历 (Finance Calendar)**:
- **任务**: 实现财务对账差异下钻视图、收支时间轴日历、现金流 AGI 预测图表.
- **状态**: ⏳ `pending` | 🛡️ Pending
---
---
### Batch 08 (2026-03-14) - [FE_GOV_INBOX] 治理与任务中枢 (Inbox & Approval)
#### **[AI-FE] 协同交互 (Collaboration UI)**
- **[FE_INBOX_01] 统一任务收件箱 (Global Inbox UI)**:
- **任务**: 实现全局待办列表,支持按来源模块、优先级、截止时间过滤 (联动 `UnifiedTaskService`).
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_APPROVE_01] 通用审批中心 UI (Approval Center)**:
- **任务**: 开发统一审批详情组件展示变更前后对比、AGI 建议与影响评估.
- **状态**: ⏳ `pending` | 🛡️ Pending
---
### Batch 09 (2026-03-14) - [FE_REP_BI] 数据分析与 AGI 报表 (BI Center)
#### **[AI-FE] 决策支持 (Decision Support)**
- **[FE_REP_01] 报表中心工作台 (Report Hub)**:
- **任务**: 分组展示销售、库存、供应链、财务报表,支持维度切换与导出.
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_BI_01] 自助分析与 AGI 报表生成 (Natural Language BI)**:
- **任务**: 提供「维度-指标」拖拽界面,支持 AGI 语义解析生成可视化图表.
- **状态**: ⏳ `pending` | 🛡️ Pending
---
### Batch 10 (2026-03-14) - [FE_CRM_360] 客户主权资产看板 (CRM)
#### **[AI-FE] 资产管理 (Asset UI)**
- **[FE_CRM_01] 客户 360 档案与商机看板 (CRM UI)**:
- **任务**: 实现 TOC/TOB 统一档案,展示订单历史、客诉、信用评分与商机漏斗.
- **状态**: ⏳ `pending` | 🛡️ Pending
---
### Batch 11 (2026-03-14) - [FE_GOV_CONFIG] 配置中心与 A/B 实验平台
#### **[AI-FE] 策略治理 (Policy UI)**
- **[FE_CONF_01] 统一配置中心页面 (Config Manager)**:
- **任务**: 实现 Feature Flag、风控阈值、策略参数的颗粒度管理 UI.
- **状态**: ⏳ `pending` | 🛡️ Pending
- **[FE_EXP_01] A/B 实验与策略分桶平台 (Experiment Hub)**:
- **任务**: 展示实验目标、分组策略、KPI 对比分析图表.
- **状态**: ⏳ `pending` | 🛡️ Pending
---
### Batch 12 (2026-03-14) - [FE_SB_SIM] What-If 策略仿真与沙盒控制
#### **[AI-FE] 策略仿真 (Simulation UI)**
- **[FE_SB_01] 沙盒模式切换与模拟看板 (Sandbox Dashboard)**:
- **任务**: 实现全局沙盒模式开关,展示在模拟环境下的策略执行 KPI 预测结果.
- **状态**: ⏳ `pending` | 🛡️ Pending
---
### Batch 13 (2026-03-14) - [FE_ALRT_OBS] 告警与可观测性中心
#### **[AI-FE] 运维遥测 (Ops UI)**
- **[FE_ALRT_01] 统一告警与观察中心 (Alert Hub UI)**:
- **任务**: 聚合节点异常、任务失败、库存超阈告警,展示 AGI 自愈记录.
- **状态**: ⏳ `pending` | 🛡️ Pending
---
### Batch 14 (2026-03-14) - [FE_AI_CREATIVE] 多模态 AGI 创作工作台
#### **[AI-FE] 内容生产 (Content UI)**
- **[FE_CRE_01] AI 创作工作台与任务列表 (Creative Workbench)**:
- **任务**: 提供商品图生成、视频翻译、TTS 语音合成的任务下发与素材库 UI.
- **状态**: ⏳ `pending` | 🛡️ Pending
---
### 📊 全栈前端落地执行矩阵 (Frontend Execution Matrix)
| 任务 ID | 模块属性 | 核心描述 | 关键 UI 组件 | 状态 | 负责人 | 生产校验 |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `FE_ADV_01` | **核心/策略** | **统一建议中心页面 (Advice Hub)** | `AdviceList`, `FilterBar` | ⏳ `in_progress` | AI-FE | 🛡️ Pending |
| `FE_ADV_02` | **核心/UI** | **AGI 建议审批与因果链 (XAI)** | `CausalChainChart` | ⏳ `in_progress` | AI-FE | 🛡️ Pending |
| `EXT_SUB_01` | **插件/业务** | **商品页 Suggestion Bubble** | `SuggestionBubble` | ✅ `completed` | AI-EXT | 🛡️ Verified |
| `EXT_AUTH_01` | **插件/架构** | **Console-Plugin 身份同步** | `AuthBridge` | ✅ `completed` | AI-EXT | 🛡️ Verified |
| `FE_SOV_01` | **架构/遥测** | **全球节点拓扑遥测视图 (G6)** | `NetworkTopologyGraph` | ⏳ `in_progress` | AI-FE | 🛡️ Pending |
| `FE_SEC_01` | **安全/UI** | **ZKP 隐私声誉证明展示** | `ReputationBadge` | ⏳ `in_progress` | AI-FE | 🛡️ Pending |
| `FE_FIN_01` | **业务/财务** | **实时 P&L 穿透分析看板** | `ProfitBreakdownChart` | ⏳ `in_progress` | AI-FE | 🛡️ Pending |
| `FE_INV_01` | **业务/库存** | **全球库存分布热力图** | `InventoryWorldMap` | ⏳ `in_progress` | AI-FE | 🛡️ Pending |
| `FE_HEAL_01` | **内核/运维** | **AGI 自愈异常上报看板** | `AnomalyRCAView` | ⏳ `pending` | AI-FE | 🛡️ Pending |
| `EXT_HEAL_01`| **插件/内核** | **插件端页面结构自愈上报** | `AnomalyReporter` | ⏳ `pending` | AI-EXT | 🛡️ Pending |
---
### 🛡️ 前端质量红线 (Frontend Red Lines)
1. **Zero-Mock Policy**:严禁 Mock 数据。所有展示必须基于 [AdviceService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Strategy/AdviceService.ts) 或相关生产接口。
2. **Causal Chain Enforcement**:任何 AI 建议展示必须具备 [UX_XAI_01](file:///d:/trae_projects/crawlful-hub/server/src/api/controllers/BizStrategyController.ts) 定义的因果链入口。
3. **Traceability**:所有操作必须注入 `x-trace-id`,并支持从 UI 一键跳转至 [AuditLog](file:///d:/trae_projects/crawlful-hub/server/src/core/runtime/DomainRegistry.ts)。
4. **FSM Consistency**UI 交互状态必须严格遵循后端定义的状态机PENDING -> APPROVED -> EXECUTED
---
**看板维护者**AI-FE | **当前版本**V32.0
**关联规格**[task-specifications.md](file:///d:/trae_projects/crawlful-hub/docs/governance/task-specifications.md)