# 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。