hackforla / hackforla/tdm-calculator

DEV: Snapshot Submission Email Template to DRO

Open
#2,864 1 comment 0 reactions 0 assignees View on GitHub
deck: staging level: medium p-feature: Submissions and process Participant type: User priority: MUST HAVE role: back-end size: 2pt
Dominant language
JavaScript
Stars
68
Forks
47
Avg merge
3d 9h
Merged PRs (30d)
25

Description

### Dependency
- https://github.com/hackforla/tdm-calculator/issues/2437

### Overview
This email is sent to the DRO when a user submits a snapshot. The goal is to notify the DRO staff member and give them a direct entry point into the app using the project ID to review the submission.

### Details
- only admins can access the Manage submission page
- Email subject : New Snapshot Submission for DRO: {DRO NAME}
- Include the Project ID in the email body.
- The link of the Manage Submissions button encodes the project ID in the URL and goes to the Manage Submissions page with the results pre-filtered to the Project ID

User Experience

Step 1: click on link in Email

- The DRO staff will get an email that says there is a new Sumbission to review.
Image

Step 2: sent to Manage Submissions page - Filtered to project ID

- The link of the Manage Submissions button encodes the project ID in the URL and goes to the Manage Submissions page with the results pre-filtered to the Project ID
Image

### Action Items
- [ ] Assign yourself to the development issue.
- [ ] Move the development issue from the Prioritized Backlog to In Progress.
- [ ] Implement the email as requested. This should be initiated when the web api endpoint for submission is called.
- [ ] Create a PR, if applicable.
- [ ] Create a new slide (or edit one if it already exists) in staging and add the before and after images
- [ ] Once the PR has been approved, use it to close this issue. If there is no PR is associated with this issue, close this issue after lead signoff.

### Resources/Instructions
- Design details:
- Content Issue includes text: https://github.com/hackforla/tdm-calculator/issues/2424#issuecomment-3752388099
- Doc with draft text: [Manage Submission notification messaging #2424](https://docs.google.com/document/d/1FlQHjQTCx6vIWTI2or3FQ4ssT9240bIwZ0-QB78wS3A)
- Design Issue comment that shows whole user workflow: https://github.com/hackforla/tdm-calculator/issues/2437#issuecomment-4261930684
- Design mockups: [Figma](https://www.figma.com/design/nD9QK56Mzq7xNSaSUoeGx0/TDM-Calculator?node-id=18525-77&p=f&t=7H7kUVviON3QGm5x-0)

#### Staging and Release decks
- [Staging Deck](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/)
- [[Staging Deck, slide 2864](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3c3611c139e_0_14#slide=id.g3c3611c139e_0_14)]
- Release Deck
- [2025-MM-DD Release deck, slide ISSUE NUMBER]

Contributor guide

Open the contributing guide

Research direction

Start at the web API endpoint for submission and trace the existing Manage Submissions page and its project-ID filtering behavior. Read the draft text in issue #2424, the workflow details in #2437, and the Figma mockup; done means the submission triggers the requested email with the project ID and a working filtered Manage Submissions link.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
api, backend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.