eva4j 1.0.16 → 1.0.18

package/examples/system/orders.yaml

@@ -0,0 +1,119 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# orders — Domain Model
+# ─────────────────────────────────────────────────────────────────────────────
+# Gestión de órdenes de compra. Usa readModels para mantener proyecciones
+# locales de Product y Customer, eliminando dependencias HTTP síncronas.
+# ─────────────────────────────────────────────────────────────────────────────
+
+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: customer
+            validations:
+              - type: NotBlank
+                message: "Customer ID is required"
+          - name: productId
+            type: String
+            reference:
+              aggregate: Product
+              module: product
+            validations:
+              - type: NotBlank
+                message: "Product ID is required"
+          - name: quantity
+            type: Integer
+            validations:
+              - type: Positive
+          - name: totalAmount
+            type: BigDecimal
+            readOnly: true
+            defaultValue: "0.00"
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Declarative REST endpoints
+# ─────────────────────────────────────────────────────────────────────────────
+endpoints:
+  basePath: /orders
+  versions:
+    - version: v1
+      operations:
+        - useCase: CreateOrder
+          method: POST
+          path: /
+        - useCase: GetOrder
+          method: GET
+          path: /{id}
+        - useCase: FindAllOrders
+          method: GET
+          path: /
+        - useCase: UpdateOrder
+          method: PUT
+          path: /{id}
+        - useCase: DeleteOrder
+          method: DELETE
+          path: /{id}
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Read Models — proyecciones locales de datos de otros módulos
+# ─────────────────────────────────────────────────────────────────────────────
+# Cada readModel mantiene una tabla local (rm_*) sincronizada por eventos de
+# ciclo de vida del módulo productor. Elimina la necesidad de ports: (HTTP).
+# ─────────────────────────────────────────────────────────────────────────────
+readModels:
+  - name: ProductReadModel
+    source:
+      module: product
+      aggregate: Product
+    tableName: rm_orders_products
+    fields:
+      - name: id
+        type: String
+      - name: name
+        type: String
+      - name: price
+        type: BigDecimal
+      - name: categoryId
+        type: String
+    syncedBy:
+      - event: ProductCreatedEvent
+        action: UPSERT
+      - event: ProductUpdatedEvent
+        action: UPSERT
+
+  - name: CustomerReadModel
+    source:
+      module: customer
+      aggregate: Customer
+    tableName: rm_orders_customers
+    fields:
+      - name: id
+        type: String
+      - name: fullName
+        type: String
+      - name: email
+        type: String
+    syncedBy:
+      - event: CustomerCreatedEvent
+        action: UPSERT
+      - event: CustomerUpdatedEvent
+        action: UPSERT
+      - event: CustomerDeletedEvent
+        action: DELETE

package/examples/system/product.yaml

@@ -80,6 +80,33 @@ aggregates:
           - DISCONTINUED
 
     events:
+      # ProductCreatedEvent — lifecycle: create → raise() in creation constructor
+      # Feeds readModels in consumer modules (e.g. orders/ProductReadModel)
+      - name: ProductCreatedEvent
+        lifecycle: create
+        fields:
+          - name: productId
+            type: String
+          - name: name
+            type: String
+          - name: price
+            type: BigDecimal
+          - name: categoryId
+            type: String
+
+      # ProductUpdatedEvent — lifecycle: update → raise() in update() method
+      - name: ProductUpdatedEvent
+        lifecycle: update
+        fields:
+          - name: productId
+            type: String
+          - name: name
+            type: String
+          - name: price
+            type: BigDecimal
+          - name: categoryId
+            type: String
+
       # ProductPublishedEvent — triggered by publish transition.
       # price: BigDecimal tests VO-unwrap: entity.price is Price, event expects BigDecimal
       # → generator should emit: this.getPrice().getAmount()

package/examples/system/system.yaml

@@ -93,6 +93,62 @@ modules:
         useCase: MarkNotificationRead
         description: "Marcar notificación como leída"
 
+  # ─────────────────────────────────────────────
+  # CLIENTES
+  # ─────────────────────────────────────────────
+
+  - name: customer
+    description: "Gestión de clientes. Emite lifecycle events para que otros módulos mantengan proyecciones locales."
+    exposes:
+      - method: POST
+        path: /customers
+        useCase: CreateCustomer
+        description: "Registrar un nuevo cliente"
+      - method: GET
+        path: /customers/{id}
+        useCase: GetCustomer
+        description: "Obtener detalle de un cliente"
+      - method: GET
+        path: /customers
+        useCase: FindAllCustomers
+        description: "Listar clientes con paginación"
+      - method: PUT
+        path: /customers/{id}
+        useCase: UpdateCustomer
+        description: "Actualizar datos de un cliente"
+      - method: DELETE
+        path: /customers/{id}
+        useCase: DeleteCustomer
+        description: "Eliminar un cliente"
+
+  # ─────────────────────────────────────────────
+  # ÓRDENES
+  # ─────────────────────────────────────────────
+
+  - name: orders
+    description: "Gestión de órdenes de compra. Mantiene readModels locales de Product y Customer para evitar llamadas HTTP síncronas."
+    exposes:
+      - method: POST
+        path: /orders
+        useCase: CreateOrder
+        description: "Crear una nueva orden"
+      - method: GET
+        path: /orders/{id}
+        useCase: GetOrder
+        description: "Obtener detalle de una orden"
+      - method: GET
+        path: /orders
+        useCase: FindAllOrders
+        description: "Listar órdenes con paginación"
+      - method: PUT
+        path: /orders/{id}
+        useCase: UpdateOrder
+        description: "Actualizar una orden"
+      - method: DELETE
+        path: /orders/{id}
+        useCase: DeleteOrder
+        description: "Eliminar una orden"
+
 integrations:
   async:
     # Producto publicado → notification envía alerta a usuarios suscritos
@@ -110,3 +166,27 @@ integrations:
       consumers:
         - module: notification
           useCase: SendProductDiscontinuedNotification
+
+    # ── Lifecycle events para readModels ──────────────────────────────────
+
+    # Product lifecycle → orders mantiene ProductReadModel
+    - event: ProductCreatedEvent
+      producer: product
+      topic: PRODUCT_CREATED
+
+    - event: ProductUpdatedEvent
+      producer: product
+      topic: PRODUCT_UPDATED
+
+    # Customer lifecycle → orders mantiene CustomerReadModel
+    - event: CustomerCreatedEvent
+      producer: customer
+      topic: CUSTOMER_CREATED
+
+    - event: CustomerUpdatedEvent
+      producer: customer
+      topic: CUSTOMER_UPDATED
+
+    - event: CustomerDeletedEvent
+      producer: customer
+      topic: CUSTOMER_DELETED

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eva4j",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "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": {