# 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

1. **FASE 1 - MVP Core**: Infraestructura, Auth, Productos, POS, Pagos
2. **FASE 2 - Inteligencia**: Onboarding, Templates, Fiados, Predicciones
3. **FASE 3 - Asistente IA**: MCP Server, WhatsApp, Chat LLM
4. **FASE 4 - Pedidos**: Clientes, Pedidos WhatsApp, Entregas
5. **FASE 5 - Monetización**: Suscripciones, Tokens, Pagos
6. **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

- [Visión del Proyecto](../docs/00-vision-general/VISION-PROYECTO.md)
- [Requerimientos Funcionales](../docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md)
- [Arquitectura Técnica](../docs/00-vision-general/ARQUITECTURA-TECNICA.md)
- [Mapa de Épicas](../docs/01-epicas/_MAP.md)
- [Environment Inventory](./environment/ENVIRONMENT-INVENTORY.yml)

## Estado Actual de Implementación

| Componente | Estado | Notas |
|------------|--------|-------|
| Base de datos | ✅ Completado | 9 schemas, 29 tablas |
| Backend API | ✅ Completado | 12 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