rckrdmrd
2c916e75e5
Nuevas Épicas (MCH-029 a MCH-033): - Infraestructura SaaS multi-tenant - Auth Social (OAuth2) - Auditoría Empresarial - Feature Flags - Onboarding Wizard Nuevas Integraciones (INT-010 a INT-014): - Email Providers (SendGrid, Mailgun, SES) - Storage Cloud (S3, GCS, Azure) - OAuth Social - Redis Cache - Webhooks Outbound Nuevos ADRs (0004 a 0011): - Notifications Realtime - Feature Flags Strategy - Storage Abstraction - Webhook Retry Strategy - Audit Log Retention - Rate Limiting - OAuth Social Implementation - Email Multi-provider Actualizados: - MASTER_INVENTORY.yml - CONTEXT-MAP.yml - HERENCIA-SIMCO.md - Mapas de documentación Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
131 lines
4.2 KiB
Markdown
131 lines
4.2 KiB
Markdown
# _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)
|