makemd/docs/ARCHIVE/01_Architecture/03_Domain_Model.md

DOMAIN_MODEL（领域模型）

核心实体

Merchant（商户）

• id
• name
• status（pending / active / inactive）
• created_at
• updated_at
• contact_person
• contact_email
• contact_phone
• address
• business_type（B2B / B2C）

---

User（用户）

• id
• merchant_id
• role（admin / operator / viewer）
• status
• username
• email
• password_hash
• created_at
• updated_at

---

Store（店铺）

• id
• merchant_id
• name
• platform
• platform_shop_id
• description
• status
• created_at
• updated_at

---

Feature（功能）

• code
• name
• price_type（free / paid）
• price_value
• description

---

PlatformIntegration（平台集成）

• id
• merchant_id
• platform_name（Sellbrite / Shoplazza / SaleSmartly）
• api_key
• api_secret
• access_token
• refresh_token
• status
• created_at
• updated_at

---

CrossBorderProduct（跨境商品）

• id
• product_id
• hs_code
• tariff_rate
• compliance_status
• country_of_origin
• weight
• dimensions
• created_at
• updated_at

---

CustomsDocument（清关文件）

• id
• order_id
• document_type
• document_url
• status
• created_at
• updated_at

---

CrossBorderOrder（跨境订单）

• id
• order_id
• customs_status
• shipping_status
• tracking_number
• logistics_provider
• estimated_delivery
• created_at
• updated_at
• category

---

MerchantFeature（商户功能）

• id
• merchant_id
• feature_code
• status（inactive / pending_payment / active / expired）
• expire_at
• created_at
• updated_at

---

Order（订单）

• id
• user_id
• merchant_id
• total_amount
• status（pending / paid / split / shipped / completed / refunded）
• created_at
• updated_at
• shipping_address
• payment_method

---

SubOrder（子订单）

• id
• order_id
• merchant_id
• store_id
• amount
• status
• created_at
• updated_at

---

Product（商品）

• id
• merchant_id
• store_id
• name
• sku
• price
• stock
• status
• created_at
• updated_at

---

Inventory（库存）

• id
• product_id
• merchant_id
• warehouse_id
• quantity
• status
• last_sync_at

---

Payment（支付）

• id
• merchant_id
• amount
• status（created / paid / failed）
• type（feature / order）
• payment_method
• transaction_id
• created_at
• updated_at

---

Bill（账单）

• id
• merchant_id
• type（income / expense）
• amount
• status（pending / confirmed / settled）
• source_type（order / feature）
• source_id
• created_at
• updated_at

---

Permission（权限）

• id
• role
• resource
• action
• created_at

---

Settlement（结算）

• id
• merchant_id
• total_amount
• platform_fee
• net_amount
• status
• period_start
• period_end
• created_at
• updated_at

---

Analytics（数据分析）

• id
• merchant_id
• report_type
• data
• generated_at
• period_start
• period_end

---

商品中心领域模型（Product Center Domain Model）

设计原则: 采用三层商品模型（SPU → SKU → Listing），支持多平台统一管理

商品层级关系

SPU（产品层）
  │
  ├── SKU-001（库存单元层）
  │     ├── Listing-A（平台商品层）
  │     ├── Listing-B（平台商品层）
  │     └── Listing-C（平台商品层）
  │
  ├── SKU-002（库存单元层）
  │     └── Listing-D（平台商品层）
  │
  └── SKU-003（库存单元层）
        └── Listing-E（平台商品层）

SPU（标准产品单元）

字段	类型	说明
id	string	主键
tenant_id	string	租户ID
name	string	产品名称
brand	string	品牌
category_id	string	类目ID
description	text	产品描述
attributes	json	通用属性
status	enum	DRAFT/ACTIVE/INACTIVE/ARCHIVED
created_at	timestamp	创建时间
updated_at	timestamp	更新时间

interface SPU {
  id: string;
  tenantId: string;
  name: string;
  brand: string;
  categoryId: string;
  description: string;
  attributes: Record<string, any>;
  status: 'DRAFT' | 'ACTIVE' | 'INACTIVE' | 'ARCHIVED';
  createdAt: Date;
  updatedAt: Date;
}

SKU（库存单元）

字段	类型	说明
id	string	主键
spu_id	string	关联SPU
tenant_id	string	租户ID
sku_code	string	SKU编码
attributes	json	变体属性 {"color": "red", "size": "XL"}
cost_price	decimal(10,2)	成本价
base_price	decimal(10,2)	基准价（参考锚点）
weight	decimal(10,3)	重量(kg)
dimensions	json	尺寸 {length, width, height}
status	enum	ACTIVE/INACTIVE
created_at	timestamp	创建时间
updated_at	timestamp	更新时间

interface SKU {
  id: string;
  spuId: string;
  tenantId: string;
  skuCode: string;
  attributes: Record<string, any>;
  costPrice: number;
  basePrice: number;
  weight: number;
  dimensions: { length: number; width: number; height: number };
  status: 'ACTIVE' | 'INACTIVE';
  createdAt: Date;
  updatedAt: Date;
}

