Saltar a contenido

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 Migraciones en subdirectorios numerados ejecutados por grupos aceptado
0002 Acceso a product_item_view vía query scopeada forProduct() aceptado
0003 Política de reintentos de jobs de salida (timeout, backoff, retry_after) aceptado
0004 Edición masiva: escritura con eventos suprimidos y propagación única por lote aceptado
0005 Precios de competencia: comando único, estados derivados y consumo directo de tablas aceptado

| 0007 | Categorías a Medusa: sync en cola, árbol por parent_category_id y estado en metadata | propuesto |

| 0006 | Factor de categoría menor a 1 = precio sugerido de venta; desactiva el margen mínimo | aceptado |