[API-42091] Retrieve POA Requests - Schema Update

[tycol7]

Summary

• Map BGS procID to database Lighthouse ID.
  • Extract index logic from controller to service.
• Format response with Blueprinter.
• Update docs (v2 staging only).

Related issue(s)

API-42091

Testing done

• New code is covered by unit tests
• Observed correct response:

{
    "data": [
        {
            "id": "4ced145b-c706-4df3-944e-829e31077185",
            "type": "power-of-attorney-request",
            "attributes": {
                "veteran": {
                    "firstName": "[Vet First Name]",
                    "lastName": "[Vet Last Name]",
                    "middleName": null
                },
                "claimant": {
                    "city": "Richmond",
                    "country": "USA",
                    "militaryPo": null,
                    "militaryPostalCode": null,
                    "state": null,
                    "zip": "00123"
                },
                "representative": {
                    "poaCode": "003",
                    "vsoUserEmail": null,
                    "vsoUserFirstName": "VDC USER",
                    "vsoUserLastName": null
                },
                "receivedDate": "2013-01-17T10:54:11-06:00",
                "actionedDate": "2013-01-17T10:54:11-06:00",
                "status": "New",
                "declinedReason": null,
                "changeAddressAuthorization": "Y",
                "healthInfoAuthorization": "Y"
            }
        },
        {
            "id": "7abf74a7-0952-4caa-98c5-f3aa8b34c8cd",
            "type": "power-of-attorney-request",
            "attributes": {
                "veteran": {
                    "firstName": "[Vet First Name]",
                    "lastName": "[Vet Last Name]",
                    "middleName": null
                },
                "claimant": {
                    "city": "Richmond",
                    "country": "USA",
                    "militaryPo": null,
                    "militaryPostalCode": null,
                    "state": null,
                    "zip": "00123"
                },
                "representative": {
                    "poaCode": "003",
                    "vsoUserEmail": null,
                    "vsoUserFirstName": "VDC USER",
                    "vsoUserLastName": null
                },
                "receivedDate": "2013-01-17T11:04:22-06:00",
                "actionedDate": "2013-01-17T11:04:22-06:00",
                "status": "New",
                "declinedReason": null,
                "changeAddressAuthorization": "Y",
                "healthInfoAuthorization": "Y"
            }
        },
        …

Note: id will be null unless you create a corresponding PowerOfAttorneyRequest record in your local database (must include procID from the BGS response).

Screenshots

What areas of the site does it impact?

PowerOfAttorneyRequests index (search)
v2 staging docs

Acceptance criteria

• I updated unit tests and integration tests for each feature (if applicable).
• No error nor warning in the console.
• Events are being sent to the appropriate logging solution
• Documentation has been updated (link to documentation)
• No sensitive information (i.e. PII/credentials/internal URLs/etc.) is captured in logging, hardcoded, or specs
• Feature/bug has a monitor built into Datadog (if applicable)
• If app impacted requires authentication, did you login to a local build and verify all authenticated routes work as expected
• I added a screenshot of the developed feature

Requested Feedback

See below.

[tycol7]

Adding index in #19945 to optimize this query.

[tycol7]

Copied from #19932.

[tycol7]

cf. BGS response:

vets-api/modules/claims_api/app/swagger/claims_api/v2/dev/swagger.json

Lines 416 to 439 in d870a13

	"example": [
	{
	"VSOUserEmail": null,
	"VSOUserFirstName": "Joe",
	"VSOUserLastName": "BestRep",
	"changeAddressAuth": "Y",
	"claimantCity": "Charlottesville",
	"claimantCountry": "USA",
	"claimantMilitaryPO": null,
	"claimantMilitaryPostalCode": null,
	"claimantState": null,
	"claimantZip": "00123",
	"dateRequestActioned": "2024-05-25T13:45:00-05:00",
	"dateRequestReceived": "2012-11-23T16:49:16-06:00",
	"declinedReason": null,
	"healthInfoAuth": "Y",
	"poaCode": "083",
	"procID": "11027",
	"secondaryStatus": "New",
	"vetFirstName": "[Vet First Name]",
	"vetLastName": "[Vet Last Name]",
	"vetMiddleName": null,
	"vetPtcpntID": "111"
	},

[rockwellwindsor-va]

@tycol7 Looks like some unrelated tests are failing, but everything related to this work looked good to me!