BusDK Update

Dokumentaatio jäsentyy arkkitehtuuriksi, työnkuluiksi ja tiedostorakenteeksi

24.1.2026 BusDK:n julkinen dokumentaatio muuttuu yhdestä pitkästä suunnitelmasta selattavaksi kokonaisuudeksi. Mukaan tulee myös 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 aineiston hallituksi käsittelypinnaksi, ei pelkäksi 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.

Dokumentaatiota on nyt helpompi lukea, koska eri asiat erotetaan omille sivuilleen. Arkkitehtuurissa avataan, miksi järjestelmä rakentuu löyhästi toisiinsa kytkeytyvien moduulien ympärille. Komentoriviä käsittelevä osio sanoo suoraan, että komento lukee, tarkistaa, päivittää ja tallentaa muutoksen 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.