department-of-veterans-affairs / va.gov-team

Public resources for building on and in support of VA.gov. Visit complete Knowledge Hub:
https://depo-platform-documentation.scrollhelp.site/index.html
284 stars 206 forks source link

[Spike] Update the alert message on the Type of Care page #39610

Closed ldelacosta closed 1 year ago

ldelacosta commented 2 years ago

Background

We are looking to improve the alert message on the Type of Care page. Currently in the VAOS workflow, user selects a type of care when scheduling an appointment/request. If the veteran does not see the type of care, there is an alert message below the page. We would like to enhance this flow and provide better instructions.

By improving the page, this would help decrease the drop off rate on the Type of Care page and we can add a tracker on the radio button to gather analytics.

Screen Shot 2022-04-05 at 2 26 39 PM

Goal

To improve the Veteran's experience in the event that the type of care is not available in VAOS.

Requirements to Consider


Tasks

Time Box

_ hours

Definition of Done


vbahinwillit commented 2 years ago

Question What facility information can we get from the application that can be easily be displayed to the veteran?

Answer As far as I can tell, nothing on initial access to the application. Facility information is not retrieved until the user clicks the 'continue' button on the type of care page.

ldelacosta commented 2 years ago

@vbahinwillit - could we display the facility info that would be displayed on the next page or could we surface displaying the Veteran's PACT team (Primary care)?

We had a spike in the past that discussed how we might leverage the primary care.

Please me know your thoughts or we can get on a call to discuss further.

ldelacosta commented 2 years ago

Will resume the ticket once v2 bugs are fixed.

jenniemc commented 1 year ago
  1. Once the user logs in, it calls on the user endpoint that returns user vaProfile which contains user registered facilities ID. In this case, it is 983 and 984
    
    https://staging-api.va.gov/v0/user

get the data>attribute>vaProfile to see all registered facilities { "status": "OK", "birthDate": "19620101", "familyName": "Mhvpsim", "gender": "F", "givenNames": [ "Psim" ], "isCernerPatient": false, "facilities": [ { "facilityId": "984", "isCerner": false }, { "facilityId": "983", "isCerner": false } ], "vaPatient": true, "mhvAccountState": "MULTIPLE" }


2. Once the user navigates to the vaos app,  the appt endpoint returns future booked appts (previous month through  1yr from next month) and proposed appt (3 months prior through next month) which contains locationID aka the facilityID (ie  984) along with the facility name (Dayton VA Medical Center). **Getting a tally of future appointment facility name may be a solution of getting the most preferred facility.**  Below is an abbreviated example of one appointment being returned.

https://staging-api.va.gov/vaos/v2/appointments?_include=facilities,clinics&start=2022-10-30&end=2023-12-29&statuses[]=booked&statuses[]=arrived&statuses[]=fulfilled&statuses[]=cancelled

