Sincronización en la nube

Cómo funciona la sincronización en la nube

Kanban Pro es una aplicación local-first. Cada proyecto es una carpeta en su sistema de archivos que contiene archivos de tickets Markdown y un directorio de configuración .kanban/. No hay cuentas, no hay servicios en la nube propietarios y no hay registros.

Para colaborar con otros, simplemente coloque su carpeta de proyecto dentro de un directorio sincronizado por la nube — iCloud Drive, Dropbox, Google Drive, OneDrive o cualquier unidad de red. Cada participante abre la misma carpeta en Kanban Pro, y los cambios se propagan automáticamente a través de la sincronización de archivos del proveedor de nube.

Configuración de un proyecto compartido

1. Elija una carpeta en la nube. Abra el Finder y navegue al directorio de sincronización de su proveedor de nube (por ejemplo, ~/Library/Mobile Documents/com~apple~CloudDocs/ para iCloud Drive, ~/Dropbox/ para Dropbox, o el montaje de Google Drive / OneDrive en su barra lateral de Finder).
2. Cree una carpeta de proyecto. Cree una nueva carpeta para su proyecto, por ejemplo, Team Board.
3. Ábrala en Kanban Pro. Inicie Kanban Pro, haga clic en Abrir carpeta y seleccione la carpeta que acaba de crear. Kanban Pro inicializará el directorio .kanban/ y podrá comenzar a agregar columnas y tickets.
4. Comparta la carpeta. Utilice las funciones de uso compartido de su proveedor de nube para invitar a colaboradores. En iCloud Drive, haga clic con el botón derecho en la carpeta y elija Compartir. En Dropbox o Google Drive, utilice el cuadro de diálogo de uso compartido. En OneDrive, haga clic con el botón derecho y seleccione Compartir → Compartir con OneDrive. Cada colaborador debe abrir la misma carpeta sincronizada en su propia copia de Kanban Pro.

Estructura de carpeta recomendada

Cuando Kanban Pro inicializa un proyecto, crea la siguiente estructura dentro de la carpeta elegida:

Cada ticket es un archivo Markdown simple con YAML frontmatter para metadatos (estado, prioridad, asignado, etiquetas, campos personalizados). Puede leer, editar o hacer copia de seguridad de estos archivos con cualquier herramienta — incluyendo agentes de codificación de IA que funcionan directamente con el sistema de archivos.

Sincronización en tiempo real y edición sin conflictos

Kanban Pro monitorea la carpeta del proyecto para cambios del sistema de archivos utilizando un observador de archivos en tiempo real. Cuando un colaborador guarda un ticket o actualiza la configuración del tablero, el cambio se detecta en segundos y la interfaz de usuario se actualiza automáticamente.

Cómo se evitan los conflictos

• Bloqueo de tickets: Cuando abre un ticket para editar, Kanban Pro crea un pequeño archivo de bloqueo dentro de .kanban/locks/. Otros usuarios ven el ticket como bloqueado y no pueden sobrescribir sus cambios. Los archivos de bloqueo se sincronizan a través de su proveedor de nube para que todos los colaboradores vean el mismo estado de bloqueo.
• Escrituras atómicas: Cada ticket es un archivo Markdown único. Kanban Pro escribe primero en un archivo temporal y luego lo renombra en su lugar — evitando actualizaciones parciales incluso si el proveedor de nube se sincroniza a mitad de escritura.
• Detección de finalización de escritura: Kanban Pro espera a que los archivos se estabilicen (2 segundos para tickets, 1 segundo para configuración de tablero) antes de leerlos. Esto garantiza que la sincronización en la nube haya terminado de escribir antes de que la aplicación procese el cambio.
• Última escritura gana para configuración del tablero: El orden de las columnas, la configuración y las definiciones de campos personalizados se almacenan en board.json. Si dos usuarios cambian la configuración del tablero simultáneamente, la última escritura gana — pero esto es raro en la práctica ya que la configuración del tablero cambia poco frecuentemente.

Comprensión de archivos de bloqueo

