ADRs · Architecture Decision Records¶
Estado del documento
Versión: 1.0 · 15-may-2026 Estado: ✅ sección completa Audiencia: Equipo de desarrollo
Qué es esto¶
Registro de las decisiones arquitectónicas del proyecto. Cada ADR documenta una decisión técnica relevante con su contexto, las alternativas consideradas y las consecuencias asumidas.
Las decisiones se numeran de forma estable (D1, D2, …) y se referencian desde el resto de la documentación. La numeración se mantiene aunque alguna decisión sea reemplazada o supersedida — el número no se reutiliza.
Índice¶
| # | Decisión | Estado |
|---|---|---|
| D1 | Plan Grow de Shopify | ✅ aceptada |
| D2 | B2B nativo (Companies/Catalogs/Price Lists) | ✅ aceptada |
| D3 | Shopify Flow + Supabase Edge Functions | ✅ aceptada |
| D4 | Gate híbrido (Liquid + Locksmith) | ✅ aceptada |
| D5 | New customer accounts | ✅ aceptada (impuesta) |
| D6 | Catálogo único multi-ready | ✅ aceptada |
| D7 | Página backoffice con tag backoffice |
✅ aceptada |
| D8 | Columna Predeterminado: importar sin exponer |
⚠️ provisional |
| D9 | Modelo de metafields ampliado | ✅ aceptada |
| D10 | 3 CSVs SFTP separados (importer) | ✅ aceptada |
| D11 | Pre-upload de imágenes a Shopify Files | ✅ aceptada |
| D12 | Pipeline split sftp-sync (Edge) → GHA | ✅ aceptada |
| D13 | Multidivisa con auto-rates de Shopify Markets | ✅ aceptada |
| D14 | Fingerprint cache en private.sku_state |
⚠️ parcial |
| D15 | Reconciliación del image_cache · feed como fuente de verdad de imágenes | ✅ aceptada |
Leyenda: ✅ completo · ⚠️ parcial / provisional · 🚧 esqueleto · ❌ obsoleta · ♻️ superseded por otra.
Convenciones¶
- Numeración estable: si una decisión se revierte o reemplaza, el ADR original se marca como
supersededy se crea uno nuevo con número siguiente. - Estado: se actualiza en el documento del ADR y en esta tabla a la vez.
- Plantilla: Estado · Contexto · Decisión · Alternativas consideradas · Consecuencias.