hackforla / hackforla/HomeUniteUs
Product: Section 2b: Guest Intake Profile | USER STORY | Employment Information
- Dominant language
- Python
- Stars
- 45
- Forks
- 22
- Avg merge
- 15d 1h
- Merged PRs (30d)
- 1
Description
## 🧩 Overview
We need to **capture a Guest’s employment status and future work plans** during their intake process. This feature helps Coordinators understand each Guest’s career goals and stability, ensuring more accurate host matching and appropriate support services.
---
## 🧠 Problem Statement
Guests currently cannot provide information about their current employment or career goals through the intake form. This gap limits the program’s ability to match them with Hosts who can offer compatible living arrangements or mentorship aligned with their career paths.
By adding employment-related questions, we will improve the matching accuracy and the support experience for both guests and hosts.
---
## 🙋♀️ User Story
**As a** Guest,
**I want** to provide information about my current employment status and/or future work plans,
**So that** I can receive support and be matched with a Host who understands my career goals.
---
## 🎯 Acceptance Criteria (Definition of Done)
- [ ] **Employment Status Selection**: Guests can indicate whether they are currently employed (“Yes” or “No”).
- [ ] If “No” is selected, a text field appears prompting the guest to describe whether they are looking for work and what type of work they are seeking.
- [ ] If “Yes” is selected, a text field appears prompting the guest to describe their current employment situation.
- [ ] **Validation**: All required fields must be completed before submission.
- [ ] Data is captured and stored correctly in the backend.
- [ ] Submitted information displays correctly in the coordinator dashboard.
---
## 🔍 Context / Background
- Research Summary: N/A (capturing employment info was identified as a data gap through coordinator feedback).
- Previous Discovery Work: [_TBD – Add once created_]
- Related Epics or Projects: [_TBD – Add once created_]
---
## 🖼️ Design Notes (Preliminary)
- **Ready for design work?** Yes
- Use consistent layout and styling from existing Guest Intake Form.
- Follow HUU Design System form patterns (Material UI inputs, conditional logic).
- Reference design: [Guest Wireframe - Employment Information](https://www.figma.com/design/BNWqZk8SHKbtN1nw8BB7VM/HUU-Main-File---11%2F2024?node-id=17438-9151&t=MT6iDoPNwPGd8Y86-4)
---
## 📌 Scope Considerations (In/Out Scope)
- [Feature List](https://docs.google.com/spreadsheets/d/1uM287TOz20jnXPS4kRe0Dt5GlhnPbNRYBHHOxcamCJ0/edit?gid=343529642#gid=343529642) *Add/Update Feature List*
- [x] Added to feature list and completed information accordingly.
**In Scope:**
- Employment status and career goal fields in the guest intake form.
- Validation and conditional display logic.
- Data storage integration.
**Out of Scope:**
- Automated matching algorithm updates.
- Admin/coordinator dashboard enhancements beyond displaying stored data.
---
## 🛑 Constraints / Risks / Workflow Dependency
- Must align with data privacy and storage standards for personally identifiable information (PII).
- Dependent on guest intake form architecture and existing data schema.
- Ensure conditional form logic is compatible with Vite/React implementation.
---
### Action Items
- **Assign and Prep**
- [x] Product Manager: Draft user story and self-assign
- [x] Product Manager: Validate scope with Product Lead
- [ ] Product Manager: Collaborate with Design to ensure mockups align with current UI patterns
- [ ] Product Manager: Add to feature list and link related tickets
- **Draft and Review**
- [x] Product Manager: Change issue status to “In Progress”
- [x] Product Manager: Tag for “Ready for: Design Peer Review” once complete
- [x] Product Peer Reviewer: Validate story clarity and completeness
- [ ] Product Manager: Incorporate feedback and finalize for engineering handoff
---
### 🔗 Related Tickets
- **Design Ticket:** [_TBD – Add once created_]
- **Engineering Ticket:** [_TBD – Add once created_]
- **QA Test Plan:** [_TBD – Add once created_]
---
### 📎 Resources & References
- Existing Research: N/A
- Brand Guidelines / Design System: [_TBD – Add once created_]
- Previous or Related Designs: [Guest Wireframe - Employment Information](https://www.figma.com/design/BNWqZk8SHKbtN1nw8BB7VM/HUU-Main-File---11%2F2024?node-id=17438-9151&t=MT6iDoPNwPGd8Y86-4)
Contributor guide
Assessment
This issue has not been assessed yet.