eva4j 1.0.11 → 1.0.13

package/examples/domain-events.yaml

@@ -0,0 +1,201 @@
+# EJEMPLO: DOMAIN EVENTS
+# Muestra cómo declarar eventos de dominio en domain.yaml
+# Los eventos son siblings de entities:, valueObjects: y enums:
+#
+# Generación:
+#   eva4j g entities orders
+#
+# ─── ARCHIVOS GENERADOS ───────────────────────────────────────────────────────
+#
+# 1. shared/domain/DomainEvent.java  (una sola vez por proyecto)
+#
+#    public abstract class DomainEvent {
+#        private final String eventId;        // UUID autogenerado
+#        private final LocalDateTime occurredOn;
+#        private final String aggregateId;
+#
+#        protected DomainEvent(String aggregateId) {
+#            this.eventId = UUID.randomUUID().toString();
+#            this.occurredOn = LocalDateTime.now();
+#            this.aggregateId = aggregateId;
+#        }
+#        // getters...
+#    }
+#
+# ─────────────────────────────────────────────────────────────────────────────
+#
+# 2. orders/domain/models/events/OrderPlacedEvent.java  (uno por evento)
+#
+#    public final class OrderPlacedEvent extends DomainEvent {
+#        private final String customerId;
+#        private final String orderNumber;
+#        private final BigDecimal totalAmount;
+#
+#        public OrderPlacedEvent(String aggregateId,
+#                                String customerId,
+#                                String orderNumber,
+#                                BigDecimal totalAmount) {
+#            super(aggregateId);
+#            this.customerId  = customerId;
+#            this.orderNumber = orderNumber;
+#            this.totalAmount = totalAmount;
+#        }
+#        // getters...
+#    }
+#
+# ─────────────────────────────────────────────────────────────────────────────
+#
+# 3. orders/domain/models/entities/Order.java  (modificaciones al agregado)
+#
+#    public class Order {
+#        // ... campos normales ...
+#
+#        // ─── Domain Events ───────────────────────────────────────
+#        private final List<DomainEvent> _domainEvents = new ArrayList<>();
+#
+#        protected void raise(DomainEvent event) {
+#            _domainEvents.add(event);
+#        }
+#
+#        public List<DomainEvent> pullDomainEvents() {
+#            List<DomainEvent> events =
+#                Collections.unmodifiableList(new ArrayList<>(_domainEvents));
+#            _domainEvents.clear();
+#            return events;   // retorna y limpia (operación atómica)
+#        }
+#
+#        // El desarrollador llama a raise() dentro de sus métodos de negocio:
+#        public void place(String customerId, BigDecimal total) {
+#            this.status = this.status.transitionTo(OrderStatus.PLACED);  // lanza InvalidStateTransitionException si no es válida
+#            raise(new OrderPlacedEvent(this.id, customerId, this.orderNumber, total));
+#        }
+#    }
+#
+# ─────────────────────────────────────────────────────────────────────────────
+#
+# 4. orders/infrastructure/database/repositories/OrderRepositoryImpl.java
+#    (publicación automática tras persistencia)
+#
+#    @Repository
+#    @RequiredArgsConstructor
+#    public class OrderRepositoryImpl implements OrderRepository {
+#
+#        private final OrderJpaRepository jpaRepository;
+#        private final OrderMapper mapper;
+#        private final ApplicationEventPublisher eventPublisher;  // ← inyectado por Spring
+#
+#        @Override
+#        public Order save(Order order) {
+#            OrderJpa jpa   = mapper.toJpa(order);
+#            OrderJpa saved = jpaRepository.save(jpa);          // 1. persiste en BD
+#            order.pullDomainEvents()
+#                 .forEach(eventPublisher::publishEvent);        // 2. publica al bus interno
+#            return mapper.toDomain(saved);
+#        }
+#    }
+#
+# ─────────────────────────────────────────────────────────────────────────────
+#
+# 5. orders/application/usecases/OrderDomainEventHandler.java  (bridge)
+#
+#    @Component
+#    public class OrderDomainEventHandler {
+#
+#        @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
+#        public void onOrderPlaced(OrderPlacedEvent event) {
+#            // TODO: messageBroker.sendOrderPlaced(event);
+#            //       notificationService.notify(event);
+#        }
+#
+#        @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
+#        public void onOrderCancelled(OrderCancelledEvent event) {
+#            // TODO: handle OrderCancelled
+#        }
+#
+#        @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
+#        public void onOrderShipped(OrderShippedEvent event) {
+#            // TODO: handle OrderShipped
+#        }
+#    }
+#
+# ─────────────────────────────────────────────────────────────────────────────
+#
+# Para conectar un broker externo después de generar:
+#   eva4j g kafka-event orders OrderPlaced
+#   (el selector muestra los eventos declarados en este domain.yaml como opciones)
+
+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
+          - name: customerId
+            type: String
+          - name: status
+            type: OrderStatus
+          - name: totalAmount
+            type: BigDecimal
+            readOnly: true
+
+    enums:
+      - name: OrderStatus
+        values:
+          - DRAFT
+          - PLACED
+          - CONFIRMED
+          - SHIPPED
+          - DELIVERED
+          - CANCELLED
+        transitions:
+          - from: DRAFT
+            to: PLACED
+          - from: DRAFT
+            to: CANCELLED
+          - from: PLACED
+            to: CONFIRMED
+          - from: PLACED
+            to: CANCELLED
+          - from: CONFIRMED
+            to: SHIPPED
+          - from: CONFIRMED
+            to: CANCELLED
+          - from: SHIPPED
+            to: DELIVERED
+
+    # ─── Domain Events ────────────────────────────────────────────────────────
+    # Siblings de entities:, enums: y valueObjects:
+    # La declaración es agnóstica al broker — ningún campo de infraestructura aquí.
+    # Cada entrada genera: domain/models/events/{Name}Event.java
+
+    events:
+      - name: OrderPlaced
+        fields:
+          - name: customerId
+            type: String
+          - name: orderNumber
+            type: String
+          - name: totalAmount
+            type: BigDecimal
+
+      - name: OrderCancelled
+        fields:
+          - name: reason
+            type: String
+
+      - name: OrderShipped
+        fields:
+          - name: shippingAddress
+            type: String
+          - name: estimatedDeliveryDate
+            type: LocalDate

