refactor(terminology): 统一术语标准并优化代码类型安全
- 将B2B统一为TOB术语 - 将状态值统一为大写格式 - 优化类型声明,避免使用any - 将float类型替换为decimal以提高精度 - 新增术语标准化文档 - 优化路由结构和菜单分类 - 添加TypeORM实体类 - 增强加密模块安全性 - 重构前端路由结构 - 完善任务模板和验收标准
This commit is contained in:
@@ -1,55 +1,25 @@
|
||||
# 📌 Crawlful Hub 业务闭环总览
|
||||
|
||||
> **说明**:本文档为业务闭环总索引,详细内容请查看各子文档。TOC(零售/前端)和 TOB(B2B贸易)共享通用模块,特有流程用 `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) | 治理与审批标准 |
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user