microwind/ai-skills/clean-architecture

┌─────────────────────────────────────────┐
│  Frameworks & Drivers (最外层)           │
│  Web框架、数据库、UI                      │
│  ┌─────────────────────────────────┐    │
│  │  Interface Adapters              │    │
│  │  控制器、Gateway、Presenter       │    │
│  │  ┌─────────────────────────┐    │    │
│  │  │  Application (Use Cases) │    │   │
│  │  │  应用业务规则             │    │    │
│  │  │  ┌─────────────────┐    │    │    │
│  │  │  │  Entities        │    │    │   │
│  │  │  │  企业业务规则     │    │    │    │
│  │  │  └─────────────────┘    │    │    │
│  │  └─────────────────────────┘    │    │
│  └─────────────────────────────────┘    │
└─────────────────────────────────────────┘
 
依赖方向：外 → 内（箭头永远指向中心）

// ===== 最内层：Entities（领域模型） =====
public class Order {
    private OrderId id;
    private List<OrderItem> items;
    private OrderStatus status;
 
    public void place() {
        if (items.isEmpty()) throw new DomainException("订单不能为空");
        this.status = OrderStatus.PLACED;
    }
}
 
// ===== Use Cases 层 =====
// 输入端口
public interface PlaceOrderUseCase {
    PlaceOrderOutput execute(PlaceOrderInput input);
}
 
// 输出端口
public interface OrderGateway {
    Order findById(String id);
    void save(Order order);
}
 
// 用例实现
public class PlaceOrderInteractor implements PlaceOrderUseCase {
    private final OrderGateway orderGateway;
 
    @Override
    public PlaceOrderOutput execute(PlaceOrderInput input) {
        Order order = orderGateway.findById(input.getOrderId());
        order.place();
        orderGateway.save(order);
        return new PlaceOrderOutput(order.getId(), order.getStatus());
    }
}
 
// ===== Interface Adapters 层 =====
@RestController
public class OrderController {
    private final PlaceOrderUseCase placeOrder;
 
    @PostMapping("/orders/{id}/place")
    public ResponseEntity<?> place(@PathVariable String id) {
        var output = placeOrder.execute(new PlaceOrderInput(id));
        return ResponseEntity.ok(OrderResponse.from(output));
    }
}
 
// ===== Frameworks 层 =====
@Repository
public class JpaOrderGateway implements OrderGateway {
    @Override
    public Order findById(String id) { /* JPA 实现 */ }
    @Override
    public void save(Order order) { /* JPA 实现 */ }
}

✅ 合法依赖：
Controller → UseCase → Entity
JpaGateway → OrderGateway(interface) ← UseCase
 
❌ 非法依赖：
Entity → JpaRepository（内层依赖外层）
UseCase → Spring annotation（业务依赖框架）
Entity → HttpClient（领域依赖基础设施）