Registro de decisiones (ADR)

Un ADR registra una decisión técnica vigente y su contexto, para que no se re-discuta sin conocer por qué se tomó. Formato: MADR simplificado — usar 0000-plantilla.md.

Reglas

• Numeración: secuencial de 4 dígitos (0001-, 0002-, ...). No se reusan números.
• Un ADR no se edita para cambiar la decisión: se escribe uno nuevo que lo reemplaza y el viejo pasa a estado reemplazado por ADR-NNNN.
• ADRs retroactivos: solo decisiones que siguen costando dinero re-discutir. Límite estricto: 3 por repositorio. Esto no es arqueología histórica.
• ADRs nuevos: toda decisión de arquitectura tomada a partir de ahora se registra en el momento, dentro del mismo PR que la implementa.

Índice

ADR	Título	Estado
0001	Payload CMS como fuente del contenido editorial	aceptado
0002	Algolia e InstantSearch como motor de búsqueda	aceptado
0003	La imagen de producción se construye con npm	reemplazado por 0004 y 0005
0004	npm como gestor único y política de actualización de dependencias	aceptado
0005	La imagen de producción usa el output standalone de Next	aceptado
0006	Next 16, React 19 estable y updateTag para invalidar caché	aceptado
0007	CSP con nonce y cabeceras de seguridad en el storefront; el modo (reporte o bloqueante) se elige con CSP_ENFORCE	aceptado
0008	Vista previa de borradores del lado del servidor, no del cliente	aceptado
0009	Las tarjetas de producto no precargan la ficha	aceptado

Los 0001 a 0003 son retroactivos: reconstruyen decisiones ya implementadas a partir del código y del historial de git, y ninguno tiene fecha de decisión registrada — se indica el commit donde aparece la implementación. Con ellos se alcanzó el límite de 3 ADRs retroactivos del repositorio.

El 0004 es el primero registrado en el momento en que se tomó la decisión, con decisores y fecha. De acá en adelante todos van así, dentro del mismo PR que implementa la decisión.

El 0006 nació como 0004 en la rama mvaliente-desa y se renumeró al integrarse con develop, que ya tenía un 0004 y un 0005 distintos.