01 — El Problema
Un almacén central multi-empresa consolidaba manualmente requisiciones de tres razones sociales distintas en hojas de cálculo propensas a truncamiento silencioso, códigos contables inconsistentes y pérdida de borradores cuando fallaba la generación de documentos.
02 — Arquitectura & Flujo
Separación estricta en tres capas (UI → Dominio → Persistencia atómica). Cada escritura JSON ejecuta escritura temporal, flush, fsync y reemplazo atómico en disco, protegiendo catálogos maestros y borradores operativos en estaciones Windows.
Limpieza Unicode en códigos ERP y validación estricta de cantidades antes de mutar el carrito.
Asignación de generation_id y correlativo único previo a generar artefactos Excel/Word.
División automática de lotes en bloques de 19 líneas respetando códigos de empresa y subgrupos.
Commit atómico en disco (temp + fsync + replace) y verificación headless en actualizaciones.
03 — Solución Técnica
Se implementó normalización Unicode de códigos de inventario, reserva determinista de correlativos contables mediante UUID por intento (generation_id), paginación automática en bloques de 19 ítems para formularios físicos y un canal dual de actualizaciones OTA con rollback automático.
04 — Resultados
- Cero corrupción de archivos de estado gracias a escrituras atómicas con fsync y bloqueo de runtime.
- Paginación determinista que evita el truncamiento silencioso en requisiciones de alto volumen.
- Despliegues OTA con verificación smoke headless y preservación íntegra de los datos operativos.
Decisiones clave de ingeniería
Invariantes de dominio como primera línea de defensa
En sistemas operativos internos donde un error de formato se traduce en discrepancias de inventario, confiar en validaciones en la interfaz no basta. En Kronos toda regla crítica vive en la capa de dominio libre de UI:
- Precedencia de clasificación: Los subgrupos respetan estrictamente el orden
erp > manual > inferido, impidiendo que heurísticas pisen datos maestros. - Tolerancia a reintentos: Si la generación de un lote Word o Excel falla a mitad de camino, el borrador se conserva intacto y el reintento reutiliza el
generation_idpara emitir únicamente los documentos faltantes sin duplicar correlativos. - Pruebas aisladas: Una suite de regresión aislada clona el árbol hacia un directorio temporal desechable, garantizando que ningún test toque archivos vivos de producción.
Nota de confidencialidad: Los nombres de razones sociales, códigos internos y documentos operativos fueron anonimizados para proteger los datos del cliente.
Demo interactiva de ingeniería
DEMO INTERACTIVA EN VIVO // REACT ISLAND
Prueba la lógica de cada arquitectura
Paginación determinista en lotes de máximo 19 ítems (FM-SU-003) con reserva UUID idempotente y persistencia atómica.
Lotes generados (cap 19)
generation_id reservado
8f42b9c0-7a1d-4e3f-9c12
Ciclo de persistencia en disco
En espera de ejecución