🏠 Overview › 👥 User Roles ›📖 Search Contacts and Peer Mentors by Name or Attrib...

Search Contacts and Peer Mentors by Name or Attribute

The contact search feature must provide a debounced search bar at the top of the contact list that queries both the online Supabase backend and a local offline cache. Search results must update as the user types, with a configurable debounce delay to avoid excessive API calls. The search must respect the same RLS policies as the main list, ensuring coordinators only find contacts within their chapter. Offline mode must degrade gracefully by searching the local cache.

HIGH story-contact-list-management-organization-admin-002 5 pts
5
Story Points
High
Priority
Contact List Management
Feature

User Story

As a Organization Administrator
I want to search for contacts and peer mentors by name, phone number, or other attributes with real-time results
So that I can quickly locate a specific person without scrolling through long lists, especially when handling urgent assignment requests

Acceptance Criteria

  • Given I am on the contact list screen, when I tap the search bar and type at least 2 characters, then the list filters to show matching contacts within 400ms
  • Given I am searching for a contact, when the search debounce triggers, then only one API call is made per debounce interval rather than one call per keystroke
  • Given I am offline, when I search for a contact, then the search queries the local offline cache and displays cached results with an offline indicator
  • Given search results are displayed, when I tap a result, then I am navigated to the contact detail screen for that contact
  • Given I clear the search bar, when the input is empty, then the full contact list is restored without requiring a manual reload

Business Value

Coordinators managing dozens to hundreds of contacts cannot rely on manual scrolling when time-sensitive situations arise, such as finding an available peer mentor for an urgent assignment. Real-time debounced search with offline fallback ensures productivity is maintained regardless of network conditions, directly reducing response time for contact matching and assignment.

Components

Dependencies

Contact List Management
Related Feature
Organization Administrator
User Role