package/examples/domain-field-visibility.yaml

@@ -6,7 +6,7 @@ aggregates:
   # User Management Aggregate
   - name: User
     entities:
-      - name: user
+      - name: User
         isRoot: true
         tableName: users
         audit:
@@ -40,6 +40,7 @@ aggregates:
           - name: loginCount
             type: Integer
             readOnly: true
+            defaultValue: 0   # Initialized to 0 on creation
           
           # Readonly field - NOT in constructor or CreateDto
           # Use case: Calculated timestamp
@@ -57,7 +58,7 @@ aggregates:
   # Order Management Aggregate
   - name: Order
     entities:
-      - name: order
+      - name: Order
         isRoot: true
         tableName: orders
         audit:
@@ -80,11 +81,13 @@ aggregates:
           - name: totalAmount
             type: BigDecimal
             readOnly: true
+            defaultValue: "0.00"  # Starts at zero before items are added
           
           # Readonly field - count of items
           - name: itemCount
             type: Integer
             readOnly: true
+            defaultValue: 0   # Starts at zero
           
           # Hidden field - internal processing flag
           - name: processingToken
@@ -97,7 +100,7 @@ aggregates:
             mappedBy: order
             cascade: [PERSIST, MERGE, REMOVE]
       
-      - name: orderItem
+      - name: OrderItem
         tableName: order_items
         fields:
           - name: id
@@ -116,6 +119,7 @@ aggregates:
           - name: subtotal
             type: BigDecimal
             readOnly: true
+            defaultValue: "0.00"  # Calculated on creation
         
         relationships:
           - type: ManyToOne
@@ -125,7 +129,7 @@ aggregates:
   # Product Catalog Aggregate
   - name: Product
     entities:
-      - name: product
+      - name: Product
         isRoot: true
         tableName: products
         audit:
@@ -147,6 +151,7 @@ aggregates:
           - name: stockLevel
             type: Integer
             readOnly: true
+            defaultValue: 0   # New products start with zero stock
           
           # Readonly field - last updated stock timestamp
           - name: stockUpdatedAt
@@ -166,7 +171,7 @@ aggregates:
   # Session Management Aggregate
   - name: Session
     entities:
-      - name: session
+      - name: Session
         isRoot: true
         tableName: sessions
         fields:
@@ -191,6 +196,7 @@ aggregates:
             type: Boolean
             hidden: true
             readOnly: true
+            defaultValue: false  # Sessions start as not revoked
           
           - name: createdAt
             type: LocalDateTime

package/examples/domain-multi-aggregate.yaml

@@ -6,7 +6,7 @@ aggregates:
   # AGREGADO 1: Customer
   - name: Customer
     entities:
-      - name: customer
+      - name: Customer
         isRoot: true
         tableName: customers
         auditable: true
@@ -30,7 +30,7 @@ aggregates:
             cascade: [PERSIST, MERGE, REMOVE]
             fetch: LAZY
       
