fgpe-erasmus / authorkit-api

The API of a toolkit to author gamified activities to support programming learning. This is part of the Erasmus+ Project entitled Framework for Gamified Programming Education (FGPE).

FGPE AuthorKit API

The API of a toolkit to author gamified activities to support programming learning. This is part of the Erasmus+ Project entitled Framework for Gamified Programming Education (FGPE).

Requirements

• Node Version Manager n
• Docker + Docker Compose
• npm

Installation

$ npm install

Configuration

Copy file .env.example and name it .env.dev

Start Guide

Outside Docker containers

• Create .env file cp .env.example .env and fill-in existing env variables
• Install dependencies npm install
• Start the app npm run start

Inside Docker containers

Just run already prepared bash script:

$ ./build

It will setup the project for you (building the Docker images, starting docker-compose stack). The NestJS app running in dev mode will be exposed on http://localhost (port 80)

For IDE autocompletion to work, run yarn on the host machine.

Working w/ the app

# Bring up the docker with api, database, ...
$ docker-compose up -d

# development
$ npm run start

# build
$ npm run build

# production mode
$ npm run prod

# fix lint errors
$ npm run lint:fix

Docker build

Build image

To build a docker image, execute:

$ ./build.sh

Test

# unit tests
$ docker exec -it nest npm run test

# e2e tests
$ docker exec -it nest npm run test:e2e

# test coverage
$ docker exec -it nest npm run test:cov

Environment Configuration

.env.example contains the configuration keys that must be set in .env.dev for development and/or .env.prod for production.

When using the build script, one of these is automatically cloned to .env. If you don't use the build script, please m

Swagger

To see all available endpoints visit http://localhost/docs

TypeORM integrated

TypeORM gives the possibility to use next db types: mysql, postgres, mariadb, sqlite, mongodb etc. Please look at docs for more details.

We are using postgres.

Acknowledgments

This software has been developed as a part of the Framework for Gamified Programming Education (https://fgpe.usz.edu.pl/) and FGPE Plus: Learning tools interoperability for gamified programming education (https://fgpeplus.usz.edu.pl/) projects which were co-funded by the Erasmus+ Programme of the European Union.

License

authorkit-api's Issues

Refactor access control

Currently, access control rules for new entities involve the creation of a voter and ~30 lines of almost repeated code. I don't like this strategy anymore.

Develop access control guards mechanism (annotation-based) to protect endpoints, both through project-level roles and global roles.

Social Login - Github

Integrating Github Sign-In into Authorkit.

Import a full project

Import a full project containing sub-packages in YAPExIL and GEdIL format.

Social Login - Facebook

Integrating Facebook Sign-In into Authorkit.

Export a gamification layer in GEdIL format

Allow to export gamification layers in a package following GEdIL format.

Import a gamification layer in GEdIL format

Allow to import gamification layers from a package following GEdIL format.

Import an exercise in YAPExIL format

Allow to import exercises from a package following YAPExIL format.

Social Login - Google

Integrating Google Sign-In into Authorkit.

Export a full project

Export a full project containing sub-packages in YAPExIL and GEdIL format.

Complete Support for GraphQL

Support for GraphQL is not synced yet with REST since refactoring.

Social Login - Twitter

Integrating Twitter Sign-In into Authorkit.

Export an exercise in YAPExIL format

Allow to export exercises in a package following YAPExIL format.