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,13 +1,15 @@
# 🏢 Business Blueprint (Crawlful Hub)
> **定位**Crawlful Hub 业务核心蓝图 - 包含项目目标、技术栈、核心业务模块、功能规格、状态机及行业标杆参考。
> **更新日期**: 2026-03-17
> **定位**Crawlful Hub 高层业务规划文档 - 包含项目目标、技术栈、核心业务模块概述、功能规格、状态机及行业标杆参考。
> **更新日期**: 2026-03-19
>
> **业务闭环详细实现**:请查阅 [Business_ClosedLoops.md](./Business_ClosedLoops.md)
---
## 1. 项目概述 (Project Overview)
**项目名称**: Crawlful Hub (跨境电商增长台)
**项目名称**: Crawlful Hub (跨境电商智能增长台)
**项目愿景**:
成为全球领先的跨境电商智能增长平台
@@ -22,6 +24,10 @@
- 提升跨境贸易运营效率与利差套利能力。
- 自动化80%的运营操作帮助商户平均利润提升30%。
**术语规范**:
- 业务类型:`TOC`(零售)/ `TOB`(企业)
- 模块简称PIM商品管理、OMS订单管理、WMS库存管理、FIN财务管理
**主要技术栈**:
- **语言**: TypeScript
- **前端框架**: UmiJS 4.x, Ant Design 5.x
@@ -54,21 +60,23 @@
### 3.1 商品管理 (PIM) & 跨平台套利 (Arbitrage)
- **跨平台套利雷达**: 自动识别 1688 (价格洼地) 与 Amazon/Temu/eBay (价格高地) 的利差。支持视觉寻源与多模态匹配。
- **套利净利引擎**: 统一计算口径 `售价 - 采购 - 平台费 - 物流 - 税费 - 汇率对冲 - 售后损耗 - 广告摊销`
- **风险门禁**:
- B2C: 利润率 < 20% 触发风控预警
- B2B: 利润率 < 15% 禁止报价
- **风险门禁**:
- TOC: 利润率 < 20% 触发风控预警
- TOB: 利润率 < 15% 禁止报价
- ROI < 20% 标记为高风险,< 5% 强制拦截
- **SPU/SKU 管理**: 支持独立站 (Shopify/WooCommerce) 与平台电商的多维度属性映射。
- **刊登任务**: 支持无 API 平台 (TikTok/Temu) 模拟执行与官方 API 刊登。
- **多平台商品管理**: 统一管理多平台商品,实现批量操作和跨平台库存同步。
### 3.2 订单管理 (OMS) & TOB 业务
- **多渠道归集**: 聚合平台订单与独立站 (DTC) 订单。
- **自动审单**: 地址、库存、风险验证规则引擎自动审核。
- **异常处理**: 缺货、地址异常、支付失败进入异常队列,支持人工介入。
- **批量操作**: 审核、发货、标记、打印面单。
- **TOB 报价红线**: B2B 利润率 < 15% 严禁报价,支持大宗贸易的阶梯价设置与询盘转化。
- **TOB 报价红线**: TOB 利润率 < 15% 严禁报价,支持大宗贸易的阶梯价设置与询盘转化。
- **分账引擎**: 针对 TOB 业务支持主权级信用池 (Sovereign Credit Pool) 与跨境结算审计。
- **利润核算**: 实时计算单笔订单净利,关联广告支出实现全链路 ROI 溯源。
- **一站式订单履约**: 统一处理多平台订单,提供全流程履约管理和跨平台状态同步。
### 3.3 库存与仓储 (WMS)
- **多仓协同**: 实时同步全球多仓库存,支持独立站与平台库存共享/隔离策略。
@@ -86,10 +94,11 @@
### 3.5 营销与广告 (MKT)
- **跨平台投放**: 统一管理 Facebook, Google, TikTok 广告。
- **独立站 DTC 策略**: 针对独立站流量进行全链路归因分析 (Multi-touch Attribution)。
- **独立站 TOC 策略**: 针对独立站流量进行全链路归因分析 (Multi-touch Attribution)。
- **动态优化**: 基于 ROAS 自动调整预算,监控盈亏平衡点 (Break-even ROAS)。
- **套利闭环回流**: 从选品建议到真实销量回流,持续迭代套利策略。
- **广告计划看板**: 跨平台广告投放监控与预算动态优化ROAS 实时监控、自动调价建议、亏损活动预警。
- **全渠道营销整合**: 整合多种营销渠道,实现全渠道营销管理和智能营销自动化。
### 3.6 供应链与供应商管理 (SCM)
- **供应商档案**: 信用分级、联系方式、评分管理。
@@ -102,80 +111,42 @@
### 3.7 治理与审批中心
- **通用审批中心**: 大额订单、价格变更、退款等敏感操作多级审核。
- **UI 布局**: 待办/已办统计,审批日志,核准/拒绝动作。
- **适用场景**
- TOC大额订单、价格变动、退款
- TOB大额企业订单、阶梯价审批、信用审批
---
## 6. 术语规范参考
本文档遵循 [术语标准化规范](../10_Documents_Global/TERMINOLOGY_STANDARDS.md),主要术语定义如下:
| 术语 | 说明 |
|-----|------|
| TOC | To Consumer零售业务 |
| TOB | To Business企业业务 |
| PIM | 商品管理 (Product Information Management) |
| OMS | 订单管理 (Order Management System) |
| WMS | 库存管理 (Warehouse Management System) |
| FIN | 财务管理 (Financial Management) |
| MKT | 营销管理 (Marketing Management) |
### 3.8 合规与证书管理
- **自动化合规**: 订单数据生成 CE、FDA、原产地证等电子证书。
- **信用分级**: 基于配送员履约率、争议率的信用体系。
### 3.9 套利与定价分析 (ARB / Pricing) — TOC + TOB 全链路
#### 核心定位
- 支持 **零售TOC****批发/整柜TOB** 套利分析。
- 覆盖 **从生产/采购阶段 → 拿货/整柜阶段 → 零售/平台销售阶段** 的利润分析。
- 提供 **定价推荐、ROI 模拟、利润预测和风险提示**
#### 核心功能
1. **成本与利润测算**
- **TOC**:单件商品成本 + 平台费 + 物流 + 广告 → 售价 / ROI / 利润预测
- **TOB**:整柜成本、批量采购成本、关税、物流 → 单件拆算利润、ROI
- 支持 **固定成本与浮动成本**组合计算(如汇率、运费波动、关税变化)
2. **定价推荐与模拟**
- 自动推荐售价区间以满足目标毛利率或 ROI 红线
- 支持批量调价、不同平台定价差异、整柜与零售拆算定价
- 可模拟不同库存、销量、物流方式下的利润变化
3. **套利机会发现**
- **跨平台零售套利**:基于采集价格或手动录入的成本分析价差
- **跨阶段 TOB 套利**:生产采购成本 vs 平台/批发售价,输出净利和 ROI
- **跨国家/跨仓套利**:考虑关税、仓储成本、物流方式的最优利润路径
4. **供应链阶段利润分析**
- **生产阶段**:原材料采购、工厂成本、生产周期成本
- **拿货阶段**:整柜成本、运输成本、报关费用、税费
- **零售阶段**:平台费用、广告投入、物流派送、售后成本
- 支持全链路可视化报表,显示每个环节对利润的贡献
5. **多维度分析报表**
- **商品维度**:每 SKU/整柜商品成本、售价、ROI、利润预测
- **阶段维度**:生产 → 拿货 → 零售,每阶段成本、利润占比
- **平台 / 渠道维度**:各平台毛利率、利润贡献度、风险提示
- **时间维度**:预测未来收益、库存消耗、套利机会变化
#### 业务流示意
```text
生产阶段 / 原材料采购
拿货 / 整柜阶段
套利分析模块TOB + TOC
├─ 成本测算(固定/浮动)
├─ 定价推荐 & ROI 模拟
├─ 跨平台 / 跨阶段套利机会
└─ 全链路利润分析报表
商品刊登 / 调价执行
OMS / WMS / 财务 / 营销全链路闭环
```
### 3.10 B2B / TOB 贸易管理
### 3.9 TOB 贸易管理
- **报价红线控制**: 利润率低于阈值自动拦截,支持多级审批。
- **阶梯价策略**: 采购数量触发阶梯折扣。
- **信用池**: 基于历史履约记录的结算额度与审计。
- **询盘管理**: 多渠道整合询盘,支持跟进与转化。
### 3.11 产品采集与数据分析
### 3.10 产品采集与数据分析
- **多平台采集**: Amazon, eBay, Shopee, 1688 等平台商品信息抓取。
- **数据标准化**: SKU 属性、价格、库存统一格式化。
- **分析支持**: ARB、PIM、营销调价、库存补货预测的数据基础。
### 3.12 物流策略与渠道选择
### 3.11 物流策略与渠道选择
- **物流模式管理**:
- 整柜出海 (FCL Shipping)
- 自有仓出货
@@ -183,17 +154,30 @@ OMS / WMS / 财务 / 营销全链路闭环
- 直发客户 (D2C / Dropship)
- **物流健康状态**: 多渠道实时轨迹遥测、异常节点告警 (48h+ 停留)。
### 3.13 客户管理 (CRM)
### 3.12 客户管理 (CRM)
- **客户 360 视图**: 订单历史、客诉记录与信用分级。
- **押金与账户管理**: 客户/商家押金管理、账户资产统计。
### 3.13 客户服务与沟通
- **全渠道客户沟通**: 整合多渠道客户沟通,提供智能自动化客服,实现客户精细化管理。
- **智能自动化客服**: AI自动回复常见问题智能分流与 escalate个性化回复生成24/7全天候服务。
- **团队协作管理**: 客服任务分配与管理,内部协作与知识共享,客服绩效监控。
- **客户精细化管理**: 客户画像构建,客户分层与标签,个性化服务策略。
- **跨境沟通适配**: 自动翻译功能,跨文化沟通支持,多语言客服支持。
### 3.14 快速建站与品牌化运营
- **快速建站**: 模板化网站设计,拖拽式页面编辑器,响应式布局适配,多语言支持。
- **品牌化配置**: 品牌标识与视觉设计,品牌故事与内容管理,品牌调性与风格统一。
- **功能集成**: 电商功能集成(商品展示、购物车、支付),营销工具集成(优惠券、促销活动),物流与配送配置,数据分析与报表。
- **品牌推广**: SEO优化社交媒体集成内容营销支持品牌故事传播。
---
## 4. 关键业务状态机 (State Machines)
### 4.1 订单状态机
```
PULLED → PENDING_REVIEW → CONFIRMED → ALLOCATED → READY_TO_SHIP → SHIPPED → DELIVERED → CLOSED
PENDING → PAID → SPLIT → PROCESSING → SHIPPED → COMPLETED → REFUNDED → CANCELLED
```
### 4.2 业务审核状态机
@@ -223,6 +207,7 @@ REQUESTED → PENDING_REVIEW → APPROVED → RETURN_IN_TRANSIT → QC_INSPECTIO
| **物流模式** | FCL / Own / 3PL / D2C | 全球物流路径、调拨、直发客户 |
| **审批与合规** | 内部审批 & 电子证书 | 敏感操作审核、证书生成 |
| **B2B 贸易管理** | 内部 TOB 系统 | 阶梯价、信用池、询盘管理 |
| **客户服务** | SaleSmartly | 全渠道沟通、智能自动化客服 |
---