refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
This commit is contained in:
35
docs/SERVICES/_index.md
Normal file
35
docs/SERVICES/_index.md
Normal file
@@ -0,0 +1,35 @@
|
||||
# 服务地图索引
|
||||
|
||||
> **入口**: [../README.md](../README.md)
|
||||
|
||||
---
|
||||
|
||||
## 服务文件
|
||||
|
||||
| 文件 | 内容 | 大小 |
|
||||
|------|------|------|
|
||||
| [product.md](product.md) | 商品域服务 | ~300行 |
|
||||
| [order.md](order.md) | 订单域服务 | ~300行 |
|
||||
| [inventory.md](inventory.md) | 库存域服务 | ~200行 |
|
||||
| [finance.md](finance.md) | 财务域服务 | ~200行 |
|
||||
| [marketing.md](marketing.md) | 营销域服务 | ~200行 |
|
||||
| [collection.md](collection.md) | 采集域服务 | ~200行 |
|
||||
|
||||
---
|
||||
|
||||
## 服务命名规范
|
||||
|
||||
| 后缀 | 说明 | 示例 |
|
||||
|------|------|------|
|
||||
| Service | 业务服务 | ProductService |
|
||||
| Repository | 数据访问 | ProductRepository |
|
||||
| Connector | 平台连接 | ShopifyConnector |
|
||||
| Orchestrator | 编排器 | PublishOrchestrator |
|
||||
|
||||
---
|
||||
|
||||
## 🔗 相关文档
|
||||
|
||||
- [规则中心](../RULES/_index.md)
|
||||
- [架构设计](../ARCH/_index.md)
|
||||
- [业务闭环](../LOOPS/_index.md)
|
||||
112
docs/SERVICES/collection.md
Normal file
112
docs/SERVICES/collection.md
Normal file
@@ -0,0 +1,112 @@
|
||||
# 采集域服务
|
||||
|
||||
> **入口**: [_index.md](_index.md)
|
||||
|
||||
---
|
||||
|
||||
## 服务列表
|
||||
|
||||
| 服务 | 文件 | 职责 |
|
||||
|------|------|------|
|
||||
| CollectionAdapterService | services/CollectionAdapterService.ts | 采集适配 |
|
||||
| TikTokConnector | core/connectors/TikTokConnector.ts | TikTok采集 |
|
||||
| TemuConnector | core/connectors/TemuConnector.ts | Temu采集 |
|
||||
| ShopifyConnector | core/connectors/ShopifyConnector.ts | Shopify采集 |
|
||||
|
||||
---
|
||||
|
||||
## 核心流程
|
||||
|
||||
```
|
||||
创建采集任务 → 选择连接器 → 执行采集 → 数据解析 → 存储入库
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## CollectionAdapterService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| createTask | 创建任务 | CreateRequest | CollectionTask |
|
||||
| executeTask | 执行任务 | taskId | CollectionResult |
|
||||
| getTaskStatus | 获取状态 | taskId | TaskStatus |
|
||||
| cancelTask | 取消任务 | taskId | void |
|
||||
|
||||
---
|
||||
|
||||
## Connector接口
|
||||
|
||||
```typescript
|
||||
interface IPlatformConnector {
|
||||
platformCode: string;
|
||||
capabilities: {
|
||||
hasApi: boolean;
|
||||
supportsPriceSync: boolean;
|
||||
supportsInventorySync: boolean;
|
||||
supportsOrderPull: boolean;
|
||||
};
|
||||
|
||||
pullProducts(shopId: string): Promise<PlatformProduct[]>;
|
||||
pullOrders(shopId: string): Promise<PlatformOrder[]>;
|
||||
pushListing(product: Product): Promise<ListingResult>;
|
||||
updatePrice(listingId: string, price: number): Promise<void>;
|
||||
syncInventory(listingId: string, stock: number): Promise<void>;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 已实现连接器
|
||||
|
||||
| 连接器 | 平台 | 能力 |
|
||||
|--------|------|------|
|
||||
| ShopifyConnector | Shopify | API全功能 |
|
||||
| AmazonConnector | Amazon | API全功能 |
|
||||
| TikTokConnector | TikTok Shop | API+采集 |
|
||||
| TemuConnector | Temu | 采集 |
|
||||
| ShopeeConnector | Shopee | API+采集 |
|
||||
|
||||
---
|
||||
|
||||
## 待实现连接器
|
||||
|
||||
| 连接器 | 平台 | 优先级 |
|
||||
|--------|------|--------|
|
||||
| Alibaba1688Connector | 1688 | P0 |
|
||||
| TikTokAdsConnector | TikTok Ads | P0 |
|
||||
| FacebookAdsConnector | Facebook Ads | P0 |
|
||||
| GoogleAdsConnector | Google Ads | P0 |
|
||||
|
||||
---
|
||||
|
||||
## 状态机
|
||||
|
||||
```
|
||||
PENDING → RUNNING → COMPLETED
|
||||
↓
|
||||
FAILED
|
||||
```
|
||||
|
||||
| 状态 | 说明 |
|
||||
|------|------|
|
||||
| PENDING | 待执行 |
|
||||
| RUNNING | 执行中 |
|
||||
| COMPLETED | 已完成 |
|
||||
| FAILED | 失败 |
|
||||
|
||||
---
|
||||
|
||||
## API端点
|
||||
|
||||
| 端点 | 方法 | 服务方法 |
|
||||
|------|------|----------|
|
||||
| /api/v1/collection/tasks | POST | CollectionAdapterService.createTask |
|
||||
| /api/v1/collection/tasks/:id | GET | CollectionAdapterService.getTaskStatus |
|
||||
| /api/v1/collection/tasks/:id/execute | POST | CollectionAdapterService.executeTask |
|
||||
| /api/v1/collection/tasks/:id/cancel | POST | CollectionAdapterService.cancelTask |
|
||||
|
||||
---
|
||||
|
||||
*最后更新: 2026-03-22*
|
||||
110
docs/SERVICES/finance.md
Normal file
110
docs/SERVICES/finance.md
Normal file
@@ -0,0 +1,110 @@
|
||||
# 财务域服务
|
||||
|
||||
> **入口**: [_index.md](_index.md)
|
||||
|
||||
---
|
||||
|
||||
## 服务列表
|
||||
|
||||
| 服务 | 文件 | 职责 |
|
||||
|------|------|------|
|
||||
| FinanceService | services/FinanceService.ts | 财务管理 |
|
||||
| ReconciliationService | services/ReconciliationService.ts | 对账管理 |
|
||||
| SettlementService | services/SettlementService.ts | 结算管理 |
|
||||
|
||||
---
|
||||
|
||||
## 核心流程
|
||||
|
||||
```
|
||||
订单完成 → 对账 → 结算 → 利润核算
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## FinanceService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| getOverview | 财务概览 | tenantId | FinanceOverview |
|
||||
| getProfit | 利润计算 | orderId | Profit |
|
||||
| getReport | 财务报表 | params | Report |
|
||||
|
||||
---
|
||||
|
||||
## ReconciliationService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| reconcile | 执行对账 | params | ReconciliationResult |
|
||||
| getDiscrepancies | 获取差异 | reconciliationId | Discrepancy[] |
|
||||
| resolve | 解决差异 | discrepancyId, resolution | void |
|
||||
|
||||
---
|
||||
|
||||
## SettlementService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | 结算列表 | params | Settlement[] |
|
||||
| get | 结算详情 | id | Settlement |
|
||||
| create | 创建结算 | CreateRequest | Settlement |
|
||||
| confirm | 确认结算 | id | Settlement |
|
||||
|
||||
---
|
||||
|
||||
## 利润计算
|
||||
|
||||
### 计算公式
|
||||
|
||||
```
|
||||
净利润 = 售价 - 采购成本 - 平台费用 - 物流费用 - 税费 - 汇率对冲 - 售后损耗 - 广告摊销
|
||||
|
||||
利润率 = 净利润 / 售价 × 100%
|
||||
```
|
||||
|
||||
### 利润红线
|
||||
|
||||
| 业务类型 | 阈值 | 处理 |
|
||||
|---------|------|------|
|
||||
| TOC | < 20% | 风控预警 |
|
||||
| TOB | < 15% | 禁止报价 |
|
||||
|
||||
---
|
||||
|
||||
## 状态机
|
||||
|
||||
```
|
||||
PENDING → PROCESSING → COMPLETED
|
||||
↓
|
||||
FAILED
|
||||
```
|
||||
|
||||
| 状态 | 说明 |
|
||||
|------|------|
|
||||
| PENDING | 待处理 |
|
||||
| PROCESSING | 处理中 |
|
||||
| COMPLETED | 已完成 |
|
||||
| FAILED | 失败 |
|
||||
|
||||
---
|
||||
|
||||
## API端点
|
||||
|
||||
| 端点 | 方法 | 服务方法 |
|
||||
|------|------|----------|
|
||||
| /api/v1/finance/overview | GET | FinanceService.getOverview |
|
||||
| /api/v1/finance/profit/:orderId | GET | FinanceService.getProfit |
|
||||
| /api/v1/reconciliation | POST | ReconciliationService.reconcile |
|
||||
| /api/v1/settlements | GET | SettlementService.list |
|
||||
| /api/v1/settlements | POST | SettlementService.create |
|
||||
|
||||
---
|
||||
|
||||
*最后更新: 2026-03-22*
|
||||
105
docs/SERVICES/inventory.md
Normal file
105
docs/SERVICES/inventory.md
Normal file
@@ -0,0 +1,105 @@
|
||||
# 库存域服务
|
||||
|
||||
> **入口**: [_index.md](_index.md)
|
||||
|
||||
---
|
||||
|
||||
## 服务列表
|
||||
|
||||
| 服务 | 文件 | 职责 |
|
||||
|------|------|------|
|
||||
| InventoryService | services/InventoryService.ts | 库存管理 |
|
||||
| WarehouseService | services/WarehouseService.ts | 仓库管理 |
|
||||
| ReplenishmentService | services/ReplenishmentService.ts | 补货管理 |
|
||||
|
||||
---
|
||||
|
||||
## 核心流程
|
||||
|
||||
```
|
||||
库存查询 → 库存调整 → 库存预警 → 自动补货
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## InventoryService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | 库存列表 | ListParams | Inventory[] |
|
||||
| get | 库存详情 | skuId | Inventory |
|
||||
| updateStock | 更新库存 | skuId, quantity, type | Inventory |
|
||||
| reserve | 预留库存 | skuId, quantity | Inventory |
|
||||
| release | 释放预留 | skuId, quantity | Inventory |
|
||||
|
||||
### 库存操作类型
|
||||
|
||||
| 类型 | 说明 |
|
||||
|------|------|
|
||||
| IN | 入库 |
|
||||
| OUT | 出库 |
|
||||
| ADJUST | 调整 |
|
||||
| RESERVE | 预留 |
|
||||
| RELEASE | 释放 |
|
||||
|
||||
---
|
||||
|
||||
## WarehouseService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | 仓库列表 | tenantId | Warehouse[] |
|
||||
| get | 仓库详情 | id | Warehouse |
|
||||
| create | 创建仓库 | CreateRequest | Warehouse |
|
||||
| update | 更新仓库 | id, UpdateRequest | Warehouse |
|
||||
|
||||
---
|
||||
|
||||
## ReplenishmentService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| checkAlert | 检查预警 | tenantId | Alert[] |
|
||||
| createOrder | 创建补货单 | CreateRequest | ReplenishmentOrder |
|
||||
| getOrder | 获取补货单 | id | ReplenishmentOrder |
|
||||
|
||||
---
|
||||
|
||||
## 状态机
|
||||
|
||||
```
|
||||
IN_STOCK → LOW_STOCK → OUT_OF_STOCK
|
||||
↑ ↓ ↓
|
||||
└───────────┴────────────┘
|
||||
(补货后恢复)
|
||||
```
|
||||
|
||||
| 状态 | 说明 | 触发条件 |
|
||||
|------|------|---------|
|
||||
| IN_STOCK | 有库存 | quantity > threshold |
|
||||
| LOW_STOCK | 低库存 | quantity ≤ threshold |
|
||||
| OUT_OF_STOCK | 缺货 | quantity = 0 |
|
||||
| RESERVED | 预留 | 有预留数量 |
|
||||
|
||||
---
|
||||
|
||||
## API端点
|
||||
|
||||
| 端点 | 方法 | 服务方法 |
|
||||
|------|------|----------|
|
||||
| /api/v1/inventory | GET | InventoryService.list |
|
||||
| /api/v1/inventory/:skuId | GET | InventoryService.get |
|
||||
| /api/v1/inventory/:skuId/stock | PUT | InventoryService.updateStock |
|
||||
| /api/v1/warehouses | GET | WarehouseService.list |
|
||||
| /api/v1/warehouses | POST | WarehouseService.create |
|
||||
| /api/v1/replenishment/alerts | GET | ReplenishmentService.checkAlert |
|
||||
|
||||
---
|
||||
|
||||
*最后更新: 2026-03-22*
|
||||
100
docs/SERVICES/marketing.md
Normal file
100
docs/SERVICES/marketing.md
Normal file
@@ -0,0 +1,100 @@
|
||||
# 营销域服务
|
||||
|
||||
> **入口**: [_index.md](_index.md)
|
||||
|
||||
---
|
||||
|
||||
## 服务列表
|
||||
|
||||
| 服务 | 文件 | 职责 |
|
||||
|------|------|------|
|
||||
| CampaignService | services/CampaignService.ts | 广告计划管理 |
|
||||
| AdService | services/AdService.ts | 广告管理 |
|
||||
| AnalyticsService | services/AnalyticsService.ts | 数据分析 |
|
||||
|
||||
---
|
||||
|
||||
## 核心流程
|
||||
|
||||
```
|
||||
创建计划 → 创建广告 → 投放 → 监控 → 优化
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## CampaignService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | 计划列表 | params | Campaign[] |
|
||||
| get | 计划详情 | id | Campaign |
|
||||
| create | 创建计划 | CreateRequest | Campaign |
|
||||
| update | 更新计划 | id, UpdateRequest | Campaign |
|
||||
| start | 启动计划 | id | Campaign |
|
||||
| pause | 暂停计划 | id | Campaign |
|
||||
|
||||
---
|
||||
|
||||
## AdService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | 广告列表 | campaignId | Ad[] |
|
||||
| get | 广告详情 | id | Ad |
|
||||
| create | 创建广告 | CreateRequest | Ad |
|
||||
| update | 更新广告 | id, UpdateRequest | Ad |
|
||||
| getPerformance | 获取表现 | id | Performance |
|
||||
|
||||
---
|
||||
|
||||
## AnalyticsService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| getDashboard | 获取仪表盘 | params | Dashboard |
|
||||
| getMetrics | 获取指标 | params | Metrics |
|
||||
| getReport | 获取报告 | params | Report |
|
||||
|
||||
---
|
||||
|
||||
## 状态机
|
||||
|
||||
```
|
||||
DRAFT → PENDING_REVIEW → ACTIVE → PAUSED → COMPLETED
|
||||
↓
|
||||
ARCHIVED
|
||||
```
|
||||
|
||||
| 状态 | 说明 |
|
||||
|------|------|
|
||||
| DRAFT | 草稿 |
|
||||
| PENDING_REVIEW | 待审核 |
|
||||
| ACTIVE | 投放中 |
|
||||
| PAUSED | 已暂停 |
|
||||
| COMPLETED | 已完成 |
|
||||
| ARCHIVED | 已归档 |
|
||||
|
||||
---
|
||||
|
||||
## API端点
|
||||
|
||||
| 端点 | 方法 | 服务方法 |
|
||||
|------|------|----------|
|
||||
| /api/v1/campaigns | GET | CampaignService.list |
|
||||
| /api/v1/campaigns | POST | CampaignService.create |
|
||||
| /api/v1/campaigns/:id | GET | CampaignService.get |
|
||||
| /api/v1/campaigns/:id/start | POST | CampaignService.start |
|
||||
| /api/v1/campaigns/:id/pause | POST | CampaignService.pause |
|
||||
| /api/v1/campaigns/:id/ads | GET | AdService.list |
|
||||
| /api/v1/ads | POST | AdService.create |
|
||||
| /api/v1/analytics/dashboard | GET | AnalyticsService.getDashboard |
|
||||
|
||||
---
|
||||
|
||||
*最后更新: 2026-03-22*
|
||||
106
docs/SERVICES/order.md
Normal file
106
docs/SERVICES/order.md
Normal file
@@ -0,0 +1,106 @@
|
||||
# 订单域服务
|
||||
|
||||
> **入口**: [_index.md](_index.md)
|
||||
|
||||
---
|
||||
|
||||
## 服务列表
|
||||
|
||||
| 服务 | 文件 | 职责 |
|
||||
|------|------|------|
|
||||
| OrderService | services/OrderService.ts | 订单管理 |
|
||||
| FulfillmentService | services/FulfillmentService.ts | 订单履约 |
|
||||
| AfterSalesService | services/AfterSalesService.ts | 售后处理 |
|
||||
|
||||
---
|
||||
|
||||
## 核心流程
|
||||
|
||||
```
|
||||
订单创建 → 确认 → 处理 → 发货 → 送达 → 完成
|
||||
↓
|
||||
售后退货 ← ← ← ← ←
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## OrderService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | 订单列表 | ListParams | Order[] |
|
||||
| get | 订单详情 | id | Order |
|
||||
| create | 创建订单 | CreateRequest | Order |
|
||||
| update | 更新订单 | id, UpdateRequest | Order |
|
||||
| cancel | 取消订单 | id, reason | Order |
|
||||
| confirm | 确认订单 | id | Order |
|
||||
|
||||
---
|
||||
|
||||
## FulfillmentService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| create | 创建履约 | CreateRequest | Fulfillment |
|
||||
| ship | 发货 | id, trackingInfo | Fulfillment |
|
||||
| deliver | 送达 | id | Fulfillment |
|
||||
| getTracking | 获取物流 | id | TrackingInfo |
|
||||
|
||||
---
|
||||
|
||||
## AfterSalesService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| create | 创建售后 | CreateRequest | AfterSales |
|
||||
| approve | 批准 | id | AfterSales |
|
||||
| reject | 拒绝 | id, reason | AfterSales |
|
||||
| refund | 退款 | id | AfterSales |
|
||||
| return | 退货 | id, returnInfo | AfterSales |
|
||||
|
||||
---
|
||||
|
||||
## 状态机
|
||||
|
||||
```
|
||||
PENDING → CONFIRMED → PROCESSING → SHIPPED → DELIVERED → COMPLETED
|
||||
↓ ↓ ↓ ↓
|
||||
CANCELLED CANCELLED CANCELLED RETURNED
|
||||
```
|
||||
|
||||
| 状态 | 说明 | 允许操作 |
|
||||
|------|------|---------|
|
||||
| PENDING | 待处理 | 确认、取消 |
|
||||
| CONFIRMED | 已确认 | 处理、取消 |
|
||||
| PROCESSING | 处理中 | 发货、取消 |
|
||||
| SHIPPED | 已发货 | 送达、退货 |
|
||||
| DELIVERED | 已送达 | 完成、退货 |
|
||||
| COMPLETED | 已完成 | 售后 |
|
||||
| CANCELLED | 已取消 | - |
|
||||
| RETURNED | 已退货 | 退款 |
|
||||
|
||||
---
|
||||
|
||||
## API端点
|
||||
|
||||
| 端点 | 方法 | 服务方法 |
|
||||
|------|------|----------|
|
||||
| /api/v1/orders | GET | OrderService.list |
|
||||
| /api/v1/orders | POST | OrderService.create |
|
||||
| /api/v1/orders/:id | GET | OrderService.get |
|
||||
| /api/v1/orders/:id | PUT | OrderService.update |
|
||||
| /api/v1/orders/:id/cancel | POST | OrderService.cancel |
|
||||
| /api/v1/orders/:id/confirm | POST | OrderService.confirm |
|
||||
| /api/v1/orders/:id/fulfill | POST | FulfillmentService.create |
|
||||
| /api/v1/orders/:id/ship | POST | FulfillmentService.ship |
|
||||
| /api/v1/orders/:id/after-sales | POST | AfterSalesService.create |
|
||||
|
||||
---
|
||||
|
||||
*最后更新: 2026-03-22*
|
||||
160
docs/SERVICES/product.md
Normal file
160
docs/SERVICES/product.md
Normal file
@@ -0,0 +1,160 @@
|
||||
# 商品域服务
|
||||
|
||||
> **入口**: [_index.md](_index.md)
|
||||
|
||||
---
|
||||
|
||||
## 服务列表
|
||||
|
||||
| 服务 | 文件 | 职责 |
|
||||
|------|------|------|
|
||||
| ProductService | services/ProductService.ts | 商品主数据管理 |
|
||||
| SKUService | services/SKUService.ts | SKU变体管理 |
|
||||
| ListingService | services/ListingService.ts | 平台刊登管理 |
|
||||
| PricingService | services/PricingService.ts | 价格计算 |
|
||||
|
||||
---
|
||||
|
||||
## 核心流程
|
||||
|
||||
```
|
||||
商品采集 → SPU创建 → SKU生成 → 平台刊登 → 价格同步
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ProductService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | 商品列表 | ListParams | Product[] |
|
||||
| get | 商品详情 | id | Product |
|
||||
| create | 创建商品 | CreateRequest | Product |
|
||||
| update | 更新商品 | id, UpdateRequest | Product |
|
||||
| delete | 删除商品 | id | void |
|
||||
|
||||
### 示例
|
||||
|
||||
```typescript
|
||||
// 获取商品列表
|
||||
const products = await ProductService.list({
|
||||
tenantId: 'tenant-001',
|
||||
shopId: 'shop-001',
|
||||
status: 'ACTIVE',
|
||||
page: 1,
|
||||
pageSize: 20,
|
||||
});
|
||||
|
||||
// 创建商品
|
||||
const product = await ProductService.create({
|
||||
tenantId: 'tenant-001',
|
||||
shopId: 'shop-001',
|
||||
name: '商品名称',
|
||||
platform: 'SHOPIFY',
|
||||
// ...
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## SKUService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | SKU列表 | productId | SKU[] |
|
||||
| get | SKU详情 | id | SKU |
|
||||
| create | 创建SKU | CreateRequest | SKU |
|
||||
| update | 更新SKU | id, UpdateRequest | SKU |
|
||||
| updateStock | 更新库存 | id, quantity | SKU |
|
||||
|
||||
---
|
||||
|
||||
## ListingService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| list | 刊登列表 | ListParams | Listing[] |
|
||||
| get | 刊登详情 | id | Listing |
|
||||
| publish | 刊登商品 | PublishRequest | Listing |
|
||||
| updatePrice | 更新价格 | id, price | Listing |
|
||||
| syncInventory | 同步库存 | id, stock | Listing |
|
||||
|
||||
---
|
||||
|
||||
## PricingService
|
||||
|
||||
### 方法列表
|
||||
|
||||
| 方法 | 说明 | 参数 | 返回 |
|
||||
|------|------|------|------|
|
||||
| calculate | 计算价格 | PriceParams | number |
|
||||
| getStrategy | 获取策略 | id | PriceStrategy |
|
||||
| createStrategy | 创建策略 | CreateRequest | PriceStrategy |
|
||||
| updateStrategy | 更新策略 | id, UpdateRequest | PriceStrategy |
|
||||
|
||||
### 价格计算流程
|
||||
|
||||
```
|
||||
基准价(SKU.basePrice)
|
||||
↓
|
||||
策略计算(PriceStrategy)
|
||||
↓
|
||||
最终价(Listing.price)
|
||||
```
|
||||
|
||||
### 示例
|
||||
|
||||
```typescript
|
||||
const finalPrice = await PricingService.calculate({
|
||||
basePrice: 100,
|
||||
strategy: {
|
||||
type: 'multiplier',
|
||||
value: 1.2,
|
||||
},
|
||||
platform: 'SHOPIFY',
|
||||
});
|
||||
// 结果: 120
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 状态机
|
||||
|
||||
```
|
||||
DRAFT → PENDING_REVIEW → ACTIVE → INACTIVE
|
||||
↓
|
||||
ARCHIVED
|
||||
```
|
||||
|
||||
| 状态 | 说明 | 允许操作 |
|
||||
|------|------|---------|
|
||||
| DRAFT | 草稿 | 编辑、删除、提交审核 |
|
||||
| PENDING_REVIEW | 待审核 | 审核通过、审核拒绝 |
|
||||
| ACTIVE | 活跃 | 编辑、停用、刊登 |
|
||||
| INACTIVE | 停用 | 启用、归档 |
|
||||
| ARCHIVED | 归档 | 删除 |
|
||||
|
||||
---
|
||||
|
||||
## API端点
|
||||
|
||||
| 端点 | 方法 | 服务方法 |
|
||||
|------|------|----------|
|
||||
| /api/v1/products | GET | ProductService.list |
|
||||
| /api/v1/products | POST | ProductService.create |
|
||||
| /api/v1/products/:id | GET | ProductService.get |
|
||||
| /api/v1/products/:id | PUT | ProductService.update |
|
||||
| /api/v1/products/:id | DELETE | ProductService.delete |
|
||||
| /api/v1/products/:id/skus | GET | SKUService.list |
|
||||
| /api/v1/products/:id/listings | GET | ListingService.list |
|
||||
| /api/v1/listings/:id/publish | POST | ListingService.publish |
|
||||
|
||||
---
|
||||
|
||||
*最后更新: 2026-03-22*
|
||||
Reference in New Issue
Block a user