Ingeniería · TourCheck
Un libro de rondas que se firma solo
Un registro de rondas de vigilancia solo vale algo en la disputa, la reclamación al seguro, la revisión del incidente, el «demuestre que la ronda nocturna ocurrió». Si la base de datos es la única evidencia, quien puede editarla decide lo que pasó. La respuesta de TourCheck es un diario que hace la manipulación visible en lugar de imposible.
Escribir una vez, encadenarlo todo
Cada evento, el escaneo de un punto de control, el inicio de una ronda, un incidente, se escribe una vez y nunca se actualiza. Las correcciones son filas nuevas, no ediciones. Sobre esas filas se asienta un diario encadenado por hash: cada entrada lleva un hash que la ata a la entrada anterior y a la carga de la fila que referencia, al modo de una blockchain menos todo lo que hace insufrible a una blockchain. Reescribir la historia significa recalcular cada entrada posterior, y la cabeza de la cadena se guarda donde un verificador lo nota.
La cuestión no es que la manipulación sea imposible. Nada lo es en una máquina autoalojada. La cuestión es que la manipulación deja huellas. La verificación recalcula el hash de carga de cada fila referenciada: una fila borrada deliberadamente se verifica como TOMBSTONEDcodeTAMPERED, intencional, visible, mientras que cualquier otra inconsistencia se verifica como code. «La base de datos lo dice» se convierte en «la base de datos puede probarlo».
Las reglas que lo sostienen
Una pasada de equipo rojo convirtió la vaga promesa en invariantes aplicados, y las interesantes son las aburridas:
- Un solo escritor para el estado de ronda. Una única ruta de código puede transicionar el estado de una ronda, dentro de una transacción, y cada transición produce una entrada de diario que nombra quién la cerró. Ningún UPDATE perdido en un controlador puede reescribir un resultado en silencio.
- El servidor decide la procedencia. El método y el ámbito de sitio de un evento se resuelven en el servidor a partir de la vinculación y la membresía. Las afirmaciones del cliente son entradas de validación, nunca se almacenan literalmente, así una petición amañada no puede atribuir su escaneo a una estación a la que no pertenece.
- El reenvío compara afirmaciones, no solo ids. Un id de evento de cliente repetido se comprueba contra el hash de carga almacenado, la nota vinculante, la foto y la marca temporal, un reenvío que discrepa del original es una discrepancia, no una deduplicación.
- Las sondas le cuestan al atacante. Los intentos con miembro desconocido queman el contador de bloqueo de la estación, de modo que el sondeo no puede usarse para enumerar qué miembros existen sin bloquear también lo que se está sondeando.
- Un solo orden de bloqueo, siempre. Primero la fila de ronda, luego la cabeza de cadena, nunca al revés. Existe para que la ingesta de eventos y el cierre de ronda no puedan bloquearse mutuamente. La corrección bajo concurrencia también es una propiedad de integridad.
La evidencia vive donde el acceso es una política
Las fotos y los informes generados no van a carpetas de Files visibles para el usuario, viven en appdata bajo ids gestionados por la app, con la autorización decidida por el rol en el sitio. Eso mata una clase entera de bug: el problema de «los demás lectores reciben un 404 o, peor, un 200» que viene gratis con los permisos de archivos. El anclaje a nivel de día cubre también el caso aburrido: una cadena vacía sigue produciendo un ancla válida, así que «el martes pasado no pasó nada» es en sí mismo una afirmación demostrable.
Nada de esto requiere confiar en nosotros. La verificación de la cadena es código que puede ejecutar, el modelo de amenazas está escrito en los expedientes de decisión, y la AGPL significa que un comité de empresa, un auditor o un administrador escéptico puede comprobar que el libro de rondas hace lo que este artículo dice. Las funciones de firma que no pueden inspeccionarse no son firmas, son decoraciones.