makemd/docs/01_Architecture/18_Global_Features_Plan.md

全局功能方案

创建日期: 2026-03-20
状态: 设计中
优先级: 最高

---

1. 全局功能架构

1.1 功能模块总览

┌─────────────────────────────────────────────────────────────────────────────┐
│                          Crawlful Hub 功能架构                               │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                        业务功能层 (Business Layer)                    │   │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐       │   │
│  │  │ 商品管理 │ │ 订单管理 │ │ 营销管理 │ │ 财务管理 │ │ 库存管理 │       │   │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘       │   │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐       │   │
│  │  │ 物流管理 │ │ B2B贸易 │ │ 合规管理 │ │ 多商户  │ │ 客户服务 │       │   │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘       │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                        AI自动化层 (AI Layer)                          │   │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐       │   │
│  │  │ 自动选品 │ │ 自动定价 │ │ 自动上架 │ │ 智能客服 │ │ 异常检测 │       │   │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘       │   │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐       │   │
│  │  │ 跨境套利 │ │ 广告优化 │ │ 库存预测 │ │ 风险预警 │ │ 策略市场 │       │   │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘       │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                        Agent执行层 (Agent Layer)                      │   │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐       │   │
│  │  │ 平台采集 │ │ 自动刊登 │ │ 订单处理 │ │ 广告投放 │ │ 库存同步 │       │   │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘       │   │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐       │   │
│  │  │ 价格调整 │ │ 退货处理 │ │ 客服回复 │ │ 数据同步 │ │ 健康监控 │       │   │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘       │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                        后台管理层 (Admin Layer)                       │   │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐       │   │
│  │  │ 用户管理 │ │ 租户管理 │ │ 权限管理 │ │ 审批流程 │ │ 审计日志 │       │   │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘       │   │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐       │   │
│  │  │ 配额管理 │ │ 系统配置 │ │ 监控告警 │ │ 数据分析 │ │ 报表中心 │       │   │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘       │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                        基础设施层 (Infrastructure Layer)              │   │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐       │   │
│  │  │ 数据库   │ │ 缓存    │ │ 消息队列 │ │ 任务调度 │ │ 日志系统 │       │   │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘       │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

---

2. 业务功能模块

2.1 商品管理模块

功能	描述	前端页面	后端服务
商品采集	多平台商品数据采集	ProductList	ProductService, Node Agent
商品编辑	商品信息编辑、SKU管理	ProductDetail	ProductService
商品刊登	多平台一键刊登	ProductPublishForm	AutoListingService
商品定价	智能定价、利润计算	AIPricing	PricingService
商品分析	ROI分析、利润监控	ROIAnalysis, ProfitMonitor	ArbitrageService
跨平台管理	多平台商品同步	CrossPlatformManage	ProductService

2.2 订单管理模块

功能	描述	前端页面	后端服务
订单列表	订单查询、筛选、导出	OrderList	OrderService
订单详情	订单详细信息、操作	OrderDetail	OrderService
异常订单	异常订单处理	ExceptionOrder	OrderService
订单聚合	多店铺订单汇总	OrderAggregation	OrderAggregationService
订单履约	发货、物流跟踪	-	UnifiedFulfillmentService

2.3 营销管理模块

功能	描述	前端页面	后端服务
广告计划	广告创建、管理	AdPlanPage	MarketingService
广告投放	自动投放、优化	AdDelivery	AdOpsService
ROI分析	广告效果分析	ROIAnalysis	MarketingService
竞品分析	竞品监控、分析	Competitors	CompetitorService
A/B测试	策略测试优化	ABTestConfig, ABTestResults	ABTestService

2.4 财务管理模块

功能	描述	前端页面	后端服务
交易记录	交易流水查询	Transactions	FinanceService
资金对账	多平台对账	Reconciliation	ReconciliationService
利润核算	利润计算、分析	ProfitReport	OrderProfitService
结算管理	商户结算	MerchantSettlementManage	SettlementService

