- 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>
309 lines
8.9 KiB
Markdown
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
|