Issue Certificate After Full Review Approval

mbertucci commented 4 months ago

📖 User Story

As an Examiner,
I want to issue a certificate of registration with a unique registration number,
so that each registered entity has a verifiable and distinct identifier for official recognition and record-keeping.

Context:

This user story focuses on the process of issuing certificates after an examiner clicks Approve, Status must be "Approved – Examined" and after the examiner clicks the Issue certificate button. It covers the generation of a unique registration number, the creation of a certificate, and its accessibility to both the Examiner and the Host.

📏 Business Rules

[ ] Reg number: BCH[YR]######### (generated randomly and unique) example: BCH24076345645. For renewal, change 6 digits too. Don’t assign the same 9 digits to the same person. Registration number is slightly different between platform and hosts.
[ ] System generates a certificate in a PDF format.
[ ] Certificate name will be Host Registration Certificate.
[ ] Certificate will contain Date of Registration, Date of Expiration (1 year after date of registration), Property (rental property address, full address except country), Type of offering (blank for now as this info is not collected during application yet), Registrant Name (primary contact, full name), Property Host (primary contact, full name), Issue date.
[ ] Certificate will pass accessibility
[ ] When a certificate is issued, the examiner can see a record in the Filing History and can download the certificate.
[ ] When the examiner clicks on the "Download Certificate" button, it will open the certificate in a new tab.
[ ] The "Issue Certificate" button will always be there regardless of whether a certificate has been issued or not (for future use, issue amendment).
[ ] When a certificate is issued, examiners can see the registration number on the examiner dashboard and application details page.
[ ] When a certificate is issued, hosts can see the registration number and download the certificate on the host dashboard and application details page.
[ ] Error handling - if the registration number or certificate is not issued successfully, flag it with error message under Filing History for examiner application details view.

🎭 Story Scenarios

Scenario 1: Issue Certificate After Approval

Given a registration application has been approved:

When the Examiner clicks the "Issue Certificate" button:
- Then the system should generate a unique registration number.
- And the system should generate a certificate in PDF format.
- And the system should log the issuance in the Filing History with a timestamp.
- And the registration number should be visible on both the Examiner's dashboard and the Host's dashboard.
- And the Examiner and Host should be able to download the certificate from their respective dashboards.

Scenario 2: Error Handling During Certificate Issuance

Given an application is approved, and the Examiner attempts to issue a certificate:

When the system fails to generate a unique registration number,
Then flag the application with an error message in the Filing History for both the Examiner view.

💡 Considerations

Verify that the unique registration number is generated correctly and is not reused, particularly during renewals.
Ensure that the generated PDF certificate includes all necessary details and meets accessibility standards.
Confirm that both Examiners and Hosts have the ability to download the certificate from their dashboards once it is issued.
Implement robust error handling for the registration number generation process to prevent data inconsistencies.
Ensure the "Issue Certificate" button remains functional for future amendments or reissues of certificates.

🌐 Accessibility Scenarios

### Keyboard Users Scenario: Comprehensive Keyboard Navigation Given I am a keyboard user on the website When I use the Tab key to navigate through the website Then all interactive elements should be accessible and highlighted And I should be able to activate these elements using the Enter or Space key Scenario: Full Content Accessibility via Keyboard Given I am a keyboard user navigating the website 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 that prevent me from navigating away using the keyboard ### Screen Reader Users Scenario: Accessible Image Descriptions Given I am using a screen reader on the website When I encounter images Then each image should have descriptive alt text that conveys the same message as the image Scenario: Structured Navigation for Screen Readers Given I am navigating the website using a screen reader When I move through different page elements Then the content should be structured with proper headings And the reading order should be logical and sequential Scenario: Descriptive Form Fields Given I am filling out a form using a screen reader When I navigate through the form fields Then each field should be clearly labeled with descriptive text And instructions should be directly associated with their respective inputs ### Low Vision Users Scenario: Effective High Contrast Mode Given I am a user with low vision on the website When I enable high contrast mode Then all content should display with high color contrast suitable for low vision And the layout should remain coherent and unchanged Scenario: Text Resizing Accommodation Given I am a user with low vision on the website When I increase the text size Then the text should resize without loss of information or functionality And the page layout should adapt accordingly without disrupting the user experience Scenario: Personalized Styling Preferences Given I am a user with low vision adjusting settings on the website When I customize my styling preferences, including colors, fonts, and spacing Then these adjustments should be applied consistently across all pages And the changes should persist during my entire session or until altered by me

##

🌍 Global Scenarios

## Data Validation # Mikaela to confirm: Do we need to do these for MVP - data validation required for inputing data in the right format - as defined by business rules. ### Internet Connection #### Standard Internet Connection Given I am accessing the website from a standard internet connection When I navigate to any page on the site Then the page should load completely within 2 seconds, ensuring a fast and efficient user experience. #### Low-Speed Internet Given a user accesses "Application Details View" with a low-speed internet connection defined as under [specific speed] Mbps When the user attempts to load and interact with the dashboard page Then the "Application Details View" should prioritize critical content and functionality, loading essential elements first to ensure usability. #### Mobile Responsiveness Given I am accessing "Application Details View" on a mobile device When I click on the "any" link Then "_____ " should display correctly and be easily editable on my device, ensuring a responsive design.

fionazhou-jsb commented 4 months ago

@mbertucci made some changes on this sentence "After an examiner has manually reviewed an application and clicked "Approved" (status might change . Then the system should automatically issue a certificate." - so status change will be a different UI, here is to use the issue certificate button to issue the document.

mbertucci commented 3 weeks ago

this needs to be estimated so I can add the estimated points to the Story Map

mbertucci commented 2 weeks ago

Is this still working?

bcgov / entity