CEA Smart — Cómo se guardan, se consumen y se presentan los datos

Documento para revisión · Versión 1 · 7 de agosto de 2026

Para qué es este documento

La app nueva deja de entregar el trabajo de CEA como archivos Word y Excel, y pasa a entregarlo como datos. Este documento describe qué datos se guardan, cómo se estructuran, de dónde salen y cómo se muestran.

No es un documento técnico. No hay tablas de base de datos ni tipos de campo. Lo que está acá es el modelo del negocio: si algo de lo que CEA hace hoy no se puede expresar con este modelo, es un problema de diseño y hay que corregirlo ahora, antes de escribir código.

Cómo revisarlo, en orden de utilidad:

1. La jerarquía de clientes (sección 2) es lo más importante. Es la estructura sobre la que se apoya todo lo demás: permisos, gráficos, informes y facturación.
2. Los dos casos reales (sección 9) muestran cómo quedan representados Trivium y Asofarma. Si algo del Excel actual no aparece ahí, falta.
3. Las preguntas abiertas (sección 10) son decisiones que todavía no tomamos y necesitan tu criterio.

Cada sección usa como ejemplo un caso real que ya conocés. Donde el modelo tiene una limitación, está dicho explícitamente.

1. Qué cambia respecto de hoy

Hoy el informe es el producto: un Excel con los datos adentro, las fórmulas adentro y el formato adentro. Todo junto en un archivo.

En el sistema nuevo esas tres cosas se separan:

Qué gana el negocio con esa separación:

• El mismo dato sirve para todo. Una medición alimenta el gráfico de la pantalla, el informe mensual, la comparativa anual y la alerta de desvío. Hoy hay que actualizarlo en cada lugar.
• Nada se recalcula solo hacia atrás. Un informe emitido en marzo sigue diciendo lo mismo en diciembre, aunque la línea de base haya cambiado en el medio.
• Se puede consultar desde el móvil, presentar en pantalla completa y exportar a PDF, sin rehacer el trabajo tres veces.
• Agregar un cliente nuevo no es copiar un Excel y renombrarlo. Es cargar su estructura.

2. La jerarquía de clientes

Es la parte más importante del modelo. Cuatro niveles.

graph TD
    A["CLIENTE<br/>Trivium Packaging Argentina S.A."] --> B["SITIO<br/>Planta Pilar"]
    A --> C["SITIO<br/>Planta Buenos Aires"]
    B --> D["PUNTO DE MEDICIÓN<br/>Suministro eléctrico principal"]
    B --> E["PUNTO DE MEDICIÓN<br/>Suministro de gas"]
    D --> F["Línea 5"]
    D --> G["Línea 6 … Línea 13"]
    D --> H["Compresor 1 … Compresor 5"]
    D --> I["Total compresores<br/>(calculado)"]

Nivel 1 — Cliente

La empresa que contrata a CEA. También puede ser un hogar: es la misma estructura con un solo sitio y un solo punto.

Es la unidad de aislamiento (ningún cliente ve datos de otro, garantizado por el sistema, no por cuidado del programador) y de facturación.

Qué se guarda: nombre, CUIT, país, moneda, zona horaria por defecto, y el segmento (gran usuario / pyme / hogar), que determina qué módulos se habilitan.

Nivel 2 — Sitio

Una ubicación física: planta, sucursal, oficina, depósito o domicilio. Un cliente puede tener todos los sitios que necesite.

Qué se guarda: nombre, dirección, coordenadas, zona horaria y zona de red eléctrica.

Dos datos que parecen menores y no lo son:

• La zona horaria se guarda en el sitio, no en el cliente ni en el usuario. El consumo de una planta pertenece al día de la planta, no al día de quien mira la pantalla. Una empresa con plantas en Argentina y en México tiene dos husos, y "el consumo de enero" significa cosas distintas en cada una.
• La zona de red eléctrica determina el factor de emisión de CO₂ y el mix de generación (térmica / nuclear / renovable). No es un número global: el mismo consumo en distintas regiones tiene distinta huella de carbono.

