ADR-024 — Monorepo organization

Architecture decision record — status: Accepted.

Source: docs/adr/ADR-024-monorepo.md

ADR-024: Monorepo organization

Estado

Accepted — 2026-08-23

Contexto

API Nest + web Next + packages compartidos + docs/specs. Un solo equipo y agentes IA. Misma estrategia que IVPrior, sin apps/mobile (ADR-005).

Decisión

Un monorepo pnpm + Turborepo (ADR-002).

Layout canónico: docs/architecture/DOC-015-monorepo-folder-structure.md.

apps/api          NestJS
apps/web          Next.js
packages/ui       design system
packages/api-contract   OpenAPI
packages/shared   tipos / zod / constants

Un PR puede tocar api + web + contrato.
No polyrepos. No publicar packages a npm en V1 (workspace interno).
infrastructure/ para compose y futuros manifiestos de deploy — vacío hasta scaffolding.

Alternativas

Polyrepo o Nx: se descartan para no divergir de la factory IVPrior (pnpm + Turbo).

Consecuencias

Scaffolding crea este árbol; no se inventan apps (help, docs, mobile) sin ADR.