User Story

As a Team Lead, when the property manger clicks on "Start Application" (whatever this should be) I want to collect detailed information about the Property Manager, including their contact details and authorization to register on behalf of their clients (Host, Strata Hotel, or Platform),
So that we can ensure proper authorization and communication with the Property Manager for managing the property.

Context / Background

Property Managers are a user type in our system who can submit applications on behalf of their client. Whenever a Property Manager submits an application, their detailed information should be collected and stored with the application. This information must be retained as part of the application record. Property Managers should also be able to edit their information if necessary.

Note: It is suggested to include a page outside of the application that can be Host application can be reused

UX/UI Links

[Insert Miro Link or UI Mockup Here]

Business Rules

Authorization to Register on Behalf of Client:
- An authorization checkbox or declaration confirming the Property Manager has permission to register on behalf of the client. The checkbox has to be ticked before proceeding.
- checkbox: I am authorized to register this listing on behalf of host and make declarations for them
Property Manager’s Personal Information:
- First Name (mandatory)
- Middle Name (optional)
- Last Name (mandatory)
- Preferred Name (optional)
Property Manager’s Business Information:
- Business (GST) Number (optional)
Contact Information:
- Phone Number (mandatory)
- Extension (optional)
- Fax Number (optional)
- Email Address (mandatory)
Mailing Address:
- Property Manager's personal mailing address (mandatory)
Property Management Company Information:
- Business Name (mandatory)
- Mailing Address (mandatory)

Secondary Contact Information:

Validation Rules:
- Email address must be in a valid format.
- Phone number must be in a valid format.
- Mandatory fields cannot be left blank; the system must prompt the user to correct any missing or invalid information.

Story Scenarios

Scenario 1: Property Manager Provides All Required Information and Authorization

Given the Property Manager is filling out the application form,
When they complete all mandatory fields and check the authorization checkbox,
Then the system accepts the form submission,
And registers the property on behalf of the client.

Scenario 2: Property Manager Fails to Check the Authorization Box

Given the Property Manager is filling out the application form,
When they attempt to submit the form without checking the authorization checkbox,
Then the system displays an error message preventing them from proceeding,
And instructs them to confirm authorization by checking the box.

Scenario 3: Missing Mandatory Fields

Given the Property Manager is filling out the application form,
When they attempt to submit the form without filling in all mandatory fields (e.g., First Name, Last Name, Phone Number, Email Address, Business Name),
Then the system highlights the incomplete fields,
And displays error messages indicating that these fields are required,
And prevents form submission until the required information is provided.

Scenario 4: Optional Fields Left Blank

Given the Property Manager is filling out the application form,
When they leave optional fields blank (e.g., Middle Name, Preferred Name, GST Number, Extension, Fax Number),
Then the system allows them to proceed without those fields,
And completes the application with the information provided.

Scenario 5: Invalid Email or Phone Number Format

Given the Property Manager enters an email address or phone number,
When the format is invalid,
Then the system displays an error message indicating the invalid format,
And prompts the user to correct the information before proceeding.

Scenario 6: Editing Property Manager Information

Given the Property Manager has previously submitted their information,
When they need to update their personal or business details,
Then they can access and edit their information,
And the updated information will be associated with future applications.

bcgov / entity

Property Manager Details #23432