Skip to content

Latest commit

 

History

History
50 lines (40 loc) · 3.04 KB

README.md

File metadata and controls

50 lines (40 loc) · 3.04 KB
Raw

A+ Build status

"We present a design and open source implementation for a service oriented e-learning system, which utilizes external services for supporting a wide range of learning content and also offers a REST API for external clients to fetch information stored in the system."

Karavirta, V. & Ihantola, P. & Koskinen, T. (2013) Service-Oriented Approach to Improve Interoperability of E-Learning Systems http://dx.doi.org/10.1109/ICALT.2013.105

The system has since been developed by various contributors at Aalto University, Finland.

Requirements

A+ is a Django 2.2 and Python 3.5+ application which has been run in production using Postgresql database, Apache 2 (or Nginx) and uwsgi. See doc/DEPLOYMENT.md for further deployment instructions. Consider using virtualenv and pip3 install -r requirements.txt. Create local_settings.py and override necessary Django settings from aplus/settings.py. At least DEBUG, SECRET_KEY and DATABASES must be set in case of deployment. The server process needs write access to the media directory.

Development

See doc/README.md on how to create and run a test environment for development. The doc/GRADERS.md describes grader service protocols and doc/example_grader.py is a minimal sample for implementing different kind of exercise graders. A separate grading framework application supporting the A+ protocol exists at https://github.com/Aalto-LeTech/mooc-grader

The selenium_test/ offers an integration test suite using the Selenium Firefox driver.

Code Organization

  • aplus/ : Django main settings
  • userprofile/ : User information and authentication
  • shibboleth_login/ : User authentication via external Shibboleth login. Requires Shibboleth configuration for the Apache/Nginx web server.
  • course/ : The course instances, modules and chapters
  • exercise/ : Exercises and submissions to them
  • deviations/ : Student deviations to submission rules (deadline extensions and extra submission attempts)
  • notification/ : User messaging framework
  • edit_course/ : The course editing for teachers
  • inheritance/ : Utilities for model class hierarchy
  • external_services/ : Linking to external services, optionally LTI authenticated
  • apps/ : Provides plugins that can integrate additional content to course instances
  • api/ : An HTTP REST service API for accessing A+ data
  • redirect_old_urls/ : Redirections from the most important old URL targets
  • lib/ : General library code
  • templates/ : General site templates
  • assets/ : Static web server assets, e.g., JavaScript, styles and images
  • media/ : User uploaded files