feat: Add poblacion_apta service to docker-compose, enhance API gateway for new service integration, and update README with service details. Introduce new database tables for poblacion_apta_jobs and poblacion_apta_rows, and implement functionality for handling cop/mod calculations in the cleaning service.

docs/database.dbml

@@ -29,6 +29,8 @@ TableGroup pipeline {
   extraction_rows
   cleaning_jobs
   cleaned_rows
+  poblacion_apta_jobs
+  poblacion_apta_rows
 }
 
 TableGroup counting {
@@ -274,3 +276,38 @@ Table cleaned_rows {
 
   Note: 'Salida del servicio de limpieza.'
 }
+
+Table poblacion_apta_jobs {
+  id varchar(36) [pk, note: 'UUID v4']
+  job_id varchar(36) [null, ref: > jobs.id, note: 'Trabajo Desktop al que pertenece']
+  status varchar(32) [not null, default: 'pending', note: 'pending | running | completed | failed']
+  request jsonb [not null, default: '{}', note: 'cleaning_job_ids, job_id']
+  log jsonb [not null, default: '[]']
+  summary jsonb [not null, default: '{}', note: 'totales paso_bot / errores / por fuente']
+  error text
+  created_at timestamptz [not null]
+  updated_at timestamptz [not null]
+
+  indexes {
+    job_id
+    status
+  }
+
+  Note: 'Consolidación y validación Verificador ST sobre una o más limpiezas.'
+}
+
+Table poblacion_apta_rows {
+  id integer [pk, increment]
+  poblacion_apta_job_id varchar(36) [not null, ref: > poblacion_apta_jobs.id]
+  cleaning_job_id varchar(36) [null, note: 'Limpieza de origen de la fila']
+  row_index integer [not null, default: 0]
+  row_json jsonb [not null, default: '{}', note: 'Schema FINAL_IT + OBSERVACION']
+  created_at timestamptz [not null]
+
+  indexes {
+    poblacion_apta_job_id
+    cleaning_job_id
+  }
+
+  Note: 'Filas del consolidado Población apta (PASO_BOT y observaciones).'
+}