# _MAP: Architecture Decision Records (ADRs)

**Carpeta:** docs/97-adr/
**Proposito:** Documentar decisiones arquitectonicas importantes del proyecto
**Estado:** Actualizado
**Ultima actualizacion:** 2026-01-10

---

## Resumen

| Metrica | Valor |
|---------|-------|
| Total ADRs | 11 |
| Aceptados | 11 |
| Propuestos | 0 |
| Deprecated | 0 |

---

## Contenido

### ADRs Activos

| ID | Titulo | Estado | Fecha | Impacto |
|----|--------|--------|-------|---------|
| [ADR-0001](./ADR-0001-multi-tenant-architecture.md) | Arquitectura Multi-Tenant | Accepted | 2026-01-06 | Alto |
| [ADR-0002](./ADR-0002-whatsapp-first-approach.md) | WhatsApp como Canal Principal | Accepted | 2026-01-06 | Alto |
| [ADR-0003](./ADR-0003-llm-agnostic-strategy.md) | Estrategia LLM Agnostica | Accepted | 2026-01-06 | Medio |
| [ADR-0004](./ADR-0004-notifications-realtime.md) | Notificaciones en Tiempo Real | Accepted | 2026-01-10 | Medio |
| [ADR-0005](./ADR-0005-feature-flags.md) | Feature Flags por Plan | Accepted | 2026-01-10 | Alto |
| [ADR-0006](./ADR-0006-storage-abstraction.md) | Storage Abstraction | Accepted | 2026-01-10 | Alto |
| [ADR-0007](./ADR-0007-webhook-retry-strategy.md) | Webhook Retry Strategy | Accepted | 2026-01-10 | Medio |
| [ADR-0008](./ADR-0008-audit-log-retention.md) | Audit Log Retention | Accepted | 2026-01-10 | Medio |
| [ADR-0009](./ADR-0009-rate-limiting.md) | Rate Limiting Strategy | Accepted | 2026-01-10 | Alto |
| [ADR-0010](./ADR-0010-oauth-social.md) | OAuth Social Strategy | Accepted | 2026-01-10 | Medio |
| [ADR-0011](./ADR-0011-email-multi-provider.md) | Email Multi-Provider | Accepted | 2026-01-10 | Medio |

---

## Navegacion por Dominio

### Arquitectura
- [ADR-0001 - Multi-Tenant](./ADR-0001-multi-tenant-architecture.md)
- [ADR-0006 - Storage Abstraction](./ADR-0006-storage-abstraction.md)
- [ADR-0009 - Rate Limiting](./ADR-0009-rate-limiting.md)

### Producto
- [ADR-0002 - WhatsApp First](./ADR-0002-whatsapp-first-approach.md)
- [ADR-0005 - Feature Flags](./ADR-0005-feature-flags.md)

### Tecnologia
- [ADR-0003 - LLM Agnostico](./ADR-0003-llm-agnostic-strategy.md)
- [ADR-0011 - Email Multi-Provider](./ADR-0011-email-multi-provider.md)

### Infraestructura
- [ADR-0004 - Notificaciones Realtime](./ADR-0004-notifications-realtime.md)
- [ADR-0007 - Webhook Retry Strategy](./ADR-0007-webhook-retry-strategy.md)

### Seguridad y Compliance
- [ADR-0008 - Audit Log Retention](./ADR-0008-audit-log-retention.md)
- [ADR-0010 - OAuth Social](./ADR-0010-oauth-social.md)

---

## Formato de ADR

Cada ADR sigue la estructura de @SIMCO-ESTRUCTURA-DOCS:

```markdown
# ADR-{NNNN}: {Titulo}

## Metadata
- ID, Estado, Fecha, Supersede (si aplica)

## Contexto
{Problema que requiere decision}

## Decision
{La decision tomada}

## Alternativas Consideradas
{Opciones evaluadas con pros/cons}

## Consecuencias
{Positivas, negativas, neutrales}

## Referencias
{Links relacionados}
```

---

## Proceso de ADR

```
┌─────────────┐     ┌───────────────┐     ┌──────────────┐
│  Propuesto  │ --> │  En Revision  │ --> │   Aceptado   │
└─────────────┘     └───────────────┘     └──────────────┘
                                                │
                                                v
                                          ┌──────────────┐
                                          │  Deprecated  │
                                          │ (superseded) │
                                          └──────────────┘
```

---

## Cuando Crear un ADR

Crear un ADR cuando:

1. **Decision arquitectonica significativa** - Afecta multiples componentes
2. **Eleccion entre alternativas** - Hay opciones razonables a considerar
3. **Dificil de revertir** - El costo de cambiar es alto
4. **Requiere documentacion** - Otros deben entender el "por que"

---

## Referencias

- [SIMCO-ESTRUCTURA-DOCS.md](../../../../orchestration/directivas/simco/SIMCO-ESTRUCTURA-DOCS.md)
- [Template ADR](https://adr.github.io/)

---

**Mantenido por:** Architecture Team
**Version:** 2.0.0
**Total ADRs:** 11 (ADR-0001 a ADR-0011)