hackforla / hackforla/HomeUniteUs

Product: Section 2b: Guest Intake Profile | USER STORY | Interest in Being a Guest

Open
#887 4 comments 0 reactions 1 assignee Claimed by @amitunikorn View on GitHub
Complexity: Small draft p-Feature: Profile Guest Ready for: Product Lead Role: PM size: 1pt User Stories
Dominant language
Python
Stars
45
Forks
22
Avg merge
15d 1h
Merged PRs (30d)
1

Description

## 🧩 Overview
We need to create a **Guest Goals & Expectations Form** within the Guest application process.
This form allows Guests to share their long-term goals, relationship expectations, and potential challenges so that Coordinators can make better, more informed host-guest matches.

---

## 🧠 Problem Statement
Guests currently lack a structured way to communicate their personal goals, relationship expectations, and potential challenges within the Host Homes Program.
Without this information, Coordinators may struggle to make compatible and supportive matches between Hosts and Guests, potentially impacting program success and Guest satisfaction.

---

## 🙋‍♀️ User Story
**As a** Guest,
**I want** to share my goals, expectations, and potential challenges for the Host Homes Program,
**So that** I can be matched with a host who understands my needs and can help me achieve my personal and professional goals.

---

## 🎯 Acceptance Criteria (Definition of Done)
- [ ] **Long-Term Goal Entry**: Guests can enter their long-term housing, education, and employment goals in a text field.
- [ ] **Relationship Expectations Entry**: Guests can describe the type of relationship they hope to have with their host.
- [ ] **Challenge Identification Entry**: Guests can outline any challenges they anticipate in the program.
- [ ] **Text Validation**: The system enforces character limits and displays clear validation messages when text exceeds or falls below acceptable length.
- [ ] **Data Persistence**: All entered information is saved correctly to the database and retrievable for coordinators.
- [ ] **UI/UX Consistency**: The design aligns with the Guest Intake Form style and uses existing Material UI components.
- [ ] **Accessibility Compliance**: Input fields and validation messages meet accessibility standards.

---

## 🔍 Context / Background
- This feature builds upon the existing Guest Intake Form in the Home Unite Us (HUU) application.
- It captures qualitative data that supports better host-guest matching and improved program outcomes.

**Related Resources:**
- Research Summary: [link to research or discovery doc]
- Guest Wireframe – Interest in Being a Guest: [Figma Mockup](https://www.figma.com/design/BNWqZk8SHKbtN1nw8BB7VM/HUU-Main-File---11%2F2024?node-id=16750-1330&t=A4M1Bco8bi5TZnhK-4)
- Previous Discovery Work: [link to user flow or requirements doc]
- Related Epic: *Guest Application Flow*

---

## 🖼️ Design Notes (Preliminary)
- **Design Ready:** Yes
- **Inspiration / Reference:** Use consistent design patterns and text field components from the existing HUU design system (Material UI).
- Include guidance or placeholder text to help guests understand what to include in their responses.

---

## 📌 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](https://docs.google.com/spreadsheets/d/1uM287TOz20jnXPS4kRe0Dt5GlhnPbNRYBHHOxcamCJ0/edit?gid=343529642#gid=343529642) and completed information accordingly.

**In Scope:**
- Guest form fields for long-term goals, relationship expectations, and challenges.
- Input validation (min/max length).
- Storage and retrieval of guest-provided responses.

**Out of Scope (future stories):**
- Coordinator-facing dashboard view for guest responses.
- Advanced matching algorithm enhancements based on goals/expectations data.

---

## 🛑 Constraints / Risks / Workflow Dependency
- Must align with data model and backend API for Guest applications (FastAPI + PostgreSQL).
- Input text must comply with privacy and data protection requirements.
- Dependencies: Form integration within the Guest Application workflow.

---

### Action Items
- Assign and Prep
- [x] Product Manager: Draft user story and self-assign.
- [x] Product Manager: Conduct research or clarify open questions (if applicable).
- [x] Product Manager: Collaborate with Product Lead to size and prioritize the work.
- [ ] Product Manager/Lead: Determine if this should be split into sub-issues (Design / Engineering / QA).
- Draft and Review:
- [x] Change Issue Status to **In Progress**.
- [x] Draft and finalize acceptance criteria.
- [x] Change Issue Status to **For Review/Feedback Needed**.
- [x] Add Label **Ready for: Design Peer Review**.
- [ ] Peer Reviewer: Validate story completeness and clarity.
- [ ] Resolve reviewer comments iteratively.
- [ ] Product Lead: Conduct final review and mark **Ready for Product Persona**.

---

### 🔗 Related Tickets
- Design Ticket: [link once created]
- Engineering Ticket: [link once created]
- QA Test Plan: [link once created]

---

### 📎 Resources & References
- [Figma Wireframe – Guest Intake Form Section](https://www.figma.com/design/BNWqZk8SHKbtN1nw8BB7VM/HUU-Main-File---11%2F2024?node-id=16750-1330&t=A4M1Bco8bi5TZnhK-4)
- [Home Unite Us Dev Environment](https://dev.homeunite.us/)
- [Home Unite Us Stable Environment](https://homeunite.us/)
- [Hack for LA Shared Housing Initiative Overview](https://www.hackforla.org/projects/home-unite-us)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.