Nivel 3 — Punto de medición

Acá está la decisión de diseño más importante y sobre la que más quiero tu opinión.

Un punto de medición es cualquier cosa que produce una serie de datos de energía. Hay cuatro tipos, y todos se tratan igual:

Por qué son todos el mismo concepto: un punto de suministro y un compresor instrumentado son ambos cosas que generan una serie de consumo en el tiempo. Si los tratáramos como cosas distintas, habría que escribir dos veces los gráficos, dos veces los indicadores, dos veces la línea de base y dos veces los permisos. Con un solo concepto, todo lo que sirve para un punto de suministro sirve automáticamente para una máquina.

Los puntos cuelgan unos de otros. Las Líneas 5 a 13 y los Compresores 1 a 5 de Trivium cuelgan del suministro principal. Eso permite:

• ver el consumo total de la planta, o abrir y ver de dónde viene;
• comparar el peso de cada línea sobre el total;
• detectar cuando la suma de los submedidores se aleja del general (pérdidas o un medidor mal).

El vector energético (electricidad, gas, agua, vapor, combustible) es una característica del punto, no un árbol aparte. Un mismo sitio tiene puntos de electricidad y puntos de gas conviviendo, y el sistema puede sumarlos en unidades equivalentes cuando hace falta.

Qué se guarda de cada punto: nombre, tipo, vector, código de identificación (NIS eléctrico, número de cliente ENARGAS, TAG interno), ubicación física ("TGBT", "Compresor 3"), frecuencia de lectura esperada, responsable de la lectura, y si es un USEn (uso significativo de la energía, concepto formal de ISO 50001).

Los tres últimos salen directamente de la hoja de puntos de lectura del Excel de Trivium, que hoy es una tabla suelta sin conexión con los datos.

Ojo con el "de energía" de la definición: temperatura, humedad y producción no son puntos de medición. Van en un lugar aparte, explicado más abajo.

Nivel 4 — Dispositivo

El aparato físico que mide: medidor, analizador de red, PLC, gateway.

Se guarda separado del punto de medición a propósito. Un medidor se rompe y se cambia, pero el punto sigue siendo el mismo: el suministro eléctrico de Planta Pilar es el mismo antes y después del recambio. Si mezcláramos las dos cosas, cambiar un equipo cortaría la serie histórica de años.

El sistema registra desde cuándo y hasta cuándo cada dispositivo estuvo asignado a cada punto. Eso es lo que permite explicar un salto en el contador sin contarlo como consumo.

Un punto, muchas magnitudes

Un punto de medición no produce un número por período: produce varios a la vez. Una factura trae los kWh del mes, pero un analizador de red conectado a una máquina reporta decenas de magnitudes en paralelo, todas del mismo punto.

Todo eso es el mismo punto de medición: "Compresor 3" es uno solo. Lo que tiene son varias magnitudes, cada una con su serie de datos en el tiempo. El punto es el qué; la magnitud es el qué se mide de eso.

Cada magnitud trae dos datos propios que el sistema necesita saber:

Esa segunda columna es la clave: sin ella el sistema promedia energía o suma tensiones, y los dos resultados son basura. Es la razón por la que las magnitudes no pueden ser simplemente "más puntos": necesitan que el sistema sepa qué es cada una.

Cada punto tiene una magnitud principal — la que se factura y la que aparece cuando alguien abre el punto sin pedir nada más: energía activa en electricidad, m³ en gas. El resto está disponible, se grafica y se alerta, pero no compite con ella: el "consumo de Planta Pilar" sigue siendo un número sin ambigüedad.

Qué habilita tener las otras magnitudes, más allá de guardarlas:

• Coseno φ bajo → recargo por energía reactiva en la factura. Es plata que se recupera con un banco de capacitores, y hoy no se ve en ningún Excel.
• Desbalance entre fases → una fase cargada y otra ociosa: se corrige redistribuyendo, sin invertir un peso.
• Tensión fuera de rango → reclamo a la distribuidora, con la serie histórica como prueba.
• Horas de marcha contra energía → cuánto consume el compresor por hora encendido, que es la medida real de si se está degradando.

