Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack

Projects

Page tree
Skip to end of metadata
Go to start of metadata

Primary mentor

Backup mentor

Assigned to

Rohan Sharma

Abstract

Nigeria Telemedicine App is a lightweight, easy to use telemedicine mobile app developed to make health services more accessible to the Nigerian population. Users can register themselves on the OpenMRS server providing basic details like their name, phone number. All this can be done within a minute as there is no wasting time in login and verification etc. After successful registration, the user will receive a call from a doctor as early as possible.

The project involved me developing an Android application as well as a reverse proxy for the app. Both of these tasks were successfully completed.

Objectives

1. To develop an android app from scratch that allows the user to register himself/herself on the OpenMRS server.

  • Devising suitable architecture for the app that makes it easy to maintain the app in the long run and is also easier for other contributors to understand and contribute. (COMPLETED)
  • Using the latest jetpack components with Kotlin. The app uses ViewModel, LiveData, View and Data binding. (COMPLETED)
  • Implementing the dashboard, register patient and help functionalities into the app. (COMPLETED)
  • Creating a new user role on the OpenMRS that had the minimum possible privileges required to register a patient on the server. All patient registrations via the app are made by this user. (COMPLETED)
  • Adding Firebase Crash analytics for monitoring app crashes. (COMPLETED)
  • Adding suitable Unit tests to the app. (PENDING)

2. Implementing a proxy server that serves as a mediator between our app and the OpenMRS server to improve the security of our servers.

  • Learning about python, Flask, Gunicorn, and Docker. (COMPLETED)
  • Developed the Flask app and served it using Gunicorn. (COMPLETED)
  • Created the docker image for the app. (COMPLETED)
  • Adding the docker container to the main infrastructure’s docker-compose. (COMPLETED)
  • Deploying the app on AWS (COMPLETED).

Sample Use Cases

A user enters his/her name, gender, DOB, and phone number in a simple form. If the information is correct, the user taps the "Request Consult" button and the information entered is sent to the OpenMRS API. In the background, the app checks if the information was successfully received by the API. If the information was not successfully received (due to network errors, etc.) the app displays an appropriate and helpful error message. If the information was successfully received, the app displays a success message. The app also includes a help section which explains how to use the app and how the telemedicine process works.

Steps

  1. Build a "Frontend-only" version of the application
    1. Data-entry page
    2. Verification page
    3. Successful transaction page
    4. Unsuccessful transaction page
  2. Integrate the application with the OpenMRS API backend
  3. Set-Up a reverse proxy for the app.
  4. Publish app on an appropriate platform

Required Skills

  • Android development experience using Kotlin.
  • Experience interacting with APIs programmatically (REST)

Useful Resources

Android Development Tips

(thanks to suggestions from Unknown User (f4ww4z))

  • Use the new Android Jetpack architecture
  • Write in Kotlin
  • Don't reinvent the wheel (use 3rd party libraries when possible)
  • No labels