H24
volver a Writing

05 de agosto de 2026 / 6 min de lectura

Tres apps, un esquema: el monorepo de Biomed CMMS

Web, API y Electron compartiendo tipos Zod. Cómo evitar que un cambio en el modelo rompa el cliente de escritorio sin que nadie se entere.

#Biomed CMMS#TypeScript

Biomed CMMS tiene tres piezas: `apps/web` (React 19, Vite, Tailwind 4, TanStack Query), `apps/api` (Node 22, Fastify 5, Drizzle) y `apps/desktop` (Electron). Sin una frontera clara, un cambio en el modelo de orden de trabajo rompe una pieza y nadie lo descubre hasta el despliegue.

El contrato vive en packages/shared

Los esquemas Zod y los tipos compartidos están en `packages/shared`. La API valida con el mismo esquema que usa la web para renderizar y el escritorio para conectarse. No hay tres definiciones de «orden de trabajo» compitiendo entre sí.

typescript
import { z } from 'zod';

export const workOrder = z.object({
  id: z.string(),
  equipmentId: z.string(),
  status: z.enum(['abierta', 'en_curso', 'cerrada']),
  createdAt: z.coerce.date(),
});

El escritorio no es una web metida en una ventana

  • Modo servidor: arranca el API como sidecar con un Node 22 propio y guarda SQLite en `%APPDATA%`, sin Docker.
  • Modo cliente: carga la SPA del servidor de la red, manteniendo frontend y backend en la misma versión.
  • El cierre ordenado va por IPC porque en Windows no existe un `SIGTERM` real para el sidecar.

Ese último detalle resume el proyecto: la arquitectura se decide mirando dónde se va a ejecutar, no solo cómo se ve en el diagrama.