Módulo 7: Colaboración sin conflictos con Obsidian Sync

7.1 La colaboración asincrónica como modelo de trabajo

Obsidian no es un editor colaborativo en tiempo real. No permite que dos personas escriban simultáneamente sobre el mismo párrafo viendo los cambios del otro letra por letra, como sí lo hacen Google Docs o Microsoft Word en la nube. Esta limitación, lejos de ser una carencia, es una decisión de diseño que protege la privacidad de los datos y evita la complejidad técnica que introducen los algoritmos de transformación operacional. A cambio, ofrece un modelo de colaboración asincrónica que, combinado con Obsidian Sync y un protocolo sencillo, se adapta con naturalidad al flujo de trabajo de un despacho jurídico.
En la práctica diaria del litigio colombiano, la redacción de una demanda rara vez es una tarea simultánea. Lo habitual es que un abogado redacte el borrador, otro lo revise horas o días después, y un tercero apruebe la versión final. Durante ese proceso, no hay necesidad de que dos personas estén escribiendo al mismo tiempo sobre el mismo archivo. Lo que sí se necesita es que, cuando alguien tome un documento para editarlo, los demás lo sepan y no interfieran. Y que, una vez terminada la edición, la nueva versión esté disponible para todos.
Obsidian Sync proporciona la capa técnica que hace posible ese flujo: sincronización periódica, cifrado extremo a extremo y un historial de versiones. Este módulo enseña a complementar esa capa con un protocolo humano que elimina la fricción y convierte la colaboración asincrónica en una ventaja.

7.2 Cómo funciona la sincronización periódica y el periodo de gracia

7.2.1 Sincronización diferencial

Obsidian Sync no copia archivos completos cada vez que se detecta un cambio. Envía únicamente las diferencias entre la versión local y la versión remota. Si un abogado modifica dos líneas de una nota de diez páginas, solo esas dos líneas viajan por la red, cifradas. Esto hace que la sincronización sea rápida incluso con conexiones de baja velocidad, como las que pueden encontrarse en algunos palacios de justicia o zonas rurales del país.
El proceso es el siguiente:

1. Un abogado edita una nota en su equipo local.
2. Obsidian detecta el cambio y, tras un breve intervalo (configurable en «Settings > Sync > Sync interval»), inicia la sincronización.
3. El cliente local cifra las diferencias y las envía al servidor de Obsidian.
4. El servidor almacena las diferencias cifradas y las retransmite a los demás dispositivos autorizados.
5. Cada dispositivo recibe las diferencias, las descifra con su copia de la clave de bóveda y las aplica a su archivo local.
   El intervalo de sincronización por defecto es adecuado para la mayoría de los despachos. Si se requiere inmediatez, puede forzarse una sincronización manual en cualquier momento con Ctrl/Cmd + P > Sync: Sync.

7.2.2 El periodo de gracia

Obsidian Sync incorpora un mecanismo llamado grace period (periodo de gracia) que resuelve una situación cotidiana: el abogado cierra Obsidian al terminar la jornada, pero la sincronización no ha terminado. En otras nubes, esto podría generar un conflicto o una pérdida de datos. Con el periodo de gracia, Sync retiene los cambios pendientes durante un tiempo configurable (por defecto, varios minutos) y los aplica en cuanto el dispositivo se reconecta.
Esto significa que el abogado puede cerrar su computador portátil inmediatamente después de escribir, sin esperar a que el indicador de sincronización se detenga. Al abrirlo al día siguiente, Obsidian Sync completará la sincronización pendiente de manera transparente. Esta característica es particularmente valiosa para los abogados que trabajan en movilidad, entre audiencias y desplazamientos.

7.3 El protocolo de check-out / check-in

El protocolo de check-out / check-in es la pieza central del método de colaboración. No depende de ninguna funcionalidad técnica de Obsidian; es un acuerdo expreso entre los miembros del despacho, documentado en la nota diaria y respetado por todos. Su propósito es sencillo: evitar que dos personas editen el mismo escrito al mismo tiempo.

7.3.1 Paso 1: Verificar antes de editar

Antes de abrir un escrito para modificarlo, el abogado consulta la nota diaria del día. Si otro compañero ha anotado un check-out sobre ese documento, significa que está en edición. En ese caso, el abogado espera a que aparezca el check-in correspondiente, o se comunica directamente con el compañero si la urgencia lo requiere.
Si la nota diaria no muestra ningún check-out sobre el escrito, el documento está libre.

7.3.2 Paso 2: Anunciar el inicio de la edición (check-out)

El abogado que va a editar anota en la nota diaria del día una línea con el siguiente formato:

