BusDK Docs

Overview

• Overview
• FAQ: what are bus and BusDK?
• Purpose and scope
• Deployment and data control
• Visual identity and branding on outputs
• Design goals and requirements
• Module CLI reference

Principles

• CLI-first interfaces
• Deterministic .bus command files
• Modularity
• Schema-driven contract
• Git as source of truth
• Auditability and append-only

Status

• Module capabilities
• Development cost summary
• Source package estimates
• Module CLI quickstart

Platform operations

• Deployment and data control
• AI and external service integration
• Integration and runtime interfaces
• API JWT audiences and scopes
• Append-only and security

Runtime and providers

• bus api (CLI)
• bus api provider llm (CLI)
• bus api provider vm (CLI)
• bus api provider containers (CLI)
• bus events (CLI)
• bus integration upcloud (CLI)
• bus integration ssh runner (CLI)

Product controls

• bus auth (CLI)
• bus billing (CLI)
• bus operator (CLI)
• bus operator auth (CLI)
• bus operator billing (CLI)
• bus operator stripe (CLI)
• bus integration billing (CLI)
• bus integration stripe (CLI)
• bus integration usage (CLI)

Workflow overview

• End-to-end workflow
• Accounting workflow overview
• Sale invoicing
• Scenario introduction
• CLI tooling and workflow

Core flow

• Initialize a new repository
• Configure the chart of accounts
• Add a sales invoice
• Invoice ledger impact
• Record a purchase as a journal transaction

Controls

• Import bank transactions and apply payments
• VAT reporting and payment
• Year-end close
• Generate invoice PDF and register attachment
• Workflow takeaways

Advanced

• AI-assisted classification
• Codex-assisted accountant workflow
• Budgeting and budget-vs-actual reporting
• Finnish payroll
• Inventory valuation and COGS postings
• Workbook editing

Core commands

• bus (CLI)
• bus init (CLI)
• bus config (CLI)
• bus data (CLI)
• bus preferences (CLI)
• bus status (CLI)

User interfaces

• bus sheets (CLI)
• bus books (CLI)
• bus chat (CLI)
• bus ui (CLI)
• bus portal (CLI)
• bus portal auth (CLI)
• bus portal ai (CLI)
• bus portal accounting (CLI)

Automation and integration

• bus api (CLI)
• bus api provider auth (CLI)
• bus api provider billing (CLI)
• bus api provider books (CLI)
• bus api provider containers (CLI)
• bus api provider data (CLI)
• bus api provider events (CLI)
• bus api provider llm (CLI)
• bus api provider session (CLI)
• bus api provider terminal (CLI)
• bus api provider usage (CLI)
• bus api provider vm (CLI)
• bus auth (CLI)
• bus billing (CLI)
• bus containers (CLI)
• bus run (CLI)
• bus agent (CLI)
• bus work (CLI)
• bus secrets (CLI)
• bus dev (CLI)
• bus update (CLI)
• bus shell (CLI)
• bus gateway (CLI)
• bus factory (CLI)
• bus events (CLI)
• bus integration (CLI)
• bus integration billing (CLI)
• bus integration ssh runner (CLI)
• bus integration stripe (CLI)
• bus integration usage (CLI)
• bus integration upcloud (CLI)
• bus operator (CLI)
• bus operator auth (CLI)
• bus operator billing (CLI)
• bus operator stripe (CLI)
• bus operator token (CLI)
• bus faq (CLI)
• bus inspection (CLI)
• bus vm (CLI)

Ledger foundation

• bus bfl (CLI)
• bus ledger (CLI)
• bus accounts (CLI)
• bus entities (CLI)
• bus customers (CLI)
• bus vendors (CLI)
• bus period (CLI)
• bus balances (CLI)

Journal flow

• bus journal (CLI)
• bus memo (CLI)
• bus invoices (CLI)
• bus files (CLI)
• bus bank (CLI)
• bus reconcile (CLI)
• bus attachments (CLI)

Assets and resources

• bus assets (CLI)
• bus loans (CLI)
• bus inventory (CLI)
• bus payroll (CLI)
• bus budget (CLI)

Validation and reports

• bus reports (CLI)
• bus replay (CLI)
• bus validate (CLI)
• bus vat (CLI)
• bus pdf (CLI)
• bus filing (CLI)

Filing targets

• bus filing prh (CLI)
• bus filing vero (CLI)

The module CLI reference covers every current top-level BusDK module in this superproject, including supporting tools that are not always part of the first bookkeeping workflow pass.

Design documents

• Independent modules
• Modularity

Architecture

• System architecture
• Architectural overview
• Independent modules
• Workspace scope
• Shared validation layer

Security and storage

• Append-only and security
• CLI as the primary interface
• Git-backed data repository
• Data formats and storage
• Table Schema contract

Data evolution

• Workspace configuration (datapackage.json)
• CSV conventions
• Append-only updates and soft deletion
• Schema evolution and migration
• Scaling over decades

Workspace layout

• Data directory layout
• Layout principles
• Workspace baseline
• Minimal example layout
• Schemas beside datasets

Layout areas

• Accounts area
• Invoices area
• Journal area
• VAT area
• Budgeting area

Master data

• Master data (business objects)
• Accounting entity
• Chart of accounts
• Accounting periods
• Bookkeeping status

Commercial and cash

• Sales invoices
• Purchase invoices
• Bank transactions
• Reconciliations
• Evidence documents

People, assets, and planning

• Fixed assets
• Loans
• Employees
• Inventory items
• Budgets

CLI behavior

• CLI tooling (index)
• Standard global flags
• .bus script files (writing and execution guide)
• CLI command naming
• Required command surface
• Validation and safety checks

Integration and quality

• Integration and runtime interfaces
• Extensibility model
• Deployment and data control
• Testing
• References
• Sources

Compliance

• Finnish bookkeeping and tax-audit compliance
• Finnish company reorganisation evidence pack

Sources

• Overview
• Module CLI reference
• Workflow examples
• Deployment and data control