wms-saas/docs/06-backend-laravel.md

06 Laravel 后端结构

分层

不要把所有业务代码写进 Controller。推荐：

Controller
 ↓
FormRequest
 ↓
Service / Action
 ↓
Domain Logic
 ↓
Model / Repository
 ↓
Database

Controller 只负责：

• 接收请求
• 参数验证（通过 FormRequest）
• 调用业务服务
• 返回 API Resource

复杂业务必须进入 Service / Action。

Action 命名示例

• CreateInboundAction
• ReceiveInboundAction
• PutawayInboundAction
• AllocateOutboundAction
• CreateWaveAction
• PickOrderAction
• PackOrderAction
• ShipOrderAction
• AdjustInventoryAction
• StocktakeAction

目录结构

app/
├── Domain/                 # WMS 核心业务规则（状态机、领域规则、值对象、枚举）
│   ├── Inventory/
│   ├── Order/
│   ├── Inbound/
│   ├── Outbound/
│   ├── Warehouse/
│   ├── Picking/
│   ├── Packing/
│   ├── Shipment/
│   ├── Return/
│   └── Logistics/
│
├── Application/            # 应用层用例
│   ├── Inventory/
│   │   ├── Actions/
│   │   ├── Services/
│   │   └── DTOs/
│   ├── Order/
│   ├── Inbound/
│   └── Outbound/
│
├── Http/
│   ├── Controllers/
│   ├── Requests/
│   └── Resources/
│
├── Models/                 # Eloquent 模型（数据持久化）
│
├── Jobs/
├── Events/
├── Listeners/
├── Policies/
├── Console/
├── Support/                # 通用支持：TenantContext、ApiResponse 等
│
└── Infrastructure/         # 外部适配
    ├── Cache/
    ├── Queue/
    ├── Logistics/
    └── Platforms/
        ├── Amazon/
        ├── TikTokShop/
        ├── Temu/
        ├── Shopee/
        └── Mirakl/

职责划分

层	职责
Laravel（Http / Application）	应用层：请求、用例编排、事务边界
Domain	WMS 核心业务规则
Eloquent（Models）	数据持久化
Queue（Jobs）	异步任务
Adapter（Infrastructure）	第三方平台、物流商
TenantContext	多租户隔离

依赖方向

• Http → Application → Domain；Infrastructure 实现 Domain / Application 定义的接口。
• Domain 不依赖 Http、不依赖具体第三方平台。
• 模块之间避免强耦合，跨模块协作优先通过 Application Service 或 Events。