Register a Driver Honorarium for a Driving Engagement
Peer mentors who act as volunteer drivers for their organisation (particularly Blindeforbundet, where drivers transport members to appointments) are entitled to a driver honorarium. The Driver Honorarium Screen allows the peer mentor to select the relevant assignment or activity the driving was associated with, input the number of trips or engagements, and view the automatically calculated honorarium amount based on the organisation's configured rate. On submission, a record is written to the driver_honorariums table linked to the relevant activity or assignment. The Honorarium Service applies the per-organisation rate rules and thresholds. This data is subsequently available for accounting system integration (e.g. Xledger for Blindeforbundet).
User Story
Acceptance Criteria
- Given a peer mentor opens the Driver Honorarium Screen, when the screen loads, then it displays the current applicable honorarium rate configured for their organisation
- Given the peer mentor enters the number of driving trips, when the value is entered, then the honorarium amount is calculated automatically and displayed before submission
- Given the peer mentor submits the honorarium record, when the Honorarium Service validates and saves it, then a record is written to driver_honorariums linked to the relevant activity or assignment with the correct calculated amount
- Given the peer mentor attempts to submit without selecting an associated activity or assignment, when validation runs, then a clear error message is shown and submission is blocked
- Given the honorarium record is successfully saved, when the peer mentor views the confirmation, then they see the trip count, calculated amount, associated activity/assignment reference, and submission timestamp
- Given a network failure occurs during submission, when the peer mentor retries, then no duplicate honorarium records are created
Business Value
Accurate driver honorarium registration ensures peer mentors are fairly compensated and eliminates the manual reconciliation work currently performed by coordinators. Digital capture creates an auditable accounting trail suitable for integration with Xledger or other accounting systems, reducing errors and administrative overhead associated with paper-based or informal honorarium tracking.
Components
- Driver Honorarium Screen ui
- Honorarium Service service
- NDA Repository data
- Document Signing Infrastructure infrastructure