IPSExtractor/services/poblacion_apta/README.md

poblacion_apta

Microservicio Python (FastAPI) que consolida varias limpiezas y aplica las validaciones de Verificador_ST para producir la Población apta (registros PASO_BOT).

Puerto

8003

Endpoints

Método	Ruta	Descripción
GET	/health	Liveness
POST	/jobs	Crear job desde cleaning_job_ids (+ job_id Desktop)
POST	/jobs/from-csv	Crear job desde uno o varios CSV (multipart)
GET	/jobs?job_id=	Listar jobs
GET	/jobs/{id}	Detalle + summary
GET	/jobs/{id}/rows	Filas (observacion opcional)
GET	/jobs/{id}/export.csv?subset=aptos|no_aptos	CSV | aptos o no aptos

Crear un job desde limpiezas

POST /jobs
{
  "job_id": "...",
  "cleaning_job_ids": ["uuid-limpieza-1", "uuid-limpieza-2"]
}

Crear un job desde CSV

POST /jobs/from-csv
# multipart/form-data
# files: uno o más .csv
# job_id: (opcional) UUID del trabajo Desktop

Variables de entorno

Variable	Descripción
DATABASE_URL	PostgreSQL (postgresql+psycopg://...)