makemd/docs/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