eva4j 1.0.13 → 1.0.15

package/docs/commands/INDEX.md

@@ -112,7 +112,16 @@ Commands for transitioning from monolith to microservices.
   - Service independence
   - Zero code rewrite
 
-### 📊 Utility Commands
+### 📊 Analysis & Utility Commands
+
+- **[evaluate system](./EVALUATE_SYSTEM.md)** - Statically analyze a system.yaml for architectural problems
+  - Referential integrity (producers, consumers, sync endpoints)
+  - Synchronous cycle detection (DFS — deadlock prevention)
+  - Module role analysis (isolation, pure consumers, autonomous modules)
+  - Behavior gap detection (scheduler verbs with no trigger)
+  - Coupling pattern analysis (asymmetric sync↔async dependencies)
+  - Interactive HTML report with flow simulator + network diagram
+  - Domain-agnostic: works for any microservices design
 
 - **info** - Display project information
   - *Documentation coming soon*

package/examples/domain-endpoints-relations.yaml

@@ -0,0 +1,353 @@
+# EJEMPLO: ENDPOINTS + RELACIONES
+#
+# Muestra cómo funciona la sección endpoints: cuando el agregado tiene
+#   - Entidad raíz   : Order
+#   - OneToMany       : OrderItem
+#   - OneToOne        : ShippingAddress
+#
+# REGLA CLAVE:
+#   La sección `endpoints:` controla CUÁLES use cases se generan.
+#   La sección `aggregates:` controla LA ESTRUCTURA de cada use case
+#   (campos, listas anidadas, DTOs de relaciones).
+#
+#   Ambas secciones son INDEPENDIENTES entre sí. El generador combina
+#   la información de ambas para producir el código correcto.
+#
+# ─────────────────────────────────────────────────────────────────────────
+# QUÉ SE GENERA
+# ─────────────────────────────────────────────────────────────────────────
+#
+# CreateOrder → implementación COMPLETA
+#   Porque su nombre coincide con el patrón estándar Create{Aggregate}.
+#   El Command incluirá automáticamente:
+#     - Los campos simples de Order (orderNumber, customerId)
+#     - List<CreateOrderItemDto> items   ← por la relación OneToMany
+#     - CreateShippingAddressDto shipping ← por la relación OneToOne
+#
+# GetOrder / FindAllOrders → implementación COMPLETA
+#   El ResponseDto incluirá:
+#     - Campos de Order
+#     - List<OrderItemDto> items          ← OneToMany en respuesta
+#     - ShippingAddressDto shippingAddress ← OneToOne en respuesta
+#
+# ConfirmOrder / CancelOrder / ShipOrder → Cat. 1 TRANSITION
+#   Porque su nombre es PascalCase(method) + Aggregate para una transición
+#   declarada en enums[].transitions. Handler completo generado automáticamente.
+#
+# AddOrderItem / RemoveOrderItem → Cat. 2 SUB-ENTITY ADD/REMOVE
+#   Porque su nombre es Add{Target} / Remove{Target} para una relación OneToMany.
+#   Handler completo generado automáticamente.
+#
+# FindAllOrdersByCustomerId → Cat. 3 FIND-BY
+#   Porque su nombre sigue FindAll{Aggregate}sBy{FieldPascal} para un campo de la raíz.
+#   Query + handler + método en el repositorio generados automáticamente.
+#
+# ProcessOrderPayment → SCAFFOLD (nombre libre)
+#   No coincide con ningún patrón → genera stubs con TODO.
+#   El desarrollador añade los campos al Command e implementa el Handler.
+
+aggregates:
+  - name: Order
+    entities:
+
+      # ── Raíz del agregado ──────────────────────────────────────────────
+      - name: Order
+        isRoot: true
+        tableName: orders
+        audit:
+          enabled: true
+          trackUser: true
+        fields:
+          - name: id
+            type: String
+          - name: orderNumber
+            type: String
+            validations:
+              - type: NotBlank
+                message: "El número de pedido es obligatorio"
+          - name: customerId
+            type: String
+            reference:
+              aggregate: Customer
+              module: customers
+          - name: status
+            type: OrderStatus
+            readOnly: true     # Manejado por transitions — no va en CreateCommand
+          - name: totalAmount
+            type: BigDecimal
+            readOnly: true     # Calculado — no va en CreateCommand
+            defaultValue: "0.00"
+          - name: notes
+            type: String
+        relationships:
+          # El generador crea automáticamente la relación inversa (ManyToOne) en OrderItem
+          # No es necesario declarar la relación inversa en OrderItem
+          - type: OneToMany
+            target: OrderItem
+            mappedBy: order          # → OrderItem tendrá un campo 'order' (FK: order_id)
+            cascade: [PERSIST, MERGE, REMOVE]
+            fetch: LAZY
+          # El generador crea automáticamente la relación inversa (OneToOne) en ShippingAddress
+          # No es necesario declarar la relación inversa en ShippingAddress
+          - type: OneToOne
+            target: ShippingAddress
+            mappedBy: order          # → ShippingAddress tendrá un campo 'order' (FK: order_id)
+            cascade: [PERSIST, MERGE, REMOVE]
+            fetch: LAZY
+
+      # ── OneToMany: líneas del pedido ───────────────────────────────────
+      - name: OrderItem
+        tableName: order_items
+        fields:
+          - name: id
+            type: String
+          - name: productId
+            type: String
+            reference:
+              aggregate: Product
+              module: catalog
+          - name: productName
+            type: String
+          - name: quantity
+            type: Integer
+            validations:
+              - type: Min
+                value: 1
+                message: "La cantidad mínima es 1"
+          - name: unitPrice
+            type: BigDecimal
+          - name: subtotal
+            type: BigDecimal
+            readOnly: true     # Calculado por el método de negocio addOrderItem()
+            defaultValue: "0.00"
+        # ❌ No declarar aquí la relación inversa (ManyToOne hacia Order):
+        #    el generador la infiere automáticamente desde la definición de Order
+
+      # ── OneToOne: dirección de envío ───────────────────────────────────
+      - name: ShippingAddress
+        tableName: order_shipping_addresses
+        fields:
+          - name: id
+            type: String
+          - name: street
+            type: String
+            validations:
+              - type: NotBlank
+          - name: city
+            type: String
+            validations:
+              - type: NotBlank
+          - name: postalCode
+            type: String
+          - name: country
+            type: String
+        # ❌ No declarar aquí la relación inversa (OneToOne hacia Order):
+        #    el generador la infiere automáticamente desde la definición de Order
+
+    enums:
+      - name: OrderStatus
+        initialValue: PENDING
+        transitions:
+          - from: PENDING
+            to: CONFIRMED
+            method: confirm
+          - from: [PENDING, CONFIRMED]
+            to: CANCELLED
+            method: cancel
+          - from: CONFIRMED
+            to: SHIPPED
+            method: ship
+        values: [PENDING, CONFIRMED, SHIPPED, DELIVERED, CANCELLED]
+
+    events:
+      - name: OrderConfirmedEvent
+        fields:
+          - name: orderId
+            type: String
+          - name: customerId
+            type: String
+        
+
+# ─────────────────────────────────────────────────────────────────────────
+# ENDPOINTS
+# ─────────────────────────────────────────────────────────────────────────
+#
+# Solo controla CUÁLES use cases existen y bajo qué URLs viven.
+# La estructura (campos anidados, listas) la define aggregates: arriba.
+
+endpoints:
+  basePath: /orders
+  versions:
+    - version: v1
+      operations:
+
+        # ── CRUD estándar ─────────────────────────────────────────────────
+
+        - method: POST
+          path: /
+          description: "Crear pedido con sus líneas y dirección de envío"
+          useCase: CreateOrder
+          # El Command generado incluirá automáticamente:
+          #   String orderNumber
+          #   String customerId
+          #   String notes
+          #   List<CreateOrderItemDto> items        ← OneToMany
+          #   CreateShippingAddressDto shippingAddress ← OneToOne
+
+        - method: GET
+          path: /{id}
+          description: "Obtener pedido completo con líneas y dirección"
+          useCase: GetOrder
+          # El ResponseDto tendrá:
+          #   campos de Order + List<OrderItemDto> + ShippingAddressDto
+
+        - method: GET
+          path: /
+          description: "Listar pedidos con paginación"
+          useCase: FindAllOrders
+
+        - method: DELETE
+          path: /{id}
+          description: "Cancelar y eliminar un pedido"
+          useCase: DeleteOrder
+
+        # ── Operaciones de negocio (scaffold) ────────────────────────────
+
+        - method: PUT
+          path: /{id}/confirm
+          description: "Confirmar un pedido pendiente"
+          useCase: ConfirmOrder
+          # Cat. 1 TRANSITION — nombre coincide con PascalCase(confirm) + Order
+          # Genera ConfirmOrderCommand(String id) + handler completo:
+          #   repository.findById(id) → entity.confirm() → repository.save(entity)
+          # type inferido: PUT → command
+
+        - method: PUT
+          path: /{id}/cancel
+          description: "Cancelar un pedido"
+          useCase: CancelOrder
+          # Cat. 1 TRANSITION — cancel + Order
+
+        - method: PUT
+          path: /{id}/ship
+          description: "Marcar pedido como enviado"
+          useCase: ShipOrder
+          # Cat. 1 TRANSITION — ship + Order
+
+        # ── Operaciones sobre sub-entidades (scaffold) ───────────────────
+
+        - method: POST
+          path: /{id}/items
+          description: "Agregar línea a un pedido existente"
+          useCase: AddOrderItem
+          # Cat. 2a SUB-ENTITY ADD — patrón: Add{target} donde target=OrderItem (OneToMany)
+          # Patrón de nombre: Add + rel.target → AddOrderItem
+          # Genera AddOrderItemCommand(String id, String productId, String productName, Integer quantity, BigDecimal unitPrice)
+          # Handler: findById → entity.addOrderItem(productId, productName, quantity, unitPrice) → save
+          # Nota: el campo generado en Order se llama 'orderItems' (auto-pluralizado de OrderItem)
+
+        - method: DELETE
+          path: /{id}/items/{itemId}
+          description: "Eliminar una línea del pedido"
+          useCase: RemoveOrderItem
+          # Cat. 2b SUB-ENTITY REMOVE — patrón: Remove{target} donde target=OrderItem
+          # Patrón de nombre: Remove + rel.target → RemoveOrderItem
+          # Genera RemoveOrderItemCommand(String id, String itemId)
+          # Handler: findById → entity.removeOrderItemById(itemId) → save
+
+        - method: GET
+          path: /customer/{customerId}
+          description: "Buscar pedidos por cliente"
+          useCase: FindAllOrdersByCustomerId
+          # Cat. 3 FIND-BY — patrón FindAll{Aggregate}sBy{FieldPascal}
+          # Genera FindAllOrdersByCustomerIdQuery(customerId, page, size, sortBy, sortDirection)
+          # Handler: repository.findByCustomerId(customerId, pageable)
+          # Además actualiza OrderRepository + OrderJpaRepository + OrderRepositoryImpl
+          # type inferido: GET → query
+
+        # ── SCAFFOLD (nombre libre — ningún patrón lo reconoce) ──────────
+
+        - method: POST
+          path: /{id}/payment
+          description: "Procesar el pago de un pedido"
+          useCase: ProcessOrderPayment
+          # ⚠️ SCAFFOLD — el nombre no coincide con ningún patrón:
+          #   ✗ No es Create/Get/FindAll/Update/Delete{Aggregate}  (estándar)
+          #   ✗ No es {MethodPascal}{Aggregate} de ninguna transition (Cat. 1)
+          #   ✗ No es Add{Target} / Remove{Target} de un OneToMany  (Cat. 2)
+          #   ✗ No es FindAll{Aggregate}sBy{Field}                  (Cat. 3)
+          #
+          # Por eso genera stubs con TODO y UnsupportedOperationException:
+          #
+          #   ProcessOrderPaymentCommand.java  ← record con /* TODO: add fields */
+          #   ProcessOrderPaymentCommandHandler.java ← lanza UnsupportedOperationException
+          #
+          # El desarrollador debe:
+          #   1. Añadir los campos al Command (paymentMethod, amount, etc.)
+          #   2. Implementar la lógica en el Handler
+          #
+          # type inferido: POST → command  (o declarar explícitamente si es GET)
+
+# ─────────────────────────────────────────────────────────────────────────
+# RESUMEN DE ARCHIVOS GENERADOS
+# ─────────────────────────────────────────────────────────────────────────
+#
+# domain/models/entities/
+#   ├── Order.java              (raíz — con métodos confirm/cancel/ship/addOrderItem/removeOrderItemById)
+#   ├── OrderItem.java
+#   └── ShippingAddress.java
+#
+# domain/models/enums/
+#   └── OrderStatus.java
+#
+# domain/models/events/
+#   └── OrderConfirmedEvent.java
+#
+# domain/repositories/
+#   └── OrderRepository.java   ← actualizado con findByCustomerId (Cat.3)
+#
+# infrastructure/database/repositories/
+#   ├── OrderJpaRepository.java       ← actualizado con findByCustomerId
+#   └── OrderRepositoryImpl.java      ← actualizado con findByCustomerId
+#
+# application/commands/
+#   ├── CreateOrderCommand.java                ← ESTÁNDAR — incluye items[] y shippingAddress
+#   ├── DeleteOrderCommand.java                ← ESTÁNDAR
+#   ├── ConfirmOrderCommand.java               ← TRANSITION Cat.1 — record(String id)
+#   ├── CancelOrderCommand.java                ← TRANSITION Cat.1
+#   ├── ShipOrderCommand.java                  ← TRANSITION Cat.1
+#   ├── AddOrderItemCommand.java               ← SUB-ENTITY ADD Cat.2 — incluye campos de OrderItem
+#   ├── RemoveOrderItemCommand.java            ← SUB-ENTITY REMOVE Cat.2 — record(id, itemId)
+#   └── ProcessOrderPaymentCommand.java        ← SCAFFOLD — record con /* TODO: add fields */
+#
+# application/queries/
+#   ├── GetOrderQuery.java                     ← ESTÁNDAR
+#   ├── FindAllOrdersQuery.java                ← ESTÁNDAR (FindAll + Order + s)
+#   └── FindAllOrdersByCustomerIdQuery.java    ← FIND-BY Cat.3 — filtra por customerId
+#
+# application/usecases/
+#   ├── CreateOrderCommandHandler.java         ← ESTÁNDAR — completo
+#   ├── DeleteOrderCommandHandler.java         ← ESTÁNDAR — completo
+#   ├── GetOrderQueryHandler.java              ← ESTÁNDAR — completo
+#   ├── FindAllOrdersQueryHandler.java         ← ESTÁNDAR — paginado completo
+#   ├── ConfirmOrderCommandHandler.java        ← TRANSITION — findById → entity.confirm() → save
+#   ├── CancelOrderCommandHandler.java         ← TRANSITION — findById → entity.cancel() → save
+#   ├── ShipOrderCommandHandler.java           ← TRANSITION — findById → entity.ship() → save
+#   ├── AddOrderItemCommandHandler.java        ← SUB-ENTITY ADD — findById → entity.addOrderItem(new OrderItem(...)) → save
+#   ├── RemoveOrderItemCommandHandler.java     ← SUB-ENTITY REMOVE — findById → entity.removeOrderItemById(itemId) → save
+#   ├── FindAllOrdersByCustomerIdQueryHandler.java ← FIND-BY — repository.findByCustomerId(customerId, pageable)
+#   └── ProcessOrderPaymentCommandHandler.java ← SCAFFOLD — UnsupportedOperationException (TODO)
+#
+# application/dtos/
+#   ├── OrderResponseDto.java
+#   ├── OrderItemDto.java
+#   ├── ShippingAddressDto.java
+#   ├── CreateOrderItemDto.java          ← para el comando de creación
+#   └── CreateShippingAddressDto.java    ← para el comando de creación
+#
+# application/mappers/
+#   └── OrderApplicationMapper.java
+#
+# infrastructure/rest/controllers/order/
+#   └── v1/
+#       └── OrderV1Controller.java       ← 10 endpoints declarados

