[C4GT] Connect2Bahmni Flutter App for ordering investigations & drugs

[angshu]

UPDATE: 11-July-2023 The JIRA issue for this and related issues can be seen here: https://bahmni.atlassian.net/browse/BAH-3101?jql=labels%20%3D%20Code4GovTech

Note: Bahmni team tracks all issues in public JIRA repository. But since Code4GovTech requires all project details to be created in Github, we are writing the project details here. But eventually as per Bahmni community process, the actual stories will tracked in JIRA, and issue number in commit messages will need to be of JIRA ticket number (and optionally Github issue number).

Purpose

Introduce feature for Lab investigations and medication orders using Flutter/dart.

Introducing Bahmni

1. Bahmni is an opensource hospital management system, used in low resource environments and is currently live in 600+ facilities across the world, including India, Nepal, Bangladesh, Uganda, Lesotho, Kenya, Cambodia, etc. It is also recognized as a Digital Public Good (DPG) by DPGA and Digital Square Alliance. For more details on Bahmni please visit: https://bahmni.org
2. One can try out Bahmni online using our demo servers here: Online Bahmni Demo
3. Connect2Bahmni is an mobile app specifically targeting practitioners to do manage their appointments, search and view patient details, teleconsult and record simple consultation documentation

Feature details

1. We would like to introduce capability for the practitioner to order investigations (Lab, Radiology, other procedures etc) and also order medications.
2. To see how such features are enabled on Bahmni online version, you can see here. Alternatively, you can login to our demo site, register a patient and then from from clinical module start a consultation for the patient.
3. The medication order UI will resemble somewhat like existing feature in Bahmni online version. However, for Investigation orders UI we would want a simplistic one, comprising of ability to search test/panel/radiology order etc, and subsequently capture simple details like intended date (optional), notes, priority etc

Technical details

1. Follow a FHIR first model, leverage Bahmni/OMRS fhir models. If there is a gap, raise to the core team for resolution.
2. For concepts/orderable search (e.g. drugs, investigations etc), use Bahmni/OMRS REST APIs.

Learning Path

1. Complexity: Medium.
2. Skills Required: Frontend (Flutter, Dart, Material UI). Backend (Java, MySQL). Local Install (Docker).
3. Name of Mentors: @angshu @gsluthra
4. Project Size: 4-6 weeks

Product Setup

1. For Bahmni setup, follow Docker setup. See: Running Bahmni on Docker
2. For building the flutter app, best to use Android Studio. See README

Acceptance Criteria

• 1. As a practitioner/doctor, I should be able to able to search investigations and order so for the patient. Once a particular investigation/drug is ordered, its added to consultation session. Subsequently on "finish" of session, the orders should reflect on Bahmni Server, and visible onto patient dashboard.
• 2. Pull Request reviewed/merged into Bahmni codebase, after feedback from Bahmni core team & mentor has been incorporated.
• 3. Automation Tests pass on Github Actions CI.
• 4. Verification of functionality against our dev server
• 4. All message strings are added into translation files.
• 5. A showcase is done of this feature in our public Bahmni PAT call (every Wed evening at 6:30 pm IST).

Milestones

• 1. Install Bahmni locally.
• 2. Demo the feature functionality, to ensure the contributor has understood the functionality.
• 3. Work with mentor to create low-fi design/mockup for new screens.
• 4. Create stories in JIRA (possibly 4-5) which list all requirements to develop this feature.
• 5. Complete the development (with unit tests), with local showcase from your own machine.
• 6. Raise PR for each story, and have it reviewed.
• 7. Merge PRs for all stories.
• 8. Validate and showcase the feature from our DEV server.
• 9. Document the new screens in Bahmni public WIKI.
• 10. Showcase the new feature in Community PAT call over zoom.

C4GT

This issue is nominated for Code for GovTech (C4GT) 2023 edition. C4GT is India's first annual coding program to create a community that can build and contribute to global Digital Public Goods. If you want to use Open Source GovTech to create impact, then this is the opportunity for you! More about C4GT here: https://codeforgovtech.in/

[UdityaRaj11]

Hi @gsluthra, this project has caught my interest, and I'll be glad to potentially contribute. I have some experience creating Flutter applications in different domains using my skills and creativity, and I'm looking forward to participating, giving my best with the help of your guidance.

[gsluthra]

Want to explore Bahmni?

Please install Bahmni and join our Slack (#community) channel. You can pick a volunteer ticket to get familiar. Thanks!

Links:

1. Docker: https://bahmni.atlassian.net/wiki/spaces/BAH/pages/3117744129/Getting+Started+Quickly+with+Bahmni+on+Docker
2. Slack/Bahmni Talk Forum: https://bahmni.atlassian.net/wiki/spaces/BAH/pages/414646273/Communication+Channels+and+Tools+Discourse+Slack
3. Volunteer JIRA Links: https://bahmni.atlassian.net/wiki/spaces/BAH/pages/116069555/Contributing+to+Bahmni#ContributingtoBahmni-4.ContributeasaDeveloper%2FCoder%2FAnalyst%2FQAtoBahmni
4. You will need to open a free Atlassian account to self-sign-up on Bahmni JIRA.

[Khushal747]

I am highly interested in joining this project, equipped with valuable experience in developing live projects using Flutter. My expertise in Flutter project management ensures efficient implementation of innovative solutions. I am eager to contribute my skills and deliver exceptional results for the success of this endeavor.

[ayku686]

Hi @gsluthra I feel immense joy and happiness in informing that this flutter project has caught my attention and I will like to work on this project. I assure you that I am sufficiently equipped and can come up with extraordinary results. Kindly give a chance to work on this project. I will send a proposal soon and will wait for your response.

[dhgavali]

The project looks fantastic and as a passionate flutter developer I would love to work on this project. I am excited to apply my development skills to optimize and enhance features in this app.

[sampadaagarwal]

Hi @gsluthra , I really get fascinated by the Bahmni and want to contribute in this project . I had an experience on building project using flutter/dart and also has a good knowledge of java . so please give me a chance to work on this project

[Balendrasingh2210]

Hi @angshu , I was exploring projects for c4gt , and I found about Bahmni. As a flutter developer, I can contribute in this project very well . So please give me a chance to work on this project.

[Abhijeetcodev]

I am extremely excited about the opportunity to be part of this project, as my experience in developing live projects using Flutter has equipped me with valuable skills.

[notinrange]

Hello, @gsluthra I go through Bahmni offers valuable tools for healthcare facilities and practitioners in managing hospital operations and providing quality care to patients in low-resource settings. and having requirements of a strong understanding of Flutter, Dart, and Material UI like tech stack. I want to contribute to Bahmni through Code for GovTech 2023 I made an application on Saloon Classifier which uses Tflite model in Flutter.

[Raj-kumarpatidar]

Dear @gsluthra, I'm highly intrigued by Bahmni and would love to contribute to this project. With experience in building projects using Flutter/Dart and a strong knowledge of Java, I believe I can make a valuable contribution. I kindly request an opportunity to work on this project.