eva4j 1.0.17 → 1.0.18

package/AGENTS.md

@@ -625,6 +625,7 @@ Si un evento **no declara `triggers`** ni `lifecycle`, el desarrollador debe lla
 - **C2-008** (error): valor de `lifecycle` inválido (no es `create`, `update`, `delete` ni `softDelete`)
 - **C2-009** (warning): `lifecycle: softDelete` sin `hasSoftDelete: true` en la entidad raíz, o `lifecycle: delete` con `hasSoftDelete: true`
 - **C2-010** (error): campo de lifecycle event no existe en la entidad raíz del agregado (excluyendo `{entityName}Id` y campos `*At` + `LocalDateTime`)
+- **C2-012** (error): nombre del agregado no coincide con la entidad raíz — el generador usa `aggregate.name` para imports/mappers pero la clase de dominio se genera desde `entity.name`, causando `cannot find symbol`
 
 **Auto-wiring de broker:** Si el proyecto tiene un broker de mensajería instalado (`eva add kafka-client`), `eva g entities` genera automáticamente la capa de Integration Events para **todos** los eventos declarados — sin necesidad de ejecutar `eva g kafka-event` por separado:
 
@@ -1443,6 +1444,7 @@ private String customerId;
 5. **SABER** que cualquier otro nombre genera un **scaffold** con `UnsupportedOperationException` — el desarrollador debe implementar el handler
 6. **APLICAR** la regla anti-duplicado: si el mismo useCase aparece en v1 y v2, se genera solo una vez
 7. **NOMBRAR** los controladores según la convención: `{Aggregate}{VersionCapitalized}Controller` (ej: `OrderV1Controller`)
+8. **SI** el módulo tiene **2+ agregados** → usar `basePath: ""` (string vacío, **NO** `basePath: /`) y paths absolutos por operación (ej: `/products`, `/categories/{id}`). Si tiene un solo agregado → `basePath: /recurso` con paths relativos
 
 ### Al Generar Código de Dominio
 

package/DOMAIN_YAML_GUIDE.md

