3. Implement the Patient Resource Provider

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
...
components:
...
- https://coderepo.mobilehealth.va.gov/scm/dhsss/wiremock.git//kubernetes?ref=v3.13.2&timeout=120s
- ../components/dev

{
  "request": {
    "method": "GET",
    "urlPath": "/mvi/v1/version"
  },
  "response": {
    "status": 200,
    "body": "1.53.0"
  }
}

{
  "request": {
    "method": "GET",
    "urlPath": "/mvi/v1/patients/ICN/10115V737384/mvi/person"
  },
  "response": {
    "status": 200,
    "headers": {
      "content-type": "application/json"
    },
    "jsonBody": {
      "lastName": "FIFTEEN",
      "firstName": "PATIENT",
      "birthTime": "19530401",
      "gender": "M",
      "telecom": "(123)234-5678",
      "address": {
        "street": "1111 Any Street",
        "city": "Any Town",
        "state": "WV",
        "zipCode": "99998-3414",
        "country": "USA"
      },
      "identifiers": [
        {
          "idType": "NI",
          "idStatus": "PERMANENT",
          "uniqueId": "10115V737384",
          "assigningAuthority": "ICN",
          "assigningCode": "200M"
        },
        {
          "idType": "PI",
          "idStatus": "ACTIVE",
          "uniqueId": "69",
          "assigningAuthority": "dfn-500",
          "assigningCode": "500"
        }
      ]
    }
  }
}

{
  "request": {
    "method": "GET",
    "urlPath": "/mvi/v1/patients/ICN/1012845331V153043/mvi/person"
  },
  "response": {
    "status": 204
  }
}

...
configMapGenerator:
- name: fhir-starter-service-app-config
  behavior: merge
  envs:
  - overrides.env
- name: mvi-wiremock-mappings
  behavior: create
  files:
  - wiremock-data/mvi/version.json
  - wiremock-data/mvi/person-10115V737384.json
  - wiremock-data/mvi/person-10132V467385.json
  - wiremock-data/mvi/person-1012845331V153043.json
...
patches:
- path: deployment.yaml
- path: service.yaml
- path: wiremock-data/data-wiremock.yaml
...

apiVersion: apps/v1
kind: Deployment
metadata:
  name: wiremock
spec:
  template:
    spec:
      volumes:
      - name: mvi-wiremock-mappings
        configMap:
          name: mvi-wiremock-mappings
      containers:
      - name: wiremock
        volumeMounts:
        - name: mvi-wiremock-mappings
          mountPath: /home/wiremock/mappings/mappings/mvi

<properties>
...
    <!-- Client Library Dependencies -->
    <mobile-mvi-client.version>1.53</mobile-mvi-client.version>
...
</properties>

<dependencies>
...
    <!-- Mobile MVI Service client models (Person, PatientIdentifier) -->
    <dependency>
        <groupId>gov.va.mobile.client.openapi</groupId>
        <artifactId>mobile-mvi-client</artifactId>
        <version>${mobile-mvi-client.version}</version>
    </dependency>
...
</dependencies>

# The service is only ready when the Mobile MVI Service is reachable (health indicator "mvi")
management.endpoint.health.group.readiness.include=readinessState,mvi
...
# Mobile MVI Service: patient demographics and identifiers, used through RestClientManager.getClient("mvi")
va.mobile.restclient.registration.mvi.url=http://mobile-mvi-service-v1:8080/mvi/v1

# Local deployments use the WireMock stubs of the Mobile MVI Service (kubernetes/components/dev/wiremock-data/mvi)
va.mobile.restclient.registration.mvi.url=http://wiremock:8080/mvi/v1

package gov.va.mobile.fhirstarter.v1.client;

import gov.va.mobile.boot.restclient.RestClientManager;
import gov.va.mobile.mvi.v1.model.Person;
import gov.va.mobile.security.HeaderNames;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
import org.springframework.web.client.HttpClientErrorException;
import org.springframework.web.client.RestClient;

import java.util.Optional;

/**
 * Client for the Mobile MVI Service, which looks up patients in the VA Master Veteran Index (MVI).
 *
 * <p>The REST client is configured by the {@code va.mobile.restclient.registration.mvi.*} properties. Local
 * deployments call the WireMock stubs in {@code kubernetes/components/dev/wiremock-data/mvi} instead of the real
 * service.
 *
 * @since 1.0
 */
@Slf4j
@Component
public class MviClient {

    /**
     * Registration ID of the Mobile MVI Service REST client ({@code va.mobile.restclient.registration.mvi.*}).
     */
    public static final String REGISTRATION_ID = "mvi";

    /**
     * REST client for the Mobile MVI Service, created by the Mobile Framework from the registration properties.
     */
    private final RestClient restClient;

    /**
     * Creates the client.
     *
     * @param restClientManager provides the REST clients of the registrations in the service properties
     */
    public MviClient(final RestClientManager restClientManager) {
        this.restClient = restClientManager.getClient(REGISTRATION_ID);
    }

    /**
     * Returns the demographics of the patient with the given ICN.
     *
     * <p>The caller's JWT is passed on, because the Mobile MVI Service authorizes every request.
     *
     * @param icn the ICN of the patient
     * @param jwt the JWT of the caller
     * @return the demographics of the patient, or empty if MVI has no record of the patient
     */
    public Optional<Person> getPerson(final String icn, final String jwt) {
        try {
            // The Mobile MVI Service answers 204 No Content when MVI has no record, which results in a null body
            return Optional.ofNullable(restClient.get()
                                                 .uri("/patients/ICN/{icn}/mvi/person", icn)
                                                 .header(HeaderNames.VAMF_JWT_HEADER, jwt)
                                                 .retrieve()
                                                 .body(Person.class));
        } catch (final HttpClientErrorException.NotFound e) {
            log.debug("The Mobile MVI Service has no record of the requested patient");
            return Optional.empty();
        }
    }
}

