michangarrito/docs
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
..
_definitions [INTEGRATION] F4: Crear _definitions/ y _quick/ (independiente, 18 módulos) 2026-01-16 04:14:27 -06:00
_quick [INTEGRATION] F4: Crear _definitions/ y _quick/ (independiente, 18 módulos) 2026-01-16 04:14:27 -06:00
00-vision-general [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 2026-01-10 11:28:54 -06:00
01-epicas [MCH-DOC-VAL] docs: Estandarizar épicas MCH-016 a MCH-027 con HU formales 2026-01-17 04:40:45 -06:00
02-devops [SIMCO-V4] feat: Agregar documentación SaaS, ADRs e integraciones 2026-01-13 01:43:15 -06:00
02-especificaciones [INTEGRATION] feat: Integrate template-saas scopes and database objects 2026-01-13 07:10:55 -06:00
02-integraciones [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
04-modelado/trazabilidad [SIMCO-V4] feat: Agregar documentación SaaS, ADRs e integraciones 2026-01-13 01:43:15 -06:00
90-transversal [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 2026-01-10 11:28:54 -06:00
97-adr [SIMCO-V4] feat: Agregar documentación SaaS, ADRs e integraciones 2026-01-13 01:43:15 -06:00
_MAP.md [INTEGRATION] F4: Crear _definitions/ y _quick/ (independiente, 18 módulos) 2026-01-16 04:14:27 -06:00
INDICE-ARQUITECTURA.md [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

MiChangarrito - Documentacion

Descripcion

Documentacion completa del proyecto MiChangarrito, punto de venta inteligente para micro-negocios informales en Mexico (tiendas de abarrotes, puestos de comida, fondas).

Propuesta de Valor

  • WhatsApp First: El dueno 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

Estructura de Documentacion

Directorio Contenido Archivos
00-vision-general/ Vision, requerimientos, arquitectura 3
01-epicas/ 28 epicas del proyecto (MCH-001 a MCH-028) 29
02-especificaciones/ Especificaciones tecnicas 6
02-integraciones/ Documentacion de integraciones externas 5
90-transversal/ Documentacion transversal 2
97-adr/ Decisiones arquitectonicas 4

Navegacion Rapida

Por Tipo de Documento

Tipo Ubicacion Descripcion
Vision VISION-PROYECTO.md Propuesta de valor y target market
Requerimientos REQUERIMIENTOS-FUNCIONALES.md Requisitos del sistema
Arquitectura ARQUITECTURA-TECNICA.md Stack tecnico
Epicas 01-epicas/_MAP.md Indice de 28 epicas
Integraciones 02-integraciones/_MAP.md WhatsApp, Stripe, LLM, etc
ADRs 97-adr/_MAP.md Decisiones arquitectonicas

Mapa Principal

  • _MAP.md - Mapa completo de documentacion con metricas

Estado del Proyecto

Metrica Valor
Progreso MVP 95%
Fases Completadas 5.1 de 7
Epicas Completadas 22 de 28
Schemas BD 11
Tablas BD 47
Modulos Backend 17
Sistema SIMCO v3.7.0

Componentes del Sistema

Componente Tecnologia Puerto
Backend API NestJS 10.3.0 3141
Frontend Web React + Vite 3140
Mobile App React Native + Expo 8081
MCP Server TypeScript + MCP SDK 3142
WhatsApp Service NestJS + Meta API 3143
Database PostgreSQL 16+ 5432
Cache Redis 7 6379

Integraciones Principales

Servicio Tipo Estado
WhatsApp Business API Comunicacion Implementado
Stripe Pagos/Suscripciones Implementado
OpenRouter LLM Gateway Implementado
Mercado Pago Terminal Pago Pendiente

Referencias

Documentacion de Orchestration

Inventarios (SSOT)


Ultima actualizacion: 2026-01-10 Version: 1.0.0 Sistema: SIMCO v3.7.0