Kanban Pro

Cloud Sync

Lær, hvordan du deler cloudmapper og samarbejder i realtid.

Sådan fungerer Cloud Sync

Kanban Pro er et lokalt program. Hvert projekt er en mappe på dit filsystem med Markdown-ticketfiler og et konfigurationsmappe .kanban/. Der er ingen konti, ingen proprietære cloudservices og ingen tilmeldinger.

For at samarbejde med andre skal du blot placere din projektmappe i en cloud-synkroniseret mappe — iCloud Drive, Dropbox, Google Drive, OneDrive eller ethvert netværksdrev. Hver deltager åbner den samme mappe i Kanban Pro, og ændringer forplantes automatisk gennem cloududbyderens filsynkronisering.

Tip

Ingen Kanban Pro-konto er påkrævet. Synkronisering bruger filsystemet direkte — hvis din cloududbyders kan synkronisere en mappe, fungerer Kanban Pro med den.

Opsætning af et delt projekt

  1. Vælg en cloudmappe. Åbn Finder og naviger til din cloududbyders synkroniseringsmappe (f.eks. ~/Library/Mobile Documents/com~apple~CloudDocs/ for iCloud Drive, ~/Dropbox/ for Dropbox, eller Google Drive-/OneDrive-monteringen i din Finder-sidebar).
  2. Opret en projektmappe. Opret en ny mappe til dit projekt, f.eks. Team Board.
  3. Åbn den i Kanban Pro. Start Kanban Pro, klik på Åbn mappe, og vælg den mappe, du lige har oprettet. Kanban Pro initialiserer mappen .kanban/ og du kan begynde at tilføje kolonner og tickets.
  4. Del mappen. Brug din cloududbyders delingsfunktioner til at invitere medarbeidere. Højreklik på mappen i iCloud Drive og vælg Del. I Dropbox eller Google Drive, brug delingsdialogen. I OneDrive, højreklik og vælg Del → Del via OneDrive. Hver medarbeidr bør derefter åbne den samme synkroniserede mappe i deres egen kopi af Kanban Pro.

Tip

Indstil tilladelser til Kan redigere (ikke Kan se) når du deler, så medarbeidere kan oprette og opdatere tickets.

Anbefalet mappestruktur

Når Kanban Pro initialiserer et projekt, oprettes følgende struktur i din valgte mappe:

Team Board/
  .kanban/ — projektkonfiguration
    board.json — kolonner, indstillinger, brugerdefinerede felter
    locks/ — aktive redigeringslåse (se nedenfor)
    activity/ — aktivitetslogposter
  attachments/ — uploadede billeder og filer
  KAN-1.md — ticket (Markdown + YAML frontmatter)
  KAN-2.md
  KAN-3.md

Hvert ticket er en almindelig Markdown-fil med YAML frontmatter for metadata (status, prioritet, tildelt til, tags, brugerdefinerede felter). Du kan læse, redigere eller sikkerhedskopiere disse filer med ethvert værktøj — herunder AI-kodningsagenter, der arbejder direkte med filsystemet.

Realtidssynkronisering og konfliktfri redigering

Kanban Pro overvåger projektmappen for filsystemændringer ved hjælp af en realtid filmonitor. Når en medarbeidr gemmer et ticket eller opdaterer boardkonfigurationen, detekteres ændringen inden for sekunder, og brugerfladen opdateres automatisk.

Sådan undgås konflikter

  • Ticketlåsning: Når du åbner et ticket til redigering, opretter Kanban Pro en lille låsefil i .kanban/locks/. Andre brugere ser ticketet som låst og kan ikke overskrive dine ændringer. Låsefiler synkroniseres gennem din cloududbyders, så alle medarbeidere ser den samme låsetilstand.
  • Atomare skrivninger: Hvert ticket er en enkelt Markdown-fil. Kanban Pro skriver først til en midlertidig fil, derefter omdøber den — hvilket forhindrer delvise opdateringer, selvom cloududbyders synkroniserer under skrivningen.
  • Skrive-afslutningsdetektering: Kanban Pro venter, til filerne stabiliseres (2 sekunder for tickets, 1 sekund for boardkonfiguration) før læsning. Dette sikrer, at cloudsynkronisering er færdig med skrivningen, før appen behandler ændringen.
  • Sidste-skrivning-vinder for boardkonfiguration: Kolonnerekkefølge, indstillinger og brugerdefinerede feltdefinitioner gemmes i board.json. Hvis to brugere ændrer boardindstillinger samtidigt, vinder den sidste skrivning — men dette er sjældent i praksis, da boardkonfiguration sjældent ændres.

