miinventario-v2/orchestration/PLAN-IMPLEMENTACION.md
rckrdmrd 1a53b5c4d3 [MIINVENTARIO] feat: Initial commit - Sistema de inventario con análisis de video IA
- Backend NestJS con módulos de autenticación, inventario, créditos
- Frontend React con dashboard y componentes UI
- Base de datos PostgreSQL con migraciones
- Tests E2E configurados
- Configuración de Docker y deployment

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 02:25:48 -06:00

7.6 KiB

PLAN DE IMPLEMENTACION - MiInventario

Version: 1.0.0 Fecha: 2026-01-10 Estado: Aprobado SIMCO Version: 4.0.0


Resumen Ejecutivo

Campo Valor
Total Fases 4
Total Epicas 15
Total Story Points 202
Duracion Estimada 12-16 semanas
Prioridad Alta

FASE 1: MVP Core

Objetivo: Funcionalidad base de inventario por video Story Points: 97 Duracion Estimada: 6-8 semanas

MII-001: Infraestructura Base (8 SP)

Objetivo: Establecer la base tecnica del proyecto

Entregable Descripcion
Docker Compose Servicios PostgreSQL, Redis, MinIO
Schemas base Extensions, auth, public
Proyecto NestJS Estructura inicial
Proyecto Expo Estructura inicial
CI/CD base GitHub Actions

Dependencias: Ninguna Bloquea: MII-002

MII-002: Autenticacion (13 SP)

Objetivo: Sistema completo de autenticacion

Entregable Descripcion
Registro Email/telefono con OTP
Login JWT + Refresh tokens
Perfil Datos basicos de usuario
Consentimientos GDPR/Mexico compliance

Dependencias: MII-001 Bloquea: MII-003 Catalogo: auth, session-management

MII-003: Gestion de Tiendas (8 SP)

Objetivo: Multi-tienda por usuario

Entregable Descripcion
CRUD Tiendas Crear, editar, eliminar
Multi-tenant RLS por tienda
Roles Owner/Operator

Dependencias: MII-002 Bloquea: MII-004 Catalogo: multi-tenancy

MII-004: Captura de Video (21 SP)

Objetivo: Captura guiada de video en mobile

Entregable Descripcion
Guia UX Instrucciones de captura
Validacion Resolucion, luz, duracion
Compresion Preprocesado local
Upload Subida resiliente

Dependencias: MII-003 Bloquea: MII-005

MII-005: Procesamiento IA (34 SP)

Objetivo: Deteccion y conteo de productos

Entregable Descripcion
Cola trabajos Bull + Redis
Extraccion Frames de video
Deteccion Integracion proveedor IA
Conteo Consolidacion multi-frame

Dependencias: MII-004 Bloquea: MII-006, MII-007, MII-008

MII-006: Reportes de Inventario (13 SP)

Objetivo: Visualizacion de resultados

Entregable Descripcion
Reporte sesion Lista por SKU
Historial Sesiones anteriores
Exportacion PDF/CSV
Compartir WhatsApp

Dependencias: MII-005 Bloquea: MII-007, MII-008, MII-009


FASE 2: Retroalimentacion

Objetivo: Mejora continua del modelo IA Story Points: 21 Duracion Estimada: 2-3 semanas

MII-007: Retroalimentacion (13 SP)

Entregable Descripcion
Correccion SKU Cambiar producto detectado
Correccion cantidad Ajustar conteo
Etiquetado Productos desconocidos
Ground truth Registro de correcciones

Dependencias: MII-006

MII-008: Validacion Aleatoria (8 SP)

Entregable Descripcion
Micro-auditorias X% de sesiones
Reglas Activacion por calidad
Registro Respuestas como ground truth

Dependencias: MII-006


FASE 3: Monetizacion

Objetivo: Sistema de creditos y pagos Story Points: 50 Duracion Estimada: 3-4 semanas

MII-009: Wallet y Creditos (13 SP)

