# Mapa de Conflictos de Nomenclatura

**Fecha:** 2026-01-10
**Fase:** 3.2 - Analisis de Conflictos de Nomenclatura
**Estado:** COMPLETADO

---

## Resumen Ejecutivo

| Tipo de Conflicto | Cantidad | Severidad |
|-------------------|----------|-----------|
| Numeracion de modulos | 8 | CRITICA |
| Rutas obsoletas | 2 | ALTA |
| Nombres de campos | 3 | MEDIA |
| Estructura propuesta vs real | 1 | MEDIA |

---

## Conflictos de Numeracion de Modulos

### Fuentes en Conflicto

| Modulo | _MAP.md | CONTEXT-MAP.yml | docs/01-modulos/ (REAL) |
|--------|---------|-----------------|-------------------------|
| SAAS-006 | Onboarding | Onboarding | **AI Integration** |
| SAAS-007 | Notifications | Notifications | Notifications |
| SAAS-008 | Feature Flags | Feature Flags | **Audit Logs** |
| SAAS-009 | Audit | Audit | **Feature Flags** |
| SAAS-010 | AI Integration | AI Integration | **Webhooks** |
| SAAS-011 | Portal User | Portal User | **Storage** |
| SAAS-012 | Portal Admin | Portal Admin | **CRUD Base** |
| SAAS-013 | - | - | **Email** |
| SAAS-014 | - | - | **WhatsApp** |

**Fuente de verdad:** `docs/01-modulos/` (archivos reales)

### Resolucion Requerida

1. Actualizar `_MAP.md` lineas 62-94
2. Actualizar `CONTEXT-MAP.yml` lineas 175-210
3. Agregar SAAS-013 y SAAS-014 a ambos archivos

---

## Conflictos de Rutas Obsoletas

### docs/97-adr/ (OBSOLETO)

| Archivo | Linea | Ruta Obsoleta | Ruta Correcta |
|---------|-------|---------------|---------------|
| CONTEXTO-PROYECTO.md | 153 | `docs/97-adr/` | `docs/architecture/adr/` |
| GUIA-ORQUESTACION-SUBAGENTES.md | 197 | `docs/97-adr/` | `docs/architecture/adr/` |

### orchestration/planes/ (OBSOLETO)

| Archivo | Referencias | Estado Real |
|---------|-------------|-------------|
| PLAN-SPRINT-1-TESTS.md | 5 enlaces | Movido a `_archivo/` |
| PLAN-SPRINT-2-ONBOARDING.md | 5 enlaces | Movido a `_archivo/` |
| PLAN-SPRINT-3-E2E.md | 5 enlaces | Movido a `_archivo/` |
| PLAN-SPRINT-4-DOCS.md | 5 enlaces | Movido a `_archivo/` |
| PLAN-SPRINT-5-WHATSAPP.md | 6 enlaces | Movido a `_archivo/` |

---

## Conflictos de Nombres de Campos

### WhatsApp: waba_id vs business_account_id

| Ubicacion | Nombre Usado |
|-----------|--------------|
| SAAS-014-whatsapp.md | `waba_id` |
| DDL whatsapp-configs.sql | `business_account_id` |
| Entity whatsapp-config.entity.ts | `business_account_id` |

**Resolucion:** Actualizar documentacion a `business_account_id`

### Feature Flags: status vs is_enabled

| Ubicacion | Tipo |
|-----------|------|
| DDL 01-flags.sql | `status` ENUM ('disabled', 'enabled', 'percentage', 'user_list') |
| Entity feature-flag.entity.ts | `is_enabled` BOOLEAN |

**Resolucion:** Alinear entity con DDL usando ENUM

### Subscription Status (dos enums)

| Schema | Enum | Valores |
|--------|------|---------|
| tenants | subscription_status | trialing, active, past_due, cancelled, unpaid |
| billing | subscription_status | trial, active, past_due, cancelled, expired |

**Resolucion:** Ya documentado en SAAS-004 como intencionalmente diferente

---

## Conflicto de Estructura Propuesta vs Real

### Estructura de docs/01-modulos/

**Propuesto en _MAP.md:**
```
docs/01-modulos/SAAS-001-auth/
├── README.md
├── ESPECIFICACION.md
├── FLUJOS.md
├── IMPLEMENTACION.md
└── TESTS.md
```

**Real:**
```
docs/01-modulos/
├── SAAS-001-auth.md (archivo unico)
├── SAAS-002-tenants.md
└── ... (14 archivos planos)
```

**Resolucion:** Actualizar _MAP.md para reflejar estructura real (archivos planos)

---

## Plan de Resolucion

### Prioridad CRITICA
1. Actualizar numeracion en _MAP.md y CONTEXT-MAP.yml
2. Corregir rutas de ADRs en 2 archivos

### Prioridad ALTA
1. Corregir enlaces a _archivo/ (5 archivos fuente)
2. Actualizar waba_id -> business_account_id en docs

### Prioridad MEDIA
1. Actualizar estructura propuesta en _MAP.md
2. Documentar diferencia de subscription_status enums

---

## Matriz de Impacto

| Conflicto | Archivos Afectados | Esfuerzo |
|-----------|-------------------|----------|
| Numeracion modulos | 2 | 1 hora |
| Rutas ADR | 2 | 15 min |
| Enlaces _archivo | 2 | 30 min |
| Campo waba_id | 1 | 10 min |
| Estructura _MAP.md | 1 | 30 min |
| **TOTAL** | **8** | **~2.5 horas** |

---

**Entregable de:** FASE 3.2