@@ -2337,7 +2337,7 @@ public void removeOrderItem(OrderItem orderItem) {
 
 **Genera en JPA:**
 ```java
-@OneToMany(mappedBy = "order", cascade = {CascadeType.PERSIST, CascadeType.MERGE, CascadeType.REMOVE}, fetch = FetchType.LAZY)
+@OneToMany(mappedBy = "order", cascade = {CascadeType.PERSIST, CascadeType.MERGE, CascadeType.REMOVE}, orphanRemoval = true, fetch = FetchType.LAZY)
 @Builder.Default
 private List<OrderItemJpa> orderItems = new ArrayList<>();
 ```
@@ -2565,6 +2565,8 @@ relationships:
 | `DETACH` | Al separar el padre, separa los hijos | ⚠️ Rara vez necesario |
 | `ALL` | Todas las operaciones anteriores | ⚠️ Solo si estás seguro |
 
+> **Nota:** eva4j genera automáticamente `orphanRemoval = true` en todas las relaciones `@OneToMany` y `@OneToOne(mappedBy)`. Esto asegura que al remover un hijo de la colección del padre, JPA elimina la fila de la base de datos. Es el comportamiento correcto en DDD: las entidades secundarias del agregado no tienen existencia independiente — su ciclo de vida lo controla la raíz.
+
 #### **Configuraciones Recomendadas:**
 
 ```yaml

package/QUICK_REFERENCE.md

@@ -120,13 +120,17 @@ eva detach order
 
 ## 🧩 Temporal Queue Model
 
+Queues are **module-scoped** — each module gets its own set of queues prefixed with the module name in SCREAMING_SNAKE_CASE:
+
 | Queue | Purpose | ActivityOptions var |
 |-------|---------|---------------------|
-| `FLOW_QUEUE` | Workflow orchestration | — |
-| `LIGHT_TASK_QUEUE` | Fast activities < 30 s | `lightActivityOptions` |
-| `HEAVY_TASK_QUEUE` | Long-running ≤ 2 min | `heavyActivityOptions` |
+| `{MODULE}_WORKFLOW_QUEUE` | Workflow orchestration | — |
+| `{MODULE}_LIGHT_TASK_QUEUE` | Fast activities < 30 s | `lightActivityOptions` |
+| `{MODULE}_HEAVY_TASK_QUEUE` | Long-running ≤ 2 min | `heavyActivityOptions` |
+
+Example for module `order`: `ORDER_WORKFLOW_QUEUE`, `ORDER_LIGHT_TASK_QUEUE`, `ORDER_HEAVY_TASK_QUEUE`.
 
-Activities are registered automatically via Spring DI (`LightActivity` / `HeavyActivity` marker interfaces). No manual `TemporalConfig.java` patching needed.
+Activities are registered automatically via Spring DI (`{Module}LightActivity` / `{Module}HeavyActivity` marker interfaces). Each module has its own `{Module}TemporalWorkerConfig.java` — no shared `TemporalConfig.java` patching needed.
 
 ---
 

package/bin/eva4j.js

@@ -6,16 +6,20 @@ const packageJson = require('../package.json');
 const createCommand = require('../src/commands/create');
 const addModuleCommand = require('../src/commands/add-module');
 const addKafkaClientCommand = require('../src/commands/add-kafka-client');
+const addRabbitMQClientCommand = require('../src/commands/add-rabbitmq-client');
 const addTemporalClientCommand = require('../src/commands/add-temporal-client');
 const generateUsecaseCommand = require('../src/commands/generate-usecase');
 const generateHttpExchangeCommand = require('../src/commands/generate-http-exchange');
 const generateKafkaEventCommand = require('../src/commands/generate-kafka-event');
 const generateKafkaListenerCommand = require('../src/commands/generate-kafka-listener');
+const generateRabbitMQEventCommand = require('../src/commands/generate-rabbitmq-event');
+const generateRabbitMQListenerCommand = require('../src/commands/generate-rabbitmq-listener');
 const generateResourceCommand = require('../src/commands/generate-resource');
 const generateRecordCommand = require('../src/commands/generate-record');
 const generateEntitiesCommand = require('../src/commands/generate-entities');
 const generateTemporalFlowCommand = require('../src/commands/generate-temporal-flow');
 const generateTemporalActivityCommand = require('../src/commands/generate-temporal-activity');
+const generateTemporalSystemCommand = require('../src/commands/generate-temporal-system');
 const buildCommand = require('../src/commands/build');
 const evaluateSystemCommand = require('../src/commands/evaluate-system');
 const infoCommand = require('../src/commands/info');
@@ -45,7 +49,7 @@ program
 // Add module command
 program
   .command('add <type> [name]')
-  .description('Add components to the project. Use: module [name], kafka-client, temporal-client')
+  .description('Add components to the project. Use: module [name], kafka-client, rabbitmq-client, temporal-client')
   .action(async (type, name, options) => {
     if (type === 'kafka-client') {
       try {
@@ -57,6 +61,16 @@ program
       return;
     }
 
+    if (type === 'rabbitmq-client') {
+      try {
+        await addRabbitMQClientCommand(options);
+      } catch (error) {
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+      return;
+    }
+
     if (type === 'temporal-client') {
       try {
         await addTemporalClientCommand(options);
@@ -72,6 +86,7 @@ program
       console.log(chalk.yellow('\nUsage:'));
       console.log(chalk.gray('  eva4j add module [module-name]  # Interactive or with name'));
       console.log(chalk.gray('  eva4j add kafka-client'));
+      console.log(chalk.gray('  eva4j add rabbitmq-client'));
       console.log(chalk.gray('  eva4j add temporal-client'));
       console.log(chalk.gray('\nExamples:'));
       console.log(chalk.gray('  eva4j add module user'));
@@ -91,7 +106,7 @@ program
 program
   .command('generate <type> [module] [name]')
   .alias('g')
-  .description('Generate components (usecase, http-exchange, kafka-event, kafka-listener, resource, record)')
+  .description('Generate components (usecase, http-exchange, kafka-event, kafka-listener, rabbitmq-event, rabbitmq-listener, resource, record)')
   .option('--force', 'Overwrite files even if they were manually modified (bypasses safe mode)')
   .action(async (type, module, name, options) => {
     if (type === 'usecase') {
@@ -166,6 +181,42 @@ program
       return;
     }
 
+    if (type === 'rabbitmq-event') {
+      if (!module) {
+        console.error(chalk.red('❌ Module name is required'));
+        console.log(chalk.gray('Usage: eva4j generate rabbitmq-event <module> [event-name]'));
+        console.log(chalk.gray('Examples:'));
+        console.log(chalk.gray('  eva4j generate rabbitmq-event user user-created'));
+        console.log(chalk.gray('  eva4j generate rabbitmq-event user  # Will prompt for event name\n'));
+        process.exit(1);
+      }
+      try {
+        await generateRabbitMQEventCommand(module, name, options);
+      } catch (error) {
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+      return;
+    }
+
+    if (type === 'rabbitmq-listener') {
+      if (!module) {
+        console.error(chalk.red('❌ Module name is required'));
+        console.log(chalk.gray('Usage: eva4j generate rabbitmq-listener <module>'));
+        console.log(chalk.gray('Examples:'));
+        console.log(chalk.gray('  eva4j generate rabbitmq-listener user'));
+        console.log(chalk.gray('  eva4j g rabbitmq-listener order\n'));
+        process.exit(1);
+      }
+      try {
+        await generateRabbitMQListenerCommand(module, options);
+      } catch (error) {
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+      return;
+    }
+
     if (type === 'record') {
       // Record command doesn't require module/name as parameters
       // They will be prompted interactively
@@ -239,6 +290,16 @@ program
       return;
     }
 
+    if (type === 'temporal-system') {
+      try {
+        await generateTemporalSystemCommand(options);
+      } catch (error) {
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+      }
+      return;
+    }
+
     if (type === 'resource') {
       if (!module) {
         console.error(chalk.red('❌ Module name is required'));
@@ -263,8 +324,11 @@ program
     console.log(chalk.gray('  eva4j generate http-exchange <port-name> <module>'));
     console.log(chalk.gray('  eva4j generate kafka-event <event-name> <module>'));
     console.log(chalk.gray('  eva4j generate kafka-listener <module>'));
+    console.log(chalk.gray('  eva4j generate rabbitmq-event <event-name> <module>'));
+    console.log(chalk.gray('  eva4j generate rabbitmq-listener <module>'));
     console.log(chalk.gray('  eva4j generate temporal-flow <module> [workflow-name]'));
     console.log(chalk.gray('  eva4j generate temporal-activity <module> [activity-name]'));
+    console.log(chalk.gray('  eva4j generate temporal-system'));
     console.log(chalk.gray('  eva4j generate resource <module>'));
     console.log(chalk.gray('  eva4j generate record'));
     console.log(chalk.gray('  eva4j generate entities <module>'));
@@ -273,8 +337,11 @@ program
     console.log(chalk.gray('  eva4j g http-exchange user-service-port user'));
     console.log(chalk.gray('  eva4j g kafka-event user-created user'));
     console.log(chalk.gray('  eva4j g kafka-listener user'));
+    console.log(chalk.gray('  eva4j g rabbitmq-event user-created user'));
+    console.log(chalk.gray('  eva4j g rabbitmq-listener user'));
     console.log(chalk.gray('  eva4j g temporal-flow order process-order'));
     console.log(chalk.gray('  eva4j g temporal-activity order register-order'));
+    console.log(chalk.gray('  eva4j g temporal-system  # Reads from system/system.yaml'));
     console.log(chalk.gray('  eva4j g resource product'));
     console.log(chalk.gray('  eva4j g record  # Reads JSON from clipboard'));
     console.log(chalk.gray('  eva4j g entities order  # Generates from domain.yaml\n'));
@@ -359,6 +426,7 @@ program.on('--help', () => {
   console.log(chalk.gray('  $ eva4j add module user'));
   console.log(chalk.gray('  $ eva4j add module product'));
   console.log(chalk.gray('  $ eva4j add kafka-client'));
+  console.log(chalk.gray('  $ eva4j add rabbitmq-client'));
   console.log(chalk.gray('  $ eva4j generate usecase create-provider provider'));
   console.log(chalk.gray('  $ eva4j g usecase get-all-products product'));
   console.log(chalk.gray('  $ eva4j g http-exchange user-service-port user'));

package/config/defaults.json

@@ -8,6 +8,7 @@
   "temporalSdkVersion": "1.24.1",
   "temporalDockerVersion": "1.21.5",
   "kafkaConfluentVersion": "7.6.0",
+  "rabbitmqVersion": "4-management",
   "springdocVersion": "2.8.13",
   "gradleVersion": "8.7",
   "encoding": "UTF-8",