From 8da33040248fd65a568608e7e568cf0078e4ec56 Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 2 Feb 2024 17:27:03 -0800 Subject: [PATCH 01/17] Low-income use case --- docs/enrollment-pathways/Low-income.md | 77 ++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 docs/enrollment-pathways/Low-income.md diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/Low-income.md new file mode 100644 index 000000000..2d7892a58 --- /dev/null +++ b/docs/enrollment-pathways/Low-income.md @@ -0,0 +1,77 @@ +# Low-income + +## Overview + +This use case describes a feature in the[ Cal-ITP Benefits app](https://benefits.calitp.org) that allows Californians to verify their active participation in the CalFresh Program—as a proxy for low-income status—to receive reduced fares for transit when paying by contactless debit or credit card at participating transit operators in California. + +**Actor:** A person who uses public transit in California. For benefit eligibility, a “low-income rider” is a person who has received [CalFresh benefits](https://www.cdss.ca.gov/food-nutrition/calfresh) in any of the previous three months. + +**Goal:** To verify a transit rider’s financial need so they receive reduced fares when paying by contactless debit or credit card. + +**Precondition:** The California transit operator offers fixed route service, has installed and tested validator hardware necessary to collect fares using contactless payment on bus or rail lines, and the operator has a policy in place to offer a transit discount to low-income riders. + +## **Basic Flow** + +1. The transit rider visits the web application at [benefits.calitp.org](benefits.calitp.org) in a browser on their desktop computer. + +2. The transit rider chooses the transit operator that serves their area. + +3. The transit rider chooses to verify their eligibility as a participant in the [CalFresh Program](https://www.cdss.ca.gov/food-nutrition/calfresh). + +4. The transit rider authenticates with their existing [Login.gov](Login.gov) account or, if they don’t have one, creates a [Login.gov](Login.gov) account. + +5. The Cal-ITP Benefits app interfaces with the [California Department of Transportation](https://dot.ca.gov/) Identity Gateway (IdG) to verify benefit eligibility. The IdG uses personal information shared by [Login.gov](Login.gov) to verify Calfresh participation status. + +6. The IdG uses the response provided by the California Department of Social Services (CDSS) to determine the rider’s eligibility for a transit benefit. + +7. The IdG then passes the response from CDSS as low-income status = TRUE to the Cal-ITP Benefits app to indicate the person is eligible for a benefit. + +8. The transit rider provides the debit or credit card details they use to pay for transit to Littlepay, the payment processor that facilitates transit fare collection. + +9. The app registers the low-income benefit with the transit rider’s debit or credit card. + +## **Alternative Flows** + +- Suppose the transit rider does not have a desktop computer. In this case, they open the web application at [benefits.calitp.org](benefits.calitp.org) in a mobile browser on their iOS or Android tablet or mobile device to complete enrollment using the basic flow. + +- Suppose the transit rider cannot authenticate with [Login.gov](Login.gov), or will not create an account. In either case, the app cannot determine their Calfresh Program participation status and they cannot enroll their contactless debit or credit card for a reduced fare. + +- Suppose the CDT Identity Gateway returns a status of FALSE for Calfresh Program participation status. In that case, the Cal-ITP Benefits app will not allow the transit rider to enroll their contactless debit or credit card for a reduced fare. + +- Suppose the debit or credit card expires or is canceled by the issuer. In that case, the transit rider must repeat the basic flow to register a new debit or credit card. + +- When the initial transit benefit enrollment period ends after one year from the date of enrollment, the transit rider must repeat the basic flow to re-enroll. + +- Suppose the transit rider attempts to re-enroll for a transit benefit as a CalFresh Program participant three months after their enrollment period started. The app will inform them they must wait re-enroll within 14 days of the benefit expiration. + +- Suppose the transit rider doesn’t re-enroll for a transit benefit after one year, but continues paying for transit using the card they registered. The transit operator will charge the rider full fare. + +- If the transit rider uses more than one debit or credit card to pay for transit, they repeat the basic flow for each card. + +## **Postcondition** + +The transit rider receives a fare reduction each time they use the debit or credit card they registered to pay for transit rides. The number of times they can use the card to pay for transit is unlimited, but the benefit expires one year after enrollment. + +## **Benefits** + +- The transit rider no longer needs cash to pay for transit rides. + +- The transit rider doesn’t have to lock up funds on a closed-loop card offered by the transit agency. + +- The transit rider pays for transit rides with their debit or credit card, just as they do for groceries, a cup of coffee, or any other good or service. + +- The transit rider can enroll in a transit benefit from home when convenient; they do not have to visit a transit agency in person. + +- Secure state and federal solutions manage the transit rider’s personal identifiable information (PII): [Login.gov](Login.gov) and the California Department of Technology Identity Gateway (IdG). Transit riders do not have to share personal information with local transit operators. + +- Benefit enrollment takes minutes rather than days or weeks. + +- Benefit enrollment doesn’t require online accounts with private companies. + +## **Example Scenario** + +A Calfresh Program participant uses public transit regularly. They don’t have a car and depend on buses to get to appointments and do errands that take too long to use their bicycle. Even though this person already qualifies for benefits from the California Department of Social Services, they had to navigate another extensive, in-person eligibility process with different requirements to qualify for reduced fares from their local transit agency. They now receive a 50% fare reduction but have to pay for transit rides using the closed loop card provided by the operator to receive the reduced fare. It’s frustrating and inconvenient to reload this closed loop card in $10 payments every week, especially because they sometimes they could use the money tied up on the card to make ends meet. In summary, this person pays for daily expenses using three forms of payment: their EBT card for eligibles items, their agency card for transportation, and their bank card for everything else. + +The transit operator serving their region of California implements contactless payments on fixed bus routes throughout the service area. This rider uses [benefits.calitp.org](benefits.calitp.org) on their mobile device to confirm their participation in the CalFresh Program offered by CDSS and registers their debit card for reduced fares. They tap to pay when boarding buses in their area and are automatically charged the reduced fare. While they still need to manage funds on their EBT card *and* their bank card, they no longer need to use their transit operator card to pay for transit. Best of all, they have complete access to all funds in their weekly budget. If other expenses are higher one week, they can allocate additional funds to those areas and ride transit less. + + From 93c79b8366720313e230fcc0b88c22445c46ae14 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Sat, 3 Feb 2024 01:27:46 +0000 Subject: [PATCH 02/17] chore(pre-commit): autofix run --- docs/enrollment-pathways/Low-income.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/Low-income.md index 2d7892a58..09e7b6063 100644 --- a/docs/enrollment-pathways/Low-income.md +++ b/docs/enrollment-pathways/Low-income.md @@ -40,11 +40,11 @@ This use case describes a feature in the[ Cal-ITP Benefits app](https://benefits - Suppose the debit or credit card expires or is canceled by the issuer. In that case, the transit rider must repeat the basic flow to register a new debit or credit card. -- When the initial transit benefit enrollment period ends after one year from the date of enrollment, the transit rider must repeat the basic flow to re-enroll. +- When the initial transit benefit enrollment period ends after one year from the date of enrollment, the transit rider must repeat the basic flow to re-enroll. -- Suppose the transit rider attempts to re-enroll for a transit benefit as a CalFresh Program participant three months after their enrollment period started. The app will inform them they must wait re-enroll within 14 days of the benefit expiration. +- Suppose the transit rider attempts to re-enroll for a transit benefit as a CalFresh Program participant three months after their enrollment period started. The app will inform them they must wait re-enroll within 14 days of the benefit expiration. -- Suppose the transit rider doesn’t re-enroll for a transit benefit after one year, but continues paying for transit using the card they registered. The transit operator will charge the rider full fare. +- Suppose the transit rider doesn’t re-enroll for a transit benefit after one year, but continues paying for transit using the card they registered. The transit operator will charge the rider full fare. - If the transit rider uses more than one debit or credit card to pay for transit, they repeat the basic flow for each card. @@ -70,8 +70,6 @@ The transit rider receives a fare reduction each time they use the debit or cred ## **Example Scenario** -A Calfresh Program participant uses public transit regularly. They don’t have a car and depend on buses to get to appointments and do errands that take too long to use their bicycle. Even though this person already qualifies for benefits from the California Department of Social Services, they had to navigate another extensive, in-person eligibility process with different requirements to qualify for reduced fares from their local transit agency. They now receive a 50% fare reduction but have to pay for transit rides using the closed loop card provided by the operator to receive the reduced fare. It’s frustrating and inconvenient to reload this closed loop card in $10 payments every week, especially because they sometimes they could use the money tied up on the card to make ends meet. In summary, this person pays for daily expenses using three forms of payment: their EBT card for eligibles items, their agency card for transportation, and their bank card for everything else. +A Calfresh Program participant uses public transit regularly. They don’t have a car and depend on buses to get to appointments and do errands that take too long to use their bicycle. Even though this person already qualifies for benefits from the California Department of Social Services, they had to navigate another extensive, in-person eligibility process with different requirements to qualify for reduced fares from their local transit agency. They now receive a 50% fare reduction but have to pay for transit rides using the closed loop card provided by the operator to receive the reduced fare. It’s frustrating and inconvenient to reload this closed loop card in $10 payments every week, especially because they sometimes they could use the money tied up on the card to make ends meet. In summary, this person pays for daily expenses using three forms of payment: their EBT card for eligibles items, their agency card for transportation, and their bank card for everything else. The transit operator serving their region of California implements contactless payments on fixed bus routes throughout the service area. This rider uses [benefits.calitp.org](benefits.calitp.org) on their mobile device to confirm their participation in the CalFresh Program offered by CDSS and registers their debit card for reduced fares. They tap to pay when boarding buses in their area and are automatically charged the reduced fare. While they still need to manage funds on their EBT card *and* their bank card, they no longer need to use their transit operator card to pay for transit. Best of all, they have complete access to all funds in their weekly budget. If other expenses are higher one week, they can allocate additional funds to those areas and ride transit less. - - From 8523ec9f11a76744b169a638fb4275ccf4ac1873 Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 14:25:37 -0800 Subject: [PATCH 03/17] Update docs/enrollment-pathways/Low-income.md formatting Co-authored-by: machiko --- docs/enrollment-pathways/Low-income.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/Low-income.md index 09e7b6063..fef3a8ab5 100644 --- a/docs/enrollment-pathways/Low-income.md +++ b/docs/enrollment-pathways/Low-income.md @@ -10,7 +10,7 @@ This use case describes a feature in the[ Cal-ITP Benefits app](https://benefits **Precondition:** The California transit operator offers fixed route service, has installed and tested validator hardware necessary to collect fares using contactless payment on bus or rail lines, and the operator has a policy in place to offer a transit discount to low-income riders. -## **Basic Flow** +## Basic Flow 1. The transit rider visits the web application at [benefits.calitp.org](benefits.calitp.org) in a browser on their desktop computer. From d6bebe20e04883b42eaf5a7367337762d55752d6 Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 14:28:48 -0800 Subject: [PATCH 04/17] Update docs/enrollment-pathways/Low-income.md remove link to application Co-authored-by: machiko --- docs/enrollment-pathways/Low-income.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/Low-income.md index fef3a8ab5..8d3db8c3c 100644 --- a/docs/enrollment-pathways/Low-income.md +++ b/docs/enrollment-pathways/Low-income.md @@ -2,7 +2,7 @@ ## Overview -This use case describes a feature in the[ Cal-ITP Benefits app](https://benefits.calitp.org) that allows Californians to verify their active participation in the CalFresh Program—as a proxy for low-income status—to receive reduced fares for transit when paying by contactless debit or credit card at participating transit operators in California. +This use case describes a feature in the Cal-ITP Benefits app that allows Californians to verify their active participation in the CalFresh Program—as a proxy for low-income status—to receive reduced fares for transit when paying by contactless debit or credit card at participating transit operators in California. **Actor:** A person who uses public transit in California. For benefit eligibility, a “low-income rider” is a person who has received [CalFresh benefits](https://www.cdss.ca.gov/food-nutrition/calfresh) in any of the previous three months. From 3a490c08d082eb0348a0e50d68ab9464d89c128c Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 14:30:16 -0800 Subject: [PATCH 05/17] Update docs/enrollment-pathways/Low-income.md remove link to application Co-authored-by: machiko --- docs/enrollment-pathways/Low-income.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/Low-income.md index 8d3db8c3c..02e176ffc 100644 --- a/docs/enrollment-pathways/Low-income.md +++ b/docs/enrollment-pathways/Low-income.md @@ -32,7 +32,7 @@ This use case describes a feature in the Cal-ITP Benefits app that allows Califo ## **Alternative Flows** -- Suppose the transit rider does not have a desktop computer. In this case, they open the web application at [benefits.calitp.org](benefits.calitp.org) in a mobile browser on their iOS or Android tablet or mobile device to complete enrollment using the basic flow. +- Suppose the transit rider does not have a desktop computer. In this case, they open the web application at `benefits.calitp.org` in a mobile browser on their iOS or Android tablet or mobile device to complete enrollment using the basic flow. - Suppose the transit rider cannot authenticate with [Login.gov](Login.gov), or will not create an account. In either case, the app cannot determine their Calfresh Program participation status and they cannot enroll their contactless debit or credit card for a reduced fare. From deb0fbb60fbcf3345cf9e978b2bed6643574c14b Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 14:30:56 -0800 Subject: [PATCH 06/17] Update docs/enrollment-pathways/Low-income.md adding code syntax for response formatting Co-authored-by: machiko --- docs/enrollment-pathways/Low-income.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/Low-income.md index 02e176ffc..276ab843f 100644 --- a/docs/enrollment-pathways/Low-income.md +++ b/docs/enrollment-pathways/Low-income.md @@ -36,7 +36,7 @@ This use case describes a feature in the Cal-ITP Benefits app that allows Califo - Suppose the transit rider cannot authenticate with [Login.gov](Login.gov), or will not create an account. In either case, the app cannot determine their Calfresh Program participation status and they cannot enroll their contactless debit or credit card for a reduced fare. -- Suppose the CDT Identity Gateway returns a status of FALSE for Calfresh Program participation status. In that case, the Cal-ITP Benefits app will not allow the transit rider to enroll their contactless debit or credit card for a reduced fare. +- Suppose the IdG returns a status of `FALSE` for CalFresh Program participation status. In that case, the Cal-ITP Benefits app will not allow the transit rider to enroll their contactless debit or credit card for a reduced fare. - Suppose the debit or credit card expires or is canceled by the issuer. In that case, the transit rider must repeat the basic flow to register a new debit or credit card. From 4c10d2c6a4bddd4638415d2693b0b933705742da Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 14:33:46 -0800 Subject: [PATCH 07/17] Update docs/enrollment-pathways/Low-income.md remove link to application Co-authored-by: machiko --- docs/enrollment-pathways/Low-income.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/Low-income.md index 276ab843f..029927d3b 100644 --- a/docs/enrollment-pathways/Low-income.md +++ b/docs/enrollment-pathways/Low-income.md @@ -72,4 +72,4 @@ The transit rider receives a fare reduction each time they use the debit or cred A Calfresh Program participant uses public transit regularly. They don’t have a car and depend on buses to get to appointments and do errands that take too long to use their bicycle. Even though this person already qualifies for benefits from the California Department of Social Services, they had to navigate another extensive, in-person eligibility process with different requirements to qualify for reduced fares from their local transit agency. They now receive a 50% fare reduction but have to pay for transit rides using the closed loop card provided by the operator to receive the reduced fare. It’s frustrating and inconvenient to reload this closed loop card in $10 payments every week, especially because they sometimes they could use the money tied up on the card to make ends meet. In summary, this person pays for daily expenses using three forms of payment: their EBT card for eligibles items, their agency card for transportation, and their bank card for everything else. -The transit operator serving their region of California implements contactless payments on fixed bus routes throughout the service area. This rider uses [benefits.calitp.org](benefits.calitp.org) on their mobile device to confirm their participation in the CalFresh Program offered by CDSS and registers their debit card for reduced fares. They tap to pay when boarding buses in their area and are automatically charged the reduced fare. While they still need to manage funds on their EBT card *and* their bank card, they no longer need to use their transit operator card to pay for transit. Best of all, they have complete access to all funds in their weekly budget. If other expenses are higher one week, they can allocate additional funds to those areas and ride transit less. +The transit operator serving their region of California implements contactless payments on fixed bus routes throughout the service area. This rider uses `benefits.calitp.org` on their mobile device to confirm their participation in the CalFresh Program offered by CDSS and registers their debit card for reduced fares. They tap to pay when boarding buses in their area and are automatically charged the reduced fare. While they still need to manage funds on their EBT card *and* their bank card, they no longer need to use their transit operator card to pay for transit. Best of all, they have complete access to all funds in their weekly budget. If other expenses are higher one week, they can allocate additional funds to those areas and ride transit less. From bd70f889b5c83809e5ab55ae36dd52aa37ca38f5 Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 14:34:09 -0800 Subject: [PATCH 08/17] Update docs/enrollment-pathways/Low-income.md remove link to application Co-authored-by: machiko --- docs/enrollment-pathways/Low-income.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/Low-income.md index 029927d3b..24b1b140b 100644 --- a/docs/enrollment-pathways/Low-income.md +++ b/docs/enrollment-pathways/Low-income.md @@ -12,7 +12,7 @@ This use case describes a feature in the Cal-ITP Benefits app that allows Califo ## Basic Flow -1. The transit rider visits the web application at [benefits.calitp.org](benefits.calitp.org) in a browser on their desktop computer. +1. The transit rider visits the web application at `benefits.calitp.org` in a browser on their desktop computer. 2. The transit rider chooses the transit operator that serves their area. From c1bed4e7c6b171dda63a3a1536d954fe2aac1fdc Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 14:37:46 -0800 Subject: [PATCH 09/17] Update docs/enrollment-pathways/Low-income.md clarifying acronym Co-authored-by: machiko --- docs/enrollment-pathways/Low-income.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/Low-income.md index 24b1b140b..a1d7bd588 100644 --- a/docs/enrollment-pathways/Low-income.md +++ b/docs/enrollment-pathways/Low-income.md @@ -70,6 +70,6 @@ The transit rider receives a fare reduction each time they use the debit or cred ## **Example Scenario** -A Calfresh Program participant uses public transit regularly. They don’t have a car and depend on buses to get to appointments and do errands that take too long to use their bicycle. Even though this person already qualifies for benefits from the California Department of Social Services, they had to navigate another extensive, in-person eligibility process with different requirements to qualify for reduced fares from their local transit agency. They now receive a 50% fare reduction but have to pay for transit rides using the closed loop card provided by the operator to receive the reduced fare. It’s frustrating and inconvenient to reload this closed loop card in $10 payments every week, especially because they sometimes they could use the money tied up on the card to make ends meet. In summary, this person pays for daily expenses using three forms of payment: their EBT card for eligibles items, their agency card for transportation, and their bank card for everything else. +A CalFresh Program participant uses public transit regularly. They don’t have a car and depend on buses to get to appointments and do errands that take too long to use their bicycle. Even though this person already qualifies for benefits from the California Department of Social Services, they had to navigate another extensive, in-person eligibility process with different requirements to qualify for reduced fares from their local transit agency. They now receive a 50% fare reduction but have to pay for transit rides using the closed loop card provided by the operator to receive the reduced fare. It’s frustrating and inconvenient to reload this closed loop card in $10 payments every week, especially because they sometimes they could use the money tied up on the card to make ends meet. In summary, this person pays for daily expenses using three forms of payment: their Electronic Benefits Transfer (EBT) card for eligible items, their agency card for transportation, and their bank card (or cash) for everything else. The transit operator serving their region of California implements contactless payments on fixed bus routes throughout the service area. This rider uses `benefits.calitp.org` on their mobile device to confirm their participation in the CalFresh Program offered by CDSS and registers their debit card for reduced fares. They tap to pay when boarding buses in their area and are automatically charged the reduced fare. While they still need to manage funds on their EBT card *and* their bank card, they no longer need to use their transit operator card to pay for transit. Best of all, they have complete access to all funds in their weekly budget. If other expenses are higher one week, they can allocate additional funds to those areas and ride transit less. From 633a6e6db83a07feecae658709514683483dc342 Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 14:48:52 -0800 Subject: [PATCH 10/17] Update docs/enrollment-pathways/Low-income.md capitalization Co-authored-by: machiko --- docs/enrollment-pathways/Low-income.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/Low-income.md index a1d7bd588..6caf7c014 100644 --- a/docs/enrollment-pathways/Low-income.md +++ b/docs/enrollment-pathways/Low-income.md @@ -20,7 +20,7 @@ This use case describes a feature in the Cal-ITP Benefits app that allows Califo 4. The transit rider authenticates with their existing [Login.gov](Login.gov) account or, if they don’t have one, creates a [Login.gov](Login.gov) account. -5. The Cal-ITP Benefits app interfaces with the [California Department of Transportation](https://dot.ca.gov/) Identity Gateway (IdG) to verify benefit eligibility. The IdG uses personal information shared by [Login.gov](Login.gov) to verify Calfresh participation status. +5. The Cal-ITP Benefits app interfaces with the [California Department of Transportation](https://dot.ca.gov/) Identity Gateway (IdG) to verify benefit eligibility. The IdG uses personal information shared by [Login.gov](Login.gov) to verify CalFresh participation status. 6. The IdG uses the response provided by the California Department of Social Services (CDSS) to determine the rider’s eligibility for a transit benefit. From ea09cec510baaf7d431f9edabfc261c4b119cbe8 Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 14:49:17 -0800 Subject: [PATCH 11/17] Update docs/enrollment-pathways/Low-income.md capitalization Co-authored-by: machiko --- docs/enrollment-pathways/Low-income.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/Low-income.md index 6caf7c014..4482a2719 100644 --- a/docs/enrollment-pathways/Low-income.md +++ b/docs/enrollment-pathways/Low-income.md @@ -34,7 +34,7 @@ This use case describes a feature in the Cal-ITP Benefits app that allows Califo - Suppose the transit rider does not have a desktop computer. In this case, they open the web application at `benefits.calitp.org` in a mobile browser on their iOS or Android tablet or mobile device to complete enrollment using the basic flow. -- Suppose the transit rider cannot authenticate with [Login.gov](Login.gov), or will not create an account. In either case, the app cannot determine their Calfresh Program participation status and they cannot enroll their contactless debit or credit card for a reduced fare. +- Suppose the transit rider cannot authenticate with [Login.gov](Login.gov), or will not create an account. In either case, the app cannot determine their CalFresh Program participation status and they cannot enroll their contactless debit or credit card for a reduced fare. - Suppose the IdG returns a status of `FALSE` for CalFresh Program participation status. In that case, the Cal-ITP Benefits app will not allow the transit rider to enroll their contactless debit or credit card for a reduced fare. From d0ed1bdee732b8a0fb1b08376598d6daa31c7722 Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 14:53:09 -0800 Subject: [PATCH 12/17] Rename Low-income.md to low-income.md --- docs/enrollment-pathways/{Low-income.md => low-income.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/enrollment-pathways/{Low-income.md => low-income.md} (100%) diff --git a/docs/enrollment-pathways/Low-income.md b/docs/enrollment-pathways/low-income.md similarity index 100% rename from docs/enrollment-pathways/Low-income.md rename to docs/enrollment-pathways/low-income.md From 73e0129db5166a4afa1be7dc2c134f003589b6f4 Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 14:54:23 -0800 Subject: [PATCH 13/17] Update low-income.md removed extraneous bolding on headings --- docs/enrollment-pathways/low-income.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/enrollment-pathways/low-income.md b/docs/enrollment-pathways/low-income.md index 4482a2719..0002c88c9 100644 --- a/docs/enrollment-pathways/low-income.md +++ b/docs/enrollment-pathways/low-income.md @@ -30,7 +30,7 @@ This use case describes a feature in the Cal-ITP Benefits app that allows Califo 9. The app registers the low-income benefit with the transit rider’s debit or credit card. -## **Alternative Flows** +## Alternative Flows - Suppose the transit rider does not have a desktop computer. In this case, they open the web application at `benefits.calitp.org` in a mobile browser on their iOS or Android tablet or mobile device to complete enrollment using the basic flow. @@ -48,11 +48,11 @@ This use case describes a feature in the Cal-ITP Benefits app that allows Califo - If the transit rider uses more than one debit or credit card to pay for transit, they repeat the basic flow for each card. -## **Postcondition** +## Postcondition The transit rider receives a fare reduction each time they use the debit or credit card they registered to pay for transit rides. The number of times they can use the card to pay for transit is unlimited, but the benefit expires one year after enrollment. -## **Benefits** +## Benefits - The transit rider no longer needs cash to pay for transit rides. @@ -68,7 +68,7 @@ The transit rider receives a fare reduction each time they use the debit or cred - Benefit enrollment doesn’t require online accounts with private companies. -## **Example Scenario** +## Example Scenario A CalFresh Program participant uses public transit regularly. They don’t have a car and depend on buses to get to appointments and do errands that take too long to use their bicycle. Even though this person already qualifies for benefits from the California Department of Social Services, they had to navigate another extensive, in-person eligibility process with different requirements to qualify for reduced fares from their local transit agency. They now receive a 50% fare reduction but have to pay for transit rides using the closed loop card provided by the operator to receive the reduced fare. It’s frustrating and inconvenient to reload this closed loop card in $10 payments every week, especially because they sometimes they could use the money tied up on the card to make ends meet. In summary, this person pays for daily expenses using three forms of payment: their Electronic Benefits Transfer (EBT) card for eligible items, their agency card for transportation, and their bank card (or cash) for everything else. From 8af3ba39734716d5aeadc4e95d3ecad7a20095bb Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 15:16:53 -0800 Subject: [PATCH 14/17] Update low-income.md added additional benefits to using Benefits! --- docs/enrollment-pathways/low-income.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/enrollment-pathways/low-income.md b/docs/enrollment-pathways/low-income.md index 0002c88c9..eb526b189 100644 --- a/docs/enrollment-pathways/low-income.md +++ b/docs/enrollment-pathways/low-income.md @@ -62,6 +62,10 @@ The transit rider receives a fare reduction each time they use the debit or cred - The transit rider can enroll in a transit benefit from home when convenient; they do not have to visit a transit agency in person. +- The transit rider does not have to prove income eligibility with the transit agency. The app simply uses their participation in the CalFresh program to confirm eligibility for a transit benefit. + +- The transit agency doesn't have to craft and policy for a low-icome discount; they simply use the approach implemented in the Cal-ITP Benefits application. As more agencies adopt the application, they also adopt a standard policy for transit benefits. + - Secure state and federal solutions manage the transit rider’s personal identifiable information (PII): [Login.gov](Login.gov) and the California Department of Technology Identity Gateway (IdG). Transit riders do not have to share personal information with local transit operators. - Benefit enrollment takes minutes rather than days or weeks. From 03727b231468b69b7b794a46971ae54ac5f6ef2d Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Fri, 9 Feb 2024 23:17:03 +0000 Subject: [PATCH 15/17] chore(pre-commit): autofix run --- docs/enrollment-pathways/low-income.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/low-income.md b/docs/enrollment-pathways/low-income.md index eb526b189..b8cf39640 100644 --- a/docs/enrollment-pathways/low-income.md +++ b/docs/enrollment-pathways/low-income.md @@ -64,7 +64,7 @@ The transit rider receives a fare reduction each time they use the debit or cred - The transit rider does not have to prove income eligibility with the transit agency. The app simply uses their participation in the CalFresh program to confirm eligibility for a transit benefit. -- The transit agency doesn't have to craft and policy for a low-icome discount; they simply use the approach implemented in the Cal-ITP Benefits application. As more agencies adopt the application, they also adopt a standard policy for transit benefits. +- The transit agency doesn't have to craft and policy for a low-icome discount; they simply use the approach implemented in the Cal-ITP Benefits application. As more agencies adopt the application, they also adopt a standard policy for transit benefits. - Secure state and federal solutions manage the transit rider’s personal identifiable information (PII): [Login.gov](Login.gov) and the California Department of Technology Identity Gateway (IdG). Transit riders do not have to share personal information with local transit operators. From 512512c4d9b5c07c4b7190f1d2a0fb1a9a9a936d Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Fri, 9 Feb 2024 16:03:22 -0800 Subject: [PATCH 16/17] Update low-income.md added sequence diagram to basic flow section Mermaid! --- docs/enrollment-pathways/low-income.md | 36 +++++++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/low-income.md b/docs/enrollment-pathways/low-income.md index b8cf39640..e514e4ded 100644 --- a/docs/enrollment-pathways/low-income.md +++ b/docs/enrollment-pathways/low-income.md @@ -11,7 +11,41 @@ This use case describes a feature in the Cal-ITP Benefits app that allows Califo **Precondition:** The California transit operator offers fixed route service, has installed and tested validator hardware necessary to collect fares using contactless payment on bus or rail lines, and the operator has a policy in place to offer a transit discount to low-income riders. ## Basic Flow - +```mermaid +sequenceDiagram +autonumber +%% Low-income Rider Enrollment Pathway + actor Transit Rider + participant Benefits as Benefits app + participant IdG as Identity Gateway + participant Login.gov + participant CDSS + participant Littlepay +Transit Rider->>Benefits: visits benefits.calitp.org + activate Benefits +Benefits-->>IdG: eligibility verification + activate IdG +Transit Rider->>Login.gov: account authentication + activate Login.gov +IdG-->>Login.gov: requests required PII + activate Login.gov + Note right of Login.gov: first name
last name
Social Security number
date of birth +Login.gov-->>IdG: returns required PII + deactivate Login.gov +IdG-->>CDSS: check Calfresh enrollment status + activate CDSS +CDSS-->>IdG: return Calfresh enrollment status + deactivate CDSS +IdG-->>Benefits: eligibility response + deactivate IdG + deactivate Login.gov +Benefits-->>Littlepay: payment enrollment start + activate Littlepay +Transit Rider->>Littlepay: provides debit or credit card details +Littlepay-->>Benefits: payment method enrollment confirmation + deactivate Littlepay + deactivate Benefits +``` 1. The transit rider visits the web application at `benefits.calitp.org` in a browser on their desktop computer. 2. The transit rider chooses the transit operator that serves their area. From 20ab413d6736d73ee7e8697e547a91566c076944 Mon Sep 17 00:00:00 2001 From: Andy Walker Date: Mon, 12 Feb 2024 17:28:27 -0800 Subject: [PATCH 17/17] Update low-income.md updated IdG hyperlink - increased linked text - replaced CDT generic URL with a much more meaningful one --- docs/enrollment-pathways/low-income.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enrollment-pathways/low-income.md b/docs/enrollment-pathways/low-income.md index e514e4ded..90dbd3bc6 100644 --- a/docs/enrollment-pathways/low-income.md +++ b/docs/enrollment-pathways/low-income.md @@ -54,7 +54,7 @@ Littlepay-->>Benefits: payment method enrollment confirmation 4. The transit rider authenticates with their existing [Login.gov](Login.gov) account or, if they don’t have one, creates a [Login.gov](Login.gov) account. -5. The Cal-ITP Benefits app interfaces with the [California Department of Transportation](https://dot.ca.gov/) Identity Gateway (IdG) to verify benefit eligibility. The IdG uses personal information shared by [Login.gov](Login.gov) to verify CalFresh participation status. +5. The Cal-ITP Benefits app interfaces with the [California Department of Technology Identity Gateway](https://digitalidstrategy.cdt.ca.gov/primary-elements.html) (IdG) to verify benefit eligibility. The IdG uses personal information shared by [Login.gov](Login.gov) to verify CalFresh participation status. 6. The IdG uses the response provided by the California Department of Social Services (CDSS) to determine the rider’s eligibility for a transit benefit.