Cómo funciona IngelCoding — Recorrido guiado
IngelCoding es la automatización central de Ingelsur. Este recorrido te muestra el camino completo que sigue un dato — una factura, un pedido, un parte de obra — desde que llega hasta que aparece en el dashboard de jefatura.
No necesitas saber programar para entenderlo. Cada etapa responde una pregunta de negocio.
El espinazo del sistema
Sección titulada «El espinazo del sistema»El sistema opera en cuatro etapas en cadena. Cada una tiene una responsabilidad única:
Captación → Procesamiento → Almacenamiento → ReportabilidadNinguna etapa salta a la siguiente sin haber terminado la anterior. Esto garantiza que lo que ves en los dashboards es siempre consistente con lo que entró al sistema.
Etapa 1 — Captación
Sección titulada «Etapa 1 — Captación»Pregunta que responde: ¿De dónde vienen los datos?
Por aquí entra todo: facturas y notas de crédito por correo, pedidos HES y SAP, archivos Excel de operación. Ninguno de estos datos llega tipeado a mano. El sistema los captura sin intervención humana y los deja listos para procesar.
Las fuentes actuales son tres:
- Correo corporativo (IMAP/Gmail) — facturas PDF, pedidos HES en HTML, avisos de SAP. El sistema se conecta a tres cuentas corporativas y descarga solo los correos relevantes, filtrando por remitente y asunto.
- Archivos Excel compartidos — cronogramas de brigadas, reportes de campo, saldos. Se leen desde carpetas sincronizadas con Drive.
- APIs y sistemas internos — datos de la nube (reportes de saldos, controles de OTs).
Todo lo que entra queda registrado. Si un correo llega dos veces, el sistema lo detecta y no lo procesa dos veces.
Estado actual: Captura automática desde correo y archivos — Activo (80% completo). Pendiente: reintentos automáticos en cortes de conexión.
→ Para el detalle técnico: Orquestador de Pipelines
Etapa 2 — Procesamiento
Sección titulada «Etapa 2 — Procesamiento»Pregunta que responde: ¿Qué se hace con los datos?
El corazón del sistema: los pipelines que limpian, clasifican y consolidan los datos de entrada. Cada uno produce una salida confiable que reemplaza horas de planilla — facturación, pedidos HES y SAP, valorizaciones, Gantt, cierres técnicos, pagos pendientes, costos, productividad.
Hay 10 pipelines activos, organizados en dos grupos:
Fetchers (primero, en paralelo): bajan los reportes de la nube antes de que los pipelines principales los necesiten.
Pipelines principales (en secuencia): procesan los datos ya disponibles y producen los resultados de negocio.
Cada pipeline sigue el mismo patrón: recibe datos crudos, aplica reglas de negocio y produce una salida tabular limpia. Las reglas de negocio (tarifarios, zonas, procesos) están separadas del código de transformación, lo que permite cambiarlas sin tocar el pipeline.
Estado actual: 6 pipelines de dominio activos — Activo (70% completo). Pendiente: scheduler automático y logs centralizados.
→ Para ver cada pipeline: Pipelines
Etapa 3 — Almacenamiento
Sección titulada «Etapa 3 — Almacenamiento»Pregunta que responde: ¿Dónde viven los datos procesados?
Donde viven los datos procesados. Tres lugares con propósitos distintos:
- Google Sheets — para que el equipo consulte al día. Los pipelines escriben directamente a hojas específicas después de cada ejecución. Accesible desde cualquier lugar sin necesidad de instalar nada.
- SQLite local (data warehouse) — 32 tablas, ~9 MB, el archivo histórico completo del sistema. Sirve como respaldo y como fuente para Power BI a través del Gateway.
- PostgreSQL en la nube (Supabase) — para que Power BI sirva reportes sin depender del computador del analista. En migración activa: 9 tablas ya migradas.
Cada dato que entra queda registrado con su fecha, origen y versión del pipeline que lo procesó. Esto permite auditar cualquier resultado: saber exactamente qué datos se usaron, cuándo y con qué versión del código.
Estado actual: Google Sheets + SQLite + Supabase cloud — Activo (80% completo). Pendiente: conexión Supabase a Power BI Service.
→ Para la arquitectura técnica: Arquitectura de Persistencia
Etapa 4 — Reportabilidad
Sección titulada «Etapa 4 — Reportabilidad»Pregunta que responde: ¿Cómo ve jefatura los datos?
La cara visible para jefaturas: dashboards de Power BI con calendarios, OTs, pagos pendientes e indicadores SSO. Cuatro informes segmentados por audiencia (AT consolidado, Zonal Chiloé, Zonal Osorno, SSO) que consumen los datos procesados sin fricción.
El calendario de OTs es un visual personalizado construido especialmente para Ingelsur — muestra las órdenes de trabajo en vistas de mes, semana y día con drill-down, en colores que corresponden a estado y zona.
Los informes se actualizan cuando los pipelines terminan: no hay que hacer nada a mano para que los números del dashboard reflejen el último procesamiento.
Estado actual: Dashboard Power BI con calendario personalizado — En desarrollo (40% completo). Pendiente: conexión Supabase, refresh automático en la nube.
→ Para el detalle: Arquitectura completa
Resumen de estado global
Sección titulada «Resumen de estado global»| Etapa | Estado | Avance |
|---|---|---|
| Captación | Activo | 80% |
| Procesamiento | Activo | 70% |
| Almacenamiento | Activo | 80% |
| Reportabilidad | En desarrollo | 40% |
¿Qué sigue?
Sección titulada «¿Qué sigue?»- Para entender los procesos de negocio (cobro, valorizaciones, pedidos): Guías de Negocio
- Para ver la arquitectura técnica del sistema: Arquitectura Completa
- Para explorar el grafo interactivo del sistema: Vista del grafo
Datos derivados de portal-data.json — nodos L1: l1_entrada, l1_proceso, l1_datos, l1_reporte.