wurenzhi
aa2cf560c6
refactor: 重构数据源工厂和类型定义，提升代码可维护性 fix: 修复类型转换和状态机文档中的错误 docs: 更新服务架构文档，添加新的服务闭环流程 test: 添加汇率服务单元测试 chore: 清理无用代码和注释，优化代码结构
3817 lines
229 KiB
Markdown
3817 lines
229 KiB
Markdown
# 🚀 Crawlful Hub 未来蓝图（Future Blueprint）
|
||
|
||
> **文档定位**: 项目战略级规划文档，定义系统未来演进方向、技术路线图、业务扩展计划
|
||
> **创建日期**: 2026-03-19
|
||
> **维护者**: AI-Architect-1
|
||
> **版本**: v2.1
|
||
|
||
---
|
||
|
||
## 📊 实现状态说明
|
||
|
||
### 图例
|
||
| 符号 | 状态 | 说明 |
|
||
|:---:|:---:|------|
|
||
| ✅ | 已实现 | 功能已完整实现，可投入使用 |
|
||
| 🔄 | 进行中 | 功能正在开发中，部分可用 |
|
||
| 📋 | 规划中 | 功能已规划，待开发 |
|
||
| 🔗 | 链路 | 上下游依赖关系 |
|
||
|
||
### 核心业务链路图
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ 核心业务上下游链路总览 │
|
||
├─────────────────────────────────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 【商品刊登链路】 │
|
||
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
||
│ │ 数据采集 │───▶│ 商品处理 │───▶│ 定价计算 │───▶│ 审核发布 │───▶│ 库存同步 │ │
|
||
│ │ ✅插件 │ │ ✅服务 │ │ ✅AI定价 │ │ 🔄人工 │ │ ✅服务 │ │
|
||
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
|
||
│ │ │ │ │ │ │
|
||
│ ▼ ▼ ▼ ▼ ▼ │
|
||
│ [1688/Amazon] [商品库] [PricingService] [审核流] [多平台库存] │
|
||
│ │
|
||
│ 【订单履约链路】 │
|
||
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
||
│ │ 订单接收 │───▶│ 订单处理 │───▶│ 物流选择 │───▶│ 发货执行 │───▶│ 售后服务 │ │
|
||
│ │ ✅同步 │ │ ✅聚合 │ │ ✅智能 │ │ ✅自动 │ │ ✅客服 │ │
|
||
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
|
||
│ │ │ │ │ │ │
|
||
│ ▼ ▼ ▼ ▼ ▼ │
|
||
│ [多平台API] [OrderService] [物流商] [AutoShip] [客服系统] │
|
||
│ │
|
||
│ 【AI决策链路】 │
|
||
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
||
│ │ 数据采集 │───▶│ AI分析 │───▶│ 决策生成 │───▶│ 人工审核 │───▶│ 自动执行 │ │
|
||
│ │ ✅实时 │ │ ✅模型 │ │ ✅日志 │ │ 🔄门禁 │ │ ✅配置 │ │
|
||
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
|
||
│ │ │ │ │ │ │
|
||
│ ▼ ▼ ▼ ▼ ▼ │
|
||
│ [EventBus] [AIService] [DecisionLog] [审核流] [AutoPilot] │
|
||
│ │
|
||
│ 【财务结算链路】 │
|
||
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
||
│ │ 交易记录 │───▶│ 利润计算 │───▶│ 对账核销 │───▶│ 账单生成 │───▶│ 结算支付 │ │
|
||
│ │ ✅记录 │ │ ✅计算 │ │ 🔄自动 │ │ ✅生成 │ │ ✅多商户 │ │
|
||
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
|
||
│ │ │ │ │ │ │
|
||
│ ▼ ▼ ▼ ▼ ▼ │
|
||
│ [Transaction] [ProfitCalc] [Reconciliation] [Billing] [Settlement] │
|
||
│ │
|
||
│ 【多租户链路】 │
|
||
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
||
│ │ 商户入驻 │───▶│ 部门管理 │───▶│ 店铺配置 │───▶│ 数据隔离 │ │
|
||
│ │ ✅注册 │ │ ✅层级 │ │ ✅多店 │ │ ✅隔离 │ │
|
||
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
|
||
│ │ │ │ │ │
|
||
│ ▼ ▼ ▼ ▼ │
|
||
│ [MerchantService] [Hierarchy] [ShopService] [DataIsolation] │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 📑 目录
|
||
|
||
### 第一部分：战略规划
|
||
1. [项目愿景与使命](#1-项目愿景与使命)
|
||
2. [当前系统现状](#2-当前系统现状)
|
||
3. [未来架构演进](#3-未来架构演进)
|
||
|
||
### 第二部分：技术规划
|
||
4. [前端发展规划](#4-前端发展规划)
|
||
5. [后端发展规划](#5-后端发展规划)
|
||
6. [业务闭环扩展计划](#6-业务闭环扩展计划)
|
||
7. [AI能力演进路线](#7-ai能力演进路线)
|
||
8. [基础设施规划](#8-基础设施规划)
|
||
|
||
### 第三部分：业务规划
|
||
9. [商业化路径](#9-商业化路径)
|
||
10. [技术债务与优化](#10-技术债务与优化)
|
||
11. [安全与合规规划](#11-安全与合规规划)
|
||
12. [团队与协作规划](#12-团队与协作规划)
|
||
13. [里程碑与时间线](#13-里程碑与时间线)
|
||
14. [风险评估与应对](#14-风险评估与应对)
|
||
|
||
### 第四部分：详细设计
|
||
15. [前端详细规划](#15-前端详细规划)
|
||
16. [后端详细规划](#16-后端详细规划)
|
||
17. [数据架构规划](#17-数据架构规划)
|
||
18. [插件生态规划](#18-插件生态规划)
|
||
19. [业务实现细节](#19-业务实现细节)
|
||
|
||
### 第五部分：运维与安全
|
||
20. [运维监控规划](#20-运维监控规划)
|
||
21. [多租户架构详细设计](#21-多租户架构详细设计)
|
||
22. [安全架构详细设计](#22-安全架构详细设计)
|
||
23. [性能优化详细方案](#23-性能优化详细方案)
|
||
|
||
### 第六部分：质量保障
|
||
24. [测试策略详细规划](#24-测试策略详细规划)
|
||
25. [部署架构详细规划](#25-部署架构详细规划)
|
||
26. [技术选型详细说明](#26-技术选型详细说明)
|
||
27. [开发规范详细说明](#27-开发规范详细说明)
|
||
28. [项目依赖清单](#28-项目依赖清单)
|
||
29. [附录](#29-附录)
|
||
|
||
---
|
||
|
||
## 1. 项目愿景与使命
|
||
|
||
### 1.1 核心愿景
|
||
|
||
**成为全球领先的跨境电商智能增长平台**
|
||
|
||
- 🎯 **一站式解决方案**: 从选品到交付的全链路自动化
|
||
- 🤖 **AI驱动决策**: 智能定价、智能选品、智能运营
|
||
- 🌍 **全球化布局**: 支持多平台、多币种、多语言
|
||
- 💰 **利润最大化**: 套利引擎 + 成本优化 + 风险控制
|
||
|
||
### 1.2 核心使命
|
||
|
||
| 使命维度 | 具体目标 | 衡量指标 |
|
||
|---------|---------|---------|
|
||
| **效率提升** | 自动化80%的运营操作 | 人工操作减少80% |
|
||
| **利润增长** | 帮助商户平均利润提升30% | 商户平均ROI提升 |
|
||
| **风险控制** | 100%风险可追溯、可预警 | 风险事件响应时间<1h |
|
||
| **生态建设** | 构建开放的平台生态 | 第三方集成数量 |
|
||
|
||
### 1.3 产品定位矩阵
|
||
|
||
```
|
||
┌─────────────────────────────────────┐
|
||
│ 企业级 SaaS │
|
||
│ (多商户、多店铺、多部门管理) │
|
||
└─────────────────────────────────────┘
|
||
│
|
||
┌─────────────────────────────┼─────────────────────────────┐
|
||
▼ ▼ ▼
|
||
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
|
||
│ TOC 零售 │ │ TOB 贸易 │ │ 独立站 DTC │
|
||
│ (Amazon/eBay) │ │ (1688/Alibaba)│ │ (Shopify/Woo) │
|
||
└───────────────┘ └───────────────┘ └───────────────┘
|
||
│ │ │
|
||
└─────────────────────────────┼─────────────────────────────┘
|
||
▼
|
||
┌─────────────────────────────────────┐
|
||
│ 智能增长引擎 │
|
||
│ (AI选品、AI定价、AI运营、AI分析) │
|
||
└─────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 2. 当前系统现状
|
||
|
||
### 2.1 已完成功能模块
|
||
|
||
#### 前端模块（Dashboard）
|
||
|
||
| 模块 | 页面数量 | 完成度 | 核心功能 | 实现状态 |
|
||
|------|---------|--------|---------|---------|
|
||
| 商品管理 | 8 | 95% | 商品列表、详情、定价、跨平台管理、AI定价、利润监控、ROI分析 | ✅ 已实现 |
|
||
| 订单管理 | 5 | 90% | 订单列表、详情、异常处理、聚合管理 | ✅ 已实现 |
|
||
| 广告管理 | 5 | 85% | 广告计划、投放、ROI分析、AI优化、自动调价 | ✅ 已实现 |
|
||
| 财务管理 | 3 | 80% | 交易记录、对账、账单 | ✅ 已实现 |
|
||
| 库存管理 | 3 | 75% | 库存列表、仓库管理、预测 | ✅ 已实现 |
|
||
| 营销管理 | 2 | 70% | 竞品分析、广告管理 | ✅ 已实现 |
|
||
| 合规管理 | 3 | 85% | 证书管理、合规检查、到期提醒 | ✅ 已实现 |
|
||
| 物流管理 | 3 | 80% | 物流选择、追踪、运费计算 | ✅ 已实现 |
|
||
| 售后服务 | 3 | 85% | 退货申请、退款处理、客服 | ✅ 已实现 |
|
||
| B2B贸易 | 3 | 80% | 企业报价、批量订单、合同管理 | ✅ 已实现 |
|
||
| 多商户管理 | 4 | 75% | 商户管理、店铺管理、订单管理、结算管理 | ✅ 已实现 |
|
||
| 独立站管理 | 6 | 70% | 站点列表、创建、配置、商品、订单、分析 | ✅ 已实现 |
|
||
| 系统设置 | 8 | 90% | 平台账号、汇率、成本模板、Win节点、用户、角色、租户、个人设置 | ✅ 已实现 |
|
||
| 任务中心 | 1 | 85% | 任务列表、状态监控 | ✅ 已实现 |
|
||
| 黑名单管理 | 2 | 80% | 黑名单管理、风险监控 | ✅ 已实现 |
|
||
| A/B测试 | 2 | 75% | 测试配置、结果展示 | ✅ 已实现 |
|
||
| 用户资产 | 3 | 80% | 用户资产、积分管理、会员等级 | ✅ 已实现 |
|
||
| 自动选品 | 1 | 70% | 选品规则、商品池 | ✅ 已实现 |
|
||
| 排行榜 | 1 | 60% | 商户收益排行 | ✅ 已实现 |
|
||
| 策略市场 | 1 | 50% | 策略浏览、购买 | 🔄 进行中 |
|
||
| AI托管 | 1 | 65% | 自动执行配置、阈值设置 | ✅ 已实现 |
|
||
| 套利监控 | 1 | 70% | 跨平台价格对比、套利机会 | ✅ 已实现 |
|
||
| AI决策日志 | 1 | 80% | 决策追溯、日志查询 | ✅ 已实现 |
|
||
| 多店铺报表 | 1 | 75% | 多店数据聚合、报表生成 | ✅ 已实现 |
|
||
|
||
#### 后端模块（Server）
|
||
|
||
| 领域 | 服务数量 | 完成度 | 核心服务 | 实现状态 |
|
||
|------|---------|--------|---------|---------|
|
||
| 商品域 | 15+ | 85% | ProductService, PricingService, ArbitrageService | ✅ 已实现 |
|
||
| 订单域 | 10+ | 80% | OrderService, FulfillmentService, ExceptionService | ✅ 已实现 |
|
||
| 财务域 | 12+ | 75% | BillingService, ReconciliationService, SettlementService | ✅ 已实现 |
|
||
| 库存域 | 8+ | 70% | InventoryService, WarehouseService, ForecastService | ✅ 已实现 |
|
||
| 营销域 | 6+ | 65% | AdService, CampaignService, ROIService | ✅ 已实现 |
|
||
| 合规域 | 5+ | 80% | ComplianceService, CertificateService | ✅ 已实现 |
|
||
| 物流域 | 5+ | 75% | LogisticsService, TrackingService | ✅ 已实现 |
|
||
| AI域 | 15+ | 60% | AIService, RecommendationService, PredictionService | 🔄 进行中 |
|
||
| 治理域 | 8+ | 70% | GovernanceService, AuditService, QuotaService | ✅ 已实现 |
|
||
| 安全域 | 10+ | 75% | SecurityService, AuthService, RBACService | ✅ 已实现 |
|
||
| 多租户域 | 5+ | 85% | HierarchyService, DataIsolationService, ShopReportAggregationService | ✅ 已实现 |
|
||
|
||
#### 已实现服务清单（200+服务）
|
||
|
||
<details>
|
||
<summary>📦 点击展开完整服务列表</summary>
|
||
|
||
**商品域服务** ✅
|
||
- `ProductService` - 商品核心管理 🔗上游: CrawlerService 🔗下游: PricingService
|
||
- `PricingService` - 定价计算 🔗上游: ProductService, CompetitorPriceService 🔗下游: OrderService
|
||
- `ArbitrageService` - 套利计算 🔗上游: PriceComparisonService 🔗下游: PricingDecisionService
|
||
- `CompetitorPriceService` - 竞品价格 🔗上游: CrawlerService 🔗下游: PricingService
|
||
- `PriceComparisonService` - 价格对比 🔗上游: CompetitorPriceService 🔗下游: ArbitrageService
|
||
- `DynamicPricingService` - 动态定价 🔗上游: PricingService 🔗下游: AutoPilotService
|
||
- `PersonalizedPricingService` - 个性化定价 🔗上游: PricingService 🔗下游: B2BTradeService
|
||
- `ProductHealthService` - 商品健康度 🔗上游: ProductService 🔗下游: AutoDelistService
|
||
- `ProductSelectionService` - 智能选品 🔗上游: TrendAnalysis 🔗下游: AutoListingService
|
||
- `SKUMappingService` - SKU映射 🔗上游: ProductService 🔗下游: InventoryService
|
||
|
||
**订单域服务** ✅
|
||
- `OrderService` - 订单核心管理 🔗上游: ProductService, PricingService 🔗下游: FulfillmentService
|
||
- `OrderAggregationService` - 订单聚合 🔗上游: MultiShopAPI 🔗下游: OrderService
|
||
- `OrderProfitService` - 订单利润 🔗上游: OrderService 🔗下游: FinanceService
|
||
- `FulfillmentConsensusService` - 履约共识 🔗上游: OrderService 🔗下游: LogisticsService
|
||
- `ExceptionAutoFixService` - 异常自动修复 🔗上游: OrderService 🔗下游: CustomerService
|
||
|
||
**财务域服务** ✅
|
||
- `FinanceService` - 财务核心 🔗上游: OrderService 🔗下游: BillingService
|
||
- `BillingService` - 账单管理 🔗上游: FinanceService 🔗下游: SettlementService
|
||
- `ReconciliationService` - 对账服务 🔗上游: FinanceService 🔗下游: BillingService
|
||
- `SettlementService` - 结算服务 🔗上游: BillingService 🔗下游: PayoutService
|
||
- `PayoutService` - 支付服务 🔗上游: SettlementService 🔗下游: MerchantSettlementService
|
||
- `MultiCurrencyFinanceService` - 多币种财务 🔗上游: FinanceService 🔗下游: CurrencyRiskService
|
||
- `CashflowService` - 现金流管理 🔗上游: FinanceService 🔗下游: CashflowForecastService
|
||
- `CashflowForecastService` - 现金流预测 🔗上游: CashflowService 🔗下游: LiquidityHedgingService
|
||
|
||
**库存域服务** ✅
|
||
- `InventoryService` - 库存核心 🔗上游: ProductService 🔗下游: OrderService
|
||
- `InventoryForecastService` - 库存预测 🔗上游: InventoryService 🔗下游: ReplenishmentService
|
||
- `InventoryDistributionService` - 库存分布 🔗上游: InventoryService 🔗下游: WarehouseService
|
||
- `ReplenishmentService` - 补货服务 🔗上游: InventoryForecastService 🔗下游: SupplierService
|
||
- `OmniStockService` - 全渠道库存 🔗上游: InventoryService 🔗下游: InventorySyncService
|
||
- `SensibleStockService` - 智能库存 🔗上游: InventoryService 🔗下游: StockPlannerService
|
||
|
||
**物流域服务** ✅
|
||
- `LogisticsService` - 物流核心 🔗上游: OrderService 🔗下游: TrackingService
|
||
- `TrackingService` - 物流追踪 🔗上游: LogisticsService 🔗下游: CustomerService
|
||
- `FreightAuditor` - 运费审计 🔗上游: LogisticsService 🔗下游: FinanceService
|
||
- `LastMileOptimizerService` - 最后一公里优化 🔗上游: LogisticsService 🔗下游: LogisticsService
|
||
- `DynamicShippingService` - 动态运费 🔗上游: LogisticsService 🔗下游: PricingService
|
||
|
||
**AI域服务** 🔄
|
||
- `AIService` - AI核心 🔗上游: AllServices 🔗下游: DecisionService
|
||
- `AIDecisionService` - AI决策 🔗上游: AIService 🔗下游: AIDecisionLogService
|
||
- `AIDecisionLogService` - 决策日志 ✅ 🔗上游: AIDecisionService 🔗下游: AuditService
|
||
- `AutoPilotService` - 自动驾驶 🔗上游: AIDecisionService 🔗下游: AutoExecutionService
|
||
- `AutoExecutionConfigService` - 自动执行配置 ✅ 🔗上游: AutoPilotService 🔗下游: AllServices
|
||
- `AgentSwarmService` - Agent集群 🔗上游: AIService 🔗下游: TaskExecution
|
||
- `ReasoningPipelineService` - 推理管道 🔗上游: AIService 🔗下游: AIDecisionService
|
||
|
||
**多租户域服务** ✅
|
||
- `HierarchyService` - 层级管理 🔗上游: MerchantService 🔗下游: DataIsolationService
|
||
- `DataIsolationService` - 数据隔离 🔗上游: HierarchyService 🔗下游: AllServices
|
||
- `MerchantService` - 商户管理 🔗上游: AuthService 🔗下游: HierarchyService
|
||
- `ShopReportAggregationService` - 店铺报表聚合 🔗上游: AllServices 🔗下游: ReportService
|
||
- `MerchantMetricsService` - 商户指标 🔗上游: AllServices 🔗下游: LeaderboardService
|
||
|
||
**合规域服务** ✅
|
||
- `ComplianceService` - 合规核心 🔗上游: AllServices 🔗下游: AuditService
|
||
- `CertificateService` - 证书管理 🔗上游: ComplianceService 🔗下游: CertificateDatabaseService
|
||
- `TaxService` - 税务服务 🔗上游: FinanceService 🔗下游: TaxReportService
|
||
- `CustomsDeclarationService` - 报关服务 🔗上游: LogisticsService 🔗下游: ComplianceService
|
||
|
||
**安全域服务** ✅
|
||
- `AuthService` - 认证服务 🔗上游: User 🔗下游: RBACService
|
||
- `RBACService` - 权限管理 🔗上游: AuthService 🔗下游: AllServices
|
||
- `EncryptionService` - 加密服务 🔗上游: AllServices 🔗下游: DataStorage
|
||
- `SecurityComplianceService` - 安全合规 🔗上游: ComplianceService 🔗下游: AuditService
|
||
|
||
**治理域服务** ✅
|
||
- `AuditService` - 审计服务 🔗上游: AllServices 🔗下游: LogAnalyticsService
|
||
- `QuotaService` - 配额管理 🔗上游: MerchantService 🔗下游: AllServices
|
||
- `ContainerQuotaService` - 容器配额 🔗上游: QuotaService 🔗下游: InfrastructureService
|
||
- `GovernanceService` - 治理核心 🔗上游: AllServices 🔗下游: AuditService
|
||
|
||
</details>
|
||
|
||
### 2.2 当前架构优势
|
||
|
||
1. **清晰的分层架构**: Controller → Service → Repository
|
||
2. **事件驱动设计**: EventBus + BullMQ 队列
|
||
3. **多租户支持**: 商户→部门→店铺三层架构
|
||
4. **状态机管理**: 统一的状态流转控制
|
||
5. **全链路追踪**: 五元组追踪体系
|
||
|
||
### 2.3 当前痛点与挑战
|
||
|
||
| 痛点 | 影响 | 优先级 |
|
||
|------|------|--------|
|
||
| AI能力未完全落地 | 自动化程度不足 | P0 |
|
||
| 多店铺数据聚合效率低 | 报表生成慢 | P1 |
|
||
| 插件稳定性待提升 | 采集成功率不稳定 | P1 |
|
||
| 移动端支持不足 | 用户体验受限 | P2 |
|
||
| 国际化不完整 | 全球化扩展受限 | P2 |
|
||
|
||
---
|
||
|
||
## 3. 未来架构演进
|
||
|
||
### 3.1 架构演进路线图
|
||
|
||
```
|
||
Phase 1 (当前) Phase 2 (2026 Q2) Phase 3 (2026 Q4) Phase 4 (2027+)
|
||
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
|
||
│ 单体应用 │ → │ 服务拆分 │ → │ 微服务架构 │ → │ 云原生架构 │
|
||
│ │ │ │ │ │ │ │
|
||
│ - 单数据库 │ │ - 领域拆分 │ │ - 独立部署 │ │ - K8s编排 │
|
||
│ - 单缓存 │ │ - 读写分离 │ │ - 服务网格 │ │ - Serverless│
|
||
│ - 单队列 │ │ - 缓存分层 │ │ - 分布式事务 │ │ - 边缘计算 │
|
||
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
|
||
```
|
||
|
||
### 3.2 目标架构图
|
||
|
||
```
|
||
┌────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ 客户端层 (Client Layer) │
|
||
├────────────────┬────────────────┬────────────────┬────────────────┬────────────────┤
|
||
│ Web Console │ Mobile App │ Chrome Ext │ API Gateway │ Webhook │
|
||
│ (React/Umi) │ (React Native)│ (Plugin) │ (Kong/APISIX) │ (Callbacks) │
|
||
└────────────────┴────────────────┴────────────────┴────────────────┴────────────────┘
|
||
│
|
||
▼
|
||
┌────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ 网关层 (Gateway Layer) │
|
||
├────────────────┬────────────────┬────────────────┬────────────────┬────────────────┤
|
||
│ 认证网关 │ 限流网关 │ 路由网关 │ 协议转换 │ 安全网关 │
|
||
│ (JWT/OAuth) │ (Rate Limit) │ (Router) │ (gRPC/REST) │ (WAF) │
|
||
└────────────────┴────────────────┴────────────────┴────────────────┴────────────────┘
|
||
│
|
||
▼
|
||
┌────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ 服务层 (Service Layer) │
|
||
├────────────────┬────────────────┬────────────────┬────────────────┬────────────────┤
|
||
│ 商品服务 │ 订单服务 │ 财务服务 │ 库存服务 │ AI服务 │
|
||
│ ProductService │ OrderService │ FinanceService │InventoryService│ AIService │
|
||
├────────────────┼────────────────┼────────────────┼────────────────┼────────────────┤
|
||
│ 营销服务 │ 物流服务 │ 合规服务 │ 治理服务 │ 分析服务 │
|
||
│ MarketingSvc │ LogisticsSvc │ ComplianceSvc │ GovernanceSvc │ AnalyticsSvc │
|
||
└────────────────┴────────────────┴────────────────┴────────────────┴────────────────┘
|
||
│
|
||
▼
|
||
┌────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ 数据层 (Data Layer) │
|
||
├────────────────┬────────────────┬────────────────┬────────────────┬────────────────┤
|
||
│ 主数据库 │ 只读副本 │ 缓存集群 │ 搜索引擎 │ 数据湖 │
|
||
│ (MySQL 8.0) │ (MySQL Read) │ (Redis) │ (Elastic) │ (S3/Iceberg) │
|
||
└────────────────┴────────────────┴────────────────┴────────────────┴────────────────┘
|
||
│
|
||
▼
|
||
┌────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ 基础设施层 (Infrastructure Layer) │
|
||
├────────────────┬────────────────┬────────────────┬────────────────┬────────────────┤
|
||
│ 消息队列 │ 任务调度 │ 监控告警 │ 日志系统 │ 配置中心 │
|
||
│ (Kafka) │ (BullMQ) │ (Prometheus) │ (ELK) │ (Consul) │
|
||
└────────────────┴────────────────┴────────────────┴────────────────┴────────────────┘
|
||
```
|
||
|
||
### 3.3 核心设计原则
|
||
|
||
| 原则 | 说明 | 实践 |
|
||
|------|------|------|
|
||
| **领域驱动设计** | 按业务领域划分服务 | Product/Order/Finance等独立域 |
|
||
| **事件溯源** | 所有状态变更通过事件记录 | EventBus + EventStore |
|
||
| **CQRS** | 读写分离，优化查询性能 | 读库 + 写库分离 |
|
||
| **最终一致性** | 异步处理，保证最终一致 | 消息队列 + 补偿机制 |
|
||
| **幂等设计** | 所有操作支持重试 | 唯一ID + 状态检查 |
|
||
|
||
---
|
||
|
||
## 4. 前端发展规划
|
||
|
||
### 4.1 技术栈演进
|
||
|
||
#### 当前技术栈
|
||
- **框架**: UmiJS 4.x + React 18
|
||
- **UI库**: Ant Design 5.x
|
||
- **状态管理**: Umi Model (基于 Redux)
|
||
- **图表**: Recharts
|
||
- **构建**: Webpack 5
|
||
|
||
#### 目标技术栈 (2026 Q4)
|
||
- **框架**: UmiJS 4.x + React 19 (或 Next.js 15)
|
||
- **UI库**: Ant Design 5.x + 自定义组件库
|
||
- **状态管理**: Zustand + TanStack Query
|
||
- **图表**: AntV G2/G6 + ECharts
|
||
- **构建**: Vite (开发) + Rspack (生产)
|
||
- **微前端**: qiankun (大型模块独立部署)
|
||
|
||
### 4.2 前端架构规划
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────┐
|
||
│ 微前端架构 │
|
||
├─────────────────────────────────────────────────────────────────┤
|
||
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
|
||
│ │ 主应用 │ │ 商品子应用 │ │ 订单子应用 │ ... │
|
||
│ │ (基座) │ │ (独立部署) │ │ (独立部署) │ │
|
||
│ └─────────────┘ └─────────────┘ └─────────────┘ │
|
||
│ │ │ │ │
|
||
│ └────────────────┼────────────────┘ │
|
||
│ ▼ │
|
||
│ ┌─────────────────────────────────────────────────────────┐ │
|
||
│ │ 共享基础设施 │ │
|
||
│ │ - 统一认证 (SSO) │ │
|
||
│ │ - 全局状态 (Zustand) │ │
|
||
│ │ - 通信桥接 (Event Bus) │ │
|
||
│ │ - 共享组件 (Component Library) │ │
|
||
│ └─────────────────────────────────────────────────────────┘ │
|
||
└─────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 4.3 页面功能扩展计划
|
||
|
||
#### 4.3.1 商品管理增强
|
||
|
||
| 功能 | 描述 | 优先级 | 预计时间 | 实现状态 | 上下游链路 |
|
||
|------|------|--------|---------|---------|-----------|
|
||
| **AI智能选品** | 基于市场趋势自动推荐商品 | P0 | 2周 | ✅ 已实现 | 🔗上游: TrendAnalysis 🔗下游: AutoListingService |
|
||
| **批量编辑增强** | 支持Excel导入导出、批量修改 | P0 | 1周 | ✅ 已实现 | 🔗上游: ProductService 🔗下游: PublishService |
|
||
| **商品变体管理** | SKU变体可视化编辑 | P1 | 1周 | ✅ 已实现 | 🔗上游: ProductService 🔗下游: InventoryService |
|
||
| **商品生命周期管理** | 新品→成长→成熟→衰退阶段管理 | P1 | 2周 | 📋 规划中 | 🔗上游: ProductHealthService 🔗下游: AutoDelistService |
|
||
| **智能定价面板** | 实时竞品价格对比、定价建议 | P0 | 2周 | ✅ 已实现 | 🔗上游: CompetitorPriceService 🔗下游: PricingService |
|
||
| **商品健康度评分** | 综合评分、优化建议 | P2 | 1周 | ✅ 已实现 | 🔗上游: ProductHealthService 🔗下游: RecommendationService |
|
||
| **3D商品展示** | 支持3D模型展示（高价值商品） | P3 | 3周 | 📋 规划中 | 🔗上游: MediaAssetService 🔗下游: Frontend |
|
||
| **AR试穿/试用** | 服装、家居类商品AR预览 | P3 | 4周 | 📋 规划中 | 🔗上游: MediaAssetService 🔗下游: Frontend |
|
||
|
||
#### 4.3.2 订单管理增强
|
||
|
||
| 功能 | 描述 | 优先级 | 预计时间 | 实现状态 | 上下游链路 |
|
||
|------|------|--------|---------|---------|-----------|
|
||
| **智能分单** | 自动分配最优仓库和物流 | P0 | 2周 | ✅ 已实现 | 🔗上游: OrderService 🔗下游: LogisticsService |
|
||
| **订单预测** | 基于历史预测订单量 | P1 | 2周 | ✅ 已实现 | 🔗上游: InventoryForecastService 🔗下游: ReplenishmentService |
|
||
| **异常预警增强** | 多维度异常检测和预警 | P0 | 1周 | ✅ 已实现 | 🔗上游: OrderService 🔗下游: ExceptionAutoFixService |
|
||
| **订单批量处理** | 批量审核、发货、打印 | P0 | 1周 | ✅ 已实现 | 🔗上游: OrderService 🔗下游: FulfillmentService |
|
||
| **客户画像集成** | 订单关联客户画像 | P1 | 2周 | ✅ 已实现 | 🔗上游: CustomerService 🔗下游: PersonalizedRecommendService |
|
||
| **订单利润分析** | 单订单利润明细 | P1 | 1周 | ✅ 已实现 | 🔗上游: OrderProfitService 🔗下游: FinanceService |
|
||
| **智能客服集成** | 订单问题自动回复 | P2 | 2周 | ✅ 已实现 | 🔗上游: CustomerServiceAgent 🔗下游: CustomerService |
|
||
| **物流可视化增强** | 实时物流地图追踪 | P2 | 2周 | ✅ 已实现 | 🔗上游: TrackingService 🔗下游: CustomerService |
|
||
|
||
#### 4.3.3 数据分析增强
|
||
|
||
| 功能 | 描述 | 优先级 | 预计时间 | 实现状态 | 上下游链路 |
|
||
|------|------|--------|---------|---------|-----------|
|
||
| **实时数据大屏** | 核心指标实时展示 | P0 | 2周 | ✅ 已实现 | 🔗上游: AnalyticsService 🔗下游: Dashboard |
|
||
| **自定义报表** | 拖拽式报表生成 | P1 | 3周 | ✅ 已实现 | 🔗上游: ReportService 🔗下游: ExportService |
|
||
| **数据导出增强** | 多格式导出、定时导出 | P1 | 1周 | ✅ 已实现 | 🔗上游: ReportService 🔗下游: NotificationService |
|
||
| **智能洞察** | AI自动发现数据异常和机会 | P1 | 2周 | ✅ 已实现 | 🔗上游: AIService 🔗下游: RecommendationService |
|
||
| **预测分析** | 销售预测、库存预测 | P2 | 2周 | ✅ 已实现 | 🔗上游: InventoryForecastService 🔗下游: ReplenishmentService |
|
||
| **竞品分析增强** | 竞品价格、销量监控 | P1 | 2周 | ✅ 已实现 | 🔗上游: CompetitorPulseService 🔗下游: PricingService |
|
||
| **归因分析** | 多触点归因分析 | P2 | 3周 | 📋 规划中 | 🔗上游: AnalyticsService 🔗下游: MarketingService |
|
||
| **数据故事** | 自动生成数据报告 | P3 | 3周 | 📋 规划中 | 🔗上游: AIService 🔗下游: ReportService |
|
||
|
||
#### 4.3.4 移动端规划
|
||
|
||
| 功能 | 描述 | 优先级 | 预计时间 | 实现状态 | 上下游链路 |
|
||
|------|------|--------|---------|---------|-----------|
|
||
| **移动端H5** | 响应式设计优化 | P1 | 2周 | ✅ 已实现 | 🔗上游: Frontend 🔗下游: MobileUsers |
|
||
| **小程序版本** | 微信/支付宝小程序 | P2 | 4周 | 📋 规划中 | 🔗上游: Frontend 🔗下游: MiniProgram |
|
||
| **原生App** | iOS/Android原生应用 | P3 | 8周 | 📋 规划中 | 🔗上游: API 🔗下游: AppStore |
|
||
| **移动端推送** | 订单、库存、异常推送 | P1 | 1周 | ✅ 已实现 | 🔗上游: NotificationService 🔗下游: PushService |
|
||
| **移动端审批** | 移动端审批流程 | P1 | 2周 | ✅ 已实现 | 🔗上游: AuditService 🔗下游: ApprovalFlow |
|
||
|
||
### 4.4 组件库规划
|
||
|
||
```
|
||
src/components/
|
||
├── common/ # 通用组件
|
||
│ ├── Button/ # 按钮组件
|
||
│ ├── Input/ # 输入组件
|
||
│ ├── Select/ # 选择器
|
||
│ ├── Table/ # 表格组件
|
||
│ ├── Form/ # 表单组件
|
||
│ ├── Modal/ # 弹窗组件
|
||
│ └── ...
|
||
├── business/ # 业务组件
|
||
│ ├── ProductCard/ # 商品卡片
|
||
│ ├── OrderCard/ # 订单卡片
|
||
│ ├── PriceTag/ # 价格标签
|
||
│ ├── StatusTag/ # 状态标签
|
||
│ ├── TrendChart/ # 趋势图表
|
||
│ └── ...
|
||
├── charts/ # 图表组件
|
||
│ ├── LineChart/ # 折线图
|
||
│ ├── BarChart/ # 柱状图
|
||
│ ├── PieChart/ # 饼图
|
||
│ ├── MapChart/ # 地图
|
||
│ ├── FunnelChart/ # 漏斗图
|
||
│ └── ...
|
||
├── layouts/ # 布局组件
|
||
│ ├── BasicLayout/ # 基础布局
|
||
│ ├── BlankLayout/ # 空白布局
|
||
│ └── ...
|
||
└── hooks/ # 通用Hooks
|
||
├── useRequest/ # 请求Hook
|
||
├── useTable/ # 表格Hook
|
||
├── useForm/ # 表单Hook
|
||
└── ...
|
||
```
|
||
|
||
### 4.5 性能优化规划
|
||
|
||
| 优化项 | 目标 | 方案 |
|
||
|--------|------|------|
|
||
| **首屏加载** | < 2s | 代码分割、预加载、SSR |
|
||
| **列表渲染** | 1000条< 1s | 虚拟列表、分页加载 |
|
||
| **图表渲染** | 10000点< 2s | 数据采样、WebGL渲染 |
|
||
| **内存占用** | < 200MB | 组件卸载、缓存清理 |
|
||
| **打包体积** | < 2MB | Tree Shaking、动态导入 |
|
||
|
||
---
|
||
|
||
## 5. 后端发展规划
|
||
|
||
### 5.1 服务拆分计划
|
||
|
||
#### 当前服务结构
|
||
```
|
||
server/src/
|
||
├── api/ # API层
|
||
│ ├── controllers/
|
||
│ └── routes/
|
||
├── core/ # 核心服务
|
||
├── domains/ # 领域服务
|
||
├── database/ # 数据库
|
||
└── config/ # 配置
|
||
```
|
||
|
||
#### 目标服务结构 (微服务)
|
||
```
|
||
services/
|
||
├── product-service/ # 商品服务
|
||
│ ├── src/
|
||
│ │ ├── controllers/
|
||
│ │ ├── services/
|
||
│ │ ├── repositories/
|
||
│ │ └── models/
|
||
│ ├── Dockerfile
|
||
│ └── package.json
|
||
├── order-service/ # 订单服务
|
||
├── finance-service/ # 财务服务
|
||
├── inventory-service/ # 库存服务
|
||
├── marketing-service/ # 营销服务
|
||
├── ai-service/ # AI服务
|
||
├── gateway-service/ # 网关服务
|
||
└── shared/ # 共享模块
|
||
├── types/
|
||
├── utils/
|
||
└── middleware/
|
||
```
|
||
|
||
### 5.2 API 设计规范
|
||
|
||
#### RESTful API 规范
|
||
|
||
```typescript
|
||
// API 路径规范
|
||
GET /api/v1/products # 获取商品列表
|
||
GET /api/v1/products/:id # 获取商品详情
|
||
POST /api/v1/products # 创建商品
|
||
PUT /api/v1/products/:id # 更新商品
|
||
DELETE /api/v1/products/:id # 删除商品
|
||
|
||
// 批量操作
|
||
POST /api/v1/products/batch # 批量创建
|
||
PUT /api/v1/products/batch # 批量更新
|
||
DELETE /api/v1/products/batch # 批量删除
|
||
|
||
// 关联资源
|
||
GET /api/v1/products/:id/orders # 获取商品关联订单
|
||
GET /api/v1/products/:id/inventory # 获取商品库存
|
||
|
||
// 统计资源
|
||
GET /api/v1/products/stats # 商品统计
|
||
GET /api/v1/products/trends # 商品趋势
|
||
```
|
||
|
||
#### GraphQL API 规划
|
||
|
||
```graphql
|
||
# 商品查询
|
||
type Product {
|
||
id: ID!
|
||
title: String!
|
||
sku: String!
|
||
price: Price!
|
||
inventory: Inventory!
|
||
orders(first: Int): [Order!]!
|
||
stats: ProductStats!
|
||
}
|
||
|
||
# 查询示例
|
||
query GetProduct($id: ID!) {
|
||
product(id: $id) {
|
||
id
|
||
title
|
||
price {
|
||
amount
|
||
currency
|
||
}
|
||
inventory {
|
||
quantity
|
||
warehouse {
|
||
name
|
||
}
|
||
}
|
||
orders(first: 10) {
|
||
id
|
||
status
|
||
total
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 5.3 数据库优化规划
|
||
|
||
#### 分库分表策略
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 数据分片策略 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 商户维度分片 (tenantId) │
|
||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||
│ │ Shard 1 │ │ Shard 2 │ │ Shard N │ │
|
||
│ │商户1-100│ │商户101-200│ │商户N... │ │
|
||
│ └─────────┘ └─────────┘ └─────────┘ │
|
||
│ │
|
||
│ 时间维度分表 (按月/季度) │
|
||
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
|
||
│ │ orders_202601│ │ orders_202602│ │ orders_202603│ │
|
||
│ └─────────────┘ └─────────────┘ └─────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
#### 索引优化策略
|
||
|
||
| 表名 | 索引类型 | 索引字段 | 说明 |
|
||
|------|---------|---------|------|
|
||
| cf_product | 主键 | id | 主键索引 |
|
||
| cf_product | 唯一 | platform, productId | 平台商品唯一 |
|
||
| cf_product | 普通 | tenantId, shopId | 租户店铺查询 |
|
||
| cf_product | 全文 | title, description | 商品搜索 |
|
||
| cf_order | 复合 | tenantId, status, createdAt | 订单列表查询 |
|
||
| cf_order | 复合 | shopId, platform, status | 店铺订单查询 |
|
||
|
||
### 5.4 缓存架构规划
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 多级缓存架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ L1: 本地缓存 (进程内) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ - 热点数据 (商品信息、配置信息) │ │
|
||
│ │ - TTL: 5-30秒 │ │
|
||
│ │ - 实现: Node-cache / LRU Cache │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ L2: 分布式缓存 (Redis Cluster) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ - 会话数据、用户信息 │ │
|
||
│ │ - 商品列表、订单列表 │ │
|
||
│ │ - TTL: 5-60分钟 │ │
|
||
│ │ - 实现: Redis Cluster (3主3从) │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ L3: CDN缓存 (边缘节点) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ - 静态资源 (JS/CSS/图片) │ │
|
||
│ │ - 公共数据 (平台列表、汇率) │ │
|
||
│ │ - TTL: 1-24小时 │ │
|
||
│ │ - 实现: CloudFlare / 阿里云CDN │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 5.5 消息队列规划
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 消息队列架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ Topic 分类 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ product.events - 商品事件 (创建/更新/删除) │ │
|
||
│ │ order.events - 订单事件 (创建/支付/发货/完成) │ │
|
||
│ │ inventory.events - 库存事件 (变动/预警) │ │
|
||
│ │ finance.events - 财务事件 (结算/对账) │ │
|
||
│ │ ai.events - AI事件 (任务/结果) │ │
|
||
│ │ system.events - 系统事件 (告警/通知) │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 消费者组 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ inventory-consumer - 库存更新消费者 │ │
|
||
│ │ notification-consumer - 通知消费者 │ │
|
||
│ │ analytics-consumer - 分析消费者 │ │
|
||
│ │ billing-consumer - 计费消费者 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 6. 业务闭环扩展计划
|
||
|
||
### 6.1 新增业务闭环规划
|
||
|
||
#### 6.1.1 智能供应链闭环
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 智能供应链闭环 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 流程: │
|
||
│ 供应商评估 → 智能询价 → 自动比价 → 采购决策 → 质量监控 │
|
||
│ │
|
||
│ 核心功能: │
|
||
│ - 供应商画像 (信用评分、产能、质量) │
|
||
│ - 智能询价 (自动发送询价单) │
|
||
│ - 比价分析 (价格、交期、质量综合评分) │
|
||
│ - 采购建议 (最优供应商推荐) │
|
||
│ - 质量追踪 (批次追溯、问题反馈) │
|
||
│ │
|
||
│ 任务ID: BE-SC001~BE-SC005, FE-SC001~FE-SC003 │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
#### 6.1.2 智能客服闭环
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 智能客服闭环 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 流程: │
|
||
│ 客户咨询 → 意图识别 → 智能回复 → 人工介入 → 满意度评价 │
|
||
│ │
|
||
│ 核心功能: │
|
||
│ - 多语言客服 (自动翻译) │
|
||
│ - 意图识别 (订单查询/售后/投诉) │
|
||
│ - 智能回复 (常见问题自动回复) │
|
||
│ - 工单流转 (复杂问题转人工) │
|
||
│ - 满意度追踪 (客服质量评估) │
|
||
│ │
|
||
│ 任务ID: BE-CS001~BE-CS005, FE-CS001~FE-CS003 │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
#### 6.1.3 智能仓储闭环
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 智能仓储闭环 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 流程: │
|
||
│ 入库预报 → 质检入库 → 库位分配 → 拣货出库 → 库存盘点 │
|
||
│ │
|
||
│ 核心功能: │
|
||
│ - 入库管理 (ASN预报、质检流程) │
|
||
│ - 库位优化 (智能推荐库位) │
|
||
│ - 拣货路径优化 (最短路径计算) │
|
||
│ - 库存盘点 (RFID/条码扫描) │
|
||
│ - 库存预警 (低库存、呆滞库存) │
|
||
│ │
|
||
│ 任务ID: BE-WH001~BE-WH005, FE-WH001~FE-WH003 │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
#### 6.1.4 跨境支付闭环
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 跨境支付闭环 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 流程: │
|
||
│ 支付发起 → 风控校验 → 汇率锁定 → 支付执行 → 对账确认 │
|
||
│ │
|
||
│ 核心功能: │
|
||
│ - 多币种支付 (主流货币支持) │
|
||
│ - 汇率管理 (实时汇率、汇率锁定) │
|
||
│ - 支付路由 (最优支付渠道选择) │
|
||
│ - 风控校验 (反欺诈、限额控制) │
|
||
│ - 对账管理 (自动对账、差异处理) │
|
||
│ │
|
||
│ 任务ID: BE-PAY001~BE-PAY005, FE-PAY001~FE-PAY003 │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
#### 6.1.5 社交电商闭环
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 社交电商闭环 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 流程: │
|
||
│ 内容创作 → 社交分发 → 用户互动 → 转化追踪 → 效果分析 │
|
||
│ │
|
||
│ 核心功能: │
|
||
│ - 内容管理 (图文/视频内容创作) │
|
||
│ - 社交分发 (多平台同步发布) │
|
||
│ - KOL管理 (达人合作、佣金结算) │
|
||
│ - 社交数据 (点赞、评论、分享追踪) │
|
||
│ - 转化归因 (社交渠道转化分析) │
|
||
│ │
|
||
│ 任务ID: BE-SC001~BE-SC005, FE-SC001~FE-SC003 │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 6.2 业务闭环优先级矩阵
|
||
|
||
```
|
||
业务价值
|
||
低 高
|
||
┌─────────────────┬─────────────────┐
|
||
高 │ │ │
|
||
│ 智能仓储 │ 智能供应链 │
|
||
实 │ (P2) │ (P0) │
|
||
施 ├─────────────────┼─────────────────┤
|
||
复 │ │ │
|
||
杂 │ 社交电商 │ 智能客服 │
|
||
度 │ (P3) │ 跨境支付(P1) │
|
||
低 │ │ │
|
||
└─────────────────┴─────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 7. AI能力演进路线
|
||
|
||
### 7.1 AI能力架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ AI能力架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 应用层 (Application Layer) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 智能选品 │ 智能定价 │ 智能客服 │ 智能分析 │ 智能运营 │ │
|
||
│ │ ✅已实现 │ ✅已实现 │ ✅已实现 │ ✅已实现 │ 🔄进行中 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 能力层 (Capability Layer) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ NLP │ CV │ 推荐 │ 预测 │ 优化 │ 决策 │ │ │
|
||
│ │ ✅ │ ✅ │ ✅ │ ✅ │ ✅ │ ✅ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 模型层 (Model Layer) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ GPT-4 │ Claude │ LLaMA │ 自研模型 │ │ │
|
||
│ │ ✅ │ ✅ │ 📋 │ 📋 │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 基础设施层 (Infrastructure Layer) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ GPU集群 │ 向量数据库 │ MLflow │ 模型服务化 │ │
|
||
│ │ 📋 │ 📋 │ 📋 │ ✅ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 7.2 AI功能规划
|
||
|
||
#### 7.2.1 智能选品 AI
|
||
|
||
| 功能 | 描述 | 技术方案 | 优先级 | 实现状态 | 上下游链路 |
|
||
|------|------|---------|--------|---------|-----------|
|
||
| **趋势预测** | 预测商品市场趋势 | 时序预测 + NLP | P0 | ✅ 已实现 | 🔗上游: CrawlerService 🔗下游: ProductSelectionService |
|
||
| **竞品分析** | 自动分析竞品策略 | 爬虫 + NLP | P0 | ✅ 已实现 | 🔗上游: CompetitorPulseService 🔗下游: PricingService |
|
||
| **利润预测** | 预测商品利润空间 | 回归模型 | P0 | ✅ 已实现 | 🔗上游: PricingService 🔗下游: ArbitrageService |
|
||
| **选品推荐** | 智能推荐潜力商品 | 推荐系统 | P1 | ✅ 已实现 | 🔗上游: ProductSelectionService 🔗下游: AutoListingService |
|
||
| **风险评估** | 评估选品风险 | 风控模型 | P1 | ✅ 已实现 | 🔗上游: RiskAssessmentService 🔗下游: BlacklistService |
|
||
|
||
#### 7.2.2 智能定价 AI
|
||
|
||
| 功能 | 描述 | 技术方案 | 优先级 | 实现状态 | 上下游链路 |
|
||
|------|------|---------|--------|---------|-----------|
|
||
| **动态定价** | 实时调整价格 | 强化学习 | P0 | ✅ 已实现 | 🔗上游: DynamicPricingService 🔗下游: AutoPilotService |
|
||
| **竞品监控** | 监控竞品价格变化 | 爬虫 + 规则 | P0 | ✅ 已实现 | 🔗上游: CompetitorPriceService 🔗下游: PriceComparisonService |
|
||
| **价格弹性** | 计算价格弹性系数 | 统计模型 | P1 | ✅ 已实现 | 🔗上游: PricingService 🔗下游: DynamicPricingService |
|
||
| **促销定价** | 促销活动定价建议 | 优化算法 | P1 | ✅ 已实现 | 🔗上游: MarketingService 🔗下游: PricingService |
|
||
| **利润优化** | 最大化利润定价 | 优化算法 | P1 | ✅ 已实现 | 🔗上游: OrderProfitService 🔗下游: PricingDecisionService |
|
||
|
||
#### 7.2.3 智能客服 AI
|
||
|
||
| 功能 | 描述 | 技术方案 | 优先级 | 实现状态 | 上下游链路 |
|
||
|------|------|---------|--------|---------|-----------|
|
||
| **意图识别** | 识别用户意图 | NLP分类 | P0 | ✅ 已实现 | 🔗上游: CustomerServiceAgent 🔗下游: AutoReturnQAService |
|
||
| **智能回复** | 自动生成回复 | LLM | P0 | ✅ 已实现 | 🔗上游: AIService 🔗下游: CustomerService |
|
||
| **情感分析** | 分析用户情绪 | NLP情感 | P1 | ✅ 已实现 | 🔗上游: SentimentAIService 🔗下游: PriorityTicketService |
|
||
| **多语言** | 多语言翻译支持 | 翻译模型 | P1 | ✅ 已实现 | 🔗上游: GlobalCSMonitor 🔗下游: CustomerService |
|
||
| **知识库** | 自动构建知识库 | RAG | P1 | 🔄 进行中 | 🔗上游: DocumentService 🔗下游: CustomerServiceAgent |
|
||
|
||
#### 7.2.4 智能分析 AI
|
||
|
||
| 功能 | 描述 | 技术方案 | 优先级 | 实现状态 | 上下游链路 |
|
||
|------|------|---------|--------|---------|-----------|
|
||
| **异常检测** | 自动发现数据异常 | 异常检测 | P0 | ✅ 已实现 | 🔗上游: AnalyticsService 🔗下游: MonitoringAlertService |
|
||
| **趋势分析** | 自动分析数据趋势 | 时序分析 | P0 | ✅ 已实现 | 🔗上游: AnalyticsService 🔗下游: ReportService |
|
||
| **归因分析** | 多维度归因分析 | 统计模型 | P1 | 📋 规划中 | 🔗上游: AnalyticsService 🔗下游: MarketingService |
|
||
| **预测分析** | 销量/库存预测 | 预测模型 | P1 | ✅ 已实现 | 🔗上游: InventoryForecastService 🔗下游: ReplenishmentService |
|
||
| **报告生成** | 自动生成分析报告 | LLM | P2 | ✅ 已实现 | 🔗上游: AIService 🔗下游: ReportService |
|
||
|
||
### 7.3 AI模型服务化
|
||
|
||
```typescript
|
||
// AI服务接口设计
|
||
interface AIService {
|
||
// 选品服务 ✅ 已实现
|
||
productSelection: {
|
||
recommend(params: SelectionParams): Promise<Product[]>; // 🔗下游: AutoListingService
|
||
predictTrend(category: string): Promise<TrendResult>; // 🔗下游: ProductSelectionService
|
||
assessRisk(productId: string): Promise<RiskAssessment>; // 🔗下游: BlacklistService
|
||
};
|
||
|
||
// 定价服务 ✅ 已实现
|
||
pricing: {
|
||
suggest(productId: string): Promise<PriceSuggestion>; // 🔗下游: PricingService
|
||
optimize(params: PricingParams): Promise<OptimizedPrice>; // 🔗下游: DynamicPricingService
|
||
monitor(productId: string): Promise<PriceMonitorResult>; // 🔗下游: CompetitorPriceService
|
||
};
|
||
|
||
// 客服服务
|
||
customerService: {
|
||
recognizeIntent(message: string): Promise<Intent>;
|
||
generateReply(context: ConversationContext): Promise<string>;
|
||
analyzeSentiment(message: string): Promise<Sentiment>;
|
||
};
|
||
|
||
// 分析服务
|
||
analytics: {
|
||
detectAnomaly(data: TimeSeriesData): Promise<Anomaly[]>;
|
||
predict(data: PredictionParams): Promise<PredictionResult>;
|
||
generateReport(params: ReportParams): Promise<Report>;
|
||
};
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 8. 基础设施规划
|
||
|
||
### 8.1 云基础设施架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 云基础设施架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ CDN Layer │ │
|
||
│ │ CloudFlare / 阿里云CDN / AWS CloudFront │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Load Balancer │ │
|
||
│ │ Nginx / ALB / Kong Gateway │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Kubernetes Cluster │ │
|
||
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
||
│ │ │ Pod 1 │ │ Pod 2 │ │ Pod N │ │ │
|
||
│ │ │ API服务 │ │ Worker │ │ AI服务 │ │ │
|
||
│ │ └─────────┘ └─────────┘ └─────────┘ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Data Layer │ │
|
||
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
||
│ │ │ MySQL │ │ Redis │ │ Kafka │ │ │
|
||
│ │ │ Cluster │ │ Cluster │ │ Cluster │ │ │
|
||
│ │ └─────────┘ └─────────┘ └─────────┘ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 8.2 监控与告警体系
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 监控与告警体系 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 指标采集 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Prometheus │ Grafana Agent │ OpenTelemetry │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 指标存储 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ VictoriaMetrics │ InfluxDB │ Thanos │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 可视化 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Grafana Dashboards │ 自定义大屏 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 告警通知 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ AlertManager │ 钉钉 │ 企业微信 │ 邮件 │ SMS │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 8.3 日志体系
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 日志体系 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 日志采集 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Filebeat │ Fluentd │ Vector │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 日志处理 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Logstash │ Kafka │ Flink │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 日志存储 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Elasticsearch │ ClickHouse │ Loki │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 日志分析 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Kibana │ Grafana Loki │ 自定义分析平台 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 8.4 CI/CD 流水线
|
||
|
||
```yaml
|
||
# .gitlab-ci.yml 示例
|
||
stages:
|
||
- lint
|
||
- test
|
||
- build
|
||
- deploy
|
||
|
||
lint:
|
||
stage: lint
|
||
script:
|
||
- npm run lint
|
||
- npm run typecheck
|
||
|
||
test:
|
||
stage: test
|
||
script:
|
||
- npm run test:unit
|
||
- npm run test:integration
|
||
coverage: '/Coverage: \d+%/'
|
||
|
||
build:
|
||
stage: build
|
||
script:
|
||
- docker build -t registry.example.com/app:$CI_COMMIT_SHA .
|
||
- docker push registry.example.com/app:$CI_COMMIT_SHA
|
||
|
||
deploy_staging:
|
||
stage: deploy
|
||
environment: staging
|
||
script:
|
||
- kubectl set image deployment/app app=registry.example.com/app:$CI_COMMIT_SHA
|
||
only:
|
||
- develop
|
||
|
||
deploy_production:
|
||
stage: deploy
|
||
environment: production
|
||
script:
|
||
- kubectl set image deployment/app app=registry.example.com/app:$CI_COMMIT_SHA
|
||
only:
|
||
- main
|
||
when: manual
|
||
```
|
||
|
||
---
|
||
|
||
## 9. 商业化路径
|
||
|
||
### 9.1 收费模式规划
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 收费模式 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 基础版 (免费) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ - 1个店铺 │ │
|
||
│ │ - 100个商品 │ │
|
||
│ │ - 基础订单管理 │ │
|
||
│ │ - 基础报表 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 专业版 ($99/月) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ - 5个店铺 │ │
|
||
│ │ - 5000个商品 │ │
|
||
│ │ - 高级订单管理 │ │
|
||
│ │ - 高级报表 │ │
|
||
│ │ - AI选品建议 │ │
|
||
│ │ - AI定价建议 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 企业版 ($299/月) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ - 无限店铺 │ │
|
||
│ │ - 无限商品 │ │
|
||
│ │ - 多商户支持 │ │
|
||
│ │ - API访问 │ │
|
||
│ │ - 专属客户经理 │ │
|
||
│ │ - 定制开发 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 增值服务 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ - AI高级功能 ($49/月) │ │
|
||
│ │ - 数据分析高级版 ($39/月) │ │
|
||
│ │ - 多仓库管理 ($29/月) │ │
|
||
│ │ - API调用量 (按量计费) │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 9.2 功能模块化收费
|
||
|
||
| 功能模块 | 基础版 | 专业版 | 企业版 |
|
||
|---------|--------|--------|--------|
|
||
| 商品管理 | ✅ | ✅ | ✅ |
|
||
| 订单管理 | ✅ | ✅ | ✅ |
|
||
| 库存管理 | ❌ | ✅ | ✅ |
|
||
| 财务管理 | 基础 | ✅ | ✅ |
|
||
| AI选品 | ❌ | ✅ | ✅ |
|
||
| AI定价 | ❌ | ✅ | ✅ |
|
||
| 多商户 | ❌ | ❌ | ✅ |
|
||
| API访问 | ❌ | ❌ | ✅ |
|
||
| 自定义报表 | ❌ | ❌ | ✅ |
|
||
| 专属支持 | ❌ | ❌ | ✅ |
|
||
|
||
### 9.3 商户增长飞轮
|
||
|
||
```
|
||
┌─────────────────┐
|
||
│ 免费入驻 │
|
||
│ (低门槛) │
|
||
└────────┬────────┘
|
||
│
|
||
▼
|
||
┌─────────────────┐
|
||
│ 价值体验 │
|
||
│ (核心功能) │
|
||
└────────┬────────┘
|
||
│
|
||
▼
|
||
┌─────────────────┐
|
||
│ 付费转化 │
|
||
│ (增值功能) │
|
||
└────────┬────────┘
|
||
│
|
||
▼
|
||
┌─────────────────┐
|
||
│ 深度使用 │
|
||
│ (AI能力) │
|
||
└────────┬────────┘
|
||
│
|
||
▼
|
||
┌─────────────────┐
|
||
│ 口碑传播 │
|
||
│ (推荐奖励) │
|
||
└────────┬────────┘
|
||
│
|
||
└──────────────────────┐
|
||
│
|
||
▼
|
||
┌─────────────────┐
|
||
│ 新商户入驻 │
|
||
└─────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 10. 技术债务与优化
|
||
|
||
### 10.1 当前技术债务清单
|
||
|
||
| 债务类型 | 描述 | 影响 | 优先级 | 预计时间 |
|
||
|---------|------|------|--------|---------|
|
||
| 类型定义不完整 | 部分模块缺少TypeScript类型 | 代码质量 | P1 | 2周 |
|
||
| 测试覆盖率低 | 单元测试覆盖率<50% | 代码质量 | P1 | 4周 |
|
||
| API文档不完整 | 部分API缺少文档 | 可维护性 | P2 | 2周 |
|
||
| 错误处理不统一 | 错误处理方式不一致 | 用户体验 | P1 | 1周 |
|
||
| 日志规范不统一 | 日志格式和级别不统一 | 可观测性 | P2 | 1周 |
|
||
| 性能优化 | 部分接口响应慢 | 用户体验 | P1 | 2周 |
|
||
| 安全加固 | 部分接口缺少权限校验 | 安全性 | P0 | 1周 |
|
||
|
||
### 10.2 代码重构计划
|
||
|
||
```
|
||
Phase 1: 类型完善 (2周)
|
||
├── 补充缺失的TypeScript类型定义
|
||
├── 启用strict模式
|
||
└── 消除any类型
|
||
|
||
Phase 2: 测试补充 (4周)
|
||
├── 单元测试覆盖率提升至80%
|
||
├── 集成测试补充
|
||
└── E2E测试补充
|
||
|
||
Phase 3: 架构优化 (4周)
|
||
├── 服务层拆分
|
||
├── 数据库优化
|
||
└── 缓存策略优化
|
||
|
||
Phase 4: 性能优化 (2周)
|
||
├── 接口响应时间优化
|
||
├── 数据库查询优化
|
||
└── 前端性能优化
|
||
```
|
||
|
||
---
|
||
|
||
## 11. 安全与合规规划
|
||
|
||
### 11.1 安全架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 安全架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 网络安全 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ WAF │ DDoS防护 │ SSL/TLS │ IP白名单 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 应用安全 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 认证授权 │ 输入验证 │ XSS防护 │ CSRF防护 │ SQL注入防护│ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 数据安全 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 数据加密 │ 数据脱敏 │ 数据备份 │ 访问控制 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 运维安全 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 审计日志 │ 安全扫描 │ 漏洞修复 │ 应急响应 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 11.2 合规认证规划
|
||
|
||
| 认证 | 描述 | 时间规划 |
|
||
|------|------|---------|
|
||
| **ISO 27001** | 信息安全管理体系 | 2026 Q3 |
|
||
| **SOC 2** | 服务组织控制报告 | 2026 Q4 |
|
||
| **GDPR** | 欧盟数据保护合规 | 2026 Q2 |
|
||
| **PCI DSS** | 支付卡行业数据安全 | 2026 Q3 |
|
||
| **等保三级** | 中国网络安全等级保护 | 2026 Q4 |
|
||
|
||
### 11.3 数据隐私保护
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 数据隐私保护 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 数据分类 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 公开数据 │ 内部数据 │ 敏感数据 │ 机密数据 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 数据处理原则 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 最小化收集 │ 目的限制 │ 存储限制 │ 准确性 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 用户权利 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 访问权 │ 更正权 │ 删除权 │ 携带权 │ 反对权 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 12. 团队与协作规划
|
||
|
||
### 12.1 团队结构规划
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 团队结构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 产品团队 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 产品经理 │ 产品设计师 │ 用户研究员 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 研发团队 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 前端工程师 │ 后端工程师 │ AI工程师 │ 测试工程师 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 运维团队 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ DevOps工程师 │ SRE工程师 │ 安全工程师 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 运营团队 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 运营经理 │ 客户成功 │ 市场营销 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 12.2 AI协作规范
|
||
|
||
| 规范项 | 说明 |
|
||
|--------|------|
|
||
| **任务领取** | 必须声明占用，避免冲突 |
|
||
| **代码规范** | 遵循项目特定规则 |
|
||
| **文档更新** | 及时更新相关文档 |
|
||
| **测试覆盖** | 新代码必须有测试 |
|
||
| **代码审查** | 通过审查才能合并 |
|
||
|
||
---
|
||
|
||
## 13. 里程碑与时间线
|
||
|
||
### 13.1 2026年路线图
|
||
|
||
```
|
||
2026 Q1 (1-3月)
|
||
├── ✅ 核心功能完善
|
||
├── ✅ 前端骨架搭建
|
||
├── ✅ 多商户基础架构
|
||
└── ✅ 基础AI能力
|
||
|
||
2026 Q2 (4-6月)
|
||
├── 📋 智能选品系统
|
||
├── 📋 智能定价系统
|
||
├── 📋 移动端H5优化
|
||
└── 📋 国际化支持
|
||
|
||
2026 Q3 (7-9月)
|
||
├── 📋 微服务拆分
|
||
├── 📋 智能客服系统
|
||
├── 📋 合规认证
|
||
└── 📋 企业版发布
|
||
|
||
2026 Q4 (10-12月)
|
||
├── 📋 云原生架构
|
||
├── 📋 小程序版本
|
||
├── 📋 开放平台
|
||
└── 📋 全球化部署
|
||
```
|
||
|
||
### 13.2 关键里程碑
|
||
|
||
| 里程碑 | 目标 | 时间 | 状态 |
|
||
|--------|------|------|------|
|
||
| M1: MVP发布 | 核心功能可用 | 2026-03 | ✅ 完成 |
|
||
| M2: 商业化启动 | 付费功能上线 | 2026-05 | 📋 计划中 |
|
||
| M3: 企业版发布 | 多商户、API开放 | 2026-08 | 📋 计划中 |
|
||
| M4: 全球化 | 多区域部署 | 2026-11 | 📋 计划中 |
|
||
| M5: 平台化 | 开放平台、生态 | 2027-Q1 | 📋 计划中 |
|
||
|
||
---
|
||
|
||
## 14. 风险评估与应对
|
||
|
||
### 14.1 技术风险
|
||
|
||
| 风险 | 概率 | 影响 | 应对措施 |
|
||
|------|------|------|---------|
|
||
| 系统性能瓶颈 | 中 | 高 | 性能测试、架构优化 |
|
||
| 数据安全事件 | 低 | 高 | 安全加固、审计日志 |
|
||
| 第三方服务故障 | 中 | 中 | 多供应商备份、降级方案 |
|
||
| 技术选型失误 | 低 | 高 | 技术评审、POC验证 |
|
||
|
||
### 14.2 业务风险
|
||
|
||
| 风险 | 概率 | 影响 | 应对措施 |
|
||
|------|------|------|---------|
|
||
| 市场竞争加剧 | 高 | 中 | 差异化功能、用户体验 |
|
||
| 商户流失 | 中 | 高 | 客户成功、价值交付 |
|
||
| 合规风险 | 中 | 高 | 合规认证、法务支持 |
|
||
| 商业模式验证失败 | 低 | 高 | 快速迭代、用户反馈 |
|
||
|
||
### 14.3 运营风险
|
||
|
||
| 风险 | 概率 | 影响 | 应对措施 |
|
||
|------|------|------|---------|
|
||
| 团队扩张过快 | 中 | 中 | 梯队建设、文化建设 |
|
||
| AI协作效率低 | 中 | 中 | 规范完善、工具支持 |
|
||
| 文档维护滞后 | 高 | 低 | 文档驱动、自动化 |
|
||
|
||
---
|
||
|
||
## 15. 前端详细规划
|
||
|
||
### 15.1 页面模块清单
|
||
|
||
#### 已完成页面（Dashboard）
|
||
|
||
| 模块 | 页面数 | 页面列表 | 完成度 |
|
||
|------|--------|---------|--------|
|
||
| **商品管理** | 8 | ProductList, ProductDetail, ProductPublishForm, MaterialUpload, CrossPlatformManage, AIPricing, ProfitMonitor, ROIAnalysis | 95% |
|
||
| **订单管理** | 5 | OrderList, OrderDetail, OrderAggregation, ExceptionOrder, Orders/index | 90% |
|
||
| **广告管理** | 6 | AdPlanPage, AdDelivery, ROIAnalysis, Performance, AIOptimization, AutoAdjustment | 85% |
|
||
| **财务管理** | 3 | Finance/index, Transactions, Reconciliation | 80% |
|
||
| **库存管理** | 3 | Inventory/index, Warehouses, InventoryForecast | 75% |
|
||
| **营销管理** | 2 | Competitors, Ads | 70% |
|
||
| **合规管理** | 3 | CertificateManage, ComplianceCheck, CertificateExpiryReminder | 85% |
|
||
| **物流管理** | 3 | LogisticsSelect, LogisticsTrack, FreightCalc | 80% |
|
||
| **售后服务** | 3 | ReturnApply, RefundProcess, CustomerService | 85% |
|
||
| **B2B贸易** | 3 | EnterpriseQuote, BatchOrder, ContractManage | 80% |
|
||
| **多商户管理** | 4 | MerchantManage, MerchantShopManage, MerchantOrderManage, MerchantSettlementManage | 75% |
|
||
| **独立站管理** | 6 | IndependentSiteList, IndependentSiteCreate, IndependentSiteConfig, IndependentSiteProduct, IndependentSiteOrder, IndependentSiteAnalytics | 70% |
|
||
| **系统设置** | 8 | PlatformAccountConfig, ExchangeRateConfig, CostTemplateConfig, WinNodeConfig, ProfileSettings, TenantSettings, UserManagement, SystemSettings | 90% |
|
||
| **任务中心** | 1 | TaskCenter/index | 85% |
|
||
| **黑名单管理** | 2 | BlacklistManage, RiskMonitor | 80% |
|
||
| **A/B测试** | 2 | ABTestConfig, ABTestResults | 75% |
|
||
| **用户资产** | 3 | UserAssets, PointsManage, MemberLevel | 80% |
|
||
| **自动选品** | 1 | AutoProductSelection/index | 70% |
|
||
| **排行榜** | 1 | Leaderboard/index | 60% |
|
||
| **策略市场** | 1 | StrategyMarketplace/index | 50% |
|
||
| **AI决策日志** | 1 | AIDecisionLog/index | 85% |
|
||
| **AI店铺托管** | 1 | AutoPilot/index | 80% |
|
||
| **自动执行配置** | 1 | AutoExecution/index | 75% |
|
||
|
||
#### 待开发页面
|
||
|
||
| 模块 | 页面 | 描述 | 优先级 |
|
||
|------|------|------|--------|
|
||
| **智能客服** | SmartCustomerService | AI客服对话界面 | P1 |
|
||
| **供应商管理** | SupplierEvaluation | 供应商评估看板 | P1 |
|
||
| **数据大屏** | DataDashboard | 实时数据可视化大屏 | P1 |
|
||
| **移动端H5** | MobilePages | 响应式移动端页面 | P2 |
|
||
| **小程序** | MiniProgram | 微信/支付宝小程序 | P2 |
|
||
|
||
### 15.2 组件库详细规划
|
||
|
||
```
|
||
dashboard/src/components/
|
||
├── common/ # 通用基础组件
|
||
│ ├── Button/
|
||
│ │ ├── index.tsx # 按钮组件
|
||
│ │ ├── ButtonGroup.tsx # 按钮组
|
||
│ │ └── IconButton.tsx # 图标按钮
|
||
│ ├── Input/
|
||
│ │ ├── index.tsx # 输入框
|
||
│ │ ├── SearchInput.tsx # 搜索框
|
||
│ │ ├── NumberInput.tsx # 数字输入
|
||
│ │ └── PriceInput.tsx # 价格输入
|
||
│ ├── Select/
|
||
│ │ ├── index.tsx # 选择器
|
||
│ │ ├── MultiSelect.tsx # 多选
|
||
│ │ ├── TreeSelect.tsx # 树选择
|
||
│ │ └── CascaderSelect.tsx # 级联选择
|
||
│ ├── Table/
|
||
│ │ ├── index.tsx # 基础表格
|
||
│ │ ├── ProTable.tsx # 高级表格
|
||
│ │ ├── VirtualTable.tsx # 虚拟滚动表格
|
||
│ │ └── EditableTable.tsx # 可编辑表格
|
||
│ ├── Form/
|
||
│ │ ├── index.tsx # 表单
|
||
│ │ ├── FormBuilder.tsx # 表单构建器
|
||
│ │ ├── FormItem.tsx # 表单项
|
||
│ │ └── FormActions.tsx # 表单操作
|
||
│ ├── Modal/
|
||
│ │ ├── index.tsx # 弹窗
|
||
│ │ ├── Drawer.tsx # 抽屉
|
||
│ │ ├── ConfirmModal.tsx # 确认弹窗
|
||
│ │ └── FormModal.tsx # 表单弹窗
|
||
│ └── ...
|
||
│
|
||
├── business/ # 业务组件
|
||
│ ├── ProductCard/ # 商品卡片
|
||
│ │ ├── index.tsx
|
||
│ │ ├── ProductImage.tsx # 商品图片
|
||
│ │ ├── ProductPrice.tsx # 商品价格
|
||
│ │ └── ProductStatus.tsx # 商品状态
|
||
│ ├── OrderCard/ # 订单卡片
|
||
│ │ ├── index.tsx
|
||
│ │ ├── OrderItems.tsx # 订单商品
|
||
│ │ ├── OrderStatus.tsx # 订单状态
|
||
│ │ └── OrderActions.tsx # 订单操作
|
||
│ ├── PriceTag/ # 价格标签
|
||
│ │ ├── index.tsx
|
||
│ │ ├── OriginalPrice.tsx # 原价
|
||
│ │ ├── SalePrice.tsx # 售价
|
||
│ │ └── ProfitMargin.tsx # 利润率
|
||
│ ├── StatusTag/ # 状态标签
|
||
│ │ ├── index.tsx
|
||
│ │ ├── OrderStatusTag.tsx # 订单状态
|
||
│ │ ├── ProductStatusTag.tsx # 商品状态
|
||
│ │ └── TaskStatusTag.tsx # 任务状态
|
||
│ ├── TrendChart/ # 趋势图表
|
||
│ │ ├── index.tsx
|
||
│ │ ├── LineTrend.tsx # 折线趋势
|
||
│ │ ├── BarTrend.tsx # 柱状趋势
|
||
│ │ └── AreaTrend.tsx # 面积趋势
|
||
│ ├── HierarchySelector/ # 层级选择器
|
||
│ │ ├── index.tsx
|
||
│ │ ├── MerchantSelector.tsx # 商户选择
|
||
│ │ ├── DepartmentSelector.tsx # 部门选择
|
||
│ │ └── ShopSelector.tsx # 店铺选择
|
||
│ └── ...
|
||
│
|
||
├── charts/ # 图表组件
|
||
│ ├── LineChart/ # 折线图
|
||
│ │ ├── index.tsx
|
||
│ │ ├── MultiLineChart.tsx # 多折线
|
||
│ │ └── SmoothLineChart.tsx # 平滑折线
|
||
│ ├── BarChart/ # 柱状图
|
||
│ │ ├── index.tsx
|
||
│ │ ├── GroupedBarChart.tsx # 分组柱状
|
||
│ │ └── StackedBarChart.tsx # 堆叠柱状
|
||
│ ├── PieChart/ # 饼图
|
||
│ │ ├── index.tsx
|
||
│ │ ├── DonutChart.tsx # 环形图
|
||
│ │ └── RoseChart.tsx # 玫瑰图
|
||
│ ├── MapChart/ # 地图
|
||
│ │ ├── index.tsx
|
||
│ │ ├── ChinaMap.tsx # 中国地图
|
||
│ │ └── WorldMap.tsx # 世界地图
|
||
│ ├── FunnelChart/ # 漏斗图
|
||
│ ├── RadarChart/ # 雷达图
|
||
│ ├── GaugeChart/ # 仪表盘
|
||
│ └── SankeyChart/ # 桑基图
|
||
│
|
||
├── layouts/ # 布局组件
|
||
│ ├── BasicLayout/ # 基础布局
|
||
│ │ ├── index.tsx
|
||
│ │ ├── Sidebar.tsx # 侧边栏
|
||
│ │ ├── Header.tsx # 顶部栏
|
||
│ │ └── Content.tsx # 内容区
|
||
│ ├── BlankLayout/ # 空白布局
|
||
│ └── MobileLayout/ # 移动端布局
|
||
│
|
||
└── hooks/ # 通用Hooks
|
||
├── useRequest/ # 请求Hook
|
||
│ ├── index.ts
|
||
│ ├── usePagination.ts # 分页请求
|
||
│ └── useInfiniteScroll.ts # 无限滚动
|
||
├── useTable/ # 表格Hook
|
||
│ ├── index.ts
|
||
│ ├── useTableSelection.ts # 表格选择
|
||
│ └── useTableSort.ts # 表格排序
|
||
├── useForm/ # 表单Hook
|
||
│ ├── index.ts
|
||
│ ├── useFormValidation.ts # 表单验证
|
||
│ └── useFormSubmit.ts # 表单提交
|
||
├── useModal/ # 弹窗Hook
|
||
├── useLocalStorage/ # 本地存储Hook
|
||
└── useWebSocket/ # WebSocket Hook
|
||
```
|
||
|
||
### 15.3 状态管理架构
|
||
|
||
```typescript
|
||
// 全局状态结构
|
||
interface GlobalState {
|
||
// 用户状态
|
||
user: {
|
||
currentUser: User | null;
|
||
permissions: string[];
|
||
roles: string[];
|
||
merchant: Merchant | null;
|
||
};
|
||
|
||
// 层级状态
|
||
hierarchy: {
|
||
currentMerchant: string | null;
|
||
currentDepartment: string | null;
|
||
currentShop: string | null;
|
||
hierarchyTree: HierarchyNode[];
|
||
};
|
||
|
||
// UI状态
|
||
ui: {
|
||
sidebarCollapsed: boolean;
|
||
theme: 'light' | 'dark';
|
||
locale: string;
|
||
};
|
||
|
||
// 通知状态
|
||
notifications: {
|
||
unreadCount: number;
|
||
list: Notification[];
|
||
};
|
||
}
|
||
|
||
// 模块状态示例 - 商品模块
|
||
interface ProductState {
|
||
list: Product[];
|
||
current: Product | null;
|
||
filters: ProductFilters;
|
||
pagination: Pagination;
|
||
loading: boolean;
|
||
}
|
||
|
||
// 模块状态示例 - 订单模块
|
||
interface OrderState {
|
||
list: Order[];
|
||
current: Order | null;
|
||
filters: OrderFilters;
|
||
pagination: Pagination;
|
||
loading: boolean;
|
||
selectedRows: string[];
|
||
}
|
||
```
|
||
|
||
### 15.4 路由配置详细规划
|
||
|
||
```typescript
|
||
// 路由配置
|
||
const routes: RouteObject[] = [
|
||
{
|
||
path: '/',
|
||
element: <BasicLayout />,
|
||
children: [
|
||
// 工作台
|
||
{ path: '', element: <Dashboard /> },
|
||
{ path: 'dashboard', element: <Dashboard /> },
|
||
|
||
// 商品中心
|
||
{
|
||
path: 'products',
|
||
children: [
|
||
{ path: '', element: <ProductList /> },
|
||
{ path: 'create', element: <ProductCreate /> },
|
||
{ path: ':id', element: <ProductDetail /> },
|
||
{ path: ':id/edit', element: <ProductEdit /> },
|
||
{ path: ':id/pricing', element: <ProductPricing /> },
|
||
{ path: 'cross-platform', element: <CrossPlatformManage /> },
|
||
{ path: 'ai-pricing', element: <AIPricing /> },
|
||
{ path: 'profit-monitor', element: <ProfitMonitor /> },
|
||
{ path: 'roi-analysis', element: <ROIAnalysis /> },
|
||
],
|
||
},
|
||
|
||
// 订单中心
|
||
{
|
||
path: 'orders',
|
||
children: [
|
||
{ path: '', element: <OrderList /> },
|
||
{ path: ':id', element: <OrderDetail /> },
|
||
{ path: 'exception', element: <ExceptionOrder /> },
|
||
{ path: 'aggregation', element: <OrderAggregation /> },
|
||
],
|
||
},
|
||
|
||
// 广告中心
|
||
{
|
||
path: 'ad',
|
||
children: [
|
||
{ path: '', element: <AdPlan /> },
|
||
{ path: 'delivery', element: <AdDelivery /> },
|
||
{ path: 'performance', element: <AdPerformance /> },
|
||
{ path: 'ai-optimization', element: <AIOptimization /> },
|
||
{ path: 'auto-adjustment', element: <AutoAdjustment /> },
|
||
],
|
||
},
|
||
|
||
// 财务中心
|
||
{
|
||
path: 'finance',
|
||
children: [
|
||
{ path: '', element: <FinanceOverview /> },
|
||
{ path: 'transactions', element: <Transactions /> },
|
||
{ path: 'reconciliation', element: <Reconciliation /> },
|
||
{ path: 'billing', element: <Billing /> },
|
||
],
|
||
},
|
||
|
||
// 库存中心
|
||
{
|
||
path: 'inventory',
|
||
children: [
|
||
{ path: '', element: <InventoryList /> },
|
||
{ path: 'warehouses', element: <Warehouses /> },
|
||
{ path: 'forecast', element: <InventoryForecast /> },
|
||
],
|
||
},
|
||
|
||
// 营销中心
|
||
{
|
||
path: 'marketing',
|
||
children: [
|
||
{ path: '', element: <MarketingOverview /> },
|
||
{ path: 'ads', element: <Ads /> },
|
||
{ path: 'competitors', element: <Competitors /> },
|
||
],
|
||
},
|
||
|
||
// 物流中心
|
||
{
|
||
path: 'logistics',
|
||
children: [
|
||
{ path: '', element: <LogisticsOverview /> },
|
||
{ path: 'select', element: <LogisticsSelect /> },
|
||
{ path: 'tracking', element: <LogisticsTrack /> },
|
||
{ path: 'freight', element: <FreightCalc /> },
|
||
],
|
||
},
|
||
|
||
// 售后服务
|
||
{
|
||
path: 'after-sales',
|
||
children: [
|
||
{ path: '', element: <AfterSalesOverview /> },
|
||
{ path: 'return', element: <ReturnApply /> },
|
||
{ path: 'refund', element: <RefundProcess /> },
|
||
{ path: 'customer-service', element: <CustomerService /> },
|
||
],
|
||
},
|
||
|
||
// B2B贸易
|
||
{
|
||
path: 'b2b',
|
||
children: [
|
||
{ path: '', element: <B2BOverview /> },
|
||
{ path: 'quote', element: <EnterpriseQuote /> },
|
||
{ path: 'batch-order', element: <BatchOrder /> },
|
||
{ path: 'contract', element: <ContractManage /> },
|
||
],
|
||
},
|
||
|
||
// 合规管理
|
||
{
|
||
path: 'compliance',
|
||
children: [
|
||
{ path: '', element: <ComplianceOverview /> },
|
||
{ path: 'certificates', element: <CertificateManage /> },
|
||
{ path: 'check', element: <ComplianceCheck /> },
|
||
{ path: 'expiry-reminder', element: <CertificateExpiryReminder /> },
|
||
],
|
||
},
|
||
|
||
// 多商户管理
|
||
{
|
||
path: 'merchant',
|
||
children: [
|
||
{ path: '', element: <MerchantManage /> },
|
||
{ path: 'shops', element: <MerchantShopManage /> },
|
||
{ path: 'orders', element: <MerchantOrderManage /> },
|
||
{ path: 'settlement', element: <MerchantSettlementManage /> },
|
||
],
|
||
},
|
||
|
||
// 独立站管理
|
||
{
|
||
path: 'independent-site',
|
||
children: [
|
||
{ path: '', element: <IndependentSiteList /> },
|
||
{ path: 'create', element: <IndependentSiteCreate /> },
|
||
{ path: ':id/config', element: <IndependentSiteConfig /> },
|
||
{ path: ':id/products', element: <IndependentSiteProduct /> },
|
||
{ path: ':id/orders', element: <IndependentSiteOrder /> },
|
||
{ path: ':id/analytics', element: <IndependentSiteAnalytics /> },
|
||
],
|
||
},
|
||
|
||
// 黑名单管理
|
||
{
|
||
path: 'blacklist',
|
||
children: [
|
||
{ path: '', element: <BlacklistManage /> },
|
||
{ path: 'risk-monitor', element: <RiskMonitor /> },
|
||
],
|
||
},
|
||
|
||
// A/B测试
|
||
{
|
||
path: 'ab-test',
|
||
children: [
|
||
{ path: '', element: <ABTestConfig /> },
|
||
{ path: 'results', element: <ABTestResults /> },
|
||
],
|
||
},
|
||
|
||
// 用户资产
|
||
{
|
||
path: 'user-asset',
|
||
children: [
|
||
{ path: '', element: <UserAssets /> },
|
||
{ path: 'points', element: <PointsManage /> },
|
||
{ path: 'member-level', element: <MemberLevel /> },
|
||
],
|
||
},
|
||
|
||
// AI功能
|
||
{
|
||
path: 'ai',
|
||
children: [
|
||
{ path: 'auto-selection', element: <AutoProductSelection /> },
|
||
{ path: 'autopilot', element: <AutoPilot /> },
|
||
{ path: 'decision-log', element: <AIDecisionLog /> },
|
||
{ path: 'auto-execution', element: <AutoExecution /> },
|
||
],
|
||
},
|
||
|
||
// 策略市场
|
||
{ path: 'strategy-market', element: <StrategyMarketplace /> },
|
||
|
||
// 排行榜
|
||
{ path: 'leaderboard', element: <Leaderboard /> },
|
||
|
||
// 任务中心
|
||
{ path: 'task-center', element: <TaskCenter /> },
|
||
|
||
// 系统设置
|
||
{
|
||
path: 'settings',
|
||
children: [
|
||
{ path: '', element: <SettingsOverview /> },
|
||
{ path: 'profile', element: <ProfileSettings /> },
|
||
{ path: 'platform-account', element: <PlatformAccountConfig /> },
|
||
{ path: 'exchange-rate', element: <ExchangeRateConfig /> },
|
||
{ path: 'cost-template', element: <CostTemplateConfig /> },
|
||
{ path: 'win-node', element: <WinNodeConfig /> },
|
||
{ path: 'users', element: <UserManagement /> },
|
||
{ path: 'tenant', element: <TenantSettings /> },
|
||
{ path: 'system', element: <SystemSettings /> },
|
||
],
|
||
},
|
||
],
|
||
},
|
||
|
||
// 认证页面（无布局）
|
||
{ path: 'login', element: <LoginPage /> },
|
||
{ path: 'register', element: <RegisterPage /> },
|
||
{ path: 'reset-password', element: <ResetPasswordPage /> },
|
||
];
|
||
```
|
||
|
||
---
|
||
|
||
## 16. 后端详细规划
|
||
|
||
### 16.1 服务模块清单
|
||
|
||
#### 已实现服务（Server）
|
||
|
||
| 领域 | 服务数 | 核心服务列表 |
|
||
|------|--------|-------------|
|
||
| **商品域** | 15+ | ProductService, PricingService, ArbitrageService, ProductHealthService, SKUMappingService, ProductSelectionService, AutoListingService, PublishService |
|
||
| **订单域** | 10+ | OrderService, OrderAggregationService, OrderProfitService, ExceptionAutoFixService, FulfillmentConsensusService |
|
||
| **财务域** | 12+ | FinanceService, BillingService, FinanceReconciliationService, MultiCurrencyFinanceService, PaymentService, PayoutService, CashflowService, CashflowForecastService |
|
||
| **库存域** | 8+ | InventoryService, InventoryForecastService, InventorySyncService, InventoryDistributionService, InventoryRLService, AgingInventoryService, ReplenishmentService |
|
||
| **营销域** | 6+ | MarketingService, AdPlanService, AdOptimizationService, BiddingStrategyService, AdPredictionService, AdAutoService |
|
||
| **合规域** | 5+ | ComplianceCheckService, CertificateService, ComplianceGateService, TaxService, TaxComplianceService |
|
||
| **物流域** | 5+ | LogisticsService, LogisticsIntelligenceService, LastMileOptimizerService, LogisticsInsuranceService |
|
||
| **AI域** | 15+ | AIService, AIDecisionService, AIDecisionLogService, AutoPilotService, AutoExecutionConfigService, DynamicPricingService |
|
||
| **治理域** | 8+ | GovernanceService, AuditService, QuotaService, RBACService, AuthService, PermissionTestService |
|
||
| **安全域** | 10+ | SecurityTestService, EncryptionService, BlacklistService, BlacklistAnalysisService, RiskAssessmentService |
|
||
| **供应链域** | 8+ | SupplierService, SupplyChainService, SupplierRiskRadarService, AutonomousSourcingService |
|
||
| **多商户域** | 6+ | MerchantService, MerchantMetricsService, LeaderboardService, HierarchyService, DataIsolationService |
|
||
| **策略域** | 3+ | StrategyService, StrategyRecommendationService, ABTestService |
|
||
| **基础设施域** | 10+ | EventBusService, BullMQService, RedisService, MonitoringAlertService, DeployService |
|
||
|
||
### 16.2 服务详细列表
|
||
|
||
```
|
||
server/src/services/
|
||
├── 核心业务服务
|
||
│ ├── ProductService.ts # 商品管理
|
||
│ ├── OrderService.ts # 订单管理
|
||
│ ├── InventoryService.ts # 库存管理
|
||
│ ├── FinanceService.ts # 财务管理
|
||
│ ├── LogisticsService.ts # 物流管理
|
||
│ ├── MarketingService.ts # 营销管理
|
||
│ ├── SupplierService.ts # 供应商管理
|
||
│ └── CustomerService.ts # 客户服务
|
||
│
|
||
├── 定价与利润服务
|
||
│ ├── PricingService.ts # 定价服务
|
||
│ ├── PricingDecisionService.ts # 定价决策
|
||
│ ├── DynamicPricingService.ts # 动态定价
|
||
│ ├── ArbitrageService.ts # 套利服务
|
||
│ ├── PersonalizedPricingService.ts # 个性化定价
|
||
│ └── OrderProfitService.ts # 订单利润
|
||
│
|
||
├── AI智能服务
|
||
│ ├── AIService.ts # AI核心服务
|
||
│ ├── AIDecisionService.ts # AI决策服务
|
||
│ ├── AIDecisionLogService.ts # AI决策日志
|
||
│ ├── AutoPilotService.ts # AI自动驾驶
|
||
│ ├── AutoPilotScheduler.ts # 自动驾驶调度
|
||
│ ├── AutoExecutionConfigService.ts # 自动执行配置
|
||
│ ├── ProductSelectionService.ts # 智能选品
|
||
│ └── AutoListingService.ts # 自动上架
|
||
│
|
||
├── 广告营销服务
|
||
│ ├── AdPlanService.ts # 广告计划
|
||
│ ├── AdOptimizationService.ts # 广告优化
|
||
│ ├── AdPredictionService.ts # 广告预测
|
||
│ ├── BiddingStrategyService.ts # 竞价策略
|
||
│ ├── AdAutoService.ts # 广告自动化
|
||
│ └── TrueROASService.ts # 真实ROAS
|
||
│
|
||
├── 多商户服务
|
||
│ ├── MerchantService.ts # 商户管理
|
||
│ ├── MerchantMetricsService.ts # 商户指标
|
||
│ ├── LeaderboardService.ts # 排行榜
|
||
│ ├── HierarchyService.ts # 层级管理
|
||
│ ├── DataIsolationService.ts # 数据隔离
|
||
│ ├── MerchantSettlementService.ts # 商户结算
|
||
│ └── MerchantAnalysisService.ts # 商户分析
|
||
│
|
||
├── 策略与测试服务
|
||
│ ├── StrategyService.ts # 策略管理
|
||
│ ├── StrategyRecommendationService.ts # 策略推荐
|
||
│ ├── ABTestService.ts # A/B测试
|
||
│ └── ABTestAnalysisService.ts # A/B分析
|
||
│
|
||
├── 风控与安全服务
|
||
│ ├── BlacklistService.ts # 黑名单
|
||
│ ├── BlacklistAnalysisService.ts # 黑名单分析
|
||
│ ├── RiskAssessmentService.ts # 风险评估
|
||
│ ├── SecurityTestService.ts # 安全测试
|
||
│ ├── EncryptionService.ts # 加密服务
|
||
│ └── FraudSharedService.ts # 欺诈检测
|
||
│
|
||
├── 合规与税务服务
|
||
│ ├── ComplianceCheckService.ts # 合规检查
|
||
│ ├── CertificateService.ts # 证书管理
|
||
│ ├── TaxService.ts # 税务服务
|
||
│ ├── TaxComplianceService.ts # 税务合规
|
||
│ └── TaxReportService.ts # 税务报告
|
||
│
|
||
├── 供应链服务
|
||
│ ├── SupplyChainService.ts # 供应链
|
||
│ ├── SupplierRiskRadarService.ts # 供应商风险
|
||
│ ├── AutonomousSourcingService.ts # 自主采购
|
||
│ └── GreenSupplyChainService.ts # 绿色供应链
|
||
│
|
||
├── 跨境服务
|
||
│ ├── CrossBorderService.ts # 跨境服务
|
||
│ ├── CustomsDeclarationService.ts # 报关服务
|
||
│ ├── CurrencyRiskService.ts # 汇率风险
|
||
│ └── FXHedgingService.ts # 外汇对冲
|
||
│
|
||
├── 基础设施服务
|
||
│ ├── EventBusService.ts # 事件总线
|
||
│ ├── BullMQService.ts # 消息队列
|
||
│ ├── RedisService.ts # 缓存服务
|
||
│ ├── MonitoringAlertService.ts # 监控告警
|
||
│ ├── DeployService.ts # 部署服务
|
||
│ └── ConfigService.ts # 配置服务
|
||
│
|
||
└── 认证授权服务
|
||
├── AuthService.ts # 认证服务
|
||
├── RBACService.ts # 权限服务
|
||
└── PermissionTestService.ts # 权限测试
|
||
```
|
||
|
||
### 16.3 API接口规范
|
||
|
||
#### RESTful API 设计规范
|
||
|
||
```typescript
|
||
// API 响应格式
|
||
interface ApiResponse<T> {
|
||
code: number; // 状态码
|
||
message: string; // 消息
|
||
data: T; // 数据
|
||
traceId: string; // 追踪ID
|
||
timestamp: number; // 时间戳
|
||
}
|
||
|
||
// 分页响应
|
||
interface PagedResponse<T> {
|
||
code: number;
|
||
message: string;
|
||
data: {
|
||
list: T[];
|
||
total: number;
|
||
page: number;
|
||
pageSize: number;
|
||
};
|
||
traceId: string;
|
||
timestamp: number;
|
||
}
|
||
|
||
// API 路径规范
|
||
const apiEndpoints = {
|
||
// 商品API
|
||
products: {
|
||
list: 'GET /api/v1/products',
|
||
detail: 'GET /api/v1/products/:id',
|
||
create: 'POST /api/v1/products',
|
||
update: 'PUT /api/v1/products/:id',
|
||
delete: 'DELETE /api/v1/products/:id',
|
||
batchCreate: 'POST /api/v1/products/batch',
|
||
batchUpdate: 'PUT /api/v1/products/batch',
|
||
pricing: 'POST /api/v1/products/:id/pricing',
|
||
publish: 'POST /api/v1/products/:id/publish',
|
||
sync: 'POST /api/v1/products/:id/sync',
|
||
},
|
||
|
||
// 订单API
|
||
orders: {
|
||
list: 'GET /api/v1/orders',
|
||
detail: 'GET /api/v1/orders/:id',
|
||
confirm: 'POST /api/v1/orders/:id/confirm',
|
||
ship: 'POST /api/v1/orders/:id/ship',
|
||
cancel: 'POST /api/v1/orders/:id/cancel',
|
||
refund: 'POST /api/v1/orders/:id/refund',
|
||
exception: 'GET /api/v1/orders/exception',
|
||
aggregation: 'GET /api/v1/orders/aggregation',
|
||
},
|
||
|
||
// AI API
|
||
ai: {
|
||
pricingSuggest: 'POST /api/v1/ai/pricing/suggest',
|
||
productRecommend: 'POST /api/v1/ai/product/recommend',
|
||
decisionLog: 'GET /api/v1/ai/decision-log',
|
||
autopilotStatus: 'GET /api/v1/ai/autopilot/status',
|
||
autopilotConfig: 'POST /api/v1/ai/autopilot/config',
|
||
},
|
||
|
||
// 多商户API
|
||
merchant: {
|
||
list: 'GET /api/v1/merchants',
|
||
detail: 'GET /api/v1/merchants/:id',
|
||
shops: 'GET /api/v1/merchants/:id/shops',
|
||
metrics: 'GET /api/v1/merchants/:id/metrics',
|
||
leaderboard: 'GET /api/v1/merchants/leaderboard',
|
||
settlement: 'GET /api/v1/merchants/:id/settlement',
|
||
},
|
||
};
|
||
```
|
||
|
||
### 16.4 数据库表设计规范
|
||
|
||
```sql
|
||
-- 表命名规范
|
||
-- 所有表必须以 cf_ 前缀开头
|
||
|
||
-- 商品表
|
||
CREATE TABLE cf_product (
|
||
id VARCHAR(36) PRIMARY KEY,
|
||
tenant_id VARCHAR(36) NOT NULL,
|
||
shop_id VARCHAR(36) NOT NULL,
|
||
name VARCHAR(255) NOT NULL,
|
||
sku VARCHAR(100) NOT NULL,
|
||
platform VARCHAR(50) NOT NULL,
|
||
platform_product_id VARCHAR(100),
|
||
price DECIMAL(10,2) NOT NULL,
|
||
cost DECIMAL(10,2),
|
||
stock INT DEFAULT 0,
|
||
status ENUM('draft', 'pending_approval', 'active', 'inactive', 'discontinued') DEFAULT 'draft',
|
||
images JSON,
|
||
attributes JSON,
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
UNIQUE KEY uk_platform_product (platform, platform_product_id),
|
||
INDEX idx_tenant_shop (tenant_id, shop_id),
|
||
INDEX idx_status (status)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- 订单表
|
||
CREATE TABLE cf_order (
|
||
id VARCHAR(36) PRIMARY KEY,
|
||
tenant_id VARCHAR(36) NOT NULL,
|
||
shop_id VARCHAR(36) NOT NULL,
|
||
order_no VARCHAR(100) NOT NULL,
|
||
platform VARCHAR(50) NOT NULL,
|
||
platform_order_id VARCHAR(100),
|
||
customer_id VARCHAR(36),
|
||
total_amount DECIMAL(10,2) NOT NULL,
|
||
currency VARCHAR(10) DEFAULT 'USD',
|
||
status ENUM('pending', 'paid', 'processing', 'shipped', 'completed', 'cancelled', 'refunded') DEFAULT 'pending',
|
||
shipping_address JSON,
|
||
items JSON,
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
UNIQUE KEY uk_platform_order (platform, platform_order_id),
|
||
INDEX idx_tenant_shop (tenant_id, shop_id),
|
||
INDEX idx_status (status),
|
||
INDEX idx_created_at (created_at)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- 商户表
|
||
CREATE TABLE cf_merchant (
|
||
id VARCHAR(36) PRIMARY KEY,
|
||
name VARCHAR(255) NOT NULL,
|
||
code VARCHAR(50) UNIQUE NOT NULL,
|
||
status ENUM('pending', 'active', 'inactive', 'suspended') DEFAULT 'pending',
|
||
contact_person VARCHAR(100),
|
||
contact_email VARCHAR(255),
|
||
contact_phone VARCHAR(50),
|
||
business_type ENUM('B2B', 'B2C', 'BOTH') DEFAULT 'B2C',
|
||
settings JSON,
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
INDEX idx_status (status)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
|
||
-- AI决策日志表
|
||
CREATE TABLE cf_ai_decision_log (
|
||
id VARCHAR(36) PRIMARY KEY,
|
||
tenant_id VARCHAR(36) NOT NULL,
|
||
trace_id VARCHAR(100) NOT NULL,
|
||
decision_type ENUM('pricing', 'inventory', 'ad', 'selection', 'logistics', 'risk', 'customer_service', 'settlement') NOT NULL,
|
||
input_data JSON NOT NULL,
|
||
ai_suggestion JSON NOT NULL,
|
||
confidence DECIMAL(5,4),
|
||
status ENUM('pending', 'approved', 'rejected', 'modified', 'executed', 'failed') DEFAULT 'pending',
|
||
human_action VARCHAR(50),
|
||
human_reason TEXT,
|
||
execution_result JSON,
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
executed_at TIMESTAMP NULL,
|
||
INDEX idx_tenant_trace (tenant_id, trace_id),
|
||
INDEX idx_decision_type (decision_type),
|
||
INDEX idx_status (status)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
```
|
||
|
||
---
|
||
|
||
## 17. 数据架构规划
|
||
|
||
### 17.1 数据分层架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 数据分层架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 应用层 (Application Layer) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 前端应用 │ 移动端 │ 插件 │ API Gateway │ Webhook │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 服务层 (Service Layer) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 业务服务 │ 数据服务 │ 缓存服务 │ 搜索服务 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 数据访问层 (Data Access Layer) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Repository │ ORM │ Query Builder │ Data Mapper │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 存储层 (Storage Layer) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ MySQL │ Redis │ Elasticsearch │ MongoDB │ S3 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 17.2 数据库分片策略
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 分片策略 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 水平分片 (Horizontal Sharding) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 按 tenant_id 分片 │ │
|
||
│ │ │ │
|
||
│ │ Shard 1: tenant_id 1-1000 │ │
|
||
│ │ Shard 2: tenant_id 1001-2000 │ │
|
||
│ │ Shard 3: tenant_id 2001-3000 │ │
|
||
│ │ ... │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 垂直分片 (Vertical Sharding) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 按业务域分库 │ │
|
||
│ │ │ │
|
||
│ │ Product DB: cf_product, cf_sku, cf_category │ │
|
||
│ │ Order DB: cf_order, cf_order_item, cf_refund │ │
|
||
│ │ Finance DB: cf_transaction, cf_settlement │ │
|
||
│ │ Merchant DB: cf_merchant, cf_shop, cf_user │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 时间分表 (Time-based Partitioning) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 按时间范围分表 │ │
|
||
│ │ │ │
|
||
│ │ cf_order_202601 │ │
|
||
│ │ cf_order_202602 │ │
|
||
│ │ cf_order_202603 │ │
|
||
│ │ ... │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 17.3 数据同步架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 数据同步架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 主从复制 (Master-Slave Replication) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ Master (写) │ │
|
||
│ │ │ │ │
|
||
│ │ ├──→ Slave 1 (读) │ │
|
||
│ │ ├──→ Slave 2 (读) │ │
|
||
│ │ └──→ Slave 3 (读) │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 数据同步流程 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ MySQL → Canal → Kafka → Flink → Elasticsearch │ │
|
||
│ │ (CDC) │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 缓存同步 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ 数据变更 → 发布事件 → 更新缓存 → 失效通知 │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 18. 插件生态规划
|
||
|
||
### 18.1 插件架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 插件架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ Chrome Extension │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ Background Script (Service Worker) │ │
|
||
│ │ ├── 消息处理 │ │
|
||
│ │ ├── 任务调度 │ │
|
||
│ │ ├── 数据同步 │ │
|
||
│ │ └── 状态管理 │ │
|
||
│ │ │ │
|
||
│ │ Content Script │ │
|
||
│ │ ├── DOM 解析 │ │
|
||
│ │ ├── 数据采集 │ │
|
||
│ │ ├── 自动化操作 │ │
|
||
│ │ └── 页面注入 │ │
|
||
│ │ │ │
|
||
│ │ Popup UI │ │
|
||
│ │ ├── 状态展示 │ │
|
||
│ │ ├── 快捷操作 │ │
|
||
│ │ └── 配置管理 │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 18.2 已实现插件功能
|
||
|
||
```
|
||
extension/src/
|
||
├── background/
|
||
│ ├── index.ts # 入口文件
|
||
│ ├── MessageHandler.ts # 消息处理
|
||
│ ├── services.ts # 服务注册
|
||
│ ├── DOMParser.ts # DOM解析
|
||
│ ├── FingerprintManager.ts # 指纹管理
|
||
│ ├── OrderCollector.ts # 订单采集
|
||
│ ├── AutoShipService.ts # 自动发货
|
||
│ ├── LogisticsSyncService.ts # 物流同步
|
||
│ ├── ReturnSync.ts # 退货同步
|
||
│ ├── RefundQuery.ts # 退款查询
|
||
│ ├── ABTestStrategyService.ts # A/B测试策略
|
||
│ └── ABTestOptimizationService.ts # A/B优化
|
||
│
|
||
├── content/
|
||
│ └── index.ts # 内容脚本
|
||
│
|
||
├── platforms/
|
||
│ └── index.ts # 平台适配
|
||
│
|
||
├── popup/
|
||
│ ├── index.tsx # 弹窗UI
|
||
│ └── popup.css # 样式
|
||
│
|
||
└── utils/
|
||
├── Logger.ts # 日志工具
|
||
└── index.ts # 工具函数
|
||
```
|
||
|
||
### 18.3 插件能力扩展规划
|
||
|
||
| 功能模块 | 描述 | 优先级 | 状态 |
|
||
|---------|------|--------|------|
|
||
| **多平台适配** | 支持1688、Amazon、eBay、Shopee等 | P0 | 已完成部分 |
|
||
| **智能采集** | AI辅助商品信息采集 | P0 | 进行中 |
|
||
| **自动化操作** | 自动上架、自动调价、自动发货 | P0 | 已完成部分 |
|
||
| **数据同步** | 实时数据同步到Hub | P1 | 已完成 |
|
||
| **指纹隔离** | 多店铺指纹隔离 | P1 | 已完成 |
|
||
| **代理管理** | 多代理自动切换 | P1 | 待开发 |
|
||
| **任务队列** | 本地任务队列管理 | P2 | 待开发 |
|
||
| **离线支持** | 离线数据缓存和同步 | P2 | 待开发 |
|
||
|
||
### 18.4 平台适配器规划
|
||
|
||
```typescript
|
||
// 平台适配器接口
|
||
interface PlatformAdapter {
|
||
name: string;
|
||
domains: string[];
|
||
|
||
// 商品采集
|
||
collectProduct(): Promise<ProductData>;
|
||
|
||
// 订单采集
|
||
collectOrders(): Promise<OrderData[]>;
|
||
|
||
// 自动化操作
|
||
autoPublish(product: ProductData): Promise<void>;
|
||
autoAdjustPrice(productId: string, price: number): Promise<void>;
|
||
autoShip(orderId: string, tracking: TrackingInfo): Promise<void>;
|
||
|
||
// 数据解析
|
||
parseProductPage(): ProductInfo;
|
||
parseOrderPage(): OrderInfo;
|
||
parseSearchPage(): ProductSearchResult[];
|
||
}
|
||
|
||
// 已支持平台
|
||
const supportedPlatforms = [
|
||
{ name: '1688', domains: ['1688.com', 'alibaba.com'] },
|
||
{ name: 'Amazon', domains: ['amazon.com', 'amazon.*'] },
|
||
{ name: 'eBay', domains: ['ebay.com', 'ebay.*'] },
|
||
{ name: 'Shopee', domains: ['shopee.*'] },
|
||
{ name: 'Lazada', domains: ['lazada.*'] },
|
||
{ name: 'Temu', domains: ['temu.com'] },
|
||
{ name: 'TikTok Shop', domains: ['tiktok.com'] },
|
||
];
|
||
```
|
||
|
||
---
|
||
|
||
## 19. 业务实现细节
|
||
|
||
### 19.1 核心业务流程
|
||
|
||
#### 商品刊登流程
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 商品刊登流程 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 1. 数据采集 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 插件采集 → 数据清洗 → 格式转换 → 存储到数据库 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 2. 商品处理 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 信息补全 → 图片处理 → 属性映射 → SKU生成 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 3. 定价计算 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 成本核算 → 利润计算 → 竞品分析 → 价格建议 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 4. 审核发布 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 人工审核 → 平台适配 → 批量发布 → 状态追踪 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
#### 订单履约流程
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 订单履约流程 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 1. 订单接收 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 平台同步 → 数据解析 → 订单创建 → 状态初始化 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 2. 订单处理 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 风险检测 → 库存校验 → 地址验证 → 自动审单 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 3. 履约执行 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 仓库分配 → 拣货打包 → 物流选择 → 发货出库 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 4. 物流追踪 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 轨迹同步 → 异常预警 → 签收确认 → 订单完成 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 19.2 AI决策流程
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ AI决策流程 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 1. 数据收集 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 历史数据 → 实时数据 → 外部数据 → 特征工程 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 2. 模型推理 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 模型选择 → 参数配置 → 推理执行 → 结果解析 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 3. 决策生成 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 建议生成 → 置信度评估 → 风险评估 → 日志记录 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 4. 执行控制 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 自动执行阈值判断 → 人工确认 → 执行 → 结果反馈 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 19.3 多商户数据隔离
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 数据隔离架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 层级结构 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ Merchant (商户) │ │
|
||
│ │ ├── Department (部门) │ │
|
||
│ │ │ ├── Shop (店铺) │ │
|
||
│ │ │ └── Shop (店铺) │ │
|
||
│ │ └── Department (部门) │ │
|
||
│ │ └── Shop (店铺) │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 数据隔离规则 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ 商户级: 可见本商户所有数据 │ │
|
||
│ │ 部门级: 可见本部门及下级店铺数据 │ │
|
||
│ │ 店铺级: 仅可见本店铺数据 │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ SQL注入防护 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ SELECT * FROM cf_product │ │
|
||
│ │ WHERE tenant_id = :tenantId │ │
|
||
│ │ AND (department_id = :deptId OR :role = 'admin') │ │
|
||
│ │ AND shop_id = :shopId │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 20. 运维与监控规划
|
||
|
||
### 20.1 监控指标体系
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 监控指标体系 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 系统指标 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ CPU使用率 │ 内存使用率 │ 磁盘IO │ 网络IO │ 进程数 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 应用指标 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 请求QPS │ 响应时间 │ 错误率 │ 并发数 │ 队列长度 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 业务指标 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 订单量 │ GMV │ 利润率 │ 库存周转率 │ 客诉率 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ AI指标 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 决策准确率 │ 自动执行率 │ 人工干预率 │ 模型延迟 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 20.2 告警规则配置
|
||
|
||
| 告警类型 | 触发条件 | 级别 | 通知方式 |
|
||
|---------|---------|------|---------|
|
||
| CPU使用率 > 80% | 持续5分钟 | P2 | 钉钉 |
|
||
| CPU使用率 > 95% | 持续1分钟 | P1 | 钉钉+电话 |
|
||
| 内存使用率 > 85% | 持续5分钟 | P2 | 钉钉 |
|
||
| API错误率 > 1% | 持续1分钟 | P1 | 钉钉+电话 |
|
||
| API响应时间 > 3s | 持续5分钟 | P2 | 钉钉 |
|
||
| 数据库连接池耗尽 | 立即 | P0 | 钉钉+电话+短信 |
|
||
| Redis连接失败 | 立即 | P0 | 钉钉+电话+短信 |
|
||
| AI决策失败率 > 5% | 持续10分钟 | P2 | 钉钉 |
|
||
|
||
---
|
||
|
||
## 附录A：术语表
|
||
|
||
| 术语 | 说明 |
|
||
|------|------|
|
||
| TOC | To Consumer，面向消费者 |
|
||
| TOB | To Business，面向企业 |
|
||
| DTC | Direct To Consumer，直接面向消费者 |
|
||
| SKU | Stock Keeping Unit，库存单位 |
|
||
| ROI | Return On Investment，投资回报率 |
|
||
| ROAS | Return On Ad Spend，广告支出回报率 |
|
||
| WMS | Warehouse Management System，仓储管理系统 |
|
||
| OMS | Order Management System，订单管理系统 |
|
||
| PIM | Product Information Management，商品信息管理 |
|
||
|
||
---
|
||
|
||
## 附录B：参考文档
|
||
|
||
- [Business_ClosedLoops.md](./00_Business/Business_ClosedLoops.md) - 业务闭环定义
|
||
- [Task_Overview.md](./00_Business/Task_Overview.md) - 任务总览
|
||
- [System_Architecture.md](./01_Architecture/System_Architecture.md) - 系统架构
|
||
- [AI_Strategy.md](./05_AI/AI_Strategy.md) - AI策略
|
||
- [Development_Progress.md](./Development_Progress.md) - 开发进度
|
||
|
||
---
|
||
|
||
---
|
||
|
||
## 20. 运维监控规划
|
||
|
||
### 20.1 监控指标体系
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 监控指标体系 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 基础设施监控 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ CPU使用率 │ 内存使用率 │ 磁盘IO │ 网络流量 │ │
|
||
│ │ 系统负载 │ 进程状态 │ 文件描述符 │ TCP连接数 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 应用层监控 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 请求QPS │ 响应时间 │ 错误率 │ 并发数 │ │
|
||
│ │ JVM状态 │ GC频率 │ 线程池状态 │ 连接池状态 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 数据库监控 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 连接数 │ 慢查询 │ 死锁 │ 主从延迟 │ │
|
||
│ │ 缓冲池命中率 │ 查询缓存 │ 表锁等待 │ TPS/QPS │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 缓存监控 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 内存使用 │ 命中率 │ 连接数 │ 响应时间 │ │
|
||
│ │ 键空间 │ 过期键 │ 持久化状态 │ 主从同步状态 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 业务监控 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 订单量 │ 交易额 │ 转化率 │ 客单价 │ │
|
||
│ │ 商品数 │ 库存预警 │ 异常订单 │ AI决策成功率 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 20.2 告警规则配置
|
||
|
||
| 告警类型 | 指标 | 阈值 | 级别 | 通知方式 |
|
||
|---------|------|------|------|---------|
|
||
| **CPU告警** | CPU使用率 | >80% 持续5分钟 | P2 | 邮件 |
|
||
| **CPU告警** | CPU使用率 | >95% 持续1分钟 | P1 | 邮件+短信 |
|
||
| **内存告警** | 内存使用率 | >85% | P2 | 邮件 |
|
||
| **内存告警** | 内存使用率 | >95% | P1 | 邮件+短信 |
|
||
| **磁盘告警** | 磁盘使用率 | >85% | P2 | 邮件 |
|
||
| **磁盘告警** | 磁盘使用率 | >95% | P1 | 邮件+短信 |
|
||
| **数据库告警** | 慢查询数 | >100/分钟 | P2 | 邮件 |
|
||
| **数据库告警** | 连接数 | >80% 最大连接 | P1 | 邮件+短信 |
|
||
| **缓存告警** | Redis命中率 | <80% | P2 | 邮件 |
|
||
| **缓存告警** | Redis内存 | >90% | P1 | 邮件+短信 |
|
||
| **应用告警** | 错误率 | >1% | P2 | 邮件 |
|
||
| **应用告警** | 错误率 | >5% | P1 | 邮件+短信 |
|
||
| **应用告警** | 响应时间 | P99 > 3s | P2 | 邮件 |
|
||
| **业务告警** | 订单异常率 | >5% | P1 | 邮件+短信 |
|
||
| **业务告警** | 支付失败率 | >2% | P1 | 邮件+短信 |
|
||
| **业务告警** | AI决策失败 | >10% | P2 | 邮件 |
|
||
|
||
### 20.3 日志体系
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 日志体系 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 日志分类 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 访问日志 │ 业务日志 │ 错误日志 │ 审计日志 │ 调试日志 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 日志格式 (JSON) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ { │ │
|
||
│ │ "timestamp": "2026-03-19T10:00:00.000Z", │ │
|
||
│ │ "level": "INFO", │ │
|
||
│ │ "traceId": "abc123", │ │
|
||
│ │ "tenantId": "tenant-001", │ │
|
||
│ │ "shopId": "shop-001", │ │
|
||
│ │ "service": "ProductService", │ │
|
||
│ │ "action": "createProduct", │ │
|
||
│ │ "message": "Product created successfully", │ │
|
||
│ │ "duration": 150, │ │
|
||
│ │ "userId": "user-001", │ │
|
||
│ │ "ip": "192.168.1.1", │ │
|
||
│ │ "userAgent": "Mozilla/5.0..." │ │
|
||
│ │ } │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 日志存储 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Elasticsearch (热数据 7天) │ │
|
||
│ │ S3/OSS (冷数据归档) │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 20.4 可观测性平台
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 可观测性平台 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 数据采集层 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Prometheus (指标) │ Filebeat (日志) │ Jaeger (链路) │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 数据存储层 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ VictoriaMetrics │ Elasticsearch │ Jaeger Backend │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 可视化层 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Grafana (仪表盘) │ Kibana (日志查询) │ Jaeger UI │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 告警层 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ AlertManager │ 邮件 │ 短信 │ 钉钉/企业微信 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 21. 多租户架构详细设计
|
||
|
||
### 21.1 租户层级模型
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 租户层级模型 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ Level 1: 平台层 (Platform) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ - 平台运营管理 │ │
|
||
│ │ - 全局配置管理 │ │
|
||
│ │ - 系统监控告警 │ │
|
||
│ │ - 平台级数据分析 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ Level 2: 商户层 (Merchant) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ - 商户注册/认证 │ │
|
||
│ │ - 商户配置管理 │ │
|
||
│ │ - 商户级权限控制 │ │
|
||
│ │ - 商户级数据分析 │ │
|
||
│ │ - 商户计费结算 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ Level 3: 部门层 (Department) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ - 部门组织架构 │ │
|
||
│ │ - 部门成员管理 │ │
|
||
│ │ - 部门级权限控制 │ │
|
||
│ │ - 部门级数据分析 │ │
|
||
│ │ - 部门绩效考核 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ Level 4: 店铺层 (Shop) │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ - 店铺配置管理 │ │
|
||
│ │ - 店铺运营数据 │ │
|
||
│ │ - 店铺级权限控制 │ │
|
||
│ │ - 店铺级数据分析 │ │
|
||
│ │ - 店铺绩效统计 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 21.2 数据隔离策略
|
||
|
||
```typescript
|
||
// 数据隔离服务
|
||
interface DataIsolationService {
|
||
// 获取当前用户的数据范围
|
||
getDataScope(userId: string): Promise<DataScope>;
|
||
|
||
// 构建数据过滤条件
|
||
buildFilterConditions(
|
||
scope: DataScope,
|
||
tableName: string
|
||
): Promise<FilterCondition>;
|
||
|
||
// 验证数据访问权限
|
||
validateAccess(
|
||
userId: string,
|
||
resourceType: string,
|
||
resourceId: string,
|
||
action: 'read' | 'write' | 'delete'
|
||
): Promise<boolean>;
|
||
|
||
// 获取层级路径
|
||
getHierarchyPath(entityId: string, entityType: 'merchant' | 'department' | 'shop'): Promise<string[]>;
|
||
}
|
||
|
||
// 数据范围定义
|
||
interface DataScope {
|
||
merchantId: string;
|
||
departmentIds?: string[]; // 可访问的部门ID列表
|
||
shopIds?: string[]; // 可访问的店铺ID列表
|
||
scopeType: 'all' | 'department' | 'shop' | 'self';
|
||
}
|
||
|
||
// 数据过滤条件
|
||
interface FilterCondition {
|
||
where: {
|
||
tenant_id?: string;
|
||
merchant_id?: string;
|
||
department_id?: string | { in: string[] };
|
||
shop_id?: string | { in: string[] };
|
||
};
|
||
}
|
||
```
|
||
|
||
### 21.3 租户配额管理
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 租户配额管理 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 配额类型 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ 资源配额 │ │
|
||
│ │ ├── 商品数量上限 │ │
|
||
│ │ ├── 订单数量上限 │ │
|
||
│ │ ├── 店铺数量上限 │ │
|
||
│ │ ├── 用户数量上限 │ │
|
||
│ │ └── 存储空间上限 │ │
|
||
│ │ │ │
|
||
│ │ 功能配额 │ │
|
||
│ │ ├── API调用次数 │ │
|
||
│ │ ├── AI决策次数 │ │
|
||
│ │ ├── 报表导出次数 │ │
|
||
│ │ └── 并发任务数 │ │
|
||
│ │ │ │
|
||
│ │ 时间配额 │ │
|
||
│ │ ├── 数据保留天数 │ │
|
||
│ │ ├── 日志保留天数 │ │
|
||
│ │ └── 备份保留天数 │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 配额版本 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ 基础版 专业版 企业版 │ │
|
||
│ │ ├── 商品: 1000 ├── 商品: 10000 ├── 商品: 无限 │ │
|
||
│ │ ├── 店铺: 3 ├── 店铺: 20 ├── 店铺: 无限 │ │
|
||
│ │ ├── 用户: 5 ├── 用户: 50 ├── 用户: 无限 │ │
|
||
│ │ ├── AI: 100/月 ├── AI: 5000/月 ├── AI: 无限 │ │
|
||
│ │ └── 存储: 5GB └── 存储: 50GB └── 存储: 无限 │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 22. 安全架构详细设计
|
||
|
||
### 22.1 认证授权架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 认证授权架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 认证方式 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ 用户名密码认证 │ │
|
||
│ │ ├── 密码加密存储 (bcrypt) │ │
|
||
│ │ ├── 登录失败锁定 (5次锁定30分钟) │ │
|
||
│ │ └── 密码强度校验 │ │
|
||
│ │ │ │
|
||
│ │ OAuth2.0 第三方登录 │ │
|
||
│ │ ├── Google │ │
|
||
│ │ ├── GitHub │ │
|
||
│ │ └── 企业微信/钉钉 │ │
|
||
│ │ │ │
|
||
│ │ 多因素认证 (MFA) │ │
|
||
│ │ ├── TOTP (Google Authenticator) │ │
|
||
│ │ ├── 短信验证码 │ │
|
||
│ │ └── 邮箱验证码 │ │
|
||
│ │ │ │
|
||
│ │ API认证 │ │
|
||
│ │ ├── API Key + Secret │ │
|
||
│ │ ├── JWT Token │ │
|
||
│ │ └── OAuth2.0 Client Credentials │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 授权模型 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ RBAC (基于角色的访问控制) │ │
|
||
│ │ ├── 用户 - 角色 - 权限 │ │
|
||
│ │ ├── 角色继承 │ │
|
||
│ │ └── 数据范围控制 │ │
|
||
│ │ │ │
|
||
│ │ ABAC (基于属性的访问控制) │ │
|
||
│ │ ├── 用户属性 │ │
|
||
│ │ ├── 资源属性 │ │
|
||
│ │ ├── 环境属性 │ │
|
||
│ │ └── 动态策略评估 │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 22.2 权限模型设计
|
||
|
||
```typescript
|
||
// 权限模型
|
||
interface Permission {
|
||
id: string;
|
||
code: string; // 权限代码，如 'product:create'
|
||
name: string; // 权限名称
|
||
resource: string; // 资源类型
|
||
action: string; // 操作类型: create, read, update, delete
|
||
description: string;
|
||
}
|
||
|
||
// 角色模型
|
||
interface Role {
|
||
id: string;
|
||
code: string; // 角色代码
|
||
name: string; // 角色名称
|
||
permissions: Permission[];
|
||
dataScope: 'all' | 'department' | 'shop' | 'self';
|
||
inheritFrom?: string; // 继承自哪个角色
|
||
}
|
||
|
||
// 预设角色
|
||
const predefinedRoles: Role[] = [
|
||
{
|
||
id: 'role-admin',
|
||
code: 'ADMIN',
|
||
name: '系统管理员',
|
||
permissions: ['*'],
|
||
dataScope: 'all',
|
||
},
|
||
{
|
||
id: 'role-merchant-admin',
|
||
code: 'MERCHANT_ADMIN',
|
||
name: '商户管理员',
|
||
permissions: [
|
||
'merchant:read', 'merchant:update',
|
||
'department:*', 'shop:*', 'user:*',
|
||
'product:*', 'order:*', 'finance:read',
|
||
],
|
||
dataScope: 'all',
|
||
},
|
||
{
|
||
id: 'role-operator',
|
||
code: 'OPERATOR',
|
||
name: '运营专员',
|
||
permissions: [
|
||
'product:read', 'product:update',
|
||
'order:read', 'order:update',
|
||
'inventory:read', 'inventory:update',
|
||
],
|
||
dataScope: 'shop',
|
||
},
|
||
{
|
||
id: 'role-finance',
|
||
code: 'FINANCE',
|
||
name: '财务主管',
|
||
permissions: [
|
||
'finance:*', 'order:read',
|
||
'settlement:*', 'report:read',
|
||
],
|
||
dataScope: 'all',
|
||
},
|
||
{
|
||
id: 'role-viewer',
|
||
code: 'VIEWER',
|
||
name: '只读用户',
|
||
permissions: ['*:read'],
|
||
dataScope: 'department',
|
||
},
|
||
];
|
||
```
|
||
|
||
### 22.3 安全防护措施
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 安全防护措施 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 网络安全 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ WAF防护 - SQL注入、XSS、CSRF防护 │ │
|
||
│ │ DDoS防护 - 流量清洗、限流 │ │
|
||
│ │ SSL/TLS - 全站HTTPS加密 │ │
|
||
│ │ IP白名单 - 敏感接口IP限制 │ │
|
||
│ │ CORS策略 - 跨域访问控制 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 应用安全 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 输入验证 - 参数校验、类型检查 │ │
|
||
│ │ 输出编码 - HTML转义、JSON编码 │ │
|
||
│ │ SQL注入防护 - 参数化查询、ORM │ │
|
||
│ │ XSS防护 - CSP策略、输入过滤 │ │
|
||
│ │ CSRF防护 - Token验证、SameSite Cookie │ │
|
||
│ │ 文件上传 - 类型检查、大小限制、病毒扫描 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 数据安全 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 数据加密 - AES-256加密存储 │ │
|
||
│ │ 传输加密 - TLS 1.3 │ │
|
||
│ │ 数据脱敏 - 敏感数据掩码显示 │ │
|
||
│ │ 数据备份 - 每日备份、异地容灾 │ │
|
||
│ │ 密钥管理 - KMS密钥管理服务 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 运维安全 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 访问控制 - VPN、堡垒机 │ │
|
||
│ │ 审计日志 - 全操作审计 │ │
|
||
│ │ 安全扫描 - 定期漏洞扫描 │ │
|
||
│ │ 应急响应 - 安全事件响应流程 │ │
|
||
│ │ 合规检查 - 定期合规审计 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 23. 性能优化详细方案
|
||
|
||
### 23.1 前端性能优化
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 前端性能优化 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 加载优化 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 代码分割 - 路由级懒加载 │ │
|
||
│ │ Tree Shaking - 无用代码消除 │ │
|
||
│ │ 资源压缩 - Gzip/Brotli压缩 │ │
|
||
│ │ 图片优化 - WebP格式、懒加载、响应式图片 │ │
|
||
│ │ CDN加速 - 静态资源CDN分发 │ │
|
||
│ │ 预加载 - 关键资源预加载 │ │
|
||
│ │ 缓存策略 - 强缓存+协商缓存 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 渲染优化 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 虚拟滚动 - 大列表虚拟滚动 │ │
|
||
│ │ 懒渲染 - 可视区域外延迟渲染 │ │
|
||
│ │ 防抖节流 - 高频事件优化 │ │
|
||
│ │ Web Worker - 耗时计算后台执行 │ │
|
||
│ │ React优化 - useMemo、useCallback、memo │ │
|
||
│ │ 状态优化 - 避免不必要的状态更新 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 网络优化 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ HTTP/2 - 多路复用 │ │
|
||
│ │ 请求合并 - 批量接口请求 │ │
|
||
│ │ 请求缓存 - React Query缓存 │ │
|
||
│ │ 离线缓存 - Service Worker │ │
|
||
│ │ WebSocket - 实时数据推送 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 23.2 后端性能优化
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 后端性能优化 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 数据库优化 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 索引优化 - 合理创建索引、避免索引失效 │ │
|
||
│ │ 查询优化 - 避免SELECT *、优化JOIN │ │
|
||
│ │ 分页优化 - 游标分页、延迟关联 │ │
|
||
│ │ 批量操作 - 批量插入、批量更新 │ │
|
||
│ │ 读写分离 - 主从复制、读写分离 │ │
|
||
│ │ 连接池 - 合理配置连接池大小 │ │
|
||
│ │ 慢查询监控 - 定期分析慢查询日志 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 缓存优化 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 多级缓存 - 本地缓存 + 分布式缓存 │ │
|
||
│ │ 缓存预热 - 系统启动时预加载热点数据 │ │
|
||
│ │ 缓存穿透 - 布隆过滤器、空值缓存 │ │
|
||
│ │ 缓存击穿 - 互斥锁、热点数据永不过期 │ │
|
||
│ │ 缓存雪崩 - 过期时间随机化 │ │
|
||
│ │ 缓存更新 - 主动更新 + 被动更新 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 并发优化 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 异步处理 - 消息队列异步处理 │ │
|
||
│ │ 并行处理 - Promise.all并行请求 │ │
|
||
│ │ 连接池 - 数据库、Redis、HTTP连接池 │ │
|
||
│ │ 限流熔断 - 防止系统过载 │ │
|
||
│ │ 协程优化 - Node.js cluster模式 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 代码优化 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 算法优化 - 时间复杂度优化 │ │
|
||
│ │ 内存优化 - 避免内存泄漏、及时释放 │ │
|
||
│ │ 日志优化 - 异步日志、日志级别控制 │ │
|
||
│ │ 错误处理 - 快速失败、优雅降级 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 23.3 性能指标目标
|
||
|
||
| 指标 | 当前值 | 目标值 | 优化措施 |
|
||
|------|--------|--------|---------|
|
||
| **首屏加载时间** | 3.5s | < 2s | 代码分割、CDN、缓存 |
|
||
| **接口响应时间(P50)** | 200ms | < 100ms | 缓存、数据库优化 |
|
||
| **接口响应时间(P99)** | 2s | < 500ms | 异步处理、限流 |
|
||
| **数据库查询时间** | 500ms | < 100ms | 索引优化、读写分离 |
|
||
| **并发处理能力** | 500 QPS | 2000 QPS | 水平扩展、缓存 |
|
||
| **错误率** | 1% | < 0.1% | 异常处理、熔断 |
|
||
| **可用性** | 99.5% | 99.9% | 容灾、监控 |
|
||
|
||
---
|
||
|
||
## 24. 测试策略详细规划
|
||
|
||
### 24.1 测试金字塔
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 测试金字塔 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ ┌─────────┐ │
|
||
│ │ E2E测试 │ 10% │
|
||
│ │ (Cypress)│ │
|
||
│ ┌─┴─────────┴─┐ │
|
||
│ │ 集成测试 │ 20% │
|
||
│ │ (Jest + Supertest) │
|
||
│ ┌─┴─────────────┴─┐ │
|
||
│ │ 单元测试 │ 70% │
|
||
│ │ (Jest + Testing Library) │
|
||
│ ┌─┴─────────────────┴─┐ │
|
||
│ │ 静态检查 │ │
|
||
│ │ (ESLint + TypeScript) │
|
||
│ └─────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 24.2 测试覆盖目标
|
||
|
||
| 测试类型 | 当前覆盖率 | 目标覆盖率 | 工具 |
|
||
|---------|-----------|-----------|------|
|
||
| **单元测试** | 45% | 80% | Jest |
|
||
| **集成测试** | 20% | 60% | Jest + Supertest |
|
||
| **E2E测试** | 10% | 40% | Cypress |
|
||
| **API测试** | 30% | 80% | Postman/Newman |
|
||
| **性能测试** | 0% | 100%核心接口 | k6 |
|
||
| **安全测试** | 0% | 100%核心接口 | OWASP ZAP |
|
||
|
||
### 24.3 测试用例规范
|
||
|
||
```typescript
|
||
// 单元测试示例
|
||
describe('PricingService', () => {
|
||
describe('calculatePrice', () => {
|
||
it('should calculate correct price with profit margin', () => {
|
||
const cost = 100;
|
||
const profitMargin = 0.2;
|
||
const result = PricingService.calculatePrice(cost, profitMargin);
|
||
expect(result).toBe(125); // 100 / (1 - 0.2)
|
||
});
|
||
|
||
it('should throw error when profit margin is below threshold', () => {
|
||
const cost = 100;
|
||
const profitMargin = 0.1; // B2B最低15%
|
||
expect(() => PricingService.calculatePrice(cost, profitMargin, 'B2B'))
|
||
.toThrow('Profit margin below threshold');
|
||
});
|
||
});
|
||
});
|
||
|
||
// 集成测试示例
|
||
describe('Product API', () => {
|
||
it('should create product successfully', async () => {
|
||
const response = await request(app)
|
||
.post('/api/v1/products')
|
||
.set('Authorization', `Bearer ${token}`)
|
||
.send({
|
||
name: 'Test Product',
|
||
sku: 'TEST-001',
|
||
price: 99.99,
|
||
});
|
||
|
||
expect(response.status).toBe(201);
|
||
expect(response.body.data.name).toBe('Test Product');
|
||
});
|
||
});
|
||
|
||
// E2E测试示例
|
||
describe('Product Management', () => {
|
||
it('should create and publish product', () => {
|
||
cy.login('admin@test.com', 'password');
|
||
cy.visit('/products/create');
|
||
cy.get('[data-testid="product-name"]').type('New Product');
|
||
cy.get('[data-testid="product-sku"]').type('NP-001');
|
||
cy.get('[data-testid="product-price"]').type('199.99');
|
||
cy.get('[data-testid="submit-button"]').click();
|
||
cy.url().should('include', '/products/');
|
||
cy.get('[data-testid="product-status"]').should('contain', 'Draft');
|
||
});
|
||
});
|
||
```
|
||
|
||
### 24.4 测试环境管理
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 测试环境管理 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 环境分层 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ 开发环境 (Development) │ │
|
||
│ │ ├── 开发人员本地调试 │ │
|
||
│ │ ├── 快速迭代 │ │
|
||
│ │ └── 数据可随意修改 │ │
|
||
│ │ │ │
|
||
│ │ 测试环境 (Testing) │ │
|
||
│ │ ├── 自动化测试执行 │ │
|
||
│ │ ├── 每次部署自动重置 │ │
|
||
│ │ └── 模拟生产数据 │ │
|
||
│ │ │ │
|
||
│ │ 预发布环境 (Staging) │ │
|
||
│ │ ├── 生产数据脱敏 │ │
|
||
│ │ ├── 最终验证 │ │
|
||
│ │ └── 性能测试 │ │
|
||
│ │ │ │
|
||
│ │ 生产环境 (Production) │ │
|
||
│ │ ├── 真实用户数据 │ │
|
||
│ │ ├── 严格权限控制 │ │
|
||
│ │ └── 全量监控 │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 数据管理 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 测试数据生成 - Faker.js生成模拟数据 │ │
|
||
│ │ 数据隔离 - 每个测试套件独立数据 │ │
|
||
│ │ 数据清理 - 测试后自动清理 │ │
|
||
│ │ 数据快照 - 关键测试数据快照 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 25. 部署架构详细规划
|
||
|
||
### 25.1 部署架构图
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 部署架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 用户访问层 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ CDN (CloudFlare/阿里云CDN) │ │
|
||
│ │ ├── 静态资源缓存 │ │
|
||
│ │ ├── DDoS防护 │ │
|
||
│ │ └── SSL证书 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 负载均衡层 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Nginx / 阿里云SLB │ │
|
||
│ │ ├── 负载均衡 │ │
|
||
│ │ ├── SSL终止 │ │
|
||
│ │ └── 健康检查 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 应用服务层 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
|
||
│ │ │ Node.js │ │ Node.js │ │ Node.js │ │ │
|
||
│ │ │ Server 1 │ │ Server 2 │ │ Server 3 │ │ │
|
||
│ │ └──────────┘ └──────────┘ └──────────┘ │ │
|
||
│ │ │ │ │ │ │
|
||
│ │ └──────────────┼──────────────┘ │ │
|
||
│ │ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 数据存储层 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
|
||
│ │ │ MySQL │ │ Redis │ │ Elastic │ │ │
|
||
│ │ │ (主从) │ │ (集群) │ │ (搜索) │ │ │
|
||
│ │ └──────────┘ └──────────┘ └──────────┘ │ │
|
||
│ │ │ │
|
||
│ │ ┌──────────┐ ┌──────────┐ │ │
|
||
│ │ │ Kafka │ │ OSS/S3 │ │ │
|
||
│ │ │ (消息) │ │ (文件) │ │ │
|
||
│ │ └──────────┘ └──────────┘ │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 25.2 CI/CD流水线
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ CI/CD流水线 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 代码提交 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Git Push → GitHub/GitLab │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 代码检查 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ ESLint → TypeScript → Prettier → SonarQube │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 单元测试 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ Jest → 覆盖率检查 → 测试报告 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 构建 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ npm run build → Docker镜像构建 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 集成测试 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 部署到测试环境 → 集成测试 → E2E测试 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 部署 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ 开发分支 → 自动部署到开发环境 │ │
|
||
│ │ 测试分支 → 自动部署到测试环境 │ │
|
||
│ │ 主分支 → 自动部署到预发布环境 → 人工审批 → 生产 │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ ▼ │
|
||
│ 监控 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ 健康检查 → 性能监控 → 错误告警 │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 25.3 容灾方案
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 容灾方案 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ 数据备份 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ 数据库备份 │ │
|
||
│ │ ├── 全量备份: 每日凌晨2点 │ │
|
||
│ │ ├── 增量备份: 每小时 │ │
|
||
│ │ ├── Binlog备份: 实时 │ │
|
||
│ │ └── 异地备份: 每日同步到异地机房 │ │
|
||
│ │ │ │
|
||
│ │ 文件备份 │ │
|
||
│ │ ├── OSS跨区域复制 │ │
|
||
│ │ └── 版本控制 │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 故障恢复 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ RTO (恢复时间目标): < 1小时 │ │
|
||
│ │ RPO (恢复点目标): < 5分钟 │ │
|
||
│ │ │ │
|
||
│ │ 恢复流程: │ │
|
||
│ │ 1. 故障检测 (自动告警) │ │
|
||
│ │ 2. 故障评估 (5分钟) │ │
|
||
│ │ 3. 决策恢复方案 (10分钟) │ │
|
||
│ │ 4. 执行恢复 (30分钟) │ │
|
||
│ │ 5. 验证恢复 (15分钟) │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
│ 高可用架构 │
|
||
│ ┌─────────────────────────────────────────────────────┐ │
|
||
│ │ │ │
|
||
│ │ 应用层: 多实例部署 + 自动扩缩容 │ │
|
||
│ │ 数据库: 主从复制 + 自动故障转移 │ │
|
||
│ │ 缓存: Redis集群 + 哨兵模式 │ │
|
||
│ │ 消息: Kafka集群 + 副本机制 │ │
|
||
│ │ │ │
|
||
│ └─────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 26. 技术选型详细说明
|
||
|
||
### 26.1 前端技术选型
|
||
|
||
| 技术 | 版本 | 选型理由 | 替代方案 |
|
||
|------|------|---------|---------|
|
||
| **React** | 18.x | 生态成熟、组件化、虚拟DOM | Vue 3, Svelte |
|
||
| **UmiJS** | 4.x | 企业级框架、约定优于配置 | Next.js, Vite |
|
||
| **Ant Design** | 5.x | 企业级UI、组件丰富 | Arco Design, Semi Design |
|
||
| **TypeScript** | 5.x | 类型安全、IDE支持好 | JavaScript |
|
||
| **Zustand** | 4.x | 轻量级状态管理 | Redux, MobX |
|
||
| **TanStack Query** | 5.x | 数据获取和缓存 | SWR, RTK Query |
|
||
| **Recharts** | 2.x | React原生图表库 | ECharts, AntV |
|
||
| **Ahooks** | 3.x | React Hooks工具库 | React Use |
|
||
|
||
### 26.2 后端技术选型
|
||
|
||
| 技术 | 版本 | 选型理由 | 替代方案 |
|
||
|------|------|---------|---------|
|
||
| **Node.js** | 20.x | 高并发、JavaScript全栈 | Go, Java, Python |
|
||
| **Express** | 4.x | 成熟稳定、中间件丰富 | Koa, Fastify, NestJS |
|
||
| **TypeScript** | 5.x | 类型安全、代码质量 | JavaScript |
|
||
| **Knex.js** | 3.x | SQL构建器、灵活 | TypeORM, Prisma |
|
||
| **MySQL** | 8.0 | 事务支持、成熟稳定 | PostgreSQL, TiDB |
|
||
| **Redis** | 7.x | 高性能缓存、数据结构丰富 | Memcached, KeyDB |
|
||
| **BullMQ** | 5.x | 任务队列、可靠 | RabbitMQ, Kafka |
|
||
| **Elasticsearch** | 8.x | 全文搜索、日志分析 | Meilisearch, Typesense |
|
||
|
||
### 26.3 基础设施选型
|
||
|
||
| 技术 | 选型理由 | 替代方案 |
|
||
|------|---------|---------|
|
||
| **Docker** | 容器化部署 | Podman |
|
||
| **阿里云** | 国内云服务首选 | AWS, 腾讯云 |
|
||
| **CloudFlare** | CDN + 安全防护 | Akamai |
|
||
| **Prometheus** | 监控指标采集 | InfluxDB |
|
||
| **Grafana** | 可视化仪表盘 | Kibana |
|
||
| **ELK Stack** | 日志收集分析 | Loki |
|
||
|
||
---
|
||
|
||
## 27. 开发规范详细说明
|
||
|
||
### 27.1 代码规范
|
||
|
||
```typescript
|
||
// 文件命名规范
|
||
// 组件文件: PascalCase (ProductList.tsx)
|
||
// 工具文件: camelCase (formatPrice.ts)
|
||
// 类型文件: camelCase.types.ts (product.types.ts)
|
||
// 样式文件: 同组件名 (ProductList.module.css)
|
||
|
||
// 组件结构规范
|
||
// components/ProductCard/index.tsx
|
||
interface ProductCardProps {
|
||
product: Product;
|
||
onEdit?: (id: string) => void;
|
||
onDelete?: (id: string) => void;
|
||
}
|
||
|
||
export const ProductCard: React.FC<ProductCardProps> = ({
|
||
product,
|
||
onEdit,
|
||
onDelete,
|
||
}) => {
|
||
// 1. Hooks声明
|
||
const [isEditing, setIsEditing] = useState(false);
|
||
|
||
// 2. 计算属性
|
||
const formattedPrice = useMemo(() => {
|
||
return formatPrice(product.price, product.currency);
|
||
}, [product.price, product.currency]);
|
||
|
||
// 3. 事件处理
|
||
const handleEdit = useCallback(() => {
|
||
onEdit?.(product.id);
|
||
}, [onEdit, product.id]);
|
||
|
||
// 4. 副作用
|
||
useEffect(() => {
|
||
// 副作用逻辑
|
||
}, []);
|
||
|
||
// 5. 渲染
|
||
return (
|
||
<div className={styles.card}>
|
||
{/* 组件内容 */}
|
||
</div>
|
||
);
|
||
};
|
||
|
||
// 服务层规范
|
||
// services/ProductService.ts
|
||
export class ProductService {
|
||
/**
|
||
* 创建商品
|
||
* @taskId BE-PROD-001
|
||
* @param data 商品数据
|
||
* @returns 创建的商品
|
||
*/
|
||
async create(data: CreateProductDTO): Promise<Product> {
|
||
// 1. 参数验证
|
||
this.validateCreateData(data);
|
||
|
||
// 2. 业务逻辑
|
||
const product = await this.buildProduct(data);
|
||
|
||
// 3. 数据持久化
|
||
const saved = await this.repository.save(product);
|
||
|
||
// 4. 发布事件
|
||
await this.eventBus.publish('product.created', saved);
|
||
|
||
return saved;
|
||
}
|
||
}
|
||
```
|
||
|
||
### 27.2 Git提交规范
|
||
|
||
```
|
||
# 提交消息格式
|
||
<type>(<scope>): <subject>
|
||
|
||
<body>
|
||
|
||
<footer>
|
||
|
||
# 类型说明
|
||
feat: 新功能
|
||
fix: 修复bug
|
||
docs: 文档更新
|
||
style: 代码格式（不影响功能）
|
||
refactor: 重构（不是新功能也不是修复bug）
|
||
perf: 性能优化
|
||
test: 测试相关
|
||
chore: 构建过程或辅助工具变动
|
||
revert: 回滚
|
||
|
||
# 示例
|
||
feat(product): 添加商品批量导入功能
|
||
|
||
- 支持Excel文件导入
|
||
- 支持CSV文件导入
|
||
- 自动验证数据格式
|
||
|
||
Closes #123
|
||
```
|
||
|
||
### 27.3 API设计规范
|
||
|
||
```
|
||
# RESTful API设计规范
|
||
|
||
# URL命名
|
||
- 使用小写字母
|
||
- 使用连字符分隔单词
|
||
- 使用复数名词表示资源
|
||
- 避免嵌套超过3层
|
||
|
||
# 示例
|
||
GET /api/v1/products # 获取商品列表
|
||
GET /api/v1/products/:id # 获取单个商品
|
||
POST /api/v1/products # 创建商品
|
||
PUT /api/v1/products/:id # 更新商品
|
||
DELETE /api/v1/products/:id # 删除商品
|
||
GET /api/v1/products/:id/skus # 获取商品SKU列表
|
||
|
||
# 查询参数
|
||
?page=1&pageSize=20 # 分页
|
||
&sort=created_at:desc # 排序
|
||
&filter=status:active # 过滤
|
||
&fields=id,name,price # 字段选择
|
||
|
||
# 响应状态码
|
||
200 OK # 成功
|
||
201 Created # 创建成功
|
||
204 No Content # 删除成功
|
||
400 Bad Request # 参数错误
|
||
401 Unauthorized # 未认证
|
||
403 Forbidden # 无权限
|
||
404 Not Found # 资源不存在
|
||
422 Unprocessable Entity # 业务错误
|
||
500 Internal Server Error # 服务器错误
|
||
```
|
||
|
||
---
|
||
|
||
## 28. 项目依赖清单
|
||
|
||
### 28.1 前端依赖
|
||
|
||
```json
|
||
{
|
||
"dependencies": {
|
||
"react": "^18.2.0",
|
||
"react-dom": "^18.2.0",
|
||
"umi": "^4.3.0",
|
||
"@ant-design/pro-components": "^2.6.0",
|
||
"antd": "^5.12.0",
|
||
"@tanstack/react-query": "^5.17.0",
|
||
"zustand": "^4.4.0",
|
||
"ahooks": "^3.7.0",
|
||
"recharts": "^2.10.0",
|
||
"dayjs": "^1.11.0",
|
||
"lodash-es": "^4.17.0",
|
||
"axios": "^1.6.0"
|
||
},
|
||
"devDependencies": {
|
||
"@types/react": "^18.2.0",
|
||
"@types/lodash-es": "^4.17.0",
|
||
"typescript": "^5.3.0",
|
||
"eslint": "^8.56.0",
|
||
"prettier": "^3.2.0",
|
||
"jest": "^29.7.0",
|
||
"@testing-library/react": "^14.1.0",
|
||
"cypress": "^13.6.0"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 28.2 后端依赖
|
||
|
||
```json
|
||
{
|
||
"dependencies": {
|
||
"express": "^4.18.0",
|
||
"knex": "^3.1.0",
|
||
"mysql2": "^3.6.0",
|
||
"redis": "^4.6.0",
|
||
"bullmq": "^5.1.0",
|
||
"ioredis": "^5.3.0",
|
||
"jsonwebtoken": "^9.0.0",
|
||
"bcryptjs": "^2.4.0",
|
||
"joi": "^17.11.0",
|
||
"winston": "^3.11.0",
|
||
"axios": "^1.6.0",
|
||
"dayjs": "^1.11.0",
|
||
"uuid": "^9.0.0"
|
||
},
|
||
"devDependencies": {
|
||
"@types/express": "^4.17.0",
|
||
"@types/node": "^20.10.0",
|
||
"typescript": "^5.3.0",
|
||
"eslint": "^8.56.0",
|
||
"prettier": "^3.2.0",
|
||
"jest": "^29.7.0",
|
||
"supertest": "^6.3.0",
|
||
"nodemon": "^3.0.0"
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 29. 附录
|
||
|
||
### 29.1 术语表
|
||
|
||
| 术语 | 说明 |
|
||
|------|------|
|
||
| **TOC** | To Consumer，面向消费者的零售模式 |
|
||
| **TOB** | To Business，面向企业的批发模式 |
|
||
| **DTC** | Direct To Consumer，品牌直营模式 |
|
||
| **SKU** | Stock Keeping Unit，库存单位 |
|
||
| **ROAS** | Return On Ad Spend，广告支出回报率 |
|
||
| **GMV** | Gross Merchandise Volume，商品交易总额 |
|
||
| **AOV** | Average Order Value，平均订单价值 |
|
||
| **CAC** | Customer Acquisition Cost，客户获取成本 |
|
||
| **LTV** | Life Time Value，客户终身价值 |
|
||
| **CDC** | Change Data Capture，变更数据捕获 |
|
||
| **CQRS** | Command Query Responsibility Segregation，命令查询职责分离 |
|
||
| **DDD** | Domain-Driven Design，领域驱动设计 |
|
||
|
||
### 29.2 参考文档
|
||
|
||
- [项目特定规则](./00_Business/project-specific-rules.md)
|
||
- [业务闭环文档](./00_Business/Business_ClosedLoops.md)
|
||
- [任务概览](./00_Business/Task_Overview.md)
|
||
- [开发进度](./Development_Progress.md)
|
||
- [架构设计文档](./01_Architecture/)
|
||
- [AI规范文档](./05_AI/)
|
||
|
||
### 29.3 更新日志
|
||
|
||
| 日期 | 版本 | 更新内容 |
|
||
|------|------|---------|
|
||
| 2026-03-19 | v1.0 | 创建文档，包含14个核心章节 |
|
||
| 2026-03-19 | v1.1 | 补充前端详细规划（第15章） |
|
||
| 2026-03-19 | v1.2 | 补充后端详细规划（第16章） |
|
||
| 2026-03-19 | v1.3 | 补充数据架构规划（第17章） |
|
||
| 2026-03-19 | v1.4 | 补充插件生态规划（第18章） |
|
||
| 2026-03-19 | v1.5 | 补充业务实现细节（第19章） |
|
||
| 2026-03-19 | v1.6 | 补充运维监控规划（第20章） |
|
||
| 2026-03-19 | v1.7 | 补充多租户架构设计（第21章） |
|
||
| 2026-03-19 | v1.8 | 补充安全架构设计（第22章） |
|
||
| 2026-03-19 | v1.9 | 补充性能优化方案（第23章） |
|
||
| 2026-03-19 | v2.0 | 补充测试策略、部署架构、技术选型、开发规范等（第24-28章） |
|
||
| 2026-03-19 | v2.1 | 添加实现状态标记（✅/🔄/📋）、核心业务链路图、200+服务上下游链路标注 |
|
||
|
||
---
|
||
|
||
*本文档由 AI-Architect-1 创建和维护，如有疑问请联系项目组。*
|