Marketplace móvil para negocios locales
## Documentation - Align MCH-029 to MCH-032 with template-saas modules (SAAS-008 to SAAS-015) - Create MCH-034 (Analytics) and MCH-035 (Reports) from SAAS-016/017 - Update PLAN-DESARROLLO.md with Phase 7 and 8 - Update _MAP.md indexes (35 total epics) ## Database (5 new schemas, 14 tables) - Add storage schema: buckets, files, signed_urls - Add webhooks schema: endpoints, deliveries - Add audit schema: logs, retention_policies - Add features schema: flags, tenant_flags (14 seeds) - Add analytics schema: metrics, events, reports, report_schedules - Add auth.oauth_connections for MCH-030 - Add timestamptz_to_date() IMMUTABLE function - Update EXPECTED_SCHEMAS in recreate-database.sh ## Analysis Reports - ANALISIS-INTEGRACION-TEMPLATE-SAAS-2026-01-13.md - VALIDACION-COHERENCIA-2026-01-13.md - GAP-ANALYSIS-BD-2026-01-13.md - REPORTE-EJECUCION-2026-01-13.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .github/workflows | ||
| apps | ||
| backups | ||
| database | ||
| deploy | ||
| docs | ||
| orchestration | ||
| .env | ||
| .env.docker | ||
| .env.example | ||
| .env.ports | ||
| .gitignore | ||
| docker-compose.yml | ||
| README.md | ||
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 |
| 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
- Auth - Autenticacion y autorizacion
- Tenants - Multi-tenancy
- Products - Catalogo de productos
- Inventory - Control de inventario
- Sales - Punto de venta
- Customers - Clientes y fiados
- Orders - Pedidos
- Reports - Reportes y analytics
- Subscriptions - Planes y suscripciones
- 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