Forståelse af låsefiler

Mappen .kanban/locks/ indeholder midlertidige låsefiler, der angiver, hvilke tickets der i øjeblikket bliver redigeret og af hvem. Hver låsefil er et lille JSON-dokument:

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

Låsefiler oprettes, når et ticket åbnes til redigering og fjernes, når editoren lukkes. De gør det muligt for Kanban Pro at vise en visuel indikator på låste tickets, så medarbeidere ved, at nogen arbejder på dem.

Løsning af forældede låse

Hvis Kanban Pro styrter ned eller en enhed går offline, kan en låsefil blive tilbage uden at blive ryddet. Dette kaldes en forældet låse.

Forældet låse?

Hvis et ticket ser låst ud, men ingen redigerer det, kan du trygt slette den tilsvarende fil i .kanban/locks/ ved hjælp af Finder eller terminalen. Kanban Pro detekterer fjernelsen og låser ticketet op.

Kanban Pro detekterer også låse ældre end 24 timer og markerer dem som potentielt forældede i brugerfladen, hvilket giver dig mulighed for at tvinge låseoplukningen direkte fra appen.

Cloududbydernoter

iCloud Drive

iCloud Drive fungerer problemfrit med Kanban Pro. macOS holder for nylig få tilgange til filer downloadet lokalt, så dit board indlæses øjeblikkeligt. Hvis en ticketfil er blevet fjernet fra lokal lagring (vist som en lille .icloud placeholder i Finder), downloader macOS den efter behov — du kan bemærke en kort forsinkelse ved første åbning af meget store projekter.

Deling af en iCloud Drive-mappe

  1. Åbn Finder og naviger til din iCloud Drive-mappe i sidepanelet.
  2. Højreklik på projektmappen og vælg Del → Samarbejd.
  3. Indstil tilladelser til "Kun inviterede personer" og "Kan foretage ændringer".
  4. Indtast e-mailadresser på dine medarbeidere og klik Del.

Tip

For at holde projektfiler altid tilgængelige på din Mac, højreklik på projektmappen i Finder og vælg Hold downloadet. Dette forhindrer macOS i at fjerne filer for at spare plads.

Dropbox

Dropbox fungerer godt med Kanban Pro, men dens Smart Sync-funktion kan fjerne ticketfiler for at spare diskplads. Markér din projektmappe som Tilgængelig offline for optimale resultater, så alle filer bliver på din Mac.

Opsætning af offline-adgang

  1. Åbn Finder og naviger til din Dropbox-mappe.
  2. Højreklik på projektmappen.
  3. Vælg Gør tilgængelig offline.
  4. Et grønt hak bekræfter, at mappen nu gemmes lokalt.

Deling af en Dropbox-mappe

  1. Højreklik på projektmappen i Finder.
  2. Klik Del… (ved siden af Dropbox-ikonet).
  3. Klik Tilføj personer, indtast e-mailadresser og indstil tilladelser til Kan redigere.
  4. Klik Del for at sende invitationen.

Google Drive

Google Drive for Desktop tilbyder to synkroniseringstilstande. For Kanban Pro anbefales Spejlfiler mode stærkt, fordi det holder en fuldstændig lokal kopi af dit projekt — hvilket sikrer øjeblikkelig adgang uden downloadforsinkelser.

Skift til spejlmodus

  1. Klik på Google Drive-ikonet i dit menubjælke.
  2. Åbn Indstillinger.
  3. Under "Min Drive synkroniseringsmuligheder" vælg Spejlfiler.
  4. Google Drive downloader alle filer til din Mac. Dette kan tage et stykke tid for store biblioteker.

Advarsel

Standard "Stream filer" mode downloader filer efter behov, hvilket kan forårsage mærkbar latens, når Kanban Pro læser ticketfiler. Skift til spejlmodus for det bedste resultat.

