Atlas Module 2.0 Project

Abstract

The Atlas Module was created in Google Summer of Code 2011 as a way for implementations to easily create and maintain a marker on the OpenMRS Atlas. The module has not yet been widely adopted for two reasons: (1) it has not been distributed as part of OpenMRS, since OpenMRS 1.10 was delayed and later changed, and (2) creating or updating a marker depends on the module running in a production system connected to the public internet.

This project aims to address both of these issues by making a version of the Atlas Module to be distributed within OpenMRS 2.0 and allowing an implementation's marker to be registered to an OpenMRS ID, allowing for a the marker to be created or revised outside of the module.

Project Champions

• Paul Biondich
• Hamish Fraser
• Darius Jazayeri

Skills Needed

• Decent Java coding skills
• Basic SQL skills
• Some PHP experience will help

Objectives

• New Features
  • Adapt the Atlas Module to run within OpenMRS 2.0
  • Allow markers to be filtered by type(s)
• Marker Ownership
  • Refactor the Atlas Module and the OpenMRS Atlas website to register ownership of an implementation marker (via OpenMRS ID)
  • Provide a mechanism to "recover" control of a marker using the registered OpenMRS ID
  • Allow a user to link to an existing marker from within the Atlas Module, using their OpenMRS ID
• Administration
  • Create administrative screen(s) for the Atlas Server to more easily manage markers

Extra Credit

• New Features
  • Provide a tool to export a slide for presentation (e.g., using phantomjs to create slide-worthy image)
• Marker Ownership
  • Allow a user to create their marker directly on the Atlas website
  • Allow a user to update or delete their marker directly on the Atlas website
  • Provide a mechanism to transfer ownership from one OpenMRS ID to another (registered owner specifies a new owner's OpenMRS ID)

Resources

• Atlas Module page and user guide
• Original Atlas Module project page

Deliverables

• Updated Atlas Module associating marker with OpenMRS ID with new functionality.
• OpenMRS 2.0 Atlas Module integration.
• Atlas website markers management functions + extra functionalities (markers filtering, color, …).
• README in developer’s documentation explaining how are implemented new functionalities and Atlas Module App.
• README in user documentation  explaining how to use Atlas Module App.

Project Timeline

21 April – 18 May:

• Getting familiar with Atlas Module and OpenMRS ID SSO

• Fixing some Atlas related Tickets

• Community bonding, participating in community events (Developers Forum, OpenMRS University, Hangout with mentor….).
   

19 May – 31 May:

• Refactor Atlas Server with a php framework
• Add global navbar on the top of Atlas

• Add Sign In form for OpenMRS ID and add OpenMRS ID SSO dependency in Atlas Module.
   

1 June 1 – 30 June:

• User can sign in successfully with his OpenMRS ID in Atlas Module

• A marker can be created and updated directly in the Atlas Server.

• Mid term Eval
  
  

1 July – 12 July:

• An existing marker can be associated with an OpenMRS ID in Atlas Module

13 July – 26 July: 

• Atlas Module ported to OpenRMS 2.0 (whith a look like google app style)

• New administrative screens in Atlas Server to manage markers (move, remove outdated or invalid markers)
   

10 August – 15 August:

• Extra features in Atlas Server : map exporting as a slide for presentation, marker filtering by type or version
   

16 August – 22 August:

• Wrapping up project, final touches.

• Writing Wiki and developer doc.