MiChangarrito - Contexto del Proyecto
Identificación
| Campo |
Valor |
| Nombre |
MiChangarrito |
| Código |
MCH |
| Tipo |
SaaS - Punto de Venta + IA |
| Estado |
Desarrollo |
| Nivel |
NIVEL_2A (Standalone) |
| Inicio |
2026-01-04 |
Descripción
Punto de venta inteligente diseñado para micro-negocios informales en México (tiendas de abarrotes, puestos de comida, fondas). La interfaz principal es WhatsApp con un asistente de IA que gestiona el negocio.
Propuesta de Valor
- WhatsApp First: El dueño opera su negocio desde WhatsApp
- IA Asistente: Consulta ventas, inventario, ganancias por chat
- Pagos Integrados: Terminal Mercado Pago, Clip, CoDi
- Precio Accesible: $99-199/mes + tokens de IA
Target Market
- Tiendas de abarrotes
- Puestos de comida
- Fondas y cocinas económicas
- Pequeños comercios informales
- Usuarios: Personas mayores de 40 años con baja adopción tecnológica
Stack Tecnológico
| Componente |
Tecnología |
| App Móvil |
React Native (Expo) |
| Web Dashboard |
React + Vite + TailwindCSS |
| Backend API |
NestJS |
| MCP Server |
TypeScript + MCP SDK |
| WhatsApp Service |
NestJS + Meta API |
| Base de Datos |
PostgreSQL (multi-tenant) |
| Cache |
Redis |
| LLM |
Agnóstico (OpenRouter/OpenAI/Claude) |
Arquitectura de Carpetas
michangarrito/
├── docs/
│ ├── 00-vision-general/ # Documentación libre de formato
│ ├── 01-epicas/ # Épicas del proyecto
│ ├── 02-especificaciones/ # Specs técnicas
│ └── 90-transversal/ # Docs transversales
├── orchestration/
│ ├── 00-guidelines/ # Lineamientos
│ ├── environment/ # Config DevEnv
│ └── estados/ # Estado de agentes
├── database/
│ ├── init/ # Scripts iniciales
│ ├── schemas/ # DDL
│ └── seeds/ # Datos iniciales
└── apps/
├── backend/ # NestJS API
├── frontend/ # React Dashboard
├── mobile/ # React Native App
├── mcp-server/ # Gateway LLM
└── whatsapp-service/ # WhatsApp Bot
Puertos Asignados (Desarrollo)
| Servicio |
Puerto |
| Web Dashboard |
3140 |
| Backend API |
3141 |
| MCP Server |
3142 |
| WhatsApp Service |
3143 |
| Mobile (Metro) |
8081 |
| PostgreSQL |
5432 |
| Redis |
6379 (db:8) |
Épicas Principales
- FASE 1 - MVP Core: Infraestructura, Auth, Productos, POS, Pagos
- FASE 2 - Inteligencia: Onboarding, Templates, Fiados, Predicciones
- FASE 3 - Asistente IA: MCP Server, WhatsApp, Chat LLM
- FASE 4 - Pedidos: Clientes, Pedidos WhatsApp, Entregas
- FASE 5 - Monetización: Suscripciones, Tokens, Pagos
- FASE 6 - Crecimiento: Offline, Referidos, CoDi, Widgets
Integraciones Externas
| Servicio |
Propósito |
| Meta WhatsApp Business API |
Canal principal de comunicación |
| Stripe |
Suscripciones, pagos, OXXO |
| Mercado Pago |
Terminal de pago con tarjeta |
| Clip |
Terminal de pago con tarjeta |
| CoDi (Banxico) |
Pagos QR sin comisión |
| OpenRouter |
Gateway LLM (más barato) |
| Firebase |
Push notifications |
| Google Vision / Tesseract |
OCR de imágenes |
| Whisper |
Transcripción de audio |
Modelo de Negocio
| Plan |
Precio |
Incluye |
| Changarrito |
$99/mes |
App completa + 500 tokens IA |
| Tiendita |
$199/mes |
Todo + 2,000 tokens + WhatsApp propio |
Tokens IA adicionales (tipo recarga):
- $29 = 1,000 tokens
- $69 = 3,000 tokens
- $149 = 8,000 tokens
- $299 = 20,000 tokens
Referencias
Estado Actual de Implementación
| Componente |
Estado |
Notas |
| Base de datos |
✅ Completado |
11 schemas, 47 tablas |
| Backend API |
✅ Completado |
17 módulos NestJS |
| WhatsApp Service |
✅ Completado |
Meta API + LLM + Multi-tenant |
| MCP Server |
✅ Completado |
15 herramientas |
| Frontend Web |
✅ Completado |
9 páginas |
| Mobile App |
✅ Completado |
React Native (Expo) - 10 pantallas |
| Multi-Tenant Integraciones |
✅ Completado |
WhatsApp/LLM por tenant con fallback |
Última actualización: 2026-01-10
rckrdmrd
97f407c661