Assign Peer Mentor to Additional Chapter Without Removing Existing Affiliations
The chapter assignment editor must support additive operations. Adding a peer mentor to a new chapter is a non-destructive action that appends a new affiliation record without touching existing ones. The editor must list currently active affiliations clearly and provide a way to add a new chapter via a searchable dropdown of chapters the coordinator has admin access to. The multi-chapter membership service enforces a maximum of 5 simultaneous active affiliations per contact as per NHF's operational rules.
User Story
Acceptance Criteria
- Given a peer mentor already has two chapter affiliations, when a coordinator opens the chapter assignment editor and adds a third chapter, then all three affiliations are active after saving
- Given a peer mentor already has five active chapter affiliations (the maximum), when a coordinator attempts to add a sixth, then the save button is disabled and an explanatory message states the maximum has been reached
- Given the chapter assignment editor is open, when the coordinator searches for a chapter by partial name, then matching chapters are shown in a dropdown for selection
- Given the coordinator selects a chapter that the peer mentor is already affiliated with, when attempting to save, then a validation error is shown indicating the affiliation already exists
- Given a new affiliation is saved successfully, when the coordinator returns to the affiliations panel, then the newly added chapter appears in the list with an 'active' status and the correct timestamp
Business Value
Peer mentor mobility across chapters is a real operational pattern in NHF's large volunteer network. If adding a new chapter affiliation were destructive (overwriting existing ones), coordinators would lose historical activity data and statistics continuity for that peer mentor. Additive affiliation management ensures that a peer mentor's total contribution to the organization is always accurately represented, which is critical for recognition programs, Bufdir grant reporting, and understanding true volunteer engagement levels.
Components
- Chapter Assignment Editor ui
- Multi-Chapter Membership Service service
- Chapter Membership Cubit service
- Contact Chapter Repository data
- Supabase Contact Chapter Adapter infrastructure
- Hierarchy Cache data
- Organization Unit Repository data