PlatformListing（平台商品）

字段	类型	说明
id	string	主键
sku_id	string	关联SKU
shop_id	string	店铺ID
tenant_id	string	租户ID
platform	enum	平台类型
platform_listing_id	string	平台商品ID
title	string	商品标题
price	decimal(10,2)	最终销售价
original_price	decimal(10,2)	原价
stock	int	库存
status	enum	DRAFT/PENDING/ACTIVE/INACTIVE
strategy_id	string	价格策略ID
override_price	decimal(10,2)	手动覆盖价格
created_at	timestamp	创建时间
updated_at	timestamp	更新时间

interface PlatformListing {
  id: string;
  skuId: string;
  shopId: string;
  tenantId: string;
  platform: 'TIKTOK' | 'SHOPEE' | 'LAZADA' | 'SHOPIFY' | 'WOOCOMMERCE' | 'B2B';
  platformListingId: string;
  title: string;
  price: number;
  originalPrice: number;
  stock: number;
  status: 'DRAFT' | 'PENDING' | 'ACTIVE' | 'INACTIVE';
  strategyId: string;
  overridePrice: number | null;
  createdAt: Date;
  updatedAt: Date;
}

PriceStrategy（价格策略）

字段	类型	说明
id	string	主键
tenant_id	string	租户ID
name	string	策略名称
scope_type	enum	PLATFORM/SHOP/LISTING
scope_id	string	作用域ID
strategy_type	enum	MULTIPLIER/FIXED/DYNAMIC
value	decimal(10,2)	策略值（倍率或固定值）
min_price	decimal(10,2)	最低价格限制
max_price	decimal(10,2)	最高价格限制
status	enum	ACTIVE/INACTIVE
created_at	timestamp	创建时间
updated_at	timestamp	更新时间

interface PriceStrategy {
  id: string;
  tenantId: string;
  name: string;
  scopeType: 'PLATFORM' | 'SHOP' | 'LISTING';
  scopeId: string;
  strategyType: 'MULTIPLIER' | 'FIXED' | 'DYNAMIC';
  value: number;
  minPrice: number;
  maxPrice: number;
  status: 'ACTIVE' | 'INACTIVE';
  createdAt: Date;
  updatedAt: Date;
}

SKUMapping（SKU映射）

字段	类型	说明
id	string	主键
tenant_id	string	租户ID
sku_id	string	系统SKU ID
platform	enum	平台类型
shop_id	string	店铺ID
platform_sku_id	string	平台SKU ID
mapping_type	enum	AUTO/MANUAL
confidence	decimal(5,2)	匹配置信度
status	enum	ACTIVE/INACTIVE
created_at	timestamp	创建时间
updated_at	timestamp	更新时间

interface SKUMapping {
  id: string;
  tenantId: string;
  skuId: string;
  platform: string;
  shopId: string;
  platformSkuId: string;
  mappingType: 'AUTO' | 'MANUAL';
  confidence: number;
  status: 'ACTIVE' | 'INACTIVE';
  createdAt: Date;
  updatedAt: Date;
}

Organization（组织架构）

字段	类型	说明
id	string	主键
tenant_id	string	租户ID
parent_id	string	父级ID
name	string	组织名称
type	enum	COMPANY/DEPARTMENT/TEAM
path	string	层级路径
level	int	层级深度
status	enum	ACTIVE/INACTIVE
created_at	timestamp	创建时间
updated_at	timestamp	更新时间

interface Organization {
  id: string;
  tenantId: string;
  parentId: string | null;
  name: string;
  type: 'COMPANY' | 'DEPARTMENT' | 'TEAM';
  path: string;
  level: number;
  status: 'ACTIVE' | 'INACTIVE';
  createdAt: Date;
  updatedAt: Date;
}

ShopAuthorization（店铺授权）

字段	类型	说明
id	string	主键
shop_id	string	店铺ID
tenant_id	string	租户ID
auth_type	enum	OAUTH/API_KEY/AGENT
access_token	text	访问令牌
refresh_token	text	刷新令牌
expire_at	timestamp	过期时间
cookies	text	Cookie（Agent授权）
proxy	json	代理配置
status	enum	PENDING/ACTIVE/EXPIRED/INVALID
last_sync_at	timestamp	最后同步时间
created_at	timestamp	创建时间
updated_at	timestamp	更新时间

interface ShopAuthorization {
  id: string;
  shopId: string;
  tenantId: string;
  authType: 'OAUTH' | 'API_KEY' | 'AGENT';
  accessToken: string;
  refreshToken: string;
  expireAt: Date;
  cookies: string;
  proxy: { host: string; port: number; username: string };
  status: 'PENDING' | 'ACTIVE' | 'EXPIRED' | 'INVALID';
  lastSyncAt: Date;
  createdAt: Date;
  updatedAt: Date;
}