Arquitectura

Esta sección describe el estado actual del sistema: qué proyecto vive dónde, cómo se conectan, en qué orden se construye y qué módulos lo componen.

El porqué de cada decisión arquitectónica vive en Decisiones técnicas — los ADR describen cómo llegamos hasta acá; esta sección describe dónde estamos parados.

Qué hay en esta sección

Página	Qué cubre
Roadmap de desarrollo	Orden y criterios para construir el sistema, módulo por módulo. Incluye principios rectores, dependencias, estado actual y decisiones abiertas.
Catálogo de módulos	Índice rápido de cada módulo con propósito, roles, dependencias y link al doc de dominio. Útil para no scrollear el roadmap entero.
Entornos	Cómo coexisten los tres ambientes — local, preview y producción— sobre una sola base Supabase con dos schemas. Variables, deploy, rollback, qué pasa cuando algo falla.

Qué NO va acá

El dominio del negocio (reglas de producción, ventas, clientes, envases) vive en Dominio. Esta sección solo apunta a esos documentos — no los copia.
Las decisiones técnicas con alternativas evaluadas (por qué Supabase y no Firebase, por qué Postgres y no Mongo, etc.) viven en Decisiones técnicas como ADR numerados. El roadmap enumera qué se decide, no cómo se decide.
El cómo se ve cada pantalla vive en /claude-design/ como referencia visual — los mockups no son código de producción y no se versionan en este sitio de docs.