- 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>
13 KiB
13 KiB
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) |
| 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