Difference between revisions of "Foxtrot"

From mn/ifi/inf5750
Jump to: navigation, search
Line 121: Line 121:
 
= How you are dividing tasks within the group =
 
= How you are dividing tasks within the group =
  
Peter: forms and dataparsing - quiz-taking-app
+
We worked on several of the tasks together, and had no pre-defined roles within the group.
  
Mona: HTML, layout, CSS
+
However, we divided into areas of main responsibility. 
 +
 
 +
Peter: Forms and dataparsing - quiz-taking-app
 +
 
 +
Mona: HTML, layout, CSS over all, and front-end quiz-making-app.
  
 
Christopher: Backend API-read and write, quiz-making-logic, git-master
 
Christopher: Backend API-read and write, quiz-making-logic, git-master

Revision as of 19:16, 8 December 2014

List of group members

  • Mona Isabelle Yari (monaiy@ifi.uio.no)
  • Peter Havgar(peterkh@ifi.uio.no)
  • Christopher Neumann Ruud (chrinr@ifi.uio.no)

Summary of requirements

In this project there will be developed two applications (app) for participating and creating quizzes, indented to contribute to e-learning of the DHIS2 system.The content of the apps is divided into courses consisting of modules with three different levels of users.

APP 1: Course taking app 

Initially intended for new beginners taking courses at different levels.

The application should include:

  • User level session
  1. Presentation, (presentation of a topic).
  2. Test/quiz.
  • Mentor level session
  1. Be able to check if a user has passed a level.
  2. Presentation, (issues users have when learning this topic).
  3. Test/quiz.
  • Further, the app should take into account: 
    • Competition: Score list or stats. Districts and/or individual.
    • Computer user interface: The application will open in a separate window.
    • The app will be foolproof and will not need any instructions before use.

 APP 2: Course writing app

This app is intended for creating and editing modules and courses. Will be rigid, so the format stays the same.

Courses:

Need to be able to edit and create:

  1. Motivation, possibly by adding a video.
  2. Select list of modules.
  3. Test/quiz.

Modules: 

The user will be able to create and edit the presentation of a topic; free text, formatting and inserting links, pictures, videos etc.

Evaluation: 

This module is for monitoring a set of users during an evaluation period, through logs of their use of some of the DHIS operations.

Architechture

We will primarily use HTML5, CSS3,, Bootstrap and AngularJS in this project. We believe they will work well together and help us create the best possible solution. 

To communicate with the DHIS2 RESTful API, AJAX and JSON will be applied.

List of technologies and frameworks we will use:

  • JavaScript (angular)
  • JSON
  • CSS
  • HTML5
  • AJAX
  • Bootstrap

Features

The application will have the following features: 
(Core funtionality will be priorotized)

  • Two types of users: Normal User and Administrator
  • Creating quiz
  • Taking quiz
  • Courses
  • Modules
  • Tests

Functinality not included in first release:

  • Score Board (for competition)
  • Integrated update for each user taking a quiz
  • Mentoring possibilities (optional)
  • Forum for community of learners
  • Level system
  • Deleting courses
  • Editing courses

Time schedule

Each group should follow these milestones:

Milestone 1: 01th November

Document features and architecture on Wiki - DONE

Show understanding of DHIS2 web apps - DONE

Milestone 2: 15th November

First bare-bone version - static HTML - DONE

Basic JS object creation - DONE

Uploadable as DHIS2 web app - DONE and working

Read and write to API - DONE

Read and write to API via WEB - interface - DONE

Milestone 3: 8th December

Finished, if applicable also with mobile app. DONE

Final delivery: 8th December

Presentation: 9th December

How you are dividing tasks within the group

We worked on several of the tasks together, and had no pre-defined roles within the group.

However, we divided into areas of main responsibility. 

Peter: Forms and dataparsing - quiz-taking-app

Mona: HTML, layout, CSS over all, and front-end quiz-making-app.

Christopher: Backend API-read and write, quiz-making-logic, git-master

Screenshots and screen flows

Quiz making app

First step: This is the list of courses, with the ability to create more courses or edit a course's modules

First step: This is the list of courses, with the ability to create more courses or edit a course's modules


Second step: This is the list of modules, with the ability to create more modules or edit a module's tests

Second step: This is the list of modules, with the ability to create more modules or edit a module's tests


Third step: This is the list of tests, with the ability to create more questions

Third step: This is the list of tests, with the ability to create more questions

Quiz taking app

First scene in the application

First scene in the application

Total screen with application(left) and site (right)

Total screen with application(left) and site (right)

Second scene in the application

Second scene in the application

Third scene in the application

Third scene in the application

fourth scene in the application

Fourth scene in the application

Fifth scene in the application

Fifth scene in the application

Documented learning during project

In this project there has been a heavy focus on Javascript as a tool. Neither of the group members has used javascript in the past to any extent, and we feel we have learned a lot about DOM manipulation, AJAX and jQuery, javascript data structures, SCOPEs and functions.

In assition, we have used GIT extensively throughout he project, totaling over 250 commits between us.

We have also learned that most web-projects, or any project that needs to work with an established API, has to resort to workarounds in some cases because the API creators never predict all possible use-cases.

Suggested improvements to APIs etc

We would very much like the server to handle application/json or application/xml - requests, so that everything would not have to be parsed to text/plain - Christopher

allow data creation apart from writing hacks into systemSettings/myKey - really dirty way of handling larger data structures - Christopher

/api/systemSettings.json gives 200 OK, as well as /api/systemSettings/myKey , but /api/systemSettings/myKey throws 404 errors with some GET methods in postman, for unknown reasons. The API should be tidier.

Link to repository

Link to our git repository

gitolite@git.uio.no:inf5750/chrinr/foxtrot

https://github.com/Christopherruud/FoxTrot

Download link to sample web app or Android app

Quiz Maker: [1]

Quiz Taker: [2]