Expunge Assist User Guide: Letter Generator Flow - hackforla/expunge-assist GitHub Wiki

Letter Generator

About the letter generator

The letter generator is the actual function of Expunge Assist. The letter generator asks users information that can be compiled into a declaration letter that can be submitted to a judge as part of the record clearance process.

Users progress through the letter generator sections in this order:

  • Initial static informational pages
  • Introductory input dynamic pages to capture basic personal information and involvements since conviction
  • Conditional involvement input dynamic pages capturing information based on involvement selections
  • Final input dynamic pages to capture future goals and reasons for seeking expungement
  • Final review and download of the generated personalized letter

The users progress through the pages by entering the required information (if present) and pressing the Next button. The user can navigate backwards in the flow by pressing the Back button. Data entered in previous pages will be retained and viewable during backwards navigation in the same session. The flow always follows the same sequence, but users only visit the Involvement Sub-Pages they select in the Involvement Selection page.

On pages that collect text input from the user, the letter generator tool will take the input text and format it into a paragraph for the letter. After each of these pages, the user will be prompted to review and optionally edit the paragraph before continuing. The user has the ability to review and edit all generated paragraphs at the end of the flow.

Initial URL: /form/intro

Technical details

  • Backward navigation with the Back button on the page retains all entered data throughout the flow
  • Browser navigation (refresh, back, etc.) will cause data loss
  • Data is not retained once the browser session is closed

Letter Generator Sections

1. Initial Static Informational Pages

These pages appear for all users in this sequence to provide essential guidance before beginning the letter generation process.

Page Purpose
Welcome Tool overview and editing capabilities
Before you begin Eligibility confirmation, time expectations, navigation warnings
Advice Writing guidance for professional, effective declarations
Screenshots 1_welcome 2_before 3_advice

2. Introductory Input Pages

These pages collect basic user information and determine the included involvement options for each user. The involvement selection page requires the user to select at least one option before forward navigation becomes available.

Page Collects Paragraph Preview
Introduction Name, age, veteran status Yes
Involvement Selection Activities since conviction (checkboxes) No
Screenshots 4_intro 4_intro_preview 5_intro_modal 6_involvement

3. Involvement Details Pages

These pages conditionally appear only if the involvement category is selected in the Involvement Selection page. Each involvement category follows the same pattern: the user enters the specified information on an input page, then is presented with an editable preview page. Upon completion, they navigate to the next selected involvement category or to the "Final Information" pages if all involvement options have been completed.

Page Collects Paragraph Preview
Employment Job details, company, title, responsibilities Yes
Unemployment Employment challenges, job search efforts Yes
Self-improvement Activity name, importance/impact Yes
Education School/program, subject, motivation Yes
Parenting Number of children, parenting impact Yes
Community service Organization, role, volunteer impact Yes
Something else Other activities, importance Yes
Screenshots 7_job 8_job_preview 9_unemployment 10_unemployment_preview 11_self_improvement 12_self_improvement_preview 13_education 14_education_preview 15_parenting 16_parenting_preview 17_community_service 18_community_service_preview 19_something_else 20_something_else_preview 21_involvement_complete_modal

4. Final Information Pages

These pages capture the user's goals and motivation for seeking expungement. The pages follow the same flow: input to preview/edit flow.

Page Collects Paragraph Preview
Future Goals Life improvement goals, progress toward reaching goals Yes
Why (clear your record) Expungement motivation, negative record impact on goals Yes
Screenshots 22_future_goals 23_future_goals_preview 24_future_goals_complete_modal 25_why 25_why_preview 26_why_done_modal

5. Review and Download Pages

These final pages allow comprehensive review and completion of the letter generation process. The review page allows the user to edit all of the previously generated letter paragraphs. The Preview and Download allows the user to view the generated letter, and download it after checking a liability release.

Page Purpose
Finalize Review and edit all generated sections
Preview and Download Display final letter and provide download options
Screenshots 27_finalize 28_preview
⚠️ **GitHub.com Fallback** ⚠️