Difference between revisions of "FRM"

From mn/ifi/inf5750
Jump to: navigation, search
(Design =)
Line 8: Line 8:
 
Since there are a lot of organization units there will be implemented a dynamic search and filtering to help simplify the search for a specific organization unit.   
 
Since there are a lot of organization units there will be implemented a dynamic search and filtering to help simplify the search for a specific organization unit.   
  
== Design ===
+
== Design ==
 
=== Sketch ===
 
=== Sketch ===
  
[[File:FRM-sketch.jpg|200px|alt text]]
+
[[File:FRM-sketch.jpg|500px|alt text]]
  
 
== Group members ==
 
== Group members ==

Revision as of 14:32, 10 December 2015

Project details

This project is a web application to be used within DHIS2. DHIS2 is an open source health system where you can easily collect, display and analyze reported health data.

"In DHIS 2 the location of the data, the geographical context, is represented as organisational units. Organisational units can be either a health facility or department/sub-unit providing services or an administrative unit representing a geographical area (e.g. a health district)." [1]

Managing Organization Units[2] is an application to get a better overview of organization units within the DHIS2 system. The application will be a singe page application with a map displaying all org. units as polygons and markers with their correct coordinates. By clicking on a marker you will get all available information on a unit. You will also be able to edit these units if necessary. By clicking on an empty point on the map you will be asked to add a new org. unit.

Since there are a lot of organization units there will be implemented a dynamic search and filtering to help simplify the search for a specific organization unit.

Design

Sketch

alt text

Group members

Erik Haider Forsén - erikh@ifi.uio.no

Julie Hill Roa - juliehr@ifi.uio.no

Roza Moustafa - rozarm@ifi.uio.no

Yrjan Fraschetti - yrjanaf@ifi.uio.no

Architecture

This application will be a new module within the DHIS2 web app. This will be a easier, more visual way of doing tasks on organization units than what is possible within the DHIS2 web app today.

The app it self will be a SPA which get organization units and other information from the DHIS2 REST API. This app will therefore not store any information other than locally before sending the updated/new information back to the DHIS2 rest API.

Technologies

  • Bootstrap
  • HTML 5 & CSS 3
  • Angular 2.0 (alpha v. 48)
  • DHIS2 Web app
  • Google Maps JavaScript API
  • REST to communicate with DHIS2

It is a requirement to use Angular and since we had a lecture about Angular 2.0 and it is a new technology, the group wanted to test it out and see if it suited our project. So far there are no indication that it won't, so we are developing the application in Angular 2.0.

Features

  • Find organization units on map.
  • Present the information pertaining to the chosen facility.
  • Add new organization units by clicking on map.
  • Edit existing organization units.
  • Filter organization units.
  • Dynamic search for organization units.

If time:

  • Statistics on organization units
  • List all organization units.

Development

So far we have split the project development into 4 areas:

  1. Map interaction
  2. design
  3. DHIS2 API (retrieving and sending data to the DHIS web app)
  4. Dynamic search

If time we will also look into testing for javascript with Jasmine.

Milestones

Milestone 1 - due 08.11.2015

  • Document features and architecture on wiki:

See features paragraph.

We have also made a sketch of the design/layout of the application.

We have set up a project in git. This project contains a skeleton with a good Angular 2.0 structure for the web app.

We looked at googlemaps and made an API-key to be able to use their map-API .

All group members have done Angular 2.0 quick start and tutorials.

We have also looked into testing for javascript with Jasmine and tried to test one method.

  • Show understanding of dhis2 web app:

We have downloaded the dhis-live package and deployed it on our local computers. We have also switched from H2 db to postgres. We have populated our databases with sample data from Sierra Leone. We managed to upload our "hello-world"-app into dhis.

We have also browsed the dhis app too see other app examples, and successfully added a new organization unit.

We have started looking into retrieving data from the dhis API, but so far it is difficult with Angular 2.0 (need to learn more).

Milestone 2 - due 22.11.2015

  • First bare-bone version - static HTML
  • Uploadable as DHIS2 web app.

Milestone 3 - due 04.12.2015

  • Finished, if applicable also with mobile app.

Final delivery - due 11.12.2015

  • Presentations in mid December.

Other

Git repo: gitolite@git.uio.no:u/erikhf/frm.git

PR

FRM_PR#.231

FRM_PR#.232