miinventario-v2/orchestration/analisis/PLAN-CORRECCION-DOCUMENTACION-2026-01-13.md

Plan de Corrección de Documentación - MiInventario

---

id: PLAN-CORR-DOC-20260113 type: Plan status: Draft version: "1.0.0" created_date: 2026-01-13 updated_date: 2026-01-13 simco_version: "4.0.0" analyst: "Claude Opus 4.5 (Arquitecto de Documentación)" depends_on: "ANALISIS-VALIDACION-DOCUMENTACION-2026-01-13.md"

1. Objetivo

Corregir todas las inconsistencias, referencias rotas y desincronizaciones detectadas en el análisis de documentación, para que la documentación refleje fielmente el estado real del proyecto (100% completado).

---

2. Decisiones Previas Requeridas

Antes de ejecutar las correcciones, se necesita confirmar:

#	Decisión	Opciones	Recomendación
D-001	Estado real del proyecto	A) 100% completado B) Parcial	A) 100% (basado en PROJECT-STATUS.md y trazas)
D-002	Puerto backend definitivo	A) 3142 B) 3150	A) 3142 (usado en PROJECT-STATUS)
D-003	Archivos 02-especificaciones/	A) Crear B) Eliminar referencias	B) Eliminar (la info está en inventarios)
D-004	Archivos 90-transversal/	A) Crear B) Eliminar referencias	A) Crear (son críticos para operaciones)

---

3. Plan de Correcciones por Fases

FASE A: CORRECCIONES CRÍTICAS (1-2 horas)

A.1 Sincronizar estados de épicas a "Completado"

Archivos a modificar (16):

docs/01-epicas/MII-001-infraestructura-base.md
docs/01-epicas/MII-002-autenticacion.md
docs/01-epicas/MII-003-gestion-tiendas.md
docs/01-epicas/MII-004-captura-video.md
docs/01-epicas/MII-005-procesamiento-ia.md
docs/01-epicas/MII-006-reportes-inventario.md
docs/01-epicas/MII-007-retroalimentacion.md
docs/01-epicas/MII-008-validacion-aleatoria.md
docs/01-epicas/MII-009-wallet-creditos.md
docs/01-epicas/MII-010-paquetes-recarga.md
docs/01-epicas/MII-011-pagos-tarjeta.md
docs/01-epicas/MII-012-pagos-oxxo.md
docs/01-epicas/MII-013-pagos-7eleven.md
docs/01-epicas/MII-014-referidos.md
docs/01-epicas/MII-015-admin-saas.md

Cambios por archivo:

1. Cambiar status: Pendiente → status: Completado
2. Actualizar updated_date: 2026-01-13
3. En cada tarea, cambiar Estado: Pendiente → Estado: Completado

A.2 Actualizar CONTEXT-MAP.yml

Archivo: orchestration/CONTEXT-MAP.yml

Cambios:

# ANTES
version: "0.1.0"
estado: planificacion

# DESPUÉS
version: "1.2.0"
estado: completado

También actualizar todas las épicas de estado: pendiente a estado: completado.

A.3 Actualizar MASTER_INVENTORY.yml

Archivo: orchestration/inventarios/MASTER_INVENTORY.yml

Cambios:

1. Actualizar version: "3.0.0"
2. Cambiar estado_general: "100% - Completado"
3. Marcar Fase 2 como completada (21/21 SP)
4. Marcar Fase 4 como completada (34/34 SP)
5. Actualizar contadores:
   • modulos_backend: 14
   • endpoints: 61
   • screens_mobile: 22
   • tablas: 21

A.4 Eliminar módulo videos de BACKEND_INVENTORY.yml

Archivo: orchestration/inventarios/BACKEND_INVENTORY.yml

Cambio: Eliminar la sección completa del módulo videos que no existe.

A.5 Corregir puerto backend

Archivos a modificar:

1. orchestration/CONTEXT-MAP.yml - Cambiar 3150 → 3142
2. orchestration/environment/ENVIRONMENT-INVENTORY.yml - Cambiar 3150 → 3142

---

FASE B: CORRECCIONES DE ALTA PRIORIDAD (2-3 horas)

B.1 Documentar módulos backend faltantes

Archivo: orchestration/inventarios/BACKEND_INVENTORY.yml

Agregar secciones para:

1. Módulo admin:

   • 6 servicios: dashboard, moderation, packages, promotions, providers, audit-log
   • 17 endpoints documentados
   • 3 entidades: AuditLog, Promotion, IaProvider

