Project: OpenMRS Atlas 3.1
Primary Mentor: Burke Mamlin
Backup Mentor: Harsha Kumara
Student: Sai Sandeep Mutyala
Project Link: https://wiki.openmrs.org/display/projects/Atlas+3.1+Project
Overview
As OpenMRS infrastructure moved towards using LDAP, the PHP implementation of Atlas started to break. Efforts on converting Atlas to Node were started in a previous year’s GSoC project, where most of the front-end was setup. The objective of the project is to fix the missing pieces in the Node version of Atlas, and also integrate Atlas with the Atlas module. A lot of new features were also implemented as part of this project.
Objectives
Primary
- Implement Login through LDAP (Done!)
- Support addition, updating, and deletion of markers (Done!)
- Check and store whether user is an admin (Done!)
- Create an admin page (Done!)
- Get the Atlas Module working (Done!)
- Examine and Document the API (Done, but updates are expected)
- Make it easier for a user to spot his own markers (By displaying a list/coloring markers/etc.) (Done!)
Additional
- Create an RSS feed (Done!)
- Support upload of marker images (Done!)
- Support download of map images (Done!)
- Implement downloading of marker data for admins (Done!)
- Allow more than own owner for a marker (Done!)
- Notify users when their marker is fading (Done!)
- Add search for markers (Done!)
- Add basic reporting resource (Done!)
- Add report screen for Atlas (Done!)
Contributions
openmrs-contrib-atlas:
Here’s my list of contributions to the repository.
openmrs-module-atlas:
Here’s my PR on making the Atlas module work with Atlas.
Weekly Blog Posts
- OpenMRS Atlas GSoC 2019 — Community Bonding Period
- OpenMRS Atlas GSoC 2019 — Week 1
- OpenMRS Atlas GSoC 2019 — Week 2
- OpenMRS Atlas GSoC 2019 — Week 3
- OpenMRS Atlas GSoC 2019 — Week 4
- OpenMRS Atlas GSoC 2019 — Week 5
- OpenMRS Atlas GSoC 2019 — Week 6
- OpenMRS Atlas GSoC 2019 — Week 7
- OpenMRS Atlas GSoC 2019 — Week 8
- OpenMRS Atlas GSoC 2019 — Week 9
- OpenMRS Atlas GSoC 2019 — Week 10
- OpenMRS Atlas GSoC 2019 — Week 11
- OpenMRS Atlas GSoC 2019 — Week 12
Resources
Important Links
- Atlas 3.1 Talk Page
- Atlas 3.1 Project Page
- Atlas Server REST API
- Final Evaluation Blog Post
- openmrs-contrib-atlas
- openmrs-module-atlas
Mid-term Presentation
Future Work
- The interface still uses Bootstrap 3, and could be upgraded.
- Transferring of marker ownership could be implemented.
Thoughts on GSoC
I had always been curious about contributing to open source, but didn’t get into it until I heard about GSoC. I didn’t know I’d enjoy it so much until I started contributing to OpenMRS around the beginning of March.
My primary mentor @burke has been really responsive and supportive throughout the GSoC period, and made my experience pleasant. Under his guidance, I feel like we managed to do more than what we had set out to do. I also learned a lot about open-source practices, got a bit of experience with CI/CD (Thank you @cintiadr!), etc.
I’d like to thank the OpenMRS community and Google for this opportunity, and for giving me a fun and productive summer.