rckrdmrd
2c916e75e5
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>
141 lines
6.6 KiB
Markdown
141 lines
6.6 KiB
Markdown
# _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](./INT-001-whatsapp-meta.md) | Meta | Comunicacion | Activo | WhatsApp Business API |
|
|
| [INT-002-stripe.md](./INT-002-stripe.md) | Stripe | Pagos | Activo | Suscripciones y pagos |
|
|
| [INT-003-openrouter.md](./INT-003-openrouter.md) | OpenRouter | LLM | Activo | Gateway LLM multi-modelo |
|
|
| [INT-004-mercadopago.md](./INT-004-mercadopago.md) | MercadoPago | Terminal | Pendiente | Terminal de pago |
|
|
| [INT-005-clip.md](./INT-005-clip.md) | Clip Mexico | Terminal | Mock | Terminal pagos con tarjeta |
|
|
| [INT-006-codi-banxico.md](./INT-006-codi-banxico.md) | Banxico/STP | Pagos QR | Mock | Pagos CoDi/SPEI |
|
|
| [INT-007-firebase-fcm.md](./INT-007-firebase-fcm.md) | Firebase | Notificaciones | Pendiente | Push notifications |
|
|
| [INT-008-google-vision.md](./INT-008-google-vision.md) | Google Cloud | OCR | Pendiente | Vision OCR productos |
|
|
| [INT-009-whisper.md](./INT-009-whisper.md) | OpenAI | Speech-to-Text | Pendiente | Transcripcion audio |
|
|
| [INT-010-email-providers.md](./INT-010-email-providers.md) | SendGrid/SES/SMTP | Email | Planificado | Email multi-proveedor |
|
|
| [INT-011-storage-cloud.md](./INT-011-storage-cloud.md) | S3/R2/MinIO | Storage | Planificado | Almacenamiento cloud |
|
|
| [INT-012-oauth-social.md](./INT-012-oauth-social.md) | Google/Apple | Auth | Planificado | OAuth 2.0 social login |
|
|
| [INT-013-redis-cache.md](./INT-013-redis-cache.md) | Redis | Infraestructura | Planificado | Cache y queues |
|
|
| [INT-014-webhooks-outbound.md](./INT-014-webhooks-outbound.md) | BullMQ | Eventos | Planificado | Webhooks salientes |
|
|
|
|
---
|
|
|
|
## Navegacion por Tipo
|
|
|
|
### Comunicacion
|
|
1. [INT-001 - WhatsApp Meta](./INT-001-whatsapp-meta.md) - Canal principal
|
|
2. [INT-007 - Firebase FCM](./INT-007-firebase-fcm.md) - Push notifications
|
|
|
|
### Pagos
|
|
1. [INT-002 - Stripe](./INT-002-stripe.md) - Suscripciones
|
|
2. [INT-004 - MercadoPago](./INT-004-mercadopago.md) - Terminal
|
|
3. [INT-005 - Clip](./INT-005-clip.md) - Terminal tarjetas
|
|
4. [INT-006 - CoDi/Banxico](./INT-006-codi-banxico.md) - Pagos QR
|
|
|
|
### IA/ML
|
|
1. [INT-003 - OpenRouter](./INT-003-openrouter.md) - LLM Gateway
|
|
2. [INT-008 - Google Vision](./INT-008-google-vision.md) - OCR
|
|
3. [INT-009 - Whisper](./INT-009-whisper.md) - Speech-to-Text
|
|
|
|
### Notificaciones
|
|
1. [INT-010 - Email Providers](./INT-010-email-providers.md) - Email transaccional
|
|
|
|
### Almacenamiento
|
|
1. [INT-011 - Storage Cloud](./INT-011-storage-cloud.md) - S3/R2/MinIO
|
|
|
|
### Autenticacion
|
|
1. [INT-012 - OAuth Social](./INT-012-oauth-social.md) - Google/Apple
|
|
|
|
### Infraestructura
|
|
1. [INT-013 - Redis Cache](./INT-013-redis-cache.md) - Cache y queues
|
|
2. [INT-014 - Webhooks Outbound](./INT-014-webhooks-outbound.md) - 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
|
|
|
|
```env
|
|
# 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
|
|
|
|
- [SIMCO-INTEGRACIONES-EXTERNAS.md](../../../../orchestration/directivas/simco/SIMCO-INTEGRACIONES-EXTERNAS.md)
|
|
- [TEMPLATE-INTEGRACION-EXTERNA.md](../../../../orchestration/templates/TEMPLATE-INTEGRACION-EXTERNA.md)
|
|
- [Arquitectura Multi-Tenant](../90-transversal/ARQUITECTURA-MULTI-TENANT-INTEGRACIONES.md)
|
|
|
|
---
|
|
|
|
**Mantenido por:** Documentation Team
|
|
**Version:** 2.0.0
|
|
**Total Integraciones:** 14 (INT-001 a INT-014)
|