docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
236
docs/governance/console-collaboration-board.md
Normal file
236
docs/governance/console-collaboration-board.md
Normal file
@@ -0,0 +1,236 @@
|
||||
# 🎨 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)
|
||||
Reference in New Issue
Block a user