refactor(terminology): 统一术语标准并优化代码类型安全

- 将B2B统一为TOB术语
- 将状态值统一为大写格式
- 优化类型声明,避免使用any
- 将float类型替换为decimal以提高精度
- 新增术语标准化文档
- 优化路由结构和菜单分类
- 添加TypeORM实体类
- 增强加密模块安全性
- 重构前端路由结构
- 完善任务模板和验收标准
This commit is contained in:
2026-03-20 09:43:50 +08:00
parent eafa1bbe94
commit 48a78137c5
132 changed files with 13767 additions and 2140 deletions

View File

@@ -1,55 +1,25 @@
# 📌 Crawlful Hub 业务闭环总览
> **说明**本文档为业务闭环总索引详细内容请查看各子文档。TOC零售/前端)和 TOBB2B贸易)共享通用模块,特有流程用 `businessType` 标记。
> **说明**本文档为业务闭环总索引详细内容请查看各子文档。TOC零售/前端)和 TOB企业/后端)共享通用模块,特有流程用 `businessType` 标记。
## 🧠 系统核心架构
### 系统层级
```
前端管理面板 → 后端服务 → Operation-Agent → 平台 Adapter → 外部平台
---------- 数据回传 -----------------
前端控制台 → 后端服务 → 运营代理 → 平台适配器 → 第三方平台
↓ ↑
←-------------- 数据回传 -------------
```
### 核心组件
- **前端控制台**:操作入口、状态展示、多店铺管理、数据可视化
- **后端服务**数据存储、业务逻辑、AI策略、报表系统
- **系统大脑**:全局决策、信号处理、执行编排
- **任务依赖引擎**DAG管理、自动执行、状态管理、失败重试
- **运营代理**:轻量化守护进程、核心操作、平台适配、监控能力
- **平台适配器**:模块化设计、操作封装、数据标准化、异常处理
#### 1. 前端管理面板
- **操作入口**:商品采集、上架/下架、调价、店铺管理
- **状态展示**:实时操作状态、执行日志、截图回传
- **多店铺管理**:统一面板展示,独立操作流程
- **数据可视化**销售报表、ROI分析、库存监控
#### 2. 后端服务
- **数据存储**统一接收Operation-Agent回传数据
- **业务逻辑**:服务编排、状态管理、权限控制
- **AI策略**:定价策略、选品推荐、套利分析
- **报表系统**:多维度数据分析、导出功能
#### 3. SystemOrchestrator系统大脑
- **全局决策**:资源分配、任务优先级、风险控制
- **信号层**:接收店铺、商品、财务、风控等指标
- **决策层**多目标优化生成Action建议
- **执行层**通过TaskGraph执行决策
- **反馈层**:收集执行结果,优化决策模型
#### 4. TaskGraph任务依赖引擎
- **DAG有向无环图**:任务依赖关系管理
- **自动执行**:选品 → 定价 → 上架 → 广告 → 监控
- **状态管理**pending → waiting_approval → ready → running → success/failed
- **失败重试**:异常处理、指数退避
#### 5. Operation-Agent操作代理
- **轻量化守护进程**运行在VPS/客户端
- **核心操作**:采集、上架、调价、数据回传
- **平台适配**模块化Adapter支持多平台
- **监控能力**:关键位置截图、状态心跳
- **安全边界**:只执行业务操作,禁止系统级操作
#### 6. 平台Adapter
- **模块化设计**:每个平台独立实现
- **操作封装**模拟浏览器或调用API
- **数据标准化**:统一输出格式,便于后端处理
- **异常处理**:捕获错误,触发截图回传
> **详细架构设计**:请参考 [系统架构文档](../01_Architecture/01_System.md)
---
@@ -57,15 +27,15 @@
| 业务域 | 文档 | 包含闭环 |
|--------|------|---------|
| 🛍️ 商品域 | [01_Product.md](./Business_ClosedLoops/01_Product.md) | 数据采集、商品刊登、素材管理、商品主数据、SKU变体 |
| 📦 订单域 | [02_Order.md](./Business_ClosedLoops/02_Order.md) | 订单履约、售后逆向、订单集中管理、订单拆分合并、异常订单处理 |
| 📢 营销域 | [03_Marketing.md](./Business_ClosedLoops/03_Marketing.md) | 广告计划与营销、A/B测试与策略优化 |
| 🛍️ 商品域 | [01_Product.md](./Business_ClosedLoops/01_Product.md) | 数据采集、商品刊登、素材管理、商品主数据、SKU变体、多平台商品管理 |
| 📦 订单域 | [02_Order.md](./Business_ClosedLoops/02_Order.md) | 订单履约、售后逆向、订单集中管理、订单拆分合并、异常订单处理、一站式订单履约 |
| 📢 营销域 | [03_Marketing.md](./Business_ClosedLoops/03_Marketing.md) | 广告计划与营销、A/B测试与策略优化、全渠道营销整合 |
| 💰 财务域 | [04_Finance.md](./Business_ClosedLoops/04_Finance.md) | 资金对账、回款与财务、利润核算、支付与结算 |
| 📦 库存域 | [05_Inventory.md](./Business_ClosedLoops/05_Inventory.md) | 库存与仓储管理、海外仓/本土仓 |
| 🚚 供应链域 | [06_SupplyChain.md](./Business_ClosedLoops/06_SupplyChain.md) | 供应链与供应商管理、物流策略与渠道选择 |
| 🏢 B2B贸易域 | [07_B2BTrade.md](./Business_ClosedLoops/07_B2BTrade.md) | B2B/TOB贸易管理 |
| 🏢 TOB贸易域 | [07_TOBTrade.md](./Business_ClosedLoops/07_TOBTrade.md) | TOB贸易管理 |
| 👥 商户域 | [08_Merchant.md](./Business_ClosedLoops/08_Merchant.md) | 多商户入驻、商户店铺、多商户订单、多商户库存、多商户结算、商户权限、商户数据 |
| ⚙️ 平台基础域 | [09_Platform.md](./Business_ClosedLoops/09_Platform.md) | 治理与审批、功能模块化、功能开通、用户/客户资产、客户服务、货币管理、Operation-Agent |
| ⚙️ 平台基础域 | [09_Platform.md](./Business_ClosedLoops/09_Platform.md) | 治理与审批、功能模块化、功能开通、用户/客户资产、客户服务、货币管理、运营代理Agent、全渠道客户沟通、快速建站与品牌化运营 |
| 🤖 AI与自动化域 | [10_AI_Automation.md](./Business_ClosedLoops/10_AI_Automation.md) | AI驱动智能决策、自动选品+上架、AI店铺托管、AI动态定价、跨平台套利、策略市场 |
| 🛡️ 治理与合规域 | [11_Governance.md](./Business_ClosedLoops/11_Governance.md) | 合规与证书、合规与风控、异常处理、恶意买家黑名单、高退货率SKU |
| 📈 增长与商业化域 | [12_Growth.md](./Business_ClosedLoops/12_Growth.md) | 商业化与增长、增长飞轮、多商户收益排行榜、首页商业化 |
@@ -78,9 +48,17 @@
## 🔗 闭环依赖关系
```
[Operation-Agent][数据采集][数据清洗][套利/利润评估] → [商品主数据] → [SKU变体与结构] → [商品刊登] ←→ [素材管理] → [定价与利润决策] → [广告/营销 (TOC) / 企业营销 (TOB)] → [订单履约 (OMS)] → [订单拆分与合并] → [异常订单处理] → [物流策略与渠道选择] → [库存 & WMS] ←→ [供应链 & 补货] → [售后逆向] → [资金对账] → [利润核算] → [B2B/TOB 贸易管理 (TOB)] → [用户/客户资产] → [A/B测试 & 策略优化] → [治理与审批中心] → [合规 & 证书] → [风控] → [报表 & 分析] ↺(反馈所有环节)
```
### 核心流程
1. **数据采集与处理**:运营代理 → 数据采集 → 数据清洗 → 套利/利润评估
2. **商品管理**:商品主数据 → SKU变体与结构 → 商品刊登 ←→ 素材管理
3. **营销与销售**:定价与利润决策 → 广告/营销TOC/ 企业营销TOB
4. **订单履约**订单履约OMS → 订单拆分与合并 → 异常订单处理
5. **物流与库存**:物流策略与渠道选择 → 库存 & WMS ←→ 供应链 & 补货
6. **售后与财务**:售后逆向 → 资金对账 → 利润核算
7. **TOB业务**TOB 贸易管理 → 用户/客户资产
8. **优化与治理**A/B测试 & 策略优化 → 治理与审批中心 → 合规 & 证书 → 风控 → 报表 & 分析
> **反馈机制**:报表与分析结果反馈到所有环节,持续优化业务流程
---
@@ -117,9 +95,9 @@
## 📋 业务审核状态机
- **通用审核流程**`SUBMITTED` (提交) → `PENDING_REVIEW` (人工审核) → `EXECUTED` / `REJECTED`
- **适用场景**
- TOC大额订单、价格变动、退款
- TOB大额企业订单、阶梯价审批、信用审批
- **适用场景**TOC大额订单、价格变动、退款、TOB大额企业订单、阶梯价审批、信用审批
> **详细状态机定义**:请参考 [状态机文档](../01_Architecture/06_State_Machine.md)
---
@@ -146,11 +124,11 @@
| 文档 | 路径 | 说明 |
|------|------|------|
| **Task Overview** | [Task_Overview.md](./Task_Overview.md) | AI开发任务总览包含所有任务包和状态 |
| **AI Strategy** | [../05_AI/AI_Strategy.md](../05_AI/AI_Strategy.md) | AI协作策略、节点自动决策体系、规则引擎 |
| **System Architecture** | [../01_Architecture/System_Architecture.md](../01_Architecture/System_Architecture.md) | 系统架构设计 |
| **State Machine** | [../01_Architecture/STATE_MACHINE.md](../01_Architecture/STATE_MACHINE.md) | 状态机定义 |
| **Backend Design** | [../02_Backend/Backend_Design.md](../02_Backend/Backend_Design.md) | 后端设计规范 |
| **Frontend Design** | [../03_Frontend/Frontend_Design.md](../03_Frontend/Frontend_Design.md) | 前端设计规范 |
| **AI Strategy** | [../05_AI/01_Strategy.md](../05_AI/01_Strategy.md) | AI协作策略、节点自动决策体系、规则引擎 |
| **System Architecture** | [../01_Architecture/01_System.md](../01_Architecture/01_System.md) | 系统架构设计 |
| **State Machine** | [../01_Architecture/06_State_Machine.md](../01_Architecture/06_State_Machine.md) | 状态机定义 |
| **Backend Design** | [../02_Backend/01_Design.md](../02_Backend/01_Design.md) | 后端设计规范 |
| **Frontend Design** | [../03_Frontend/01_Design.md](../03_Frontend/01_Design.md) | 前端设计规范 |
| **Governance Standards** | [./Governance_Standards.md](./Governance_Standards.md) | 治理与审批标准 |
---