api_gateway
Puerta de enlace HTTP (FastAPI) que actúa como punto de entrada único para el sistema IPSExtractor. Enruta las peticiones del cliente hacia los microservicios internos sin lógica de negocio propia.
Puerto
8189 en el host (mapeado al 8000 interno del contenedor). Es el único puerto publicado por docker-compose.
Enrutamiento
| Ruta cliente | Servicio destino | Descripción |
|---|---|---|
GET /health/live |
(local) | Liveness sin consultar upstreams |
GET /health |
Agrega /health de los tres servicios |
Estado del sistema |
GET /models |
extraction:8001/models |
Modelos LLM disponibles |
GET /config |
extraction:8001/config + cleaning:8002/rules |
Configuración |
/extraction/{path} |
extraction:8001/{path} |
Extracción (quita prefijo) |
/tasks/{path} |
extraction:8001/tasks/{path} |
Tareas de extracción |
/jobs/{path} |
extraction:8001/jobs/{path} |
Jobs |
/count-jobs/{path} |
extraction:8001/count-jobs/{path} |
Jobs de conteo |
/cleaning/{path} |
cleaning:8002/{path} |
Limpieza |
/count/{path} |
count-api:8080/{path} |
Conteo OCR+ML (quita prefijo) |
El proxy reenvía método, query string, headers y body sin modificaciones.
Timeouts: JSON 30s lectura; uploads /count/* e ingest 600s.
Variables de entorno
| Variable | Default | Descripción |
|---|---|---|
EXTRACTION_URL |
http://extraction:8001 |
URL interna del servicio extraction |
CLEANING_URL |
http://cleaning:8002 |
URL interna del servicio cleaning |
COUNT_URL |
http://count-api:8080 |
URL interna del servicio count-api |
CORS
Solo permite orígenes localhost y 127.0.0.1. Sin autenticación.
Estructura del código
api/
main.py — FastAPI app con proxy HTTP (httpx)
Dockerfile
requirements.txt — fastapi, httpx, uvicorn
Arrancar localmente
docker compose up --build api_gateway
API disponible en http://127.0.0.1:8189 (único puerto expuesto por docker-compose).