Skip to content
Documentación Jean d'Arc
GitHub

Decisiones Arquitectónicas (ADRs)

Propósito

Section titled “Propósito”

Los Architecture Decision Records (ADRs) documentan decisiones técnicas significativas del ecosistema Nostromo, incluyendo:

  • Contexto: Por qué se necesitaba una decisión
  • Decisión: Qué se decidió hacer
  • Consecuencias: Trade-offs positivos y negativos
  • Alternativas: Opciones consideradas y rechazadas

Índice de ADRs

Section titled “Índice de ADRs”

Estado: En construcción. Los ADRs documentan decisiones clave del pasado y futuras.

Pendientes (Alta Prioridad)

Section titled “Pendientes (Alta Prioridad)”
  • ADR-001: Multi-Tenant Strategy - Por qué schema-per-tenant vs database-per-tenant
  • ADR-002: Pool Management - Pool central vs per-tenant pools
  • ADR-003: ETL Architecture - Python ETL vs Node.js
  • ADR-004: Frontend Framework - Astro + SolidJS vs React/Vue
  • ADR-005: Auth Strategy - JWT + HTTP-only cookies vs sessions

Pendientes (Media Prioridad)

Section titled “Pendientes (Media Prioridad)”
  • ADR-006: Database Choice - PostgreSQL vs MySQL/MongoDB
  • ADR-007: FDW for Multi-Tenancy - Foreign Data Wrappers justificación
  • ADR-008: Monorepo vs Polyrepo - Estructura de repositorios

Proceso de Creación

Section titled “Proceso de Creación”
  1. Identificar decisión significativa: Arquitectura, tecnología, patrón de diseño
  2. Copiar template: Usar template.mdx
  3. Completar secciones: Contexto, decisión, consecuencias, alternativas
  4. Numerar secuencialmente: ADR-XXX (próximo número disponible)
  5. Actualizar este índice: Agregar a lista correspondiente
  6. Commit: Incluir ADR en PR de implementación o como standalone

Referencias

Section titled “Referencias”