// 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.

// índice
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