2. Módulo feedback:

   • 1 servicio: feedback.service.ts
   • 6 endpoints
   • 3 entidades: Correction, GroundTruth, ProductSubmission

3. Módulo validations:

   • 2 servicios: validations.service.ts, validation-engine.service.ts
   • 4 endpoints
   • 2 entidades: ValidationRequest, ValidationResponse

B.2 Actualizar DATABASE_INVENTORY.yml

Archivo: orchestration/inventarios/DATABASE_INVENTORY.yml

Agregar:

1. 8 entidades faltantes:

   • audit_logs
   • promotions
   • ia_providers
   • corrections
   • ground_truth
   • product_submissions
   • validation_requests
   • validation_responses

2. 2 migraciones faltantes:

   • 1736502000000-CreateFeedbackTables.ts
   • 1736600000000-CreateAdminTables.ts

3. 4 ENUMs faltantes:

   • corrections_type_enum
   • ground_truth_status_enum
   • product_submissions_status_enum
   • promotions_type_enum

4. Actualizar enum users_role_enum:

   • Agregar: VIEWER, MODERATOR, SUPER_ADMIN

5. Documentar campos de fraude en referrals:

   • fraudHold, fraudReason, reviewedBy, reviewedAt

B.3 Actualizar FRONTEND_INVENTORY.yml

Archivo: orchestration/inventarios/FRONTEND_INVENTORY.yml

Agregar:

1. Screens:

   • validation/items.tsx
   • validation/complete.tsx
   • validation/_layout.tsx

2. Stores:

   • validations.store.ts
   • feedback.store.ts

3. Services:

   • validations.service.ts
   • feedback.service.ts

4. Componentes:

   • validation/ValidationPromptModal.tsx
   • validation/ValidationItemCard.tsx
   • validation/ValidationProgressBar.tsx
   • feedback/ConfirmItemButton.tsx
   • feedback/CorrectionHistoryCard.tsx
   • feedback/CorrectSkuModal.tsx
   • feedback/CorrectQuantityModal.tsx

B.4 Crear documentos transversales críticos

Crear: docs/90-transversal/GUIA-DESPLIEGUE.md

Contenido mínimo:

• Requisitos previos
• Comandos Docker Compose
• Variables de entorno requeridas
• Verificación de despliegue
• Troubleshooting común

Crear: docs/90-transversal/SEGURIDAD.md

Contenido mínimo:

• Autenticación JWT + OTP
• Roles y permisos (RBAC)
• Row-Level Security
• Sanitización de inputs
• Secretos y variables de entorno

---

FASE C: CORRECCIONES DE MEDIA PRIORIDAD (3-4 horas)

C.1 Mover frontmatter antes del título H1

Archivos (20 total):

Patrón de cambio:

# ANTES:
# Título del Documento

---
id: XXX
type: Epic
...
---

# DESPUÉS:
---
id: XXX
type: Epic
...
---

# Título del Documento

docs/00-vision-general/ (4 archivos):

• VISION-PROYECTO.md
• REQUERIMIENTOS-FUNCIONALES.md
• ARQUITECTURA-TECNICA.md
• _MAP.md

docs/01-epicas/ (16 archivos):

• MII-001 a MII-015
• _MAP.md

C.2 Eliminar referencias rotas

Actualizar docs/00-vision-general/_MAP.md:

• Eliminar referencia a REQUERIMIENTOS-ORIGINALES.md

Actualizar docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md:

• Eliminar referencia a REQUERIMIENTOS-ORIGINALES.md

Actualizar docs/02-especificaciones/_MAP.md:

• Cambiar estado de archivos de "Pendiente" a "No Planificado" o eliminar entradas

Actualizar docs/README.md:

• Eliminar referencias a archivos inexistentes

C.3 Corregir nomenclatura de archivos

Opción A: Renombrar INT-002-oxxo.md → INT-002-oxxo-voucher.md Opción B: Actualizar referencias en docs/_MAP.md de INT-002-oxxo-voucher.md → INT-002-oxxo.md

Recomendación: Opción B (menos cambios)

C.4 Actualizar PLAN-IMPLEMENTACION.md

Archivo: orchestration/PLAN-IMPLEMENTACION.md

Cambios:

• Marcar checkboxes de criterios de éxito como completados [x]
• Actualizar fecha de última modificación

---

FASE D: CORRECCIONES DE BAJA PRIORIDAD (1 hora)

