Bufdir Schema Config Service
Component Detail
Service Layer
medium complexity
backend
0
Dependencies
0
Dependents
0
Entities
0
Integrations
Description
Manages the versioned server-side configuration that maps internal Meander activity fields to Bufdir's required output structure. Maintained as a versioned config rather than hardcoded so field mappings can be updated when Bufdir changes requirements without a client release.
bufdir-schema-config-service
Sources & reasoning
Versioned schema config is explicitly called out in the implementation notes as a requirement so mappings can be updated when Bufdir changes its format without a client release. Isolating this into its own service keeps the report service clean and makes schema evolution testable.
No source references — this artifact was included based on reasoning alone (see above).
Responsibilities
- Load and validate Bufdir field mapping schema by version
- Expose current active schema version to report service
- Support schema version upgrades without application redeployment
- Validate that all required Bufdir output fields have a mapping
Interfaces
getActiveSchema(): BufdirFieldSchema
getSchemaByVersion(version: string): BufdirFieldSchema
validateMapping(schema: BufdirFieldSchema): ValidationResult
listAvailableVersions(): string[]