Bufdir Export Service
Component Detail
Service Layer
high complexity
backend
2
Dependencies
1
Dependents
17
Entities
0
Integrations
Description
Server-side service that orchestrates the full Bufdir export pipeline: queries activity data for the selected reporting period from PostgreSQL, applies configurable field mapping rules from a JSON format specification, and produces the output file in XLSX or CSV format. The mapping layer is decoupled from the query layer so that Bufdir format changes require only configuration updates.
bufdir-export-service
Responsibilities
- Query activity records by reporting period from PostgreSQL
- Apply Bufdir field mapping rules from JSON configuration
- Generate export files in XLSX and CSV formats
- Produce preview data for the admin UI before download
- Create audit log entries for every export action
Interfaces
generatePreview(organizationId, periodStart, periodEnd)
generateExport(organizationId, periodStart, periodEnd, format)
getExportHistory(organizationId)
getExportById(exportId)
downloadExportFile(exportId)
validateReportingPeriod(periodStart, periodEnd)
getAvailableFormats()
getFieldMappingConfig()
Relationships
Dependencies (2)
Components this component depends on
Related Data Entities (17)
Data entities managed by this component
Activity
26 fields
core
Audit Log
16 fields
audit
Bufdir Report
21 fields
core
Expense
23 fields
core
Organization
17 fields
core
Accounting Exports
23 fields
core
Activities
24 fields
core
Activity Approvals
14 fields
core
Audit Logs
14 fields
audit
Bufdir Reports
25 fields
core
Documents
20 fields
core
Expense Receipts
22 fields
core
Expense Types
25 fields
configuration
Expenses
31 fields
core
Local Associations
17 fields
core
Organizations
25 fields
core
Reimbursements
21 fields
core