hackforla / hackforla/HomeUniteUs
Section 2 | Coordinator: Receive a notification when coordinators are assigned a new Guest/Host
- Dominant language
- Python
- Stars
- 45
- Forks
- 22
- Avg merge
- 15d 1h
- Merged PRs (30d)
- 1
Description
### 🧩 Overview
We need to enable automatic notifications for Coordinators within the Home Unite Program system when a new Guest or Host is assigned to them, so that Coordinators can promptly initiate onboarding activities. This will enhance service responsiveness and operational efficiency.
### 🧠 Problem Statement
Currently, Coordinators are not automatically informed when a new Guest or Host is assigned to them, leading to delays in onboarding and gaps in support delivery. A lack of timely notifications hampers the goal of providing a responsive and coordinated experience for vulnerable youth and volunteer Hosts.
### 🙋♀️ User Story
As a Coordinator,
I want to receive a notification when a new Guest or Host is assigned to me,
So that I can immediately begin assisting them with onboarding and support.
### 🎯 Acceptance Criteria (Definition of Done)
> - [ ] Notification is triggered upon successful Guest/Host assignment in the system
> - [ ] Coordinator receives an email and/or dashboard alert with key details (e.g., Guest/Host name, referral date, next step links)
> - [ ] Notification includes contact method and onboarding checklist link
> - [ ] Coordinator can access the Guest/Host profile directly from the alert
> - [ ] Notification settings (email/on-platform toggle) can be managed in profile preferences
> - [ ] Notification event is recorded in system audit log
> - [ ] Notification tested across user environments (desktop, mobile)
> - [ ] Coordinator acknowledges alert or marks it “seen” in dashboard
> - [ ] Design handoff approved by stakeholders.
### 🔍 Context / Background
- Host Home Handbook: Emphasizes the Coordinator’s role in onboarding and supporting both Hosts and Guests throughout the program lifecycle.
- Host Home Project Brief Workflow: Details manual steps where Coordinators begin involvement post-referral and require timely updates to avoid delays in registration, interview, and training processes.
### 🖼️ Design Notes (Preliminary)
- Is this feature ready for design work? Yes / **No**
- Use toast/banner alerts and email template from existing design system
- Maintain consistency with notification UX used for Guest/Host form updates
- Ensure alerts are accessible and WCAG 2.1 compliant
- Include dismissible notification feature with timestamp.
### 📌 Scope Considerations (In/Out Scope)
- [Feature List](https://docs.google.com/spreadsheets/d/1uM287TOz20jnXPS4kRe0Dt5GlhnPbNRYBHHOxcamCJ0/edit?gid=343529642#gid=343529642) *Add/Update Feature List*
- [ ] Added to [Feature List](https://docs.google.com/spreadsheets/d/1uM287TOz20jnXPS4kRe0Dt5GlhnPbNRYBHHOxcamCJ0/edit?gid=343529642#gid=343529642) and completed information accordingly
**In Scope:**
- Initial release of Coordinator related feature.
### 🛑 Constraints / Risks / Workflow Dependency
- Must ensure notifications are role-based and do not expose sensitive data to unauthorized users.
- Delay in backend event triggering or database updates could lead to missed notifications.
- Dependency on engineering team to finalize assignment logic and ensure proper user-role tagging.
- Must comply with data privacy standards (e.g., HIPAA/GDPR as applicable)
### 🔗 Related Tickets
https://github.com/hackforla/HomeUniteUs/issues/518
Contributor guide
Assessment
This issue has not been assessed yet.