Eso no es guardar datos por completitud: es la materia prima de recomendaciones que se cobran.

Lo que no es un punto de medición: las variables

La temperatura, la humedad, la producción del mes, los grados-día, las horas trabajadas y los turnos también son mediciones — pero no son puntos de medición. Son variables, y viven en un lugar aparte del modelo.

La diferencia no es de dónde sale el dato, sino para qué sirve:

Dicho corto: si se factura o se consume, es un punto; si sirve para explicar por qué se consumió eso, es una variable.

Por qué separarlas y no meter todo en el mismo saco: si la temperatura fuera un punto de medición más, aparecería sumada en el consumo total de la planta, tendría precio unitario, huella de carbono y línea de base propia. Nada de eso tiene sentido. Al revés también: una variable se puede compartir entre puntos — la temperatura de CABA explica a la vez la electricidad y el gas de Asofarma — y un punto no funciona así.

Cada variable guarda su valor por período (igual que las mediciones: desde/hasta, valor, unidad, calidad y origen), y su alcance: a qué llega.

Que el alcance sea global es lo que evita cargar la temperatura de Buenos Aires una vez por cada cliente que la necesite: se trae una sola vez y cada sitio la toma de la estación que le corresponde por cercanía.

Cómo se cruza esto con las magnitudes de la sección anterior. Si el analizador del Compresor 3 reporta temperatura, ese dato se guarda como una magnitud más de ese punto — es lo que el aparato midió, y ahí queda registrado con su origen. Si además esa temperatura se usa para normalizar una línea de base, se declara una variable que se alimenta de esa serie.

No son dos copias del dato: el dato se guarda una vez, y la variable dice "para normalizar, usá esta serie". Lo mismo si mañana la temperatura viene de una estación meteorológica en vez del sensor: cambia de dónde se alimenta la variable, no la línea de base ni los informes.

Dicho de otro modo: magnitud es lo que el aparato midió; variable es el rol que ese número cumple en un cálculo. El mismo número puede ser las dos cosas.

Cómo se ve un hogar

La misma estructura, más chica:

graph TD
    A["CLIENTE<br/>Familia Pérez (hogar)"] --> B["SITIO<br/>Domicilio"]
    B --> C["PUNTO DE MEDICIÓN<br/>Medidor eléctrico"]
    B --> D["PUNTO DE MEDICIÓN<br/>Medidor de gas"]
    B --> E["PUNTO DE MEDICIÓN<br/>Cargador del auto eléctrico"]
    C --> F["Resto de la casa<br/>(calculado)"]

No es un sistema aparte ni un modo reducido: es el mismo recorrido con menos elementos cargados.

El cargador del auto eléctrico es el mejor ejemplo de por qué el modelo es así. Hoy ya se puede pedir un suministro aparte para el cargador — con su propio medidor y su propia tarifa —, o dejarlo colgado del medidor de la casa con un submedidor propio. El modelo cubre las dos formas sin cambiar nada:

En los dos primeros casos entra en el mismo informe del hogar, junto a la electricidad y el gas. Y aparece el "resto de la casa" como punto calculado — medidor general menos cargador —, que es exactamente el tipo de pregunta que un cliente hogareño hace: ¿cuánto de mi factura es el auto y cuánto es la casa?

Eso da además tres cosas que hoy nadie le entrega a un hogar: el costo por kilómetro del auto si se carga la variable de kilómetros recorridos, la comparación contra lo que costaría el mismo recorrido en nafta, y si conviene cargar en horario nocturno cuando hay tarifa diferenciada.

3. Quién ve qué

Un cliente empresa puede tener muchos usuarios con distintos alcances. El permiso se otorga sobre una parte de la estructura, y alcanza automáticamente a todo lo que cuelga de ella.

Tres reglas que importan al negocio:

