rckrdmrd
928eb795e6
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8 - Cambios en backend y frontend Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
122 lines
5.5 KiB
Markdown
122 lines
5.5 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 | 9 |
|
|
| Documentadas | 9 |
|
|
| Implementadas | 4 |
|
|
| En desarrollo | 2 |
|
|
| Pendientes | 3 |
|
|
| 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
|
|
|
|
---
|
|
|
|
## 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
|
|
|
|
---
|
|
|
|
## 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:** 1.0.0
|