Motor de Vida
para la operación de IPSmart

01 — DIAGNÓSTICO EN VIVOQué encontré en Railway

Entré al servicio postgres del proyecto IPSmart y conté filas de verdad. El punto de partida es bueno: no arrancas de cero, arrancas de una empresa de 60.000 abonados que alguien apagó.

El problema, en un solo dato

02 — HUECOSLos dominios que están en cero

De los 32 schemas de la base, doce no tienen ni una fila. Sus módulos enseñan pantallas en blanco por más que el resto tenga un millón de facturas.

03 — ARQUITECTURAEl motor: cuatro piezas

Un servicio pequeño en Railway que despierta solo, un modelo de operación que convierte tus parámetros en eventos, un panel donde mueves esos parámetros, y una pantalla para ver el resultado. Sin IA en el bucle: el modelo es determinista y auditable; la IA consume lo que el motor produce.

Por dónde escribe

Por SQL directo, en funciones dentro del schema sim, una transacción por latido. No por la API: aguanta el volumen, no depende de despliegues y reusa los invariantes que ya validó la siembra (saldo cuadrado, tasa congelada en la fila, PII cifrada, cero cruces entre empresas). Con una excepción deliberada: cada escritura emite su evento en audit.outbox_event, que es lo que despierta la capa de IA, alimenta el Pulso horario y le da material al ETL.

04 — EL VOLANTEPanel de Mando

Esto es lo que pediste: mover los números y ver cómo se desenvuelve la operación. La maqueta de abajo funciona de verdad — mueve las perillas y mira qué pasa. Es el mismo modelo que irá dentro del motor, con los valores de arranque calibrados contra tu base.

05 — PARÁMETROSTodas las variables del simulador

La maqueta de arriba expone once perillas para que se entienda el mecanismo. El panel real lleva las ~50 de esta tabla, agrupadas igual, con su valor de arranque y su rango. Todas viven en sim.parametro y se cambian en caliente.

Lo que sale del otro lado: el estado de resultados

Las mismas perillas que arreglan la cola de instalación mueven la nómina, y por tanto el margen. Esa tensión es el corazón del simulador: contratar cuadrillas quita cola y quita EBITDA a la vez, y el panel enseña las dos cosas al mismo tiempo. Cada indicador lleva su ⓘ explicando qué es, cómo se calcula y en qué rango se mueve un operador sano.

El panel no muestra un OPEX de una línea: despliega el estado de resultados completo, con las quince partidas de costo, su peso sobre los ingresos, y las tres paradas del camino — margen bruto, EBITDA y utilidad neta.

06 — RITMOEl día tipo: todo pasa todos los días

Esta es la corrección importante frente a la primera versión del plan. No es que el día 1 se factura y el resto del mes no pasa nada: todos los días hay ventas, instalaciones, averías, quejas, cobros y retiros. El calendario del mes solo marca los hitos que se concentran en una fecha; el resto es continuo.

Con la forma de un día real

• Curva horaria: arranque 7–9 h, meseta 9–13 h, pico 14–17 h, cola hasta las 20 h, madrugada casi muerta. Nada repartido plano en 24 horas — eso se nota a la legua.
• Semana: lunes y martes cargados, viernes de cierre, sábado al 60 %, domingo al 20 % y solo guardia. Se calcula contra el calendario real, no contra el número del día.
• Encadenado: la venta de hoy es la instalación de dentro de dos a cinco días, que es la primera factura del ciclo siguiente, que es el pago de la semana que viene. Nada aparece de la nada.

07 — COHERENCIAQue el motor no diga tonterías

Al que acaba de pagar no se le corta. Al que ya está instalado no se le instala. Al que ya se retiró no se le da de baja otra vez. Esta es la regla dura del motor, y no es un detalle de acabado: sin ella, en una semana la demo tiene facturas cobradas dos veces, cortados sin deuda y órdenes de instalación para gente que lleva tres años conectada. Una base así miente, y eso es peor que una base congelada.

Los estados por los que se pasa

Que terminated sea terminal no es capricho: es lo que permite medir reactivación como algo distinto de reconexión, que en un ISP son dos números que no se parecen en nada.

Quién es elegible para qué

Y cuatro reglas que atraviesan todo