• El permiso se hereda hacia abajo. Dar acceso a un sitio alcanza a los puntos que se agreguen después. No hay que actualizar permisos cada vez que se instala un medidor.
• Sin permiso explícito no hay acceso. No existen reglas de "ve todo menos esto": son imposibles de auditar y es donde aparecen los agujeros.
• El permiso es sobre la entidad, no sobre un nombre o una ruta. Renombrar una planta no cambia quién la ve. (En el sistema actual los permisos son por prefijo de carpeta, y por eso ACME da acceso a ACME-Confidencial.)

El mismo mecanismo cubre los documentos: una carpeta se comparte igual que una planta.

4. Qué se guarda de una medición

Un número solo no sirve. De cada dato se guarda:

Por qué el período es desde/hasta y no "mes": el período de Asofarma va del 18 al 17 de cada mes, no del 1 al 31. Si el sistema guardara "mes = 4", no habría forma de representar eso sin inventar una regla especial. Con desde/hasta, el período del cliente es el que sea.

Por qué la calidad y el origen son obligatorios: en dos años, nadie va a recordar si un valor lo emitió un medidor o lo tipeó una persona. En una auditoría ISO 50001, un indicador mal calculado sin poder explicar de dónde salió el dato es un problema serio.

Lecturas de contador y consumos

Se guardan las dos cosas, porque llegan de fuentes distintas:

• Lectura de contador: el índice acumulado que muestra un medidor. Es lo que reportan los sensores.
• Consumo del período: lo que consumió entre dos fechas. Es lo que traen las facturas y los Excel actuales.

El sistema deriva el consumo a partir de las lecturas cuando la fuente es un medidor, manejando los reseteos del contador y los recambios de equipo. Guardar las dos cosas permite recalcular si la derivación tuvo un error, y auditar contra el medidor físico.

Datos agregados

Cuando lleguen sensores reportando por minuto o por segundo, el volumen es enorme: un solo punto reportando cada segundo genera más de 31 millones de datos por año.

Por eso el sistema calcula y guarda resúmenes por hora, por día y por mes, y las pantallas e informes consultan siempre esos resúmenes, nunca el dato crudo. El dato crudo se conserva un tiempo acotado y después se descarta, conservando los resúmenes.

Cada resumen guarda además qué porcentaje del período tenía dato. Es importante: un mes con la mitad de las mediciones no se muestra como un mes de bajo consumo — se muestra el hueco.

5. La línea de base (LBEn)

Hoy la LBEn vive como una fórmula escrita dentro de las celdas del Excel. En el sistema nuevo es un dato guardado, con vigencia.

De cada línea de base se guarda: a qué punto y vector aplica, desde cuándo y hasta cuándo rige, la constante, las variables con sus coeficientes, el R², el período de datos con el que se calculó y la justificación escrita.

Asofarma, electricidad:

Y = 155.191,52 + 19.896,19 × temperatura + 4.609,29 × humedad

Se guarda como: constante 155.191,52 · variable temperatura con coeficiente 19.896,19 · variable humedad con coeficiente 4.609,29.

Trivium, electricidad:

2018 a 2023:   Y = 41,108 × producción + 274.762
2024 en adelante:  Y = 31,25 × producción + 562.762,65

Se guarda como dos líneas de base del mismo punto con vigencias distintas. Hoy en el Excel esto es una condición escrita dentro de la fórmula (SI el año es menor o igual a 2023…), que es el lugar más probable donde se cuele un error.

Qué habilita guardarlo así:

• El sistema calcula la regresión. Hoy alguien la corre aparte y pega los coeficientes a mano.
• Avisa cuando la línea de base se degrada. Si el R² empieza a caer, hubo un cambio estructural en la planta y corresponde renormalizar. Eso es un aviso automático y una oportunidad de consultoría.
• Los informes viejos no cambian. Cada indicador calculado guarda qué versión de línea de base usó. Si en 2027 se recalibra la LBEn de Trivium, el informe de marzo de 2026 sigue diciendo exactamente lo mismo.

