Abstract

The goal of the Android client is to provide an alternative to access a hospital's OpenMRS instance by just using the provider's Android devices. See the full Android client guide for more info.

Considering the services offered by a hospital, an Android application can help doctors, patients, and other staff a lot with its mobility and ease of use, without them having to start the OpenMRS web app on a desktop computer. This will improve the productivity and efficiency of the hospital workflow.

This year, we will focus on two aspects to improve the Android client - performance and UI/UX.

There are still frequent crashes when using the app, especially if a doctor is using it for a long time with no pause. On crashes, the app will just return the user to the dashboard page, and any unsaved transactions will be lost. Also, the offline-first solution needs to be developed, where a provider cannot connect to the internet and needs to work offline temporarily. Data should be synced again when back online.

Next, the current user interface is slow to respond to user inputs and does not look pleasing to the eye, compared to the newer and modern Android apps in the google play store. E.g. 'Undo' buttons (that takes the user back to the previous state if he/she errors) should be available for any operation. So we should enhance the feel of the app so that the user knows that he/she is in control every time.

Finally, seeing the number of components in the web app, the Android app should integrate more of them so that doctors and staff can expect to see the same functionalities in the web app implemented in the client.

An additional request is to migrate the Java source code to Android's now recommended Kotlin, to increase readability and reduce a thousand lines of code present in the GitHub repository.

Objectives

1. Material UI design (Figma Link)
2. Integrate more components of the web app to the client (to be discussed further)
3. Password reset via email
4. Replace Java code with Kotlin
5. Replace native SQL to Room

Future Works that need to be done

1. Migrate the remaining 80% codebase to kotlin.
2. Start converting MVP pattern to MVVM as it follows the new standard guideline brought by Google.
3. Re-design Home screen with a better UI.
4. Add the password-reset feature.
5. Create a diagnosis using REST.
6. Implement the Appointment Scheduling Module.
7. Mark Patient deceased using a non-coded response.

Sample Use Cases

1. A doctor does not have access to a PC, but his Android phone is available to use during office hours.
2. No internet connectivity and a doctor needs to work offline temporarily.

Project Champions

Same people who use the web app: Providers (e.g. doctors, nurses, clinicians)

Skills Needed

Android, Java, Room, Kotlin

Progress

Issues that are completed and their status:

Timeline

Week 1

Blog post

Tasks completed:

• AC-689 - Getting issue details... STATUS
• AC-665 - Getting issue details... STATUS
• AC-763 - Getting issue details... STATUS
• AC-764 - Getting issue details... STATUS
• AC-767 - Getting issue details... STATUS
• AC-770 - Getting issue details... STATUS
• AC-450 - Getting issue details... STATUS

Week 2

Blog post

Tasks completed:

• AC-778 - Getting issue details... STATUS
• AC-779 - Getting issue details... STATUS
• AC-783 - Getting issue details... STATUS
• AC-777 - Getting issue details... STATUS
• AC-780 - Getting issue details... STATUS
• AC-782 - Getting issue details... STATUS

Week 3

Blog post

Tasks completed:

• AC-780 - Getting issue details... STATUS
• AC-776 - Getting issue details... STATUS
• AC-785 - Getting issue details... STATUS
• AC-787 - Getting issue details... STATUS

Week 4

Blog post

Tasks completed:

• RA-1790 - Getting issue details... STATUS
• RESTWS-777 - Getting issue details... STATUS

Week 5

Blog post

Tasks completed:

• AC-799 - Getting issue details... STATUS
• AC-791 - Getting issue details... STATUS
• AC-766 - Getting issue details... STATUS
• AC-794 - Getting issue details... STATUS

Week 6

Blog post

Tasks completed:

• AC-804 - Getting issue details... STATUS

Week 7

Blog post

Tasks completed:

• AC-817 - Getting issue details... STATUS

Week 8

Blog post

Completed database migration (from ActiveAndroid to Room) at AC-470 - Getting issue details... STATUS

Week 9

Blog post

Tasks completed:

• AC-814 - Getting issue details... STATUS
• AC-596 - Getting issue details... STATUS
• AC-805 - Getting issue details... STATUS
• AC-815 - Getting issue details... STATUS
• AC-824 - Getting issue details... STATUS
• AC-823 - Getting issue details... STATUS

Week 10

Blog post

Tasks completed:

• AC-810 - Getting issue details... STATUS
• AC-808 - Getting issue details... STATUS
• AC-664 - Getting issue details... STATUS
• AC-809 - Getting issue details... STATUS

Week 11

Blog post

Tasks completed:

• AC-811 - Getting issue details... STATUS
• AC-833 - Getting issue details... STATUS
• AC-835 - Getting issue details... STATUS

Week 12

Blog post

Tasks completed:

• AC-836 - Getting issue details... STATUS
• AC-829 - Getting issue details... STATUS
• AC-840 - Getting issue details... STATUS
• AC-841 - Getting issue details... STATUS

Dev Tracks

• Project Issue Tracker (JIRA) - https://issues.openmrs.org/projects/AC/issues
• GitHub repo - https://github.com/openmrs/openmrs-contrib-android-client

Resources

• OpenMRS Android Client Project 2.8+ - Previous year's GSoC page for this project
• https://github.com/openmrs/openmrs-contrib-android-client - main repo
• https://openmrs.github.io/openmrs-android-client-user-guide/introduction.html - User guide
• https://talk.openmrs.org/t/gsoc-2018-openmrs-android-client-3-x-project/18035?source_topic_id=19471