BusDK Docs

Overview

• Overview
• FAQ: what are bus and BusDK?
• Purpose and scope
• 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
• BusDK module pricing
• Module CLI quickstart

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 ui (CLI)
• bus portal (CLI)

Automation and integration

• bus api (CLI)
• bus api provider books (CLI)
• bus api provider data (CLI)
• bus api provider session (CLI)
• bus run (CLI)
• bus agent (CLI)
• bus secrets (CLI)
• bus dev (CLI)
• bus update (CLI)
• bus shell (CLI)
• bus gateway (CLI)
• bus factory (CLI)
• bus events (CLI)
• bus faq (CLI)
• bus inspection (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 future interfaces
• Extensibility model
• Testing
• References
• Sources

Compliance

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

Sources

• Overview
• Module CLI reference
• Workflow examples