Este último punto es, a mi juicio, el más importante de todo el modelo para la credibilidad del servicio.

6. Los indicadores (IDEn)

Un indicador se define una vez y se calcula solo en cada período. De cada uno se guarda: qué se divide por qué, el factor de escala, la unidad, el tipo de período y el objetivo.

De cada cálculo mensual se guarda: el valor, el valor que daba la línea de base, el desvío en porcentaje, qué línea de base se usó, y qué porcentaje del período tenía datos.

El desvío es lo que se grafica, lo que dispara alertas y lo que se presenta al cliente.

Costos y huella de carbono

• Costos: importe del período, moneda, y el precio unitario ($/kWh, $/m³) — el "monómico" que hoy Asofarma calcula a mano. Se guarda con el enlace a la factura en PDF que lo respalda, de modo que del número se puede ir al documento original.
• Huella de carbono: toneladas de CO₂ equivalente, con el factor de emisión y el mix de generación exactos que se usaron. Ese dato viene de afuera y cambia todos los meses; guardarlo junto al cálculo es lo que hace el número defendible ante una auditoría.

7. De dónde salen los datos

Cuatro caminos, un mismo destino:

graph LR
    A["Carga manual"] --> S["Revisión<br/>y validación"]
    B["Factura por OCR"] --> S
    C["Sensores"] --> S
    D["APIs externas"] --> S
    S --> M["Mediciones<br/>del sistema"]

Ningún dato entra directo. Todo pasa por una etapa intermedia donde se valida antes de incorporarse.

El OCR de facturas es el de mayor valor inmediato: elimina la carga manual más costosa y trae los datos económicos que hoy se cargan a mano. Pero nunca aplica automáticamente — la revisión humana es parte del diseño, no una etapa transitoria.

Datos externos

Los Excel actuales ya dependen de tres fuentes externas:

Dos reglas de diseño:

• Nada se consulta en vivo. Todo se trae y se guarda. Si CAMMESA se cae, el sistema sigue funcionando con el último dato conocido, mostrando de cuándo es.
• Los precios se guardan con su publicación y su vigencia. Un cuadro tarifario se publica con vigencia retroactiva y a veces se corrige. Si guardáramos sólo "el precio", los informes históricos cambiarían solos.

8. Cómo se presenta

En pantalla

Mismo dato, distinta densidad según el dispositivo:

• Móvil: una métrica por pantalla, scroll vertical, gestos. Pensado para consultar algo puntual estando fuera de la oficina.
• Escritorio: grilla de paneles, comparación lado a lado, tablas anchas, exportación. Pensado para analizar.

Lo que no se hace es diseñar en escritorio y encoger.

Los informes

Un informe es una lista ordenada de bloques — gráficos, tablas, indicadores, textos, comparativas — con su período y su alcance. No es una pantalla fija.

Al ser un objeto guardado, la misma definición se muestra de cuatro maneras:

1. como pantalla en la app;
2. como presentación a pantalla completa, avanzando bloque a bloque, sin barras ni menús, para la reunión con el cliente;
3. como PDF exportable;
4. publicado al cliente, con aviso.

Además, un informe se puede plantillar: "Informe mensual SGEn" se define una vez y se instancia por cliente y por período. Es lo que hoy es copiar el Excel del mes pasado y renombrarlo.

Al publicarse, un informe congela sus datos. Nunca cambia después, aunque cambien la línea de base o los datos de origen.

Alertas

El sistema avisa sin que nadie tenga que entrar a mirar: desvío de la línea de base por encima de un umbral, objetivo de IDEn incumplido, un punto sin datos hace demasiado tiempo, consumo fuera de rango, informe listo.

Cada usuario elige por qué canal recibe cada tipo (correo, notificación push, dentro de la app).

9. Los dos casos reales, completos

Trivium Packaging — Planta Pilar

Asofarma

Lo que quiero que verifiques: si algo de estos dos Excel no aparece en las tablas de arriba, o aparece distinto de como se usa en la realidad, es exactamente lo que hay que corregir.

