refactor: 优化代码结构并修复类型问题

- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
2026-03-23 12:41:35 +08:00
parent a037843851
commit 2b86715c09
363 changed files with 39305 additions and 40622 deletions
--- a/docs/ARCHIVE/08_Analysis/00_Analysis_Index.md
+++ b/docs/ARCHIVE/08_Analysis/00_Analysis_Index.md
@@ -0,0 +1,60 @@
+# 分析文档索引
+
+> **模块**: 08_Analysis - 系统分析与映射  
+> **更新日期**: 2026-03-22
+
+---
+
+## 分析文档列表
+
+| 文档 | 描述 | 状态 |
+|------|------|------|
+| [01_Business_Service_Mapping](01_Business_Service_Mapping.md) | 业务服务映射 | ✅ |
+| [02_Data_Flow](02_Data_Flow.md) | 数据流分析 | ✅ |
+| [03_Exception_Handling](03_Exception_Handling.md) | 异常处理分析 | ✅ |
+| [04_Frontend_Business_Mapping](04_Frontend_Business_Mapping.md) | 前端业务映射 | ✅ |
+| [05_Service_State_Mapping](05_Service_State_Mapping.md) | 服务状态映射 | ✅ |
+| [06_Runtime_Architecture](06_Runtime_Architecture.md) | 运行时架构 | ✅ |
+
+---
+
+## 已拆解文档
+
+> **说明**: 以下分析文档已拆解到现有文档体系中，保持思路统一、方便维护
+
+| 原文档 | 拆解目标 | 完成日期 |
+|--------|----------|----------|
+| ~~07_Product_Center_Analysis~~ | 术语标准、领域模型、服务地图、状态机、RBAC设计、API文档、前端产品、业务闭环、监控、治理规范、数据一致性、后端设计 | 2026-03-22 |
+
+### 拆解映射详情
+
+| 原文档章节 | 拆解目标文档 | 内容说明 |
+|------------|--------------|----------|
+| 核心概念与术语 | [TERMINOLOGY_STANDARDS.md](../10_Documents_Global/TERMINOLOGY_STANDARDS.md) | SPU/SKU/Listing、商品映射/刊登、三层价格体系 |
+| 数据模型设计 | [03_Domain_Model.md](../01_Architecture/03_Domain_Model.md) | 商品中心领域模型 |
+| 服务层设计 | [04_Service_Map.md](../01_Architecture/04_Service_Map.md) | 商品管理、价格策略服务流程 |
+| 状态机设计 | [06_State_Machine.md](../01_Architecture/06_State_Machine.md) | 商品中心状态机 |
+| 权限设计 | [07_RBAC_Design.md](../02_Backend/07_RBAC_Design.md) | 组织层级与数据范围 |
+| API设计 | [04_Product_API.md](../02_Backend/api/04_Product_API.md) | 商品中心API |
+| 前端设计 | [01_Product.md](../01_Architecture/frontend/01_Product.md) | 商品中心前端架构 |
+| 业务闭环 | [01_Product.md](../00_Business/Business_ClosedLoops/01_Product.md) | 三层商品模型、价格体系、组织权限闭环 |
+| 数据指标 | [06_Observability.md](../02_Backend/06_Observability.md) | 商品中心监控指标 |
+| 风险评估 | [Governance_Standards.md](../00_Business/Governance_Standards.md) | 商品中心风险评估 |
+| 数据流转 | [05_Data_Consistency.md](../02_Backend/05_Data_Consistency.md) | 商品中心数据流转 |
+| 异常处理 | [01_Design.md](../02_Backend/01_Design.md) | 商品中心异常处理 |
+
+---
+
+## 关联模块
+
+- [架构模块](../01_Architecture/00_Architecture_Index.md)
+- [后端模块](../02_Backend/00_Backend_Index.md)
+- [报告模块](../06_Reports/00_Reports_Index.md)
+
+---
+
+## 最近更新
+
+- 2026-03-22: 将商品中心分析文档拆解到现有文档体系，保持思路统一
+- 2026-03-22: 完善商品中心分析文档，添加背景介绍、核心功能说明、数据指标定义、分析方法、结论与建议章节
+- 2026-03-19: 创建分析模块，归档分析文档
--- a/docs/ARCHIVE/08_Analysis/01_Business_Service_Mapping.md
+++ b/docs/ARCHIVE/08_Analysis/01_Business_Service_Mapping.md
@@ -0,0 +1,146 @@
+# 业务-服务映射分析报告
+
+## 1. 业务闭环与服务流程映射
+
+| 业务闭环ID | 业务闭环名称 | 对应服务流程 | 覆盖情况 | 问题 |
+|---------|------------|------------|---------|------|
+| 1 | 数据采集与清洗闭环 | 自动选品闭环 | 部分覆盖 | 缺少数据清洗服务 |
+| 2 | 商品刊登闭环 | 自动上架闭环 | 部分覆盖 | 缺少商品准备和平台规则适配服务 |
+| 3 | 素材管理闭环 | - | 未覆盖 | 缺少素材管理服务 |
+| 4 | 广告计划与营销闭环 | - | 未覆盖 | 缺少广告管理服务 |
+| 5 | 订单履约闭环 | 订单履约闭环 | 完整覆盖 | - |
+| 6 | 售后逆向闭环 | - | 未覆盖 | 缺少售后处理服务 |
+| 7 | 资金对账闭环 | 结算闭环 | 部分覆盖 | 缺少资金对账服务 |
+| 8 | 库存与仓储管理闭环 | - | 未覆盖 | 缺少库存管理服务 |
+| 9 | 供应链与供应商管理闭环 | - | 未覆盖 | 缺少供应商管理服务 |
+| 10 | B2B / TOB 贸易管理闭环 | - | 未覆盖 | 缺少B2B贸易服务 |
+| 11 | 治理与审批中心闭环 | - | 未覆盖 | 缺少审批服务 |
+| 12 | 合规与证书管理闭环 | - | 未覆盖 | 缺少合规管理服务 |
+| 13 | 合规与风控闭环 | - | 未覆盖 | 缺少风控服务 |
+| 14 | 报表与分析闭环 | 商户数据与分析闭环 | 部分覆盖 | 缺少报表生成服务 |
+| 15 | 定价与利润决策闭环 | - | 未覆盖 | 缺少定价服务 |
+| 16 | 账号/店铺健康度闭环 | - | 未覆盖 | 缺少店铺健康度服务 |
+| 17 | 店铺隔离与自动化闭环 | - | 未覆盖 | 缺少店铺隔离服务 |
+| 18 | 订单集中管理闭环 | 订单多店铺聚合闭环 | 部分覆盖 | 缺少多平台订单采集服务 |
+| 19 | 客户/商家押金与账户管理闭环 | - | 未覆盖 | 缺少押金管理服务 |
+| 20 | 商家选择发货闭环 | - | 未覆盖 | 缺少商家发货服务 |
+| 21 | 回款与财务闭环 | 结算闭环 | 部分覆盖 | 缺少回款管理服务 |
+| 22 | 海外仓/本土仓 & 多品类支持闭环 | - | 未覆盖 | 缺少仓库管理服务 |
+| 23 | 商品主数据闭环 | - | 未覆盖 | 缺少商品主数据服务 |
+| 24 | SKU变体与结构闭环 | - | 未覆盖 | 缺少SKU管理服务 |
+| 25 | 订单拆分与合并闭环 | - | 未覆盖 | 缺少订单拆分合并服务 |
+| 26 | 异常订单处理闭环 | 异常处理闭环 | 完整覆盖 | - |
+| 27 | 物流策略与渠道选择闭环 | - | 未覆盖 | 缺少物流策略服务 |
+| 28 | 利润核算闭环 | - | 未覆盖 | 缺少利润核算服务 |
+| 29 | 用户/客户资产闭环 | - | 未覆盖 | 缺少用户资产服务 |
+| 30 | A/B测试与策略优化闭环 | - | 未覆盖 | 缺少A/B测试服务 |
+| 31 | 多商户入驻与认证闭环 | 商户管理闭环 | 部分覆盖 | 缺少商户认证服务 |
+| 32 | 商户店铺管理闭环 | 店铺管理闭环 | 完整覆盖 | - |
+| 33 | 多商户订单闭环 | 多商户订单闭环 | 完整覆盖 | - |
+| 34 | 多商户库存同步闭环 | 多商户库存同步闭环 | 完整覆盖 | - |
+| 35 | 多商户结算与财务闭环 | 结算闭环 | 部分覆盖 | 缺少商户财务服务 |
+| 36 | 商户权限与角色闭环 | 权限校验闭环 | 部分覆盖 | 缺少角色管理服务 |
+| 37 | 商户数据与分析闭环 | 商户数据与分析闭环 | 完整覆盖 | - |
+| 38 | 异常处理闭环 | 异常处理闭环 | 完整覆盖 | - |
+| 39 | 功能模块化与权限控制闭环 | 功能开通闭环 | 部分覆盖 | 缺少模块管理服务 |
+| 40 | 功能开通与支付闭环 | 功能开通闭环 | 完整覆盖 | - |
+| 41 | 恶意买家黑名单闭环 | - | 未覆盖 | 缺少黑名单服务 |
+| 42 | 高退货率SKU自动下架/改进建议闭环 | - | 未覆盖 | 缺少退货率管理服务 |
+| 43 | 商业化与增长闭环 | - | 未覆盖 | 缺少商业化服务 |
+| 44 | 服务编排与执行闭环 | - | 未覆盖 | 缺少服务编排服务 |
+| 45 | 增长飞轮闭环 | - | 未覆盖 | 缺少增长策略服务 |
+| 46 | 技术基础设施闭环 | - | 未覆盖 | 缺少基础设施服务 |
+| 47 | 客户服务闭环 | - | 未覆盖 | 缺少客户服务 |
+| 48 | 跨境电商闭环 | 跨境电商闭环 | 完整覆盖 | - |
+| 49 | AI驱动智能决策闭环 | AI决策日志闭环 | 部分覆盖 | 缺少AI决策服务 |
+| 50 | 核心服务优先级闭环 | - | 未覆盖 | 缺少服务优先级服务 |
+| 51 | 多商户收益排行榜系统（信任引擎） | - | 未覆盖 | 缺少排行榜服务 |
+| 52 | 策略市场（Strategy Marketplace） | - | 未覆盖 | 缺少策略市场服务 |
+| 53 | 自动选品+自动上架系统（增长引擎） | 自动选品闭环, 自动上架闭环 | 完整覆盖 | - |
+| 54 | AI店铺托管（AutoPilot） | - | 未覆盖 | 缺少店铺托管服务 |
+| 55 | 跨平台套利系统 | - | 未覆盖 | 缺少套利系统服务 |
+| 56 | AI动态定价系统 | - | 未覆盖 | 缺少动态定价服务 |
+| 57 | 多店铺管理闭环 | 店铺管理闭环 | 部分覆盖 | 缺少多店铺协调服务 |
+| 58 | 多租户层级管理闭环 | 层级管理闭环 | 完整覆盖 | - |
+| 59 | 首页商业化闭环 | - | 未覆盖 | 缺少首页商业化服务 |
+| 60 | 安全与风控闭环 | - | 未覆盖 | 缺少安全风控服务 |
+| 61 | 用户管理与权限系统闭环 | 权限校验闭环 | 部分覆盖 | 缺少用户管理服务 |
+| 62 | 多租户隔离闭环 | 多租户数据隔离闭环 | 完整覆盖 | - |
+| 63 | 支付与结算系统闭环 | 结算闭环 | 部分覆盖 | 缺少支付系统服务 |
+| 64 | API文档与开发者工具闭环 | - | 未覆盖 | 缺少API文档服务 |
+| 65 | 系统监控与运维闭环 | - | 未覆盖 | 缺少监控运维服务 |
+| 66 | 国际化与本地化闭环 | 多语言服务闭环, 翻译管理闭环, 多语言内容发布闭环 | 完整覆盖 | - |
+| 67 | 合规性与法律闭环 | - | 未覆盖 | 缺少合规法律服务 |
+| 68 | 技术债务管理闭环 | - | 未覆盖 | 缺少技术债务服务 |
+| 69 | 用户教育与支持闭环 | - | 未覆盖 | 缺少用户教育服务 |
+
+## 2. 服务流程覆盖分析
+
+### 已覆盖的服务流程（24个）
+1. 功能开通闭环
+2. 跨境电商闭环
+3. 多商户订单闭环
+4. 订单履约闭环
+5. 结算闭环
+6. 权限校验闭环
+7. 商户管理闭环
+8. 店铺管理闭环
+9. 商户数据与分析闭环
+10. 多商户库存同步闭环
+11. 自动选品闭环
+12. 自动上架闭环
+13. AI决策日志闭环
+14. 多租户数据隔离闭环
+15. 层级管理闭环
+16. 订单多店铺聚合闭环
+17. 订单同步闭环
+18. 异常处理闭环
+19. 多语言服务闭环
+20. 翻译管理闭环
+21. 多语言内容发布闭环
+22. 货币管理闭环
+23. 汇率更新闭环
+24. 货币转换闭环
+25. 多货币计算闭环
+
+### 未覆盖的核心业务领域
+1. **营销与广告**：广告计划与营销闭环
+2. **供应链管理**：供应链与供应商管理闭环
+3. **物流管理**：物流策略与渠道选择闭环
+4. **财务管理**：资金对账闭环、回款与财务闭环
+5. **合规与风控**：合规与证书管理闭环、合规与风控闭环
+6. **AI智能决策**：AI驱动智能决策闭环、AI店铺托管
+7. **用户体验**：客户服务闭环、用户教育与支持闭环
+
+## 3. 服务调用链分析
+
+### 完整的服务调用链
+- **订单履约闭环**：OrderService.confirm → ShipmentService.createShipment → OrderService.updateStatus → NotificationService.send
+- **多商户订单闭环**：OrderController.create → OrderService.createOrder → OrderService.splitByMerchant → InventoryService.lockStock → OrderRepository.save
+- **自动选品闭环**：ProductSelectionController.execute → ProductSelectionService.executeSelection → ProductSelectionService.calculateScore → ProductPoolRepository.save → AutoListingService.createListingTask
+
+### 服务调用链问题
+1. **缺少中间服务**：部分服务调用链直接从Controller到Repository，缺少Service层的业务逻辑处理
+2. **服务依赖不明确**：部分服务流程没有明确的依赖关系
+3. **异常处理缺失**：部分服务调用链没有包含异常处理机制
+
+## 4. 改进建议
+
+### 短期改进（1-2个月）
+1. **补全核心服务**：优先实现营销、供应链、物流、财务等核心业务领域的服务
+2. **完善服务调用链**：确保每个业务操作都有完整的服务调用流程
+3. **加强异常处理**：在服务调用链中添加异常处理机制
+
+### 中期改进（3-6个月）
+1. **服务模块化**：将大型服务拆分为更小的、可复用的服务模块
+2. **服务编排**：实现服务编排机制，支持复杂业务流程的自动化执行
+3. **服务监控**：建立服务调用监控体系，及时发现和解决服务问题
+
+### 长期改进（6个月以上）
+1. **服务治理**：建立服务治理体系，确保服务质量和可靠性
+2. **服务发现**：实现服务发现机制，支持服务的动态注册和发现
+3. **服务编排平台**：构建服务编排平台，支持复杂业务流程的可视化配置
+
+## 5. 结论
+
+当前系统已经实现了24个核心服务流程，覆盖了部分业务闭环，但仍有大量业务领域缺少对应的服务实现。建议按照优先级逐步补全缺失的服务，完善服务调用链，加强异常处理，确保业务到功能的完整闭环。
--- a/docs/ARCHIVE/08_Analysis/02_Data_Flow.md
+++ b/docs/ARCHIVE/08_Analysis/02_Data_Flow.md
@@ -0,0 +1,97 @@
+# 数据闭环分析报告
+
+## 1. 关键业务数据类型
+
+### 核心数据实体
+1. **商品数据**：商品基本信息、SKU信息、价格信息、库存信息
+2. **订单数据**：订单基本信息、订单商品信息、订单状态信息、物流信息
+3. **用户数据**：用户基本信息、权限信息、角色信息
+4. **商户数据**：商户基本信息、店铺信息、结算信息
+5. **财务数据**：交易记录、账单信息、结算信息、退款信息
+6. **物流数据**：物流渠道信息、运费信息、物流状态信息
+7. **营销数据**：广告信息、促销信息、ROI数据
+8. **合规数据**：证书信息、合规检查结果、风控信息
+
+## 2. 数据生命周期分析
+
+### 1. 商品数据生命周期
+- **输入**：数据采集、手动录入、API同步
+- **处理**：数据清洗、标准化、SKU生成、定价计算
+- **存储**：商品主数据库、SKU数据库、价格历史数据库
+- **输出**：商品列表、商品详情、上架任务、定价建议
+- **反馈**：销售数据、库存数据、退货数据
+
+### 2. 订单数据生命周期
+- **输入**：平台同步、手动录入、API回调
+- **处理**：订单审核、订单拆分、库存分配、物流选择
+- **存储**：订单主数据库、子订单数据库、订单状态历史
+- **输出**：订单列表、订单详情、物流跟踪、财务对账
+- **反馈**：支付状态、物流状态、售后状态
+
+### 3. 财务数据生命周期
+- **输入**：订单交易、支付回调、手动录入
+- **处理**：交易记录、账单生成、结算计算、退款处理
+- **存储**：交易数据库、账单数据库、结算数据库
+- **输出**：财务报表、对账结果、结算单
+- **反馈**：支付状态、商户余额、平台收入
+
+## 3. 数据流转路径分析
+
+### 核心数据流转路径
+
+#### 1. 商品刊登流程数据流转
+```
+数据采集 → 数据清洗 → 商品主数据 → SKU生成 → 定价计算 → 上架任务 → 平台同步 → 商品状态更新 → 销售数据反馈
+```
+
+#### 2. 订单履约流程数据流转
+```
+订单采集 → 订单审核 → 库存分配 → 物流选择 → 发货 → 物流跟踪 → 订单完成 → 财务对账
+```
+
+#### 3. 财务结算流程数据流转
+```
+交易记录 → 账单生成 → 结算计算 → 支付处理 → 结算完成 → 财务报表
+```
+
+## 4. 数据闭环问题
+
+1. **数据断点**：部分业务流程中存在数据流转断点，导致数据无法完整传递
+2. **数据一致性**：不同系统间的数据一致性问题，如库存数据与订单数据不同步
+3. **数据质量**：数据采集和处理过程中的数据质量问题，如重复数据、错误数据
+4. **数据安全**：数据传输和存储过程中的安全问题，如敏感数据泄露
+5. **数据治理**：缺少完善的数据治理机制，导致数据管理混乱
+
+## 5. 数据流转优化建议
+
+### 短期优化（1-2个月）
+1. **补全数据流转路径**：识别并补全数据流转断点
+2. **加强数据同步**：建立数据同步机制，确保不同系统间的数据一致性
+3. **提升数据质量**：建立数据质量检查机制，确保数据的准确性和完整性
+
+### 中期优化（3-6个月）
+1. **数据集成平台**：建立数据集成平台，统一管理数据流转
+2. **数据治理体系**：建立完善的数据治理体系，确保数据的可管理性
+3. **数据监控**：建立数据流转监控机制，及时发现和解决数据问题
+
+### 长期优化（6个月以上）
+1. **数据中台**：构建数据中台，实现数据的集中管理和共享
+2. **智能数据处理**：利用AI技术实现智能数据处理，提升数据处理效率和质量
+3. **数据价值挖掘**：通过数据分析和挖掘，发现数据的商业价值
+
+## 6. 数据安全与合规
+
+### 数据安全措施
+- ✅ 数据加密：传输和存储过程中的数据加密
+- ✅ 访问控制：基于角色的访问控制
+- ✅ 数据脱敏：敏感数据的脱敏处理
+- ✅ 审计日志：数据操作的审计日志
+
+### 数据合规要求
+- ✅ 数据隐私：符合GDPR、CCPA等数据隐私法规
+- ✅ 数据留存：符合行业数据留存要求
+- ✅ 数据跨境：符合数据跨境传输要求
+
+## 7. 结论
+
+当前系统的数据流转路径基本完整，但仍存在部分数据断点和一致性问题。建议按照优先级逐步优化数据流转路径，加强数据同步和质量控制，建立完善的数据治理体系，确保数据在业务流程中的完整流转，为业务决策提供可靠的数据支持。
--- a/docs/ARCHIVE/08_Analysis/03_Exception_Handling.md
+++ b/docs/ARCHIVE/08_Analysis/03_Exception_Handling.md
@@ -0,0 +1,89 @@
+# 异常处理分析报告
+
+## 1. 异常处理机制现状
+
+### 已实现的异常处理机制
+1. **异常处理闭环**：ExceptionController.handle → ExceptionService.process → NotificationService.alert → SettlementService.adjust
+2. **异常订单处理**：订单管理模块中的异常订单处理功能
+3. **错误边界**：前端使用React Error Boundary处理组件异常
+4. **API响应拦截**：前端API客户端的响应拦截器处理错误
+
+### 异常类型覆盖
+
+| 异常类型 | 处理机制 | 覆盖情况 | 问题 |
+|---------|---------|---------|------|
+| **系统异常** | 异常处理闭环 | 部分覆盖 | 缺少系统级异常监控 |
+| **业务异常** | 异常处理闭环 | 部分覆盖 | 缺少业务规则异常处理 |
+| **网络异常** | API响应拦截 | 部分覆盖 | 缺少网络重试机制 |
+| **数据库异常** | 异常处理闭环 | 部分覆盖 | 缺少数据库异常处理 |
+| **第三方API异常** | 异常处理闭环 | 部分覆盖 | 缺少第三方API异常处理 |
+| **权限异常** | 权限校验闭环 | 完整覆盖 | - |
+| **输入验证异常** | 前端表单验证 | 部分覆盖 | 缺少服务端输入验证 |
+
+## 2. 异常处理流程分析
+
+### 核心异常处理流程
+
+#### 1. 系统异常处理流程
+```
+异常发生 → 异常捕获 → 异常分类 → 异常处理 → 异常通知 → 异常记录
+```
+
+#### 2. 业务异常处理流程
+```
+业务规则检查 → 异常触发 → 异常处理 → 业务回滚 → 异常通知 → 异常记录
+```
+
+#### 3. 前端异常处理流程
+```
+API调用 → 异常捕获 → 错误边界处理 → 用户提示 → 异常上报
+```
+
+## 3. 异常处理问题
+
+1. **异常处理不完整**：部分异常类型缺少专门的处理机制
+2. **异常通知不及时**：部分异常没有及时的通知机制
+3. **异常记录不完整**：部分异常没有完整的记录
+4. **异常回滚不彻底**：部分业务异常没有彻底的回滚机制
+5. **异常处理性能**：异常处理可能影响系统性能
+
+## 4. 异常处理改进建议
+
+### 短期改进（1-2个月）
+1. **补全异常处理机制**：为所有异常类型建立专门的处理机制
+2. **加强异常通知**：建立及时的异常通知机制
+3. **完善异常记录**：确保所有异常都有完整的记录
+
+### 中期改进（3-6个月）
+1. **异常监控平台**：建立异常监控平台，实时监控系统异常
+2. **智能异常处理**：利用AI技术实现智能异常处理
+3. **异常预测**：利用AI技术预测可能的异常，提前做好预防
+
+### 长期改进（6个月以上）
+1. **自愈系统**：建立系统自愈机制，自动处理常见异常
+2. **异常知识库**：建立异常知识库，积累和分享异常处理经验
+3. **异常分析平台**：建立异常分析平台，分析异常模式和趋势
+
+## 5. 异常处理最佳实践
+
+### 1. 异常分类
+- **系统异常**：系统级别的错误，如服务器崩溃、网络故障
+- **业务异常**：业务规则违反，如库存不足、权限不足
+- **数据异常**：数据相关错误，如数据格式错误、数据丢失
+- **第三方异常**：第三方服务错误，如支付失败、API调用失败
+
+### 2. 异常处理原则
+- **早发现**：尽早发现异常，避免异常扩散
+- **早处理**：及时处理异常，减少异常影响
+- **早通知**：及时通知相关人员，便于及时响应
+- **早记录**：完整记录异常，便于后续分析
+
+### 3. 异常处理模式
+- **try-catch模式**：捕获和处理已知异常
+- **错误边界模式**：处理前端组件异常
+- **中间件模式**：统一处理API异常
+- **观察者模式**：监控和处理系统异常
+
+## 6. 结论
+
+当前系统已经实现了基本的异常处理机制，但仍存在异常处理不完整、通知不及时、记录不完整等问题。建议按照优先级逐步完善异常处理机制，建立异常监控平台，实现智能异常处理，确保系统在面对异常时能够稳定运行，减少异常对业务的影响。
--- a/docs/ARCHIVE/08_Analysis/04_Frontend_Business_Mapping.md
+++ b/docs/ARCHIVE/08_Analysis/04_Frontend_Business_Mapping.md
@@ -0,0 +1,161 @@
+# 前端-业务映射分析报告
+
+## 1. 前端页面覆盖分析
+
+### 已规划的前端模块（15个）
+1. **商品管理模块**：商品列表、详情、创建/编辑、审核、批量操作、动态定价、套利分析
+2. **订单管理模块**：订单列表、详情、状态流转、批量审核、统计、异常处理、聚合分析
+3. **商户管理模块**：商户列表、订单管理、结算管理、店铺管理
+4. **售后服务模块**：退货申请、退款流程、客户服务
+5. **物流管理模块**：物流选择、运费计算、物流追踪
+6. **合规管理模块**：合规检查、证书管理、证书过期提醒
+7. **黑名单管理模块**：黑名单管理、风险监控
+8. **B2B贸易模块**：企业报价、批量订单、合同管理
+9. **广告管理模块**：广告投放、ROI分析、广告计划
+10. **财务管理模块**：财务概览、交易记录、对账记录
+11. **库存管理模块**：库存概览、仓库管理、库存预测
+12. **营销管理模块**：营销概览、广告管理、竞争对手分析
+13. **供应商管理模块**：供应商列表、详情、产品管理
+14. **报表中心模块**：报表概览、利润报表、绩效报表
+15. **设置模块**：个人设置、租户设置、用户管理
+16. **A/B测试模块**：A/B测试配置、结果分析
+17. **退货管理模块**：退货监控、SKU管理
+18. **用户资产管理模块**：会员等级、积分管理、用户资产
+19. **多语言管理模块**：语言切换、翻译管理、多语言内容发布
+
+### 业务闭环覆盖分析
+
+| 业务闭环ID | 业务闭环名称 | 对应前端模块 | 覆盖情况 | 问题 |
+|---------|------------|------------|---------|------|
+| 1 | 数据采集与清洗闭环 | 商品管理模块 | 部分覆盖 | 缺少数据采集配置页面 |
+| 2 | 商品刊登闭环 | 商品管理模块 | 部分覆盖 | 缺少批量刊登页面 |
+| 3 | 素材管理闭环 | 商品管理模块 | 部分覆盖 | 缺少专门的素材管理页面 |
+| 4 | 广告计划与营销闭环 | 广告管理模块、营销管理模块 | 完整覆盖 | - |
+| 5 | 订单履约闭环 | 订单管理模块 | 完整覆盖 | - |
+| 6 | 售后逆向闭环 | 售后服务模块、退货管理模块 | 完整覆盖 | - |
+| 7 | 资金对账闭环 | 财务管理模块 | 部分覆盖 | 缺少资金对账专门页面 |
+| 8 | 库存与仓储管理闭环 | 库存管理模块 | 完整覆盖 | - |
+| 9 | 供应链与供应商管理闭环 | 供应商管理模块 | 完整覆盖 | - |
+| 10 | B2B / TOB 贸易管理闭环 | B2B贸易模块 | 完整覆盖 | - |
+| 11 | 治理与审批中心闭环 | 设置模块 | 部分覆盖 | 缺少审批中心页面 |
+| 12 | 合规与证书管理闭环 | 合规管理模块 | 完整覆盖 | - |
+| 13 | 合规与风控闭环 | 合规管理模块、黑名单管理模块 | 部分覆盖 | 缺少风控中心页面 |
+| 14 | 报表与分析闭环 | 报表中心模块 | 完整覆盖 | - |
+| 15 | 定价与利润决策闭环 | 商品管理模块、报表中心模块 | 部分覆盖 | 缺少定价策略配置页面 |
+| 16 | 账号/店铺健康度闭环 | 店铺管理模块 | 部分覆盖 | 缺少健康度监控页面 |
+| 17 | 店铺隔离与自动化闭环 | 店铺管理模块 | 部分覆盖 | 缺少隔离配置页面 |
+| 18 | 订单集中管理闭环 | 订单管理模块 | 部分覆盖 | 缺少多平台订单聚合页面 |
+| 19 | 客户/商家押金与账户管理闭环 | 财务管理模块 | 部分覆盖 | 缺少押金管理页面 |
+| 20 | 商家选择发货闭环 | 订单管理模块 | 部分覆盖 | 缺少商家发货选择页面 |
+| 21 | 回款与财务闭环 | 财务管理模块 | 部分覆盖 | 缺少回款管理页面 |
+| 22 | 海外仓/本土仓 & 多品类支持闭环 | 库存管理模块 | 部分覆盖 | 缺少仓库选择页面 |
+| 23 | 商品主数据闭环 | 商品管理模块 | 部分覆盖 | 缺少主数据管理页面 |
+| 24 | SKU变体与结构闭环 | 商品管理模块 | 部分覆盖 | 缺少SKU管理页面 |
+| 25 | 订单拆分与合并闭环 | 订单管理模块 | 部分覆盖 | 缺少订单拆分合并页面 |
+| 26 | 异常订单处理闭环 | 订单管理模块 | 完整覆盖 | - |
+| 27 | 物流策略与渠道选择闭环 | 物流管理模块 | 完整覆盖 | - |
+| 28 | 利润核算闭环 | 报表中心模块 | 部分覆盖 | 缺少利润核算专门页面 |
+| 29 | 用户/客户资产闭环 | 用户资产管理模块 | 完整覆盖 | - |
+| 30 | A/B测试与策略优化闭环 | A/B测试模块 | 完整覆盖 | - |
+| 31 | 多商户入驻与认证闭环 | 商户管理模块 | 部分覆盖 | 缺少商户认证页面 |
+| 32 | 商户店铺管理闭环 | 商户管理模块 | 完整覆盖 | - |
+| 33 | 多商户订单闭环 | 订单管理模块 | 部分覆盖 | 缺少多商户订单分配页面 |
+| 34 | 多商户库存同步闭环 | 库存管理模块 | 部分覆盖 | 缺少库存同步配置页面 |
+| 35 | 多商户结算与财务闭环 | 财务管理模块 | 部分覆盖 | 缺少商户结算页面 |
+| 36 | 商户权限与角色闭环 | 设置模块 | 部分覆盖 | 缺少角色管理页面 |
+| 37 | 商户数据与分析闭环 | 报表中心模块 | 部分覆盖 | 缺少商户分析专门页面 |
+| 38 | 异常处理闭环 | 订单管理模块 | 完整覆盖 | - |
+| 39 | 功能模块化与权限控制闭环 | 设置模块 | 部分覆盖 | 缺少功能模块管理页面 |
+| 40 | 功能开通与支付闭环 | 设置模块 | 部分覆盖 | 缺少功能开通页面 |
+| 41 | 恶意买家黑名单闭环 | 黑名单管理模块 | 完整覆盖 | - |
+| 42 | 高退货率SKU自动下架/改进建议闭环 | 退货管理模块 | 部分覆盖 | 缺少退货率分析页面 |
+| 43 | 商业化与增长闭环 | 营销管理模块 | 部分覆盖 | 缺少商业化配置页面 |
+| 44 | 服务编排与执行闭环 | - | 未覆盖 | 缺少服务编排页面 |
+| 45 | 增长飞轮闭环 | 营销管理模块 | 部分覆盖 | 缺少增长策略页面 |
+| 46 | 技术基础设施闭环 | - | 未覆盖 | 缺少基础设施管理页面 |
+| 47 | 客户服务闭环 | 售后服务模块 | 部分覆盖 | 缺少客户服务中心页面 |
+| 48 | 跨境电商闭环 | 商品管理模块 | 部分覆盖 | 缺少跨境电商专门页面 |
+| 49 | AI驱动智能决策闭环 | - | 未覆盖 | 缺少AI决策中心页面 |
+| 50 | 核心服务优先级闭环 | - | 未覆盖 | 缺少服务优先级配置页面 |
+| 51 | 多商户收益排行榜系统（信任引擎） | - | 未覆盖 | 缺少排行榜页面 |
+| 52 | 策略市场（Strategy Marketplace） | - | 未覆盖 | 缺少策略市场页面 |
+| 53 | 自动选品+自动上架系统（增长引擎） | 商品管理模块 | 部分覆盖 | 缺少自动选品配置页面 |
+| 54 | AI店铺托管（AutoPilot） | - | 未覆盖 | 缺少店铺托管页面 |
+| 55 | 跨平台套利系统 | 商品管理模块 | 部分覆盖 | 缺少套利监控页面 |
+| 56 | AI动态定价系统 | 商品管理模块 | 部分覆盖 | 缺少动态定价配置页面 |
+| 57 | 多店铺管理闭环 | 商户管理模块 | 部分覆盖 | 缺少多店铺协调页面 |
+| 58 | 多租户层级管理闭环 | 设置模块 | 部分覆盖 | 缺少层级管理页面 |
+| 59 | 首页商业化闭环 | - | 未覆盖 | 缺少首页商业化配置页面 |
+| 60 | 安全与风控闭环 | 合规管理模块 | 部分覆盖 | 缺少安全中心页面 |
+| 61 | 用户管理与权限系统闭环 | 设置模块 | 部分覆盖 | 缺少用户管理专门页面 |
+| 62 | 多租户隔离闭环 | 设置模块 | 部分覆盖 | 缺少租户隔离配置页面 |
+| 63 | 支付与结算系统闭环 | 财务管理模块 | 部分覆盖 | 缺少支付系统配置页面 |
+| 64 | API文档与开发者工具闭环 | - | 未覆盖 | 缺少API文档页面 |
+| 65 | 系统监控与运维闭环 | - | 未覆盖 | 缺少监控运维页面 |
+| 66 | 国际化与本地化闭环 | 多语言管理模块 | 完整覆盖 | - |
+| 67 | 合规性与法律闭环 | 合规管理模块 | 部分覆盖 | 缺少法律合规页面 |
+| 68 | 技术债务管理闭环 | - | 未覆盖 | 缺少技术债务页面 |
+| 69 | 用户教育与支持闭环 | - | 未覆盖 | 缺少用户教育页面 |
+
+## 2. 前端路由与权限分析
+
+### 路由结构
+- ✅ 公共路由：登录页面
+- ✅ 受保护路由：主应用布局下的所有功能页面
+- ✅ 嵌套路由：支持模块内部的子页面
+
+### 权限控制
+- ✅ 基于角色的路由访问控制
+- ✅ 支持ADMIN、MANAGER、OPERATOR、FINANCE、SOURCING、LOGISTICS、ANALYST等角色
+- ✅ 权限粒度：功能级权限控制
+
+## 3. 前端组件覆盖分析
+
+### 核心组件覆盖
+- ✅ 商品管理：ProductList、ProductDetail、ProductPublishForm、MaterialUpload
+- ✅ 订单管理：OrderList、OrderDetail、ExceptionOrder、OrderAggregation
+- ✅ 商户管理：MerchantManage、MerchantOrderManage、MerchantSettlementManage、MerchantShopManage
+- ✅ 售后服务：ReturnApply、RefundProcess、CustomerService
+- ✅ 物流管理：LogisticsSelect、FreightCalc、LogisticsTrack
+- ✅ 合规管理：ComplianceCheck、CertificateManage、CertificateExpiryReminder
+- ✅ B2B贸易：EnterpriseQuote、BatchOrder、ContractManage
+- ✅ 广告管理：AdDelivery、ROIAnalysis、AdPlanPage
+- ✅ 财务管理：Transactions、Reconciliation
+- ✅ 库存管理：Warehouses、InventoryForecast
+- ✅ 营销管理：Ads、Competitors
+- ✅ 供应商管理：SupplierDetail
+- ✅ 报表中心：ProfitReport、PerformanceReport
+- ✅ 设置：ProfileSettings、TenantSettings、UserManagement
+- ✅ A/B测试：ABTestConfig、ABTestResults
+- ✅ 退货管理：ReturnMonitor、SKUManage
+- ✅ 用户资产：MemberLevel、PointsManage、UserAssets
+- ✅ 多语言管理：LanguageSwitcher、TranslationManage、ContentPublish
+
+## 4. 前端-业务映射问题
+
+1. **页面覆盖不完整**：大量业务闭环缺少对应的前端页面
+2. **功能深度不足**：部分页面只覆盖了基础功能，缺少高级功能
+3. **用户体验不一致**：不同模块的用户体验设计不一致
+4. **权限控制粒度不够**：部分功能缺少细粒度的权限控制
+5. **响应式支持不足**：部分页面可能不支持多端适配
+
+## 5. 改进建议
+
+### 短期改进（1-2个月）
+1. **补全核心页面**：优先实现营销、供应链、物流、财务等核心业务领域的前端页面
+2. **完善页面功能**：增强现有页面的功能深度，满足业务需求
+3. **统一用户体验**：统一不同模块的用户体验设计
+
+### 中期改进（3-6个月）
+1. **响应式优化**：确保所有页面支持多端适配
+2. **性能优化**：优化前端性能，提升用户体验
+3. **组件库建设**：建立统一的组件库，提高开发效率
+
+### 长期改进（6个月以上）
+1. **微前端架构**：采用微前端架构，支持大型模块独立部署
+2. **BFF层**：引入Backend for Frontend模式，统一接口管理
+3. **智能组件**：开发集成AI能力的智能组件
+
+## 6. 结论
+
+当前系统已经规划了19个前端模块，覆盖了部分业务闭环的功能需求，但仍有大量业务领域缺少对应的前端页面。建议按照优先级逐步补全缺失的前端页面，完善页面功能，统一用户体验，确保前端页面能够完整覆盖所有业务功能。
--- a/docs/ARCHIVE/08_Analysis/05_Service_State_Mapping.md
+++ b/docs/ARCHIVE/08_Analysis/05_Service_State_Mapping.md
@@ -0,0 +1,119 @@
+# 服务-状态映射分析报告
+
+## 1. 状态机覆盖分析
+
+### 已定义的状态机（11种）
+1. **Merchant（商户）状态**：pending → active → inactive → suspended
+2. **User（用户）状态**：pending → active → inactive → locked
+3. **Store（店铺）状态**：pending → active → inactive → suspended
+4. **Feature（功能）状态**：inactive → pending_payment → active → expired → suspended
+5. **Order（订单）状态**：pending → paid → split → processing → shipped → completed → refunded → cancelled
+6. **Cross-Border E-Commerce（跨境电商）状态**：PENDING → PROCESSING → CLEARANCE → SHIPPING → DELIVERED
+7. **SubOrder（子订单）状态**：pending → processing → shipped → completed → refunded → cancelled
+8. **Product（商品）状态**：draft → pending_approval → active → inactive → discontinued
+9. **Inventory（库存）状态**：normal → low → out_of_stock → overstock
+10. **Payment（支付）状态**：created → processing → paid → failed → refunded
+11. **Bill（账单）状态**：pending → confirmed → settled → disputed
+12. **Settlement（结算）状态**：pending → processing → completed → failed
+13. **Task（任务）状态**：pending → running → success → failed → cancelled
+
+### 业务流程状态需求
+
+#### 1. 数据采集与清洗闭环
+- 状态需求：RAW_DATA → CLEANED → ANALYZED → READY_FOR_LISTING
+- 覆盖情况：未覆盖
+- 问题：缺少数据采集与清洗的状态定义
+
+#### 2. 商品刊登闭环
+- 状态需求：READY_FOR_LISTING → LISTING_IN_PROGRESS → LISTED → MONITORING → NEED_UPDATE → UPDATED
+- 覆盖情况：部分覆盖（Product状态机）
+- 问题：缺少LISTING_IN_PROGRESS、MONITORING、NEED_UPDATE状态
+
+#### 3. 素材管理闭环
+- 状态需求：UPLOADED → PROCESSING → PENDING_REVIEW → APPROVED → IN_USE → ARCHIVED/REJECTED
+- 覆盖情况：未覆盖
+- 问题：缺少素材管理的状态定义
+
+#### 4. 订单履约闭环
+- 状态需求：PULLED → PENDING_REVIEW → CONFIRMED → ALLOCATED → READY_TO_SHIP → SHIPPED → DELIVERED → CLOSED
+- 覆盖情况：部分覆盖（Order状态机）
+- 问题：缺少PULLED、PENDING_REVIEW、ALLOCATED、READY_TO_SHIP、CLOSED状态
+
+#### 5. 售后逆向闭环
+- 状态需求：REQUESTED → PROCESSING → APPROVED → REFUNDED → COMPLETED
+- 覆盖情况：未覆盖
+- 问题：缺少售后处理的状态定义
+
+#### 6. 报表与分析闭环
+- 状态需求：RAW_DATA → PROCESSED → GENERATED → DISTRIBUTED → FEEDBACK_APPLIED
+- 覆盖情况：未覆盖
+- 问题：缺少报表处理的状态定义
+
+## 2. 状态流转一致性分析
+
+### 状态变更原则
+- ✅ 所有状态变更必须通过Service
+- ✅ 禁止前端直接控制状态
+- ✅ 状态变更必须记录操作日志
+- ✅ 状态变更必须遵循预定义的流转路径
+- ✅ 状态变更可能触发相关业务逻辑
+
+### 状态触发条件
+- ✅ 商户状态：审核结果、逾期未付费、违规行为
+- ✅ 用户状态：登录异常、权限变更、账号管理
+- ✅ 店铺状态：平台审核、违规行为、商户操作
+- ✅ 功能状态：支付结果、订阅到期、手动操作
+- ✅ 订单状态：支付结果、商户操作、物流状态
+- ✅ 商品状态：审核结果、库存状态、商户操作
+- ✅ 库存状态：库存数量变化、库存同步
+- ✅ 支付状态：支付渠道反馈、人工处理
+- ✅ 账单状态：系统确认、支付结果、人工处理
+- ✅ 结算状态：系统处理、支付结果、人工处理
+- ✅ 任务状态：任务触发、执行结果、人工取消
+
+## 3. 服务-状态映射分析
+
+### 核心服务的状态使用
+
+| 服务流程 | 使用的状态机 | 状态流转是否完整 | 问题 |
+|---------|------------|----------------|------|
+| 功能开通闭环 | Feature状态 | 完整 | - |
+| 跨境电商闭环 | Cross-Border E-Commerce状态 | 完整 | - |
+| 多商户订单闭环 | Order状态 | 部分完整 | 缺少订单拆分状态 |
+| 订单履约闭环 | Order状态 | 部分完整 | 缺少履约中间状态 |
+| 结算闭环 | Settlement状态 | 完整 | - |
+| 权限校验闭环 | User状态 | 完整 | - |
+| 商户管理闭环 | Merchant状态 | 完整 | - |
+| 店铺管理闭环 | Store状态 | 完整 | - |
+| 自动选品闭环 | Task状态 | 完整 | - |
+| 自动上架闭环 | Task状态 | 完整 | - |
+| AI决策日志闭环 | Task状态 | 完整 | - |
+| 多租户数据隔离闭环 | - | 未覆盖 | 缺少租户状态 |
+
+## 4. 状态管理问题
+
+1. **状态定义不完整**：大量业务流程缺少对应的状态定义
+2. **状态流转不明确**：部分业务流程的状态流转路径未明确定义
+3. **状态触发条件缺失**：部分状态变更的触发条件未明确
+4. **状态与服务分离**：部分服务操作没有明确的状态更新逻辑
+
+## 5. 改进建议
+
+### 短期改进（1-2个月）
+1. **补全核心状态机**：优先实现数据采集、素材管理、售后处理等核心业务流程的状态定义
+2. **明确状态流转**：为每个业务流程定义完整的状态流转路径
+3. **关联状态与服务**：确保每个服务操作都有明确的状态更新逻辑
+
+### 中期改进（3-6个月）
+1. **状态机可视化**：建立状态机可视化工具，便于理解和管理状态流转
+2. **状态监控**：实现状态变更监控，及时发现和解决状态异常
+3. **状态审计**：建立状态变更审计机制，确保状态变更的可追溯性
+
+### 长期改进（6个月以上）
+1. **状态驱动设计**：采用状态驱动的设计方法，将状态作为业务逻辑的核心
+2. **状态机优化**：持续优化状态机设计，提高系统的可维护性和可扩展性
+3. **状态预测**：利用AI技术预测状态变更，提前做好业务准备
+
+## 6. 结论
+
+当前系统已经定义了13种核心实体的状态机，覆盖了部分业务流程的状态需求，但仍有大量业务流程缺少对应的状态定义。建议按照优先级逐步补全缺失的状态定义，明确状态流转路径，关联状态与服务操作，确保业务流程的状态管理完整和一致。
--- a/docs/ARCHIVE/08_Analysis/06_Runtime_Architecture.md
+++ b/docs/ARCHIVE/08_Analysis/06_Runtime_Architecture.md
@@ -0,0 +1,519 @@
+# 🌐 Runtime_Architecture.md（运行态架构 · 可落地版）
+
+---
+
+# 🎯 一、设计目标
+
+> 将系统从“接口驱动”升级为“事件驱动 + 自动运行系统”，实现业务闭环自动推进、可计费、可监控。
+
+---
+
+# 🧠 二、核心设计原则
+
+### 1️⃣ 事件驱动（Event Driven）
+
+所有业务流转必须通过事件触发，而不是手动串流程
+
+---
+
+### 2️⃣ 状态驱动（State Driven）
+
+所有实体必须由 STATE_MACHINE 控制流转
+
+---
+
+### 3️⃣ 服务编排（Service Orchestration）
+
+所有业务逻辑必须在 Service 层执行
+
+---
+
+### 4️⃣ 自动化优先（Automation First）
+
+能自动执行的流程，禁止依赖用户点击
+
+---
+
+### 5️⃣ 可计费（Billable by Design）
+
+所有关键行为必须具备计费能力
+
+---
+
+# 🧩 三、Runtime 四大核心模块
+
+---
+
+## 1️⃣ Event System（事件系统）
+
+### 🎯 作用
+
+解耦模块，实现系统自动联动
+
+---
+
+### 📌 事件结构
+
+```typescript
+interface DomainEvent {
+  id: string
+  type: string
+  payload: any
+  timestamp: number
+  source: string
+  merchantId?: string
+}
+```
+
+---
+
+### 📌 核心事件定义
+
+```typescript
+// 商品
+PRODUCT_CREATED
+PRODUCT_UPDATED
+
+// 订单
+ORDER_CREATED
+ORDER_PAID
+ORDER_COMPLETED
+
+// 库存
+INVENTORY_LOW
+INVENTORY_UPDATED
+
+// 功能
+FEATURE_ENABLED
+FEATURE_DISABLED
+
+// AI
+AI_TASK_CREATED
+AI_TASK_COMPLETED
+
+// 广告
+AD_STARTED
+AD_PERFORMANCE_UPDATED
+
+// 任务
+JOB_CREATED
+JOB_UPDATED
+JOB_COMPLETED
+
+// 计费
+BILLING_GENERATED
+```
+
+---
+
+### 📌 事件流
+
+```typescript
+Controller → Service → Emit Event → EventBus → Listener → Service
+```
+
+---
+
+### 📌 示例
+
+```typescript
+await productService.createProduct(data)
+
+eventBus.emit({
+  type: 'PRODUCT_CREATED',
+  payload: { productId },
+  source: 'ProductService',
+  merchantId: data.merchantId
+})
+```
+
+---
+
+## 2️⃣ Job / Worker System（任务系统）
+
+### 🎯 作用
+
+执行异步任务 & 自动推进系统
+
+---
+
+### 📌 任务模型
+
+```typescript
+interface Job {
+  id: string
+  type: string
+  status: 'pending' | 'running' | 'success' | 'failed'
+  payload: any
+  result?: any
+  retryCount: number
+  merchantId?: string
+  priority?: number
+}
+```
+
+---
+
+### 📌 核心任务类型
+
+```typescript
+AI_OPTIMIZE_PRODUCT
+SYNC_INVENTORY
+RUN_ADS
+CALCULATE_PROFIT
+GENERATE_BILL
+UPDATE_AD_BUDGET
+STOP_AD
+```
+
+---
+
+### 📌 执行流程
+
+```typescript
+Event → 创建 Job → Worker 消费 → 调用 Service → 更新状态 → 触发新 Event
+```
+
+---
+
+### 📌 示例
+
+```typescript
+eventBus.on('PRODUCT_CREATED', async (event) => {
+  await jobService.create({
+    type: 'AI_OPTIMIZE_PRODUCT',
+    payload: { productId: event.payload.productId },
+    merchantId: event.merchantId
+  })
+})
+```
+
+---
+
+## 3️⃣ Scheduler（调度系统）
+
+### 🎯 作用
+
+周期性驱动系统（无人值守）
+
+---
+
+### 📌 示例调度
+
+```typescript
+// 每5分钟
+syncInventory()
+
+// 每1小时
+calculateROI()
+
+// 每天
+runSettlement()
+```
+
+---
+
+### 📌 实现方式
+
+```typescript
+node-cron / bullmq / agenda
+```
+
+---
+
+### 📌 调度 → Job
+
+```typescript
+cron.schedule('*/5 * * * *', async () => {
+  await jobService.create({ type: 'SYNC_INVENTORY' })
+})
+```
+
+---
+
+## 4️⃣ State Engine（状态推进器）
+
+### 🎯 作用
+
+统一控制所有状态流转
+
+---
+
+### 📌 原则
+
+❌ Service 随意改状态
+✅ 必须通过 State Machine
+
+---
+
+### 📌 示例
+
+```typescript
+orderStateMachine.transition(order, 'PAY')
+```
+
+---
+
+### 📌 自动推进
+
+```typescript
+Worker → 调用 Service → 推动状态
+```
+
+---
+
+# 💰 四、计费系统（Billing Runtime）
+
+---
+
+## 📊 1️⃣ 计费模型
+
+```typescript
+FeatureBilling
+UsageBilling
+ResultBilling
+SubscriptionBilling
+```
+
+---
+
+## 📌 2️⃣ 使用量计费
+
+```typescript
+UsageService.track({
+  feature: 'AI_OPTIMIZE',
+  usage: 1,
+  merchantId,
+  source: 'AI'
+})
+```
+
+---
+
+## 📌 3️⃣ 账单生成
+
+```typescript
+BillingService.generateBill(merchantId)
+```
+
+---
+
+## 📌 4️⃣ 收费触发点
+
+| 行为 | 是否计费 |
+| --- | --- |
+| AI优化 | ✅ |
+| 广告投放 | ✅ |
+| 自动补货 | ✅ |
+| API调用 | ✅ |
+
+---
+
+# 🔄 五、完整运行链路（核心）
+
+---
+
+## 🎯 示例：商品自动赚钱闭环
+
+```typescript
+用户创建商品
+→ PRODUCT_CREATED
+
+→ 创建 Job（AI优化）
+→ AI_TASK_COMPLETED
+
+→ 自动上架
+→ AD_STARTED
+
+→ 产生订单
+→ ORDER_PAID
+
+→ CALCULATE_PROFIT
+
+→ GENERATE_BILL
+```
+
+---
+
+# 🎯 六、前端 Runtime 对应设计（关键）
+
+---
+
+## 1️⃣ Task Center（必须做）
+
+### 字段
+
+```typescript
+任务名称
+状态（运行中/完成/失败）
+进度
+结果
+触发来源
+```
+
+---
+
+## 2️⃣ Event Log
+
+```typescript
+时间
+事件类型
+来源
+结果
+```
+
+---
+
+## 3️⃣ Billing Timeline
+
+```typescript
+时间
+费用类型
+金额
+来源功能
+```
+
+---
+
+## 4️⃣ ROI Dashboard（核心）
+
+```typescript
+商品ID
+ROI
+点击数
+订单数
+成本
+收入
+```
+
+---
+
+# 🧱 七、Service 分层强化（必须执行）
+
+---
+
+## ❗ 强制规则
+
+```typescript
+Controller ❌ 不允许写逻辑
+Service ✅ 唯一逻辑入口
+Worker ✅ 调用 Service
+```
+
+---
+
+# 🔐 八、运行安全设计
+
+---
+
+## 必须补
+
+### 1️⃣ 幂等性
+
+```typescript
+jobId: productId + type
+```
+
+---
+
+### 2️⃣ 重试机制
+
+```typescript
+失败 → retry 3 次
+```
+
+---
+
+### 3️⃣ 日志系统
+
+```typescript
+Event Log + Job Log + Error Log
+```
+
+---
+
+# 🚀 九、实施步骤
+
+---
+
+## 1️⃣ 新建模块
+
+```bash
+/src/runtime
+  ├── eventBus.ts
+  ├── jobQueue.ts
+  ├── worker.ts
+  ├── scheduler.ts
+  ├── jobProcessor.ts
+```
+
+---
+
+## 2️⃣ 实现 BullMQ 分布式队列
+
+```bash
+/src/runtime/queue
+  ├── index.ts
+  ├── worker.ts
+  ├── processor.ts
+  ├── priority.ts
+```
+
+---
+
+## 3️⃣ 实现 WebSocket 实时推送
+
+```bash
+/src/runtime/ws
+  ├── server.ts
+  ├── client.ts
+  ├── broadcast.ts
+```
+
+---
+
+## 4️⃣ 实现计费系统
+
+```bash
+/src/services
+  ├── UsageService.ts
+  ├── BillingService.ts
+```
+
+---
+
+## 5️⃣ 实现 AI 策略系统
+
+```bash
+/src/runtime/strategy
+  ├── engine.ts
+  ├── roi.ts
+  ├── ad.ts
+```
+
+---
+
+## 6️⃣ 前端实现
+
+```bash
+/pages/TaskCenter/index.tsx
+/pages/EventLog/index.tsx
+/pages/Billing/index.tsx
+/pages/ROIDashboard/index.tsx
+```
+
+---
+
+# 🧠 最终结论
+
+你现在系统的阶段是：
+
+> ✅ 架构完成
+> ❗ Runtime 未建立
+
+---
+
+# 🔥 一句话
+
+> **没有 Runtime，你的系统只是“能用”；
+> 有 Runtime，才是“能赚钱 + 能自动跑”的系统。**