H24
volver a proyectos

// caso de estudio · biomed-cmms

Biomed CMMS

Biomed CMMS es un sistema GMAO/CMMS para departamentos de electromedicina: inventario de equipos, órdenes de trabajo, mantenimiento preventivo, calibraciones, avisos y cumplimiento normativo, con app web, API y cliente de escritorio.

React 19Fastify 5DrizzleSQLiteElectron
ver perfil en GitHub GMAO · mantenimiento electromédico
Vista general de Biomed CMMS con inventario, órdenes y mantenimiento

01 / problema

Problema

Mantener equipos electromédicos no es solo arreglarlos cuando fallan. Hay que saber qué hay en el centro, cada cuándo se calibra, quién hizo cada intervención y dejar constancia para una auditoría.

Ese conjunto suele vivir repartido entre hojas de cálculo, papeles y herramientas caras difíciles de adaptar a la realidad de un hospital pequeño.

02 / solución

Solución

Una aplicación web reúne el inventario, las órdenes de trabajo, los avisos de enfermería, el mantenimiento preventivo, las calibraciones, los repuestos, los contratos y los informes.

El acceso funciona por usuario y contraseña con tres roles: administrador, técnico y enfermería. La interfaz es responsive, tiene modo claro y oscuro y se puede instalar como PWA.

La app de escritorio Electron puede actuar como servidor local —con la API como sidecar— o conectarse a un servidor de la red, con asistente de configuración, QR de conexión y bandeja del sistema.

03 / resultado

Resultado

El README lo define como MVP completado con v0.3 en curso: multi-centro, ERP y una tanda de endurecimiento ya cerrados; la versión SaaS sigue pendiente.

Incluye documentación de rendimiento, pruebas de concurrencia, docker-compose, configuración de nginx y 90 declaraciones de test repartidas en cinco archivos.

Es el proyecto más completo de los cuatro y el que mejor resume la forma de trabajar: menos magia, más trazabilidad y herramientas que otra persona pueda mantener.

04 / decisiones técnicas

Cómo está construido

D01

Monorepo con tres apps

React 19 + Vite + Tailwind 4 + TanStack Query en `apps/web`, Node 22 + Fastify 5 + Drizzle en `apps/api`, Electron en `apps/desktop` y esquemas Zod compartidos en `packages/shared`.

D02

SQLite local, migrable a PostgreSQL

Usar `better-sqlite3` permite que el servidor viva en una sola PC sin Docker. El modelo con Drizzle deja abierta la migración a PostgreSQL cuando el centro crece.

D03

Offline lectura, escritura segura

El service worker precachea la app con Workbox y sirve las lecturas desde caché si falla la red. Crear, editar o borrar sigue requiriendo conexión para no perder cambios.

D04

Entrega documentada

Incluye guía de uso con capturas, PDF de 42 páginas, script de smoke test de escritorio y generación de instalador NSIS para Windows.

05 / galería

Capturas reales

Vista general del panel de Biomed CMMS
Inventario de equipos electromédicos
Órdenes de trabajo registradas
Plan de mantenimiento preventivo
Registro de auditoría del sistema
Asistente de instalación de la app de escritorio