Hospice Provider Directory & CMS Search
Relevant source files
The following files were used as context for generating this wiki page:
The Hospice Provider Directory & CMS Search system is a core component of the Hospice Roadmap platform, designed to empower users to research and navigate hospice providers. It provides a geographical search interface that leverages official Centers for Medicare & Medicaid Services (CMS) data to deliver accurate provider information, including clinical quality metrics and patient satisfaction scores.
This system bridges the gap between complex government datasets and family caregivers by presenting technical provider data in a calm, medically credible, and mobile-optimized interface. It allows users to search by city or zip code, view detailed provider cards, and access essential questions to ask during the evaluation process.
Sources: attached_assets/Pasted-Build-a-production-ready-native-iPhone-mobile-app-using_1773627288076.txt, replit.md
System Architecture & Data Flow
The architecture follows a service-oriented pattern where the React Native mobile application communicates with an Express API server, which acts as a proxy for the CMS Provider Data API.
Component Interaction Flow
The flow begins with a user entering geographical criteria. The cmsProviderService handles the network request to the backend, which then queries CMS datasets (specifically yc9t-dgbk, 252m-zfp9, and gxki-hrr8).
Data Models
The system relies on a structured definition for providers and their clinical quality ratings.
Provider Object Structure
| Field | Type | Description |
|---|---|---|
cmsId | string | Unique identifier from CMS (Provider Number). |
name | string | Legal business name of the hospice agency. |
address | string | Street address of the provider. |
city | string | City location. |
state | string | Two-letter state code. |
zip | string | Postal code. |
phone | string | Contact telephone number. |
ownershipType | string | Ownership category (e.g., For Profit, Non-Profit). |
qualityRating | number | Star rating for clinical quality. |
satisfactionRating | number | Star rating for patient/family satisfaction. |
Sources: artifacts/mobile/services/cmsProviderService.ts:4-16, artifacts/mobile/components/ProviderCard.tsx:12-21
Key Implementation Details
Search Logic
The search implementation in providers.tsx utilizes a useCallback for handleSearch to manage query execution. It includes basic validation to ensure the search term is not empty before invoking the service.
const handleSearch = useCallback(async () => {
if (!searchQuery.trim()) return;
setLoading(true);
setError(null);
try {
const results = await cmsProviderService.searchProviders(searchQuery);
setProviders(results);
} catch (err) {
setError("Failed to fetch providers. Please try again.");
} finally {
setLoading(false);
}
}, [searchQuery]);
Sources: artifacts/mobile/app/(tabs)/providers.tsx:75-88
Provider Evaluation Content
To supplement the directory, the platform includes educational resources to guide the selection process. This is primarily contained within the resources.ts data file, specifically the "Questions to Ask a Hospice Provider" resource.
Essential Evaluation Criteria
| Category | Metric/Question |
|---|---|
| Clinical Care | Nurse visit frequency and 24/7 after-hours response time. |
| Team Continuity | Consistency of assigned team members (nurses/aides). |
| Quality | CAHPS Hospice Survey scores and Medicare certification status. |
| Bereavement | 13-month follow-up support for families. |
Sources: artifacts/mobile/data/resources.ts:544-604
Component Layout: ProviderCard
The ProviderCard.tsx component is responsible for rendering individual search results. It uses a structured layout to emphasize quality ratings and geographical proximity.
Conclusion
The Hospice Provider Directory & CMS Search provides a critical bridge between government healthcare data and end-user needs. By combining a real-time geographical search interface with clinical quality metrics and educational decision support, the system enables families to make informed choices during the hospice enrollment process. Its architecture ensures scalability by offloading complex data processing to a dedicated API layer while maintaining a responsive, offline-capable mobile experience for the user.
Sources: attached_assets/Pasted-Build-a-production-ready-native-iPhone-mobile-app-using_1773627288076.txt, replit.md