Issue Description

https://dhs.invisionapp.com/share/N4XNBUHUXH3#/screens/426634090

• apply for NJ SNAP / WFNJ
• upload documents
• check application status

How to configure this issue

• Attached to a Milestone (when will this be completed?)
• Attached to an Epic (what body of work is this a part of?)
• Labeled with Team (product support, analytics-insights, operations, service-design, tools-be, tools-fe)
• Labeled with Practice Area (backend, frontend, devops, design, research, product, ia, qa, analytics, contact center, research, accessibility, content)
• Labeled with Type (bug, request, discovery, documentation, etc.)

Description or User Story

• As a user, I want to learn about NJ safety net benefits (SNAP, TANF, GA).
• As a client, I want to manage my application process.

On This Page - Content & Data Field Requirements

• This page replaces this page
• This page must enable the user/applicant to:

1. Learn about OneApp, the New Jersey state online application for Food (SNAP) and Cash Assistance (TANF/GA) -- including the steps in the process
2. Create an account to monitor the status of their application (link to)
3. Start the application process (link to)
4. Upload documents (link to)
5. Check the status of their application (link to)
6. Access an online eligibility screener (link to https://njfc.force.com/njhelps)

• This page must include additional links to:

7. Language option for Spanish
8. NJ.gov
9. The NJ DHS global footer

Functional Requirements

1. TBD

Screenshots

• Desktop version

• Mobile version

Note:

replaces Issue: OneApp Homepage

Background

This epic is for all of the login-related screens

Tasks

Initial build

• Account sign up #24
• Account sign in #25
• Forgot username #26
• Forgot password #27
• Check application status #28
• View application list #29

Design validation

Adding these tickets if design validation of the initial build was not able to happen as part of the tickets above.

• Application sign up: Design review/validation #155
• Application sign in: Design review/validation #156

Background

Spanish translation epic #21

When all of the copy for the app has been finalized, Mike needs to export it so the NJ team can use this content to produce the Spanish translation.

This ticket is blocked until all content is complete.

Tasks

• Export content
• Deliver to NJ team

Background

Is your UX/Design request related to a problem? Please describe.

NJ DHS would like USDS to integrate some additional documents to the OneApp online application for the applicant to review and electronically sign. The addendums are only needed for TANF or GA. Those documents include:

• 10D - Agreement to repay (GA & TANF)
• 51 Report changes (GA & TANF)
• Criminality (GA only)
• 30 & 30A - Repay (GA only)

Note: NJ-DHS will be providing suggested text for this new document page.

Describe the solution you'd like

In the application flow, the documents would be shown to the applicant only after they submit their application (more details to come from NJ DHS). Here is a mockup from NJ-DHS of what the document page might look like and how it might function.

Describe alternatives you've considered
None.

Additional context

Here are four of the five new documents to be included in OneApp:

WFNJ-1J Addendum A (WFNJ-10D) (Revised 9-16) --AGREEMENT TO REPAY.docx

WFNJ-91 --AFFIDAVIT OF WORK FIRST NEW JERSEY and FSP NON-CRIMINALITY (002).pdf

WFNJ-GA-30 --AUTHORIZATION FOR REIMBURSEMENT OF INITIAL SUPPLEMENTAL SECURITY INCOME (SSI).pdf

WFNJ-GA-51 --IMPORTANT REMINDER OF YOUR OBLIGATION TO REPORT CHANGES.docx

Tasks

• @johnhashva @leahbannon2 to confirm with NJ team that this is required by law for the SNAP application
• @johnhashva @leahbannon2 to confirm with NJ team what kind of signature is required (wet signature? e-signature?)
• If required, create ticket for @melissajschaff to incorporate these forms into the design

https://dhs.invisionapp.com/share/N4XNBUHUXH3#/screens/426634101

• fields for the additional household member (a subset of #3 ):
  https://dhs.invisionapp.com/share/N4XNBUHUXH3#/screens/426634102

User story

As a [type of] user, in order to [task], I need [functionality/change]

Background (Optional)

Acceptance criteria

• [ ]
• [ ]

Level of effort - <low/medium/high>

low = <2 hours | med = half a day | high = 1-2 days | more? split issue

Implementation outline (if higher than "low" effort):

MVP criteria

• 1:
  -[ ] User can complete an application end-to-end (and worker can complete eligibility process)
  -[ ] Application is compliant with laws and regs
  -[ ] Mobile & cross-browser friendly
• 2:
  -[ ] Increase enrollment
  -[ ] Decrease time to benefits
• 3:
  -[ ] Easy to self- maintain/sustain by NJ-DHS

Background

We need validation rules and copy documented for Section 0: Account and application screens. This includes:

• What fields are required
• What happens if someone submits a form without filling out the required fields
• Any other field validation (if applicable) outside of "required" validation
• All validation copy/error messages

Tasks

Provide the following in InVision:

• What fields are required
• What happens if someone submits a form without filling out the required fields
• Any other field validation (if applicable) outside of "required" validation
• All validation copy/error messages

Develop the foundation for a solid GraphQL server that can be the foundations for the new OneApp redesign.

Development process / builds

• Basic server build process: linting, live reloads, etc
• Package application into a single executable that could be run on existing OneApp servers
• Logging framework
• Mock server for UI development
• Import the OneApp development database into a reusable Docker container that all developers can utilize
• Import the OneApp development database correctly
  • The database currently has packages that are not compiling due to issues with the export from the existing database
  • This can be resolved by re-exporting and manually fixing the import errors
• Introduce a unit testing framework for GraphQL
• Setup different environment configurations
• Move over to NJ repo
• Setup dependabot

Application

• Configure a GraphQL server
• Build a solid modularized structure for working on GraphQL endpoints
• Prototype connecting GraphQL to the Oracle database
• Prototype using Oracle stored procedures against the real OneApp development database (Blocked until database is imported correctly. Verified process for stored procedures works, just not against the real data until import is fixed.)
• Authentication for the API
  • User credentials / API key to access the API, i.e. you have to have API credentials to create applications, etc. and random internet traffic won't be accessing data from the API without credentials
• Access controls for the API
  • Ensuring only the data created by the user is accessible, i.e. users can't access other users data
• Field-level validation for the API
  • Data sent to the API conforms to standards, i.e. email addresses are in email format, etc.

We need to setup a staging environment at USDS for internal testing.

Cloud.gov account

• Assemble list of required services we're going to use on Cloud.gov
• Reach out to Lisa about using USDS's Cloud.gov account
• Wait for Cloud.gov response on raising disk quota
• Deploy out application to cloud.gov after Oracle database is opened up (blocked)
• Communicate to Lisa the resource usage for cloud.gov
• Migrate app to USDS cloud.gov account (Waiting on available resources in NJ database) (#181)

Database

• Prepare database for Cloud.gov deploy
• Wait for NJ to open up Oracle database

Back-end

• Prepare back-end for Cloud.gov deploy (blocked)
• Connect back-end to database
• Deploy out the back-end to Cloud.gov

Front-end

• Prepare front-end for Cloud.gov deploy (blocked)
• Deploy out the front-end to Cloud.gov
• Connect front-end to back-end

CD

• Setup automatic deployments when code is merged into main

Description or User Story

As an applicant, I want to understand the application process and start my application.

Screenshots

• Desktop version

• Mobile version

Frontend Tasks (to be completed by Dev)

• TBD
• TBD

Backend Tasks (to be completed by Dev)

• TBD
• TBD
• TBD

Acceptance Criteria

• TBD
• TBD
• TBD

Note:

This replaces OneApp steps / process overview

Description or User Story

As a user I want to start an application by creating an account.

Screenshots

https://dhs.invisionapp.com/d/main#/console/20094964/425126493/preview

• Desktop version

• Mobile version

Acceptance Criteria

• Form built out on desktop
• Form is responsive and works for smaller viewports (tablet, mobile)
• Field validation works correctly (vaidation rules/design/copy)
• All preliminary copy is entered as shown in the mockup (we will create new tickets for future copy changes)
• All buttons/links go to correct location

Spanish translation will be tracked in another ticket.

Background

There is still a significant amount of work that needs to happen on the Basic Information section. This epic will track tickets associated with that work.

Tasks

• Review policy documentation from NJ team #73
• Make updates to the basic information section based on policy requirements and other NJ feedback #74
• Document validation rules & copy #75
• Document any conditional functionality #76
• Provide content for dropdowns #77
• Document mapping between old application and new application #78
• Content #128

Background

We need validation rules and copy documented for the basic information section. This includes:

• What fields are required
• What happens if someone submits a form without filling out the required fields
• Any other field validation (if applicable) outside of "required" validation
• All validation copy/error messages

Tasks

Provide the following in InVision:

• What fields are required
• What happens if someone submits a form without filling out the required fields
• Any other field validation (if applicable) outside of "required" validation
• All validation copy/error messages

https://dhs.invisionapp.com/share/N4XNBUHUXH3#/screens/426634098

• determine eligibility for expedited SNAP benefits

User story

As a [type of] user, in order to [task], I need [functionality/change]

Background (Optional)

Acceptance criteria

• [ ]
• [ ]

Level of effort - <low/medium/high>

low = <2 hours | med = half a day | high = 1-2 days | more? split issue

Implementation outline (if higher than "low" effort):

MVP criteria

• 1:
  -[ ] User can complete an application end-to-end (and worker can complete eligibility process)
  -[ ] Application is compliant with laws and regs
  -[ ] Mobile & cross-browser friendly
• 2:
  -[ ] Increase enrollment
  -[ ] Decrease time to benefits
• 3:
  -[ ] Easy to self- maintain/sustain by NJ-DHS

Background

It is a legal requirement that we enable/support Spanish translation. The following needs to happen for that to be complete:

PM

• Figure out process for NJ team providing Spanish translation #58

Design

• Confirm when all copy is complete

Frontend

• Export all copy and send to NJ team for Spanish translation #59

Implement Spanish translation on all sections of on OneApp:

• Homepage #60
• OneApp steps / process overview #61
• Section 0: Account and application screens #62
• Section 1: Basic Information #63

(Will add other sections as those are confirmed)

Description or User Story

As a user, I want information about how to apply for New Jersey state "safety net" benefits -- including my options for relief I may qualify for.

Screenshots

Desktop

Mobile

Frontend Tasks (to be completed by Dev)

• TBD
• TBD

Backend Tasks (to be completed by Dev)

• TBD
• TBD
• TBD

Acceptance Criteria

• TBD
• TBD
• TBD

The following fields split across a few pages:

first name
last name
middle name
maiden name
homelessness
payee
if not payee, payee first name
if not payee, payee last name
street address
city
state
zip code
county
mailing address
if not mailing address, street address
if not mailing address, city
if not mailing address, state
if not mailing address, zip code
primary phone
alternate phone
email address
member applying for benefits
disability (only if applying for benefits)
citizen status
if citizen, social security number
if not citizen, citizenship information
date of birth
relationship to payee
gender identity
gender at birth
if female, pregnant?
race
ethnicity
education
if yes, grade level
marital status

• if married, spouse of member
  accommodations
  language
  User story
  As a [type of] user, in order to [task], I need [functionality/change]

Background (Optional)
Acceptance criteria
[ ]
[ ]
Level of effort - <low/medium/high>
low = <2 hours | med = half a day | high = 1-2 days | more? split issue

Implementation outline (if higher than "low" effort):
MVP criteria
1:
-[ ] User can complete an application end-to-end (and worker can complete eligibility process)
-[ ] Application is compliant with laws and regs
-[ ] Mobile & cross-browser friendly
2:
-[ ] Increase enrollment
-[ ] Decrease time to benefits
3:
-[ ] Easy to self- maintain/sustain by NJ-DHS

Background

Spanish translation epic #21

When the Spanish translation is complete, Mike needs to implement it throughout the app.

This ticket is blocked until the Spanish translation is complete.

Tasks

• Implement Spanish translation for the homepage.

Dependabot encountered the following error when parsing your .dependabot/config.yml:

The property '#/update_configs/2' is a duplicate. Update configs must have a unique combination of 'package_manager', 'directory', and 'target_branch'

Please update the config file to conform with Dependabot's specification using our docs and online validator.

Description or User Story

As a user, I want to sign into my NJ OneApp account.

Screenshots

• Desktop version

• Mobile version

Acceptance Criteria

• Form built out on desktop
• Form is responsive and works for smaller viewports (tablet, mobile)
• Field validation works correctly (vaidation rules/design/copy)
• All preliminary copy is entered as shown in the mockup (we will create new tickets for future copy changes)
• All buttons/links go to correct location

Description or User Story

Screenshots

• Desktop version

• Mobile version

Frontend Tasks (to be completed by Dev)

• TBD
• TBD

Backend Tasks (to be completed by Dev)

• TBD
• TBD
• TBD

Acceptance Criteria

• TBD
• TBD
• TBD

Background

We need "if this, then this" conditional functionality clearly outlined in InVision for the basic information section.

Tasks

• Clearly document all conditional functionality in InVision for Mike.

Background

Spanish translation epic #21

We need to work with NJ to figure out how they expect to receive content for Spanish translation, how they will deliver the Spanish translation, and how long they need to provide us that translation.

Tasks

• Figure out in what format NJ team wants to receive content.
• Figure out how long the NJ team needs to provide the Spanish translation.
• Figure out in what format the translation will be delivered to us.

User Story

As a user, I want to get status updates on my application.

Details

https://dhs.invisionapp.com/share/N4XNBUHUXH3#/screens/426634091_v3-Login

• create an account
• continue without an account
• content that shows the 5 steps of the process

Background (optional)

Acceptance criteria

• [ ]
• [ ]

Level of effort - <low/medium/high>

low = <2 hours | med = half a day | high = 1-2 days | more? split issue

Implementation outline (if higher than "low" effort):

MVP criteria

• 1:
  -[ ] User can complete an application end-to-end (and worker can complete eligibility process)
  -[ ] Application is compliant with laws and regs
  -[ ] Mobile & cross-browser friendly
• 2:
  -[ ] Increase enrollment
  -[ ] Decrease time to benefits
• 3:
  -[ ] Easy to self- maintain/sustain by NJ-DHS

Set up a training plan that NJ developers can follow on their own time.

Training Service

• Reach out to Tom about NJ paying for training plan
• (Tom) Get Treehouse approval from NJ training department
• Reach out to Treehouse about teams pricing
• (Blocked) Wait for Treehouse to send pricing
• Pass Treehouse pricing on to NJ

Course

• Assemble a list of general developer courses (GitHub, etc)
• Assemble a list of back-end courses
• Assemble a list of front-end courses
• Send course list over to Treehouse for them to make a track
• Notify NJ developers about course list

Dev Setup

• Make sure all developers have access to GitHub

Background

Melissa met with the NJ team on 8.19.20 and received some new policy guidance (#73) and design feedback. This ticket is for implementing the changes based on that feedback and the new policy guidance we have.

Tasks

• Add ability to submit the app on every page of basic info section post-emergency/quick submit (and every page of application)
• Adjust order of required questions in basic info to put name/address/email/program interest first.
• Incorporate any other updates as required by the policy guidance provided.
• Update the order of the basic info section based on NJ's feedback.

Background

In the 8.19.20 regroup with the NJ team, the NJ team handed off some policy documentation to Melissa that will affect the design of the basic information section and the rest of the app. This includes some of the following:

• People need to be able to submit the application on any page.
• We need to ask certain required information on the first page of the basic info section — Name, address, email, program the applicant is interested in.

Melissa needs to review this documentation and see if there are other relevant policy requirements that she needs to incorporate into the design.

Tasks

• Add that documentation to Github
• Link that documentation to this ticket
• Read/review the documentation
• Create a list of additional design requirements based on that documentation
• Add that list or requirements to this ticket

User Story

As a [type of] user, in order to [task], I need [functionality/change]

As a potential applicant, in order to spend the time applying, I need a quick screener to know if it's worth my time.

Background (Optional)

This is the current screener. It includes Medicaid as well. I'm not sure it works - I tried it in Chrome and Safari and no matter how much money I make, I get the same results. Not sure what's up.

18F has started building a screener for SNAP. We could possibly fork this, add TANF and Medicaid.

Acceptance Criteria

• maintain current programs SNAP, TANF, GA, and Medicaid
• [ ]

Level of effort - <low/medium/high>

Epic issue needs splitting

low = <2 hours | med = half a day | high = 1-2 days | more? create epic and split issue

Implementation outline (if higher than "low" effort):

MVP criteria

• 1
  • User can complete an application end-to-end (and worker can complete eligibility process)
  • Application is compliant with laws and regs
  • Mobile & cross-browser friendly
• 2:
  • Increase enrollment
  • Decrease time to benefits
• 3:
  • Easy to self- maintain/sustain by NJ-DHS

Background

One big outstanding question for this project is whether there will be any differences between the client/caseworker views for the application. We need to determine:

• What does NJ think we are delivering them? Are there client/caseworker permissions they are expecting us to deliver? Are there client/caseworker permissions that are required?
• If NJ is expecting a difference in the client/caseworker permissions/flows, what are they?

Tasks

• Determine a plan for how to approach NJ about client and caseworker view requirements/permissions.
• Meet with NJ to discuss client/caseworker view requirements/permissions.
• Document decisions from that discussion.
• Create design tickets for any new functionality we plan to implement.

Background

Ron and Mike have requested the following documentation:

• Order of new questions and answers
• How the old application maps to the new application

For this ticket, Melissa will create this documentation for the basic information section only.

Tasks

• Document order of all questions and answers for the new basic info section
• Document how the new app maps to the old app for the basic info section
• Add this document to Github
• Work with Samara to create necessary build tickets coming out of this

Description or User Story

Build out code demo of the combined Client/Worker version of one-app to share with Carmen at NJ-DHS.

• Key requirement: The worker version of the app must contain all data fields (whether filled or empty) as they will use this to guide the follow up in-person/on-phone client interview.

Screenshots

Frontend Tasks (to be completed by Dev)

• TBD
• TBD

Backend Tasks (to be completed by Dev)

• TBD
• TBD
• TBD

Acceptance Criteria

• TBD
• TBD
• TBD

Description or User Story

As a user with an account, I need to have my username sent to me because I forgot it.

Screenshots

• Desktop version

• Mobile version

Acceptance Criteria

• Form built out on desktop
• Form is responsive and works for smaller viewports (tablet, mobile)
• Field validation works correctly (vaidation rules/design/copy)
• All preliminary copy is entered as shown in the mockup (we will create new tickets for future copy changes)
• All buttons/links go to correct location

Background

Spanish translation epic #21

When the Spanish translation is complete, Mike needs to implement it throughout the app.

This ticket is blocked until the Spanish translation is complete.

Tasks

Implement Spanish translation for Section 1 — Basic Information on the following pages:

[Fill out when we have confirmed names and order of pages]

Background

In the Oracle database, there are procedures that the frontend will need to call. We need to build out GraphQL nodes for all of those procedures.

In order to now what we are dealing with, Ron should conduct an audit of all the procedures in Oracle.

Tasks

• Create audit of Oracle procedures for NJ SNAP benefits app.
• Add documentation of that audit to this Github folder.

Acceptance criteria

• Ron has completed and documented this audit and has a good enough sense of Oracle procedures to start moving forward with GraphQL work.

Issue Description

• Applicant should have ability to select what they want to apply for (SNAP, GA, TANF)
• System should prompt if they are also eligible for GA and TANF and applicant did not select those programs
• Right now, system does not do any eligibility checks, so we need to determine if we want to do this
• Option A: Eligibility check, let applicant know, if yes, display the additional fields for the programs
• Option B: Use system as-is, so it's a false choice and applicant applies for all 3 even if they select only one

How to configure this issue

• Attached to a Milestone (when will this be completed?)
• Attached to an Epic (what body of work is this a part of?)
• Labeled with Team (product support, analytics-insights, operations, service-design, tools-be, tools-fe)
• Labeled with Practice Area (backend, frontend, devops, design, research, product, ia, qa, analytics, contact center, research, accessibility, content)
• Labeled with Type (bug, request, discovery, documentation, etc.)

Background

QA and accessibility reviews will need to be conducted of the new OneApp after build. We need to figure out who can conduct this for us.

Tasks

• Figure out who will conduct accessibility review
• Figure out who will conduct QA

Description or User Story

As a user who has submitted an application, I want to check the status of my application with my confirmation number.

Screenshots

• Check status

• Status screen - confirmed

• Status screen - pending

Acceptance Criteria

• Form built out on desktop
• Form is responsive and works for smaller viewports (tablet, mobile)
• All preliminary copy is entered as shown in the mockup (we will create new tickets for future copy changes)
• All buttons/links go to correct location

This work is blocked until design for this section is complete.

Design epic #72

Description or User Story

As an applicant, I need to provide basic information about myself and/or household

Sections

• Programs
• Applicant Information
• SNAP Information
• Household 1
• Household 2
• Other Individuals
• SNAP Header/Household

Background

Spanish translation epic #21

When the Spanish translation is complete, Mike needs to implement it throughout the app.

This ticket is blocked until the Spanish translation is complete.

Tasks

• Implement Spanish translation for the OneApp steps / process overview.

• consent form, screener, email template in english / spanish
• list of participants
• [] all interviews conducted/completed and synthesized

Background

We need someone who can audit all of the existing URLs for the application, create a new URL structure (if necessary), document all redirects, and figure out our SEO needs. After talking with Melissa, we determined it would be ideal/best if someone who has more expertise availability pitched in with this part of the effort.

Tasks

• Talk to Lisa/Sheri about who might be able to help out with this
• Determine who will be handling the URL audit/structure/documentation and SEO needs for this project.

Description or User Story

As an application, I want to view my application list to see in progress and/or completed applications.

Screenshots

Depending on the user's application status, one of the following screens will display:

• In progress application list

• Completed application list

Acceptance Criteria

• Form built out on desktop
• Form is responsive and works for smaller viewports (tablet, mobile)
• All preliminary copy is entered as shown in the mockup (we will create new tickets for future copy changes)
• All buttons/links go to correct location

The state of New Jersey has recently has passed a new law that now requires the Dept of Corrections to assist current inmates with applying for SNAP and WFJN (TANF/GA) before they are released. NJ-DHS may add new questions to the OneApp application to account for this change.

Issue Description

https://dhs.invisionapp.com/share/N4XNBUHUXH3#/screens/426634092

• choose program to apply for (SNAP, TANF, GA)
• need to determine selection logic (#5 )

Front end tasks

Acceptance Criteria

Appendix

How to configure this issue

• Attached to a Milestone (when will this be completed?)
• Attached to an Epic (what body of work is this a part of?)
• Labeled with Team (product support, analytics-insights, operations, service-design, tools-be, tools-fe)
• Labeled with Practice Area (backend, frontend, devops, design, research, product, ia, qa, analytics, contact center, research, accessibility, content)
• Labeled with Type (bug, request, discovery, documentation, etc.)

Background

Is your UX/Design request related to a problem? Please describe.

NJ DHS has outlined a number of request changes to the OneApp flow, including the addition of new data fields (e.g. Gender, Crowdsourcing) and positional changes for some sections of the application.

Possible work requests

• work request from 9/2019
• gender identity updates
• "OneApp updates"
• institutional applicants
• download a spreadsheet with some (all?) changes

Tasks

• Leah to review the spreadsheet in this ticket
• Review with NJ team and get answers to outstanding questions
• Once all questions are answered, work with Samara to get tickets created for design/dev

Description or User Story

As a user with an account, I need to reset my password to login

Screenshots

• Desktop version

• Mobile version

Acceptance Criteria

• Form built out on desktop
• Form is responsive and works for smaller viewports (tablet, mobile)
• Field validation works correctly (vaidation rules/design/copy)
• All preliminary copy is entered as shown in the mockup (we will create new tickets for future copy changes)
• All buttons/links go to correct location

Background

We need the dropdown content for each dropdown in the basic information section so Mike can build these form fields correctly.

Tasks

• Ask for NJ's guidance on content for each dropdown in the basic info section.
• Document the content for each dropdown in InVision.

Background

Spanish translation epic #21

When the Spanish translation is complete, Mike needs to implement it throughout the app.

This ticket is blocked until the Spanish translation is complete.

Tasks

Implement Spanish translation for Section 0 — Account and application screens on the following pages:

• Account sign up
• Account sign in
• Forgot username
• Forgot password
• Check application status
• View application list