department-of-veterans-affairs / va.gov-team

Public resources for building on and in support of VA.gov. Visit complete Knowledge Hub:
https://depo-platform-documentation.scrollhelp.site/index.html
281 stars 197 forks source link

Implement Warning for Veterans Adding Spouse Without Declaring as Dependent #70211

Open amponce opened 9 months ago

amponce commented 9 months ago

Issue Description

This is to implement an automatic notice of the spouse warning.

To enhance clarity during our dependents flow, we'd like to introduce a warning message. This message will be triggered when a veteran adds a spouse but does not declare them as a dependent. This improvement aims to alleviate confusion regarding eligibility and requirements for dependents.

Where the Warning Should Appear:

Front end tasks

  1. Collaborate with the design team to finalize the wording and presentation of the warning message.
  2. Implement a system to trigger the warning message when a veteran has a spouse listed but has not added them as a dependent.
  3. Given the 'Save in Progress' feature, ensure that this warning is also integrated into the 'Review Navigation' page, covering scenarios where the veteran might bypass the dependents page.

Acceptance Criteria

HeatherRienks commented 9 months ago

@denisecoveyduc - we would like your input on the priority of this effort, please.

denisecoveyduc commented 9 months ago

Let's discuss this on an upcoming SU maybe since it has been a while. I thought that we were not auto 'magically' adding the dependent into the dependent count that we are sending VHA and VBA. In other words if a Veteran adds their spouse we are (behind the scenes) including that in the count for the number of dependents they have. I recall @mgleo updated the language on that page to indicate that to the Veteran.

mgleo commented 9 months ago

Hi @denisecoveyduc, That is correct, we are asking the user to enter their spouse as a dependent. Joe added the following language on the dependents pages, "Dependents include your spouse, unmarried children under 18 years old, 
and other dependents." So they will at least enter "1" under dependents if they are married. Looks like this ticket is to catch any users that select that they have a spouse but enter "0" on the dependents section.

HeatherRienks commented 9 months ago

@denisecoveyduc will discuss with Mike Dewey.

mgleo commented 9 months ago

@amponce @josephrlee Are you able to find and post the dates that the updated language was up on production? I know it was down during usability session but went back up around a week later?

mgleo commented 9 months ago

^ @denisecoveyduc Thinking Mike will need the dates this updated language was up on production to compare the data

Tom-Davis commented 9 months ago

@denisecoveyduc once we have a defined solution what would you place the priority level at?

HeatherRienks commented 9 months ago

Per FE Sync, @denisecoveyduc suggests we all huddle to discuss further. Heather to set up time to discuss

amponce commented 8 months ago

Notes for sync with design:

We recently discussed an idea to streamline the process for veterans applying for benefits, specifically making it easier to add their spouse as a dependent. Here’s a breakdown of the proposed changes, potential issues, and technical requirements.

Proposed Changes:

Veterans can enter their spouse's first name, last name, and age directly on the main application form. This modification will:

Potential Issues to Watch Out For:

Frontend Requirements:

  1. Input Fields: Add an input field for the spouse's age alongside the existing name fields.
  2. Automatic Inclusion: Upon entering the spouse's details, the system should automatically include them as a dependent.
  3. Dependent Count Update: The system should increment the dependent count by one.
  4. Age Recording: The spouse's age should be automatically recorded in the dependent age records.
  5. Navigation: After entering the spouse's details, users will be guided to add any additional dependents.

Technical Considerations:

In the backend, the dependents object has a count property that needs adjustment upon adding a spouse. The hasDependents field should increment by one, and the dependentAge array must be updated correspondingly. Confirmation of the spouse’s addition will be displayed on the subsequent screen.