resumen-maestro

name	resumen-maestro
description	Resumen ejecutivo del proyecto Cobertura Docker para MSP Ecuador. Use cuando se pregunte qué es el proyecto, para qué sirve, cuál es el estado actual, o qué módulos tiene.

Resumen Maestro - Cobertura Docker

Qué es

Sistema de consulta batch de cobertura de salud del MSP Ecuador. Consulta Oracle, obtiene datos del portal MSP, genera PDFs y archivos JSON con evidencia de cobertura.

Stack

• Runtime: Node.js 20 + Express
• Base de datos: Oracle RAC 11g (SID: PRDSGH2)
• Contenedor: Docker + docker-compose
• Generación PDF: pdfkit + svg-to-pdfkit
• Cliente Oracle: Instant Client montado como volumen

Arquitectura

Oracle → batch_fetch_json.js → JSON/
                                   → batch_render_pdf.js → PDF/
                                   → server/app.js (UI + API)

Módulos principales

Archivo	Función
server/app.js	API REST + UI batch + SSE streaming
scripts/batch_fetch_json.js	Fase 1: consulta Oracle + portal, guarda JSON
scripts/batch_render_pdf.js	Fase 2: lee JSON, genera PDF
scripts/query_records.js	Consulta Oracle DIRECTO (sin portal)
scripts/query_live.js	Consulta portal MSP con retry
scripts/generate_pdf.js	Render SVG → PDF

Endpoints

• GET /health - Salud del servicio
• POST /api/query-records - Consulta Oracle directo
• POST /api/fetch-json - Fase 1 batch
• POST /api/render-pdf - Fase 2 batch
• GET /api/stream - SSE para progress
• GET /output/ - Archivos generados

Volúmenes

• ./docker-data/output → /app/output (PDFs, JSONs, SVGs)
• ./docker/oracle/instantclient → /opt/oracle/instantclient

Estados

• Pendiente: UI web para dos fases, documentación completa
• Listo: Batch funcional, Docker funcional