An experiment in mass-collaborative authoring of general, intelligent tutoring systems.

Usage

Installation

After cloning the repository,

• npm install or yarn install

The app needs to be configured with the url of a CouchDB (or other database respecting the CouchDB replication protocol) server. See /src/ENVIRONMENT_VARS.ts to point the app toward a specific database. The default value, for ease of development startup, points to an in-browser pouch-db database.

The alternate value in ENVIRONMENT_VARS.TS points to the default url of a locally running CouchDB database.

• CouchDB Website

Note that CORS may need to be enabled in your CouchDB install.

Development

This project is scaffolded with vue-cli 3. See the vue-cli docs for more detail on build / deployment / environment configuation.

Development Build / Serve

Prerequisites:

• initialize the test database submodule with git submodule init
• install docker

npm run serve or yarn serve from the project root.

Does:

• in-memory build of the project and hosts with the webpack dev server. Hot reloading and source maps included for in-browser debugging.
• runs the express server backend.
• launches a couchdb backend with test data as a docker container

UI Component browsing with mock data

npm run test:ui or yarn test:ui from ./packages/vue

Builds and runs the front-end with mock data sources. Navigate to localhost:8080/uimocks.

Debugging

The project can be debugged inside of VSCode using the existing settings from ./vscode/launch.json. After starting a development server with yarn serve / npm run serve, hitting F5 will launch VSCode's debugger and attach to the process. Launch configurations for Firefox and Chrome are present. They need the VSCode debugger for firefox and debugger for chrome exensions, respectively.

As of now, only the firefox debugger is functioning reliably (see #2).

Component state / props / virtual DOM exploration is also available in the browser via vue-devtools.

• Firefox Addon
• Chrome Extension

Production Build

Check for relevant flags in /src/ENVIRONMENT_VARS.ts before building for production.

• npm run build or yarn build

Outputs a static web page in the /build folder.

License

The project in general follows the AGPL-3.0 licence. However, materials in /src/base-course/ fall under the MIT licence (this folder will eventually be pulled to its own repository/package - see #3).

AGPL-3.0

MIT