Entregable Descripcion
Cartera Balance por usuario
Consumo Creditos por sesion
Motor costos COGS IA
Precio Regla 2x COGS

Dependencias: MII-006 Bloquea: MII-010, MII-011, MII-012, MII-013, MII-014

MII-010: Paquetes de Recarga (8 SP)

Entregable Descripcion
Paquetes $50, $100, $200, $500
Equivalencias Dinamicas por costo IA
Promociones Bonos temporales

Dependencias: MII-009

MII-011: Pagos con Tarjeta (8 SP)

Entregable Descripcion
Stripe Integracion checkout
Webhooks Confirmacion
UI Flujo de pago

Dependencias: MII-010 Catalogo: payments

MII-012: Pagos OXXO (13 SP)

Entregable Descripcion
Voucher Generacion referencia
Confirmacion Webhook asincrono
Expiracion 72h configurable

Dependencias: MII-010

MII-013: Pagos 7-Eleven (8 SP)

Entregable Descripcion
Agregador Integracion
Referencias Generacion
Confirmacion Webhook

Dependencias: MII-010


FASE 4: Crecimiento

Objetivo: Referidos y administracion Story Points: 34 Duracion Estimada: 2-3 semanas

MII-014: Sistema de Referidos (21 SP)

Entregable Descripcion
Codigos Link/codigo unico
Atribucion Registro con referido
Recompensas 1 credito break-even
Multinivel Configurable (1-3 niveles)
Anti-fraude Deteccion y limites

Dependencias: MII-009

MII-015: Administracion SaaS (13 SP)

Entregable Descripcion
Costos IA Configuracion
Paquetes Gestion
Referidos Reglas
Metricas Dashboard

Dependencias: MII-009, MII-014


Diagrama de Dependencias

MII-001
    │
    ▼
MII-002
    │
    ▼
MII-003
    │
    ▼
MII-004
    │
    ▼
MII-005
    │
    ├───────────────────┬───────────────────┐
    ▼                   ▼                   ▼
MII-006             MII-007             MII-008
    │
    ▼
MII-009
    │
    ├───────────┬───────────┬───────────┐
    ▼           ▼           ▼           ▼
MII-010     MII-011     MII-012     MII-014
    │           │           │           │
    │           │           │           ▼
    │           │           │       MII-015
    ▼           │           ▼
MII-013         │       (webhook)
                ▼
            (webhook)

Cronograma Tentativo

Semana Fase Epicas Notas
1-2 1 MII-001, MII-002 Infraestructura y Auth
3-4 1 MII-003, MII-004 Tiendas y Video
5-6 1 MII-005 Procesamiento IA (critico)
7-8 1/2 MII-006, MII-007, MII-008 Reportes y Feedback
9-10 3 MII-009, MII-010 Wallet y Paquetes
11-12 3 MII-011, MII-012, MII-013 Pagos
13-14 4 MII-014, MII-015 Referidos y Admin

Total: 14 semanas (puede variar segun recursos)


Riesgos y Mitigaciones

Riesgo Probabilidad Impacto Mitigacion
Complejidad IA Alta Alto Abstraccion multi-proveedor, empezar simple
Performance video Media Medio Preprocesado en dispositivo
Integracion pagos Media Alto Usar Stripe para OXXO (probado)
Fraude referidos Media Medio Sistema anti-fraude desde inicio
Costos IA variables Media Medio Pricing dinamico

Criterios de Exito por Fase

Fase 1 (MVP)

  • Usuario puede registrarse y crear tienda
  • Usuario puede grabar video y recibir reporte
  • Precision IA > 70% en productos conocidos

Fase 2 (Feedback)

  • Usuario puede corregir errores
  • Ground truth se registra correctamente

Fase 3 (Monetizacion)

  • Usuario puede comprar creditos
  • Pagos OXXO funcionan end-to-end

Fase 4 (Crecimiento)

  • Sistema de referidos operativo
  • Admin puede configurar parametros

Ultima Actualizacion: 2026-01-10 Aprobado por: Agente Orquestador