El directorio .kanban/locks/ contiene archivos de bloqueo temporales que indican qué tickets se están editando actualmente y por quién. Cada archivo de bloqueo es un pequeño documento JSON:

{
  "ticket": "KAN-42",
  "user": "Alice",
  "device": "Alice-MacBook",
  "timestamp": "2026-03-09T10:30:00Z"
}

Los archivos de bloqueo se crean cuando se abre un ticket para editar y se elimina cuando se cierra el editor. Permiten que Kanban Pro muestre un indicador visual en los tickets bloqueados para que los colaboradores sepan que alguien está trabajando en ellos.

Resolución de bloqueos obsoletos

Si Kanban Pro se bloquea o un dispositivo se desconecta, un archivo de bloqueo puede permanecer sin ser limpiado. Esto se llama un bloqueo obsoleto.

Kanban Pro también detecta bloqueos más antiguos de 24 horas y los marca como potencialmente obsoletos en la interfaz de usuario, dándole la opción de desbloquear forzosamente directamente desde la aplicación.

Notas sobre proveedores de nube

Mejores prácticas

• Mantenga las carpetas del proyecto disponibles sin conexión. Marque su carpeta de proyecto como « Disponible sin conexión », « Archivos espejo », « Mantener siempre en este dispositivo » o « Mantener descargado » según su proveedor de nube. Esto evita retrasos causados por descargas de archivos bajo demanda.
• Mantenga la estructura de carpetas poco profunda. Evite directorios profundamente anidados — un diseño plano mejora la confiabilidad de la sincronización en todos los proveedores.
• Verifique el estado de sincronización antes de cerrar su Mac. Busque iconos de sincronización en progreso en el Finder o la barra de menú. Apagar a mitad de la sincronización puede dejar archivos parciales que confunden a los colaboradores.
• Mantenga el almacenamiento libre. Mantenga al menos 10–15 % de espacio libre en su Mac y al menos 20 % de almacenamiento en la nube libre. El almacenamiento bajo puede detener la sincronización o activar la expulsión de archivos.
• Utilice el mismo proveedor de nube en todo el equipo. Mezclar proveedores (por ejemplo, una persona en iCloud, otra en Dropbox) requiere que cada persona tenga su propia copia — no se sincronizarán entre sí.

Solución de problemas

• Los cambios no aparecen: Verifique que su proveedor de nube se está sincronizando activamente. Busque iconos de estado de sincronización en el Finder o el icono de la barra de menú del proveedor de nube. Kanban Pro se actualiza en segundos de detectar un cambio de archivo — si el archivo aún no se ha sincronizado, la aplicación no puede verlo.
• Ticket atrapado como bloqueado: Vea la sección de bloqueos obsoletos arriba. Puede desbloquear forzosamente desde la aplicación (para bloqueos más antiguos de 24 horas) o eliminar manualmente el archivo de bloqueo en .kanban/locks/.
• Tickets faltantes después de la sincronización: Algunos proveedores de nube retrasan la sincronización de nuevos archivos. Espere un momento y verifique el estado de sincronización de su proveedor. Si el problema persiste, verifique que la carpeta esté configurada para sincronizar sin conexión. En iCloud Drive, verifique que los archivos no hayan sido reemplazados por archivos de marcador de posición .icloud.
• Carga inicial lenta: Si su proveedor de nube transmite archivos bajo demanda, la primera carga puede tomar más tiempo mientras se descargan los archivos. Cambie a modo sin conexión o espejo para obtener el mejor rendimiento.
• Sincronización pausada inesperadamente: Algunos proveedores de nube pausan la sincronización cuando su Mac funciona con batería o tiene poco espacio en disco. Verifique el icono de la barra de menú de su proveedor para indicadores de pausa y reanude la sincronización si es necesario.
• Archivos de copia conflictiva apareciendo: Si ve archivos nombrados con « copia conflictiva » en el Finder, probablemente dos personas editaron el mismo archivo sin conexión. Abra ambos archivos para compararlos, mantenga la versión correcta y elimine la copia conflictiva.