• Los pagos se procesan antes que los castigos. El motor cobra primero y suspende después, de modo que quien pagó esta mañana no aparece en la lista de la tarde. La ventana de 72 h cubre además el pago móvil sin conciliar: quien reportó pago y todavía no se le aplica tampoco se corta.
• Causalidad con retardo, no por arte de magia. La venta de hoy es la instalación de dentro de dos a cinco días, que es la primera factura del ciclo siguiente, que es el pago de la semana que viene. El aviso de cobranza precede a la suspensión, nunca al revés.
• Nada de UPDATE desnudo. Todo cambio de estado escribe su fila de historia con motivo y actor, y emite su evento en el outbox. Un estado que cambió sin historia es un bug, y el verificador nocturno lo caza.
• Capacidad antes que deseo. Si el panel pide 90 instalaciones y las cuadrillas dan para 60, se hacen 60 y 30 quedan en cola. El motor nunca infla la capacidad para cumplir un número.

El verificador nocturno

A las 23:55 corre once comprobaciones. Todas tienen que dar cero; si alguna no da, para el motor y avisa por ntfy.

08 — HITOSLo que además se concentra en un día

Sobre el fondo continuo de la sección anterior, estos son los picos que caen en fecha fija. Con jitter, para que dos meses nunca salgan idénticos.

09 — NARRATIVAEl arco de septiembre a diciembre

Cada mes cambia de escenario solo, en la fecha programada. Quien mire el sistema en noviembre no ve lo mismo que en septiembre.

10 — FRONTLa Sala de Control

Dos pantallas en una: arriba el volante (el Panel de Mando de la sección 04), abajo el tablero de lo que está pasando ahora mismo. Pensada para dejarla abierta en un monitor.

Qué muestra el tablero

• La cinta. Cada evento que escribe el motor, en el momento en que lo escribe, por SSE. Filtrable por empresa y por tipo. Es la prueba visual de que hay pulso.
• Ocho contadores del día que suben solos: abonados activos, ventas, instalaciones, facturado, cobrado, órdenes cerradas, tickets abiertos, alarmas. Con delta contra ayer y contra el mismo día del mes pasado.
• Capacidad contra demanda en vivo: las dos barras que ves en la maqueta, pero con lo que realmente lleva ejecutado el día — y el cuello de botella dicho con palabras.
• Embudo comercial de hoy: leads → visitas → ventas → instalaciones, con la cola pendiente y los días de espera del cliente.
• Las últimas 24 horas en un área, sobre la curva esperada, para ver si el día va adelantado o atrasado.
• Mapa de zonas. Los 46 sectores de Táchira, Mérida, Nueva Esparta y Sucre se encienden donde está pasando algo. Hace obvio, sin explicarlo, que las dos empresas no se cruzan.
• Salud del motor. Último tick, próximo tick, eventos por minuto, errores de 24 h, y los controles: pausar, reanudar, acelerar, cambiar de escenario y rebobinar el día.

Vive en su propio subdominio, con la paleta canónica de la casa (violeta / índigo / cian, tema claro y oscuro), y entra como tarjeta en el escritorio IPSmart. Como todo host que sirve tráfico, queda registrada en uptime.ipsmart.app en el mismo trabajo que la publica.

11 — SEGURIDADBarandas: nada de esto es irreversible

• Candado por empresa. El motor solo escribe en tenants cuyo slug empieza por demo-. La empresa de la casa (IPSmart, 4 clientes reales) queda fuera por construcción, verificado en cada tick.
• Todo marcado. Cada fila que escribe el motor lleva su marca de origen y el id del tick. sim.rebobinar(desde, hasta) deja la base exactamente como estaba antes de esa ventana.
• Interruptor de emergencia. Una fila en sim.config apaga el motor sin redesplegar nada; el botón del panel hace lo mismo.
• Verificador nocturno. Corre cada noche las mismas comprobaciones que validaron la siembra — cero descuadres de saldo, cero fugas entre empresas en las siete relaciones que podrían cruzarse — y si falla, para el motor y avisa por ntfy. Mejor un motor parado que una base mentirosa.
• Parámetros con tope. Cada perilla tiene rango máximo; no se puede poner el motor a generar un millón de órdenes por descuido.
• Respaldo previo. Antes del primer tick, volcado completo de los dos tenants demo a ~/Downloads, más rama y commit, según la regla de la casa.

12 — EDTCómo se construye

Once jornadas de construcción; después corre solo hasta el 31 de diciembre sin que nadie lo vigile. Esfuerzo en jornadas de trabajo, no en días de calendario.

Total ≈ 13 jornadas · el grueso es delegable al copiloto; la calibración y el cuadre financiero, no.

13 — TU TURNOSeis decisiones antes de escribir código

Cada una lleva mi recomendación. Si estás de acuerdo con todas, basta con que digas «dale» y arranco por la Fase 0.

14 — RIESGOSLo que puede salir mal