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