Raymond/Appeals-24777

[raymond-hughes]

Resolves APPEALS-24777

Description

Remediation steps to resolve POA Access when spouse is not in people table.

Problem: Attorney user has no access to POA or appeal when spouse is not in people table. This causes no POA to pull and disallows user access to appeal.

This PR addresses this issue by allowing Tier 3 to run remediation script by passing in verified claimant_participant_id and vacols_id which allows the script to create the needed person and poa records. This will allow the affected user to gain access to both the appeal and poa records.

Acceptance Criteria

• Code compiles correctly
• Tests are passing related to the changes

Best practices

Code Documentation Updates

• Add or update code comments at the top of the class, module, and/or component.

Tests

Test Coverage

Did you include any test coverage for your code? Check below:

• RSpec
• Jest
• Other

Code Climate

Your code does not add any new code climate offenses? If so why?

• No new code climate issues added

Monitoring, Logging, Auditing, Error, and Exception Handling Checklist

Logging

• Are logs being produced at appropriate log levels (debug, info, warn, error, fatal)?
• Are logs structured (e.g., using log tags) for easier querying and analysis?
• Are sensitive data (e.g., passwords, tokens) redacted or omitted from logs?
• Is log retention and rotation configured correctly?
• Are logs being forwarded to a centralized logging system if needed?

Error Handling

• Are errors being caught and handled gracefully?
• Are appropriate error messages being displayed to users?
• Are critical errors being reported to an error tracking system (e.g., Sentry, ELK)?
• Are unhandled exceptions being caught at the application level ?

Exception Handling

• Are custom exceptions defined and used where appropriate?
• Is exception handling consistent throughout the codebase?
• Are exceptions logged with relevant context and stack trace information?
• Are exceptions being grouped and categorized for easier analysis and resolution?

[codeclimate]

Code Climate has analyzed commit 102d6ff and detected 1 issue on this pull request.

Here's the issue category breakdown:

Category	Count
Style	1

View more on Code Climate.

[raymond-hughes]

👍 Much simpler than before 😄

You had a couple of silly CodeClimate issues failing the build, so I took the liberty of fixing them (it was just as easy to fix as it is to point them out 🤷). Hope you don't mind!

Were you going to wrap this in a Rake task as well?

Not sure if a test plan is required on this (I didn't see a subtask for that on the story). If it is, it would be good to add that under the Test Plan section here in the PR, and then I guess we'd also need to have a Jira Xray test (to comply with our contract), which could just be a copy/paste into the Jira Xray issue for that.

We can disregard test plan for now since this will be a manual remediation and doesn't require one. Same with the rake task. When we automate this we can add the rake task.

[raymond-hughes]

@jcroteau can you check the changes on how we return the new poa