codigo0/docs/DECISIONES_TECNICAS_CONSOLIDADAS.md

📋 Decisiones Técnicas Consolidadas

Fecha: 2025-01-25
Versión: 1.0

---

✅ DECISIONES TOMADAS

1. Value Objects (Híbrido) ✅

• Decisión: Tipos simples en entidades, Value Objects en servicios
• Implementación:
  • Entidades usan ContentStatusType, ContentPriorityType (strings)
  • Value Objects (ContentStatus, ContentPriority) en Application Services
  • Domain Layer mantiene entidades como POJOs

2. Serialización (Mappers) ✅

• Decisión: Mappers separados en Infrastructure Layer
• Implementación:
  • infrastructure/mappers/ContentItemMapper.ts
  • Métodos toDomain() y toPersistence()
  • Domain Layer NO tiene métodos de serialización

3. IDs (Application Layer) ✅

• Decisión: UUIDs generados en Application Layer
• Implementación:
  • Generar con randomUUID() en Use Cases
  • Pasar como parámetro a create() de entidades
  • Permite inyección en tests

4. Validación (Híbrido) ✅

• Decisión: Validaciones básicas en Domain, complejas en Application
• Implementación:
  • Validaciones de formato en create() de entidades
  • Validaciones de negocio (unicidad, dependencias) en Services
  • Zod en Application Layer para esquemas

5. Fechas (ISO 8601 Strings) ✅

• Decisión: Strings ISO 8601 en entidades
• Implementación:
  • readonly createdAt: string (formato: "2025-01-25T10:00:00Z")
  • Mappers convierten strings ↔ PostgreSQL TIMESTAMPTZ
  • NO usar Date nativo

6. Arrays (readonly T[]) ✅

• Decisión: readonly string[] para arrays inmutables
• Implementación:
  • readonly tags: readonly string[]
  • NO usar ReadonlyArray<T>

7. Opcionales (Híbrido) ✅

• Decisión: ? para opcionales, | null cuando null tiene significado
• Implementación:
  • readonly description?: string (no proporcionado)
  • readonly validatedAt: string | null (explícitamente null)

8. Errores (Personalizados) ✅

• Decisión: Errores personalizados (DomainError, ValidationError)
• Implementación:
  • shared/errors/DomainError.ts
  • Errores con código y contexto
  • NO usar errores genéricos

9. Versionado (Números Enteros) ✅

• Decisión: Números enteros incrementales
• Implementación:
  • readonly version: number
  • readonly latestVersion: number
  • NO usar semantic versioning

10. JSONB (Union Types) ✅

• Decisión: Union types para campo content
• Implementación:
  • content: ProtocolContent | GuideContent | ManualContent
  • Type safety completo
  • NO usar Record<string, unknown>

---

📐 IMPACTO EN ARQUITECTURA

Domain Layer

• Entidades con tipos simples
• Value Objects como clases separadas
• Métodos create() con validaciones básicas
• IDs recibidos como parámetro

Application Layer

• Generación de UUIDs
• Validaciones complejas con repositorios
• Uso de Value Objects para lógica
• Zod para validación de esquemas

Infrastructure Layer

• Mappers para conversión Domain ↔ Persistence
• Conversión de fechas (string ↔ TIMESTAMPTZ)
• Conversión de nombres (camelCase ↔ snake_case)

---

🔄 FLUJO COMPLETO

Crear Contenido

1. Presentation Layer: Recibe request, valida con Zod
2. Application Layer:
   • Genera UUID
   • Valida unicidad (repository)
   • Crea entidad con ContentItem.create(id, ...)
3. Domain Layer:
   • Valida formato básico
   • Retorna entidad inmutable
4. Application Layer:
   • Guarda con repository
5. Infrastructure Layer:
   • Mapper convierte a formato BD
   • Persiste en PostgreSQL

---

Fin del documento