{ "id": "142100", "type": "appointments", "attributes": { "id": "142100", "identifier": [ { "system": "http://med.va.gov/fhir/urn/vaos/vista/984/appointment/id", "value": "3294;20221107.080000" } ], "kind": "clinic", "status": "booked", "serviceType": "optometry", "patientIcn": "1013124304V115761", "locationId": "984", "clinic": "3294", "start": "2022-11-07T13:00:00Z", "end": "2022-11-07T14:00:00Z", "minutesDuration": 60, "slot": { "id": "3230323231313037313330303A323032323131303731343030", "start": "2022-11-07T13:00:00Z", "end": "2022-11-07T14:00:00Z" }, "cancellable": true, "extension": { "ccLocation": { "address": {} }, "vistaStatus": [ "NO ACTION TAKEN" ] }, "serviceName": "DAY OPTOM/CONTACT LENS", "physicalLocation": "BLDG 330, 6 NORTH", "location": { "id": "984", "type": "appointments", "attributes": { "id": "984", "vistaSite": "984", "vastParent": "984", "type": "va_health_facility", "name": "Dayton VA Medical Center", "classification": "VA Medical Center (VAMC)", "timezone": { "timeZoneId": "America/New_York" }, "lat": 39.74935, "long": -84.2532, "website": "https://www.dayton.va.gov/locations/directions.asp", "phone": { "main": "937-268-6511" }, "physicalAddress": { "type": "physical", "line": [ "4100 West Third Street" ], "city": "Dayton", "state": "OH", "postalCode": "45428-9000" },


3. Click the START SCHEDULING button, and select the type of care (ie primary care) will return appointment endpoint call of past appointments up to previous 36 months
4. Click CONTINUE button on Type of Care page will make the configuration call of user's registered facilities thus returning the direct schedule status (enabled or disabled). AND it makes the call to facility endpoint that returns detailed information of user's registered facilities and its children facilities. Below is one of 12 facilities returned. 

https://staging-api.va.gov/vaos/v2/facilities?children=true&ids[]=984&ids[]=983

{ "id": "984", "type": "facilities", "attributes": { "id": "984", "vistaSite": "984", "vastParent": "984", "type": "va_health_facility", "name": "Dayton VA Medical Center", "classification": "VA Medical Center (VAMC)", "timezone": { "timeZoneId": "America/New_York" }, "lat": 39.74935, "long": -84.2532, "website": "https://www.dayton.va.gov/locations/directions.asp", "phone": { "main": "937-268-6511" }, "hoursOfOperation": null, "mailingAddress": null, "physicalAddress": { "type": "physical", "line": [ "4100 West Third Street" ], "city": "Dayton", "state": "OH", "postalCode": "45428-9000" }, "mobile": null, "healthService": [ "Audiology", "Cardiology", "DentalServices", "Dermatology", "Gastroenterology", "Gynecology", "MentalHealthCare", "Nutrition", "Ophthalmology", "Optometry", "Orthopedics", "Podiatry", "PrimaryCare", "SpecialtyCare", "Urology", "WomensHealth" ], "operatingStatus": null } }


5. If CC is eligible, user is given the option to choose VA clinic flow or CC facility flow
6. Select VA clinic flow to call the configuration endpoint to all register facilities and its child facilities. Below is an example of returned call showing primary care is enabled at facility 983.

https://staging-api.va.gov/vaos/v2/scheduling/configurations?facility_ids[]=983QE&facility_ids[]=983QA&facility_ids[]=983GD&facility_ids[]=983GC&facility_ids[]=983GB&facility_ids[]=983&facility_ids[]=984&facility_ids[]=984GF&facility_ids[]=984GC&facility_ids[]=984GB&facility_ids[]=984GD&facility_ids[]=984GA

{ "id": "primaryCare", "name": "Primary Care", "stopCodes": [ { "primary": "322", "defaultForRequests": false }, { "primary": "323", "defaultForRequests": false }, { "primary": "350", "defaultForRequests": false } ], "direct": { "patientHistoryRequired": false, "canCancel": true, "enabled": true }, "request": { "patientHistoryRequired": false, "patientHistoryDuration": 0, "submittedRequestLimit": 1, "enterpriseSubmittedRequestLimit": 1, "enabled": false } }


7. On Choose a VA location page, FE will display facilities that are direct schedule enabled. 
8. Select Cheyenne VAMC then click CONTINUE button to get eligibly and clinics endpoints. Below is the returned clinic call showing two clinics returned for primary care at Cheyenne VAMC. The display names are Green Team Clinic1 and CHY PC VAR2. **Getting the PACT names does not surface until the clinic endpoint which is several clicks after selecting type of care followed by facility location then checking for direct schedule and eligibility**.

https://staging-api.va.gov/vaos/v2/locations/983/clinics?clinical_service=primaryCare

[ { "id": "308", "type": "clinics", "attributes": { "vistaSite": 983, "id": "308", "serviceName": "Green Team Clinic1", "physicalLocation": null, "phoneNumber": null, "stationId": "983", "stationName": "CHYSHR-Cheyenne VA Medical Center", "primaryStopCode": 323, "primaryStopCodeName": "PRIMARY CARE/MEDICINE", "secondaryStopCode": null, "secondaryStopCodeName": "Missing", "patientDirectScheduling": null, "patientDisplay": null, "char4": null } }, { "id": "848", "type": "clinics", "attributes": { "vistaSite": 983, "id": "848", "serviceName": "CHY PC VAR2", "physicalLocation": null, "phoneNumber": null, "stationId": "983", "stationName": "CHYSHR-Cheyenne VA Medical Center", "primaryStopCode": 323, "primaryStopCodeName": "PRIMARY CARE/MEDICINE", "secondaryStopCode": null, "secondaryStopCodeName": "Missing", "patientDirectScheduling": null, "patientDisplay": null, "char4": null } } ]

ldelacosta commented 1 year ago

Added the technical spec in VAOS GitHub