Onboarding para desarrolladores nuevos del proyecto Cobertura Docker. Use para explicar cómo levantar el proyecto, variables de entorno, estructura del repo, y flujo local.
docker/oracle/instantclient/)# 1. Copiar archivos sensibles
cp .env.example .env
# Editar .env con valores reales
# 2. Oracle Instant Client
mkdir -p docker/oracle/instantclient
cp -r /opt/oracle/instantclient_21_11/* docker/oracle/instantclient/
# 3. Crear carpetas
mkdir -p docker-data/output docker-data/uploads
# 4. Levantar
docker compose up --build -d
ORACLE_USER=DIGITALIZACION
ORACLE_PASSWORD=DIGITALIZACION
ORACLE_CONNECT_STRING=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=172.16.60.21)(PORT=1521))(CONNECT_DATA=(SID=PRDSGH2)))
COBERTURA_OUTPUT_DIR=/app/output
LOCAL_UID=$(id -u)
LOCAL_GID=$(id -g)
.
├── server/app.js # API + UI
├── scripts/
│ ├── batch_fetch_json.js # Fase 1: Oracle + portal → JSON
│ ├── batch_render_pdf.js # Fase 2: JSON → PDF
│ ├── query_records.js # Consulta Oracle directo
│ ├── query_live.js # Consulta portal MSP
│ └── generate_pdf.js # Render PDF
├── web/batch/public/ # UI web
├── docker/ # Oracle Instant Client
└── docker-data/ # Archivos generados (fuera del contenedor)
# Levantar
docker compose up -d
# Ver logs
docker compose logs -f
# Ver estado
docker compose ps
# Detener
docker compose down
# Inside container
docker exec -it cobertura_msp sh
# Test local (sin Docker)
npm start
/api/query-records - Consulta Oracle (lista registros)/api/fetch-json - Fase 1: consulta portal, guarda JSON/api/render-pdf - Fase 2: lee JSON, genera PDF/output/ - Archivos generadosLOCAL_UID/LOCAL_GID en .env