10. Preguntas abiertas

Necesitamos tu criterio en estas. La primera va explicada porque necesita contexto; el resto son de una línea.

1. Potencia eléctrica

Todo lo que describe este documento trata la energía como energía consumida: kWh que se acumulan en un período, se suman y se dividen por producción. La potencia (kW) no funciona así: es el pico del mes, no se suma entre meses, el valor anual es el máximo y no la suma, y no se compara contra la línea de base sino contra la potencia contratada — con multa si se pasa.

Un cliente puede bajar el consumo y aun así pagar más, por un pico de 15 minutos un martes a las

1. Hoy eso no se ve en ningún gráfico nuestro. Planta Pilar, marzo, como ejemplo:

Energía consumida ............ 412.500 kWh   ← esto sí está en el Excel de hoy
Potencia contratada .......... 1.200 kW      ← esto no está en ningún lado
Potencia máxima registrada ... 1.340 kW      ← esto tampoco
Exceso ....................... 140 kW  →  penalización en la factura

Los tres números salen de la misma factura y del mismo suministro. En el modelo, la potencia es una magnitud más del punto "Suministro eléctrico Planta Pilar" (sección 2), con su regla propia — se toma el máximo, no se suma; la potencia contratada es un dato del suministro y el exceso se calcula contra ella. Lo que necesito de vos es el negocio:

• ¿CEA analiza hoy la potencia? ¿O es un renglón más de la factura que nadie revisa?
• Si la analiza, ¿hasta dónde? (a) se muestra y listo; (b) se avisa cuando se supera la contratada; (c) se recomienda recontratar — incluso a la baja, cuando el cliente paga de más todos los meses por potencia que no usa.
• ¿Qué trae exactamente la factura? ¿Contratada y máxima registrada nada más, o discriminada por banda horaria (pico / resto / valle)? Con una factura de ejemplo alcanza.
• ¿Hay clientes pagando multa por exceso hoy? Si los hay, la alerta se paga sola.
• ¿El pico interesa por submedidor (qué máquina lo causó) o alcanza con el general?

Si la respuesta a la primera es "no se analiza", no lo construimos ahora — pero igual necesito saberlo, porque define si la potencia va en la primera versión o queda para después.

El resto

1. Roles de usuario. ¿Qué perfiles existen realmente del lado del cliente? La propuesta (dueño / administrador / analista / lector) es una hipótesis; los perfiles reales tienen que salir de cómo trabajan Trivium y Asofarma.
2. Frecuencia mínima útil. Hoy todo es mensual. ¿Hay algún análisis que ya se haría con datos diarios o de curva de carga si estuvieran disponibles?
3. Un mismo punto con varios vectores. Dejando la potencia aparte: ¿existe algún medidor que reporte dos vectores a la vez (por ejemplo electricidad y agua), o son siempre puntos separados?
4. Corrección de datos declarados. Cuando un cliente corrige la producción de un mes ya informado, ¿se rehace el informe o se emite una corrección? Cambia cómo se guarda el histórico.
5. Qué magnitudes reportan los equipos que ya existen. De los analizadores y medidores instalados hoy en los clientes: ¿qué mandan además de la energía? Si alguno reporta coseno φ o tensiones y nadie los está mirando, ahí hay recomendaciones para hacer desde el primer día.
6. Qué otras variables se usan. Además de producción, temperatura y humedad: ¿algún cliente normaliza por horas trabajadas, turnos, grados-día, superficie o metros de producto? Cada una que falte es una línea de base que después no se va a poder representar.
7. Otros vectores. ¿Hay clientes con agua, vapor o combustibles líquidos, o alcanza con electricidad y gas por ahora?
8. Retención de datos. ¿Cuántos años de histórico hay que conservar? ¿Hay alguna obligación contractual o normativa?
9. Newsletter y mensajería. El sistema actual los tiene. ¿Se usan? ¿Se conservan?

Documento generado desde docs/revision/modelo-de-datos.md. Para observaciones, indicar la sección y el punto.