-      - name: address
+      - name: Address
         tableName: customer_addresses
         fields:
           - name: id
@@ -77,7 +77,7 @@ aggregates:
   # AGREGADO 2: Supplier
   - name: Supplier
     entities:
-      - name: supplier
+      - name: Supplier
         isRoot: true
         tableName: suppliers
         auditable: true
@@ -97,7 +97,7 @@ aggregates:
           - name: rating
             type: Integer
       
-      - name: contract
+      - name: Contract
         tableName: contracts
         auditable: true
         fields:
@@ -133,7 +133,7 @@ aggregates:
   # AGREGADO 3: Inventory
   - name: Inventory
     entities:
-      - name: inventory
+      - name: Inventory
         isRoot: true
         tableName: inventory
         auditable: true
@@ -142,8 +142,14 @@ aggregates:
             type: String
           - name: productId
             type: String
+            reference:
+              aggregate: Product
+              module: catalog
           - name: warehouseId
             type: String
+            reference:
+              aggregate: Warehouse
+              module: warehouses
           - name: quantity
             type: Integer
           - name: reservedQuantity
@@ -163,7 +169,7 @@ aggregates:
             cascade: [PERSIST, MERGE]
             fetch: LAZY
       
-      - name: stockMovement
+      - name: StockMovement
         tableName: stock_movements
         auditable: true
         fields:

package/examples/domain-one-to-many.yaml

@@ -5,7 +5,7 @@
 aggregates:
   - name: Order
     entities:
-      - name: order
+      - name: Order
         isRoot: true
         tableName: orders
         audit:

package/examples/domain-one-to-one.yaml

@@ -29,7 +29,7 @@ aggregates:
         relationships:
           - type: OneToOne
             target: UserProfile
-            mappedBy: User
+            mappedBy: user
             cascade: [PERSIST, MERGE, REMOVE]
             fetch: LAZY
       

package/examples/domain-secondary-onetomany.yaml

@@ -11,7 +11,7 @@
 aggregates:
   - name: Project
     entities:
-      - name: project
+      - name: Project
         isRoot: true
         tableName: projects
         audit:

package/examples/domain-secondary-onetoone.yaml

@@ -11,7 +11,7 @@
 aggregates:
   - name: Order
     entities:
-      - name: order
+      - name: Order
         isRoot: true
         tableName: orders
         audit:

package/examples/domain-simple.yaml

@@ -6,7 +6,7 @@
 aggregates:
   - name: Product
     entities:
-      - name: product
+      - name: Product
         isRoot: true
         tableName: products
         auditable: true

package/examples/domain-soft-delete.yaml

@@ -5,7 +5,7 @@
 aggregates:
   - name: Document
     entities:
-      - name: document
+      - name: Document
         isRoot: true
         tableName: documents
         auditable: true
@@ -48,7 +48,7 @@ aggregates:
             cascade: [PERSIST, MERGE, REMOVE]
             fetch: LAZY
       
-      - name: revision
+      - name: Revision
         tableName: document_revisions
         auditable: true
         fields:
@@ -66,7 +66,7 @@ aggregates:
             type: String
        
       
-      - name: attachment
+      - name: Attachment
         tableName: document_attachments
         auditable: true
         fields:

package/examples/domain-transitions.yaml

@@ -1,7 +1,7 @@
 aggregates:
   - name: Order
     entities:
-      - name: order
+      - name: Order
         isRoot: true
         tableName: orders
         audit:

package/examples/domain-value-objects.yaml

@@ -5,7 +5,7 @@
 aggregates:
   - name: User
     entities:
-      - name: user
+      - name: User
         isRoot: true
         tableName: users
         auditable: true

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "eva4j",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "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": {
-    "eva4j": "./bin/eva4j.js"
+    "eva": "./bin/eva4j.js"
   },
   "scripts": {
     "start": "node bin/eva4j.js",

package/src/commands/add-kafka-client.js

@@ -7,6 +7,7 @@ const ConfigManager = require('../utils/config-manager');
 const { isEva4jProject } = require('../utils/validator');
 const { toPackagePath } = require('../utils/naming');
 const { renderAndWrite, renderTemplate } = require('../utils/template-engine');
+const defaults = require('../../config/defaults.json');
 
 async function addKafkaClientCommand() {
   const projectDir = process.cwd();
@@ -53,7 +54,8 @@ async function addKafkaClientCommand() {
       packagePath,
       projectName,
       groupId,
-      artifactId
+      artifactId,
+      kafkaConfluentVersion: defaults.kafkaConfluentVersion
     };
 
     // 1. Add dependencies to build.gradle