THMcards ist eine digitale Neuauflage eines klassischen Lerninstruments. Der Service bietet Studenten einen modernen und intuitiven Zugang zu einer der nachweislich erfolgreichsten Lernmethoden. THMcards wird als moderne SinglePageApplication entwickelt und legt in der ersten Ausbaustufe den Fokus auf Desktop-Browser.
Diese Version von THM Cards enthält ein vagrantfile.
Wenn man im Verzeichnis thmcards folgenden Befehl absetzt:
vagrant up
wird eine virtuelle Maschine gestartet, die bereits couchdb und nodejs enthält. Leider führt npm install auf der Vagrant VM oft zu abstürzen, weshalb npm install auf der VM nicht ausgeführt werden sollte. Um die benötigten NodeJS Module zu installieren, empfiehlt es sich auf der Host Maschine nodejs zu installieren und im thmcards Ordner folgenden Befehl auszuführen:
npm install --loglevel info --no-bin-links
danach kann man per 'vagrant ssh' auf die VM zugreifen. Um dort die CouchDB zu initialisieren muss man das Script "init.sh" ausführen.
./init.sh
Danach lässt sich THM-Cards per Script "start.sh" starten.
./start.sh
Im folgenden ist die ursprüngliche Installationsanleitung für THM-cards OHNE VM aufgeführt.
THMcards benötigt zum Betrieb eine Installation von node.js, sowie als Datenbankmangementsystem CouchDB.
Im Hauptverzeichnis finden sich die Datei development_settings.json, sowie production_settings.json. In dieser sind Einstellungen zur Datenbankverbindung, sowie den Callback-Urls der Authentifizierungsprovider wie Google oder Facebook vorzunehmen. Dies ist jeweils für das Entwicklungs- und Produktivsystem möglich.
Die benötigten Datenbankviews können über das Python-Script createviews.py angelegt werden. Vor der Ausführung ist darauf zu achten, dort ebenfalls die Zugangsdaten zur CouchDB einzutragen. Weiter müssen die Dokumente aus der Datei default_badges im Ordner couchviews manuell in die Datenbank übertragen werden.
Die Installation von THMcards erfolgt über den Node Package Manager (NPM). Dieser wird automatisch zusammen mit node.js installiert. Im Verzeichnis der Applikation ist der folgende Befehl abzusetzen:
npm install
Alle Modulabhängigkeiten, welche in der Datei package.json aufgeführt sind, werden aufgelöst und die Module installiert. Je nach aktuellem Systembenutzer sind für diesen Schritt gegebenenfalls Administratorrechte notwendig. Nach erfolgreicher Installation kann die Applikation über den Befehl
node app.js
gestartet werden.
Als Standardeinstellung kann THMcards auf Port 3000 unter der Adresse localhost im Browser aufgerufen werden.
Um THMcards dauerhaft zu betreiben, kann die Applikation mit forever als Daemon gestartet werden.
npm -g install forever
forever start app.js
Umschalten zwischen Entwicklungs- und Produktivumgebung erfolgt über die Umgebungsvariable NODE_ENV (default ist development):
NODE_ENV=production forever start app.js
Entwicklung: Daniel Knapp, Jan Kammer Projektleitung: Prof. Dr. Klaus Quibeldey-Cirkel
Verwendete OpenSource-Projekte:
node.js Backbone Marionette Underscore Bootstrap jQuery
Danke für die Unterstützung an:
F112a (M.Sc. Christoph Thelen, M.Sc. Paul-Christian Volkmer) AGQLS
THMcards is powered by Technische Hochschule Mittelhessen - University of Applied Sciences.