michangarrito/backups/docs-backup-2026-01-10/docs/00-vision-general/VISION-PROYECTO.md
rckrdmrd 928eb795e6 [SIMCO-V38] feat: Actualizar a SIMCO v3.8.0 + cambios apps
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8
- Cambios en backend y frontend

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 08:53:05 -06:00

291 lines
13 KiB
Markdown

# MiChangarrito - Visión del Proyecto
## El Problema
En México existen **más de 1.2 millones de tienditas, changarros y puestos de comida** que operan de manera informal. Estos negocios enfrentan:
- **Rechazo de clientes** que solo traen tarjeta
- **Descontrol de inventario** - No saben cuándo resurtir
- **Falta de visibilidad** - No conocen sus ganancias reales
- **Tecnología intimidante** - Sistemas complicados que no entienden
- **Costos altos** - Terminales caras y sistemas con rentas elevadas
## La Solución: MiChangarrito
Un **punto de venta inteligente y accesible** diseñado específicamente para el mercado informal mexicano, donde el usuario puede operar principalmente a través de **WhatsApp** con ayuda de un asistente de IA.
### Propuesta de Valor
```
┌─────────────────────────────────────────────────────────────────────────┐
│ │
│ "TU NEGOCIO EN TU BOLSILLO, TAN FÁCIL COMO MANDAR UN WHATSAPP" │
│ │
│ ✅ Acepta tarjetas (Mercado Pago, Clip, CoDi) │
│ ✅ Controla tu inventario con una foto │
│ ✅ Pregúntale a tu asistente cuánto vendiste │
│ ✅ Recibe pedidos de clientes por WhatsApp │
│ ✅ Precio justo: $100-200/mes + lo que uses de IA │
│ │
└─────────────────────────────────────────────────────────────────────────┘
```
## Filosofía de Diseño
### "WhatsApp First, App Second"
La mayoría de nuestros usuarios:
- Son mayores de 40 años
- Tienen educación básica o media
- Usan WhatsApp todos los días
- Les intimida instalar apps nuevas
- Prefieren hablar/escribir que navegar menús
**Por eso**: El LLM vía WhatsApp es la interfaz principal. La app es solo para acciones que requieren la pantalla (cobrar con terminal, escanear códigos).
### "Botones Grandes, Pocos Pasos"
Cuando sí usen la app:
- Máximo 2 taps para completar una acción
- Texto grande y legible
- Iconos claros y universales
- Modo "Abuelito" activable
### "Si no entiendes, pregunta"
El asistente IA siempre está disponible para:
- Explicar cómo hacer algo
- Hacer la acción por el usuario
- Generar reportes y documentos
- Recordar pendientes
## Mercado Objetivo
### Primario: Micro-negocios Informales México
| Segmento | Características | Tamaño Estimado |
|----------|-----------------|-----------------|
| Tiendas de abarrotes | 1-2 personas, familiar | 500,000+ |
| Puestos de comida | Tacos, tortas, comida corrida | 300,000+ |
| Fondas y cocinas | Comida económica | 150,000+ |
| Vendedores ambulantes | Dulces, snacks, bebidas | 200,000+ |
| Otros changarros | Papelerías, estéticas pequeñas | 100,000+ |
### Perfil del Usuario Principal
```
👤 "Doña Mary" - 52 años
- Tienda de abarrotes en colonia popular
- Usa WhatsApp para comunicarse con familia y proveedores
- Tiene smartphone Android básico
- Anota ventas en libreta (a veces)
- Pierde clientes que solo traen tarjeta
- No sabe exactamente cuánto gana al mes
- Le da "fiao" a vecinos y a veces olvida
- Quiere algo simple, no un sistema complicado
```
### Secundario: Expansión LATAM
Misma problemática en:
- Guatemala, Honduras, El Salvador
- Colombia, Perú, Ecuador
- Adaptaciones locales necesarias (idioma, proveedores, pagos)
## Modelo de Negocio
### Pricing
```
┌─────────────────────────────────────────────────────────────────────────┐
│ PLANES MICHANGARRITO │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ 🏪 PLAN CHANGARRITO $99/mes │
│ - App móvil completa │
│ - Dashboard web │
│ - Integraciones de pago (MP, Clip, CoDi) │
│ - 500 tokens IA incluidos │
│ - WhatsApp compartido │
│ │
│ 🏬 PLAN TIENDITA $199/mes │
│ - Todo lo del Plan Changarrito │
│ - 2,000 tokens IA incluidos │
│ - WhatsApp Business propio (si tiene) │
│ - Reportes avanzados │
│ - Pedidos a domicilio │
│ - Soporte prioritario │
│ │
├─────────────────────────────────────────────────────────────────────────┤
│ PAQUETES DE TOKENS IA │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ 🪙 Recarga Chica 1,000 tokens $29 │
│ 🪙 Recarga Mediana 3,000 tokens $69 │
│ 🪙 Recarga Grande 8,000 tokens $149 │
│ 🪙 Recarga Mega 20,000 tokens $299 │
│ │
│ * Similar a recargas de celular │
│ * Se pueden comprar en OXXO con referencia │
│ │
└─────────────────────────────────────────────────────────────────────────┘
```
### Métodos de Pago de Suscripción
| Método | Descripción | Comisión |
|--------|-------------|----------|
| OXXO (referencia) | Pago en efectivo, el más usado | ~$10-15 |
| Tarjeta (Stripe) | Débito/crédito recurrente | 3.6% + $3 |
| Play Store | Suscripción in-app Android | 15-30% |
| App Store | Suscripción in-app iOS | 15-30% |
### Proyección de Ingresos (Año 1)
```
Mes 1-3: 100 usuarios → $15,000/mes
Mes 4-6: 500 usuarios → $75,000/mes
Mes 7-9: 2,000 usuarios → $300,000/mes
Mes 10-12: 5,000 usuarios → $750,000/mes
+ Ingresos por tokens IA (estimado 30% adicional)
```
## Diferenciadores Clave
### vs Competencia (Clip, iZettle, Square)
| Característica | Competencia | MiChangarrito |
|----------------|-------------|---------------|
| Precio mensual | $0-299 | $99-199 |
| Comisión por transacción | 3.5%+ | Solo terminal |
| Asistente IA | ❌ | ✅ WhatsApp 24/7 |
| Onboarding | App compleja | Foto/audio/chat |
| Inventario | Básico o ninguno | Inteligente con alertas |
| Fiados/Crédito | ❌ | ✅ Digital |
| Pedidos WhatsApp | ❌ | ✅ Integrado |
| Modo offline | Limitado | ✅ Completo |
| Reportes por chat | ❌ | ✅ "¿Cuánto vendí hoy?" |
## Roadmap de Alto Nivel
### Fase 1: MVP (3-4 meses)
- App móvil básica (ventas, cobros)
- Integración Mercado Pago y Clip
- WhatsApp básico con LLM
- Dashboard web simple
### Fase 2: Inteligencia (2-3 meses)
- Onboarding con fotos/OCR
- Templates de proveedores
- Alertas de inventario
- Sistema de fiados
### Fase 3: Crecimiento (2-3 meses)
- Pedidos de clientes vía WhatsApp
- CoDi y transferencias
- Modo offline completo
- Programa de referidos
### Fase 4: Expansión (3+ meses)
- Integración SAT (opcional)
- Multi-idioma (LATAM)
- Marketplace de proveedores
- Créditos para negocio
## Tecnología
### Stack Principal
| Componente | Tecnología |
|------------|------------|
| App Móvil | React Native |
| Web Dashboard | React + Vite |
| Backend API | NestJS (TypeScript) |
| Base de Datos | PostgreSQL (multi-tenant) |
| Cache/Sessions | Redis |
| LLM Gateway | MCP Server (agnóstico) |
| WhatsApp | Meta Business API |
| Pagos | Stripe, Mercado Pago SDK, Clip API |
| Push Notifications | Firebase Cloud Messaging |
| Storage | S3/MinIO |
### LLM - Diseño Agnóstico
```
┌─────────────────────────────────────────────────────────────────────────┐
│ LLM GATEWAY (MCP Server) │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ Interfaz unificada que soporta múltiples proveedores: │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ OpenAI │ │ Claude │ │ OpenRouter │ │ Ollama │ │
│ │ GPT-4o │ │ Sonnet │ │ (Barato) │ │ (Local) │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │ │ │ │ │
│ └────────────────┴────────────────┴────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ MCP Server │ │
│ │ (Agnóstico) │ │
│ └─────────────────┘ │
│ │
│ Permite cambiar de proveedor según: │
│ - Costos (OpenRouter suele ser más barato) │
│ - Disponibilidad │
│ - Calidad de respuesta por caso de uso │
│ │
└─────────────────────────────────────────────────────────────────────────┘
```
## Métricas de Éxito
### KPIs Principales
| Métrica | Meta Año 1 |
|---------|------------|
| Usuarios activos mensuales | 5,000 |
| Retención mensual | >70% |
| NPS | >50 |
| Transacciones procesadas | 500,000 |
| Ingresos recurrentes mensuales | $750,000 MXN |
### KPIs de Producto
| Métrica | Meta |
|---------|------|
| Tiempo de onboarding | <5 minutos |
| Mensajes WhatsApp por usuario/día | 3-5 |
| Uso de IA vs app directa | 60% / 40% |
| Tasa de resolución IA | >85% |
## Riesgos y Mitigaciones
| Riesgo | Probabilidad | Impacto | Mitigación |
|--------|--------------|---------|------------|
| Adopción lenta | Media | Alto | Programa de referidos, prueba gratis |
| Costos de IA altos | Media | Medio | Multi-proveedor, cache de respuestas |
| Competencia de grandes | Alta | Medio | Enfoque en UX para mercado informal |
| Regulación WhatsApp | Baja | Alto | Alternativa in-app como backup |
| Fraude/chargebacks | Media | Medio | Verificación de negocios |
## Equipo Necesario
### Fase MVP
| Rol | Cantidad |
|-----|----------|
| Full-stack developer | 2 |
| Mobile developer (RN) | 1 |
| DevOps/Backend senior | 1 |
| UX/UI Designer | 1 |
| Product Manager | 1 |
---
**Documento vivo** - Última actualización: 2026-01-04
**Autor**: Product Team
**Versión**: 1.0.0