D.1 Documentar Guards y Decorators

Archivo: orchestration/inventarios/BACKEND_INVENTORY.yml

Agregar:

guards:
  - nombre: RolesGuard
    ruta: src/common/guards/roles.guard.ts
    estado: implementado

decorators:
  - nombre: Roles
    ruta: src/common/decorators/roles.decorator.ts
    estado: implementado

D.2 Agregar referencias a integraciones

Archivos a actualizar:

• MII-002-autenticacion.md - Agregar ref a INT-004-firebase-fcm.md
• MII-009-wallet-creditos.md - Agregar ref a INT-004-firebase-fcm.md

D.3 Actualizar información técnica

INT-001-stripe.md:

• Verificar y actualizar apiVersion si hay versión más reciente

INT-006-ia-provider.md:

• Actualizar nombre de modelo OpenAI Vision (gpt-4-vision-preview → gpt-4o)

---

4. Orden de Ejecución

┌─────────────────────────────────────────────────────────────────┐
│                    ORDEN DE EJECUCIÓN                            │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  FASE A: CRÍTICA (1-2h)                                         │
│  ├── A.1: Sincronizar estados épicas (16 archivos)              │
│  ├── A.2: Actualizar CONTEXT-MAP.yml                            │
│  ├── A.3: Actualizar MASTER_INVENTORY.yml                       │
│  ├── A.4: Eliminar módulo videos                                │
│  └── A.5: Corregir puerto backend                               │
│           │                                                      │
│           ▼                                                      │
│  FASE B: ALTA (2-3h) [puede ejecutarse en paralelo]             │
│  ├── B.1: Documentar módulos backend ────┐                      │
│  ├── B.2: Actualizar DATABASE_INVENTORY  ├──► En paralelo       │
│  ├── B.3: Actualizar FRONTEND_INVENTORY ─┘                      │
│  └── B.4: Crear docs transversales                              │
│           │                                                      │
│           ▼                                                      │
│  FASE C: MEDIA (3-4h)                                           │
│  ├── C.1: Mover frontmatter (20 archivos)                       │
│  ├── C.2: Eliminar referencias rotas                            │
│  ├── C.3: Corregir nomenclatura                                 │
│  └── C.4: Actualizar PLAN-IMPLEMENTACION                        │
│           │                                                      │
│           ▼                                                      │
│  FASE D: BAJA (1h)                                              │
│  ├── D.1: Documentar Guards/Decorators                          │
│  ├── D.2: Agregar referencias integraciones                     │
│  └── D.3: Actualizar info técnica                               │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

---

5. Validación Post-Ejecución

Después de ejecutar todas las correcciones, validar:

#	Verificación	Comando/Acción
V-001	Todos los estados de épicas = "Completado"	grep -r "status: Pendiente" docs/01-epicas/ → debe retornar vacío
V-002	CONTEXT-MAP.yml version = 1.2.0	grep "version:" orchestration/CONTEXT-MAP.yml
V-003	Puerto backend consistente	grep -r "3150" orchestration/ → debe retornar vacío
V-004	Sin módulo videos en inventory	grep "videos" orchestration/inventarios/BACKEND_INVENTORY.yml → debe retornar vacío
V-005	14 módulos en backend inventory	Contar módulos en BACKEND_INVENTORY.yml
V-006	21 entidades en database inventory	Contar entidades en DATABASE_INVENTORY.yml
V-007	Frontmatter antes de título	Verificar primeras líneas de cada .md comienzan con ---
V-008	Sin referencias rotas	grep -r "REQUERIMIENTOS-ORIGINALES" docs/ → debe retornar vacío

---

6. Resumen de Esfuerzo

Fase	Archivos	Tiempo	Paralelizable
A - Crítica	~7	1-2h	Parcialmente
B - Alta	~7 + 2 nuevos	2-3h	Sí
C - Media	~25	3-4h	Parcialmente
D - Baja	~6	1h	Sí
TOTAL	~47	7-10h	-

---

7. Riesgos del Plan

Riesgo	Probabilidad	Impacto	Mitigación
Cambios masivos rompen referencias	Media	Alto	Validar después de cada fase
Estado real no es 100% completado	Baja	Alto	Verificar código antes de asumir
Documentos transversales incompletos	Media	Medio	Crear versión mínima, iterar

---

Plan creado por: Claude Opus 4.5 Fecha: 2026-01-13 Versión del plan: 1.0.0 Requiere aprobación antes de ejecución