eva4j 1.0.16 → 1.0.18

package/COMMAND_EVALUATION.md

@@ -1,911 +0,0 @@
-# Evaluación del Comando `generate entities`
-
-## 📊 Resumen Ejecutivo
-
-| Aspecto | Estado | Cobertura |
-|---------|--------|-----------|
-| **Funcionalidades Básicas** | ✅ Completo | 100% |
-| **DDD Patterns** | ✅ Completo | 90% |
-| **Relaciones JPA** | ✅ Completo | 85% |
-| **Validaciones** | ❌ Pendiente | 0% |
-| **Auditoría** | ❌ Pendiente | 0% |
-| **Performance** | 🟡 Básico | 60% |
-| **Cobertura General** | ✅ Bueno | **78%** |
-
----
-
-## ✅ Funcionalidades Implementadas
-
-### 1. Generación de Entidades de Dominio
-
-**Estado**: ✅ Completamente implementado
-
-#### Características
-- ✅ Entidades puras Java (sin Lombok, sin JPA)
-- ✅ Constructores manuales con todos los campos
-- ✅ Getters y setters manuales
-- ✅ Métodos de negocio automáticos para colecciones (add/remove)
-- ✅ Soporte para relaciones OneToMany, ManyToOne, OneToOne
-- ✅ Separación clara domain vs infrastructure
-
-#### Calidad del Código Generado
-```java
-// ✅ Código generado de alta calidad
-public class Order {
-    private String id;
-    private OrderStatus status;
-    private Money totalAmount;
-    private List<OrderItem> orderItems = new ArrayList<>();
-    
-    // Constructor manual con todos los campos
-    public Order(String id, OrderStatus status, Money totalAmount) {
-        this.id = id;
-        this.status = status;
-        this.totalAmount = totalAmount;
-    }
-    
-    // Métodos de negocio automáticos
-    public void addOrderItem(OrderItem orderItem) {
-        this.orderItems.add(orderItem);
-    }
-}
-```
-
-**Cobertura**: 100% de los casos de uso comunes
-
----
-
-### 2. Generación de Entidades JPA
-
-**Estado**: ✅ Completamente implementado
-
-#### Características
-- ✅ Anotaciones JPA completas (@Entity, @Table, @Id, etc.)
-- ✅ Lombok para reducir boilerplate (@Getter, @Setter, @Builder)
-- ✅ Generación de IDs automática según tipo:
-  - String → `@GeneratedValue(strategy = GenerationType.UUID)`
-  - Long/Integer → `@GeneratedValue(strategy = GenerationType.IDENTITY)`
-- ✅ Relaciones bidireccionales automáticas desde mappedBy
-- ✅ Generación automática de lado inverso (OneToMany → ManyToOne)
-- ✅ Cascade y Fetch configurables desde YAML
-- ✅ Referencias correctas con sufijo "Jpa" (OrderJpa → OrderItemJpa)
-
-#### Ejemplo Generado
-```java
-@Entity
-@Table(name = "orders")
-@Getter
-@Setter
-@NoArgsConstructor
-@AllArgsConstructor
-@Builder
-public class OrderJpa {
-    @Id
-    @GeneratedValue(strategy = GenerationType.UUID)
-    private String id;
-    
-    @Enumerated(EnumType.STRING)
-    private OrderStatus status;
-    
-    @Embedded
-    private MoneyJpa totalAmount;
-    
-    @OneToMany(mappedBy = "order", cascade = {CascadeType.PERSIST, CascadeType.MERGE}, fetch = FetchType.LAZY)
-    @Builder.Default
-    private List<OrderItemJpa> orderItems = new ArrayList<>();
-}
-```
-
-**Cobertura**: 95% (falta ManyToMany completo)
-
----
-
-### 3. Value Objects
-
-**Estado**: ✅ Completamente implementado
-
-#### Características
-- ✅ Inmutabilidad completa (final fields)
-- ✅ Constructor con todos los campos
-- ✅ Getters sin setters
-- ✅ equals() y hashCode() automáticos basados en todos los campos
-- ✅ Versión JPA embebida (@Embeddable)
-- ✅ Detección automática en campos de entidades
-- ✅ Soporte para List<ValueObject> con @ElementCollection
-
-#### Calidad
-```java
-// Domain VO (inmutable)
-public class Money {
-    private final BigDecimal amount;
-    private final String currency;
-    
-    public Money(BigDecimal amount, String currency) {
-        this.amount = amount;
-        this.currency = currency;
-    }
-    
-    // Solo getters, sin setters
-    // equals() y hashCode() incluidos
-}
-
-// JPA VO (embeddable)
-@Embeddable
-public class MoneyJpa {
-    private BigDecimal amount;
-    private String currency;
-    // Con Lombok
-}
-```
-
-**Cobertura**: 100%
-
----
-
-### 4. Enumeraciones
-
-**Estado**: ✅ Completamente implementado
-
-#### Características
-- ✅ Generación automática desde YAML
-- ✅ Detección automática en campos
-- ✅ Importación automática en entidades que los usan
-- ✅ Anotación @Enumerated(EnumType.STRING) en JPA
-- ✅ Enums globales al módulo (compartibles entre agregados)
-
-**Cobertura**: 100%
-
----
-
-### 5. Mappers (Domain ↔ JPA)
-
-**Estado**: ✅ Completamente implementado
-
-#### Características
-- ✅ Conversión bidireccional toDomain() / toJpa()
-- ✅ Mapeo correcto de Value Objects
-- ✅ Mapeo de colecciones (OneToMany)
-- ✅ Referencias bidireccionales correctas
-- ✅ Null-safe (validación de nulls)
-- ✅ Uso de constructores para entidades de dominio
-- ✅ Uso de builders para entidades JPA
-- ✅ Nombres de getters correctos basados en nombres de campos
-
-#### Calidad
-```java
-public Order toDomain(OrderJpa jpa) {
-    if (jpa == null) return null;
-    
-    return new Order(
-        jpa.getId(),
-        jpa.getStatus(),
-        toDomainMoney(jpa.getTotalAmount())
-    );
-}
-```
-
-**Cobertura**: 95% (casos edge pendientes)
-
----
-
-### 6. Repositorios
-
-**Estado**: ✅ Completamente implementado
-
-#### Características
-- ✅ Interfaz en capa de dominio (port)
-- ✅ Implementación en infrastructure (adapter)
-- ✅ Spring Data JPA Repository
-- ✅ Métodos CRUD básicos (save, findById, findAll, deleteById, existsById)
-- ✅ Tipo de ID dinámico según entidad (String, Long, Integer)
-- ✅ Uso del mapper para conversiones
-- ✅ Patrón Repository correctamente implementado
-
-#### Ejemplo
-```java
-// Domain (puerto)
-public interface OrderRepository {
-    Order save(Order order);
-    Optional<Order> findById(String id);
-    List<Order> findAll();
-    void deleteById(String id);
-    boolean existsById(String id);
-}
-
-// Infrastructure (adaptador)
-@Repository
-@RequiredArgsConstructor
-public class OrderRepositoryImpl implements OrderRepository {
-    private final OrderJpaRepository jpaRepository;
-    private final OrderMapper mapper;
-    
-    @Override
-    public Order save(Order order) {
-        OrderJpa jpa = mapper.toJpa(order);
-        OrderJpa saved = jpaRepository.save(jpa);
-        return mapper.toDomain(saved);
-    }
-}
-```
-
-**Cobertura**: 80% (falta queries personalizados)
-
----
-
-### 7. Relaciones JPA
-
-**Estado**: ✅ Completo
-
-#### Implementado
-- ✅ OneToMany con cascade y fetch configurables
-- ✅ **Relaciones bidireccionales automáticas desde mappedBy** 🆕
-- ✅ Generación automática de ManyToOne inverso cuando OneToMany usa mappedBy
-- ✅ ManyToOne con joinColumn (manual o autogenerado)
-- ✅ OneToOne básico y con mappedBy
-- ✅ Detección automática de colecciones
-- ✅ mappedBy para relaciones bidireccionales
-
-#### Cómo Funciona la Generación Automática
-
-```yaml
-# Solo defines el lado OneToMany
-rootEntity:
-  name: order
-  relationships:
-    - type: OneToMany
-      target: OrderItem
-      mappedBy: order  # ← eva4j genera automáticamente el ManyToOne
-```
-
-**eva4j genera automáticamente en OrderItem:**
-
-```java
-@ManyToOne(fetch = FetchType.LAZY)
-@JoinColumn(name = "order_id")
-private OrderJpa order;
-```
-
-**Ventajas:**
-- No necesitas definir ambos lados manualmente
-- Evita inconsistencias
-- joinColumn se infiere automáticamente desde mappedBy
-
-#### Pendiente
-- ❌ ManyToMany con tabla intermedia
-- ❌ OneToOne avanzado (orphanRemoval, optional)
-- ❌ @JoinTable personalizada
-- ❌ Composite keys
-
-**Cobertura**: 85% (+15% con generación automática)
-
----
-
-### 8. Tipos de Datos
-
-**Estado**: ✅ Completamente implementado
-
-#### Soportados
-- ✅ Primitivos: String, Integer, Long, Double, Float, Boolean
-- ✅ Decimales: BigDecimal
-- ✅ Fechas: LocalDate, LocalDateTime, LocalTime
-- ✅ UUID
-- ✅ Enums personalizados
-- ✅ Value Objects personalizados
-- ✅ Colecciones: List<String>, List<VO>
-
-#### Importaciones Automáticas
-- ✅ BigDecimal → `import java.math.BigDecimal;`
-- ✅ LocalDate → `import java.time.LocalDate;`
-- ✅ Enums → `import ...enums.OrderStatus;`
-- ✅ Sin imports innecesarios en entidades de dominio
-
-**Cobertura**: 95%
-
----
-
-### 9. Generación de Código Limpio
-
-**Estado**: ✅ Excelente
-
-#### Logros
-- ✅ Espaciado uniforme (1 línea entre propiedades)
-- ✅ Anotaciones compactas sin líneas vacías extras
-- ✅ Imports organizados y sin duplicados
-- ✅ Nombres de métodos consistentes (camelCase)
-- ✅ Sin código comentado o placeholder
-- ✅ Convenciones Java estándar
-
-**Cobertura**: 100%
-
----
-
-## ⚠️ Limitaciones Actuales
-
-### 1. Validaciones (0% implementado)
-
-**Impacto**: Alto - Requerido en el 90% de aplicaciones empresariales
-
-#### Casos de Uso No Cubiertos
-```yaml
-# ❌ No soportado actualmente
-fields:
-  - name: email
-    type: String
-    validations:
-      - type: Email
-      - type: NotBlank
-      - type: Size
-        min: 5
-        max: 100
-```
-
-#### Solución Temporal
-Agregar manualmente en código generado:
-```java
-@Email(message = "Email inválido")
-@NotBlank
-@Size(min = 5, max = 100)
-private String email;
-```
-
-**Esfuerzo para implementar**: Bajo (1-2 horas)  
-**Prioridad**: 🔥 Alta
-
----
-
-### 2. Auditoría (0% implementado)
-
-**Impacto**: Alto - Común en aplicaciones enterprise
-
-#### Casos de Uso No Cubiertos
-```yaml
-# ❌ No soportado actualmente
-rootEntity:
-  name: order
-  auditable: true  # Debería agregar campos de auditoría
-```
-
-Requiere manualmente:
-```java
-@CreatedDate
-private LocalDateTime createdAt;
-
-@LastModifiedDate
-private LocalDateTime updatedAt;
-
-@CreatedBy
-private String createdBy;
-
-@LastModifiedBy
-private String updatedBy;
-```
-
-**Esfuerzo para implementar**: Medio (3-4 horas)  
-**Prioridad**: 🔥 Alta
-
----
-
-### 3. Query Methods Personalizados (0% implementado)
-
-**Impacto**: Alto - Evita escribir queries manualmente
-
-#### Casos de Uso No Cubiertos
-```yaml
-# ❌ No soportado actualmente
-aggregates:
-  - name: Order
-    repositories:
-      customQueries:
-        - name: findByStatusAndCreatedAtAfter
-          returnType: List<Order>
-          parameters:
-            - name: status
-              type: OrderStatus
-            - name: date
-              type: LocalDateTime
-```
-
-**Solución Temporal**: Agregar manualmente en `OrderRepository`
-
-**Esfuerzo para implementar**: Bajo (2-3 horas)  
-**Prioridad**: 🟡 Media
-
----
-
-### 4. Soft Delete ✅ Implementado
-
-**Impacto**: Medio - Común en apps business
-
-#### Sintaxis
-```yaml
-# ✅ Soportado — solo en la entidad raíz (isRoot: true)
-entities:
-  - name: order
-    isRoot: true
-    hasSoftDelete: true  # Genera deletedAt, softDelete(), @SQLRestriction
-```
-
-**Estado**: Implementado en `yaml-to-entity.js` + templates `AggregateRoot`, `JpaAggregateRoot`, repositorios y `DeleteCommandHandler`.
-
----
-
-### 5. Índices y Constraints (0% implementado)
-
-**Impacto**: Medio - Importante para performance
-
-#### Casos de Uso No Cubiertos
-```yaml
-# ❌ No soportado actualmente
-rootEntity:
-  name: order
-  indexes:
-    - name: idx_order_number
-      columns: [orderNumber]
-      unique: true
-```
-
-**Solución Temporal**: Agregar manualmente o en migrations
-
-**Esfuerzo para implementar**: Bajo (2-3 horas)  
-**Prioridad**: 🟡 Media
-
----
-
-### 6. Herencia de Entidades (0% implementado)
-
-**Impacto**: Bajo - Solo para dominios complejos
-
-#### Casos de Uso No Cubiertos
-```yaml
-# ❌ No soportado actualmente
-entities:
-  - name: Payment
-    inheritance:
-      strategy: JOINED
-      discriminatorColumn: payment_type
-```
-
-**Esfuerzo para implementar**: Alto (8-10 horas)  
-**Prioridad**: 🔵 Baja
-
----
-
-### 7. DTOs Automáticos (0% implementado)
-
-**Impacto**: Alto - Pero requiere más diseño
-
-#### Casos de Uso No Cubiertos
-```yaml
-# ❌ No soportado actualmente
-aggregates:
-  - name: Order
-    dtos:
-      - name: CreateOrderRequest
-        fields: [customerId, items]
-```
-
-**Esfuerzo para implementar**: Alto (12-15 horas)  
-**Prioridad**: 🔵 Baja (requiere análisis de diseño)
-
----
-
-### 8. Eventos de Dominio (0% implementado)
-
-**Impacto**: Medio - Para arquitecturas event-driven
-
-**Esfuerzo para implementar**: Alto (10-12 horas)  
-**Prioridad**: 🔵 Baja
-
----
-
-## 📈 Análisis de Cobertura por Escenarios
-
-### Escenarios Completamente Cubiertos (✅)
-
-1. ✅ **CRUD básico con agregados**
-   - Crear, leer, actualizar, eliminar
-   - Persistencia con JPA
-   - Mapeo domain ↔ infrastructure
-
-2. ✅ **Relaciones padre-hijo (OneToMany/ManyToOne)**
-   - Order → OrderItems
-   - Post → Comments
-   - Account → Transactions
-   - **Generación automática de lado inverso con mappedBy**
-
-3. ✅ **Relaciones bidireccionales**
-   - Definir solo un lado (OneToMany con mappedBy)
-   - eva4j genera automáticamente el ManyToOne inverso
-   - joinColumn inferido desde mappedBy
-
-4. ✅ **Value Objects embebidos**
-   - Money (amount, currency)
-   - Address (street, city, state, zip, country)
-   - ContactInfo, etc.
-
-5. ✅ **Enums para estados**
-   - OrderStatus, PaymentMethod, etc.
-   - Detección e importación automática
-
-6. ✅ **IDs flexibles**
-   - String → UUID
-   - Long → IDENTITY
-   - Integer → IDENTITY
-
-7. ✅ **Colecciones de primitivos y VOs**
-   - List<String> tags
-   - List<Address> addresses
-
----
-
-### Escenarios Parcialmente Cubiertos (🟡)
-
-1. 🟡 **Relaciones ManyToMany**
-   - Requiere configuración manual de @JoinTable
-   - Cobertura: 30%
-
-2. 🟡 **OneToOne avanzado**
-   - Funciona básico con mappedBy, pero falta orphanRemoval, optional
-   - Cobertura: 70%
-
-3. 🟡 **Queries personalizados**
-   - Solo CRUD básico, no queries específicos
-   - Cobertura: 20%
-
----
-
-### Escenarios No Cubiertos (❌)
-
-1. ❌ **Validaciones JSR-303** (0%)
-2. ❌ **Auditoría (createdAt, updatedAt)** (0%)
-3. ✅ **Soft delete** (implementado con `hasSoftDelete: true`)
-4. ❌ **Índices y constraints** (0%)
-5. ❌ **Herencia de entidades** (0%)
-6. ❌ **DTOs de aplicación** (0%)
-7. ❌ **Eventos de dominio** (0%)
-8. ❌ **Composite keys** (0%)
-
----
-
-## 🎯 Plan de Mejoras Priorizado
-
-### ✅ Completado Recientemente
-
-| # | Mejora | Estado | Impacto |
-|---|--------|--------|---------|
-| ✅ | **Relaciones bidireccionales automáticas** | Implementado | 🔥 Alto |
-
-**Logro**: +15% cobertura en relaciones JPA (70% → 85%)
-
----
-
-### Fase 1: Esenciales (1-2 semanas)
-**Objetivo**: Llegar al 88% de cobertura global
-
-| # | Mejora | Impacto | Esfuerzo | Prioridad |
-|---|--------|---------|----------|-----------|
-| 1 | Validaciones JSR-303 | 🔥 Alto | 2h | 🔥 Crítica |
-| 2 | Auditoría automática | 🔥 Alto | 4h | 🔥 Crítica |
-| 3 | Query methods personalizados | 🟡 Alto | 3h | 🔥 Alta |
-| 4 | Índices y constraints | 🟡 Medio | 3h | 🟡 Media |
-
-**Beneficio**: +10% cobertura global, cubre el 90% de proyectos reales
-
----
-
-### Fase 2: Avanzadas (2-4 semanas)
-**Objetivo**: Llegar al 93% de cobertura
-
-| # | Mejora | Impacto | Esfuerzo | Prioridad |
-|---|--------|---------|----------|-----------|
-| 5 | ~~Soft delete~~ | ✅ Implementado | — | — |
-| 6 | ManyToMany completo | 🟡 Medio | 6h | 🟡 Media |
-| 7 | OneToOne avanzado | 🟡 Bajo | 4h | 🔵 Baja |
-
-**Beneficio**: +5% cobertura, cubre casos avanzados
-
----
-
-### Fase 3: Arquitectura (1-2 meses)
-**Objetivo**: Funcionalidades enterprise
-
-| # | Mejora | Impacto | Esfuerzo | Prioridad |
-|---|--------|---------|----------|-----------|
-| 8 | Eventos de dominio | 🟡 Alto | 12h | 🔵 Baja |
-| 9 | DTOs automáticos | 🔥 Alto | 15h | 🔵 Baja |
-| 10 | Herencia de entidades | 🔵 Bajo | 10h | 🔵 Baja |
-
-**Beneficio**: +5% cobertura, arquitecturas avanzadas
-
----
-
-## 💡 Recomendaciones
-
-### Corto Plazo (Siguiente Sprint)
-
-1. **Implementar Validaciones JSR-303** ⭐⭐⭐⭐⭐
-   - Máximo impacto, mínimo esfuerzo
-   - Requerido en casi todos los proyectos
-   - ROI: 10/10
-
-2. **Implementar Auditoría** ⭐⭐⭐⭐
-   - Muy solicitado en enterprise
-   - Esfuerzo moderado
-   - ROI: 9/10
-
-3. **Implementar Query Methods** ⭐⭐⭐⭐
-   - Ahorra tiempo en repositories
-   - Spring Data lo implementa automáticamente
-   - ROI: 8/10
-
-### Mediano Plazo
-
-4. ~~**Soft Delete**~~ ✅ Implementado con `hasSoftDelete: true`
-
-5. **ManyToMany completo**
-   - Completa el soporte de relaciones JPA
-
-### Largo Plazo
-
-6. **DTOs y Eventos**
-   - Requiere más análisis de diseño
-   - Alto valor pero más complejo
-
----
-
-## 📊 Métricas de Calidad
-
-### Código Generado
-
-| Métrica | Actual | Objetivo | Estado |
-|---------|--------|----------|--------|
-| Líneas de código por agregado | ~800 | <1000 | ✅ |
-| Imports innecesarios | 0 | 0 | ✅ |
-| Warnings de compilación | 0 | 0 | ✅ |
-| Convenciones Java | 100% | 100% | ✅ |
-| Tests generados | 0% | 80% | ❌ |
-
-### Cobertura Funcional
-
-| Categoría | Actual | Objetivo |
-|-----------|--------|----------|
-| DDD Patterns | 90% | 95% |
-| JPA Features | 85% | 90% |
-| Validaciones | 0% | 90% |
-| Performance | 60% | 85% |
-| **Total** | **78%** | **90%** |
-
----
-
-## 🏆 Conclusiones
-
-### Fortalezas Principales
-
-1. ✅ **Excelente separación de capas**: Domain completamente libre de JPA
-2. ✅ **Mappers robustos**: Conversión bidireccional correcta con manejo de relaciones inversas
-3. ✅ **Relaciones bidireccionales automáticas**: Genera ManyToOne desde OneToMany con mappedBy
-4. ✅ **Value Objects**: Implementación completa y correcta
-5. ✅ **Código limpio**: Sin boilerplate, bien formateado
-6. ✅ **Flexibilidad**: Soporta múltiples tipos de ID, relaciones, etc.
-
-### Debilidades Principales
-
-1. ❌ **Sin validaciones**: Requiere agregar manualmente @NotNull, @Email, etc.
-2. ❌ **Sin auditoría**: Campos de auditoría deben agregarse manualmente
-3. ❌ **Queries básicos**: Solo CRUD, sin queries personalizados
-4. ❌ **Sin tests**: No genera tests unitarios ni de integración
-
-### Veredicto Final
-
-**El comando `generate entities` está en estado PRODUCCIÓN-READY para:**
-- ✅ Proyectos greenfield con DDD
-- ✅ Microservicios con hexagonal architecture
-- ✅ CRUDs con relaciones OneToMany/ManyToOne bidireccionales
-- ✅ Dominios con Value Objects y Enums
-- ✅ Relaciones complejas con generación automática de lado inverso
-
-**Requiere mejoras para:**
-- 🟡 Aplicaciones enterprise con auditoría
-- 🟡 Proyectos con validaciones complejas
-- 🟡 Sistemas con queries específicos de negocio
-
-**Cobertura Global**: **78%** (+3% con relaciones bidireccionales) → Objetivo recomendado: **90%**
-
-**Siguiente paso sugerido**: Implementar **Validaciones JSR-303** (2 horas, alto impacto)
-
----
-
-## 📅 Roadmap Sugerido
-
-### Q1 2026
-- ✅ ~~Generación básica de entidades~~
-- ✅ ~~Relaciones bidireccionales automáticas~~
-- 🔥 Validaciones JSR-303
-- 🔥 Auditoría automática
-
-### Q2 2026
-- Query methods personalizados
-- Soft delete
-- Índices y constraints
-
-### Q3 2026
-- ManyToMany completo
-- Eventos de dominio
-- Tests automáticos
-
-### Q4 2026
-- DTOs automáticos
-- Herencia de entidades
-- Composite keys
-
----
-
-**Última actualización**: Febrero 2, 2026  
-**Versión evaluada**: 1.0.0  
-**Evaluador**: Sistema de evaluación eva4j
-
-
-### 1. Relaciones ManyToMany y OneToOne
-
-```yaml
-relationships:
-  - type: ManyToMany
-    target: Tag
-    joinTable: 
-      name: order_tags
-      joinColumn: order_id
-      inverseJoinColumn: tag_id
-```
-
-**Implementación**: Ya está preparado en el parser, solo falta refinar templates.
-
----
-
-### 2. Herencia de entidades
-
-```yaml
-entities:
-  - name: Payment
-    isRoot: true
-    inheritance:
-      strategy: JOINED  # o SINGLE_TABLE, TABLE_PER_CLASS
-      discriminatorColumn: payment_type
-    
-  - name: CreditCardPayment
-    extends: Payment
-    discriminatorValue: CREDIT_CARD
-```
-
-**Impacto**: Cubriría polimorfismo en dominios complejos.
-
----
-
-### 3. Auditoría automática
-
-```yaml
-entities:
-  - name: Order
-    auditable: true  # Agrega createdAt, updatedAt, createdBy, updatedBy
-```
-
-**Implementación**: Generar campos + `@EntityListeners(AuditingEntityListener.class)`.
-
----
-
-### 4. Soft Delete ✅ Implementado
-
-```yaml
-entities:
-  - name: Order
-    isRoot: true
-    hasSoftDelete: true  # Genera deletedAt, softDelete(), isDeleted(), @SQLRestriction
-```
-
-**Implementado**: `deletedAt` inyectado automáticamente, `@SQLRestriction("deleted_at IS NULL")` en JPA, `softDelete()` + `isDeleted()` en dominio, `DeleteCommandHandler` usa borrado lógico.
-
----
-
-### 5. Validaciones JSR-303
-
-```yaml
-fields:
-  - name: email
-    type: String
-    validations:
-      - type: Email
-        message: "Email inválido"
-      - type: NotBlank
-      - type: Size
-        min: 5
-        max: 100
-```
-
-**Implementación**: Generar `@Email`, `@NotBlank`, `@Size` en entidades de dominio.
-
----
-
-### 6. Índices y constraints personalizados
-
-```yaml
-entities:
-  - name: Order
-    tableName: orders
-    indexes:
-      - name: idx_order_number
-        columns: [orderNumber]
-        unique: true
-      - name: idx_customer_date
-        columns: [customerId, createdAt]
-```
-
-**Implementación**: Agregar `@Table(indexes = {...})`.
-
----
-
-### 7. Métodos de negocio personalizados en YAML
-
-```yaml
-entities:
-  - name: Order
-    methods:
-      - name: applyDiscount
-        returnType: void
-        parameters:
-          - name: percentage
-            type: BigDecimal
-        body: |
-          BigDecimal discount = this.total.multiply(percentage).divide(new BigDecimal(100));
-          this.total = this.total.subtract(discount);
-```
-
-**Implementación**: Ya tienes infraestructura para value objects, extenderlo a entidades.
-
----
-
-### 8. Query methods en repositorios
-
-```yaml
-aggregates:
-  - name: Order
-    repositories:
-      customQueries:
-        - name: findByStatusAndCreatedAtAfter
-          returnType: List<Order>
-          parameters:
-            - name: status
-              type: OrderStatus
-            - name: date
-              type: LocalDateTime
-```
-
-**Implementación**: Generar métodos en interface de repositorio (Spring Data los implementa automáticamente).
-
----
-
-### 9. DTOs automáticos (Request/Response)
-
-```yaml
-aggregates:
-  - name: Order
-    dtos:
-      - name: CreateOrderRequest
-        fields: [customerId, items]
-      - name: OrderResponse
-        fields: [id, status, total, createdAt]
-```
-
-**Impacto**: Cubriría capa de aplicación completa.
-
----
-
-### 10. Eventos de dominio
-
-```yaml
-entities:
-  - name: Order
-    events:
-      - OrderCreated
-      - OrderCancelled
-```
-
-**Implementación**: Generar clases de eventos + lógica para publicar con Spring Events.