Pilvisynkronointi

Kuinka pilvisynkronointi toimii

Kanban Pro on paikallisesti ensisijaisesti suunniteltu sovellus. Jokainen projekti on kansio tiedostojärjestelmässäsi, joka sisältää Markdown-lipukkeita ja .kanban/-konfiguraatiohakemiston. Tilejä, omistettuja pilvipalveluja tai rekisteröintejä ei ole.

Yhteistyöskentelyn mahdollistamiseksi aseta yksinkertaisesti projektin kansio pilvisynkronoidun hakemiston sisään — iCloud Drive, Dropbox, Google Drive, OneDrive tai mikä tahansa verkkoasema. Jokainen osallistuja avaa saman kansion Kanban Prossa, ja muutokset leviävät automaattisesti pilvipalvelun tiedostosynkronoinnin kautta.

Jaetun projektin määrittäminen

1. Valitse pilvikansio. Avaa Finder ja siirry pilvipalvelusi synkronointihakemistoon (esim. ~/Library/Mobile Documents/com~apple~CloudDocs/ iCloud Drivelle, ~/Dropbox/ Dropboxille tai Google Drive- / OneDrive-liitäntä Finderin sivupalkissa).
2. Luo projektin kansio. Luo uusi kansio projektillesi, esim. Team Board.
3. Avaa se Kanban Prossa. Käynnistä Kanban Pro, napsauta Avaa kansio ja valitse juuri luomasi kansio. Kanban Pro alustaa .kanban/-hakemiston ja voit alkaa lisätä sarakkeita ja lipukkeita.
4. Jaa kansio. Käytä pilvipalvelusi jakamisominaisuuksia ja kutsu yhteistyöskentelijöitä. iCloud Drivessa napsauta kansion oikealla painikkeella ja valitse Jaa. Dropboxissa tai Google Drivessa käytä jakamisdialogissa. OneDrivessa napsauta oikealla painikkeella ja valitse Jaa → Jaa OneDriven kanssa. Jokaisen yhteistyöskentelijän tulee sitten avata sama synkronoidun kansio omassa Kanban Pro -kopioissaan.

Suositeltava kansiorakenne

Kun Kanban Pro alustaa projektin, se luo seuraavan rakenteen valitussa kansiossa:

Jokainen lipuke on tavallinen Markdown-tiedosto, jossa on YAML frontmatter metadatalle (tila, prioriteetti, määritettävä henkilö, tunnisteet, mukautetut kentät). Voit lukea, muokata tai varmuuskopioida nämä tiedostot millä tahansa työkalulla — mukaan lukien tekoälysovellukset, jotka työskentelevät suoraan tiedostojärjestelmän kanssa.

Reaaliaikainen synkronointi ja ristiriitatonta muokkaus

Kanban Pro valvoo projektin kansiota tiedostojärjestelmän muutoksista reaaliaikaista tiedostontarkistajaa käyttäen. Kun yhteistyöskentelijä tallentaa lipukkeen tai päivittää palkin konfiguraatiota, muutos havaitaan sekunnissa ja käyttöliittymä virkistyy automaattisesti.

Kuinka ristiriidat vältetään

• Lipukkeiden lukitseminen: Kun avaat lipukkeen muokkaamista varten, Kanban Pro luo pienen lukitustiedoston .kanban/locks/-kansioon. Muut käyttäjät näkevät lipukkeen lukittuna eivätkä voi korvata muutoksiasi. Lukitustiedostot synkronoidaan pilvipalvelussa, joten kaikki yhteistyöskentelijät näkevät saman lukitustilan.
• Atomiset kirjoitukset: Jokainen lipuke on yksi Markdown-tiedosto. Kanban Pro kirjoittaa ensin väliaikaisen tiedoston ja sitten nimeää sen uudelleen — estäen osittaiset päivitykset, vaikka pilvipalvelu synkronoisi kirjoituksen aikana.
• Kirjoitusvalmistuksen tunnistaminen: Kanban Pro odottaa, kunnes tiedostot vakiintuvat (2 sekuntia lipukkeiden, 1 sekunti palkin konfiguraatiolle) ennen lukemista. Tämä varmistaa, että pilvisynkronointi on valmistunut ennen kuin sovellus käsittelee muutoksen.
• Viimeinen kirjoitus voittaa palkin konfiguraatiolle: Sarakkeiden järjestys, asetukset ja mukautettujen kenttien määritelmät tallennetaan board.json-tiedostoon. Jos kaksi käyttäjää muuttaa palkin asetuksia samanaikaisesti, viimeinen kirjoitus voittaa — mutta käytännössä tämä on harvinaista, koska palkin konfiguraatio muuttuu harvoin.

Lukitustiedostojen ymmärtäminen

