Files
makemd/docs/blueprints/global-business-blueprint.md
Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
2026-03-16 01:31:26 +08:00

204 lines
8.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🌐 全球贸易 ERP 业务蓝图 (Global Business Blueprint) - V2.0
> **"务实、高效、可靠"**
> 本文档是 Crawlful Hub 的最高业务指令源,定义 ERP 核心业务能力如何落地,确保业务扩展与技术实现同频。
---
## 1. 业务-技术映射矩阵 (Business-to-Tech Mapping)
| 传统业务模块 | 行业标杆参考 | Crawlful 业务领域 | 核心功能方向 |
| :--- | :--- | :--- | :--- |
| **商品中枢 (PIM)** | 91妙手、店小秘、通途 | `Trade`, `Product` | **商品多平台刊登与库存统一管理** |
| **订单中枢 (OMS)** | 易仓、积加、船长 BI | `Trade`, `Order` | **多平台订单归集、审核与履约管理** |
| **仓储履约 (WMS)** | 易仓、Flexport、ShipStation | `Logistics`, `Warehouse` | **多仓库存管理与物流路径规划** |
| **财务清算 (FIN)** | 出海匠、易仓、积加 | `Finance`, `Billing` | **订单成本核算与利润分析** |
| **数据与营销 (MKT)** | 蝉妈妈、Koladata | `Marketing`, `Analytics` | **销售数据报表与经营分析** |
| **客户成功 (CSM)** | Zendesk、Freshdesk | `Customer`, `Service` | **售后工单管理与客户跟进** |
| **商业化计费 (BILLING)** | Stripe Billing、Chargebee | `Billing`, `Governance` | **席位/店铺配额计费与套餐管理** |
| **企业集成 (INTEGRATION)** | Okta、Zapier、MuleSoft | `Integration`, `Identity` | **SSO + Webhook + OpenAPI 企业交付** |
| **素材管理 (ASSETS)** | 剪映、BentoGrid | `Media`, `Creative` | **商品素材管理与多平台适配** |
| **全业务报表 (REPORTING)** | 船长 BI、积加、PowerBI | `Analytics`, `Finance` | **多维度经营报表与利润分析** |
| **供应商管理 (SCM)** | 1688采购、供应商管理 | `Procurement`, `Supplier` | **供应商管理与采购询价** |
---
## 2. ERP 实施路线图 (Implementation Roadmap)
### **第一阶段:核心业务闭环 (Phase 1: Foundation)**
- **目标**:实现订单、库存、财务三大核心模块的完整闭环
- **关键技术**Node.js + NestJS + MySQL + Redis + Prisma
- **核心功能**
- 多平台订单归集与管理
- 库存同步与预警
- 成本核算与利润分析
### **第二阶段:业务拓展 (Phase 2: Expansion)**
- **目标**:扩展供应商管理、售后工单、数据报表等业务模块
- **关键技术**React + UmiJS + Ant Design + TanStack Query
- **核心功能**
- 供应商管理与采购询价
- 售后工单流转
- 数据报表与分析
### **第三阶段:企业级能力 (Phase 3: Enterprise)**
- **目标**完善企业级功能包括多租户、SSO、计费、企业集成
- **关键技术**:微服务、消息队列、缓存优化
- **核心功能**
- 多租户隔离与权限管理
- 企业单点登录
- 开放 API 平台
---
## 3. 行业标杆参考库 (Market Benchmarking)
### 3.1 ERP系统类
| 标杆 | 核心优势 | 复刻重点 |
|-----|---------|---------|
| [易仓 (ECCANG)](../benchmarks/eccang-functional-breakdown.md) | OMS/WMS/TMS 一体化 | 订单履约 + 仓储管理 |
| [店小秘 (DIANXIAOMI)](../benchmarks/dianxiaomi-spec.md) | 多平台接入 | 平台连接器 |
| [积加 (JINGJIA)](../benchmarks/jingjia-spec.md) | 精品卖家 ERP | 精细化运营 |
| [通途 (TONGTU)](../benchmarks/tongtu-spec.md) | 智能刊登 | 商品发布 |
| [马帮 (MABANG)](../benchmarks/mabang-spec.md) | WMS + 供应链 | 仓储物流 |
### 3.2 TikTok 专用类
| 标杆 | 核心优势 | 复刻重点 |
|-----|---------|---------|
| [妙手 ERP (MIAOSHOU)](../benchmarks/miaoshou-tiktok-spec.md) | TikTok 运营 | TikTok 店铺管理 |
| [海鹭科技 (HAILU)](../benchmarks/hailu-tiktok-spec.md) | 达人合作 | 达人管理系统 |
| [电霸 (DIANBA)](../benchmarks/dianba-tiktok-spec.md) | 数据分析 | TikTok 数据分析 |
| [达多多 (DADAODUO)](../benchmarks/dadaoduo-tiktok-spec.md) | 选品工具 | 选品分析 |
| [乐聊 (LELIAO)](../benchmarks/leliao-tiktok-spec.md) | 客服系统 | 消息聚合 + 售后 |
### 3.3 数据分析类
| 标杆 | 核心优势 | 复刻重点 |
|-----|---------|---------|
| [船长BI (CAPTAIN BI)](../benchmarks/captain-bi-spec.md) | 商业智能 | 数据可视化 |
| [蝉妈妈 (CHANMAMA)](../benchmarks/chanmama-spec.md) | 直播数据分析 | 趋势分析 |
| [Koladata](../benchmarks/koladata-spec.md) | 红人营销 | 达人效果分析 |
---
## 4. 业务拓展路线 (Business Expansion Roadmap)
### **4.1 P0核心能力建设 (2026 Q2)**
| 模块 | 核心功能 | 优先级 |
|-----|---------|-------|
| **订单模块** | 多平台订单归集、订单审核、发货履约 | P0 |
| **库存模块** | 多仓库存管理、库存同步、预警提醒 | P0 |
| **财务模块** | 订单成本核算、利润计算、财务报表 | P0 |
| **计费模块** | 席位、店铺配额管理 | P0 |
### **4.2 P1业务扩展 (2026 Q3)**
| 模块 | 核心功能 | 优先级 |
|-----|---------|-------|
| **供应商管理** | 1688 比价、采购询价、供应商档案 | P1 |
| **售后工单** | 退货、拒付、纠纷工单统一流转 | P1 |
| **数据报表** | 销售趋势、利润分析、库存周转 | P1 |
| **素材管理** | 商品图片/视频管理与多平台适配 | P1 |
| **TikTok 运营** | TikTok 店铺接入、达人管理 | P1 |
### **4.3 P2企业级能力 (2026 Q4)**
| 模块 | 核心功能 | 优先级 |
|-----|---------|-------|
| **多租户** | 组织架构同步、租户隔离、数据权限 | P2 |
| **企业集成** | SSO 登录、Webhook 事件、OpenAPI 套件 | P2 |
| **高级计费** | 多级套餐、企业定价、增值服务 | P2 |
| **移动端** | 移动审批、移动查看、移动操作 | P2 |
---
## 5. 核心功能模块
### 5.1 订单管理 (OMS)
| 功能 | 说明 | 技术方案 |
|-----|-----|---------|
| 订单归集 | 多平台订单统一拉取 | Connector Bus |
| 订单审核 | 规则引擎自动审核 + 人工复核 | 工作流引擎 |
| 订单履约 | 发货、物流追踪 | 物流集成 |
| 异常处理 | 地址异常、库存不足处理 | 异常队列 |
### 5.2 库存管理 (WMS)
| 功能 | 说明 | 技术方案 |
|-----|-----|---------|
| 多仓管理 | 多仓库库存统一管理 | 库存服务 |
| 库存同步 | 实时同步、防止超卖 | 乐观锁 |
| 库存预警 | 安全库存提醒 | 定时任务 |
| 库存流水 | 进出库全记录 | 流水表 |
### 5.3 财务管理
| 功能 | 说明 | 技术方案 |
|-----|-----|---------|
| 成本核算 | 采购、物流、平台费用归集 | Prisma |
| 利润计算 | 订单利润实时计算 | 规则引擎 |
| 财务报表 | 利润表、成本表 | 报表引擎 |
| 回款管理 | 回款跟踪 | 财务服务 |
### 5.4 供应商管理
| 功能 | 说明 | 技术方案 |
|-----|-----|---------|
| 供应商档案 | 供应商信息管理 | 供应商库 |
| 1688 采购 | 1688 一键代采 | 1688 API |
| 采购询价 | 多供应商比价 | 询价服务 |
| 采购统计 | 成本分析、绩效统计 | 分析服务 |
### 5.5 TikTok 运营
| 功能 | 说明 | 技术方案 |
|-----|-----|---------|
| 店铺接入 | TikTok Shop 授权 | TikTok API |
| 商品刊登 | 批量发布 | 刊登服务 |
| 达人管理 | 达人库、邀约、绩效 | 达人服务 |
| 数据分析 | 销售、流量分析 | 分析服务 |
| 客服消息 | 消息聚合、自动回复 | 客服服务 |
---
## 6. 落地技术映射 (Implementation Grounding)
| 业务能力 | 核心 Service | 关键数据表 | 状态 |
| :--- | :--- | :--- | :--- |
| **多平台订单归集** | `OrderService` | `cf_order`, `cf_order_items` | 🚀 已闭环 |
| **订单分账逻辑** | `FinanceService` | `cf_transaction`, `cf_settlement` | 🚀 已实现 |
| **全口径利润审计** | `PricingService` | `cf_product_cost_snapshot` | 🚀 已实现 |
| **多平台采集** | `CrawlService` | `cf_crawl_task` | 🚀 已闭环 |
| **配额计费** | `QuotaService` | `cf_tenant_quota`, `cf_billing_plan` | ⏳ 开发中 |
| **供应商管理** | `SupplierService` | `cf_supplier` | ⏳ 开发中 |
| **售后工单** | `TicketService` | `cf_ticket` | ⏳ 开发中 |
| **数据报表** | `ReportService` | `cf_report` | ⏳ 规划中 |
---
## 7. 使用方式 (How To Use)
1. 先在**第 6 节**确定功能所属代码位置与数据表前缀
2. 在 [task-specifications.md](../governance/task-specifications.md) 查看具体接口定义与字段规格
3. 在 [collaboration-board.md](../governance/collaboration-board.md) 同步任务状态与开发进度
---
## 8. 技术栈
| 层级 | 技术方案 | 版本 |
|-----|---------|-----|
| 前端框架 | UmiJS | 4.x |
| UI 组件 | Ant Design | 5.x |
| 状态管理 | Zustand + TanStack Query | 4.x / 5.x |
| 后端框架 | NestJS | 10.x |
| ORM | Prisma | 5.x |
| 数据库 | MySQL | 8.0 |
| 缓存 | Redis | 6.0+ |
| 消息队列 | BullMQ | 最新 |
---
**规格维护者**Crawlful Hub 团队 | **当前版本**V2.0