2.5 库存管理模块

功能	描述	前端页面	后端服务
库存查询	库存实时查询	InventoryForecast	InventoryService
库存预测	AI库存预测	InventoryForecast	InventoryForecastService
仓库管理	多仓库管理	Warehouses	WMSWaveService
补货建议	智能补货建议	-	InventoryRLOptimizerService

2.6 物流管理模块

功能	描述	前端页面	后端服务
物流跟踪	订单物流追踪	LogisticsTrack	LogisticsTrackerService
运费计算	智能运费计算	FreightCalc	DynamicShippingService
物流渠道	渠道选择管理	LogisticsSelect	LogisticsService

2.7 B2B贸易模块

功能	描述	前端页面	后端服务
企业报价	B2B报价管理	EnterpriseQuote	B2BTradeService
批量订单	批量订单处理	BatchOrder	B2BTradeService
合同管理	合同创建、管理	ContractManage	B2BTradeService

2.8 合规管理模块

功能	描述	前端页面	后端服务
证书管理	合规证书管理	CertificateManage	CertificateDatabaseService
合规检查	自动合规检查	ComplianceCheck	ComplianceService
证书提醒	过期提醒	CertificateExpiryReminder	CertificateDatabaseService

2.9 多商户模块

功能	描述	前端页面	后端服务
商户管理	商户入驻、管理	MerchantManage	MerchantService
商户订单	商户订单管理	MerchantOrderManage	MerchantOrderService
商户店铺	商户店铺管理	MerchantShopManage	MerchantShopService
商户结算	商户结算管理	MerchantSettlementManage	MerchantSettlementService

2.10 客户服务模块

功能	描述	前端页面	后端服务
客服中心	客服工单管理	CustomerService	CustomerService
售后处理	退货、退款处理	RefundProcess, ReturnApply	AfterSalesService
客户资产	会员、积分管理	MemberLevel, PointsManage	UserAssetService

---

3. AI自动化模块

3.1 自动选品

interface AutoSelectionConfig {
  platforms: string[];
  categories: string[];
  priceRange: { min: number; max: number };
  profitThreshold: number;
  scoreWeights: {
    profitRate: number;
    salesVolume: number;
    competition: number;
    trend: number;
  };
}

3.2 自动定价

interface AutoPricingConfig {
  strategy: 'MAX_PROFIT' | 'MAX_VOLUME' | 'BALANCED';
  minProfitRate: number;
  competitorTracking: boolean;
  dynamicAdjustment: boolean;
  adjustmentFrequency: 'HOURLY' | 'DAILY' | 'WEEKLY';
}

3.3 自动上架

interface AutoListingConfig {
  platforms: string[];
  auto_pricing: boolean;
  auto_description: boolean;
  auto_images: boolean;
  schedule: {
    startTime: string;
    endTime: string;
    interval: number;
  };
}

3.4 智能客服

interface ChatBotConfig {
  enabled: boolean;
  autoReply: boolean;
  intentRecognition: boolean;
  escalationThreshold: number;
  supportedLanguages: string[];
}

3.5 异常检测

interface AnomalyDetectionConfig {
  metrics: string[];
  thresholds: Record<string, number>;
  alertChannels: ('EMAIL' | 'SMS' | 'WEBHOOK')[];
  autoRecovery: boolean;
}

---

4. Agent执行模块

4.1 平台采集Agent

平台	采集内容	适配器
TikTok Shop	商品、订单、广告	TikTokAdapter
Temu	商品、订单	TemuAdapter
Amazon	商品、订单、广告	AmazonAdapter
Shopee	商品、订单	ShopeeAdapter
AliExpress	商品、订单	AliExpressAdapter
1688	商品、供应商	Ali1688Adapter

4.2 自动化操作Agent

