moh-kenya / echis-2.0-integration

This Repo will be used for the Integration of echis,afya ke,client registry,KHIS integration and also any other future systems
2 stars 8 forks source link

update client and referrals route for tiberbu #136

Open freddieptf opened 4 months ago

freddieptf commented 4 months ago

The scope of this service has been reduced to client look-ups in the CR and referral service requests. The SHR bits remain mostly unchanged with the only change being the API URLs.

Changes:

The previous UPI will be maintained on contacts that already have it. A new field client_registry will be added to contacts and will contain the CR client ID from tiberbu.

The format will be

"client_registry": {
  "id": "CR1234335",
  "status": "OK",
}

or

"client_registry": {
 "error": "no matches" | "multiple matches"
}

In the case of an error it will be shown on the contact's profile Screenshot 2024-07-18 at 13-58-53 CHIS Kenya

Migration of existing SHR records and Contacts with UPIs Still in discussion, MoH team intend to migrate existing SHR records to the new FHIR server and maybe reuse the existing UPIs as IDs in the new CR. @karimkkanji can provide more on the plan here when it's ready

karimkkanji commented 3 months ago

@freddieptf Thanks for the detailed outline of the intention.

I am also including the following workflow diagram which is subject to changes and feedback.

New eCHIS integration and Migration Path - New Integration Flow

I also suggest that we run this service once a week and as the number of clients who need a new UPI decreases, we can increase this period to be biweekly and possibly weekly.

We may also not need to show the Client Registry Details as it will be on a best-effort basis as it does not affect any service being offered and we will continually proceed to even build a dashboard to identify Clients who have UPIs and Those Who don't have the new UPI. We can also diversify to add reasons for failure as you have described above so that we can determine what steps to take moving forward.