.kanban/locks/-hakemisto sisältää väliaikaisia lukitustiedostoja, jotka ilmaisevat, mitkä lipukkeet muokataan tällä hetkellä ja kuka. Jokainen lukitustiedosto on pieni JSON-asiakirja:

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

Lukitustiedostot luodaan, kun lipuke avataan muokkaamista varten, ja poistetaan, kun muokkain suljetaan. Niiden avulla Kanban Pro voi näyttää visuaalisen indikaattorin lukituille lipukkille, jotta yhteistyöskentelijät tietävät, että joku työstää niitä.

Vanhentuneista lukitoista selviytyminen

Jos Kanban Pro kaatuu tai laite menee offline-tilaan, lukitustiedosto voi jäädä ilman puhdistusta. Tätä kutsutaan vanhentuneeksi lukoksi.

Kanban Pro havaitsee myös yli 24 tuntia vanhat lukot ja merkitsee ne mahdollisesti vanhentuneiksi käyttöliittymässä, mikä antaa sinulle mahdollisuuden pakottaa lukitus avattavaksi suoraan sovelluksesta.

Pilvipalvelun huomautukset

Parhaat käytännöt

• Pidä projektin kansiot saatavilla offline. Merkitse projektin kansiosi arvoon "Saatavilla offline", "Peilaa tiedostoja", "Pidä aina tällä laitteella" tai "Pidä ladattuna" pilvipalvelusi mukaan. Tämä välttää pyyntöjen perusteella tapahtuvan tiedostolatauksen aiheuttamia viiveitä.
• Pidä kansiorakenne matala. Vältä syvästi sisäkkäisiä hakemistoja — tasainen asettelu parantaa synkronoinnin luotettavuutta kaikissa palveluntarjoajissa.
• Tarkista synkronointitila ennen Macin sulkemista. Etsi synkronoinnin käynnissä -kuvakkeet Finderissa tai valikkorivillä. Sammuttaminen synkronoinnin aikana voi jättää osittaisia tiedostoja, jotka hämmentävät yhteistyöskentelijöitä.
• Ylläpidon vapaaa tallennustilaa. Pidä vähintään 10–15 % vapaata levytilaa Macissa ja vähintään 20 % vapaata pilvitallennustilaa. Matala tallennustila voi pysäyttää synkronoinnin tai käynnistää tiedoston poistamisen.
• Käytä samaa pilvipalvelua koko tiimissä. Palveluntarjoajien sekoittaminen (esim. yksi henkilö iCloudissa, toinen Dropboxissa) vaatii jokaisen omaksi kopioiksi — ne eivät synkronoidu keskenään.

Vianmääritys

• Muutokset eivät näy: Tarkista, että pilvipalvelusi synkronoi aktiivisesti. Etsi synkronointitilan kuvakkeet Finderissa tai pilvipalvelun valikkorivin kuvakkeesta. Kanban Pro virkistyy sekunnissa tiedoston muutoksen havaitsemisen jälkeen — jos tiedostoa ei ole vielä synkronoitu, sovellus ei voi nähdä sitä.
• Lipuke jää lukituksi: Katso vanhentuneita lukituksia koskevia edellä olevia tietoja. Voit pakottaa lukituksen avaamisen sovelluksesta (lukkoille, jotka ovat yli 24 tuntia vanhoja) tai poistaa lukitustiedoston manuaalisesti .kanban/locks/-kansiosta.
• Lipukkeet puuttuvat synkronoinnin jälkeen: Jotkut pilvipalveluntarjoajat lykkäävät uusien tiedostojen synkronointia. Odota hetki ja tarkista palveluntarjoajan synkronointitila. Jos ongelma jatkuu, varmista, että kansio on asetettu synkronoimaan offline-tilassa. iCloud Drivessä tarkista, että tiedostoja ei ole korvattu .icloud-paikkamerkeillä.
• Hidas alkuaineen lataus: Jos pilvipalvelusi virtaa tiedostoja pyynnöstä, ensimmäinen lataus voi kestää kauemmin tiedostojen latauksesta. Vaihda offline- tai peilaustilaan parasta suorituskykyä varten.
• Synkronointi keskeytyy odottamatta: Jotkut pilvipalveluntarjoajat keskeyttävät synkronoinnin, kun Mac on akulla tai levytilaa on vähän. Tarkista palveluntarjoajasi valikkorivin kuvakkeesta pysäytyksen ilmaisimet ja jatka synkronointia tarvittaessa.
• "Conflicted copy" -nimetyt tiedostot näkyvät: Jos näet tiedostoja, jotka on nimetty "conflicted copy" -nimellä Finderissa, kaksi henkilöä muokkaa samaa tiedostoa offline-tilassa. Avaa molemmat tiedostot vertailtavaksi, pidä oikea versio ja poista ristiriitainen tiedosto.