Add ESFA payment response flow

[Nitemaeric]

Context

Once we've sent out the claims to ESFA to be paid, we want to update their status when ESFA sends a response CSV file.

We need to store a record of these to show a claims activity record of action "payment_response_uploaded".

Changes proposed in this pull request

• Add "Upload ESFA response" flow.
• Add Claims::PaymentResponse model to store the response CSV file onto a Claims::ClaimActivity record.
• Add a Claims::PaymentResponse::Process service to process the uploaded CSV file.
• Add Claims::Claim#unpaid_reason field.
• Show the unpaid reason in the payments claims show page.

Guidance to review

• I have tried the following approaches and both run into issues:

  1. Don't add/use a processed attribute and cleanup cron job on payment responses.

     The issue with this approach is the passing of the csv_file from the new page to the check page. We need to show how many rows are present in the CSV, therefore we need to store it.

     The read value of the #csv_file attachment is of type ActiveStorage::Attached::One, therefore we can't pass it through via memory. There is also the possibility of the first and second request hitting different pods.

  2. Use a form object.

     Using a form object without the processed attribute runs us into a very similar issue as above, the difference is that the csv_file field is serialized to a string via an implicit #to_s call. Once the csv_file field value is read on the create (prior to the implementation of check going to update), it is read as a string, not a file, and raises an error when attempted to be saved to Active Storage.

Note

Individual payment actions on their show pages will be added in an upcoming PR.

• Create some submitted claims.
• Send submitted claims to ESFA.
• Go to the activity log.
• Download the CSV of claims sent to ESFA.
• Update the status and optionally add a claim_unpaid_reason in the CSV.
• Upload that CSV.

Screenshots

Action button

Upload form

Check page

Success notification

Activity log

Claim details

[github-actions]

Review app track and pay deployed to https://track-and-pay-1276.test.teacherservices.cloud was deleted
Review app school placements deployed to https://manage-school-placements-1276.test.teacherservices.cloud was deleted