miinventario-v2/docs/00-vision-general/VISION-PROYECTO.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

309 lines
8.9 KiB
Markdown

# MiInventario - Vision del Proyecto
---
id: VIS-MII-001
type: Vision
status: Published
version: "1.0.0"
created_date: 2026-01-10
updated_date: 2026-01-10
simco_version: "4.0.0"
owner: "Product Owner"
tags:
- vision
- producto
- saas
- inventario
- ia
---
## Metadata
| Campo | Valor |
|-------|-------|
| **ID** | VIS-MII-001 |
| **Tipo** | Vision |
| **Estado** | Published |
| **Version** | 1.0.0 |
| **Ultima Actualizacion** | 2026-01-10 |
---
## 1. El Problema
### Mercado Objetivo
Los negocios pequenos en Mexico (tienditas, miscelaneas, puestos, abarrotes) enfrentan desafios significativos para gestionar su inventario:
- **2.5+ millones** de tienditas en Mexico
- **80%** no tienen sistema de inventario formal
- **Perdidas por desabasto** estimadas en 15-20% de ventas potenciales
- **Tiempo invertido** en conteo manual: 2-4 horas semanales
### Pain Points
1. **Conteo manual tedioso** - Requiere cerrar o reducir operacion
2. **Sin visibilidad de stock** - No saben que tienen hasta que falta
3. **Errores humanos** - Conteos imprecisos
4. **Falta de historial** - No hay datos para decidir compras
5. **Costo de soluciones** - Sistemas POS son caros y complejos
---
## 2. La Solucion
### Propuesta de Valor
**MiInventario** es una aplicacion movil que permite generar inventario automatico en segundos, grabando un video de 30-60 segundos de los anaqueles.
```
┌─────────────────────────────────────────────────────────────────┐
│ │
│ ANTES: 2-4 horas contando DESPUES: 60 segundos de video │
│ producto por producto y reporte automatico │
│ │
└─────────────────────────────────────────────────────────────────┘
```
### Diferenciadores
| Caracteristica | MiInventario | Competencia |
|----------------|--------------|-------------|
| Tiempo de inventario | 1 minuto | 2-4 horas |
| Curva de aprendizaje | Minima | Alta |
| Costo inicial | $0 | $500-5000 MXN |
| Pagos en efectivo | Si (OXXO, 7-Eleven) | Raro |
| Mejora con uso | Si (IA aprende) | No |
---
## 3. Filosofia de Diseno
### Principios UX
1. **Simplicidad extrema** - Maximo 3 taps para completar inventario
2. **Mobile-first** - Disenado para smartphone basico
3. **Tolerante a errores** - Guia clara, facil corregir
4. **Offline-capable** - Funciona con conectividad limitada
5. **Accesible** - Textos grandes, iconos claros
### Principios Tecnicos
1. **Costo transparente** - Precio = 2x costo IA
2. **Aprendizaje continuo** - Retroalimentacion mejora el modelo
3. **Abstraccion de IA** - Cambiar proveedor sin impacto usuario
4. **Idempotencia** - Pagos robustos y seguros
---
## 4. Mercado Objetivo
### Primario
| Segmento | Caracteristicas |
|----------|-----------------|
| **Tienditas de abarrotes** | 1-2 empleados, inventario variado |
| **Miscelaneas** | Productos de consumo diario |
| **Puestos de mercado** | Inventario cambiante |
### Secundario
| Segmento | Caracteristicas |
|----------|-----------------|
| **Farmacias pequenas** | Inventario regulado |
| **Papelerias** | SKUs diversos |
| **Ferreterias chicas** | Productos industriales |
### Perfil de Usuario
```
Nombre: "Don Pepe"
Edad: 35-60 anos
Ubicacion: Zona urbana/suburbana Mexico
Dispositivo: Android gama baja-media
Conectividad: 3G/4G intermitente
Metodo de pago preferido: Efectivo (OXXO)
Experiencia tech: Basica (WhatsApp, Facebook)
```
---
## 5. Modelo de Negocio
### Pricing
| Concepto | Descripcion |
|----------|-------------|
| **Modelo** | Pago por consumo (Pay-as-you-go) |
| **Unidad** | Credito = 1 sesion de inventario |
| **Costo** | 2x COGS IA (transparente) |
### Paquetes de Recarga
| Paquete | Precio MXN | Creditos* |
|---------|------------|-----------|
| Basico | $50 | ~5-8 |
| Popular | $100 | ~10-16 |
| Ahorro | $200 | ~20-35 |
| Pro | $500 | ~50-90 |
*Creditos varian segun costo IA actual
### Metodos de Pago
1. **Tarjeta** - Visa, Mastercard (Stripe)
2. **OXXO** - Voucher, pago en tienda
3. **7-Eleven** - Referencia, pago en tienda
### Proyeccion
| Metrica | Mes 6 | Mes 12 |
|---------|-------|--------|
| Usuarios activos | 1,000 | 10,000 |
| Sesiones/mes | 5,000 | 80,000 |
| Revenue MRR | $25,000 MXN | $400,000 MXN |
---
## 6. Diferenciadores vs Competencia
| Aspecto | MiInventario | Alegra | Bind ERP | Conteo Manual |
|---------|--------------|--------|----------|---------------|
| Automatizacion | Video + IA | Manual | Manual | Manual |
| Tiempo | 1 min | 1-2 hrs | 1-2 hrs | 2-4 hrs |
| Costo mensual | $50-500 | $300+ | $500+ | $0 |
| Pago efectivo | Si | No | No | - |
| Curva aprendizaje | Minima | Media | Alta | - |
| Precision | 80%+ (mejora) | 100% | 100% | 95% |
---
## 7. Roadmap de Alto Nivel
### Fase 1: MVP Core (6-8 semanas)
- Registro y autenticacion
- Captura de video guiada
- Procesamiento IA basico
- Reporte de inventario
### Fase 2: Retroalimentacion (2-3 semanas)
- Correcciones de usuario
- Mejora continua del modelo
### Fase 3: Monetizacion (3-4 semanas)
- Sistema de creditos
- Pagos (tarjeta, OXXO, 7-Eleven)
### Fase 4: Crecimiento (2-3 semanas)
- Sistema de referidos
- Panel de administracion
---
## 8. Tecnologia
### Stack Principal
| Capa | Tecnologia |
|------|------------|
| Mobile | React Native (Expo) |
| Backend | NestJS + TypeScript |
| Database | PostgreSQL + Redis |
| Storage | S3 Compatible |
| Pagos | Stripe |
| IA | Abstraccion multi-proveedor |
### Arquitectura de Alto Nivel
```
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Mobile │────▶│ Backend │────▶│ Database │
│ (Expo RN) │ │ (NestJS) │ │ (PostgreSQL)│
└─────────────┘ └──────┬──────┘ └─────────────┘
┌──────▼──────┐
│ Queue │
│ (Bull) │
└──────┬──────┘
┌──────────────────┼──────────────────┐
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ S3 │ │ IA Worker │ │ Stripe │
│ (MinIO) │ │ (Vision) │ │ (Payments) │
└─────────────┘ └─────────────┘ └─────────────┘
```
---
## 9. Metricas de Exito
### KPIs de Producto
| Metrica | Objetivo |
|---------|----------|
| Precision IA | >80% productos conocidos |
| Tiempo proceso | <3 min por sesion |
| NPS | >50 |
| Retencion M1 | >40% |
### KPIs de Negocio
| Metrica | Objetivo |
|---------|----------|
| CAC | <$50 MXN |
| LTV | >$500 MXN |
| LTV:CAC | >10:1 |
| Margen | >50% |
---
## 10. Riesgos y Mitigaciones
| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| Precision IA baja | Alta | Alto | Retroalimentacion, mejora continua |
| Calidad video | Media | Medio | Guia UX, validacion local |
| Costos IA suben | Media | Medio | Abstraccion, pricing dinamico |
| Fraude referidos | Media | Medio | Anti-fraude desde inicio |
| Competencia | Baja | Medio | Moverse rapido, UX superior |
---
## 11. Equipo Necesario
| Rol | Cantidad | Notas |
|-----|----------|-------|
| Product Owner | 1 | Vision y prioridades |
| Tech Lead | 1 | Arquitectura |
| Backend Dev | 1-2 | NestJS, IA integration |
| Mobile Dev | 1 | React Native |
| ML Engineer | 0.5 | Fine-tuning, optimizacion |
| DevOps | 0.5 | Infraestructura |
---
## 12. Referencias
### Documentos Relacionados
| Documento | Relacion | Path |
|-----------|----------|------|
| Requerimientos | Define los RF | [REQUERIMIENTOS-FUNCIONALES.md](./REQUERIMIENTOS-FUNCIONALES.md) |
| Arquitectura | Define el como | [ARQUITECTURA-TECNICA.md](./ARQUITECTURA-TECNICA.md) |
| Epicas | Desglose | [01-epicas/_MAP.md](../01-epicas/_MAP.md) |
### ADRs Relacionados
| ADR | Tema |
|-----|------|
| [ADR-0001](../97-adr/ADR-0001-modelo-creditos-tokens.md) | Modelo de creditos |
| [ADR-0002](../97-adr/ADR-0002-procesamiento-asincrono.md) | Procesamiento asincrono |
| [ADR-0003](../97-adr/ADR-0003-abstraccion-proveedores-ia.md) | Abstraccion IA |
| [ADR-0004](../97-adr/ADR-0004-pagos-efectivo-mexico.md) | Pagos en efectivo |
---
**Ultima Actualizacion:** 2026-01-10
**Autor:** Product Owner