eva4j 1.0.13 → 1.0.15

package/examples/system.yaml

@@ -0,0 +1,332 @@
+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
+          useCase: HandleReservationCreated
+        - module: notifications
+          useCase: NotifyReservationCreated
+
+    # Pago aprobado → reserva debe confirmarse; cliente recibe confirmación
+    - event: PaymentApprovedEvent
+      producer: payments
+      topic: PAYMENT_APPROVED
+      consumers:
+        - module: reservations
+          useCase: ConfirmReservation
+        - module: notifications
+          useCase: NotifyPaymentApproved
+
+    # Pago rechazado → reserva debe expirar y liberar asientos; cliente recibe aviso
+    - event: PaymentRejectedEvent
+      producer: payments
+      topic: PAYMENT_REJECTED
+      consumers:
+        - module: reservations
+          useCase: ExpireReservation
+        - module: notifications
+          useCase: NotifyPaymentRejected
+
+    # Reserva confirmada → se emiten los tickets QR y se envían al cliente; cliente acumula puntos de fidelidad
+    - event: ReservationConfirmedEvent
+      producer: reservations
+      topic: RESERVATION_CONFIRMED
+      consumers:
+        - module: notifications
+          useCase: NotifyReservationConfirmed
+        - module: customers     # acumula loyalty points al confirmar reserva
+          useCase: AccumulateLoyaltyPoints
+
+    # Reserva cancelada → pagos evalúa reembolso; screenings libera asientos; cliente recibe notificación
+    - event: ReservationCancelledEvent
+      producer: reservations
+      topic: RESERVATION_CANCELLED
+      consumers:
+        - module: payments        # evalúa si aplica reembolso
+          useCase: ProcessRefund
+        - module: screenings      # libera ScreeningSeats → AVAILABLE (también cubre unlock de sala privada)
+          useCase: ReleaseScreeningSeats
+        - module: notifications
+          useCase: NotifyReservationCancelled
+
+    # Reserva expirada por timeout (sin pago) → screenings libera asientos; cliente recibe aviso (sin reembolso)
+    - event: ReservationExpiredEvent
+      producer: reservations
+      topic: RESERVATION_EXPIRED
+      consumers:
+        - module: screenings      # libera ScreeningSeats → AVAILABLE
+          useCase: ReleaseScreeningSeats
+        - module: notifications   # avisa al cliente que su tiempo de bloqueo expiró
+          useCase: NotifyReservationExpired
+
+    # Función cancelada → reservas libera asientos y expira reservas activas; clientes notificados
+    - event: ScreeningCancelledEvent
+      producer: screenings
+      topic: SCREENING_CANCELLED
+      consumers:
+        - module: reservations
+          useCase: CancelReservationsByScreening
+        - module: notifications
+          useCase: NotifyScreeningCancelled
+
+    # ★ 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
+          useCase: LockScreeningForPrivateEvent
+        - module: payments
+          useCase: InitiatePrivateEventPayment
+        - module: notifications
+          useCase: NotifyPrivateEventReservationCreated
+
+    # ★ NUEVO — Sala bloqueada exitosamente → notifications confirma al organizador del evento
+    - event: TheaterLockedForPrivateEventEvent
+      producer: screenings
+      topic: THEATER_LOCKED_FOR_PRIVATE_EVENT
+      consumers:
+        - module: notifications
+          useCase: NotifyTheaterLockedForPrivateEvent
+
+  sync:
+    # Al programar una función se valida que la película esté activa y se obtiene su duración
+    - caller: screenings
+      calls: movies
+      port: MovieService
+      using:
+        - GET /movies/{id}
+
+    # Al programar una función se valida que la sala esté activa y se copian los asientos al mapa de la función
+    - caller: screenings
+      calls: theaters
+      port: TheaterService
+      using:
+        - GET /theaters/{id}
+
+    # 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.15",
   "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": {
@@ -41,6 +41,7 @@
   },
   "homepage": "https://github.com/asuridev/eva4j#readme",
   "dependencies": {
+    "@faker-js/faker": "^10.3.0",
     "chalk": "^4.1.2",
     "clipboardy": "^2.3.0",
     "commander": "^11.1.0",