MiChangarrito - Plataforma POS Multi-tenant

Version: 0.1.0 Estado: Desarrollo Tipo: STANDALONE (SaaS) Sistema: SIMCO + NEXUS v3.4

---

Descripcion

Plataforma de punto de venta (POS) para tiendas pequenas y medianas en Mexico. Sistema multi-tenant con soporte para multiples canales: app movil, web, WhatsApp y asistente IA.

Funcionalidades Principales

• Punto de venta rapido y facil
• Gestion de productos e inventario
• Control de clientes y fiados
• Pedidos y ordenes
• Integracion WhatsApp Business
• Asistente IA para ventas
• Reportes y analytics
• Pagos: Stripe, MercadoPago, Clip, CoDi, SPEI

---

Stack Tecnologico

Capa	Tecnologia
Backend	NestJS + TypeScript
Frontend Web	React + Vite
Mobile	React Native
Database	PostgreSQL 16+ con RLS (Multi-tenant)
Cache	Redis
AI/LLM	OpenRouter, OpenAI, Claude, Ollama
WhatsApp	Meta Business API
Payments	Stripe, MercadoPago, Clip

---

Estructura del Proyecto

michangarrito/
├── apps/
│   ├── backend/          # API NestJS
│   ├── frontend/         # Web React
│   ├── mobile/           # React Native
│   ├── web/              # Landing page
│   ├── mcp-server/       # Servidor MCP para LLM
│   └── whatsapp-service/ # Integracion WhatsApp
├── database/
│   ├── schemas/          # DDL
│   └── seeds/            # Datos iniciales
├── docs/
│   ├── 00-vision-general/
│   ├── 01-epicas/
│   ├── 02-especificaciones/
│   └── 90-transversal/
└── orchestration/
    ├── 00-guidelines/
    ├── inventarios/
    ├── environment/
    └── trazas/

---

Modulos Principales

1. Auth - Autenticacion y autorizacion
2. Tenants - Multi-tenancy
3. Products - Catalogo de productos
4. Inventory - Control de inventario
5. Sales - Punto de venta
6. Customers - Clientes y fiados
7. Orders - Pedidos
8. Reports - Reportes y analytics
9. Subscriptions - Planes y suscripciones
10. Payments - Integracion de pagos

---

Inicio Rapido

# Backend
cd apps/backend && npm install && npm run start:dev

# Frontend
cd apps/frontend && npm install && npm run dev

# MCP Server
cd apps/mcp-server && npm install && npm run start

# WhatsApp Service
cd apps/whatsapp-service && npm install && npm run start

---

Variables de Entorno

Ver .env.example para la configuracion requerida.

---

Referencias

• Vision: docs/00-vision-general/VISION-PROYECTO.md
• Arquitectura: docs/00-vision-general/ARQUITECTURA-TECNICA.md
• Requerimientos: docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md
• Contexto: orchestration/00-guidelines/

---

Creado: 2026-01-04 Actualizado: 2026-01-07