操作	描述	触发方式
商品刊登	自动刊登到目标平台	定时/手动
价格调整	根据策略调整价格	定时/事件
库存同步	多平台库存同步	定时/事件
订单处理	自动确认、发货	事件驱动
广告投放	自动创建、优化广告	定时/事件
客服回复	自动回复客户消息	事件驱动

4.3 Agent任务调度

interface AgentTaskScheduler {
  // 任务优先级
  priority: 'HIGH' | 'MEDIUM' | 'LOW';
  
  // 任务依赖
  dependencies: string[];
  
  // 重试策略
  retry: {
    maxAttempts: number;
    backoff: 'LINEAR' | 'EXPONENTIAL';
    interval: number;
  };
  
  // 超时设置
  timeout: number;
  
  // 并发控制
  concurrency: {
    maxConcurrent: number;
    perShop: number;
  };
}

---

5. 后台管理模块

5.1 用户管理

功能	描述	权限
用户列表	用户CRUD操作	ADMIN
角色管理	角色定义、权限分配	ADMIN
权限管理	细粒度权限控制	ADMIN
登录日志	登录记录查询	ADMIN, MANAGER

5.2 租户管理

功能	描述	权限
租户列表	租户CRUD操作	SUPER_ADMIN
租户配置	租户级配置管理	ADMIN
租户隔离	数据隔离验证	SYSTEM
配额管理	租户资源配额	ADMIN

5.3 审批流程

功能	描述	触发场景
价格审批	价格变动审批	利润率低于阈值
退款审批	退款申请审批	大额退款
订单审批	特殊订单审批	异常订单
合同审批	B2B合同审批	新合同签订

5.4 审计日志

功能	描述	存储方式
操作日志	用户操作记录	数据库
系统日志	系统事件记录	文件 + 数据库
审计追溯	操作链路追溯	数据库
合规报告	合规性报告生成	定时生成

5.5 监控告警

功能	描述	通知方式
系统监控	服务健康状态	Dashboard + 邮件
业务监控	业务指标监控	Dashboard + 邮件
异常告警	异常事件告警	邮件 + 短信 + Webhook
性能监控	性能指标监控	Dashboard

5.6 数据分析

功能	描述	输出方式
业务报表	业务数据报表	Dashboard + 导出
趋势分析	数据趋势分析	Dashboard
对比分析	多维度对比	Dashboard
预测分析	AI预测分析	Dashboard

---

6. 功能权限矩阵

角色	商品	订单	营销	财务	库存	B2B	合规	商户	系统
ADMIN	✅	✅	✅	✅	✅	✅	✅	✅	✅
MANAGER	✅	✅	✅	✅	✅	✅	✅	✅	❌
OPERATOR	✅	✅	✅	❌	✅	✅	❌	❌	❌
FINANCE	❌	❌	❌	✅	❌	✅	❌	✅	❌
SOURCING	✅	❌	❌	❌	✅	✅	❌	❌	❌
LOGISTICS	❌	✅	❌	❌	✅	❌	❌	❌	❌
ANALYST	👁️	👁️	👁️	👁️	👁️	👁️	👁️	👁️	❌

---

7. 实现路线图

Phase 1: 核心功能 (Week 1-2)

• 商品管理闭环
• 订单管理闭环
• 财务管理闭环
• 用户权限管理

Phase 2: 业务扩展 (Week 3-4)

• 营销管理闭环
• 库存管理闭环
• 物流管理闭环
• B2B贸易闭环

Phase 3: AI自动化 (Week 5-6)

• 自动选品
• 自动定价
• 自动上架
• 智能客服

Phase 4: Agent执行 (Week 7-8)

• Node Agent部署
• 平台适配器完善
• 任务调度优化
• 反检测增强

Phase 5: 后台管理 (Week 9-10)

• 审批流程
• 审计日志
• 监控告警
• 数据分析

---

8. 相关文档

• 前后端插件闭环架构
• 业务闭环总览
• 服务编排总图
• Node Agent设计

---

最后更新: 2026-03-20