1
0
Fork 0
mirror of https://codeberg.org/Mo8it/AdvLabDB.git synced 2024-09-19 18:31:16 +00:00
AdvLabDB/README.md

62 lines
1.8 KiB
Markdown

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)
# Requirements
You need to have Python version >=3.9 and Poetry installed. To install Poetry, follow the official instructions [here](https://python-poetry.org/docs/#installation).
# Start server
Every following instructions has to be followed every time before starting the server if not mentioned otherwise.
Navigate to the directory `advlabdb` where the repository is cloned and run:
```
git pull
```
to pull the latest changes from the remote repository. Then run:
```
poetry install
```
to install (or update) all needed packages to the virtual environment. Now enter the virtual environment:
```
poetry shell
```
**ONLY IF** you are starting the server for the first time without an existing database or you want to **!drop and recreate!** the database then run:
```
# CAUTION, running this drops an existing database!
python testDB.py
```
This (re-)creates the database with some elements for testing.
Now you can start the server by running:
```
python run.py
```
This command will print out the URL for accessing the local server. For example:
```
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
```
This URL leads to the home page where you can login with this testing admin account:
- email: admin@protonmail.com
- password: admin
# To-Do:
- Deactivate assistants account after a while if not assigned to experiments
- Email integration + assistant reminder?
- Students code for getting information and giving feedback
- Statistics + semester review with alerts
- Logging
- Documentation with Sphinx
- Production server configuration
- Backups
- Licence (GNU AGPLv3?)
- Privacy policy