miinventario-v2/orchestration/_archive/analisis/PLAN-ACTUALIZACION-DOCUMENTACION.md

Plan de Actualizacion de Documentacion - MiInventario

Fecha: 2026-01-10 Fase: Planeacion Estado: Aprobado para Ejecucion

---

1. OBJETIVO

Sincronizar toda la documentacion de inventarios y trazas con el estado real del codigo implementado, siguiendo los estandares SIMCO v4.0.0.

---

2. ARCHIVOS A ACTUALIZAR

2.1 Inventarios (Orden de Ejecucion)

#	Archivo	Prioridad	Dependencias
1	DATABASE_INVENTORY.yml	P0	Ninguna
2	BACKEND_INVENTORY.yml	P0	DATABASE
3	FRONTEND_INVENTORY.yml	P0	BACKEND
4	MASTER_INVENTORY.yml	P0	Todos

2.2 Trazas

#	Archivo	Prioridad
5	TRAZA-TAREAS-DATABASE.md	P1
6	TRAZA-TAREAS-BACKEND.md	P1
7	TRAZA-TAREAS-MOBILE.md	P1

2.3 Contexto

#	Archivo	Prioridad
8	CONTEXTO-PROYECTO.md	P1

---

3. DETALLE DE CAMBIOS POR ARCHIVO

3.1 DATABASE_INVENTORY.yml

Cambios Principales:

• Actualizar estado: implementado
• Cambiar modelo de schemas multiples a schema unico (public)
• Documentar 13 tablas con campos completos
• Documentar 10 ENUMs
• Documentar 17 indices
• Documentar 13 foreign keys
• Registrar migracion TypeORM

Tablas a Documentar:

1. users - Usuarios del sistema
2. stores - Tiendas
3. store_users - Relacion usuarios-tiendas
4. videos - Videos subidos
5. inventory_items - Items de inventario
6. credit_balances - Saldos de creditos
7. credit_packages - Paquetes de creditos
8. credit_transactions - Transacciones de creditos
9. payments - Pagos
10. referrals - Referidos
11. notifications - Notificaciones
12. otps - Codigos OTP
13. refresh_tokens - Tokens de refresco

---

3.2 BACKEND_INVENTORY.yml

Cambios Principales:

• Actualizar estado: implementado en todos los modulos
• Documentar 11 modulos con archivos
• Documentar 45+ endpoints
• Documentar 13 entidades
• Documentar 12+ DTOs
• Actualizar tests E2E: 53 pasando

Modulos a Documentar:

1. auth - 5 endpoints (register, verify-otp, login, refresh, logout)
2. users - 3 endpoints (me, update, fcm-token)
3. stores - 5 endpoints (create, list, get, update, delete)
4. inventory - 7 endpoints (list, stats, low-stock, categories, get, update, delete)
5. videos - 5 endpoints (initiate, confirm, status, result, list)
6. credits - 3 endpoints (balance, transactions, packages)
7. payments - 4 endpoints (create, list, get, webhook)
8. referrals - 5 endpoints (my-code, stats, list, validate, apply)
9. notifications - 5 endpoints (list, unread-count, mark-read, mark-all, register-token)
10. ia-provider - 0 endpoints (servicio interno)
11. health - 2 endpoints (health, ready)

---

3.3 FRONTEND_INVENTORY.yml

Cambios Principales:

• Actualizar estado: implementado en todas las screens
• Documentar 23 screens con rutas expo-router
• Documentar 7 stores Zustand
• Documentar 9 servicios API
• Documentar estructura de navegacion

Screens por Grupo:

• Auth (3): login, register, verify-otp
• Tabs (4): index/home, scan, inventory, profile
• Credits (2): buy, history
• Stores (3): index, new, [id]
• Inventory (1): [id]
• Notifications (1): index
• Referrals (1): index
• Profile (1): edit
• Payments (1): methods
• Help (1): index
• Support (1): index
• Legal (2): terms, privacy

Stores:

1. useAuthStore - Autenticacion
2. useCreditsStore - Creditos
3. useInventoryStore - Inventario
4. useNotificationsStore - Notificaciones
5. usePaymentsStore - Pagos
6. useReferralsStore - Referidos
7. useStoresStore - Tiendas

---

3.4 MASTER_INVENTORY.yml

Cambios Principales:

• Actualizar version: 2.0.0
• Actualizar estado: desarrollo-activo
• Actualizar progreso de fases:
  • Fase 1 MVP Core: 100%
  • Fase 3 Monetizacion: 100%
• Actualizar resumen de epicas
• Actualizar metricas de codigo
• Actualizar integraciones activas

---

3.5 TRAZA-TAREAS-*.md

Cambios Comunes:

• Actualizar estado de todas las tareas a "completado"
• Agregar fecha de completado
• Documentar archivos creados
• Actualizar estadisticas

---

3.6 CONTEXTO-PROYECTO.md

Cambios Principales:

• Actualizar estado: En Desarrollo Activo
• Actualizar version: 1.0.0
• Actualizar puertos (3142 en lugar de 3150)
• Actualizar estado de implementacion
• Actualizar integraciones

---

4. VALIDACIONES POST-ACTUALIZACION

4.1 Consistencia de Datos

• Tablas en DATABASE_INVENTORY coinciden con migracion
• Modulos en BACKEND_INVENTORY coinciden con /modules
• Screens en FRONTEND_INVENTORY coinciden con /app
• Endpoints documentados coinciden con controllers
• Totales en MASTER coinciden con inventarios detallados

4.2 Validaciones de Codigo

• Backend build: npm run build
• Mobile TypeScript: npx tsc --noEmit
• Tests E2E: npm run test:e2e

4.3 Estructura de Archivos

• Todos los archivos YAML validos
• Todos los archivos Markdown bien formateados
• Referencias cruzadas correctas

---

5. RIESGOS Y MITIGACIONES

Riesgo	Impacto	Mitigacion
Inconsistencia entre docs	Alto	Validacion cruzada automatica
Campos faltantes en entidades	Medio	Verificar contra migracion
Rutas de screens incorrectas	Bajo	Verificar con ls app/

---

6. CRONOGRAMA DE EJECUCION

Paso	Actividad	Duracion Estimada
1	Actualizar DATABASE_INVENTORY	10 min
2	Actualizar BACKEND_INVENTORY	15 min
3	Actualizar FRONTEND_INVENTORY	15 min
4	Actualizar MASTER_INVENTORY	10 min
5	Actualizar Trazas (3 archivos)	10 min
6	Actualizar CONTEXTO-PROYECTO	5 min
7	Validaciones finales	10 min
TOTAL		~75 min

---

7. CRITERIOS DE EXITO

1. Todos los inventarios reflejan estado real del codigo
2. Todas las trazas muestran tareas completadas
3. Build de backend exitoso
4. TypeScript de mobile sin errores
5. Tests E2E pasando (53 tests)
6. Documentacion consistente entre archivos

---

Plan Creado: 2026-01-10 Estado: Listo para Ejecucion Aprobado por: Agente Orquestador