BusDK Update

Dokumentaatio jäsentyy arkkitehtuuriksi, työnkuluiksi ja tiedostorakenteeksi

24.1.2026 BusDK:n julkinen dokumentaatio muuttuu yhdestä pitkästä suunnitelmasta selattavaksi kokonaisuudeksi. Samalla mukaan tulee ensimmäinen konkreettinen esimerkkirakenne siitä, miltä valmis kirjanpitoaineisto voisi näyttää hakemistoina ja tiedostoina.

24.1.2026 Dokumentaatio Arkkitehtuuri Esimerkkirakenne

Tiiviisti

TL;DR

Dokumentaatio jaettiin omiin arkkitehtuuri-, komentorivi-, data- ja työnkulkusivuihinsa.
BusDK:n komentorivi kuvataan tietoisesti aineiston vartijaksi, ei vain tiedostojen muokkaajaksi.
Ensimmäinen konkreettinen hakemistorakenne teki näkyväksi tilit, päiväkirjan, laskut, ALV-aineiston ja skeemat.
Nykyinen jatkoversio löytyy osoitteesta docs.busdk.com.

Tämä muutos tekee BusDK:sta helpomman ymmärtää, koska eri asiat erotetaan omille sivuilleen. Arkkitehtuurissa avataan, miksi järjestelmä rakentuu löyhästi toisiinsa kytkeytyvien moduulien ympärille. Komentoriviä käsittelevä osio puolestaan sanoo suoraan, että komennon tehtävä ei ole vain kirjoittaa rivejä tiedostoon, vaan lukea, tarkistaa, päivittää ja tallentaa muutos hallitusti.

busdk journal add --date 2026-01-15 \
  --debit Cash \
  --credit Sales \
  --amount 500 \
  --desc "Invoice 1001 payment"

load the necessary resources from the repository
validate requested changes
write the updated files
then commit the change

Vielä näkyvämpi muutos on ensimmäinen konkreettinen esimerkkirakenne. Dokumentaatio näyttää nyt suoraan, että aineisto voisi jakautua esimerkiksi tileihin, päiväkirjaan, laskuihin, ALV-aineistoon, budjetteihin ja skeemoihin. Tällainen rakenne tekee heti ymmärrettäväksi, mitä tiedostoja käyttäjä oikeasti ylläpitää ja mitä moduulit lukevat.

my-business-books/
  accounts/
    accounts.csv
  journal/
    journal_2026.csv
  invoices/
    sales_invoices.csv
    sales_invoice_lines.csv
  vat/
    vat_return_2026Q1.csv
  schemas/
    journal.schema.json

BusDK:n julkinen dokumentaatio alkaa tässä vaiheessa palvella sekä käyttöönottoa että arviointia. Yhdestä paikasta näkee sekä toimintamallin että aineiston rakenteen. Tätä varhaista rakennetta voi verrata nykyiseen kokonaisuuteen julkisessa dokumentaatiossa.