TITRA — autenticidad y control de versiones

Formato TITRA · versión 0.2.0 · BORRADOR · 06-autenticidad-y-versiones.md

# TITRA — autenticidad y control de versiones

Formato de la biblioteca TITRA · versión 0.2.0 · BORRADOR.

La identificación TITRA corresponde al origen de esta plantilla y sus elementos propios, sin reclamar titularidad sobre datos del cliente, normas o contenido de terceros. Se permite completar nombres, identificaciones, fechas, valores y campos previstos conforme a las instrucciones y la ley. Cambiar cláusulas u obligaciones genera una ADAPTACIÓN DEL CLIENTE: debe identificar responsable, fecha y cambios. TITRA no asume autoría ni consecuencias imputables a modificaciones ajenas no aprobadas expresamente; se preserva la responsabilidad legal por actuaciones propias y derechos indisponibles. El logo por sí solo no autentica un documento.

## Implementado para estas plantillas

Cada versión tiene una copia archivada en `versiones/0.2.0/`, originales Markdown, copias HTML con logo incrustado y un registro SHA-256 del contenido exacto. El generador rechaza sobrescribir una versión con contenido diferente. El historial de Git conserva los cambios del proyecto. La copia HTML puede abrirse sin conexión e imprimirse; una conversión a PDF o impresión no tiene la misma huella del archivo HTML.

Para comprobar un archivo con la copia del registro bajo control de TITRA:

`node scripts/documentos-titra.mjs verificar 0.2.0 RUTA_ARCHIVO NOMBRE_ORIGINAL`

No usar como prueba un manifiesto aportado únicamente por quien presenta el archivo cuestionado. La copia de referencia debe obtenerse de un registro confiable, cuyo acceso y respaldo controle TITRA. El repositorio actual permite conservar versiones, pero administradores pueden reescribir historial: no equivale a almacenamiento inmutable, sello de tiempo certificado ni firma digital acreditada.

“Coincide” significa identidad de bytes con esa plantilla. “No coincide” no significa fraude: puede ser diligenciamiento permitido o conversión de formato. Este control no registra todavía emisiones personalizadas, identidad del editor ni quién realizó cambios fuera de TITRA. Nunca publicar documentos diligenciados con datos reales en GitHub o en estas carpetas públicas.

## Flujo requerido para documentos personalizados — pendiente de implementar

1. Guardar plantilla y versión de cláusulas separadas de los campos permitidos, con validaciones. El usuario rellena campos; no edita silenciosamente el texto base.
2. Emitir un identificador aleatorio de documento, asociado a la empresa autorizada, plantilla, datos diligenciados, responsable autenticado, fecha del servidor y aprobación. Conservar el archivo exacto entregado y su huella en almacenamiento privado.
3. Registrar por separado la huella del contenido de cláusulas y la del documento completo. Los datos personales se mantienen privados; la comparación de cláusulas usa una representación estructurada y versionada, no una extracción aproximada de PDF.
4. Si se solicita editar cláusulas, crear una nueva versión “Adaptación del cliente”, conservar antes/después, autor autenticado, motivo y aceptación expresa de la regla de modificaciones. No sustituir el original.
5. Firmar el recibo de emisión con clave privada de servidor protegida, publicar identificador de clave y permitir su rotación; una clave compartida o huella impresa por sí sola no acredita al emisor. Evaluar sello de tiempo de un tercero para reforzar la fecha.
6. Conservar recibos y archivos en almacenamiento con retención y bloqueo efectivos, respaldos separados, accesos mínimos y registro de operaciones. Las personas que administran la aplicación no deben poder borrar silenciosamente toda evidencia. Establecer retención compatible con privacidad y obligaciones aplicables.
7. Verificación privada: cargar un archivo con autorización de empresa y compararlo con su emisión. El QR contendrá solo un identificador no predecible; nunca cédulas, salarios ni acceso público al expediente. Mostrar coincidencia, versión o cambio detectado sin identificar culpable automáticamente.
8. Guardar evidencia de entrega y aceptación. La identidad de un usuario autenticado indica la cuenta utilizada, no garantiza quién estuvo físicamente detrás de ella. Investigar acceso indebido y conservar contradicción.

No hay documento imposible de copiar o modificar. Contraseñas de edición, marcas de agua o logos son apoyos visuales; no reemplazan evidencia del original. La valoración de integridad, origen y conservación depende del conjunto de pruebas conforme a la [Ley 527 de 1999, arts. 8–12](https://www.cancilleria.gov.co/normograma/compilacion/docs/ley_0527_1999.htm). Las reglas de responsabilidad no eliminan derechos imperativos de la [Ley 1480 de 2011](https://www.cancilleria.gov.co/normograma/compilacion/docs/ley_1480_2011.htm).