Paul2708 / cercet

A Collaborative Educational Remote Code Execution and Teaching (CERCET) system

Home Page:https://cercet.paul-hoger.de

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

cercet CI

The Collaborative Educational Remote Code Execution and Teaching (CERCET) tool is a website that allows teachers to have a look at their students. Students and teachers can program small Java applications. They can compile and execute it as well.

The main capability is that the teachers can observe the students' editors. In addition, the students will see the teachers cursors.

At this point, I want to thank @NyCodeGHG for her contributions. The fast development would not be possible without her. ❤️

If you are interested, you may have a look at the "documentation".

Current state

At the moment, CERCET is WIP. However, the current state is a minimal valuable product.

Important note: Cercet is currently missing some security related features. The following things need to be considered while running:

  • The Java code execution is not restricted by any means. There is no security manager implemented yet.
  • For example, users can execute a command (by Java Runtime exec function) to shut down the Docker container. Therefore keep an eye on who gets access to the application.

Run it

  1. Clone the repository by git clone https://github.com/Paul2708/cercet.git.
  2. Edit docker-compose.yml and frontend/src/environments/environment.prod.ts/ by replacing cercet.paul2708.de with your domain.
  3. Copy config.yaml into the project root directory and edit the tokens.
  4. Run docker-compose up.

Contribute

If you want to contribute, just hit me up on Discord (Paul2708#1098) or open an issue for discussion.

About

A Collaborative Educational Remote Code Execution and Teaching (CERCET) system

https://cercet.paul-hoger.de

License:MIT License


Languages

Language:TypeScript 43.0%Language:Java 42.6%Language:HTML 5.6%Language:SCSS 2.9%Language:JavaScript 2.7%Language:Kotlin 1.3%Language:CSS 1.2%Language:Dockerfile 0.6%