package/examples/domain-endpoints-versioned.yaml

@@ -0,0 +1,144 @@
+# EJEMPLO: ENDPOINTS CON VERSIONADO MÚLTIPLE (v1 + v2)
+# Demuestra cómo v1 y v2 coexisten generando controladores independientes.
+#
+# REGLA ANTI-DUPLICADO:
+#   Si un useCase declarado en v2 ya fue generado en v1, el generador
+#   omite la creación del Command/Query + Handler y SOLO agrega la
+#   referencia en el controlador de v2.
+#
+# RESULTADO:
+#   - 1 controlador por versión (ProductV1Controller, ProductV2Controller)
+#   - Use cases propios de cada versión generados una sola vez
+#   - Use cases compartidos referenciados sin regenerar
+
+aggregates:
+  - name: Product
+    entities:
+      - name: product
+        isRoot: true
+        tableName: products
+        audit:
+          enabled: true
+        fields:
+          - name: id
+            type: String
+          - name: name
+            type: String
+            validations:
+              - type: NotBlank
+          - name: description
+            type: String
+          - name: price
+            type: BigDecimal
+            validations:
+              - type: Positive
+          - name: stock
+            type: Integer
+            readOnly: true
+            defaultValue: 0
+          - name: active
+            type: Boolean
+            readOnly: true
+            defaultValue: true
+
+endpoints:
+  basePath: /products
+  versions:
+    # ── v1: CRUD estándar ──────────────────────────────────────────────────
+    - version: v1
+      operations:
+        - method: GET
+          path: /{id}
+          description: "Obtener producto por ID"
+          useCase: FindProductById      # completo
+
+        - method: GET
+          path: /
+          description: "Listar productos activos"
+          useCase: FindAllProducts      # completo
+
+        - method: POST
+          path: /
+          description: "Crear producto"
+          useCase: CreateProduct        # completo
+
+        - method: PUT
+          path: /{id}
+          description: "Actualizar datos del producto"
+          useCase: UpdateProduct        # completo
+
+        - method: DELETE
+          path: /{id}
+          description: "Eliminar producto"
+          useCase: DeleteProduct        # completo
+
+    # ── v2: nuevas operaciones + reuso de use cases de v1 ─────────────────
+    - version: v2
+      operations:
+        - method: GET
+          path: /{id}
+          description: "Producto con categorías y variantes embebidas"
+          useCase: FindProductByIdV2    # NUEVO handler — shape de respuesta distinto
+
+        - method: GET
+          path: /
+          description: "Listado con filtros avanzados y metadata extendida"
+          useCase: FindAllProductsV2    # NUEVO handler — parámetros de búsqueda distintos
+
+        - method: POST
+          path: /
+          description: "Crear producto (misma lógica que v1)"
+          useCase: CreateProduct        # REUTILIZA v1 — no regenera handler
+
+        - method: PUT
+          path: /{id}
+          description: "Actualizar producto (misma lógica que v1)"
+          useCase: UpdateProduct        # REUTILIZA v1 — no regenera handler
+
+        - method: DELETE
+          path: /{id}
+          description: "Eliminar producto (misma lógica que v1)"
+          useCase: DeleteProduct        # REUTILIZA v1 — no regenera handler
+
+        - method: PUT
+          path: /{id}/activate
+          description: "Activar un producto desactivado"
+          useCase: ActivateProduct      # NUEVO scaffold — TODO: product.activate()
+
+        - method: PUT
+          path: /{id}/deactivate
+          description: "Desactivar un producto activo"
+          useCase: DeactivateProduct    # NUEVO scaffold — TODO: product.deactivate()
+
+# Archivos generados:
+#
+# infrastructure/rest/controllers/product/
+#   ├── v1/ProductV1Controller.java     ← 5 endpoints (v1)
+#   └── v2/ProductV2Controller.java     ← 7 endpoints (v2)
+#
+# application/commands/ (solo use cases ÚNICOS — sin duplicados)
+#   ├── CreateProductCommand.java
+#   ├── UpdateProductCommand.java
+#   ├── DeleteProductCommand.java
+#   ├── ActivateProductCommand.java     ← solo v2
+#   └── DeactivateProductCommand.java   ← solo v2
+#
+# application/queries/ (solo use cases ÚNICOS)
+#   ├── FindProductByIdQuery.java
+#   ├── FindAllProductsQuery.java
+#   ├── FindProductByIdV2Query.java     ← solo v2
+#   └── FindAllProductsV2Query.java     ← solo v2
+#
+# application/usecases/
+#   ├── CreateProductCommandHandler.java     ← completo
+#   ├── UpdateProductCommandHandler.java     ← completo
+#   ├── DeleteProductCommandHandler.java     ← completo
+#   ├── ActivateProductCommandHandler.java   ← scaffold + TODO
+#   ├── DeactivateProductCommandHandler.java ← scaffold + TODO
+#   ├── FindProductByIdQueryHandler.java     ← completo
+#   ├── FindAllProductsQueryHandler.java     ← completo
+#   ├── FindProductByIdV2QueryHandler.java   ← completo (shape distinto)
+#   └── FindAllProductsV2QueryHandler.java   ← completo (filtros extendidos)
+#
+# CreateProduct, UpdateProduct, DeleteProduct aparecen en v2 pero ya
+# existen de v1 → ProductV2Controller los inyecta sin regenerar handlers.

