Skip to content

HE-Arc/Bachelora

Repository files navigation

Contributors Forks Stargazers Issues


Logo

Bachelora

Bachelora is an application for storing the various bachelor's degree projects offered to students in the Computer Science and Communications Systems programme. Teachers can enter, modify or delete bachelor's work, while students can consult it.
Explore the docs »


Table of Contents
  1. About The Project
  2. Getting Started
  3. Rendu intermédiaire
  4. Contributing
  5. Contact
  6. Acknowledgments

About The Project

Project Mockups

Created on Figma

(back to top)

Built With

  • Django
  • Vuejs
  • Quasar
  • Figma

(back to top)

Getting Started

To get a local copy up and running follow these simple example steps.

Installation

Clone the repository

En SSH

git clone [email protected]:HE-Arc/Bachelora.git

En HTTP

git clone https://github.com/HE-Arc/Bachelora.git

Launch the project

ℹ️ Important

The project is separate in two parts: Backend with Django and Frontend with Vuejs The two parts of the project need to be start individually.

Backend

To start the backend, you have to create and active the virtual environment. After that, you have to start the python server.

From the subfolder ~\Bachelora\api\, in a terminal, enter the following commands:

Create virtual environment

pipenv install

Start virtual environment

pipenv shell

Apply migrations to the database (only if migrations have changed or if it's the first time you clone the project)

python manage.py migrate

Start backend server

python manage.py runserver

The backend application is available at http://localhost:8000.

Frontend

To start the backend, you have to install the dependency and run the developpement. From the subfolder ~\Bachelora\frontend\, in a terminal, enter the following commands:

Installation of dependency

npm install

Start developement server

npm run dev

The frontend application is available at http://localhost:5173.

(back to top)

Rendu intermédiaire

Page d'affichage de BDD

L'affichage d'une liste de données provenant de la base de données, dans notre application, correspond à la liste des travaux de diplômes : Liste des TB. Normalement, la liste des travaux de bachelors s'affiche, les TB sont affichés par ordre décroissant par ordre d'ajout. L'utilisateur peut filtrer l'affichage des TB en fonction des tags.

Page d'enregistrement BDD

Pour l'enregistrement de nouvelles entrées dans la base de données, dans notre application, correspond l'ajout d'un nouveau travail de diplôme. Pour ce faire, il faut cliquer sur se rendre sous "Ajouter un travail de bachelor" (toujours depuis la page de la liste des TB). Ensuite, il faut compléter le formulaire. Après avoir saisies les données, l'utilisateur est redirigé vers la page de la liste des TB.

(back to top)

Rendu final

Les visiteurs ont accès à la page d'accueil, de connexion et d'inscription. Ils ne peuvent donc pas tester ni avoir accès aux fonctionnalités de l'application s'ils ne s'inscrivent ou ne se connectent pas.

Compte enseignant

Un visiteur peut s'inscrire en tant qu'enseignant ou se connecter à son compte enseignant. Un enseignant peut :

  • Voir la liste des bachelors proposés et l'utilisateur peut filtrer l'affichage des TB en fonction des tags,
  • Ajouter un nouveau bachelor,
  • Modifier un bachelor qu'il a ajouté,
  • Supprimer un bachelor qu'il a ajouté

A noter que les opérations de modifications et de suppressions des bachelors s'appliquent pour tous les enseignants et tous les étudiants. Un bachelor supprimé ne sera plus visible dans la liste des bachelors proposés et également dans la liste des bachelors choisit par un étudiant.

Améliorations possibles (front)

  • Dans l'idéal, il faudrait qu'un administrateur système créer le compte de l'enseignant en amount et qu'il ne soit possible de s'inscrire en tant qu'enseignant ou il faudrait qu'il y ait une vérification manuelle si un utilisateur s'inscrit en tant qu'enseignant
  • Pour faciliter la gestion des bachelors entrés, il faudrait que les enseignants est une page qui leur permettent de modifier / supprimer les bachelors qu'ils ont ajoutés

Compte étudiant

Un visiteur peut s'inscrire en tant qu'étudient ou se connecter à son compte étudiant. Un étudiant peut:

  • Voir la liste des bachelors proposés et l'utilisateur peut filtrer l'affichage des TB en fonction des tags,
  • Ajouter un bachelor dans sa liste de sélection
  • Retirer un bachelor de sa liste de sélection

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

Contact

(back to top)

Acknowledgments

(back to top)