ADR catalog

Index of Accepted architecture decisions.

Source: docs/adr/README.md

Architecture Decision Records

Convención: ADR-NNN-slug.md. Estados: Proposed · Accepted · Deprecated · Superseded. Accepted solo tras ratificación humana.

Baseline vigente

  • ADR-009…018: AI-SDLC, límites modulares, UI, contratos, tests, eventos, secretos, Makefile y GitHub Flow.
  • ADR-019…028: NestJS, pnpm, PostgreSQL, Next.js, sin app nativa, patrones backend/frontend, Prisma, Docker y Turborepo.
  • ADR-032: REST + OpenAPI.
  • ADR-033: Security baseline by design.

Estos ADR siguen Accepted. Su interpretación para el ERP se amplía con ADR-034…040 Accepted; no se han revocado decisiones anteriores de stack.

Decisiones Accepted para LogicCore Platform

IDTemaEstado
ADR-034Identidad, Google OIDC, RBAC, membershipsAccepted
ADR-035Aislamiento por organización clienteAccepted
ADR-036Invoices, pagos, conciliación, cumplimientoAccepted
ADR-037Telemetría, auditoría, alertasAccepted
ADR-038Layout FoodHUB-inspired y experiencia multi-superficieAccepted
ADR-039Help Center y Developer DocsAccepted
ADR-040Observabilidad local Loki/Prometheus/GrafanaAccepted
ADR-041Cloudflare Turnstile en formularios públicosAccepted
ADR-042Support Agent: RAG Help + tools RO + OpenAIAccepted
ADR-043QuickStart, tours data-tour y progreso persistidoAccepted
ADR-044A-lite en VPS compartido MercoraHub (subdominios + Grafana edge)Accepted

Cambios de contexto en ADRs existentes

ADR-022/023/024/025/028/032 contienen decisiones tomadas para el sitio y API de leads. Se conservan las elecciones técnicas, pero se deben interpretar junto con DOC-001 v2.0, DOC-017 y las decisiones 034…039. Las enmiendas de alcance del PR #2 fueron ratificadas el 2026-11-12 junto con la nueva visión (evidencia); las elecciones técnicas Accepted se mantienen.

Pendientes

Matriz detallada de permisos y alcance por organización; jurisdicción fiscal y pasarela; CMS, hosting y notificaciones de producción; instrumentación OTel de producto (el stack local ya está en ADR-040). No implementar módulos de dominio sin briefs aprobados.