package/examples/domain-endpoints.yaml

@@ -0,0 +1,135 @@
+# EJEMPLO: ENDPOINTS DECLARATIVOS — CASO BÁSICO (una versión)
+# Módulo de pedidos con operaciones específicas del negocio.
+#
+# COMPORTAMIENTO CONDICIONAL:
+#
+#   SIN sección endpoints: → genera 5 CRUD fijos por defecto:
+#       CreateOrder, UpdateOrder, DeleteOrder,
+#       FindOrderById, FindAllOrders
+#
+#   CON sección endpoints: → genera ÚNICAMENTE las operaciones
+#       declaradas en operations[] — ni más, ni menos.
+#
+# TYPE INFERIDO desde method:
+#   GET              → query
+#   POST/PUT/DELETE/PATCH → command
+#
+# SCAFFOLD vs COMPLETO:
+#   Use cases estándar (Create*, Update*, Delete*, FindById*, FindAll*):
+#     → implementación completa con lógica de repositorio
+#   Use cases custom (ConfirmOrder, CancelOrder, etc.):
+#     → scaffold con // TODO apuntando al método de negocio sugerido
+
+aggregates:
+  - name: Order
+    entities:
+      - name: order
+        isRoot: true
+        tableName: orders
+        audit:
+          enabled: true
+          trackUser: true
+        fields:
+          - name: id
+            type: String
+          - name: orderNumber
+            type: String
+            validations:
+              - type: NotBlank
+                message: "Order number is required"
+          - name: customerId
+            type: String
+            reference:
+              aggregate: Customer
+              module: customers
+          - name: status
+            type: OrderStatus
+            readOnly: true
+          - name: totalAmount
+            type: BigDecimal
+            readOnly: true
+            defaultValue: "0.00"
+
+    enums:
+      - name: OrderStatus
+        initialValue: PENDING
+        transitions:
+          - from: PENDING
+            to: CONFIRMED
+            method: confirm
+          - from: [PENDING, CONFIRMED]
+            to: CANCELLED
+            method: cancel
+        values: [PENDING, CONFIRMED, SHIPPED, DELIVERED, CANCELLED]
+
+    events:
+      - name: OrderPlacedEvent
+        fields:
+          - name: orderId
+            type: String
+          - name: customerId
+            type: String
+        kafka: true
+
+# ─── Sección endpoints ─────────────────────────────────────────────────────
+# Presente  → genera solo los use cases declarados
+# Ausente   → comportamiento actual (5 CRUD por defecto)
+# ──────────────────────────────────────────────────────────────────────────
+
+endpoints:
+  basePath: /orders
+  versions:
+    - version: v1
+      operations:
+        - method: GET
+          path: /{id}
+          description: "Obtener detalle de un pedido"
+          useCase: FindOrderById        # completo: FindOrderByIdQuery + Handler
+
+        - method: GET
+          path: /
+          description: "Listar pedidos con paginación"
+          useCase: FindAllOrders        # completo: FindAllOrdersQuery + Handler
+
+        - method: POST
+          path: /
+          description: "Crear nuevo pedido"
+          useCase: CreateOrder          # completo: CreateOrderCommand + Handler
+
+        - method: PUT
+          path: /{id}/confirm
+          description: "Confirmar pedido pendiente — PENDING → CONFIRMED"
+          useCase: ConfirmOrder         # scaffold: TODO → order.confirm(); repo.save(order)
+
+        - method: PUT
+          path: /{id}/cancel
+          description: "Cancelar pedido — [PENDING, CONFIRMED] → CANCELLED"
+          useCase: CancelOrder          # scaffold: TODO → order.cancel(); repo.save(order)
+
+        - method: DELETE
+          path: /{id}
+          description: "Eliminar pedido"
+          useCase: DeleteOrder          # completo: DeleteOrderCommand + Handler
+
+# Archivos generados con esta configuración:
+#
+# infrastructure/rest/controllers/order/v1/
+#   └── OrderV1Controller.java          ← 6 métodos exactos
+#
+# application/commands/
+#   ├── CreateOrderCommand.java
+#   ├── ConfirmOrderCommand.java
+#   ├── CancelOrderCommand.java
+#   └── DeleteOrderCommand.java
+#
+# application/queries/
+#   ├── FindOrderByIdQuery.java
+#   └── FindAllOrdersQuery.java
+#
+# application/usecases/
+#   ├── CreateOrderCommandHandler.java      ← implementación completa
+#   ├── ConfirmOrderCommandHandler.java     ← scaffold + TODO
+#   ├── CancelOrderCommandHandler.java      ← scaffold + TODO
+#   ├── DeleteOrderCommandHandler.java      ← implementación completa
+#   ├── FindOrderByIdQueryHandler.java      ← implementación completa
+#   └── FindAllOrdersQueryHandler.java      ← implementación completa