eva4j 1.0.13 → 1.0.14

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

package/examples/system.yaml

@@ -0,0 +1,289 @@
+system:
+  name: test-eva
+  groupId: com.example
+  javaVersion: 21
+  springBootVersion: 3.5.5
+  database: postgresql
+
+messaging:
+  enabled: true
+  broker: kafka
+  kafka:
+    bootstrapServers: localhost:9092
+    defaultGroupId: test-eva
+    topicPrefix: cinema
+
+modules:
+
+  # ─────────────────────────────────────────────
+  # CATÁLOGO
+  # ─────────────────────────────────────────────
+
+  - name: movies
+    description: "Catálogo de películas: títulos, géneros, clasificaciones, sinopsis y duración"
+    exposes:
+      - method: GET
+        path: /movies
+        useCase: FindAllMovies
+        description: "Listar películas con filtros por género, clasificación y estado de estreno"
+      - method: GET
+        path: /movies/{id}
+        useCase: GetMovie
+        description: "Obtener detalle completo de una película"
+      - method: POST
+        path: /movies
+        useCase: CreateMovie
+        description: "Registrar nueva película en el catálogo"
+      - method: PUT
+        path: /movies/{id}
+        useCase: UpdateMovie
+        description: "Actualizar información de una película"
+      - method: DELETE
+        path: /movies/{id}
+        useCase: DeleteMovie
+        description: "Retirar una película del catálogo"
+
+  - name: theaters
+    description: "Salas de cine: configuración de capacidad, tipo de sala (2D, 3D, IMAX) y mapa de asientos"
+    exposes:
+      - method: GET
+        path: /theaters
+        useCase: FindAllTheaters
+        description: "Listar todas las salas disponibles"
+      - method: GET
+        path: /theaters/{id}
+        useCase: GetTheater
+        description: "Obtener configuración y capacidad de una sala"
+      - method: POST
+        path: /theaters
+        useCase: CreateTheater
+        description: "Registrar nueva sala de cine"
+      - method: PUT
+        path: /theaters/{id}
+        useCase: UpdateTheater
+        description: "Actualizar configuración de una sala"
+
+  # ─────────────────────────────────────────────
+  # PROGRAMACIÓN
+  # ─────────────────────────────────────────────
+
+  - name: screenings
+    description: "Funciones programadas: asocia película + sala + horario, gestiona disponibilidad, precios y bloqueo exclusivo para eventos privados"
+    exposes:
+      - method: GET
+        path: /screenings
+        useCase: FindAllScreenings
+        description: "Listar funciones con filtros por película, sala y fecha"
+      - method: GET
+        path: /screenings/{id}
+        useCase: GetScreening
+        description: "Obtener detalle de una función (película, sala, horario, precio base)"
+      - method: GET
+        path: /screenings/{id}/seats
+        useCase: GetAvailableSeats
+        description: "Consultar mapa de asientos con disponibilidad en tiempo real"
+      - method: POST
+        path: /screenings
+        useCase: ScheduleScreening
+        description: "Programar una nueva función"
+      - method: PUT
+        path: /screenings/{id}/cancel
+        useCase: CancelScreening
+        description: "Cancelar una función programada y liberar todas las reservas"
+      - method: GET
+        path: /screenings/{id}/private-event-availability
+        useCase: CheckPrivateEventAvailability
+        description: "Verificar si la sala completa está libre de reservas individuales y puede ser bloqueada para un evento privado" # ★ NUEVO
+      - method: PUT
+        path: /screenings/{id}/lock
+        useCase: LockScreeningForPrivateEvent
+        description: "Bloquear toda la sala para un evento privado, impidiendo nuevas reservas individuales sobre esa función" # ★ NUEVO
+
+  # ─────────────────────────────────────────────
+  # CLIENTES
+  # ─────────────────────────────────────────────
+
+  - name: customers
+    description: "Registro y perfil de clientes: datos personales, historial de compras e historial de puntos"
+    exposes:
+      - method: POST
+        path: /customers
+        useCase: CreateCustomer
+        description: "Registrar nuevo cliente"
+      - method: GET
+        path: /customers/{id}
+        useCase: GetCustomer
+        description: "Obtener perfil del cliente"
+      - method: GET
+        path: /customers
+        useCase: FindAllCustomers
+        description: "Listar clientes con filtros"
+      - method: PUT
+        path: /customers/{id}
+        useCase: UpdateCustomer
+        description: "Actualizar datos personales del cliente"
+
+  # ─────────────────────────────────────────────
+  # RESERVAS
+  # ─────────────────────────────────────────────
+
+  - name: reservations
+    description: "Ciclo de vida de la reserva: selección y bloqueo de asientos, confirmación, cancelación y reserva exclusiva de sala completa para eventos privados"
+    exposes:
+      - method: POST
+        path: /reservations
+        useCase: CreateReservation
+        description: "Iniciar reserva: seleccionar función y asientos, bloqueo temporal (15 min)"
+      - method: GET
+        path: /reservations/{id}
+        useCase: GetReservation
+        description: "Consultar estado e información de una reserva"
+      - method: GET
+        path: /reservations
+        useCase: FindAllReservations
+        description: "Listar reservas con filtros por cliente, función y estado"
+      - method: PUT
+        path: /reservations/{id}/confirm
+        useCase: ConfirmReservation
+        description: "Confirmar la reserva después de recibir pago aprobado"
+      - method: PUT
+        path: /reservations/{id}/cancel
+        useCase: CancelReservation
+        description: "Cancelar la reserva y liberar los asientos seleccionados"
+      - method: PUT
+        path: /reservations/{id}/expire
+        useCase: ExpireReservation
+        description: "Expirar reserva no pagada dentro del tiempo límite de bloqueo"
+      - method: POST
+        path: /reservations/private-events
+        useCase: CreatePrivateEventReservation
+        description: "Reservar toda la sala para un evento privado: ocupa la capacidad total de la función de forma exclusiva" # ★ NUEVO
+
+  # ─────────────────────────────────────────────
+  # PAGOS
+  # ─────────────────────────────────────────────
+
+  - name: payments
+    description: "Procesamiento de pagos: integración con pasarela externa, aprobaciones y reembolsos"
+    exposes:
+      - method: POST
+        path: /payments
+        useCase: InitiatePayment
+        description: "Iniciar proceso de pago vinculado a una reserva"
+      - method: GET
+        path: /payments/{id}
+        useCase: GetPayment
+        description: "Consultar estado de un pago"
+      - method: GET
+        path: /payments
+        useCase: FindAllPayments
+        description: "Listar pagos con filtros por estado y fecha"
+      - method: PUT
+        path: /payments/{id}/approve
+        useCase: ApprovePayment
+        description: "Registrar aprobación de pago recibida desde la pasarela"
+      - method: PUT
+        path: /payments/{id}/reject
+        useCase: RejectPayment
+        description: "Registrar rechazo de pago recibido desde la pasarela"
+      - method: PUT
+        path: /payments/{id}/refund
+        useCase: ProcessRefund
+        description: "Procesar reembolso por cancelación de reserva o función"
+
+  # ─────────────────────────────────────────────
+  # NOTIFICACIONES
+  # ─────────────────────────────────────────────
+
+  - name: notifications
+    description: "Envío de notificaciones por email y SMS: confirmaciones, tickets QR, recordatorios y alertas de cancelación"
+
+integrations:
+  async:
+    # Reserva creada → pago espera cobro; notificación informa el bloqueo de asientos
+    - event: ReservationCreatedEvent
+      producer: reservations
+      topic: RESERVATION_CREATED
+      consumers:
+        - module: payments
+        - module: notifications
+
+    # Pago aprobado → reserva debe confirmarse; cliente recibe confirmación
+    - event: PaymentApprovedEvent
+      producer: payments
+      topic: PAYMENT_APPROVED
+      consumers:
+        - module: reservations
+        - module: notifications
+
+    # Pago rechazado → reserva debe expirar y liberar asientos; cliente recibe aviso
+    - event: PaymentRejectedEvent
+      producer: payments
+      topic: PAYMENT_REJECTED
+      consumers:
+        - module: reservations
+        - module: notifications
+
+    # Reserva confirmada → se emiten los tickets QR y se envían al cliente
+    - event: ReservationConfirmedEvent
+      producer: reservations
+      topic: RESERVATION_CONFIRMED
+      consumers:
+        - module: notifications
+
+    # Reserva cancelada → pagos evalúa reembolso; cliente recibe notificación
+    - event: ReservationCancelledEvent
+      producer: reservations
+      topic: RESERVATION_CANCELLED
+      consumers:
+        - module: payments
+        - module: notifications
+
+    # Función cancelada → reservas libera asientos y expira reservas activas; clientes notificados
+    - event: ScreeningCancelledEvent
+      producer: screenings
+      topic: SCREENING_CANCELLED
+      consumers:
+        - module: reservations
+        - module: notifications
+
+    # ★ NUEVO — Reserva de evento privado creada → screenings bloquea la sala; payments inicia cobro total; notifications avisa
+    - event: PrivateEventReservationCreatedEvent
+      producer: reservations
+      topic: PRIVATE_EVENT_RESERVATION_CREATED
+      consumers:
+        - module: screenings
+        - module: payments
+        - module: notifications
+
+    # ★ NUEVO — Sala bloqueada exitosamente → notifications confirma al organizador del evento
+    - event: TheaterLockedForPrivateEventEvent
+      producer: screenings
+      topic: THEATER_LOCKED_FOR_PRIVATE_EVENT
+      consumers:
+        - module: notifications
+
+  sync:
+    # Al crear una reserva se consulta la función para validar disponibilidad y precio
+    # ★ MODIFICADO — se agrega consulta de disponibilidad para evento privado
+    - caller: reservations
+      calls: screenings
+      port: ScreeningService
+      using:
+        - GET /screenings/{id}
+        - GET /screenings/{id}/seats
+        - GET /screenings/{id}/private-event-availability  # ★ NUEVO
+
+    # Al crear una reserva se verifica que el cliente exista y esté activo
+    - caller: reservations
+      calls: customers
+      port: CustomerService
+      using:
+        - GET /customers/{id}
+
+    # Al iniciar un pago se obtiene el detalle de la reserva para calcular el monto
+    - caller: payments
+      calls: reservations
+      port: ReservationService
+      using:
+        - GET /reservations/{id}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eva4j",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "A powerful Node.js CLI for generating Spring Boot projects with modular architecture that enables efficient monolith-first development with seamless transition to microservices",
   "main": "bin/eva4j.js",
   "bin": {

package/src/commands/create.js

@@ -55,7 +55,10 @@ async function createCommand(projectName, options) {
   
   // Set all required dependencies
   answers.dependencies = ['web', 'data-jpa', 'security', 'validation', 'actuator'];
-  
+
+  // Preserve CLI name as project directory name (independent of artifactId)
+  answers.projectName = projectName || answers.artifactId;
+
   // Build context
   const context = buildBaseContext(answers);
   
@@ -69,7 +72,7 @@ async function createCommand(projectName, options) {
     spinner.succeed(chalk.green('Project created successfully! ✨'));
     
     console.log(chalk.blue('\n📦 Project structure:'));
-    console.log(chalk.gray(`  ${context.artifactId}/`));
+    console.log(chalk.gray(`  ${context.projectName}/`));
     console.log(chalk.gray(`    ├── src/main/java/${context.packagePath.replace(/\//g, '.')}`));
     console.log(chalk.gray(`    │   ├── ${context.applicationClassName}.java`));
     console.log(chalk.gray(`    │   └── common/`));
@@ -77,7 +80,7 @@ async function createCommand(projectName, options) {
     console.log(chalk.gray(`    └── README.md`));
     
     console.log(chalk.blue('\n🚀 Next steps:'));
-    console.log(chalk.white(`  cd ${context.artifactId}`));
+    console.log(chalk.white(`  cd ${context.projectName}`));
     console.log(chalk.white(`  eva4j add module user    # Add your first module`));
     console.log(chalk.white(`  ./gradlew bootRun        # Run the application`));
     console.log();