Determine Property Type for Short-Term Rental Listings (for UI work)

[fionazhou-jsb]

📖 User Story As a team lead, I want to know the details related to what the host is renting So that I can be sure we accurately categorize the property

Context:

This is to replace existing question on Step 2 - Type of property with additional questions

We need to know detailed information about the rental property including type of rental space, whether it is in PR, number of rooms rented, and rental unit type.

We do not need to switch the question to radio button.

🎨 UX/UI Link: Host: Property Details | Review & Confirm | Detail Page Examiner: Detail Page

📏 Business Rules:

• [ ] On Property Details page, hosts need to select if the type of space their STR offer is entire home or shared accommodation. They can select only one and it's required. The default is entire home.
• [ ] After selecting type of space (entire home or shared accommodation), users need to choose whether the rental unit is on the same property as their principal residence. They can select only one and it's required. The default is Yes.
• [ ] The options for second question will be dynamic based on the selection of the first question.
• [ ] Users will view a tooltip for this question that "A principal residence is the residence an individual lives in for a longer period during a calendar year than any other place."
• [ ] If "Yes" is selected, show an additional question "Where does the property host live on the property?" question. There are 2 options. The default is "The host lives in this unit when it's not being rented". The wording for the options for this question is slightly different when it's a entire home or shared accommodation
• [ ] After selecting whether the rental unit is users' principal residence, users need to enter the number of rooms being rented. Number of rooms for rent is a required field for both entire home and shared accommodation.
• [ ] The number of rooms has to be 1 or more, a whole number (from 1 to unlimited). Users can use up/down arrow to increase/decrease the number. Number cannot be 0.
• [ ] After entering the number of rooms for rent, users need to choose the rental unit type. They can select only one and it's required. The default is Single Family Home.
• [ ] Users will view a tooltip for this question that "Some property types are exempt from registration. If you’re unsure, confirm the registration requirements." Registration requirements will have a hyperlink embedded but the url is not available yet.
• [ ] The default values for these questions are "entire home", "Yes, I live in this unit when it's not being rented", "1", and "Single Family Home."
• [ ] Error handling: if users skip required fields or navigate to another page without entering a value to a required field, show error message underneath the field and show a red error on the Stepper.
• [ ] Hosts will see their selection of these 4 (5 if conditional question is asked) questions on review page.
• [ ] Hosts will see their selection of these 4 (5 if conditional question is asked) questions on the application details page.
• [ ] Examiners will see host selection of these 4 (5 if conditional question is asked) questions on the application details page of their view.

Questions: Q1 - What type of space is offered in this rental unit? - Entire home (guests have the entire place to themselves) - Shared accommodation (guests rent a bedroom with access to common spaces that may be shared with me or other guests)

Q2 - Is this rental unit on the same property as the property host’s principal residence? - Yes (go to Q3) - No (go to Q4)

Q3 - Where does the property host live on the property? (if Entire Home) - The host lives in this unit when it’s not being rented - The host lives in another unit on the same property

(if Shared accommodation) - The host lives in this unit - The host lives in another unit on the same property

Q4 - Number of Rooms for Rent

Q5 - What is the rental unit type? - Single Family Home - Secondary Suite - Accessory Dwelling Unit - Townhome - Small scale, multi-unit housing (e.g., duplex, triplex) - Condo or apartment - Recreational property (e.g., cabin, cottage) - Bed and breakfast - Strata hotel - Float home

🎭 Story Scenarios

Scenario 1: Host selects "type of space"

• Given I am a host listing my property for short-term rental,
• When I am asked the type of space I offer in this rental unit
• Then I should be presented with options to choose from

Scenario 2: Host selects "principal residence"

• Given I am a host listing my property for short-term rental,
• When I am asked whether the rental unit is on the same property as my principal residence
• Then I should be presented with options to choose from
• And Then the option will be dynamic based on the selection of the previous question

Scenario 3: Host adds "number of rooms for rent"

• Given I am a host listing my property for short-term rental,
• When I am asked number of rooms for rent
• Then I should be presented with a field to enter a number

Scenario 4: Host selects "rental unit type"

• Given I am a host listing my property for short-term rental,
• When I am asked the rental unit type
• Then I should be presented with options to choose from

[fionazhou-jsb]

@kris-daxiom for you to review

[fionazhou-jsb]

@andyyanggov assign this to you. Let me know if this makes sense. The way we structure the question is good for reporting and fee configuration

[mbertucci]

Fee Widget - can we just have it on the last page and not on every page? @forgeuxGH5

[fionazhou-jsb]

@mbertucci i thought design for this story is complete

[mbertucci]

yes it is and it is in progress now

[rstens]

Pass

after multiple iterations

[mbertucci]

@fionazhou-jsb please test this one as well

[fionazhou-jsb]

@mbertucci cannot close as #23547 is still in progress

[mbertucci]

@dimak1

Implementation for review and confirm and details pages do not match designs

[dimak1]

Fixed layout and labels in ticket #23547.

[andyyanggov]

Fixed layout and labels in ticket #23547.

Confirmed KVP labels on the review page correctly matches the design.

[dimak1]

@andyyanggov Thanks Andy, but it is not ready for QA yet. Needs a code review.

[dimak1]

Ready in Dev.

[rstens]

PASS Comments in Red are either no longer valid or implemented differently.

• [x] On Property Details page, hosts need to select if the type of space their STR offer is entire home or shared accommodation. They can select only one and it's required. The default is entire home.
• [x] After selecting type of space (entire home or shared accommodation), users need to choose whether the rental unit is on the same property as their principal residence. They can select only one and it's required. The default is Yes.
• [x] The options for second question will be dynamic based on the selection of the first question.

- Users will **see a link** for to explain that "A principal residence is the residence an individual lives in for a longer period during a calendar year than any other place." 

• [x] If "Yes" is selected, show an additional question "Where does the property host live on the property?" question. There are 2 options. The default is "The host lives in this unit when it's not being rented". The wording for the options for this question is slightly different when it's a entire home or shared accommodation
• [x] After selecting whether the rental unit is users' principal residence, users need to enter the number of rooms being rented. Number of rooms for rent is a required field for both entire home and shared accommodation.
• [x] The number of rooms has to be 1 or more, a whole number (from 1 to unlimited (actually 5000 was chosen)). Users can use up/down arrow to increase/decrease the number. Number cannot be 0.
• [x] After entering the number of rooms for rent, users need to choose the rental unit type. They can select only one and it's required. The default is Single Family Home.

- Users will view a tooltip for this question that "Some property types are exempt from registration. If you’re unsure, confirm the registration requirements." Registration requirements will have a hyperlink embedded but the url is not available yet. 
- The default values for these questions are "entire home", "Yes, I live in this unit when it's not being rented", "1", and "Single Family Home." 

• [x] Error handling: if users skip required fields or navigate to another page without entering a value to a required field, show error message underneath the field and show a red error on the Stepper.
• [x] Hosts will see their selection of these 4 (5 if conditional question is asked) questions on review page.
• [x] Hosts will see their selection of these 4 (5 if conditional question is asked) questions on the application details page.
• [x] Examiners will see host selection of these 4 (5 if conditional question is asked) questions on the application details page of their view.

[fionazhou-jsb]

closed this one as all the child tickets are done cc @mbertucci