H24
volver a proyectos

// caso de estudio · certia

CERTIA

CERTIA organiza los dossiers de seguridad eléctrica y auditoría para electromedicina y cocinas industriales: registro con roles, evidencia fotográfica, informes con QR y verificación pública, con trabajo offline-first.

React 19Fastify 5IndexedDBPWAHMAC-SHA256
ver perfil en GitHub QR · verificación de dossiers
Panel de control de CERTIA con los dossiers registrados

01 / problema

Problema

Una revisión de seguridad no termina cuando se firma el acta. Después hay que responder qué se revisó, quién lo hizo y poder demostrarlo meses más tarde.

En electromedicina y cocinas industriales ese historial suele repartirse entre papeles, PDFs y fotos sueltas. Encima, el registro se hace en el propio sitio, donde la conexión no siempre es estable.

02 / solución

Solución

CERTIA convierte cada revisión en un dossier con identidad, roles, evidencia fotográfica y trazabilidad. Desde el panel se consulta el estado de los dossiers y se generan los informes.

Cada revisión se firma con HMAC-SHA256 sobre una representación canónica del dossier y se encadena con SHA-256 a la revisión anterior. Alterar un dato rompe la cadena.

El QR del PDF apunta a una ruta pública de verificación que comprueba la firma y la cadena completa sin pedir login. Quien audita no depende de que alguien le envíe el archivo correcto.

El flujo está pensado para usarse sin red: dossiers y fotos pendientes viven en IndexedDB y se sincronizan cuando vuelve la conexión.

03 / resultado

Resultado

El proyecto quedó documentado con seis capturas reales: acceso, panel, seguridad, dossier, informe y verificación.

Es un prototipo funcional con backend real y seis declaraciones de test en `server.test.mjs`. El despliegue en Vercel quedó pendiente porque SQLite en disco no encaja tal cual.

El README es explícito con el límite: CERTIA garantiza integridad del registro, no firma electrónica cualificada ni sello de tiempo.

04 / decisiones técnicas

Cómo está construido

D01

Firma y cadena, no solo un hash

El servidor firma el JSON canónico con HMAC-SHA256 y cada revisión guarda `prev_hash`/`next_hash`. La verificación compara la firma y recorre la cadena completa.

D02

IndexedDB para el trabajo de campo

El outbox y las fotos pendientes se guardan en IndexedDB; `node:sqlite` es la base del servidor, no el almacenamiento del navegador. Son dos responsabilidades distintas.

D03

Registrar y firmar son permisos distintos

El rol técnico o responsable puede registrar; solo el responsable puede firmar. Separar ambas acciones evita que una revisión quede cerrada por quien no debía.

D04

PDF con QR real

jsPDF y qrcode generan el informe con la URL verificable y un hash corto. El papel sigue siendo útil porque vuelve a conectar con el registro digital.

05 / galería

Capturas reales

Pantalla de acceso de CERTIA
Panel de control con los dossiers registrados
Módulo de seguridad eléctrica
Detalle de un dossier y su evidencia
Informe generado en PDF
Verificación de un dossier mediante QR