BusDK Docs
BusDK Docs
  • Get started ▸
    • Overview
    • Design goals and requirements
    • Development status
      • Accounting workflow
      • Sale invoicing
      • Inventory valuation
      • Spreadsheet workbooks
      • Finnish bookkeeping and tax
      • Finnish company reorganisation
      • Developer workflow (Cursor)
      • Developer workflow (Gemini)
      • Developer workflow (Claude)
      • Developer workflow (Codex)
      • Finnish payroll
      • Orphan modules
    • Regulated report PDFs (TASE, tuloslaskelma)
    • Finnish WebView UI requirements
    • Go optimization guide
    • Cost summary
  • Workflows ▸
    • Accounting workflow overview
    • Sale invoicing (sending invoices to customers)
    • Example end-to-end workflow
    • Finnish payroll (monthly pay run)
    • CLI tooling and workflow
  • Modules ▸
    • Modules overview
    • Module feature table
    • bus
    • bus init
    • bus config
    • bus data
    • bus api
    • bus sheets
    • bus dev
    • bus agent
    • bus secrets
    • bus bfl
    • bus accounts
    • bus entities
    • bus period
    • bus preferences
    • bus attachments
    • bus invoices
    • bus journal
    • bus bank
    • bus reconcile
    • bus assets
    • bus loans
    • bus inventory
    • bus payroll
    • bus budget
    • bus reports
    • bus validate
    • bus vat
    • bus pdf
    • bus filing
    • bus filing prh
    • bus filing vero
  • Software Design Documents ▸
    • SDD overview
    • bus
    • bus init
    • bus config
    • bus data
    • bus api
    • bus sheets
    • bus dev
    • bus agent
    • bus secrets
    • bus bfl
    • bus accounts
    • bus entities
    • bus period
    • bus preferences
    • bus attachments
    • bus invoices
    • bus journal
    • bus bank
    • bus reconcile
    • bus assets
    • bus loans
    • bus inventory
    • bus payroll
    • bus budget
    • bus reports
    • bus validate
    • bus vat
    • bus pdf
    • bus filing
    • bus filing prh
    • bus filing vero
  • Design ▸
    • System architecture
    • Data formats and storage
    • Data directory layout
  • Reference ▸
    • Master data
    • Integration and future interfaces
    • Extensibility model
    • Testing
    • References and foundations
  • Compliance ▸
    • Finnish bookkeeping and tax-audit
    • Finnish balance sheet and income statement regulation
    • Finnish closing deadlines and legal milestones
    • Finnish closing checklist and reconciliations
    • Finnish closing adjustments and evidence controls
    • Finnish company reorganisation (yrityssaneeraus)

BusDK Design Spec: System architecture

In this section

This section is split into single-concept documents:

Append-only discipline and security model, Architectural overview, CLI as the primary interface (controlled read/modify/write), and Git-backed data repository (the data store) define core runtime and storage architecture.

Independent modules (integration through shared datasets), Workspace scope and multi-workspace workflows, and Shared validation layer (schema + logical validation) define module boundaries and integration contracts.

← Unix-style composability (micro-tools) BusDK Docs Append-only discipline and security model →

Sources

  • Architecture index
  • Data directory layout (principles)
  • Design goals index
Improve this page BusDK · GitHub · Releases · Issues © 2026 Heusala Group Ltd