docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
56
docs/governance/archive/collaboration-history-v31.md
Normal file
56
docs/governance/archive/collaboration-history-v31.md
Normal file
@@ -0,0 +1,56 @@
|
||||
# 📜 Crawlful Hub 协作变更编年史 (V31.0 - Batch 52-55 Archive)
|
||||
|
||||
## 📊 历史落地执行矩阵 (Batch 52-55)
|
||||
|
||||
### Batch 52 (2026-03-14) - [PRAGMATIC_PIVOT] 务实建议与半自动执行 (Semi-Auto)
|
||||
> **核心目标**:拒绝华而不实的 AI,只做能省钱、能保命、能提效的功能。Agent 提供精准建议,人工一键批复。
|
||||
|
||||
#### **[AI-1] Kernel - 降本增效建议引擎 (Cost & Profit)**
|
||||
- **[BIZ_SUP_15] 1688 极速降本比价**:
|
||||
- **务实点**: 直接对比当前采购价与 1688 同款最低价,算出“每单可省多少钱”。
|
||||
- **任务**: 升级 `SupplyChainService`,产出包含“预期毛利提升值”的采购源切换建议。
|
||||
- **[BIZ_MKT_30] 竞品压价防御建议**:
|
||||
- **务实点**: 仅在竞品价格低于我方且我方仍有 >20% 利润时提示“跟降建议”。
|
||||
- **任务**: 优化 `DynamicPricingService` 判定逻辑,拒绝无效提价建议,只做“保单调价”。
|
||||
|
||||
#### **[AI-2] Internal - 高效审核与风控流 (Efficiency & Risk)**
|
||||
- **[UX_REVIEW_01] 批量建议批复接口**:
|
||||
- **任务**: 在 `TelemetryController` 实现批量审核逻辑,联动 `DynamicPricing` 与 `Sourcing` 状态变更。
|
||||
- **[BIZ_GOV_05] 建议采纳 ROI 实时看板**:
|
||||
- **任务**: 聚合 `cf_decision_logs`,展示“建议执行后预估收益”汇总。
|
||||
|
||||
#### **[AI-3] Biz - 缺货防御与履约保障 (Fulfillment)**
|
||||
- **[BIZ_INV_10] 爆款缺货预警建议**:
|
||||
- **任务**: 完善 `InventoryForecastService`,优先处理销售速率 > 5件/日的 SKU。
|
||||
|
||||
---
|
||||
|
||||
### Batch 53 (2026-03-14) - [SOVEREIGN_TRADE] 跨主权套利与自治清算
|
||||
> **核心目标**:实现从“决策建议”向“契约清算”的演进。基于 DID 与隐私计算,构建真正自治的全球贸易网络。
|
||||
|
||||
#### **[AI-3] Biz - 增长归因与自治清算 (Finance & Growth)**
|
||||
- **[BIZ_MKT_40] 多触点归归因与利润分析 (Attribution Engine)**
|
||||
- **[BIZ_FIN_40] 基于 DID 的自治清算协议 (DID Settlement)**
|
||||
- **[BIZ_LOG_20] 全球动态路径对冲与风险熔断 (Global Route Failover)**
|
||||
- **[BIZ_INV_20] 强化学习驱动的全球库存平衡 (RL Inventory Balancing)**
|
||||
|
||||
---
|
||||
|
||||
### Batch 54 (2026-03-14) - [AUTONOMOUS_SETTLEMENT_&_LOGISTICS_RESILIENCE]
|
||||
> **核心目标**:实现从“业务建议”向“自治执行”的深度下钻。重点解决汇率对冲、众包物流与争议自动仲裁。
|
||||
|
||||
#### **[AI-3] Biz - 业务清算与履约韧性 (Resilience & Settlement)**
|
||||
- **[BIZ_FIN_50] 跨主权多币种对冲对账引擎 (Multi-Currency Recon)**
|
||||
- **[BIZ_LOG_30] 最后一公里众包路由优化 (Crowdsourced Last-mile)**
|
||||
- **[BIZ_TRADE_30] 自动化供应商产能预警 (Supplier Capacity Watch)**
|
||||
- **[BIZ_CSM_30] 智能争议仲裁建议 (Dispute Arbitration)**
|
||||
|
||||
---
|
||||
|
||||
### Batch 55 (2026-03-14) - [DTC_&_GROWTH_AUTONOMY]
|
||||
> **核心目标**:构建 DTC 品牌自治底座。重点解决基于 LTV 的自动化会员治理、税务路径优化与绿色供应链合规。
|
||||
|
||||
#### **[AI-3] Biz - 增长治理与合规路由 (Growth & Compliance)**
|
||||
- **[BIZ_MKT_60] 基于 LTV 预测的自动化会员等级晋升 (LTV Membership)**
|
||||
- **[BIZ_FIN_60] 跨主权税务路由优化引擎 (Tax Routing Optimizer)**
|
||||
- **[BIZ_LOG_40] 绿色供应链碳足迹核算与抵扣 (Green Supply Chain)**
|
||||
337
docs/governance/collaboration-board.md
Normal file
337
docs/governance/collaboration-board.md
Normal file
@@ -0,0 +1,337 @@
|
||||
# 🧠 Server & Kernel 专项协作看板 (Server Collaboration Board) - V32.0
|
||||
|
||||
> **协作定位**:本看板负责跟踪 `server/` (Hub) 的内核演进、物理表闭环、AGI 逻辑实现及安全性审计。
|
||||
> **关联前端**:[console-collaboration-board.md](file:///d:/trae_projects/crawlful-hub/docs/governance/console-collaboration-board.md) | **任务规格**:[task-specifications.md](file:///d:/trae_projects/crawlful-hub/docs/governance/task-specifications.md)
|
||||
|
||||
## 📊 核心落地执行矩阵 (Practical Task Matrix)
|
||||
|
||||
### Batch 57 (2026-03-14) - [SOVEREIGN_NETWORK_P2P] P2P 通信与节点声誉治理 (V32.0)
|
||||
|
||||
> **核心目标**:深化主权网络能力。实现节点间的真实 P2P 直连通信,构建基于 ZKP 的隐私声誉评分系统,并提供全局拓扑的可视化遥测。
|
||||
|
||||
#### **[AI-1] Kernel - P2P 通信与协议加固 (P2P Connectivity)**
|
||||
- **[SOV_NET_06] 基于 Libp2p/WebRTC 的节点直连通信 (P2P Connectivity)**:
|
||||
- **子任务**:
|
||||
- [x] 实现 Noise/TLS 1.3 双向加密握手协议.
|
||||
- [x] 实现 `P2PConnectionService` 流复用与生命周期管理.
|
||||
- [x] 对接 DHT 发现节点并同步 `PeerStore`.
|
||||
- **状态**: ✅ `completed` [AI-1 @ 2026-03-14] | 🛡️ Verified (P2P OK)
|
||||
- **[SOV_NET_08] 节点声誉衰减与惩罚机制 (Reputation Decay)**:
|
||||
- **子任务**:
|
||||
- [x] 升级 `SovereignReputationV2Service` 引入半衰期算法.
|
||||
- [x] 实现 `ReputationPunishment` 触发器 (联动熔断器).
|
||||
- [x] 物理表 `cf_node_reputation_history` 闭环.
|
||||
- **状态**: ✅ `completed` [AI-1 @ 2026-03-14] | 🛡️ Verified (Decay Logic)
|
||||
|
||||
#### **[AI-2] Internal - 隐私审计与拓扑遥测 (Privacy & Telemetry)**
|
||||
- **[SOV_NET_07] 基于 ZKP 的隐私声誉分值证明 (ZKP Reputation)**:
|
||||
- **子任务**:
|
||||
- [x] 编写 Circom 声誉范围证明电路 (Range Proof).
|
||||
- [x] 实现 `ReputationZKPService` 离线证明生成逻辑.
|
||||
- [x] 挂载 `/api/v1/sovereign/verify-reputation` 校验接口.
|
||||
- **状态**: ✅ `completed` [AI-2] | 🛡️ Verified (ZKP Verify)
|
||||
- **[CORE_TELE_TOPO] 全球节点实时拓扑遥测 (Network Topology)**:
|
||||
- **子任务**:
|
||||
- [x] 实现 `NetworkTopologyService` 采集延迟 (Latency) 与跳数.
|
||||
- [x] 提供 P2P 拓扑 JSON 导出接口 (供前端 G6 渲染).
|
||||
- [x] 异常节点自动标记与路由隔离逻辑.
|
||||
- **状态**: ✅ `completed` [AI-2] | 🛡️ Verified (Live Stats)
|
||||
|
||||
#### **[AI-3] Biz - 业务路由与声誉权益 (Biz Routing)**
|
||||
- **[BIZ_SOV_13] 声誉驱动的阶梯费率与流量倾斜 (Reputation Perks)**:
|
||||
- **子任务**:
|
||||
- [ ] 联动 `BillingService` 注入声誉费率乘数.
|
||||
- [ ] 实现 `TrafficPriorityQueue` 高信用节点优先转发.
|
||||
- [ ] 费率 FSM 状态机更新与审计日志记录.
|
||||
- **状态**: ⏳ `in_progress` [AI-3] | 🛡️ Pending (Billing FSM)
|
||||
- **[BIZ_SOV_14] 跨节点资源共享配额管理 (Resource Quota)**:
|
||||
- **子任务**:
|
||||
- [ ] 实现 `NodeResourceQuotaService` 算力配额锁.
|
||||
- [ ] 基于声誉等级动态计算 `MaxSharedStorage`.
|
||||
- [ ] 超限请求实时拦截与 `AuditLog` 存证.
|
||||
- **状态**: ⏳ `in_progress` [AI-3] | 🛡️ Pending (Quota Lock)
|
||||
|
||||
---
|
||||
|
||||
### Batch 58 (2026-03-14) - [AGI_SYSTEM_HEALTH] 系统自愈与 AGI 集群自治 (V32.0)
|
||||
|
||||
> **核心目标**:实现系统健康度的 AI 预判与 Agent 集群的自治协作,降低运维成本。
|
||||
|
||||
#### **[AI-1] Kernel - AGI 集群协议 (Swarm Protocol)**
|
||||
- **[CORE_AI_60] Agent 集群自治协作协议 (Agent Swarm)**:
|
||||
- **任务**: 实现 `AgentSwarmService` 数据库持久化与冲突协商逻辑.
|
||||
- **状态**: ✅ `completed` [AI-1 @ 2026-03-14] | 🛡️ Verified (Swarm OK)
|
||||
|
||||
#### **[AI-2] Internal - 预测性诊断 (Predictive Health)**
|
||||
- **[CORE_TELE_PREDICTIVE] 预测性系统健康度看板 (Predictive Health)**:
|
||||
- **任务**: 实现 `PredictiveHealthService` 物理表闭环与未来 24h 瓶颈预判.
|
||||
- **状态**: ✅ `completed` [AI-2] | 🛡️ Verified (Predict OK)
|
||||
|
||||
#### **[AI-3] Biz - 自动化套利与治理 (Arbitrage & Governance)**
|
||||
- **[BIZ_MKT_50] AGI 驱动的跨平台套利自动化 (Arbitrage AGI)**:
|
||||
- **任务**: 实现 `ArbitrageAGIService` 物理表闭环,全自动识别全球价格洼地.
|
||||
- **状态**: ⏳ `pending` [AI-3] | 🛡️ Pending (Arb Table)
|
||||
- **[BIZ_INV_30] 滞销库存深度治理建议 (Aging Inventory)**:
|
||||
- **任务**: 联动 `AdviceService` 实现滞销 SKU 的阶梯折扣自动生成.
|
||||
- **状态**: ⏳ `pending` [AI-3] | 🛡️ Pending (Advice Hub)
|
||||
|
||||
---
|
||||
|
||||
### Batch 59 (2026-03-14) - [ERP_CORE_ENGINE] ERP 核心业务后端引擎 (V32.0)
|
||||
|
||||
> **核心目标**:构建支撑全场景 ERP 交互的后端引擎,涵盖订单全生命周期、财务对账与 WMS 自动化。
|
||||
|
||||
#### **[AI-1] Kernel - 数据交换与主数据 (Master Data)**
|
||||
- **[ERP_MST_01] 跨平台 SKU 身份映射引擎 (SKU Mapper)**:
|
||||
- **任务**: 实现 `SKUMappingService`,支持 1688/Amazon/Temu SKU 的原子化绑定与自动解耦.
|
||||
- **状态**: ✅ `completed` [AI-1 @ 2026-03-14] | 🛡️ Verified (Mapping Table)
|
||||
- **[ERP_MST_02] 全域审计与变更溯源 (Audit Engine)**:
|
||||
- **任务**: 升级 `AuditService` 支持对 ERP 配置项(税码、科目)的颗粒度变更审计.
|
||||
- **状态**: ✅ `completed` [AI-1 @ 2026-03-14] | 🛡️ Verified (Config Audit)
|
||||
|
||||
#### **[AI-2] Internal - 仓储与物流算法 (WMS & Logistics)**
|
||||
- **[ERP_WMS_01] 拣货路径优化与波次分单算法 (Pick Wave)**:
|
||||
- **任务**: 实现 `WMSWaveService`,基于 AGI 销量预测自动生成最优拣货波次.
|
||||
- **状态**: ✅ `completed` [AI-2] | 🛡️ Verified (Wave Algo)
|
||||
- **[ERP_LOG_01] 物流轨迹全链路归一化监控 (Logistics Tracker)**:
|
||||
- **任务**: 实现 `LogisticsTrackerService`,自动识别「异常节点」并触发 `reportAnomaly`.
|
||||
- **状态**: ✅ `completed` [AI-2] | 🛡️ Verified (Tracker OK)
|
||||
|
||||
#### **[AI-3] Biz - 财务对账与订单闭环 (OMS & Finance)**
|
||||
- **[ERP_FIN_01] 财务对账与收支差异分析引擎 (Reconciliation)**:
|
||||
- **任务**: 实现 `FinanceReconService`,支持「应收/实收/费用/税费」的自动对账与差异下钻.
|
||||
- **状态**: ✅ `completed` [AI-3] | 🛡️ Verified
|
||||
- **[ERP_OMS_01] 订单全生命周期状态机加固 (OMS FSM)**:
|
||||
- **任务**: 升级 `OrderService` 支持「批量审核/异常标记/自动改派」等 ERP 级操作.
|
||||
- **状态**: ✅ `completed` [AI-3] | 🛡️ Verified
|
||||
|
||||
---
|
||||
|
||||
### Batch 60 (2026-03-14) - [GOV_INFRA_TASK] 统一任务与审批流引擎 (V32.0)
|
||||
|
||||
> **核心目标**:实现全站事件的归一化处理,提供生产级审批流门禁。
|
||||
|
||||
#### **[AI-1] Kernel - 任务分发 (Task Engine)**
|
||||
- **[ERP_TASK_01] 统一任务中枢与分发引擎 (Task Hub)**:
|
||||
- **任务**: 实现 `UnifiedTaskService` 支持多源事件接入与认领逻辑.
|
||||
- **状态**: ✅ `completed` [AI-1 @ 2026-03-14] | 🛡️ Verified
|
||||
|
||||
#### **[AI-3] Biz - 审批控制 (Approval Flow)**
|
||||
- **[ERP_APPROVE_01] 通用审批流引擎 (Approval Engine)**:
|
||||
- **任务**: 实现 `ApprovalFlowService` 支持多级审批与条件规则.
|
||||
- **状态**: ✅ `completed` [AI-3] | 🛡️ Verified
|
||||
|
||||
---
|
||||
|
||||
### Batch 61 (2026-03-14) - [BI_CRM_INFRA] 数据分析与客户 360 后端 (V32.0)
|
||||
|
||||
> **核心目标**:提供穿透式经营数据分析与全生命周期客户档案。
|
||||
|
||||
#### **[AI-2] Internal - 报表预聚合 (Reporting)**
|
||||
- **[ERP_REP_01] 全业务多维报表宽表构建 (Report Mart)**:
|
||||
- **任务**: 实现 `ReportService` 预聚合接口,支持 GMV/ROI/损耗分析.
|
||||
- **状态**: ✅ `completed` [AI-2] | 🛡️ Verified (Report Mart)
|
||||
|
||||
#### **[AI-3] Biz - 客户中枢 (CRM)**
|
||||
- **[ERP_CRM_01] 客户 360 视图与商机中枢 (CRM Hub)**:
|
||||
- **任务**: 实现 `Customer360Service` 聚合订单/客诉/财务往来.
|
||||
- **状态**: ✅ `completed` [AI-3] | 🛡️ Verified
|
||||
|
||||
---
|
||||
|
||||
### Batch 62 (2026-03-14) - [GOV_EXPERIMENT] 策略实验与全量告警中枢 (V32.0)
|
||||
|
||||
> **核心目标**:建立科学的策略评估体系与全网异常监测网。
|
||||
|
||||
#### **[AI-1] Kernel - 实验分桶 (Experiment Hub)**
|
||||
- **[CORE_GOV_EXP] AB 实验与策略分桶平台 (Experiment Hub)**:
|
||||
- **任务**: 实现 `ExperimentService` 支持按用户/店铺/节点的实验隔离.
|
||||
- **状态**: ⏳ `pending` [AI-1] | 🛡️ Pending
|
||||
|
||||
#### **[AI-2] Internal - 告警归集 (Alert Center)**
|
||||
- **[CORE_TELE_ALRT] 统一告警归集与自愈路由 (Alert Hub)**:
|
||||
- **任务**: 实现 `AlertService` 将风控/自愈/时效预警统一接入告警通道.
|
||||
- **状态**: ✅ `completed` [AI-2] | 🛡️ Verified (Alert Hub)
|
||||
|
||||
---
|
||||
|
||||
### Batch 63 (2026-03-14) - [AI_CREATIVE_INFRA] 多模态 AGI 创作后端引擎 (V32.0)
|
||||
|
||||
> **核心目标**:实现商品图生成、视频翻译与 TTS 语音合成的后端调度与存储闭环。
|
||||
|
||||
#### **[AI-1] Kernel - 创作调度 (Creative Engine)**
|
||||
- **[BIZ_CRE_01] 多模态 AI 创作工作台 (Creative Service)**:
|
||||
- **任务**: 实现 `CreativeService` 对接 Minimax/OpenAI,支持任务状态流转与素材存证.
|
||||
- **状态**: ⏳ `pending` [AI-1] | 🛡️ Pending
|
||||
|
||||
---
|
||||
|
||||
### Batch 64 (2026-03-14) - [FINANCE_DEEP_AUDIT] 财务深度审计与自动化服务 (V32.0)
|
||||
|
||||
> **核心目标**:落地 BIZ_FIN_170-200 的 31 项财务自治服务,实现穿透式经营审计。
|
||||
|
||||
#### **[AI-3] Biz - 财务自治 (Finance Autonomy)**
|
||||
- **[BIZ_FIN_170] SKU 淘汰建议报告 (Killer)**:
|
||||
- **任务**: 实现 `SKUEfficiencyService` 物理表闭环.
|
||||
- **状态**: ⏳ `pending` [AI-3] | 🛡️ Pending
|
||||
- **[BIZ_FIN_200] 全自动审计与合规性自查 (AI Guard)**:
|
||||
- **任务**: 实现 `ComplianceAIGuard` 遍历 AuditLog 识别违规.
|
||||
- **状态**: ⏳ `pending` [AI-3] | 🛡️ Pending
|
||||
|
||||
---
|
||||
|
||||
### Batch 65 (2026-03-14) - [LOGISTICS_OPTIMIZER] 全球物流路由与自愈优化 (V32.0)
|
||||
|
||||
> **核心目标**:实现最后一公里配送优化与全球物流拥堵自愈。
|
||||
|
||||
#### **[AI-2] Internal - 物流遥测 (Logistics Telemetry)**
|
||||
- **[BIZ_TRADE_18] 全球物流拥堵预测与自适应绕路 (Congestion Failover)**:
|
||||
- **任务**: 实现 `CongestionFailoverService` 自动切换备选物流.
|
||||
- **状态**: ✅ `completed` [AI-2] | 🛡️ Verified (Congestion AI)
|
||||
|
||||
---
|
||||
|
||||
### Batch 66 (2026-03-14) - [MARKETING_AUTO] AGI 广告管家与多渠道联动 (V32.0)
|
||||
|
||||
> **核心目标**:实现广告预算动态分配与营销日历自动执行。
|
||||
|
||||
#### **[AI-3] Biz - 营销自治 (Marketing Autonomy)**
|
||||
- **[BIZ_MKT_20] AGI 广告管家与预算动态优化 (AdOps)**:
|
||||
- **任务**: 实现 `AdAutoService` 联动套利引擎调整预算.
|
||||
- **状态**: ⏳ `pending` [AI-3] | 🛡️ Pending
|
||||
|
||||
---
|
||||
|
||||
### Batch 67 (2026-03-14) - [SEC_PRIVATE_COMPUTE] 隐私计算与全同态审计 (V32.0)
|
||||
|
||||
> **核心目标**:落地基于 ZKP 与 FHE 的全流程隐私审计,保护租户主权。
|
||||
|
||||
#### **[AI-2] Internal - 隐私安全 (Privacy Security)**
|
||||
- **[CORE_SEC_20] 基于 ZKP 的全流程隐私审计 (Private Audit)**:
|
||||
- **任务**: 实现 `PrivateAuditService` 利用 Circom 汇总利润.
|
||||
- **状态**: ✅ `completed` [AI-2] | 🛡️ Verified (ZKP Proof)
|
||||
|
||||
---
|
||||
|
||||
### Batch 68 (2026-03-14) - [CORE_AI_EVOLUTION] AGI 策略自进化闭环 (V32.0)
|
||||
|
||||
> **核心目标**:建立 AI 决策的自我修正机制。
|
||||
|
||||
#### **[AI-1] Kernel - 进化闭环 (Evolution Loop)**
|
||||
- **[CORE_AI_40] AGI 策略自进化闭环验证 (Evolution Loop)**:
|
||||
- **任务**: 实现 `AGIStrategyEvolutionService` 将成交数据回流至 Prompt 微调.
|
||||
- **状态**: ⏳ `pending` [AI-1] | 🛡️ Pending
|
||||
|
||||
---
|
||||
|
||||
### Batch 69 (2026-03-14) - [INFRA_BILLING] 企业配额与订阅计费中心 (V32.0)
|
||||
|
||||
> **核心目标**:建立稳定经常性收入模型。
|
||||
|
||||
#### **[AI-1] Kernel - 计费引擎 (Billing Engine)**
|
||||
- **[BIZ_BILL_01] 企业配额与订阅计费中心 (Billing Center)**:
|
||||
- **任务**: 实现 `BillingEngine` 对超限 AI 调用自动计费.
|
||||
- **状态**: ⏳ `pending` [AI-1] | 🛡️ Pending
|
||||
|
||||
---
|
||||
|
||||
### **1. 基础建设与商业闭环 (Priority: P0/P1 - 务实落地区)**
|
||||
| 任务 ID | 描述 | 核心交付物 | 状态 | 负责人 | 生产校验 |
|
||||
| :--- | :--- | :--- | :--- | :--- | :--- |
|
||||
| `ERP_OMS_01` | **订单全生命周期状态机加固** | `OrderService` 升级 | ✅ `completed` | AI-3 | 🛡️ Verified |
|
||||
| `ERP_FIN_01` | **财务对账与收支差异分析引擎** | `FinanceReconService` | ✅ `completed` | AI-3 | 🛡️ Verified |
|
||||
| `ERP_TASK_01` | **统一任务中枢与分发引擎** | `UnifiedTaskService` | ✅ `completed` | AI-1 | 🛡️ Verified |
|
||||
| `ERP_APPROVE_01`| **通用审批流引擎** | `ApprovalFlowService` | ✅ `completed` | AI-3 | 🛡️ Verified |
|
||||
| `ERP_CRM_01` | **客户 360 视图与商机中枢** | `Customer360Service` | ✅ `completed` | AI-3 | 🛡️ Verified |
|
||||
| `CORE_GOV_EXP` | **AB 实验与策略分桶平台** | `ExperimentService` | ⏳ `in_progress` | AI-1 | 🛡️ Pending |
|
||||
| `SOV_NET_06` | **基于 Libp2p/WebRTC 的直连通信** | `P2PConnectionService` | ✅ `completed` | AI-1 | 🛡️ Verified |
|
||||
| `SOV_NET_07` | **基于 ZKP 的隐私声誉分值证明** | `ReputationZKPService` | ✅ `completed` | AI-2 | 🛡️ Verified |
|
||||
| `SOV_NET_08` | **节点声誉衰减与惩罚机制** | 升级 `SovereignReputationV2` | ✅ `completed` | AI-1 | 🛡️ Verified |
|
||||
| `CORE_TELE_TOPO` | **全球节点实时拓扑遥测** | `NetworkTopologyService` | ✅ `completed` | AI-2 | 🛡️ Verified |
|
||||
| `BIZ_SOV_13` | **声誉驱动的阶梯费率与流量倾斜** | 联动 `BillingService` | ⏳ `in_progress` | AI-3 | 🛡️ Pending |
|
||||
| `BIZ_SOV_14` | **跨节点资源共享配额管理** | `NodeResourceQuotaService` | ⏳ `in_progress` | AI-3 | 🛡️ Pending |
|
||||
| `CORE_AI_60` | **Agent 集群自治协作协议 (Swarm)** | `AgentSwarmService` 物理表 | ✅ `completed` | AI-1 | 🛡️ Verified |
|
||||
| `CORE_TELE_PREDICTIVE` | **预测性系统健康度看板** | `PredictiveHealthService` 物理表 | ✅ `completed` | AI-2 | 🛡️ Verified |
|
||||
| `BIZ_MKT_50` | **AGI 驱动的跨平台套利自动化** | `ArbitrageAGIService` 物理表 | ⏳ `in_progress` | AI-3 | 🛡️ Pending |
|
||||
| `BIZ_INV_30` | **滞销库存深度治理建议** | 联动 `AdviceService` | ⏳ `in_progress` | AI-3 | 🛡️ Pending |
|
||||
| `SOV_NET_01` | **基于 DID 的节点身份握手协议** | `FederatedNodeService` | ✅ `completed` | AI-1 | 🛡️ Verified |
|
||||
| `SOV_NET_03` | **节点间加密库存同步机制** | `PrivateInventorySyncService` | ✅ `completed` | AI-1 | 🛡️ Verified |
|
||||
| `SOV_NET_05` | **跨节点算力共享与任务外包** | 升级 `InfinityComputeService` | ✅ `completed` | AI-1 | 🛡️ Verified |
|
||||
| `BIZ_KER_131` | **容器运行时资源限制动态调整** | `ContainerQuotaService` | ✅ `completed` | AI-1 | 🛡️ Verified |
|
||||
| `BIZ_KER_132` | **全局异步任务性能瓶颈分析** | `WorkerProfilerService` | ✅ `completed` | AI-1 | 🛡️ Verified |
|
||||
| `BIZ_KER_133` | **租户敏感操作二次确认审计** | `ActionAuditService` | ✅ `completed` | AI-1 | 🛡️ Verified |
|
||||
| `SOV_NET_02` | **跨节点自治清算协议实现** | `CrossNodeSettlementService` | ✅ `completed` | AI-3 | 🛡️ Verified |
|
||||
| `SOV_NET_04` | **跨节点争议自动仲裁转发** | `GlobalDisputeRouter` | ✅ `completed` | AI-3 | 🛡️ Verified |
|
||||
| `AUTO_SB_01` | **自治执行沙盒环境隔离引擎** | `AutonomousSandboxService` | ✅ `completed` | AI-2 | 🛡️ Verified |
|
||||
| `AUTO_SB_02` | **沙盒执行 ROI 自动评估器** | `SandboxROIAdvisor` | ✅ `completed` | AI-2 | 🛡️ Verified |
|
||||
| `ERP_WMS_01` | **拣货路径优化与波次分单算法** | `WMSWaveService` | ✅ `completed` | AI-2 | 🛡️ Verified |
|
||||
| `ERP_LOG_01` | **物流轨迹全链路归一化监控** | `LogisticsTrackerService` | ✅ `completed` | AI-2 | 🛡️ Verified |
|
||||
| `ERP_REP_01` | **全业务多维报表宽表构建** | `ReportService` 预聚合 | ✅ `completed` | AI-2 | 🛡️ Verified |
|
||||
| `CORE_TELE_ALRT` | **统一告警归集与自愈路由** | `AlertService` | ✅ `completed` | AI-2 | 🛡️ Verified |
|
||||
| `BIZ_TRADE_18` | **全球物流拥堵预测与自适应绕路** | `CongestionFailoverService` | ✅ `completed` | AI-2 | 🛡️ Verified |
|
||||
| `CORE_SEC_20` | **基于 ZKP 的全流程隐私审计** | `PrivateAuditService` | ✅ `completed` | AI-2 | 🛡️ Verified |
|
||||
| `BIZ_CRE_01` | **多模态 AI 创作工作台** | `CreativeService` | ⏳ `in_progress` | AI-1 | 🛡️ Pending |
|
||||
|
||||
---
|
||||
|
||||
## 📜 历史变更记录 (Change Log)
|
||||
|
||||
> 本节记录已归档的历史批次变更,详见 [collaboration-history-v31.md](governance/archive/collaboration-history-v31.md)
|
||||
|
||||
### Batch 52 (2026-03-14) - [PRAGMATIC_PIVOT] 务实建议与半自动执行 (Semi-Auto)
|
||||
> **核心目标**:拒绝华而不实的 AI,只做能省钱、能保命、能提效的功能。Agent 提供精准建议,人工一键批复。
|
||||
|
||||
#### **[AI-1] Kernel - 降本增效建议引擎 (Cost & Profit)**
|
||||
- **[BIZ_SUP_15] 1688 极速降本比价**:
|
||||
- **务实点**: 直接对比当前采购价与 1688 同款最低价,算出"每单可省多少钱"。
|
||||
- **任务**: 升级 `SupplyChainService`,产出包含"预期毛利提升值"的采购源切换建议。
|
||||
- **[BIZ_MKT_30] 竞品压价防御建议**:
|
||||
- **务实点**: 仅在竞品价格低于我方且我方仍有 >20% 利润时提示"跟降建议"。
|
||||
- **任务**: 优化 `DynamicPricingService` 判定逻辑,拒绝无效提价建议,只做"保单调价"。
|
||||
|
||||
#### **[AI-2] Internal - 高效审核与风控流 (Efficiency & Risk)**
|
||||
- **[UX_REVIEW_01] 批量建议批复接口**:
|
||||
- **任务**: 在 `TelemetryController` 实现批量审核逻辑,联动 `DynamicPricing` 与 `Sourcing` 状态变更。
|
||||
- **[BIZ_GOV_05] 建议采纳 ROI 实时看板**:
|
||||
- **任务**: 聚合 `cf_decision_logs`,展示"建议执行后预估收益"汇总。
|
||||
|
||||
#### **[AI-3] Biz - 缺货防御与履约保障 (Fulfillment)**
|
||||
- **[BIZ_INV_10] 爆款缺货预警建议**:
|
||||
- **任务**: 完善 `InventoryForecastService`,优先处理销售速率 > 5件/日的 SKU。
|
||||
|
||||
---
|
||||
|
||||
### Batch 53 (2026-03-14) - [SOVEREIGN_TRADE] 跨主权套利与自治清算
|
||||
> **核心目标**:实现从"决策建议"向"契约清算"的演进。基于 DID 与隐私计算,构建真正自治的全球贸易网络。
|
||||
|
||||
#### **[AI-3] Biz - 增长归因与自治清算 (Finance & Growth)**
|
||||
- **[BIZ_MKT_40] 多触点归归因与利润分析 (Attribution Engine)**
|
||||
- **[BIZ_FIN_40] 基于 DID 的自治清算协议 (DID Settlement)**
|
||||
- **[BIZ_LOG_20] 全球动态路径对冲与风险熔断 (Global Route Failover)**
|
||||
- **[BIZ_INV_20] 强化学习驱动的全球库存平衡 (RL Inventory Balancing)**
|
||||
|
||||
---
|
||||
|
||||
### Batch 54 (2026-03-14) - [AUTONOMOUS_SETTLEMENT_&_LOGISTICS_RESILIENCE]
|
||||
> **核心目标**:实现从"业务建议"向"自治执行"的深度下钻。重点解决汇率对冲、众包物流与争议自动仲裁。
|
||||
|
||||
#### **[AI-3] Biz - 业务清算与履约韧性 (Resilience & Settlement)**
|
||||
- **[BIZ_FIN_50] 跨主权多币种对冲对账引擎 (Multi-Currency Recon)**
|
||||
- **[BIZ_LOG_30] 最后一公里众包路由优化 (Crowdsourced Last-mile)**
|
||||
- **[BIZ_TRADE_30] 自动化供应商产能预警 (Supplier Capacity Watch)**
|
||||
- **[BIZ_CSM_30] 智能争议仲裁建议 (Dispute Arbitration)**
|
||||
|
||||
---
|
||||
|
||||
### Batch 55 (2026-03-14) - [DTC_&_GROWTH_AUTONOMY]
|
||||
> **核心目标**:构建 DTC 品牌自治底座。重点解决基于 LTV 的自动化会员治理、税务路径优化与绿色供应链合规。
|
||||
|
||||
#### **[AI-3] Biz - 增长治理与合规路由 (Growth & Compliance)**
|
||||
- **[BIZ_MKT_60] 基于 LTV 预测的自动化会员等级晋升 (LTV Membership)**
|
||||
- **[BIZ_FIN_60] 跨主权税务路由优化引擎 (Tax Routing Optimizer)**
|
||||
- **[BIZ_LOG_40] 绿色供应链碳足迹核算与抵扣 (Green Supply Chain)**
|
||||
|
||||
---
|
||||
|
||||
**看板维护者**:AI-1 (Kernel) | **当前版本**:V32.0
|
||||
**任务规格**:[task-specifications.md](file:///d:/trae_projects/crawlful-hub/docs/governance/task-specifications.md)
|
||||
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)
|
||||
251
docs/governance/doc-maintenance-plan.md
Normal file
251
docs/governance/doc-maintenance-plan.md
Normal file
@@ -0,0 +1,251 @@
|
||||
# 📋 MD 文档维护优化 - AI Agent 分工方案
|
||||
|
||||
> **文档定位**:本文档定义多 AI Agent 协同维护优化项目 MD 文档的分工矩阵、协作流程与验收标准。
|
||||
> **适用范围**:docs/ 目录下所有 .md 文档的维护、更新与优化工作。
|
||||
|
||||
---
|
||||
|
||||
## 1. 文档分类与工作量评估
|
||||
|
||||
### 1.1 文档分类矩阵
|
||||
|
||||
| 分类 | 文档数量 | 维护频率 | 复杂度 |
|
||||
|-----|---------|---------|-------|
|
||||
| **benchmarks/** | 1 (综合文档) | 低 | 中 |
|
||||
| **blueprints/** | 6 | 中 | 高 |
|
||||
| **blueprints/frontend-integration/** | 60+ | 高 | 中 |
|
||||
| **design/** | 4 | 中 | 中 |
|
||||
| **governance/** | 4 | 高 | 高 |
|
||||
| **guides/** | 3 | 中 | 低 |
|
||||
| **quality/** | 3 | 低 | 低 |
|
||||
|
||||
### 1.2 优化工作类型
|
||||
|
||||
| 工作类型 | 描述 | 预估工作量 |
|
||||
|---------|-----|----------|
|
||||
| **内容校准** | 修正过时信息、补充缺失内容 | 40% |
|
||||
| **格式规范** | 统一文档格式、命名规范 | 20% |
|
||||
| **关联更新** | 同步关联文档、交叉引用 | 15% |
|
||||
| **质量提升** | 补充示例、完善细节 | 15% |
|
||||
| **架构演进** | 适配新功能、新需求 | 10% |
|
||||
|
||||
---
|
||||
|
||||
## 2. AI Agent 分工矩阵
|
||||
|
||||
> 基于项目现有的 **三 AI 协作模式**,将文档维护任务按职责域进行分配。
|
||||
|
||||
### 2.1 分工概览
|
||||
|
||||
| Agent | 职责域 | 文档范围 | 核心能力 |
|
||||
|-------|-------|---------|---------|
|
||||
| **AI-1 (Kernel)** | 基础设施与内核文档 | blueprints/, design/ | 架构设计、技术规范 |
|
||||
| **AI-2 (Internal)** | 内部支撑与集成文档 | governance/, benchmarks/ | 分析能力、关联梳理 |
|
||||
| **AI-3 (Biz)** | 业务与前端集成文档 | frontend-integration/, guides/, quality/ | 业务理解、用户体验 |
|
||||
|
||||
### 2.2 详细分工
|
||||
|
||||
#### 🔧 AI-1 (Kernel) - 基础设施与架构文档
|
||||
|
||||
| 任务分类 | 具体文档 | 工作内容 |
|
||||
|---------|---------|---------|
|
||||
| **架构蓝图** | arch-overview-v30.md, arch-freeze-v30.md, v30-arch-optimization-plan.md | 校准技术架构描述、同步最新变更 |
|
||||
| **前端架构** | frontend-architecture.md | 更新技术栈、补充新特性 |
|
||||
| **全局蓝图** | global-business-blueprint.md | 业务架构演进同步 |
|
||||
| **设计文档** | server-initiation.md, extension-initiation.md, console-pipeline-log-design.md | 技术规范更新 |
|
||||
| **新增文档** | industry-benchmarks-comprehensive.md | 行业标杆综合文档落地 |
|
||||
|
||||
**交接给 AI-2**:
|
||||
- 架构变更需同步至 governance/collaboration-board.md
|
||||
- 前端架构变更需通知 AI-3 更新 frontend-integration/
|
||||
|
||||
#### 🔍 AI-2 (Internal) - 协作与分析文档
|
||||
|
||||
| 任务分类 | 具体文档 | 工作内容 |
|
||||
|---------|---------|---------|
|
||||
| **协作看板** | collaboration-board.md, console-collaboration-board.md | 更新任务状态、批次信息 |
|
||||
| **任务规格** | task-specifications.md | 补充任务描述、完善验收标准 |
|
||||
| **历史归档** | archive/collaboration-history-v31.md | 归档变更记录 |
|
||||
| **标杆分析** | benchmarks/industry-benchmarks-comprehensive.md | 15+标杆产品综合拆解 |
|
||||
|
||||
**交接给 AI-1**:
|
||||
- 新任务 ID 需在 task-specifications.md 定义
|
||||
- 架构变更需通知 AI-1 更新 blueprints/
|
||||
|
||||
**交接给 AI-3**:
|
||||
- 业务需求变更需通知 AI-3 更新 frontend-integration/
|
||||
- 标杆功能新增需同步至前端集成方案
|
||||
|
||||
#### 🏢 AI-3 (Biz) - 业务与前端集成文档
|
||||
|
||||
| 任务分类 | 具体文档 | 工作内容 |
|
||||
|---------|---------|---------|
|
||||
| **前端集成** | frontend-integration/*.md (48个) | 完善 UI 描述、补充 API 映射 |
|
||||
| **实施指南** | server-readme.md, toc-early-stage-spec.md, non-saas-multi-tenant-checklist.md | 更新实施步骤、补充注意事项 |
|
||||
| **质量标准** | frontend-delivery-standard.md, golive-redline-checklist.md, ux-field-acceptance-checklist.md | 完善交付标准、补充验收清单 |
|
||||
| **开发计划** | frontend-dev-plan.md | 更新前端路线图 |
|
||||
|
||||
**交接给 AI-1**:
|
||||
- 前端架构变更需通知 AI-1 更新 frontend-architecture.md
|
||||
|
||||
---
|
||||
|
||||
## 3. 协作流程
|
||||
|
||||
### 3.1 任务分发机制
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ 任务池 (Task Pool) │
|
||||
│ - 文档优化需求 │
|
||||
│ - 变更同步请求 │
|
||||
│ - 质量审计反馈 │
|
||||
└───────────────────────┬─────────────────────────────────┘
|
||||
│
|
||||
┌───────────────┼───────────────┐
|
||||
▼ ▼ ▼
|
||||
[AI-1 Kernel] [AI-2 Internal] [AI-3 Biz]
|
||||
│ │ │
|
||||
└───────────────┼───────────────┘
|
||||
│
|
||||
▼
|
||||
[验收 & 归档]
|
||||
```
|
||||
|
||||
### 3.2 跨 Agent 协作规则
|
||||
|
||||
| 场景 | 发起方 | 接收方 | 协作方式 |
|
||||
|-----|-------|-------|---------|
|
||||
| 架构变更 | AI-1 | AI-2/AI-3 | 变更通知 + 文档同步 |
|
||||
| 任务新增 | AI-2 | AI-1 | 规格定义 + 架构确认 |
|
||||
| 业务需求 | AI-3 | AI-2 | 需求描述 + 规格确认 |
|
||||
| 依赖阻塞 | 任意 | 上游 | 阻塞上报 + 等待确认 |
|
||||
|
||||
### 3.3 变更同步协议
|
||||
|
||||
```
|
||||
[变更类型] → [文档路径] → [影响范围] → [协作要求]
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```
|
||||
[架构变更] → [arch-overview-v30.md] → [AI-2:更新协作看板] → [24小时内同步]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 验收标准
|
||||
|
||||
### 4.1 单文档验收
|
||||
|
||||
| 检查项 | 标准 | 权重 |
|
||||
|-------|-----|-----|
|
||||
| **内容准确性** | 无过时信息、与代码实现一致 | 40% |
|
||||
| **格式规范性** | 符合命名规范、目录结构规范 | 20% |
|
||||
| **关联完整性** | 交叉引用有效、版本同步 | 20% |
|
||||
| **可读性** | 逻辑清晰、示例充足 | 20% |
|
||||
|
||||
### 4.2 协作验收
|
||||
|
||||
| 检查项 | 标准 |
|
||||
|-------|-----|
|
||||
| **交接完整性** | 跨 Agent 文档均已同步 |
|
||||
| **状态可追溯** | 变更记录完整、可回溯 |
|
||||
| **无静默失败** | 阻塞问题已上报 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 执行计划
|
||||
|
||||
### 5.1 第一轮:基础规范(1-2 周)
|
||||
|
||||
| Agent | 任务 | 交付物 |
|
||||
|-------|-----|-------|
|
||||
| AI-1 | 统一 blueprints/ 格式规范 | 格式检查清单 |
|
||||
| AI-2 | 审计 governance/ 文档完整性 | 缺失清单 |
|
||||
| AI-3 | 完善 frontend-integration/ 模板 | 补充示例 |
|
||||
|
||||
### 5.2 第二轮:内容优化(2-3 周)
|
||||
|
||||
| Agent | 任务 | 交付物 |
|
||||
|-------|-----|-------|
|
||||
| AI-1 | 校准架构文档与技术实现一致 | 更新的架构蓝图 |
|
||||
| AI-2 | 同步任务规格与看板状态 | 最新协作看板 |
|
||||
| AI-3 | 补充前端集成方案的 API 映射 | 完整的前端集成文档 |
|
||||
|
||||
### 5.3 第三轮:质量提升(1-2 周)
|
||||
|
||||
| Agent | 任务 | 交付物 |
|
||||
|-------|-----|-------|
|
||||
| AI-1 | 补充架构决策记录 (ADR) | 决策日志 |
|
||||
| AI-2 | 完善标杆分析报告 | 行业对比报告 |
|
||||
| AI-3 | 补充 UX 验收标准 | 完善的质量清单 |
|
||||
|
||||
---
|
||||
|
||||
## 6. 当前任务分配
|
||||
|
||||
### 6.1 优先级 P0(立即执行)
|
||||
|
||||
| 文档 | 当前状态 | 负责 Agent | 截止时间 |
|
||||
|-----|---------|------------|---------|
|
||||
| industry-benchmarks-comprehensive.md | ✅ 已完成 | AI-2 | 已完成 |
|
||||
| collaboration-board.md | ✅ 已同步 | AI-2 | 已完成 |
|
||||
| frontend-architecture.md | ✅ 已更新 | AI-1 | 已完成 |
|
||||
|
||||
### 6.2 优先级 P1(本周内)
|
||||
|
||||
| 文档 | 当前状态 | 负责 Agent |
|
||||
|-----|---------|------------|
|
||||
| arch-overview-v30.md | 待校准 | AI-1 |
|
||||
| task-specifications.md | 待同步 | AI-2 |
|
||||
| frontend-architecture.md | 待更新 | AI-3 |
|
||||
|
||||
---
|
||||
|
||||
## 7. 沟通机制
|
||||
|
||||
### 7.1 例行同步
|
||||
|
||||
| 周期 | 内容 | 参与方 |
|
||||
|-----|-----|-------|
|
||||
| **每日站会** | 进度同步、阻塞上报 | 全员 |
|
||||
| **周度复盘** | 质量评估、流程优化 | 全员 |
|
||||
| **版本发布** | 文档版本同步 | 全员 |
|
||||
|
||||
### 7.2 紧急响应
|
||||
|
||||
- **阻塞升级**:超过 4 小时未解决的跨域问题,升级至负责人
|
||||
- **变更广播**:重大变更需在 1 小时内通知所有相关方
|
||||
|
||||
---
|
||||
|
||||
## 8. 附录
|
||||
|
||||
### 8.1 文档命名规范
|
||||
|
||||
- 使用 **小写短横线** (kebab-case)
|
||||
- 示例:`frontend-architecture.md`, `arch-overview-v30.md`
|
||||
|
||||
### 8.2 目录结构规范
|
||||
|
||||
```
|
||||
docs/
|
||||
├── benchmarks/ # 行业标杆分析
|
||||
├── blueprints/ # 架构蓝图
|
||||
│ └── frontend-integration/ # 前端集成方案
|
||||
├── design/ # 技术设计
|
||||
├── governance/ # 协作与任务
|
||||
├── guides/ # 实施指南
|
||||
└── quality/ # 质量标准
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**维护者**:AI-1 (Kernel)
|
||||
**版本**:V2.0
|
||||
**状态**:已更新
|
||||
**更新内容** (2026-03-15):
|
||||
- benchmarks/ 目录已整合为 1 个综合文档
|
||||
- frontend-integration/ 更新为 60+ 个文档
|
||||
- P0 任务已完成状态同步
|
||||
854
docs/governance/task-specifications.md
Normal file
854
docs/governance/task-specifications.md
Normal file
@@ -0,0 +1,854 @@
|
||||
# 📋 任务规格说明书 (Master Task Registry) - V32.0
|
||||
|
||||
> **多 AI 协同原子指令源**。严禁物理删除历史规格,失效规格请使用 ~~删除线~~ 标注并记录版本。
|
||||
|
||||
### **[ERP_WMS_01] 拣货路径优化与波次分单算法 (Pick Wave)**
|
||||
- **技术收益**:基于 AGI 销量预测自动聚合高频 SKU 订单,优化拣货路径,提升仓库作业效率 40%。
|
||||
- **核心目标**:实现 `WMSWaveService`,支持波次自动生成、路径 TSP 优化与物理表持久化。
|
||||
- **参考路径**:[WMSWaveService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/WMSWaveService.ts)
|
||||
|
||||
### **[ERP_LOG_01] 物流轨迹全链路归一化监控 (Logistics Tracker)**
|
||||
- **技术收益**:实时识别全球物流轨迹异常(停滞、错投、延误),联动自愈路由降低丢包风险。
|
||||
- **核心目标**:实现 `LogisticsTrackerService`,支持轨迹异常检测模式匹配与 `reportAnomaly` 联动。
|
||||
- **参考路径**:[LogisticsTrackerService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/LogisticsTrackerService.ts)
|
||||
|
||||
### **[CORE_TELE_ALRT] 统一告警归集与自愈路由 (Alert Hub)**
|
||||
- **运维收益**:打破信息孤岛,将风控、系统、业务异常统一归集,为 AGI 自愈提供结构化决策输入。
|
||||
- **核心目标**:实现 `AlertService`,支持告警分级(CRITICAL/ERROR/WARN)、租户聚合与状态管理。
|
||||
- **参考路径**:[AlertService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/telemetry/AlertService.ts)
|
||||
|
||||
### **[ERP_REP_01] 全业务多维报表宽表构建 (Report Mart Aggregator)**
|
||||
- **技术收益**:通过增量预聚合(Incremental Aggregation)解决大数据量下的报表查询性能瓶颈。
|
||||
- **核心目标**:在 `ReportService` 中实现预聚合逻辑,将明细表增量同步至 `cf_report_summary` 宽表。
|
||||
- **参考路径**:[ReportService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Analytics/ReportService.ts)
|
||||
|
||||
### **[CORE_TELE_PREDICTIVE_HEALTH] 预测性系统健康度看板 (Predictive Health)**
|
||||
- **技术收益**:通过时间序列分析预判系统崩溃与性能瓶颈,实现 AGI 级别的自愈能力。
|
||||
- **核心目标**:实现 `PredictiveHealthService`,基于 Telemetry 数据展示未来 24 小时的健康度预测。
|
||||
- **参考路径**:[PredictiveHealthService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/telemetry/PredictiveHealthService.ts)
|
||||
|
||||
### **[CORE_AI_60] Agent 集群自治协作协议 (Agent Swarm)**
|
||||
- **战略收益**:打破单 Agent 性能瓶颈,实现多 AGI 实例的复杂任务流水线。
|
||||
- **核心目标**:实现 `AgentSwarmService`,支持任务在不同特性的 Agent 间自动流转。
|
||||
- **参考路径**:[AgentSwarmService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/AgentSwarmService.ts)
|
||||
|
||||
### **[BIZ_INV_30] 滞销库存深度治理与清仓建议 (Aging Inventory)**
|
||||
- **利润收益**:降低仓储成本,通过 AGI 自动生成针对滞销 SKU 的阶梯折扣建议。
|
||||
- **核心目标**:实现 `AgingInventoryService`,联动 `InventoryAgingService` 进行库龄分析。
|
||||
- **参考路径**:[AgingInventoryService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/AgingInventoryService.ts)
|
||||
|
||||
### **[BIZ_MKT_50] AGI 驱动的跨平台套利自动化 (Arbitrage AGI)**
|
||||
- **战略收益**:秒级识别全球多平台(Amazon, Temu, 1688)价格洼地,全自动执行套利下单。
|
||||
- **核心目标**:实现 `ArbitrageAGIService`,联动 `ArbitrageService` 锁定套利空间。
|
||||
- **参考路径**:[ArbitrageAGIService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/ArbitrageAGIService.ts)
|
||||
|
||||
### **[BIZ_INV_50] 分布式库存分布优化 (Inventory Distribution)**
|
||||
- **业务收益**:基于销量热力图动态调整全球各仓库存分布,减少跨区调拨成本 30%。
|
||||
- **核心目标**:实现 `InventoryDistributionService`,生成 `TRANSFER` 建议。
|
||||
- **参考路径**:[InventoryDistributionService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/InventoryDistributionService.ts)
|
||||
|
||||
### **[BIZ_FIN_210] 跨主权流动性对冲与避险 (Liquidity Hedge)**
|
||||
- **金融收益**:自动对冲跨境贸易中的流动性风险,确保结算网关资金充沛。
|
||||
- **核心目标**:实现 `LiquidityHedgingService`,监控各 Hub 节点头寸。
|
||||
- **参考路径**:[LiquidityHedgingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/LiquidityHedgingService.ts)
|
||||
|
||||
### **[BIZ_FIN_220] 供应链微贷与信用评估 (Micro Credit)**
|
||||
- **金融收益**:基于贸易真实性证据链为租户提供 AGI 授信建议,解决小微外贸融资难。
|
||||
- **核心目标**:实现 `MicroCreditService`,联动 `cf_order` 真实交易记录。
|
||||
- **参考路径**:[MicroCreditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/MicroCreditService.ts)
|
||||
|
||||
### **[BIZ_SOV_13] 声誉驱动的阶梯费率与流量倾斜 (Reputation Perks)**
|
||||
- **业务收益**:激励租户维护高信用评分,自动为高信用节点提供更低的结算手续费与优先的资源分配。
|
||||
- **核心目标**:联动 `BillingService` 与 `TrafficService`,根据声誉分值自动匹配计费 FSM。
|
||||
- **参考路径**:[BillingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Billing/BillingService.ts)
|
||||
|
||||
### **[BIZ_SOV_14] 跨节点资源共享配额管理 (Resource Quota)**
|
||||
- **网络收益**:防止恶意节点占用全网算力/存储资源,基于声誉实现动态的资源预留与配额管理。
|
||||
- **核心目标**:实现 `NodeResourceQuotaService`,联动 `InfinityComputeService` 进行配额限制。
|
||||
- **参考路径**:[NodeResourceQuotaService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/NodeResourceQuotaService.ts)
|
||||
|
||||
### **[CORE_TELE_TOPO] 全球节点实时拓扑遥测 (Network Topology)**
|
||||
- **遥测收益**:提供全球贸易网络的实时连接快照,自动识别高延迟链路并触发路由重排。
|
||||
- **核心目标**:实现 `NetworkTopologyService`,采集 P2P 通信中的 latency, jitter 与 hop_count。
|
||||
- **参考路径**:[NetworkTopologyService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/telemetry/NetworkTopologyService.ts)
|
||||
|
||||
### **[FE_CMD_01] AGI 指令终端 (Omni-Box Command)**
|
||||
- **交互收益**:让运营人员通过自然语言直接操控系统,降低操作复杂度 80%。
|
||||
- **核心目标**:实现一个全局浮动的搜索指令框,支持语义解析并映射至后端 API 指令。
|
||||
- **参考路径**:`dashboard/src/components/OmniBox/`
|
||||
|
||||
### **[FE_TOC_01] TOC 消费者运营工作台 (Consumer Ops)**
|
||||
- **业务收益**:打通零售端的售后与评价管理,提升客户满意度。
|
||||
- **核心目标**:展示消费者订单全链路状态,集成 RAG 驱动的智能纠纷处理界面。
|
||||
- **参考路径**:`dashboard/src/pages/business/toc/`
|
||||
|
||||
### **[FE_SITE_01] 独立站管理矩阵 (Site Matrix)**
|
||||
- **业务收益**:一站式管理 Shopify/WooCommerce 资产,监控全球流量波动。
|
||||
- **核心目标**:实现多站点健康度遥测、SEO 关键词热力图与跨站商品同步 UI。
|
||||
- **参考路径**:`dashboard/src/pages/business/sites/`
|
||||
|
||||
### **[FE_TOB_01] TOB 批发与寻源询价 (Wholesale & RFQ)**
|
||||
- **业务收益**:标准化 B2B 贸易流程,管理大宗订单与长期协议。
|
||||
- **核心目标**:实现 RFQ (询价单) 处理流水线,支持阶梯报价矩阵的图形化编辑。
|
||||
- **参考路径**:`dashboard/src/pages/business/tob/`
|
||||
|
||||
### **[FE_ERP_SKU] 全球 SKU 主数据管理中心 (SKU Master)**
|
||||
- **业务收益**:建立跨平台统一的商品身份,解决一物多码导致的库存混乱。
|
||||
- **核心目标**:实现多维属性(颜色/尺寸/规格)编辑器,支持 1688/Amazon/Temu SKU 映射矩阵。
|
||||
- **参考路径**:`dashboard/src/pages/erp/sku/`
|
||||
|
||||
### **[FE_ERP_SOURCING] 采购与寻源生命周期 (Procurement)**
|
||||
- **业务收益**:标准化采购流程,降低采购溢价与虚假发货风险。
|
||||
- **核心目标**:实现从 AGI 建议转采购单 (PO) 的全自动流程,支持质检 (QC) 结果录入与入库单同步。
|
||||
- **参考路径**:`dashboard/src/pages/erp/sourcing/`
|
||||
|
||||
### **[FE_ERP_WMS] AGI 驱动的智能仓储 (WMS Ops)**
|
||||
- **业务收益**:提升仓库作业效率,减少拣货路径冗余。
|
||||
- **核心目标**:提供库位管理的可视化视图,支持基于销量预测的库内移库建议。
|
||||
- **参考路径**:`dashboard/src/pages/erp/wms/`
|
||||
|
||||
### **[FE_ERP_LOG] 跨境物流与面单中心 (Logistics Hub)**
|
||||
- **业务收益**:自动化物流对账与轨迹监控,降低丢包率。
|
||||
- **核心目标**:实现多渠道运费实时比价、面单批量生成与包裹轨迹全链路监测。
|
||||
- **参考路径**:`dashboard/src/pages/erp/logistics/`
|
||||
|
||||
### **[ERP_OMS_01] 订单全生命周期状态机加固 (OMS FSM)**
|
||||
- **业务收益**:支持跨平台订单的统一调度与批量化处理,提升人效。
|
||||
- **核心目标**:升级 `OrderService`,支持 `PENDING_AUDIT` (待审), `WAITING_SHIPMENT` (待发), `EXCEPTION` (异常) 等细分状态与批量转换。
|
||||
- **参考路径**:`server/src/domains/Trade/OrderService.ts`
|
||||
|
||||
### **[FE_OMS_01] 统一订单工作台 (OMS Workbench)**
|
||||
- **交互收益**:提供类似“易仓”的订单列表处理体验,支持多维过滤与批量操作。
|
||||
- **核心目标**:实现订单列表页,集成批量审核、一键发货、异常标记、导出。
|
||||
- **参考路径**:`dashboard/src/pages/erp/oms/`
|
||||
|
||||
### **[ERP_FIN_01] 财务对账与收支差异分析引擎 (Reconciliation)**
|
||||
- **金融收益**:自动识别平台结算与实际订单的差异(运费、税费、退款),防止资金流失。
|
||||
- **核心目标**:实现 `FinanceReconService`,支持 CSV/API 账单导入、自动对齐、差异生成。
|
||||
- **参考路径**:`server/src/domains/Finance/FinanceReconService.ts`
|
||||
|
||||
### **[FE_FIN_01] 财务对账与收支日历 (Finance Calendar)**
|
||||
- **交互收益**:通过时间轴直观展示收支节奏,并支持差异项一键下钻至订单明细。
|
||||
- **核心目标**:实现财务总览看板,包含收支日历、差异对账列表、现金流预测图。
|
||||
- **参考路径**:`dashboard/src/pages/erp/finance/`
|
||||
|
||||
### **[ERP_TASK_01] 统一任务中枢与分发引擎 (Task Hub)**
|
||||
- **业务收益**:将 Advice, Alert, Approval, PO, RMA 等多源事件归一化,消除信息碎片化。
|
||||
- **核心目标**:实现 `UnifiedTaskService`,支持任务的「认领/转派/完成」状态流转与 TTL 自动失效。
|
||||
- **参考路径**:`server/src/domains/Governance/TaskService.ts`
|
||||
|
||||
### **[FE_INBOX_01] 统一任务收件箱 (Global Inbox UI)**
|
||||
- **交互收益**:提供一站式待办视图,支持按来源模块、优先级、截止时间过滤。
|
||||
- **核心目标**:实现 `Inbox` 列表页,集成「一键认领」与「详情穿透」功能。
|
||||
- **参考路径**:`dashboard/src/pages/governance/inbox/`
|
||||
|
||||
### **[ERP_APPROVE_01] 通用审批流引擎 (Approval Engine)**
|
||||
- **安全收益**:对敏感动作(大额调价、资金划转)实施多级人工门禁,满足合规审计。
|
||||
- **核心目标**:实现 `ApprovalFlowService`,支持按金额阈值、多租户/多角色规则的动态编排。
|
||||
- **参考路径**:`server/src/domains/Governance/ApprovalService.ts`
|
||||
|
||||
### **[FE_APPROVE_01] 通用审批中心 (Approval Center UI)**
|
||||
- **交互收益**:统一敏感动作的确认界面,展示变更前后对比、AGI 建议与影响评估。
|
||||
- **核心目标**:实现审批详情对话框,集成「同意/拒绝/修改后通过」动作。
|
||||
- **参考路径**:`dashboard/src/components/Approval/`
|
||||
|
||||
### **[FE_REP_BI] 自助分析与 AGI 报表生成 (BI Center)**
|
||||
- **决策收益**:通过自然语言提问生成多维分析视图,降低数据获取门槛。
|
||||
- **核心目标**:实现「维度-指标」拖拽分析界面,支持 AGI 语义解析生成 G2 图表。
|
||||
- **参考路径**:`dashboard/src/pages/analytics/bi/`
|
||||
|
||||
### **[ERP_CRM_01] 客户 360 视图与商机中枢 (CRM Hub)**
|
||||
- **业务收益**:打通 TOC/TOB 客户的全生命周期数据,沉淀信用资产。
|
||||
- **核心目标**:实现 `Customer360Service`,聚合订单历史、客诉记录、财务往来与信用分。
|
||||
- **参考路径**:`server/src/domains/Customer/CRMService.ts`
|
||||
|
||||
### **[FE_CRM_01] 客户 360 档案与商机看板 (CRM UI)**
|
||||
- **交互收益**:一键直达客户画像,可视化 B2B 商机漏斗(线索 -> 报价 -> 回款)。
|
||||
- **核心目标**:实现客户详情页与商机漏斗图组件。
|
||||
- **参考路径**:`dashboard/src/pages/business/crm/`
|
||||
|
||||
### **[CORE_GOV_EXP] AB 实验与策略分桶平台 (Experiment Hub)**
|
||||
- **战略收益**:科学评估 AGI 策略效果,支持灰度发布,降低全局误操作风险。
|
||||
- **核心目标**:实现 `ExperimentService`,支持按用户/店铺/节点的实验分桶与 KPI 对比分析。
|
||||
- **参考路径**:`server/src/core/governance/ExperimentService.ts`
|
||||
|
||||
### **[FE_ALRT_01] 统一告警与可观测性中心 (Alert Center UI)**
|
||||
- **运维收益**:秒级感知节点异常与业务跌价风险,支持订阅与静音管理。
|
||||
- **核心目标**:实现全局告警列表,展示触发条件、影响对象与 AGI 自愈尝试记录。
|
||||
- **参考路径**:`dashboard/src/pages/governance/alerts/`
|
||||
|
||||
---
|
||||
|
||||
## 🛡️ 0. 全局生产级交付校验 (Production Readiness Gates)
|
||||
|
||||
**所有任务在标记为 `completed` 前,必须通过以下红线审计:**
|
||||
|
||||
1. **Zero-Mock 校验**:实现代码中严禁包含任何模拟数据返回。所有业务输出必须来自 `cf_` 数据库表或第三方生产 API。
|
||||
2. **Schema 闭环校验**:如果涉及新字段或新表,必须在 `LegacyTableInitializer.ts` 中完成 `initTable` 实现并执行成功。
|
||||
3. **因果链校验**:通过 `DecisionExplainabilityEngine.logDecision` 记录真实的决策逻辑。
|
||||
4. **影子测试校验**:AI-2 必须产出对应的冒烟测试用例,验证逻辑非“空壳”。
|
||||
5. **全栈联调校验 (Full-Stack Sync)**:
|
||||
- 确保后端 `SUGGESTED` 状态的建议能真实流转至前端 `ReviewWorkbench`。
|
||||
- 严禁只有后端逻辑而无前端呈现方案。
|
||||
- 前端操作(Approve/Reject)必须真实触发后端业务变更。
|
||||
|
||||
---
|
||||
|
||||
### **[BIZ_TRADE_70] 全球保税仓调拨与跨境合规 (Bonded Warehouse)**
|
||||
- **交付收益**:优化跨境物流税费,实现“先入仓后报关”的灵活库存调度。
|
||||
- **核心目标**:实现 `BondedWarehouseService`,支持保税仓入库单与出库单自动映射。
|
||||
- **参考路径**:[BondedWarehouseService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/BondedWarehouseService.ts)
|
||||
|
||||
### **[BIZ_INV_40] AGI 自治仓储调度与库内优化 (Autonomous Warehousing)**
|
||||
- **效率收益**:利用 AGI 预测库内操作热度,动态优化拣货路径与补货时机。
|
||||
- **核心目标**:实现 `AutonomousWarehousingService`,联动 WMS 接口进行指令编排。
|
||||
- **参考路径**:[AutonomousWarehousingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/AutonomousWarehousingService.ts)
|
||||
|
||||
---
|
||||
|
||||
### **[SOV_NET_06] 基于 Libp2p/WebRTC 的节点直连通信 (P2P Connectivity)**
|
||||
- **战略收益**:打破中心化网关依赖,实现 Hub 节点间的亚秒级直连通信,提升资源交换效率 300%。
|
||||
- **核心目标**:实现 `P2PConnectionService`,利用 `libp2p` 或 `WebRTC` 构建加密的双向流通道。
|
||||
- **参考路径**:[P2PConnectionService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/P2PConnectionService.ts)
|
||||
|
||||
### **[SOV_NET_07] 基于 ZKP 的隐私声誉分值证明 (ZKP Reputation)**
|
||||
- **隐私收益**:允许节点在不公开具体交易细节与分值前提下,向合作伙伴证明其信用等级满足 P2P 准入门槛。
|
||||
- **核心目标**:实现 `ReputationZKPService`,利用 `circom` 生成声誉范围证明(Range Proof)。
|
||||
- **参考路径**:[ReputationZKPService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/ReputationZKPService.ts)
|
||||
|
||||
### **[SOV_NET_08] 节点声誉衰减与惩罚机制 (Reputation Decay)**
|
||||
- **治理收益**:建立动态信任模型,确保声誉真实反映节点当前的合规性与活跃度。
|
||||
- **核心目标**:升级 `SovereignReputationV2Service`,实现基于半衰期算法的自动衰减逻辑。
|
||||
- **参考路径**:[SovereignReputationV2Service.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/SovereignReputationV2Service.ts)
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ 1. 深度智能与内核进化 (Domain: CORE_AI / CORE_DEV)
|
||||
|
||||
### **[CORE_AI_40] AGI 策略自进化闭环验证 (Evolution Loop)**
|
||||
- **战略收益**:建立 AI 决策的自我修正机制,减少人工干预成本 70%。
|
||||
- **核心目标**:
|
||||
1. **闭环反馈**:将 `ConsumerOrderService` 的真实成交数据回流至 `AGIStrategyEvolutionService`。
|
||||
2. **自动微调**:AGI 代理基于利润反馈自动调整选品与调价 Prompt。
|
||||
- **参考路径**:[AGIStrategyEvolutionService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/AGIStrategyEvolutionService.ts)
|
||||
|
||||
### **[CORE_AI_22] 多模态 SKU 情感分析与评论生成 (Sentiment AI)**
|
||||
- **业务收益**:提升详情页转化率 30%,自动生成地道营销文案。
|
||||
- **核心目标**:融合商品图片(视觉)与历史抓取的评价文本,分析痛点并生成高说服力评论。
|
||||
- **参考路径**:[SentimentAnalysisService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/SentimentAnalysisService.ts)
|
||||
|
||||
### **[CORE_DEV_30] 无限水平扩展的 AGI 推理节点调度 (Infinity Compute)**
|
||||
- **技术收益**:支撑千万级并发 AGI 任务,亚秒级算力动态编排。
|
||||
- **核心目标**:实现租户级配额隔离与算力池动态扩缩容。
|
||||
- **参考路径**:[InfinityComputeService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/InfinityComputeService.ts)
|
||||
|
||||
---
|
||||
|
||||
## 🔒 2. 主权安全与隐私计算 (Domain: CORE_SEC)
|
||||
|
||||
### **[CORE_SEC_20] 基于零知识证明 (ZKP) 的全流程隐私审计 (Private Audit)**
|
||||
- **合规收益**:在不解密原始数据前提下完成全量合规审计,保护商户主权。
|
||||
- **核心目标**:利用 `circom` 或类似技术实现利润与成本的隐私汇总计算。
|
||||
- **参考路径**:[PrivateAuditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/PrivateAuditService.ts)
|
||||
|
||||
### **[CORE_SEC_35] 全同态加密 (FHE) 利润敏感度审计 (FHE Audit)**
|
||||
- **安全收益**:密文态运算,确保单租户特定策略绝不泄露。
|
||||
- **核心目标**:实现对加密状态下的财务字段执行加法与平均值运算。
|
||||
- **参考路径**:[HomomorphicService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/security/HomomorphicService.ts)
|
||||
|
||||
---
|
||||
|
||||
## 📈 3. 贸易自治与业务扩展 (Domain: BIZ_TRADE / BIZ_FIN)
|
||||
|
||||
### **[BIZ_FIN_161] 订单级 P&L 实时穿透分析建议 (P&L Analysis)**
|
||||
- **透明收益**:还原每笔订单的真实净利,剔除摊销、汇损等隐形成本。
|
||||
- **核心目标**:实现 `OrderProfitService`,通过穿透式计算,为租户提供最真实的毛利视角。
|
||||
- **参考路径**:[OrderProfitService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/OrderProfitService.ts)
|
||||
|
||||
### **[BIZ_FIN_162] 多币种自动锁汇避险建议 (FX Hedge)**
|
||||
- **避险收益**:在汇率剧烈波动时,自动建议锁定结汇汇率,保护外贸利润。
|
||||
- **核心目标**:监控汇率波动率,识别 CRITICAL 风险并生成锁汇指令建议。
|
||||
- **参考路径**:[CurrencyRiskService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CurrencyRiskService.ts)
|
||||
|
||||
### **[BIZ_FIN_164] 调价策略导致的毛利漂移分析 (Margin Drift)**
|
||||
- **质量收益**:评估动态调价的效果,识别毛利侵蚀(Erosion)风险。
|
||||
- **核心目标**:分析 SKU 毛利趋势,对比调价前后的收益变化。
|
||||
- **参考路径**:[PricingAuditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PricingAuditService.ts)
|
||||
|
||||
### **[BIZ_FIN_165] 广告 ROAS 真实性本地归因建议 (Ad Attribution)**
|
||||
- **归因收益**:识破平台广告虚假繁荣,计算剔除自然单后的真实 ROAS。
|
||||
- **核心目标**:对比总订单流与广告点击流,计算 `trueROAS` 与 `organicRevenue`。
|
||||
- **参考路径**:[TrueROASService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TrueROASService.ts)
|
||||
|
||||
### **[BIZ_FIN_166] 各国 VAT 税务起征点自动提醒 (VAT Watch)**
|
||||
- **合规收益**:防止因销售额超标导致的补税与罚款风险。
|
||||
- **核心目标**:监控各目的国年度销售额,在接近起征点(70%/90%)时触发预警。
|
||||
- **参考路径**:[TaxComplianceService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TaxComplianceService.ts)
|
||||
|
||||
### **[BIZ_FIN_167] 采购预付款比例信用分级调整 (Vendor Credit)**
|
||||
- **流动性收益**:根据供应商绩效动态优化预付款,释放沉淀资金。
|
||||
- **核心目标**:实现 `VendorCreditService`,对高信用供应商建议降低预付款。
|
||||
- **参考路径**:[VendorCreditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/VendorCreditService.ts)
|
||||
|
||||
### **[BIZ_FIN_168] 未来 30 天现金流枯竭预警 (Cashflow Burn)**
|
||||
- **生存收益**:联动采购、物流、销售全链路,预判资金链断裂风险。
|
||||
- **核心目标**:计算未来 30 天的待收与待付,生成 `projectedCash` 风险评估。
|
||||
- **参考路径**:[CashflowPredictor.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CashflowPredictor.ts)
|
||||
|
||||
### **[BIZ_FIN_169] 租户资源超限自动计费单生成 (Billing Engine)**
|
||||
- **营收收益**:自动化处理按需付费(Pay-as-you-go)场景,降低漏收风险。
|
||||
- **核心目标**:实现 `BillingEngine`,对超限的 AI 调用或存储空间自动生成计费单。
|
||||
- **参考路径**:[BillingEngine.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/BillingEngine.ts)
|
||||
|
||||
### **[BIZ_FIN_170-200] 业务财务自动化服务矩阵 (Finance Domain Expansion)**
|
||||
- **核心收益**:实现了从 SKU 效率、回款风险、库存跌价到税务合规、预算管理、审计监控的 31 项财务自治服务。
|
||||
- **核心目标**:
|
||||
- **Killer**: `SKUEfficiencyService` 识别亏损 SKU。
|
||||
- **Leverage**: `PayoutCycleService` 评估资金杠杆。
|
||||
- **Write-down**: `InventoryValueService` 计提跌价准备。
|
||||
- **Freeze**: `RefundRiskService` 预警退款风险。
|
||||
- **Terms**: `PaymentTermsService` 优化账期。
|
||||
- **Remit**: `RemitPathService` 优化汇款路径。
|
||||
- **Valuation**: `StockAuditService` 审计全球库存价值。
|
||||
- **Ad Budget**: `AdOptimizerService` 分配营销预算。
|
||||
- **Tenant Profit**: `TenantHealthService` 监控 P&L 波动。
|
||||
- **Rebate**: `RebateService` 追踪采购回扣。
|
||||
- **Loss Audit**: `FinancialAuditService` 审计操作损耗。
|
||||
- **Amortization**: `ExpenseService` 科学摊销成本。
|
||||
- **Commodity**: `MaterialRiskService` 预判原材料涨价。
|
||||
- **Refund Audit**: `RefundAuditService` 审计退款一致性。
|
||||
- **CAC**: `CACThresholdService` 设定获客上限。
|
||||
- **Split**: `CommissionService` 自动结算分销利润。
|
||||
- **Turnover**: `TurnoverWatchdog` 识别资金沉淀。
|
||||
- **Provision**: `WarrantyService` 计提售后准备金。
|
||||
- **Filing**: `TaxFilingAdvisor` 预填税务申报。
|
||||
- **Low Margin**: `MarginProtector` 拦截亏损订单。
|
||||
- **Credit Limit**: `CreditMonitorService` 监控供应商信用。
|
||||
- **Transfer Pricing**: `LegalTaxService` 评估跨境合规。
|
||||
- **Payout Optimizer**: `PayoutOptimizer` 优化提现手续费。
|
||||
- **Budgeting**: `FinancialPlanner` 生成 AI 预算。
|
||||
- **Gateway Risk**: `PaymentRiskService` 监控支付网关。
|
||||
- **Shipping Optimizer**: `DynamicShippingService` 优化包邮门槛。
|
||||
- **Campaign Health**: `CampaignHealthService` 监控营销 ROI。
|
||||
- **Savings Audit**: `SavingTrackerService` 审计采购降本。
|
||||
- **Claim Fraud**: `ClaimFraudService` 拦截恶意索赔。
|
||||
- **Balance Sheet**: `GlobalBalanceSheet` 实时资产快照。
|
||||
- **AI Guard**: `ComplianceAIGuard` 最终合规自查。
|
||||
- **参考路径**:[Finance Domain](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/)
|
||||
|
||||
### **[BIZ_FIN_170] 周期性亏损 SKU 淘汰建议报告 (Killer)**
|
||||
- **业务收益**:精准识别“利润黑洞”SKU,优化库存周转率与现金流。
|
||||
- **核心目标**:实现 `SKUEfficiencyService`,基于过去 30 天真实 P&L 自动生成淘汰/保留建议。
|
||||
- **参考路径**:[SKUEfficiencyService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/SKUEfficiencyService.ts)
|
||||
|
||||
### **[BIZ_FIN_171] 多平台回款周期差异风险评估 (Leverage)**
|
||||
- **财务收益**:预警由于回款周期(Payout Cycle)过长导致的资金链杠杆风险。
|
||||
- **核心目标**:监控各平台(Amazon, Temu 等)的平均结算周期,评估风险级别。
|
||||
- **参考路径**:[PayoutCycleService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PayoutCycleService.ts)
|
||||
|
||||
### **[BIZ_FIN_172] 库存跌价准备自动计提建议 (Write-down)**
|
||||
- **合规收益**:符合会计准则,实时评估滞销库存的资产减值风险。
|
||||
- **核心目标**:基于库龄(Aging)自动计算跌价准备金,建议财务计提。
|
||||
- **参考路径**:[InventoryValueService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/InventoryValueService.ts)
|
||||
|
||||
### **[BIZ_FIN_173] 高额退款导致的资金链冻结预警 (Freeze)**
|
||||
- **风控收益**:提前识别由于争议率/退款率过高导致的支付网关(PayPal/Stripe)冻结风险。
|
||||
- **核心目标**:监控 `refundRatio`,触发 CRITICAL 级别预警与现金流储备建议。
|
||||
- **参考路径**:[RefundRiskService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/RefundRiskService.ts)
|
||||
|
||||
### **[BIZ_FIN_174] 供应商账期自动展期/缩短建议 (Terms)**
|
||||
- **资金收益**:基于供应商绩效动态优化付款条件,平衡供应链稳定性与现金流。
|
||||
- **核心目标**:评估供应商 SLA(交期、质量),给出 `EXTEND` 或 `SHORTEN` 建议。
|
||||
- **参考路径**:[PaymentTermsService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PaymentTermsService.ts)
|
||||
|
||||
### **[BIZ_FIN_175] 跨境汇款路径手续费选优建议 (Remit)**
|
||||
- **降本收益**:实时对比多条汇款路径(Wise, PingPong, Payoneer),降低跨境汇损。
|
||||
- **核心目标**:基于汇款金额与币种,自动推荐综合评分最高的结算路径。
|
||||
- **参考路径**:[RemitPathService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/RemitPathService.ts)
|
||||
|
||||
### **[BIZ_FIN_176] 虚拟仓/海外仓库存估值审计 (Valuation)**
|
||||
- **财务收益**:符合会计准则(FIFO/加权平均),实时掌握全球库存资产价值。
|
||||
- **核心目标**:实现 `StockAuditService`,支持跨仓库、多币种的库存估值。
|
||||
- **参考路径**:[StockAuditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/StockAuditService.ts)
|
||||
|
||||
### **[BIZ_FIN_177] 多渠道广告支出预算分配建议 (Ad Budget)**
|
||||
- **增长收益**:基于边缘毛利(Contribution Margin)自动优化广告预算,提升 ROAS。
|
||||
- **核心目标**:实现 `AdOptimizerService`,识别高 ROI SKU 并建议预算向其倾斜。
|
||||
- **参考路径**:[AdOptimizerService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/AdOptimizerService.ts)
|
||||
|
||||
### **[BIZ_FIN_178] 租户层级 P&L 波动根因分析 (Tenant Profit)**
|
||||
- **治理收益**:秒级感知经营异常,自动定位导致利润下滑的“黑天鹅”因素。
|
||||
- **核心目标**:监控每日 P&L 变化,触发异常波动(>20%)的自动化归因报告。
|
||||
- **参考路径**:[TenantHealthService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TenantHealthService.ts)
|
||||
|
||||
### **[BIZ_FIN_179] 供应商佣金回扣与折扣追踪 (Rebate)**
|
||||
- **采购收益**:自动识别符合阶梯折扣或回扣(Rebate)条件的采购量,挽回隐藏利润。
|
||||
- **核心目标**:追踪 `totalVolume`,提醒采购专员发起回扣索赔。
|
||||
- **参考路径**:[RebateService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/RebateService.ts)
|
||||
|
||||
### **[BIZ_FIN_180] 员工/Agent 操作财务损失审计 (Loss Audit)**
|
||||
- **审计收益**:透明化运营成本,识别由于误操作或恶意行为导致的财务损耗。
|
||||
- **核心目标**:审计退款、改价、取消订单等敏感行为,计算预估损失。
|
||||
- **参考路径**:[FinancialAuditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/FinancialAuditService.ts)
|
||||
|
||||
### **[BIZ_FIN_181] 多平台合规成本摊销建议 (Amortization)**
|
||||
- **会计收益**:将 ERP、工具费等固定/变动合规成本科学摊销至单笔订单。
|
||||
- **核心目标**:实现 `ExpenseService`,计算 `costPerOrder`,还原真实经营毛利。
|
||||
- **参考路径**:[ExpenseService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/ExpenseService.ts)
|
||||
|
||||
### **[BIZ_FIN_182] 大宗商品价格波动对采购成本的影响预测 (Commodity)**
|
||||
- **风险收益**:提前识别原材料涨价风险,自动建议备货或套期保值策略。
|
||||
- **核心目标**:实现 `MaterialRiskService`,监控铜、钢、原油等大宗商品行情并生成建议。
|
||||
- **参考路径**:[MaterialRiskService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/MaterialRiskService.ts)
|
||||
|
||||
### **[BIZ_FIN_183] 售后退款路径原路返回一致性审计 (Refund Audit)**
|
||||
- **合规收益**:防止内部舞弊或反洗钱合规风险,确保资金流向闭环。
|
||||
- **核心目标**:实现 `RefundAuditService`,强制校验退款路径与原始支付路径的一致性。
|
||||
- **参考路径**:[RefundAuditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/RefundAuditService.ts)
|
||||
|
||||
### **[BIZ_FIN_184] 基于用户 LTV 的营销成本上限建议 (CAC)**
|
||||
- **盈利收益**:动态设定各渠道的获客成本(CAC)红线,确保长期 LTV/CAC 比率健康。
|
||||
- **核心目标**:实现 `CACThresholdService`,根据 LTV 预测自动计算允许的最高获客成本。
|
||||
- **参考路径**:[CACThresholdService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CACThresholdService.ts)
|
||||
|
||||
### **[BIZ_FIN_185] 全球分销网络利润分成自动结算 (Split)**
|
||||
- **渠道收益**:自动化处理复杂的分销分润,降低人工对账成本 100%。
|
||||
- **核心目标**:实现 `CommissionService`,支持多层级 referral 分润与状态追踪。
|
||||
- **参考路径**:[CommissionService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CommissionService.ts)
|
||||
|
||||
### **[BIZ_FIN_186] 库存周转率异常导致的资金占用预警 (Turnover)**
|
||||
- **流动性收益**:识别沉淀资金,通过加速周转提升整体资本回报率。
|
||||
- **核心目标**:实现 `TurnoverWatchdog`,监控 `daysToTurnover` 指标并触发积压预警。
|
||||
- **参考路径**:[TurnoverWatchdog.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TurnoverWatchdog.ts)
|
||||
|
||||
### **[BIZ_FIN_187] 基于历史数据的售后损耗准备金建议 (Provision)
|
||||
- **稳健收益**:根据 AGI 预测的损耗率计提准备金,使财务报表更真实地反映风险。
|
||||
- **核心目标**:实现 `WarrantyService`,基于历史 `lossRatio` 自动建议月度计提金额。
|
||||
- **参考路径**:[WarrantyService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/WarrantyService.ts)
|
||||
|
||||
### **[BIZ_FIN_188] 多国税务合规申报文件自动预填建议 (Filing)
|
||||
- **合规收益**:极大简化跨境电商的税务申报流程,降低逾期申报风险。
|
||||
- **核心目标**:实现 `TaxFilingAdvisor`,根据各订单目的国税率与销售额,自动生成申报建议。
|
||||
- **参考路径**:[TaxFilingAdvisor.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TaxFilingAdvisor.ts)
|
||||
|
||||
### **[BIZ_FIN_189] 异常低毛利订单强制拦截建议 (Low Margin)
|
||||
- **风控收益**:作为最后一道防线,识别由于配置错误(如调价异常)导致的亏本订单。
|
||||
- **核心目标**:实现 `MarginProtector`,在订单对账阶段实时检测毛利率,并触发拦截。
|
||||
- **参考路径**:[MarginProtector.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/MarginProtector.ts)
|
||||
|
||||
### **[BIZ_FIN_190] 供应商信用额度自动预警 (Credit Limit)
|
||||
- **供应链收益**:预防由于欠款超过信用额度导致的采购中断。
|
||||
- **核心目标**:实现 `CreditMonitorService`,监控各供应商的已用额度与剩余额度。
|
||||
- **参考路径**:[CreditMonitorService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CreditMonitorService.ts)
|
||||
|
||||
### **[BIZ_FIN_191] 跨国转让定价合规性建议 (Transfer Pricing)
|
||||
- **法律收益**:预防国际贸易中的反避税调查风险,合规规划全球利润分布。
|
||||
- **核心目标**:实现 `LegalTaxService`,监控大额跨境交易额,识别潜在合规审计风险。
|
||||
- **参考路径**:[LegalTaxService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/LegalTaxService.ts)
|
||||
|
||||
### **[BIZ_FIN_192] 多平台提现手续费阶梯优化建议 (Payout Optimizer)
|
||||
- **降本收益**:通过科学的提现时机与额度建议,降低平均提现手续费 10-20%。
|
||||
- **核心目标**:实现 `PayoutOptimizer`,基于平台阶梯费率模型建议最佳提现动作。
|
||||
- **参考路径**:[PayoutOptimizer.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PayoutOptimizer.ts)
|
||||
|
||||
### **[BIZ_FIN_193] 基于 AI 预测的年度财务预算生成 (Budgeting)**
|
||||
- **战略收益**:从经验决策转向数据驱动的预算编排,提升资金分配效率。
|
||||
- **核心目标**:实现 `FinancialPlanner`,基于历史趋势自动生成明年的营收与成本预算草案。
|
||||
- **参考路径**:[FinancialPlanner.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/FinancialPlanner.ts)
|
||||
|
||||
### **[BIZ_FIN_194] 高频取消订单导致的支付网关风险预警 (Gateway Risk)**
|
||||
- **风控收益**:识别由于订单取消率异常波动导致的支付通道(PayPal/Stripe)封禁风险。
|
||||
- **核心目标**:实现 `PaymentRiskService`,监控 `cancellationRatio` 并触发网关保护建议。
|
||||
- **参考路径**:[PaymentRiskService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PaymentRiskService.ts)
|
||||
|
||||
### **[BIZ_FIN_195] 基于实时毛利的动态运费模板建议 (Shipping Optimizer)**
|
||||
- **利润收益**:根据各目的地国家的实时物流成本与订单毛利,动态建议包邮门槛。
|
||||
- **核心目标**:实现 `DynamicShippingService`,计算最优 `freeShippingThreshold`。
|
||||
- **参考路径**:[DynamicShippingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/DynamicShippingService.ts)
|
||||
|
||||
### **[BIZ_FIN_196] 营销活动盈亏平衡点实时监控 (Campaign Health)**
|
||||
- **决策收益**:秒级发现正在亏损的营销活动,防止广告预算的无效浪费。
|
||||
- **核心目标**:实现 `CampaignHealthService`,实时计算 `currentROAS` vs `breakEvenROAS`。
|
||||
- **参考路径**:[CampaignHealthService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CampaignHealthService.ts)
|
||||
|
||||
### **[BIZ_FIN_197] 供应商年度框架协议降本达成度审计 (Savings Audit)**
|
||||
- **绩效收益**:量化采购团队的降本贡献,确保供应商框架协议的真实执行。
|
||||
- **核心目标**:实现 `SavingTrackerService`,对比 `base_price` 与 `actual_price` 计算真实降本。
|
||||
- **参考路径**:[SavingTrackerService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/SavingTrackerService.ts)
|
||||
|
||||
### **[BIZ_FIN_198] 基于用户行为特征的恶意索赔拦截 (Claim Fraud)**
|
||||
- **风控收益**:识别并拦截高频索赔的“职业薅羊毛”账户,保护租户利润空间。
|
||||
- **核心目标**:实现 `ClaimFraudService`,基于 `claimToOrderRatio` 自动识别欺诈风险。
|
||||
- **参考路径**:[ClaimFraudService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/ClaimFraudService.ts)
|
||||
|
||||
### **[BIZ_FIN_199] 全球多币种资产负债表实时快照 (Balance Sheet)**
|
||||
- **估值收益**:为租户提供秒级的资产负债全景,支持企业融资与决策。
|
||||
- **核心目标**:实现 `GlobalBalanceSheet`,实时汇总 Inventory Value、Payouts 与 Liabilities。
|
||||
- **参考路径**:[GlobalBalanceSheet.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/GlobalBalanceSheet.ts)
|
||||
|
||||
### **[BIZ_FIN_200] 基于 AGI 的全自动审计与合规性自查 (AI Guard)**
|
||||
- **合规收益**:最终合规防线,利用 AGI 遍历全量审计日志,识别任何潜在的财务违规行为。
|
||||
- **核心目标**:实现 `ComplianceAIGuard`,对敏感操作(如 DELETE/FORCE_REFUND)进行 AI 穿透式审计。
|
||||
- **参考路径**:[ComplianceAIGuard.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/ComplianceAIGuard.ts)
|
||||
|
||||
### **[BIZ_OPS_01] 多平台订单实时同步与状态流转 (Order Sync)**
|
||||
- **业务收益**:统一订单中枢,减少人工多后台操作时间 90%。
|
||||
- **核心目标**:
|
||||
1. **实时归集**:从 Amazon/AliExpress/Shopify 实时抓取并映射至统一订单模型。
|
||||
2. **自动分账**:支付成功后自动触发 Owner/Manager 利润分配。
|
||||
- **参考路径**:[ConsumerOrderService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/ConsumerOrderService.ts)
|
||||
|
||||
### **[BIZ_FIN_23] 跨主权多资产实时结算网关 (Multi-Asset Settlement)**
|
||||
- **金融收益**:支持法币与数字资产混合清算,降低跨境汇损 3-5%。
|
||||
- **核心目标**:构建去中心化结算协议,实现亚秒级跨租户资金对冲。
|
||||
- **参考路径**:[MultiAssetSettlementService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/MultiAssetSettlementService.ts)
|
||||
|
||||
### **[BIZ_FIN_05] 全球发票自动化生成与合规引擎 (Auto-Invoicing)**
|
||||
- **合规收益**:根据订单与目的地国家法律(VAT/GST)自动生成合规发票,减少人工开票成本。
|
||||
- **核心目标**:实现 `InvoicingService`,支持多国税率动态计算与 PDF/电子发票生成。
|
||||
- **参考路径**:[InvoicingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/InvoicingService.ts)
|
||||
|
||||
### **[BIZ_FIN_12] 实时现金流预测与资金调度 (Cashflow Forecasting)**
|
||||
- **财务收益**:利用 AI 预测未来 30 天收支风险,自动优化资金分配。
|
||||
- **核心目标**:聚合 `cf_orders` (待结) 与 `cf_purchase_orders` (待付) 数据,生成风险评级。
|
||||
- **参考路径**:[CashflowForecastService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CashflowForecastService.ts)
|
||||
|
||||
### **[BIZ_FIN_14] 跨租户大宗商品价格对冲对账 (Commodity Hedging)**
|
||||
- **避险收益**:为原材料敏感型租户提供大宗商品(油、金、钢)的价格对冲策略建议。
|
||||
- **核心目标**:实时监控大宗行情,跨租户执行虚拟对冲对账。
|
||||
- **参考路径**:[CommodityHedgingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CommodityHedgingService.ts)
|
||||
|
||||
### **[BIZ_FIN_18] 跨租户大宗商品集中采购议价池 (Pool Sourcing)**
|
||||
- **降本收益**:利用规模效应,自动合并跨租户的相似原材料采购需求,增强议价能力。
|
||||
- **核心目标**:建立 `cf_sourcing_pools`,支持“拼单”采购模式。
|
||||
- **参考路径**:[PoolSourcingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PoolSourcingService.ts)
|
||||
|
||||
### **[BIZ_FIN_25] 主权财富基金与集体投资协议 (Sovereign Wealth Fund)**
|
||||
- **生态收益**:允许租户将闲置利润投入生态基金,共享基础设施优化收益。
|
||||
- **核心目标**:基于 Shapley Value 算法模拟分红,实现生态内部资本循环。
|
||||
- **参考路径**:[SovereignWealthFundService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/SovereignWealthFundService.ts)
|
||||
|
||||
---
|
||||
|
||||
## 🎨 4. 治理遥测与沉浸交互 (Domain: UX / CORE_TELE / LOGISTICS)
|
||||
|
||||
### **[BIZ_SC_13] 供应商绩效自动评分模型 (Supplier Scoring Model)**
|
||||
- **风控收益**:基于交付时效、质检合格率、价格波动等多维数据自动淘汰劣质供应商。
|
||||
- **核心目标**:建立 `cf_supplier_scores` 模型,为 `TradeService` 提供采购决策依据。
|
||||
- **参考路径**:[SupplierScoringService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/SupplierScoringService.ts)
|
||||
|
||||
### **[BIZ_TRADE_14] 最后一公里配送成本优化模型 (Last-Mile Optimizer)**
|
||||
- **效率收益**:利用 TSP 算法动态优化派送路径,降低末端物流成本 15%。
|
||||
- **核心目标**:基于包裹密度热力图实现智能排单。
|
||||
- **参考路径**:[LastMileOptimizerService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/LastMileOptimizerService.ts)
|
||||
|
||||
### **[BIZ_TRADE_18] 全球物流拥堵预测与自适应绕路建议 (Congestion Failover)**
|
||||
- **时效收益**:分钟级响应全球港口/枢纽拥堵,自动切换备选物流方案。
|
||||
- **核心目标**:监控 `cf_congestion_history`,在危机发生前实现自动路由迁移。
|
||||
- **参考路径**:[CongestionFailoverService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/CongestionFailoverService.ts)
|
||||
|
||||
### **[BIZ_AUTO_03] 多渠道营销日历自动执行 (Marketing Calendar)**
|
||||
- **增长收益**:消除人工多平台改价操作,实现全球大促“秒级”联动。
|
||||
- **核心目标**:自动化执行折扣、优惠券发放及库存锁定。
|
||||
- **参考路径**:[MarketingCalendarService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Marketing/MarketingCalendarService.ts)
|
||||
|
||||
### **[BIZ_MKT_14] 社交媒体趋势实时对齐与选品反馈 (Social Pulse)**
|
||||
- **爆款收益**:将 TikTok/Instagram 热门趋势词与 AGI 选品引擎对齐,发现蓝海商机。
|
||||
- **核心目标**:实现 `SocialPulseService`,支持多语种语义归并。
|
||||
- **参考路径**:[SocialPulseService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Marketing/SocialPulseService.ts)
|
||||
|
||||
### **[BIZ_BILL_01] 企业配额与订阅计费中心 (Quota & Subscription Billing)**
|
||||
- **业务收益**:建立稳定经常性收入模型,支持 TOB/TOC 双线商业化。
|
||||
- **技术规格**:
|
||||
1. **数据模型 (Table: `cf_tenant_quota`)**:
|
||||
- `tenant_id` (PK), `seats_limit`, `shops_limit`, `nodes_limit`, `task_monthly_limit`, `ai_call_limit`.
|
||||
2. **计费 API**:
|
||||
- `POST /api/billing/subscribe`: 激活套餐并重置配额。
|
||||
- `GET /api/billing/usage`: 获取当前租户的五维用量实时百分比。
|
||||
- **参考路径**:`server/src/domains/Billing/`
|
||||
|
||||
### **[BIZ_CRM_10] 智能售后与客户成功中枢 (After-Sales & CSM)**
|
||||
- **业务收益**:降低退款与纠纷成本,提升复购率与品牌评分。
|
||||
- **技术规格**:
|
||||
1. **状态机 (FSM)**: `PENDING_REVIEW -> AI_ANALYZING -> AUTO_APPROVED | MANUAL_INTERVENE -> RESOLVED`.
|
||||
2. **核心逻辑**: 对接 `ArbitrageService` 自动核算退款对净利的影响,若退款后 ROI 仍符合红线则由 AGI 自动放行。
|
||||
- **参考路径**:`server/src/domains/Customer/`
|
||||
|
||||
### **[BIZ_INT_12] 企业集成网关 (SSO + Webhook + OpenAPI)**
|
||||
- **业务收益**:缩短企业客户实施周期,提升交付标准化能力。
|
||||
- **技术规格**:
|
||||
1. **Webhook 事件总线**: 支持 `order.created`, `inventory.low`, `arbitrage.found` 等 10+ 事件。
|
||||
2. **安全机制**: 采用 HMAC-SHA256 签名,Header 携带 `X-Crawlful-Signature`。
|
||||
- **参考路径**:`server/src/api/internal/`
|
||||
|
||||
---
|
||||
|
||||
## 🎨 4. 治理遥测与沉浸交互 (Domain: UX / CORE_TELE)
|
||||
|
||||
### BIZ_GOV_BEHAVIORAL_RISK: 租户行为风险监控 (Behavioral Risk)
|
||||
- **ID**: `BIZ_GOV_09`
|
||||
- **Owner**: AI-2
|
||||
- **Status**: ✅ `completed` (Batch 49)
|
||||
- **Features**:
|
||||
- `BehavioralRiskService.analyzePatterns`: 自动化模式分析 (撞库/高频/枚举).
|
||||
- `RiskScoring`: 动态评分 (0-100) + 级别联动.
|
||||
- `AGIKillSwitch`: 触发高危风险实时熔断.
|
||||
|
||||
### BIZ_AUDIT_DATA_COMPLIANCE: 跨区域数据合规扫描 (Data Compliance)
|
||||
- **ID**: `BIZ_AUDIT_DATA_COMPLIANCE`
|
||||
- **Owner**: AI-2
|
||||
- **Status**: ✅ `completed` (Batch 49)
|
||||
- **Features**:
|
||||
- `DataComplianceService`: 实时扫描跨国/跨区域数据调用路径.
|
||||
- `ComplianceMiddleware`: (TBD Integration with API routes).
|
||||
|
||||
### BIZ_AUDIT_AGENT_TRACE: AI 代理轨迹审计 (Agent Trace)
|
||||
- **ID**: `BIZ_AUDIT_14`
|
||||
- **Owner**: AI-2
|
||||
- **Status**: ✅ `completed` (Batch 49)
|
||||
- **Features**:
|
||||
- `AgentTraceAuditService`: 全生命周期轨迹审计.
|
||||
- `Reasoning Evidence`: 联动 `ExplainableAIService` 获取决策依据.
|
||||
- `Audit存证`: 决策因果链路的持久化.
|
||||
|
||||
### UX_XAI_01: AGI 决策可解释性看板 (XAI Dashboard)
|
||||
- **用户收益**:建立人机信任,让商户看懂 AI 为何调价或选品。
|
||||
- **核心目标**:展示 AGI 决策因果链路 (Causal Chain) 与影响因子热力图。
|
||||
- **参考路径**:[DecisionExplainabilityEngine.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/DecisionExplainabilityEngine.ts)
|
||||
|
||||
### **[UX_VR_02] AGI 驱动的实时虚拟供应链数字孪生 (Digital Twin)**
|
||||
- **交互收益**:可视化全球货流与仓储风险,实现“上帝视角”管理。
|
||||
- **核心目标**:利用 Three.js 渲染全球 4D 贸易流与海外仓动态热力图。
|
||||
- **参考路径**:`dashboard/src/pages/ar-3d/`
|
||||
|
||||
### **[BIZ_INV_05] 分布式多仓库存实战同步 (Inventory)**
|
||||
- **业务收益**:防止多平台超卖风险,优化跨仓调拨成本。
|
||||
- **技术规格**:
|
||||
1. **锁定机制**: 采用 Redis 分布式锁确保 `lockStock` 操作的原子性。
|
||||
2. **跨仓调拨**: AI 根据 `InventoryRLService` 建议生成 `TRANSFER` 任务,自动更新 `cf_inventory` 的可用余量。
|
||||
- **参考路径**:`server/src/domains/Trade/InventoryRLService.ts`
|
||||
|
||||
### **[BIZ_FIN_06] 全自动化利润对账引擎 (Recon)**
|
||||
- **业务收益**:消除财务黑盒,实现每笔订单利润的精准勾稽。
|
||||
- **技术规格**:
|
||||
1. **三位一体勾稽**: 自动关联 `cf_order` (收入)、`cf_purchase_order` (成本)、`cf_logistics_route` (运费)。
|
||||
2. **对账状态机**: `UNRECONCILED -> AUTO_MATCHED -> RECONCILED | DISCREPANCY`.
|
||||
- **参考路径**:`server/src/domains/Finance/ReconciliationService.ts`
|
||||
|
||||
### **[CORE_AI_50] 多模态 AGI 视觉寻源插件 (Visual Sourcing)**
|
||||
- **战略收益**:通过图片直达源头厂家,提升寻源效率 500%。
|
||||
- **核心目标**:集成 1688 图片搜索 API,利用 CLIP 模型进行特征向量匹配,自动识别源头厂家。
|
||||
- **参考路径**:`server/src/services/SupplyChainService.ts`
|
||||
|
||||
### **[BIZ_LOG_08] 全球物流轨迹实时遥测 (Tracking)**
|
||||
- **业务收益**:提升买家信任度,降低因轨迹不明导致的纠纷率 40%。
|
||||
- **技术规格**:
|
||||
1. **4D 轨迹回传**: 实现 `LogisticsTrackingService`,支持对 `cf_order` 关联的运单号进行定时拉取。
|
||||
2. **异常感知**: AI 自动识别“轨迹停滞”、“清关异常”等状态,并触发 `SovereignCrisisService` 预警。
|
||||
- **参考路径**:`server/src/domains/Logistics/LogisticTelemetryService.ts`
|
||||
|
||||
### **[BIZ_MKT_15] KOL 达人营销全生命周期管理 (Campaign)**
|
||||
- **业务收益**:标准化达人合作流程,ROI 提升 25%。
|
||||
- **技术规格**:
|
||||
1. **生命周期 FSM**: `IDENTIFIED -> OUTREACHED -> SAMPLE_SENT -> CONTENT_LIVE -> ROI_TRACKING`.
|
||||
2. **归因联动**: 自动关联 `KOLService` 中的成交数据,计算达人真实的带货转化率。
|
||||
- **参考路径**:`server/src/domains/Marketing/KOLService.ts`
|
||||
|
||||
### **[BIZ_PROD_12] AI 商品全自动“清洗”与本地化 (Washer)**
|
||||
- **业务收益**:极大降低新品上架成本,Listing 本地化质量提升 100%。
|
||||
- **技术规格**:
|
||||
1. **语义清洗**: 过滤掉原图/原标题中的非法字符、品牌 Logo 及无效关键词。
|
||||
2. **多模态增强**: 利用 `VisionFactoryService` 自动生成符合目标市场审美(如:中东/东南亚风格)的营销图。
|
||||
- **参考路径**:`server/src/services/ProductService.ts`
|
||||
|
||||
### **[CORE_SEC_45] 租户数据主权隔离门禁 (Isolation)**
|
||||
- **安全收益**:从底层杜绝越权访问,确保租户数据主权绝对隔离。
|
||||
- **技术规格**:
|
||||
1. **隔离拦截器**: 实现 `MultiTenantCore.from(tenantId, table)` 模式,强制所有查询必须通过该门禁。
|
||||
2. **所有权校验**: 提供 `ensureOwnership` 方法,在执行更新/删除前强制校验记录归属。
|
||||
- **落地代码**:[MultiTenantCore.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Tenant/MultiTenantCore.ts)
|
||||
|
||||
### **[BIZ_GOV_20] 全量业务事件审计流水线 (Audit Log)**
|
||||
- **治理收益**:满足企业级合规审计要求,100% 记录关键业务变更。
|
||||
- **技术规格**:
|
||||
1. **事件钩子**: 在 `core/runtime` 层级实现 `DomainEventBus`,自动捕获各 Domain 的变更。
|
||||
2. **结构化存储**: 记录 `actor`, `action`, `resource`, `diff`, `timestamp` 四元组。
|
||||
- **参考路径**:`server/src/core/runtime/DomainRegistry.ts`
|
||||
|
||||
### **[BIZ_TEN_03] 多租户标准交付与流程自动化 (Delivery)**
|
||||
- **业务收益**:标准化交付流程,将专有化部署开通时间从 3 天降至 1 小时。
|
||||
- **技术规格**:
|
||||
1. **任务追踪**: 实现 `cf_delivery_tasks` 表,记录每个租户交付项(如:SSO 联送、数据库初始化)的完成状态。
|
||||
2. **自动化 API**: `POST /api/v1/tenant/delivery/start` 触发异步交付流水线。
|
||||
- **参考路径**:`server/src/domains/Tenant/DeliveryTemplateService.ts`
|
||||
|
||||
### **[BIZ_FIN_11] 智能税务筹划与最优申报路径 (Tax AI)**
|
||||
- **业务收益**:自动识别最优税务结构(如 OSS/IOSS),平均降低跨境合规成本 15%。
|
||||
- **技术规格**:
|
||||
1. **税务建议 API**: `POST /api/v1/finance/tax/plan` 提交经营画像,返回 AGI 生成的税务建议。
|
||||
2. **合规登记库**: 存储 `cf_tax_strategies`,支持多国税率动态更新。
|
||||
- **参考路径**:`server/src/domains/Finance/TaxPlanningService.ts`
|
||||
|
||||
### **[BIZ_ECO_08] 自治危机管理与自愈协议 (Crisis)**
|
||||
- **生态收益**:在黑天鹅事件发生时实现分钟级避险,保护商户资金安全。
|
||||
- **技术规格**:
|
||||
1. **熔断器集成**: 联动 `CongestionFailoverService`,在危机发生时自动执行 `UPDATE cf_order SET logistics_status = 'REROUTING'`。
|
||||
2. **主权防御 API**: `GET /api/v1/biz/crisis/active` 返回当前全网受灾情况与自愈进度。
|
||||
- **参考路径**:`server/src/domains/Trade/SovereignCrisisService.ts`
|
||||
|
||||
### **[CORE_ANL_03] 租户经营表现实时聚合中心 (Analytics)**
|
||||
- **决策收益**:提供秒级经营遥测,支持从 $10W 营收下钻到单笔订单的证据链。
|
||||
- **技术规格**:
|
||||
1. **SQL 聚合**: 实现基于 `tenant_id` 的全量聚合查询(SUM Revenue, AVG ROI)。
|
||||
2. **证据链下钻**: 联动 `AuditLogService` 还原 `found -> calculate -> review -> publish` 的完整证据链。
|
||||
- **参考路径**:`server/src/domains/Analytics/AnalyticsService.ts`
|
||||
|
||||
### **[BIZ_MKT_20] AGI 广告管家与预算动态优化 (AdOps)**
|
||||
- **业务收益**:将广告 ROI 提升 20% 以上,通过 AGI 自动分配各平台预算。
|
||||
- **技术规格**:
|
||||
1. **预算动态分配**: 联动 `ArbitrageAGIService`,根据实时转化率(TikTok vs FB)动态执行 `updateBudget`。
|
||||
2. **自动创建计划**: AI 根据爆款预测结果,自动生成广告创意(联动 `AdCreativeService`)并推送到平台。
|
||||
- **参考路径**:`server/src/domains/Marketing/AdAutoService.ts`
|
||||
|
||||
### **[CORE_ANL_05] 全业务多维经营报表中心 (Reporting)**
|
||||
- **决策收益**:一站式获取经营全貌,自动识别亏损项并生成“决策周报”。
|
||||
- **技术规格**:
|
||||
1. **多维报表 API**: `GET /api/v1/analytics/reports` 支持按平台、SKU、时间维度聚合 ROI 与净利。
|
||||
2. **AI 周报生成**: 利用 LLM 对本周经营数据(cf_order + cf_pixel_logs)进行归因分析,生成自然语言总结。
|
||||
- **参考路径**:`server/src/domains/Analytics/AnalyticsService.ts`
|
||||
|
||||
### **[BIZ_CRE_01] 多模态 AI 创作工作台 (Creative)**
|
||||
- **业务收益**:实现营销素材的“零人工”生产,TTS 转化率提升 40%,视频生成效率提升 10 倍。
|
||||
- **技术规格**:
|
||||
1. **TTS 集成**: 对接 Minimax API,支持 `voice_id` 选择、语速 (`speed`)、音调 (`pitch`) 参数控制。
|
||||
2. **任务 FSM**: `PENDING -> PROCESSING -> COMPLETED | FAILED`。支持主图生成、详情图生成、视频翻译任务。
|
||||
3. **存储模型**: `cf_creative_tasks` (记录任务参数与状态) + `cf_media_assets` (记录生成后的 URL 与元数据)。
|
||||
- **参考路径**:`server/src/domains/Creative/CreativeService.ts`
|
||||
|
||||
### **[BIZ_REP_01] 全业务多维报表体系 (Reports)**
|
||||
- **决策收益**:覆盖全业务链路监控,自动识别恶意订单与财务偏差。
|
||||
- **技术规格**:
|
||||
1. **报表矩阵**: 实现 Advertiser, GMV Max, Settlement, Malicious Order, Employee Log, Financial, Order, Material, Product, Dept 报表。
|
||||
2. **数据勾稽**: 联动 `cf_order`, `cf_ad_stats`, `cf_settlement`, `cf_audit_log` 进行跨表聚合。
|
||||
- **参考路径**:`server/src/domains/Analytics/ReportService.ts`
|
||||
|
||||
---
|
||||
|
||||
## 📜 历史规格存档 (Archived Specs - V26.0 and below)
|
||||
*请查阅 Git 历史记录或对应版本的存档文档。*
|
||||
|
||||
### **[BIZ_MKT_40] 多触点归因与利润分析 (Attribution Engine)**
|
||||
- **业务收益**:识破虚假 ROAS,计算剔除自然单后的真实 LTV/CAC 比率,优化营销预算分配。
|
||||
- **核心目标**:实现 `MultiTouchAttributionService`,对比总订单流与广告点击流,计算 `trueROAS` 与 `organicRevenue`。
|
||||
- **参考路径**:[MultiTouchAttributionService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Marketing/MultiTouchAttributionService.ts)
|
||||
|
||||
### **[BIZ_FIN_40] 基于 DID 的自治清算协议 (DID Settlement)**
|
||||
- **金融收益**:利用分布式身份 (DID) 自动化品牌方、代运营与达人的三方自动分润,降低结算争议 95%。
|
||||
- **核心目标**:构建 `DIDSettlementService`,支持亚秒级清算证据链存证与多级分润逻辑。
|
||||
- **参考路径**:[DIDSettlementService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/DIDSettlementService.ts)
|
||||
|
||||
### **[BIZ_LOG_20] 全球动态路径对冲与风险熔断 (Global Route Failover)**
|
||||
- **时效收益**:在黑天鹅事件(如罢工、港口拥堵)发生时,自动切换最优路径并对冲物流成本上涨风险。
|
||||
- **核心目标**:升级 `LogisticsRoutingService`,支持多式联运动态对冲策略与实时成本监控。
|
||||
- **参考路径**:[DynamicRoutingFailoverService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/DynamicRoutingFailoverService.ts)
|
||||
|
||||
### **[BIZ_INV_20] 强化学习驱动的全球库存平衡 (RL Inventory Balancing)**
|
||||
- **库存收益**:自动决策跨仓调拨,最小化总持仓成本与缺货损失,提升库存周转率。
|
||||
- **核心目标**:完善 `InventoryRLOptimizerService`,接入多维成本评估模型与 RL 决策引擎。
|
||||
- **参考路径**:[InventoryRLOptimizerService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/InventoryRLOptimizerService.ts)
|
||||
|
||||
### **[BIZ_FIN_50] 跨主权多币种对冲对账引擎 (Multi-Currency Recon)**
|
||||
- **避险收益**:自动化处理由于汇率剧烈波动导致的对账偏差,保护商户资金主权,减少财务人工核对成本 80%。
|
||||
- **核心目标**:实现 `MultiCurrencyHedgingReconService`,实时计算 `fx_drift` 并生成对冲对账单。
|
||||
- **参考路径**:[MultiCurrencyHedgingReconService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/MultiCurrencyHedgingReconService.ts)
|
||||
|
||||
### **[BIZ_LOG_30] 最后一公里众包路由优化 (Crowdsourced Last-mile)**
|
||||
- **韧性收益**:在黑天鹅事件导致传统物流商瘫痪时,自动调度众包资源,确保履约不中断。
|
||||
- **核心目标**:实现 `CrowdsourcedLogisticsService`,支持多点派送路径计算与成本动态核算。
|
||||
- **参考路径**:[CrowdsourcedLogisticsService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/CrowdsourcedLogisticsService.ts)
|
||||
|
||||
### **[BIZ_TRADE_30] 自动化供应商产能预警 (Supplier Capacity Watch)**
|
||||
- **交付收益**:提前感知供应商交期延误风险,通过 AGI 预测产能饱和度,自动建议切换备选源。
|
||||
- **核心目标**:实现 `SupplierCapacityWatchService`,监控 `backlog_ratio` 并生成风险预警报告。
|
||||
- **参考路径**:[SupplierCapacityWatchService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/SupplierCapacityWatchService.ts)
|
||||
|
||||
### **[BIZ_CSM_30] 智能争议仲裁建议 (Dispute Arbitration)**
|
||||
- **效率收益**:自动化处理售后纠纷与退款争议,基于全链路证据链给出公正仲裁建议,降低客服工作量 70%。
|
||||
- **核心目标**:实现 `DisputeArbitrationService`,聚合订单、物流、支付全量数据生成仲裁书。
|
||||
- **参考路径**:[DisputeArbitrationService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Customer/DisputeArbitrationService.ts)
|
||||
|
||||
### **[BIZ_TRADE_40] AGI 驱动的全球合规与制裁扫描 (Compliance Scan)**
|
||||
- **合规收益**:自动化扫描 SKU 与收货地址,防止违反特定国家/地区的贸易禁令(如 OFAC 制裁、出口管制),避免高额罚款。
|
||||
- **核心目标**:实现 `TradeComplianceService`,集成全球合规库,提供实时风险评分。
|
||||
- **参考路径**:[TradeComplianceService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/TradeComplianceService.ts)
|
||||
|
||||
### **[BIZ_FIN_70] 基于 ZKP 的链上隐私信用证 (Private L/C)**
|
||||
- **金融收益**:利用 ZKP 保护商业机密,同时向金融机构证明交易真实性,缩短 B2B 结算周期,提升资金周转率。
|
||||
- **核心目标**:实现 `SovereignPrivateLCService`,支持链上信用证生成与隐私存证验证。
|
||||
- **参考路径**:[SovereignPrivateLCService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/SovereignPrivateLCService.ts)
|
||||
|
||||
### **[BIZ_LOG_50] 弹性多式联运自动对冲引擎 (Intermodal Failover)**
|
||||
- **韧性收益**:当全球主航道发生黑天鹅事件时,自动计算并执行多式联运切换(如海转铁),最小化时效延误。
|
||||
- **核心目标**:实现 `IntermodalFailoverService`,支持动态路由成本核算与自动对冲方案生成。
|
||||
- **参考路径**:[IntermodalFailoverService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/IntermodalFailoverService.ts)
|
||||
|
||||
### **[SOV_NET_02] 跨节点自治清算协议实现 (Cross-Node Settlement)**
|
||||
- **网络收益**:实现 Hub 节点间的自动化利润分润与资金清算,构建去中心化的全球贸易价值网。
|
||||
- **核心目标**:实现 `CrossNodeSettlementService`,联动 `DIDSettlementService` 处理跨 Hub 的 DID 身份清算。
|
||||
- **参考路径**:[CrossNodeSettlementService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CrossNodeSettlementService.ts)
|
||||
|
||||
### **[SOV_NET_04] 跨节点争议自动仲裁转发 (Dispute Forwarding)**
|
||||
- **信任收益**:在多节点贸易中,实现证据链的自动化路由与转发,支持跨节点的 AGI 联合仲裁。
|
||||
- **核心目标**:构建 `GlobalDisputeRouter`,支持证据链在不同主权节点间的安全传输与同步。
|
||||
- **参考路径**:[GlobalDisputeRouter.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Customer/GlobalDisputeRouter.ts)
|
||||
|
||||
### **[BIZ_FIN_80] 跨主权贸易信用保险自动投保建议 (Trade Insurance)**
|
||||
- **风险收益**:针对高价值跨国订单,基于供应商风险评分自动建议投保方案,降低坏账与货损风险。
|
||||
- **核心目标**:实现 `TradeInsuranceService`,提供自动化投保建议。
|
||||
- **参考路径**:[TradeInsuranceService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TradeInsuranceService.ts)
|
||||
|
||||
### **[BIZ_TRADE_50] 动态出口管制合规证书自动化生成 (Compliance Certificate)**
|
||||
- **合规收益**:自动生成符合目的国要求的电子合规证书,确保顺畅通关。
|
||||
- **核心目标**:实现 `ComplianceCertificateService`,支持证书自动生成与 DID 签名。
|
||||
- **参考路径**:[ComplianceCertificateService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/ComplianceCertificateService.ts)
|
||||
|
||||
### **[BIZ_LOG_60] 绿色供应链碳信用交易撮合 (Carbon Credit Trading)**
|
||||
- **绿色收益**:撮合碳抵扣额度购买,提升品牌绿色合规等级。
|
||||
- **核心目标**:实现 `CarbonCreditTradingService`,支持碳足迹抵扣撮合。
|
||||
- **参考路径**:[CarbonCreditTradingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/CarbonCreditTradingService.ts)
|
||||
|
||||
### **[BIZ_FIN_90] 跨主权多节点资金流动性自动预测 (Liquidity Forecast)**
|
||||
- **资金收益**:预测全球贸易 Hub 节点的资金缺口,自动建议资金调拨,确保清算平滑。
|
||||
- **核心目标**:实现 `NodeLiquidityForecastService`,支持节点流动性预测。
|
||||
- **参考路径**:[NodeLiquidityForecastService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/NodeLiquidityForecastService.ts)
|
||||
|
||||
### **[BIZ_TRADE_60] 自动化供应链碳配额质押建议 (Carbon Pledge)**
|
||||
- **金融收益**:允许租户质押碳抵扣额度以获取更优的采购账期。
|
||||
- **核心目标**:实现 `CarbonPledgeService`,支持碳配额质押逻辑。
|
||||
- **参考路径**:[CarbonPledgeService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/CarbonPledgeService.ts)
|
||||
|
||||
### **[BIZ_LOG_70] 众包物流配送员 DID 信用分级体系 (Courier Credit)**
|
||||
- **履约收益**:建立基于 DID 的配送员信用分级,筛选优质众包资源,降低末端风险。
|
||||
- **核心目标**:实现 `CourierCreditService`,支持配送员信用分计算。
|
||||
- **参考路径**:[CourierCreditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/CourierCreditService.ts)
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ 5. AGI 诊断与自省规范 (AGI Diagnostics & Self-Awareness)
|
||||
|
||||
### **[CORE_DIAG_01] AGI 异常根因自省规范 (Self-Awareness Protocol)**
|
||||
- **治理收益**:消除静默失败,提升系统自愈效率 90%,实现“问题即文档”。
|
||||
- **核心要求**:
|
||||
1. **强制 RCA (Root Cause Analysis)**:所有阻塞性问题必须输出 `CATEGORY/ROOT_CAUSE/MITIGATION` 三元组。
|
||||
2. **分级上报**:
|
||||
- `FATAL`:立即停止任务并记录阻塞路径,更新看板 `[ISSUE-AI-X]`。
|
||||
- `WARN`:记录降级路径(Fallback),继续执行非核心任务。
|
||||
3. **自查清单 (Checklist)**:
|
||||
- 是否存在 Context 缺失?(需 Read/Search)
|
||||
- 是否存在逻辑冲突?(需 FSM 校验)
|
||||
- 是否存在环境约束?(需 .env/Database 校验)
|
||||
- **参考路径**:[.trae/rules/project_rules.md](file:///d:/trae_projects/crawlful-hub/.trae/rules/project_rules.md)
|
||||
|
||||
---
|
||||
**规格维护者**:AI-1 (Kernel) | **当前版本**:V32.0
|
||||
**看板索引**:[collaboration-board.md](file:///d:/trae_projects/crawlful-hub/docs/governance/collaboration-board.md)
|
||||
Reference in New Issue
Block a user