FIND COVID-19 RDT Grant Deliverables - Due October 3rd

[mrjones-plip]

Intro

FIND has awarded Medic a grant to "accelerate the development and deployment [...] of COVID rapid diagnostic test (RDT) [...] into existing digital tools".

This issue is a catch-all issue that links to sub issues so we can track deliverables for this grant. All of the Slack and Google Doc links will require Medic login.

Here's the current flow showing two CHT forms: a provision form on the left and a capture form on the on the right:

Overview

Medic will:

• Extend the CHT Core and CHT Android to have a generic integrate with 3rd party solutions, but specifically the RD-Toolkit to support a COVID19 configuration within the CHT
• Create a fully functional COVID19 configuration for the CHT which is a ready to use example on how to integrate with the RD-Toolkit based off the data model specified in the grant
• Provide documentation on how to implement this integration to an existing CHT deployment
• Announce and continue to engage with our constituents via blog and forum posts about this new features and configuration

Specific Grant deliverables:

See original work order, but here's the specific items grouped into logical work chunks:

• [x] Update cht-core and cht-android to support generic 3rd Party integrations
  • Parent ticket #6981
  • CHT-CORE PR
  • CHT-Android PR
  • CHT-Docs PR documenting generic integrations per above
• [x] COVID19 CHT App/Config - see cht-core branch & google docs with xlsx files
  • Design and build Data Capture Form: Design and build a form that captures a minimum set of data points and includes the necessary interoperability attributes.
  • Build a data model in the form of a common data exchange format for COVID-19, as specified by FIND, into a module or form within Medic existing application [CHT] for use by existing customers and new customers, specifically those in LMIC counties.
  • Ensure the data capture form is available and operational on the application platform for at least two years, or preferably longer.
• [x] Data Export & aggregation Documentation - See PR and markdown preview
  • Design and build Data export: Design and build data export via a REST API in CSV or JSON, or other suitable formats that will integrate with other commonly used platforms.
  • Provide a way to view aggregate data which will aid programmatic improvement in existing dashboards
  • Provide a method to export the data to other well-used data aggregation platforms in line with industry standards, e.g. API.
  • Create a reporting method within the existing reporting platform of the existing application, allowing the review of aggregate data which will aid programmatic improvement.
• [X] Blog post and forum post - announcing new integration features and encouraging long term engagement - Ticket and internal draft and external draft (both private gdocs link) - Forum post
  • Deliver a communications plan and publicize the launch of the application to existing and new users through user community and regular social channels
  • Governance: Provide guidance on how to build governance and communities of practice around those forms to ensure continued maintenance and thoughtful evolution.
• [x] Training material - See PR and markdown preview
  • Provide training for users of the application that requires less than two hours of in person time.
  • Provide training material in line with the proposal, with training being embedded in existing training material as well
• [x] Update 2 demo movies to final version - See #medic/cht-docs/issues/554
• [X] Final Report - See final copy
  • Provide final report and demonstration of the data capture form being used end to end including the export of data to another system.

Related Links

• All documents, including the grant signed statement of work, data model and more, are here.
• All CHT configuration documents for the COVID19 app are here.

[mrjones-plip]

Given that all of the code has entered code review or QA and is not likely to change, here is an update with screenshots and videos. Huge thanks to @latin-panda for the amazing amount of work put in on all this!

All screenshots and videos taken from a live CHT instance running actual code - there are no mockups or placeholders used. In an effort to not make this ticket too tall and confusing, I've put each set of substeps and movies behind a "click to expand" feature which I hope is helpful. For Medic staff, see originals.

Referencing the above flow chart, here's each step. Click step name to see sub-step screenshots:

1. CHT: Prescreen Questions & Prep Provision RDT

   On a patient, choose to provision a COVID19 RDT  First screen of data entry per FIND data model:  Second screen of data entry per FIND data model:  Launch RDT Prompt: 
2. RDT: Provision test & Start Timer

   RDT start screen for COVID19 test  RDT Start Timer: 
3. CHT: Confirm Provision Data Submit

   RDT test provisioned  Confirm provision details: 
4. CHT: Patient View

   RDT test provisioned, task created: 
5. CHT: Complete Capture

   This task will now be clicked after timer is complete: 
6. CHT: Start Capture by Launching App

   Launch app prompt: 
7. RDT: Capture results, image & fInalize

   RDT finds existing timer based on session ID passed from CHT:  RDT Test image taken:  Test results interpreted:  Results finalized: 
8. CHT: Confirm Capture Data & Submit

   Results captured:  Check for repeat:  Review final capture: 

Click form name to view movie:

• Provision

  https://user-images.githubusercontent.com/8253488/132567794-be22ae1e-d8d3-4205-a0cd-562084dc7e35.mp4
• Capture

  https://user-images.githubusercontent.com/8253488/132567952-5bbe19d2-5749-4610-b8ba-53b5233b92f6.mp4

[mrjones-plip]

I'm going to close this ticket being aware that:

• the blog post, while written, is not live as FIND wants to coordinate content
• Final Report is delivered, but some changes were requested
• FIND is asking for a few follow up changes which we'll track in a separate ticket (#medic/cht-core/issues/7379).