🏠 Overview › 🎯 Features ›🎯 Member Associations

Member Associations

Feature Detail

medium complexity extracted Organization Management Confidence: 100%
8
Components
106
Shared
0
User Stories
Yes
Analyzed

Description

Member Associations manages the relationships between users and the local associations they belong to within the organizational hierarchy. A single user — particularly a peer mentor — may be a member of multiple local associations simultaneously, which is especially common in NHF where members can belong to up to five local associations at once. This feature provides administrators with a dedicated page to view, add, and remove association memberships for individual users, define the primary association for reporting purposes, and detect and resolve potential duplicate reporting scenarios. The interface also supports bulk assignment of users to associations and displays a clear audit trail of membership changes. Association context is used throughout the platform to scope activity reports, statistics, and coordinator oversight correctly.

User Flow

Member Associations user flow
Click to expand

Analysis

Business Value

Incorrect or missing association membership data is a primary cause of reporting errors and double-counting in the current manual workflows described by NHF. When a peer mentor registers activities without a clear association context, the coordinator cannot correctly attribute those activities to the right local association for Bufdir reporting, leading to inaccurate grant reporting and potential compliance issues. By formalizing the user-to-association relationship in the platform, this feature ensures that every activity is unambiguously attributable, which is a prerequisite for reliable automated Bufdir exports. It also enables coordinators to see exactly which peer mentors fall under their oversight scope, reducing the coordination overhead that currently requires manual spreadsheet management across dozens of local associations in large organizations like NHF.

Implementation Notes

User-to-association relationships are stored in the user_local_associations junction table with columns for user_id, local_association_id, is_primary boolean, and created_at. The API provides endpoints for listing, adding, and removing memberships with validation to prevent duplicate primary associations. The admin portal page renders a searchable user list with an expandable association panel per user, allowing inline editing without navigating away. Bulk assignment uses a multi-select dialog with search and confirmation. The primary association flag is enforced at the database level with a partial unique index. Activity submission on the mobile app includes association_id derived from the user's primary association by default, with an optional override for users with multiple memberships surfaced as a picker in the activity wizard. Duplicate activity detection uses a combination of user_id, activity_date, and association_id to flag potential double-reports for coordinator review.

Components (114)

User Interface (4)

ui Association Membership Panel medium ui Bulk Association Assignment Dialog medium ui Member Association Page medium ui Member Association Page medium

Service Layer (2)

service Association Service medium service Duplicate Reporting Detector medium

Data Layer (2)

data Association Membership Repository low data Association Membership Store low

Shared Components

These components are reused across multiple features

Service Layer (34)

service Auth API Client medium Shared service Password Policy Validator low Shared service Permission Validation Middleware high Shared service Activity Service medium Shared service Event API Client low Shared service Event Repository Service medium Shared service File Upload Service high Shared service Expense Type Service high Shared service Contact Service medium Shared service STT Service medium Shared service Keyboard Navigation Service medium Shared service Screen Reader Support Service high Shared service Screen Reader Support Service high Shared service Localization Service medium Shared service Localization Service medium Shared service Repository Data Source Router high Shared service Role Scope Resolver low Shared service Audit Log Service medium Shared service Audit Log Service medium Shared service Report Access Control Service medium Shared service Export Audit Logger low Shared service Report Export Service medium Shared service Report Export Service medium Shared service Terminology Context Provider medium Shared service Terminology Service medium Shared service Terminology Service medium Shared service Feature Registry Loader low Shared service Hierarchy Access Control Service high Shared service Hierarchy Scope Resolver medium Shared service Association Service medium Shared service Audit Log Service high Shared service DPA Content Provider low Shared service Cookie Consent Service medium Shared service Cookie Consent Service medium Shared

Data Layer (22)

data Token Store low Shared data Token Store low Shared data Secure Token Store medium Shared data Secure Token Store medium Shared data Activity Store low Shared data Event List Cache Store low Shared data Expense Type Store medium Shared data Contact Store low Shared data Contact Store low Shared data Notes Store low Shared data Assignment Count Store low Shared data Push Token Repository low Shared data Notification Audit Log Store low Shared data Push Token Store low Shared data Push Token Store low Shared data Organization Impact Settings Repository low Shared data Accessibility Preferences Store low Shared data Local SQLite Database high Shared data Sync Queue medium Shared data Report Store high Shared data Mobile Terminology Store medium Shared data Security Metrics Repository medium Shared

Infrastructure (38)

infrastructure Keychain/Keystore Adapter low Shared infrastructure JWT Claims Extractor low Shared infrastructure Organization Labels Adapter low Shared infrastructure Keychain/Keystore Adapter low Shared infrastructure Auth API Client medium Shared infrastructure REST API Client medium Shared infrastructure WCAG Accessibility Adapter low Shared infrastructure Registration API Client low Shared infrastructure Accounting API Client high Shared infrastructure PDF Renderer Adapter medium Shared infrastructure File Share Adapter low Shared infrastructure FCM/APNs Adapter high Shared infrastructure Share Sheet Adapter low Shared infrastructure Share Plus Adapter low Shared infrastructure Platform Accessibility Bridge medium Shared infrastructure Semantics Override Adapter high Shared infrastructure URL Launcher Adapter low Shared infrastructure Markdown Content Renderer low Shared infrastructure Network Connectivity Monitor low Shared infrastructure Expense Receipt Storage Adapter low Shared infrastructure Audit Log Writer low Shared infrastructure Feature Flag Checker low Shared infrastructure Logo Upload Adapter low Shared infrastructure Terminology Constants Registry low Shared infrastructure Feature Flag Cache Adapter low Shared infrastructure Org Scope JWT Resolver medium Shared infrastructure Association Audit Logger low Shared infrastructure Token Blocklist medium Shared infrastructure Analytics Tracker low Shared infrastructure SEO Metadata Config low Shared infrastructure Analytics Tracker low Shared infrastructure Analytics Tracker low Shared infrastructure Sales Analytics Tracker low Shared infrastructure Email Provider Adapter low Shared infrastructure Terms of Service Content Provider low Shared infrastructure Legal PDF Asset Provider low Shared infrastructure Consent-Gated Script Loader low Shared infrastructure Legal Page Layout low Shared

User Stories

No user stories have been generated for this feature yet.