rckrdmrd/michangarrito
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Marketplace móvil para negocios locales
21 Commits 2 Branches 0 Tags 165 MiB
TypeScript 90.4%
PLpgSQL 4.2%
Shell 3.9%
JavaScript 0.7%
Dockerfile 0.6%
Other 0.2%
15852f2d6a
Go to file
rckrdmrd 15852f2d6a [MCH-DOC-VAL] docs: Mejorar integraciones INT-004, INT-005, INT-006 con SIMCO 4.0.1 
Actualiza documentación de integraciones de pagos a estructura estándar
de 11-13 secciones siguiendo template de INT-001.

Cambios por integración:

INT-004-mercadopago.md (+458 líneas):
- Actualizado simco_version a 4.0.1
- Agregado: Rate Limits con retry strategy
- Agregado: Manejo de Errores completo (8 códigos)
- Agregado: Fallbacks y modo degradado
- Mejorado: Multi-tenant con SQL schema
- Agregado: Webhooks IPN con validación de firma
- Agregado: Testing con tarjetas de prueba MX
- Agregado: Monitoreo con métricas y logs

INT-005-clip.md (+485 líneas):
- Actualizado simco_version a 4.0.1
- Agregado: Rate Limits (100 req/min)
- Agregado: Manejo de Errores (7 códigos)
- Agregado: Fallbacks con cola Redis
- Agregado: Multi-tenant con tenant_clip_config
- Agregado: Webhooks con HMAC validation
- Agregado: Testing con tarjetas Clip MX
- Agregado: Monitoreo y Referencias

INT-006-codi-banxico.md (+694 líneas):
- Actualizado simco_version a 4.0.1
- Agregado: Rate Limits STP/Banxico
- Agregado: Manejo de Errores CoDi/STP
- Agregado: Fallbacks (QR alternativo, manual)
- Agregado: Multi-tenant con CLABEs por tenant
- Agregado: Webhooks STP con firma RSA-SHA256
- Agregado: Testing con CLABEs sandbox
- Agregado: Monitoreo y normatividad mexicana

Total: +1,573 líneas de documentación técnica.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 04:46:57 -06:00
.github/workflows [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 2026-01-10 11:28:54 -06:00
backend@d624447d4c [MULTI-REPO] Convertir a estructura multi-repo con submodules -v2 2026-01-16 08:28:00 -06:00
backups [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 2026-01-10 11:28:54 -06:00
database@ad9944d86b [MULTI-REPO] Convertir a estructura multi-repo con submodules -v2 2026-01-16 08:28:00 -06:00
deploy [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 2026-01-10 11:28:54 -06:00
docs [MCH-DOC-VAL] docs: Mejorar integraciones INT-004, INT-005, INT-006 con SIMCO 4.0.1 2026-01-17 04:46:57 -06:00
frontend@67d3eef6a5 [MULTI-REPO] Convertir a estructura multi-repo con submodules -v2 2026-01-16 08:28:00 -06:00
mcp-server@d08364c9eb [MULTI-REPO] Convertir a estructura multi-repo con submodules -v2 2026-01-16 08:28:00 -06:00
mobile@a71600df2f [MULTI-REPO] Convertir a estructura multi-repo con submodules -v2 2026-01-16 08:28:00 -06:00
orchestration [MCH-DOC-VAL] docs: Validacion documental inicial 2026-01-17 04:19:07 -06:00
whatsapp-service@7ca75455bc [MULTI-REPO] Convertir a estructura multi-repo con submodules -v2 2026-01-16 08:28:00 -06:00
.env [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 2026-01-10 11:28:54 -06:00
.env.docker [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 2026-01-10 11:28:54 -06:00
.env.example [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 2026-01-10 11:28:54 -06:00
.env.ports [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 2026-01-10 11:28:54 -06:00
.gitignore [MICHANGARRITO] chore: Add .gitignore for dependencies and build artifacts 2026-01-13 02:13:02 -06:00
.gitmodules [MULTI-REPO] Convertir a estructura multi-repo con submodules -v2 2026-01-16 08:28:00 -06:00
docker-compose.yml [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 2026-01-10 11:28:54 -06:00
README.md [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 2026-01-10 11:28:54 -06:00

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
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