template-saas/orchestration/_archive/analisis/MAPA-CONFLICTOS-NOMENCLATURA.md
Adrian Flores Cortes 1c847fbe04
Some checks are pending
CI / Backend CI (push) Waiting to run
CI / Frontend CI (push) Waiting to run
CI / Security Scan (push) Waiting to run
CI / CI Summary (push) Blocked by required conditions
[ESTANDAR-ORCHESTRATION] refactor: Consolidate to standard structure
- Rename _archivo to _archive (standard convention)
- Move analisis/, planes/ to _archive/
- Archive extra root files
- Update _MAP.md with standardized structure

Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
Level: PROVIDER (L1A)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 14:38:23 -06:00

155 lines
4.2 KiB
Markdown

# 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