bcgov / bcgov/entity

Business Details - Step 2

Open
#23,475 0 comments 0 reactions 0 assignees View on GitHub
STR CHEFs
Dominant language
JavaScript
Stars
23
Forks
62
Avg merge
24m
Merged PRs (30d)
1

Description

### 📖 User Story

**As a team lead, when the Strata Hotel user clicks "Next" or moves to the next page, I want the Strata Hotel user to move to the "Step 2 - Business Details" page, so that the Strata Hotel user can fill out the Business Details for Strata Hotels.**

### Context:

The "Step 2 Business Details" page is where the Strata Hotel user fills out the Strata Hotel details.

This step follows the "Step 1 Contact Information" page.

> **Note:** Validation statements can be found in the Product Team channel under **Files**: [Validation and Status Table](https://bcgov.sharepoint.com/:x:/r/teams/09399/Shared%20Documents/Product-Scrum%20Team%20Chat/VALIDATIONS%20%20AND%20STATUSES/Field%20validation%20and%20Status%20Table.xlsx?d=wd73427566b6148b48776b7c8682de8e9&csf=1&web=1&e=QuvR9v)

#### 🎨 UX/UI Link:

- **Miro Link:** [Miro Board](https://miro.com/app/board/uXjVKQlO-ME=/?moveToWidget=3458764600655675248&cot=14)

### 📏 Business Rules

**Navigation:**

- [ ] Display a stepper highlighting the "Business Details" step.

- [ ] Users can navigate to any step of the application form by clicking on the stepper icons.

- [ ] Users can proceed to the next step by clicking the "Next" button.

**Validation Indicators:**

- [ ] The stepper will indicate whether each page has all required information (red "X" for incomplete, green checkmark for complete).

**Field Validations:**

- [ ] If users navigate without completing required fields, the "Business Details" step will display a red "X".

- [ ] Incomplete required fields will be highlighted in red with appropriate error messages when users return to the "Business Details" page.

**Error Messages:**

- See the [Validation and Status Table](https://bcgov.sharepoint.com/:x:/r/teams/09399/Shared%20Documents/Product-Scrum%20Team%20Chat/VALIDATIONS%20%20AND%20STATUSES/Field%20validation%20and%20Status%20Table.xlsx?d=wd73427566b6148b48776b7c8682de8e9&csf=1&web=1&e=YKa6BJ&nav=MTVfe0U0NkZFMjQyLUYzNjgtNDgwMy1BQUUwLUMwMUY2NjI4NERDN30).

### Technical Breakdown

**Frontend (UI):**

- [ ] I

**Backend (BE):**

- [ ]

### Field Table

| **Section** | **Field** | **Description** | **Helper Text** |
|---------------------------------------------|------------------------------------|----------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|
| **Business Identifiers** | **Legal Strata Hotel Name** | The full legal name of the strata hotel, including corporate designations. | Include corporate designations (e.g., "Ltd.", "Inc.", "LLC"). |
| | **Place of Incorporation or Registration** | The jurisdiction where the strata hotel was incorporated. | The regional or federal jurisdiction with which the strata hotel was incorporated. |
| | **Business Number** *(Optional)* | The CRA identifier number for the strata hotel. | Canada Revenue Agency Identifier. |
| | **Aliases/DBAs** *(Optional)* | Other names under which the strata hotel operates. | If the strata hotel operates under any other names, provide them here. |
| | **Add Another Alias** | Button to add additional aliases/DBAs. | |
| **Business Mailing Address** | **Country** | The country where the strata hotel is located. | |
| | **Street Address** | The primary street address for the strata hotel. | Street address, PO box, rural route, or general delivery address. |
| | **Additional Street Address** *(Optional)* | Additional street address information. | |
| | **City** | The city where the strata hotel is located. | |
| | **Region** | The region or province where the strata hotel is located. | |
| | **Postal Code** | The postal code for the strata hotel's location. | |
| **Alternative Company Contact Information** | **Phone Number** *(Optional)* | An alternative phone number for the strata hotel. | |
| | **Fax Number** *(Optional)* | An alternative fax number for the strata hotel. | |
| | **Email Address** *(Optional)* | An alternative email address for the strata hotel. | |

### 🎭 Story Scenarios

#### Navigation Scenarios

**Scenario 1: Display "Step 2 Business Details" When "Next" is Clicked:**

- **Given** I am on the "Step 1 Contact Information" page,

- **When** I click the "Next" button,

- **Then** I am navigated to the "Step 2 Business Details" page,

- **And** the validations for "Step 1 Contact Information" are run.

**Scenario 2: Navigate via Stepper:**

- **Given** I am on any step in the application,

- **When** I click on the "Business Details" step in the stepper,

- **Then** I am navigated to the "Step 2 Business Details" page,

- **And** the validations for the page they left are run.

**Scenario 3: Next Button Functionality:**

- **Given** I am on the "Step 2 Business Details" page,

- **When** I click the "Next" button,

- **Then** I am navigated to the "Step 3 Strata Hotel Details" page,

- **And** the validations for "Step 2 Business Details" are run.

**Scenario 4: Data Persistence Between Steps:**

- **Given** I have entered information in "Step 2 Business Details",

- **When** I navigate away and return,

- **Then** the information is retained.

#### Field Scenarios

**Scenario 5: Legal Strata Hotel Name Section:**

- **Given** I am filling out the "Legal Strata Hotel Name",

- **Then** I see helpful text: "Include corporate designations (e.g., 'Ltd.', 'Inc.', 'LLC')."

**Scenario 6: Place of Incorporation or Registration:**

- **Given** I am filling out this field,

- **Then** I see helpful text: "The regional or federal jurisdiction with which the strata hotel was incorporated."

**Scenario 7: Business Number (Optional):**

- **Given** I am filling out the "Business Number",

- **Then** I see helpful text: "Canada Revenue Agency Identifier."

**Scenario 8:Business Mailing Address:**

- **Given** I am entering the mailing address,

- **Then** the following fields are available:

- Country

- Street Address

- Additional Street Address (Optional)

- City

- Region

- Postal Code

**Scenario 9: Hotel Registered Outside Canada:**

- **Given** I have checked "Does the strata hotel have a registered office or attorney for service in British Columbia?",

- **Then** "Yes" is pre-selected,

- **And** additional fields appear:

- Attorney for Service or Name (Optional)

- Country (use Canada Post Address Lookup API)

- Street Address

- Additional Street Address

- City

- Postal Code

### Accessibility Scenarios

#### Keyboard Users

**Comprehensive Keyboard Navigation:**

- **Given** I am navigating using the keyboard,

- **When** I use the Tab key,

- **Then** all interactive elements are accessible and highlighted,

- **And** I can activate these elements using the Enter or Space key.

**Full Content Accessibility via Keyboard:**

- **Given** I am a keyboard user,

- **When** I traverse through different pages and sections,

- **Then** all content should be fully accessible using the keyboard alone,

- **And** there should be no traps preventing navigation.

#### Screen Reader Users

**Accessible Image Descriptions:**

- **Given** I am using a screen reader,

- **When** I encounter images,

- **Then** each image has descriptive alt text that conveys the same message as the image.

**Structured Navigation:**

- **Given** I am navigating the website using a screen reader,

- **When** I move through different page elements,

- **Then** the content is structured with proper headings,

- **And** the reading order is logical and sequential.

**Descriptive Form Fields:**

- **Given** I am filling out a form using a screen reader,

- **When** I navigate through the form fields,

- **Then** each field is clearly labeled with descriptive text,

- **And** instructions are associated with their respective inputs.

#### Low Vision Users

**Effective High Contrast Mode:**

- **Given** I am a user with low vision,

- **When** I enable high contrast mode,

- **Then** all content displays with high color contrast,

- **And** the layout remains coherent.

**Text Resizing Accommodation:**

- **Given** I increase the text size,

- **Then** the text resizes without loss of information or functionality,

- **And** the page layout adapts accordingly.

**Personalized Styling Preferences:**

- **Given** I adjust styling preferences, including colors, fonts, and spacing,

- **Then** these adjustments are applied consistently across all pages,

- **And** changes persist during my entire session or until altered by me.

🌍 Global Scenarios

### Internet Connection

**Standard Internet Connection:**

- **Given** I access the website with a standard connection,

- **Then** pages load within 2 seconds.

**Low-Speed Internet:**

- **Given** I have a low-speed connection,

- **Then** essential content loads first.

### Mobile Responsiveness

**Mobile Device Access:**

- **Given** I use a mobile device,

- **When** I access any link,

- **Then** content displays correctly and is easily editable.

---

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.