michangarrito/backups/orchestration-backup-2026-01-10/orchestration/analisis/PLAN-REFINADO-SPRINT1-2026-01-10.md

Plan Refinado - Sprint 1: Documentacion Base

Fecha: 2026-01-10 Version: 2.0.0 Estado: REFINADO Y LISTO PARA EJECUCION

---

1. CAMBIO DE ESTRATEGIA

Situacion Original

Se planeaba CREAR 4 archivos de inventario nuevos.

Situacion Real

Los 5 archivos YA EXISTEN pero estan DESACTUALIZADOS.

Nueva Estrategia

ACTUALIZAR los 5 archivos existentes con la informacion correcta del analisis.

---

2. ARCHIVOS A ACTUALIZAR

#	Archivo	Ubicacion	Accion
1	DATABASE_INVENTORY.yml	orchestration/inventarios/	ACTUALIZAR
2	BACKEND_INVENTORY.yml	orchestration/inventarios/	ACTUALIZAR
3	FRONTEND_INVENTORY.yml	orchestration/inventarios/	ACTUALIZAR
4	MASTER_INVENTORY.yml	orchestration/inventarios/	ACTUALIZAR
5	_MAP.md	docs/	ACTUALIZAR

---

3. ORDEN DE EJECUCION

1. DATABASE_INVENTORY.yml   [Base de datos]
        |
        v
2. BACKEND_INVENTORY.yml    [API/Servicios]
        |
        v
3. FRONTEND_INVENTORY.yml   [UI/Paginas]
        |
        v
4. MASTER_INVENTORY.yml     [Consolidacion]
        |
        v
5. docs/_MAP.md             [Navegacion]

---

4. ESPECIFICACIONES POR ARCHIVO

4.1 DATABASE_INVENTORY.yml

Correcciones principales:

• Cambiar total_schemas de 10 a 9
• Cambiar total_tablas de 29 a 27
• Agregar extensiones unaccent y pg_trgm
• Corregir nombres de tablas:
  • tenant_settings → tenant_configs
  • roles, permissions → eliminar (no existen)
  • otp_codes → agregar
  • product_variants → eliminar
  • stock_movements → inventory_movements
  • inventory_counts → stock_alerts
  • credit_accounts, credit_transactions → fiados, fiado_payments
  • tenant_integrations → tenant_integration_credentials
  • integration_logs → tenant_whatsapp_numbers

Estructura final de schemas:

public: tenants, tenant_configs, tenant_integration_credentials, tenant_whatsapp_numbers
auth: users, sessions, otp_codes
catalog: categories, products, product_templates
sales: sales, sale_items, payments, daily_closures
inventory: inventory_movements, stock_alerts
customers: customers, fiados, fiado_payments
orders: orders, order_items
subscriptions: plans, subscriptions, token_packages, token_usage, tenant_token_balance
messaging: conversations, messages, notifications

---

4.2 BACKEND_INVENTORY.yml

Correcciones principales:

• Cambiar total_modulos de 14 a 12
• Actualizar lista de modulos:
  • Eliminar: billing (separado de subscriptions)
  • Corregir endpoints con prefijo v1/
• Actualizar puerto a 3141
• Corregir ruta de swagger a /docs

Modulos finales:

1. auth
2. products
3. categories
4. sales
5. customers
6. orders
7. inventory
8. payments
9. subscriptions
10. messaging
11. billing
12. integrations

---

4.3 FRONTEND_INVENTORY.yml

Correcciones principales:

• Cambiar root de apps/web a apps/frontend
• Cambiar total_paginas de 7 a 9
• Cambiar total_componentes de 15 a ~1 (Layout) + lib UI
• Cambiar total_contexts de 3 a 1 (AuthContext)
• Actualizar React 18 a 19.2.0
• Agregar Vite 7.2.4
• Actualizar puerto a 3140

Paginas finales:

1. Dashboard (/dashboard)
2. Products (/products)
3. Orders (/orders)
4. Customers (/customers)
5. Fiado (/fiado)
6. Inventory (/inventory)
7. Settings (/settings)
8. Login (/login)
9. Register (/register)

---

4.4 MASTER_INVENTORY.yml

Correcciones principales:

• Cambiar puerto backend de 3500 a 3141
• Cambiar puerto frontend de 5175 a 3140
• Cambiar progreso de 25% a 95%
• Actualizar estados de modulos a completado
• Agregar apps.mobile con estado completado
• Actualizar lista de schemas a 9
• Actualizar integraciones a estados correctos

---

4.5 docs/_MAP.md

Correcciones principales:

• Cambiar referencias de carpetas a archivos .md
  • MCH-001-infraestructura/ → MCH-001-infraestructura-base.md
• Agregar epicas MCH-023 a MCH-028 (FASE 7)
• Actualizar estados de fases segun PROJECT-STATUS.md
• Verificar que los links funcionen
• Actualizar estadisticas

---

5. VALIDACIONES POST-EJECUCION

5.1 Conteos a Verificar

Archivo	Campo	Valor Esperado
DATABASE	schemas	9
DATABASE	tablas	27
DATABASE	extensiones	4
BACKEND	modulos	12
BACKEND	puerto	3141
FRONTEND	paginas	9
FRONTEND	puerto	3140
MASTER	progreso	95%

5.2 Referencias a Verificar

• DATABASE → archivos SQL existen
• BACKEND → modulos en apps/backend/src/modules/
• FRONTEND → paginas en apps/frontend/src/pages/
• MASTER → inventarios referenciados
• MAP → archivos de epicas existen

---

6. ESTIMACION DE TIEMPO

Archivo	Complejidad	Estimacion
DATABASE_INVENTORY.yml	Alta	Reescritura completa
BACKEND_INVENTORY.yml	Alta	Reescritura completa
FRONTEND_INVENTORY.yml	Media	Actualizacion estructural
MASTER_INVENTORY.yml	Baja	Correccion de valores
docs/_MAP.md	Baja	Correccion de referencias

---

7. NOTAS IMPORTANTES

1. No modificar codigo fuente: Solo documentacion
2. Mantener formato SIMCO: Seguir estructura de templates
3. Verificar coherencia: Los inventarios deben ser consistentes entre si
4. Actualizar fechas: Cambiar ultima_actualizacion a 2026-01-10

---

8. APROBACION PARA EJECUCION

Este plan refinado esta listo para ejecucion.

Proxima fase: FASE 6 - Ejecucion del Plan

---

Fin del Plan Refinado