rckrdmrd/michangarrito
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
michangarrito/docs/02-integraciones/_MAP.md
rckrdmrd 2c916e75e5 [SIMCO-V4] feat: Agregar documentación SaaS, ADRs e integraciones 
Nuevas Épicas (MCH-029 a MCH-033):
- Infraestructura SaaS multi-tenant
- Auth Social (OAuth2)
- Auditoría Empresarial
- Feature Flags
- Onboarding Wizard

Nuevas Integraciones (INT-010 a INT-014):
- Email Providers (SendGrid, Mailgun, SES)
- Storage Cloud (S3, GCS, Azure)
- OAuth Social
- Redis Cache
- Webhooks Outbound

Nuevos ADRs (0004 a 0011):
- Notifications Realtime
- Feature Flags Strategy
- Storage Abstraction
- Webhook Retry Strategy
- Audit Log Retention
- Rate Limiting
- OAuth Social Implementation
- Email Multi-provider

Actualizados:
- MASTER_INVENTORY.yml
- CONTEXT-MAP.yml
- HERENCIA-SIMCO.md
- Mapas de documentación

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 01:43:15 -06:00

6.6 KiB
Raw Permalink Blame History

_MAP: Integraciones Externas

Carpeta: docs/02-integraciones/ Proposito: Documentacion de integraciones con servicios externos Estado: Actualizado Ultima actualizacion: 2026-01-10

Resumen

Metrica Valor
Total integraciones 14
Documentadas 14
Implementadas 4
En desarrollo 2
Pendientes 8
Progreso 100% documentado

Contenido

Todas las Integraciones

Archivo Proveedor Tipo Estado Descripcion
INT-001-whatsapp-meta.md Meta Comunicacion Activo WhatsApp Business API
INT-002-stripe.md Stripe Pagos Activo Suscripciones y pagos
INT-003-openrouter.md OpenRouter LLM Activo Gateway LLM multi-modelo
INT-004-mercadopago.md MercadoPago Terminal Pendiente Terminal de pago
INT-005-clip.md Clip Mexico Terminal Mock Terminal pagos con tarjeta
INT-006-codi-banxico.md Banxico/STP Pagos QR Mock Pagos CoDi/SPEI
INT-007-firebase-fcm.md Firebase Notificaciones Pendiente Push notifications
INT-008-google-vision.md Google Cloud OCR Pendiente Vision OCR productos
INT-009-whisper.md OpenAI Speech-to-Text Pendiente Transcripcion audio
INT-010-email-providers.md SendGrid/SES/SMTP Email Planificado Email multi-proveedor
INT-011-storage-cloud.md S3/R2/MinIO Storage Planificado Almacenamiento cloud
INT-012-oauth-social.md Google/Apple Auth Planificado OAuth 2.0 social login
INT-013-redis-cache.md Redis Infraestructura Planificado Cache y queues
INT-014-webhooks-outbound.md BullMQ Eventos Planificado Webhooks salientes

Navegacion por Tipo

Comunicacion

  1. INT-001 - WhatsApp Meta - Canal principal
  2. INT-007 - Firebase FCM - Push notifications

Pagos

  1. INT-002 - Stripe - Suscripciones
  2. INT-004 - MercadoPago - Terminal
  3. INT-005 - Clip - Terminal tarjetas
  4. INT-006 - CoDi/Banxico - Pagos QR

IA/ML

  1. INT-003 - OpenRouter - LLM Gateway
  2. INT-008 - Google Vision - OCR
  3. INT-009 - Whisper - Speech-to-Text

Notificaciones

  1. INT-010 - Email Providers - Email transaccional

Almacenamiento

  1. INT-011 - Storage Cloud - S3/R2/MinIO

Autenticacion

  1. INT-012 - OAuth Social - Google/Apple

Infraestructura

  1. INT-013 - Redis Cache - Cache y queues
  2. INT-014 - Webhooks Outbound - Eventos salientes

Arquitectura de Integraciones

┌─────────────────────────────────────────────────────────────┐
│                     MICHANGARRITO                           │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │              BACKEND (NestJS)                        │   │
│  │                                                      │   │
│  │  ┌──────────────┐  ┌──────────────┐  ┌──────────┐   │   │
│  │  │ WhatsApp     │  │ Subscriptions│  │ LLM      │   │   │
│  │  │ Module       │  │ Module       │  │ Module   │   │   │
│  │  └──────┬───────┘  └──────┬───────┘  └────┬─────┘   │   │
│  └─────────┼─────────────────┼───────────────┼─────────┘   │
│            │                 │               │              │
│            ▼                 ▼               ▼              │
│  ┌─────────────────┐ ┌─────────────┐ ┌────────────────┐    │
│  │ META WHATSAPP   │ │   STRIPE    │ │  OPENROUTER    │    │
│  │ BUSINESS API    │ │             │ │                │    │
│  │ - Mensajes      │ │ - Checkout  │ │ - Claude       │    │
│  │ - Webhooks      │ │ - Customer  │ │ - GPT-4        │    │
│  │ - Templates     │ │ - Invoice   │ │ - Mistral      │    │
│  └─────────────────┘ └─────────────┘ └────────────────┘    │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Variables de Entorno Requeridas

# WhatsApp (INT-001)
WHATSAPP_PHONE_NUMBER_ID=xxxxx
WHATSAPP_ACCESS_TOKEN=xxxxx
WHATSAPP_VERIFY_TOKEN=xxxxx
WHATSAPP_APP_SECRET=xxxxx

# Stripe (INT-002)
STRIPE_API_KEY=sk_xxxxx
STRIPE_WEBHOOK_SECRET=whsec_xxxxx

# OpenRouter (INT-003)
OPENROUTER_API_KEY=xxxxx

# MercadoPago (INT-004)
MERCADOPAGO_ACCESS_TOKEN=xxxxx

Referencias

Mantenido por: Documentation Team Version: 2.0.0 Total Integraciones: 14 (INT-001 a INT-014)