template-saas/orchestration/analisis/MAPA-CONFLICTOS-NOMENCLATURA.md
rckrdmrd 50a821a415
Some checks failed
CI / Backend CI (push) Has been cancelled
CI / Frontend CI (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / CI Summary (push) Has been cancelled
[SIMCO-V38] feat: Actualizar a SIMCO v3.8.0
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8
- Actualizaciones de configuracion

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 08:53:08 -06:00

4.2 KiB

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