rckrdmrd
928eb795e6
- 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>
142 lines
4.6 KiB
Markdown
142 lines
4.6 KiB
Markdown
# 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 | 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
|