rckrdmrd/michangarrito
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
3477c8f627
michangarrito/docs/00-vision-general/VISION-PROYECTO.md
rckrdmrd 97f407c661 [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 
- Prefijo v2: MCH
- TRACEABILITY-MASTER.yml creado
- Listo para integracion como submodulo

Workspace: v2.0.0 | SIMCO: v4.0.0
2026-01-10 11:28:54 -06:00

344 lines
15 KiB
Markdown
Raw Blame History

---
id: VIS-MCH-001
title: Vision del Proyecto MiChangarrito
type: Vision
status: Published
priority: P0
module: core
version: 1.1.0
created_date: 2026-01-04
updated_date: 2026-01-10
owner: Product Team
tags:
- vision
- estrategia
- saas
---
# MiChangarrito - Vision del Proyecto
| Campo | Valor |
|-------|-------|
| **ID** | VIS-MCH-001 |
| **Tipo** | Vision |
| **Estado** | Published |
| **Version** | 1.1.0 |
| **Ultima Actualizacion** | 2026-01-10 |
## 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 (Completada - 95%)
> **Epicas**: [MCH-001](../01-epicas/MCH-001-infraestructura-base.md) a [MCH-009](../01-epicas/MCH-009-prediccion-inventario.md)
- App movil basica (ventas, cobros)
- Integracion Mercado Pago y Clip
- WhatsApp basico con LLM
- Dashboard web simple
### Fase 2: Inteligencia (En Progreso)
> **Epicas**: [MCH-010](../01-epicas/MCH-010-mcp-server.md) a [MCH-015](../01-epicas/MCH-015-pedidos-whatsapp.md)
- Onboarding con fotos/OCR
- Templates de proveedores
- Alertas de inventario
- Sistema de fiados
### Fase 3: Crecimiento (Planificada)
> **Epicas**: [MCH-016](../01-epicas/MCH-016-entregas-domicilio.md) a [MCH-024](../01-epicas/MCH-024-codi-spei.md)
- Pedidos de clientes via WhatsApp
- CoDi y transferencias
- Modo offline completo
- Programa de referidos
### Fase 4: Expansion (Futura)
> **Epicas**: [MCH-025](../01-epicas/MCH-025-widgets-atajos.md) a [MCH-028](../01-epicas/MCH-028-marketplace-proveedores.md)
- Integracion SAT (opcional)
- Multi-idioma (LATAM)
- Marketplace de proveedores
- Creditos 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 |
---
## Referencias
### Documentos Relacionados
| Documento | Relacion | Path |
|-----------|----------|------|
| Requerimientos Funcionales | Define los RF | [REQUERIMIENTOS-FUNCIONALES.md](./REQUERIMIENTOS-FUNCIONALES.md) |
| Arquitectura Tecnica | Define el stack | [ARQUITECTURA-TECNICA.md](./ARQUITECTURA-TECNICA.md) |
| Epicas del Proyecto | Implementacion | [../01-epicas/_MAP.md](../01-epicas/_MAP.md) |
| Estado del Proyecto | Progreso actual | [../../orchestration/PROJECT-STATUS.md](../../orchestration/PROJECT-STATUS.md) |
### ADRs Relacionados
| ADR | Tema |
|-----|------|
| [ADR-0001](../97-adr/ADR-0001-multi-tenant-architecture.md) | Multi-tenancy Architecture |
| [ADR-0002](../97-adr/ADR-0002-whatsapp-first-approach.md) | WhatsApp-First Approach |
| [ADR-0003](../97-adr/ADR-0003-llm-agnostic-strategy.md) | LLM Agnostic Strategy |
---
**Sistema**: SIMCO v3.7.0
**Documento**: VIS-MCH-001 v1.1.0
Reference in New Issue View Git Blame Copy Permalink