Files
makemd/docs/01_Architecture/18_Global_Features_Plan.md

411 lines
19 KiB
Markdown
Raw Normal View History

# 全局功能方案
> **创建日期**: 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 自动选品
```typescript
interface AutoSelectionConfig {
platforms: string[];
categories: string[];
priceRange: { min: number; max: number };
profitThreshold: number;
scoreWeights: {
profitRate: number;
salesVolume: number;
competition: number;
trend: number;
};
}
```
### 3.2 自动定价
```typescript
interface AutoPricingConfig {
strategy: 'MAX_PROFIT' | 'MAX_VOLUME' | 'BALANCED';
minProfitRate: number;
competitorTracking: boolean;
dynamicAdjustment: boolean;
adjustmentFrequency: 'HOURLY' | 'DAILY' | 'WEEKLY';
}
```
### 3.3 自动上架
```typescript
interface AutoListingConfig {
platforms: string[];
auto_pricing: boolean;
auto_description: boolean;
auto_images: boolean;
schedule: {
startTime: string;
endTime: string;
interval: number;
};
}
```
### 3.4 智能客服
```typescript
interface ChatBotConfig {
enabled: boolean;
autoReply: boolean;
intentRecognition: boolean;
escalationThreshold: number;
supportedLanguages: string[];
}
```
### 3.5 异常检测
```typescript
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任务调度
```typescript
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)
- [x] 商品管理闭环
- [x] 订单管理闭环
- [x] 财务管理闭环
- [x] 用户权限管理
### Phase 2: 业务扩展 (Week 3-4)
- [x] 营销管理闭环
- [x] 库存管理闭环
- [x] 物流管理闭环
- [x] B2B贸易闭环
### Phase 3: AI自动化 (Week 5-6)
- [x] 自动选品
- [x] 自动定价
- [x] 自动上架
- [x] 智能客服
### Phase 4: Agent执行 (Week 7-8)
- [ ] Node Agent部署
- [ ] 平台适配器完善
- [ ] 任务调度优化
- [ ] 反检测增强
### Phase 5: 后台管理 (Week 9-10)
- [x] 审批流程
- [x] 审计日志
- [x] 监控告警
- [x] 数据分析
---
## 8. 相关文档
- [前后端插件闭环架构](./17_Frontend_Backend_Plugin_ClosedLoop.md)
- [业务闭环总览](../00_Business/Business_ClosedLoops.md)
- [服务编排总图](./04_Service_Map.md)
- [Node Agent设计](../04_Plugin/01_NodeAgent_Design.md)
---
*最后更新: 2026-03-20*