Deling af en Google Drive-mappe

  1. Højreklik på projektmappen i Finder (indeni din Google Drive-montering).
  2. Klik Del.
  3. Indtast e-mailadresser på medarbeidere og indstil adgang til Editor.
  4. Klik Del for at sende invitationen.

OneDrive

OneDrive for Mac fungerer godt med Kanban Pro. Som andre cloudservices tilbyder OneDrive en Filer efter behov-funktion, der kan fjerne filer fra lokal lagring. For bedste resultater indstil din projektmappe til Behold altid på denne enhed.

Hold filer tilgængelige lokalt

  1. Åbn Finder og naviger til din OneDrive-mappe.
  2. Højreklik på projektmappen.
  3. Vælg Behold altid på denne enhed.
  4. Et grønt hak bekræfter, at mappen forbliver downloadet.

Deling af en OneDrive-mappe

  1. Højreklik på projektmappen i Finder.
  2. Vælg Del → Del via OneDrive.
  3. Indtast e-mailadresser på medarbeidere og indstil tilladelser til Kan redigere.
  4. Klik Send.

Tip

Undgå specialtegn i mappe- eller filnavne (:, *, ?, |) — OneDrive understøtter ikke dem og kan forårsage synkroniseringsfejl.

Netværksdrev og NAS

Kanban Pro fungerer med ethvert monteret netværksvolumen (SMB, AFP, NFS). Sørg for, at drevet forbliver monteret, mens du arbejder. Hvis netværksforbindelsen falder ud, pauser Kanban Pro filmonitoringen og genoptager når volumenet bliver tilgængeligt igen.

Bedste praksis

  • Hold projektmapper tilgængelige offline. Markér din projektmappe som "Tilgængelig offline", "Spejlfiler", "Behold altid på denne enhed" eller "Hold downloadet" afhængigt af din cloududbyders. Dette undgår forsinkelser forårsaget af on-demand fildownloads.
  • Hold mappestrukturen flad. Undgå dybt indlejrede mapper — et fladt layout forbedrer synkroniseringspålideligheden på tværs af alle udbydere.
  • Kontroller synkroniseringsstatus før lukning af din Mac. Se efter synkroniseringsikoner i Finder eller menubjælken. Nedlukning under synkronisering kan efterlade delvise filer, der forvirrer medarbeidere.
  • Bevar fri lagring. Hold mindst 10–15% fri diskplads på din Mac og mindst 20% fri cloudlagring. Lav lagring kan standse synkronisering eller udløse filfjernelse.
  • Brug samme cloududbyders på tværs af teamet. Blanding af udbydere (f.eks. en person på iCloud, en anden på Dropbox) kræver, at hver person har sin egen kopi — de synkroniseres ikke med hinanden.

Fejlfinding

  • Ændringer bliver ikke vist: Kontroller, at din cloududbyders aktivt synkroniserer. Se efter synkroniseringsikoner i Finder eller din cloududbyders menubjælkikon. Kanban Pro opdateres inden for sekunder efter at have detekteret en filændring — hvis filen ikke endnu er blevet synkroniseret, kan appen ikke se den.
  • Ticket sidder fast som låst: Se forældede låse-afsnittet ovenfor. Du kan tvinge lås op fra appen (for låse ældre end 24 timer) eller manuelt slette låsefilen i .kanban/locks/.
  • Tickets mangler efter synkronisering: Nogle cloududbyders forsinker synkroniseringen af nye filer. Vent et øjeblik og kontroller din udbyderes synkroniseringsstatus. Hvis problemet fortsætter, kontroller at mappen er indstillet til offline-synkronisering. Kontroller i iCloud Drive, at filer ikke er erstattet af .icloud placeholder-filer.
  • Langsom indledende indlæsning: Hvis din cloududbyders streamer filer efter behov, kan den første indlæsning tage længere tid, mens filer downloades. Skift til offline eller spejlmodus for bedste performance.
  • Synkronisering paused uventet: Nogle cloududbyders pauser synkronisering når din Mac kører på batteri eller har lav diskplads. Kontroller din udbyders menubjælkikon for pauseindikationer og genoptag synkronisering hvis nødvendigt.
  • Konfliktkopierede filer vises: Hvis du ser filer navngivet med "conflicted copy" i Finder, redigerede to personer sandsynligvis samme fil mens offline. Åbn begge filer for at sammenligne, behold den korrekte version og slet den konfliktkopierede.