# _MAP: Integraciones Externas

**Ultima actualizacion:** 2025-12-05
**Estado:** Activo

---

## Proposito

Esta carpeta contiene documentacion de todas las integraciones con sistemas externos, APIs de terceros, y conexiones con brokers. Cada integracion incluye especificacion tecnica y analisis de impacto.

---

## Integraciones Documentadas

| ID | Nombre | Descripcion | Estado |
|----|--------|-------------|--------|
| INT-DATA-001 | [Data Service](./INT-DATA-001-data-service.md) | Integracion con Polygon/Massive API, MetaTrader 4, modelo de precios y spreads | ✅ Implementado |
| INT-DATA-002 | [Analisis Impacto](./INT-DATA-002-analisis-impacto.md) | Analisis de impacto del Data Service en otros modulos | ✅ Validado |

---

## Resumen de Componentes

### Data Service (INT-DATA-001)

```
apps/data-service/
├── src/
│   ├── providers/
│   │   ├── polygon_client.py    # API Polygon.io/Massive.com
│   │   └── mt4_client.py        # MetaTrader 4/MetaAPI
│   ├── services/
│   │   └── price_adjustment.py  # Modelo de ajuste de precios
│   ├── config.py                # Configuracion
│   └── main.py                  # Entry point
├── requirements.txt
└── .env.example
```

### Tablas de Base de Datos

| Schema | Tablas | Proposito |
|--------|--------|-----------|
| `data_sources` | 3 | Proveedores API, mappings, sync status |
| `broker_integration` | 5 | Cuentas MT4, precios broker, spreads, trades |

### APIs Externas

| API | Proposito | Plan |
|-----|-----------|------|
| Polygon.io | Datos historicos y tiempo real | Currencies Basic ($0) |
| MetaAPI.cloud | Conexion MT4/MT5 sin terminal | Free tier |

---

## Proximas Integraciones Planificadas

| ID | Nombre | Descripcion | Prioridad |
|----|--------|-------------|-----------|
| INT-PAY-001 | Stripe | Integracion de pagos y suscripciones | Alta |
| INT-LLM-001 | Claude API | Integracion del agente LLM | Media |
| INT-NOTIF-001 | Notificaciones | Push, email, SMS | Media |

---

## Referencias

- [DATABASE_INVENTORY.yml](../inventarios/DATABASE_INVENTORY.yml) - Inventario completo de BD
- [ARQUITECTURA-UNIFICADA.md](../../01-arquitectura/ARQUITECTURA-UNIFICADA.md) - Arquitectura del sistema
- [ET-ML-005-integracion.md](../../02-definicion-modulos/OQI-006-ml-signals/especificaciones/ET-ML-005-integracion.md) - Integracion ML Engine

---

*Indice de integraciones - Sistema NEXUS*
*Ultima actualizacion: 2025-12-05*
