Data Package organization

Data Package organization

BusDK uses a Frictionless Data Package descriptor (typically datapackage.json) at the workspace root to provide a whole-workspace manifest of resources and their schemas. A Data Package descriptor lists resources, their paths, and their schema references, enabling whole-workspace validation and standardized publication or interchange patterns. See Frictionless Data Package.

The descriptor is also the home for workspace-level BusDK metadata that is not naturally represented as a row-level field in operational datasets. For example, accounting entity configuration lives under the top-level busdk.accounting_entity object in datapackage.json (see Workspace configuration (datapackage.json extension)). This relies on Frictionless descriptor extensibility: additional properties are compatible with standard tooling and can be ignored safely by tools that do not understand BusDK.

For Finnish compliance, a Data Package descriptor SHOULD be used as the manifest inside tax-audit export packs to make datasets and schemas self-describing. See Finnish bookkeeping and tax-audit compliance.