OmniGuard: una sala de control, una base de datos por empresa
Un sistema operativo multi-tenant para empresas de seguridad privada: sala de control, incidentes, SOS, rondas de patrulla, cuadrantes y facturación.
- Rol
- Ingeniero full-stack
- Periodo
- sept 2026 a hoy
- Estado
- En desarrollo
- Stack
- NestJS, Postgres, PostGIS, Redis, BullMQ, SSE, Next.js
- Problema
- La herramienta interna de una empresa de seguridad tenía que convertirse en un producto que muchas empresas pudieran contratar, con aislamiento estricto y sin alertas perdidas.
- Qué hice
- Construí la API y la sala de control con un ingeniero líder, un desarrollador móvil y un diseñador: una base de datos por empresa, un outbox para que las alertas sobrevivan a caídas, tiempo real por SSE con reenvío, y privacidad que sobrevive a las restauraciones.
- Resultado
- Camino del lanzamiento con 340 endpoints, unos 9,000 tests y 19 registros de decisiones detrás.


El sistema
El producto nació como una herramienta para una sola empresa de seguridad y tenía que convertirse en algo que muchas empresas pudieran contratar. Eso implicaba aislamiento estricto entre empresas, la normativa europea de privacidad y flujos de seguridad vital en los que perder un evento no es aceptable.
Ingeniero full-stack en la API y la consola de la sala de control, en un equipo con un ingeniero líder, un desarrollador móvil y un diseñador. 294 commits entre las dos apps en unas seis semanas, respaldados por 19 registros de decisiones de arquitectura.
- endpoints
- 340
- entidades
- 69
- ADRs
- 19
Cada empresa tiene su propia base de datos. Pasa el cursor o toca un nodo para seguir un incidente.
Un aislamiento que puedes señalar
tenant.interceptor.ts (simplified)
const firm = resolveFirm(request.user); // from the tokenconst db = await pool.acquire(firm.id); // lazy, evicted when idlereturn cls.run({ firm, db }, () => db.transaction(() => next.handle()));
Llega una petición con un token de la empresa A.
El tenancy a nivel de fila funciona hasta que un filtro olvidado filtra el cuadrante de vigilantes a un competidor. Aquí cada empresa tiene su propia base de datos Postgres. Las conexiones se resuelven por petición a partir de un contexto asíncrono en lugar de providers con ámbito de petición, se guardan en un mapa de pools perezoso con desalojo por inactividad y un único interceptor las envuelve en una transacción.
Aprovisionar una empresa es un proceso idempotente de cinco pasos que verifica PostGIS antes de que la empresa entre en producción, y las migraciones se aplican en todas las bases de datos de tenants antes de cada despliegue, bajo un advisory lock.
Eventos que sobreviven a una caída
incidents.service.ts + outbox relay (simplified)
await db.transaction(async (tx) => { await tx.save(incident); await tx.insert(Outbox, { id, type: "sos.raised", payload });});// relay, after restart too:await queue.add(row.type, row.payload, { jobId: row.id });
Un vigilante pulsa SOS.
Un SOS no puede escribirse en la base de datos y luego perderse porque el proceso murió antes de encolar el job. Los eventos de dominio se insertan en un outbox en la misma transacción que el cambio, y un relay los mueve a BullMQ respaldado por Postgres usando el id de la fila del outbox como id del job, así que un relay que se repite no puede crear duplicados.
Tiempo real sin retener conexiones
stream.controller.ts (simplified)
// GET /v1/stream Last-Event-ID: 42const missed = await buffer.since(firmId, lastEventId);missed.forEach(send); // replay what was missedsubscribe(firmId, send); // then go livereturn; // no database connection held
La sala de control abre un stream. El handler lo registra y retorna.
La sala de control escucha mediante Server-Sent Events. El handler registra el stream y retorna, así que no se retiene ninguna conexión a la base de datos mientras un operador tiene una pestaña abierta toda la noche. Las reconexiones reenvían los eventos perdidos desde Last-Event-ID, y revocar un token o llegar a su caducidad cierra el stream. Un test de integración comprueba que la conexión se libera.
Privacidad como ingeniería, no como papeleo
Una persona pide ser olvidada. Se la borra y el borrado queda registrado.
El registro de auditoría es de solo inserción. Los borrados se escriben en un registro dentro de la base de datos del tenant y se copian a la base de datos de la plataforma, así que restaurar una copia de seguridad vuelve a aplicar los borrados en lugar de resucitar a personas eliminadas. La asistencia con IA envía roles en lugar de nombres, nunca guarda prompts ni respuestas en los logs, fija las versiones de los modelos y trata la salida como texto no fiable.
Decisiones que defiendo
Base de datos por empresa en lugar de tenancy a nivel de fila
El aislamiento pasa a ser estructural, las copias de seguridad y los borrados se hacen por empresa, y los vecinos ruidosos se quedan en su propia base de datos.
SSE en lugar de WebSockets
El tráfico va abrumadoramente del servidor al cliente, SSE reenvía eventos de forma limpia y viaja sobre HTTP normal a través de cualquier proxy.
Registros de decisiones con umbrales de revisión
Cada ADR indica la carga a partir de la cual hay que reconsiderarlo, dimensionada según un modelo de capacidad de 60 empresas y 9k usuarios.


