Geovani Lozano — Documentación técnica

Cómo funcionan por dentro

Una serie de documentos técnicos sobre plataformas que he construido. Cada uno explica el mecanismo real —las fórmulas, los estados, las decisiones de modelado y por qué se tomaron— en vez de describir funcionalidades.

Criterio · el mecanismo, no el folleto Origen · escritos a partir del código Idioma · español
01

Energía y activos

Plataformas que toman datos de campo y los convierten en diagnóstico.

Solar · Diagnóstico

Plataforma Sentinel →

Arquitectura, gobierno del dato y motor de cálculo de una plataforma de gestión de activos fotovoltaicos: PR, EPI, disponibilidad contractual, pérdidas, modelo físico y causa raíz, con el catálogo de ecuaciones y su norma de referencia.

Hielo · Solar · Caja

Congela →

Motor de reparto de ingresos entre fondos, crédito con amortización y abonos parciales, arqueo de caja que descuenta el fiado no cobrado, y liquidación de sub-medidores replicando la tarifa del operador de red.

02

Gestión y finanzas

Sistemas donde el problema no es registrar, sino que los números resistan una revisión meses después.

Multi-tenant · Tributario

ZOE — Núcleo de gestión →

Aislamiento por organización, ciclo de proyecto a cobro, imputación explícita de pagos a facturas, motor de retenciones colombianas con tarifas por condición del tercero y UVT por año, presupuesto contra costo real y reparto entre socios.

Societario · Auditable

Valoriza →

Aportes con evidencia y aprobación, tesorería con cadena de autorización, mayorías ordinaria, calificada y unánime con el conflicto de interés descontado del censo, y cierre de periodo que impide que el pasado se mueva.

03

Ingeniería y cálculo

Herramientas donde la fórmula es el producto.

Docente · Instrumentación

Simulador de Telemetría Industrial →

Siete prácticas con procesos físicos simulados y sensores que se comportan como sensores: ruido, rango saturado y cinco fallas inyectables. Lo que enseña no es el proceso sino el oficio — distinguir cuándo cambió la planta de cuándo cambió el instrumento.

500 kV · RETIE

Línea de transmisión →

La cadena completa de decisiones de una línea de 500 kV y 307 km: nivel de tensión, geometría del haz, parámetros distribuidos, corona por Peek, modelo ABCD, cálculo mecánico con vano crítico, aisladores por fuga y BIL, y altura de torre bajo RETIE.

04

Datos y herramientas

Sistemas donde el problema es que el dato sea real, o que la herramienta no mienta con autoridad.

Cuantitativo · Integridad

Quantsys — capa de datos →

Invariantes point-in-time, coherencia del funding según dónde cae el evento, por qué no se reescriben los precios históricos, y por qué el discriminador entre una acción corporativa y una parada del exchange es la sincronía y no la magnitud.

Escritorio · Electron

MultiView Hub →

Contrato de adaptador por fuente, resolución ordenada con comodín final, y capacidades declaradas para no ofrecer controles que la plataforma no permite.

Didáctico · IA

Calculadora Termodinámica →

Por qué el modelo de lenguaje nunca produce un número: el endpoint que explica también calcula primero con la librería y le entrega los resultados ya obtenidos.

05

Producto y comercio

Plataformas de cara al público, donde la decisión difícil es de diseño de dominio.

Ecommerce · Colombia

ComparaMarket Pro →

Cuándo dos ofertas de plataformas distintas son el mismo producto, los cuatro componentes del puntaje de conveniencia, la recomendación explicada por reglas que reconoce una contra, y el despeje cerrado del precio que alcanza un margen dado.

Fintech · Colombia

AQUITA →

Autofinanciamiento vehicular por grupos: el congelamiento del fondo que impide adjudicar dos veces lo mismo, el sorteo con su registro de auditoría reconstruible, y la adjudicación por oferta que excluye a quien ya ganó en esa misma asamblea.

Identidad · Privacidad

PetID →

El token de una placa QR es la única credencial que protege el contacto de un tutor: cómo se genera para que no se pueda adivinar ni reconstruir, y cómo se trata la única superficie del sistema accesible sin sesión.

06

Sobre esta serie

Todos los documentos siguen el mismo criterio, y conviene decirlo de frente.

Qué intentan hacer, y qué no

Cada documento explica el mecanismo: qué se calcula, con qué fórmula, contra qué norma, y por qué el modelo de datos quedó como quedó. Muchas de esas decisiones se explican mejor contando el problema que las obligó —un número creíble y falso, un vínculo que se perdía al editar un campo de texto, un subsidio que se multiplicaba por el número de medidores—, así que eso también está.

Ninguno es material comercial. No enumeran funcionalidades ni prometen resultados, y cuando dejan algo fuera del alcance lo dicen en su primera sección.

Están escritos a partir del código: las fórmulas reproducen las expresiones implementadas y los estados son los que existen en el esquema. Son páginas autocontenidas, sin dependencias ni build, que se abren igual desde el navegador que desde un archivo local.