Bulk Register a Recurring Group Activity for Multiple Peer Mentors
Coordinators manage recurring group activities — weekly training sessions, monthly group meetings — with many participants. Entering each participant separately is prohibitively slow. The bulk registration flow should allow the coordinator to select multiple peer mentors from a multi-select list, define shared activity details once, preview the full batch before confirming, and submit all records in a single batch RPC call. The UI should clearly display the participant count and allow removal of individual participants before final confirmation.
User Story
Acceptance Criteria
- Given the coordinator selects 'Bulk register' from the proxy mode selector, when the multi-select screen loads, then all peer mentors within their scope appear with checkboxes and a 'select all' control
- Given the coordinator has selected multiple peer mentors, when they proceed to the activity form, then they fill in the shared activity details once and a participant count badge shows how many records will be created
- Given the coordinator reaches the bulk confirmation screen, when they review the batch, then each participant is listed with the activity details and they can deselect individuals before submitting
- Given the coordinator confirms the batch, when the batch is submitted, then all records are inserted via a single batch RPC call and each is attributed to the correct peer mentor with a proxy audit marker
- Given a network failure occurs mid-batch, when the coordinator retries, then the system prevents duplicate submissions by detecting already-inserted records from the same batch
Business Value
HLF reported one peer mentor with 380 individual activity registrations in a single year. Coordinators overseeing large chapters with weekly group sessions would face hundreds of manual entries annually without bulk registration. This directly reduces coordinator burden, increases reporting completeness, and improves Bufdir data quality. NHF and HLF both explicitly requested this capability, making it a cross-organisational requirement with measurable impact on operational efficiency.
Components
- Proxy Mode Selector Screen ui
- Peer Mentor Multi-Select List ui
- Bulk Registration Confirmation Screen ui
- Bulk Registration Service service
- Proxy Activity Repository data
- Proxy Contact List Provider data
- Batch Insert RPC Adapter infrastructure
- Bulk Proxy Registration Screen ui
- Mentor Multi-Select Widget ui
- Proxy Confirmation Screen ui
- Bulk Registration Orchestrator service
- Bulk Registration Screen ui
- Proxy Peer Mentor Selector ui
- Bulk Participant List Widget ui
- Proxy Activity Form ui
- Bulk Registration Service service
- Proxy Registration BLoC service
- Coordinator Role Guard infrastructure
- Bulk Registration Defaults Provider infrastructure
- Proxy Audit Logger infrastructure