Check-out [[Demanda EXP-2024-00123]] - Luis. Inicio: 09:15.

text

Donde:

• [[Demanda EXP-2024-00123]] es el enlace a la nota del escrito que se va a editar.
• Luis es el nombre o las iniciales del abogado.
• La hora de inicio es opcional pero recomendable para que los demás sepan cuánto tiempo lleva el documento reservado.
  Esta anotación se sincroniza con los demás equipos en el siguiente ciclo de Sync.

7.3.3 Paso 3: Editar con tranquilidad

Mientras el check-out está vigente, los demás miembros del despacho se abstienen de modificar ese documento. Pueden abrirlo y leerlo, pero no introducen cambios. Esta restricción se basa en la confianza y el acuerdo mutuo, no en un bloqueo técnico.

7.3.4 Paso 4: Anunciar el fin de la edición (check-in)

Al terminar la edición, el abogado sincroniza su bóveda (Ctrl/Cmd + P > Sync: Sync) y, una vez que el indicador confirma que la sincronización se ha completado, anota en la nota diaria:

Check-in [[Demanda EXP-2024-00123]] - Luis. Cambios: ajuste de hechos y adición de prueba documental. Fin: 11:00.

text

La descripción de los cambios no necesita ser exhaustiva, pero debe dar una idea suficiente para que el revisor sepa qué buscar. Esta anotación, al sincronizarse, informa a los demás que el documento está nuevamente disponible.

7.3.5 Flujo completo con dos abogados

Abogado A (Luis) inicia su jornada. Verifica la nota diaria: no hay check-outs activos. Decide trabajar sobre la demanda del caso EXP-2024-00123.
Anota: Check-out [[Demanda EXP-2024-00123]] - Luis. Inicio: 08:00.
Sincroniza. El abogado B recibe la nota diaria actualizada y ve el check-out. No toca ese documento.
Luis termina a las 10:30. Sincroniza. Anota: Check-in [[Demanda EXP-2024-00123]] - Luis. Cambios: hechos ajustados según declaración del testigo. Fin: 10:30.
Sincroniza de nuevo. El abogado B recibe la nota diaria, ve el check-in y sabe que ya puede tomar el documento si lo necesita.
Abogado B (María) quiere ahora revisar la demanda. Consulta la nota diaria: no hay check-out activo. Anota: Check-out [[Demanda EXP-2024-00123]] - María. Inicio: 11:00.
Sincroniza. Luis ve el nuevo check-out y sabe que María está revisando. No introduce cambios hasta que María haga check-in.
Este ciclo, repetido a lo largo del día, garantiza que nunca haya dos ediciones concurrentes sobre el mismo archivo.

7.4 Qué hacer si surge un conflicto de sincronización

Aunque el protocolo reduce los conflictos a casi cero, pueden ocurrir. El escenario típico es que dos abogados editen la misma nota sin conexión a internet (por ejemplo, uno en una sala de audiencias y otro en el despacho), y ambos sincronicen al recuperar la conexión sin haber aplicado el protocolo de check-out.
Cuando esto sucede, Obsidian Sync no sobrescribe una versión con la otra. En su lugar, detecta la divergencia y crea un archivo de conflicto con el sufijo -conflict-[fecha]. La nota original conserva una de las versiones (generalmente la que se sincronizó primero). El archivo de conflicto contiene la otra versión.

7.4.1 Procedimiento de resolución

1. El abogado que detecta el conflicto (porque aparece un archivo adicional en el explorador o porque el indicador de Sync muestra una notificación) se comunica con el otro editor de inmediato.
2. Ambos revisan la versión principal y el archivo de conflicto.
3. Determinan cuál de las dos versiones es la más completa o, si ambas contienen aportes valiosos, consolidan manualmente los cambios en la nota principal.
4. Una vez consolidada la nota, eliminan el archivo de conflicto.
5. Sincronizan la bóveda. El conflicto queda resuelto.
   Este procedimiento toma menos de cinco minutos en la mayoría de los casos y no implica pérdida de datos. La clave es resolverlo a la menor brevedad, para que el archivo de conflicto no permanezca en la bóveda generando confusión.

7.5 División de documentos largos mediante transclusión

Algunos escritos jurídicos son extensos y contienen secciones que podrían ser redactadas en paralelo por distintos abogados sin interferir. Por ejemplo, en una demanda de responsabilidad civil, los hechos pueden ser redactados por un abogado mientras otro prepara los fundamentos de derecho y un tercero elabora el acápite de pruebas.
Obsidian permite esta división del trabajo mediante la transclusión, que consiste en incrustar el contenido de una nota dentro de otra.

7.5.1 Sintaxis de la transclusión