Visión general de la arquitectura

Plantilla de ejemplo. Sustituye este contenido por la arquitectura real de tus sistemas.

Esta sección describe, a alto nivel, cómo encajan las piezas de nuestros sistemas y las decisiones de diseño relevantes.

Diagrama de componentes

Puedes incluir diagramas con Mermaid, que Nextra renderiza de forma nativa:

Decisiones de arquitectura (ADR)

Documentar las decisiones importantes evita repetir discusiones. Un formato simple:

Campo	Contenido
Contexto	¿Qué problema o restricción motivó la decisión?
Decisión	¿Qué se decidió hacer?
Estado	Propuesta · Aceptada · Sustituida
Consecuencias	¿Qué ganamos y qué cedemos con esta decisión?

Una buena práctica es guardar cada ADR como una página independiente dentro de esta sección (content/arquitectura/adr-001-xxx.mdx) y registrarla en el _meta.ts de la carpeta.

Convenciones de esta sección

Mantén los diagramas como código (Mermaid) siempre que puedas: versionan mejor que las imágenes.
Cada sistema relevante debería tener, como mínimo: propósito, dependencias y punto de contacto/owner.