Cómo construí FunerariaCloud: un SaaS multi-tenant con cumplimiento SARLAFT

Cuando arranqué FunerariaCloud pensé que era un CRUD con esteroides: contratos, clientes, facturas. Ya había construido dashboards de gestión antes. Lo que no dimensioné al principio es que una funeraria en Colombia no vende un servicio puntual — vende planes de previsión exequial, contratos financieros a largo plazo con pagos mensuales durante años, a veces décadas, antes de que el servicio se preste.

SARLAFT (Sistema de Administración del Riesgo de Lavado de Activos y Financiación del Terrorismo) es el marco regulatorio colombiano que obliga a ciertos sectores — financiero, y por extensión negocios que manejan contratos de pago recurrente a largo plazo como las funerarias con planes de previsión — a tener controles sobre el origen de los fondos y la trazabilidad de las operaciones.

Para el software esto significa que ciertas cosas no pueden ser un afterthought. En términos generales, un sistema que conviva con esta normativa necesita poder:

• Registrar quién hizo qué y cuándo sobre cada contrato (trazabilidad completa, no solo el estado actual)
• Conservar evidencia auditable de cada operación, no solo mostrar un resumen
• Identificar el origen de los fondos en operaciones de valor significativo
• Tener un canal para marcar y reportar operaciones inusuales

FunerariaCloud está pensado para vender a múltiples funerarias, no para una sola. Eso significa multi-tenancy real: cada funeraria opera como una organización aislada — datos, usuarios y configuración separados — pero todas comparten la misma base de código y la misma infraestructura.

En la práctica, esto se traduce en que prácticamente ninguna query a la base de datos puede ignorar el tenant actual. Así se ve el patrón simplificado (no es el código exacto de producción, es la idea):

export const contracts = pgTable("contracts", {
  id: uuid("id").primaryKey().defaultRandom(),
  tenantId: uuid("tenant_id").notNull().references(() => tenants.id),
  clientId: uuid("client_id").notNull(),
  planId: uuid("plan_id").notNull(),
  status: contractStatus("status").notNull().default("pending"),
  createdAt: timestamp("created_at").notNull().defaultNow(),
});

// Ninguna query a "contracts" puede saltarse el tenant actual
export function getContracts(tenantId: string) {
  return db
    .select()
    .from(contracts)
    .where(eq(contracts.tenantId, tenantId));
}

Más allá del núcleo de gestión de contratos y previsión exequial, terminé construyendo firma digital de contratos, un módulo contable completo, y un log de auditoría que registra cada login y cada acción sobre un contrato — exactamente el tipo de trazabilidad que SARLAFT exige.

export const auditLog = pgTable("audit_log", {
  id: uuid("id").primaryKey().defaultRandom(),
  tenantId: uuid("tenant_id").notNull(),
  userId: uuid("user_id").notNull(),
  action: text("action").notNull(),
  // "LOGIN" | "LOGOUT" | "REQUEST_SIGNATURE" | "CONTRACT_UPDATED" ...
  targetId: uuid("target_id"),
  metadata: jsonb("metadata"),
  createdAt: timestamp("created_at").notNull().defaultNow(),
});

También terminé agregando gestión de flota (vehículos y mantenimiento) y CRM con páginas memoriales online — cosas que no estaban en el plan original, pero que aparecieron al diseñar contra el día a día real de una funeraria:

• Firma digital de contratos
• Módulo contable completo (libro diario, balance, bancos, cartera)
• Log de auditoría (login, firma, cambios de contrato)
• Gestión de flota y mantenimiento de vehículos
• CRM y páginas memoriales online

Si estás en el sector funerario en Colombia y esto te suena a un problema que tenés, o si necesitás construir un SaaS que tenga que convivir con una regulación real — SARLAFT, HABEAS DATA, DIAN, la que sea — desde el diseño y no como parche al final, hablemos.