Expunge Assist User Guide: Letter Generator Flow - hackforla/expunge-assist GitHub Wiki
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
- Backward navigation with the
Backbutton 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
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
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
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
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
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