package gov.va.mobile.fhirstarter.v1.mapper;

import gov.va.mobile.mvi.v1.model.Person;
import gov.va.mobile.security.FhirSystems;
import org.hl7.fhir.r4.model.Address;
import org.hl7.fhir.r4.model.ContactPoint;
import org.hl7.fhir.r4.model.DateType;
import org.hl7.fhir.r4.model.Enumerations.AdministrativeGender;
import org.hl7.fhir.r4.model.HumanName;
import org.hl7.fhir.r4.model.Identifier;
import org.hl7.fhir.r4.model.Patient;
import org.springframework.stereotype.Component;

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.util.Optional;

/**
 * Maps patient data from the Mobile MVI Service to FHIR resources.
 *
 * @since 1.0
 */
@Component
public class PatientMapper {

    /**
     * MVI gender code of a male patient.
     */
    private static final String MALE = "M";

    /**
     * MVI gender code of a female patient.
     */
    private static final String FEMALE = "F";

    /**
     * Maps the MVI demographics of a patient to a FHIR Patient.
     *
     * <p>The logical id of the Patient is the ICN, so clients can read it with {@code GET [base]/Patient/<icn>}.
     *
     * @param icn the ICN of the patient
     * @param person the demographics of the patient from the Mobile MVI Service
     * @return the Patient resource
     */
    public Patient toPatient(final String icn, final Person person) {
        final Patient patient = new Patient();
        patient.setId(icn);
        patient.addIdentifier()
               .setUse(Identifier.IdentifierUse.OFFICIAL)
               .setSystem(FhirSystems.ICN_SYSTEM)
               .setValue(icn);
        patient.addName(toName(person));
        patient.setGender(toGender(person.getGender()));
        patient.setBirthDateElement(toBirthDate(person.getBirthTime()));
        if (isPresent(person.getTelecom())) {
            patient.addTelecom()
                   .setSystem(ContactPoint.ContactPointSystem.PHONE)
                   .setValue(person.getTelecom());
        }
        Optional.ofNullable(person.getAddress())
                .map(PatientMapper::toAddress)
                .ifPresent(patient::addAddress);
        // MVI also returns the SSN of the patient. Never copy it to the Patient resource.
        return patient;
    }

    /**
     * Maps an MVI gender code to a FHIR administrative gender.
     *
     * @param gender the MVI gender code, {@code M} or {@code F}
     * @return the FHIR gender, {@code UNKNOWN} for any other code, or {@code null} if the code is missing
     */
    static AdministrativeGender toGender(final String gender) {
        if (!isPresent(gender)) {
            return null;
        }
        return switch (gender) {
            case MALE -> AdministrativeGender.MALE;
            case FEMALE -> AdministrativeGender.FEMALE;
            default -> AdministrativeGender.UNKNOWN;
        };
    }

    /**
     * Maps an MVI birth time to a FHIR date.
     *
     * @param birthTime the MVI birth time in the format {@code yyyyMMdd}
     * @return the birth date, or {@code null} if the birth time is missing or invalid
     */
    static DateType toBirthDate(final String birthTime) {
        if (!isPresent(birthTime)) {
            return null;
        }
        try {
            return new DateType(LocalDate.parse(birthTime, DateTimeFormatter.BASIC_ISO_DATE).toString());
        } catch (final DateTimeParseException e) {
            return null;
        }
    }

    /**
     * Maps the MVI name of a patient to the official FHIR name.
     *
     * @param person the demographics of the patient
     * @return the official name
     */
    private static HumanName toName(final Person person) {
        final HumanName name = new HumanName()
                .setUse(HumanName.NameUse.OFFICIAL)
                .setFamily(person.getLastName());
        if (isPresent(person.getFirstName())) {
            name.addGiven(person.getFirstName());
        }
        if (isPresent(person.getMiddleName())) {
            name.addGiven(person.getMiddleName());
        }
        return name;
    }

    /**
     * Maps an MVI address to a FHIR address.
     *
     * @param mviAddress the address from the Mobile MVI Service
     * @return the FHIR address
     */
    private static Address toAddress(final gov.va.mobile.mvi.v1.model.Address mviAddress) {
        final Address address = new Address()
                .setCity(mviAddress.getCity())
                .setState(mviAddress.getState())
                .setPostalCode(mviAddress.getZipCode())
                .setCountry(mviAddress.getCountry());
        if (isPresent(mviAddress.getStreet())) {
            address.addLine(mviAddress.getStreet());
        }
        return address;
    }

    /**
     * Checks whether a value from MVI is present.
     *
     * @param value the value
     * @return {@code true} if the value isn't {@code null} or blank
     */
    private static boolean isPresent(final String value) {
        return value != null && !value.isBlank();
    }
}

curl -s -H "x-vamf-jwt: $STAFF_JWT" 'http://localhost:8080/fhirstarter/v1/fhir/Patient/10115V737384' | jq

curl -s -H "x-vamf-jwt: $STAFF_JWT" 'http://localhost:8080/fhirstarter/v1/fhir/Patient?identifier=urn:oid:2.16.840.1.113883.4.349%7C10132V467385' | jq

git add .
git commit -m "Implement the Patient read and search with the Mobile MVI Service"