Changes

Jump to navigation Jump to search
1,488 bytes added ,  09:34, 20 March 2014
Line 2: Line 2:  
This project is a complementary project to One Laptop Per Child Australia and Sugar Labs Training Activity [https://github.com/walterbender/training]. This projects aims to help us understand how users progress during their training, using the Training Activity.
 
This project is a complementary project to One Laptop Per Child Australia and Sugar Labs Training Activity [https://github.com/walterbender/training]. This projects aims to help us understand how users progress during their training, using the Training Activity.
   −
== How it works ==
+
== How It Works ==
 
Each time a user finishes a new training section, a report is sent automatically, by the Training Activity to the Training Server. In this way we obtain valuable feedback on users progression and also tasks statistics. Once the server receives reports from a new user, it will send a welcome email with a confirmation link. This helps us to validate users authenticity.
 
Each time a user finishes a new training section, a report is sent automatically, by the Training Activity to the Training Server. In this way we obtain valuable feedback on users progression and also tasks statistics. Once the server receives reports from a new user, it will send a welcome email with a confirmation link. This helps us to validate users authenticity.
   Line 15: Line 15:     
{| class="wikitable"
 
{| class="wikitable"
!colspan="5"| Data
+
!colspan="5"| Report
 
|-
 
|-
 
|'''Concept'''
 
|'''Concept'''
Line 22: Line 22:  
|'''Type'''
 
|'''Type'''
 
|-
 
|-
|rowspan="7"|Trainees
+
|rowspan="8"|Trainees
 
|uid
 
|uid
 
|randomly generated identifer
 
|randomly generated identifer
Line 45: Line 45:  
|version
 
|version
 
|user's activity version
 
|user's activity version
 +
|String
 +
|-
 +
|role
 +
|user's role in their institution
 
|String
 
|String
 
|-
 
|-
Line 73: Line 77:  
|String
 
|String
 
|-
 
|-
|requests
+
|requested
 
|whether or not a confirmation email was sen
 
|whether or not a confirmation email was sen
 
|Boolean
 
|Boolean
Line 82: Line 86:  
|-
 
|-
 
|}
 
|}
 +
 +
== How It Is Useful ==
 +
 +
* Provides a automated feedback mechanism that allows us to see user's progress.
 +
* Provides task related data that can allow us to do more insight in to training process and even Sugar usage.
 +
 +
== Source Code ==
 +
The code is available under GPL at https://github.com/tchx84/training-server
 +
 +
== RPM Installation ==
 +
If you plan to run this Server on Fedora 18 or never installation, I would you strongly recommend you to install via our RPMS packages.
 +
 +
=== Install tch's Repository ===
 +
 +
  $sudo vim /etc/yum.repos.d/tch.repo
 +
 +
  [tch]
 +
  name=tch
 +
  baseurl=http://www.sugarlabs.org/~tch/repos/f19/
 +
  enabled=1
 +
  metadata_expire=1d
 +
  gpgcheck=0
 +
 +
'''Warning:''' before moving on to the next step, make you have installed db-migrate tool via pip, pip install db-migrate (I will soon package this as an RPM).
 +
 +
=== Install Training Server ===
 +
 +
  $sudo yum install training-sever
 +
  $sudo service training start
 +
  $sudo systemctl enable training.service
 +
 +
=== Training Activity Settings ===
 +
 +
To send reports to your server some values must be changed in user's machines.
 +
 +
  gconftool-2 --set /desktop/sugar/services/training/url "https://your.server.com:443/training/report" --type=string
 +
  gconftool-2 --set /desktop/sugar/services/training/api_key "your-servers-api-key" --type=string
 +
 +
== Development ==
 +
 +
If you interested in contributing to this project please contact tch at sugarlabs dot org (Martin Abente Lahaye).
572

edits

Navigation menu