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 |