Menu

1. Informations générales
2. Liste pré-requis
3. Création environnement
4. Installation des librairies
5. Lancement du programme
6. Interface de l'application
7. Image avec Docker
8. Auteur et contact

Projet Student Manager

• Développez une interface utilisateur pour une application de management d'étudiants et de classes.

• Utilisation de Python associé à une base de données MongoDB.
   

• Fonctinnalitées de l'application.

  • Création : d'étudiants
  • Création : de classes
  • Création : de cours
  • Gestion : des notes
  • Calcul : de la moyenne d'un étudiant
  • Calcul : de la moyenne d'une classe

---

Retour en haut 🡅

Liste pré-requis

• Interpréteur Python, version 3.12.0 ou supérieure.

• Application conçue avec les technologies suivantes :
   

  • Python v3.12.0 choisissez la version adaptée à votre ordinateur et système.
  • Python est disponible à l'adresse suivante ➔ https://www.python.org/downloads/
  • MongoDB 7.0.5 est disponible à l'adresse suivante ➔ https://www.mongodb.com/
  • Windows 10 Professionnel
     

- Les scripts Python s'exécutent depuis un terminal.
- Pour ouvrir un terminal sur Windows, pressez la touche windows + r et entrez cmd.
- Sur Mac, pressez la touche command + espace et entrez terminal.
- Sur Linux, vous pouvez ouvrir un terminal en pressant les touches Ctrl + Alt + T.

---

Retour en haut 🡅

Création de l'environnement virtuel

• Installer une version de Python compatible pour votre ordinateur.
• Une fois installer ouvrer le cmd (terminal) placer vous dans le dossier principal (dossier racine).
• Une fois installer ouvrer le cmd (terminal) placer vous dans le dossier principal (dossier racine).

Taper dans votre terminal :

$ python -m venv env

Un répertoire appelé env doit être créé.

---

Retour en haut 🡅

Installation des librairies

Installer les librairies

• Le programme utilise plusieurs librairies externes et modules de Python, qui sont répertoriés dans le fichier requirements.txt.
• Placez-vous dans le dossier où se trouve le fichier requirements.txt avec le terminal, l'environnement virtuel doit être activé.
• Placez-vous dans le dossier où se trouve le fichier requirements.txt avec le terminal, l'environnement virtuel doit être activé.
• Pour faire fonctionner le programme, il vous faudra installer les librairies requises.
• À l'aide du fichiers requirements.txt mis à disposition.

Taper dans votre terminal la commande :

$ pip install -r requirements.txt

---

Retour en haut 🡅

Lancement du programme

• Pour lancer le programme.
• Taper dans votre terminal la commande :

$ python main.py

---

Retour en haut 🡅

Interface de l'application

• Le programme se compose des menus suivants :

- Menu principal.

- Menu des étudiants.

- Menu des classes.

---

Retour en haut 🡅

Image Docker

• Une image Docker est disponible pour ce projet.

• Vous pouvez récupérez l'image sur Docker Hub ➔ Image Docker

$ docker pull bubhux/repository-student-manager:latest
$ docker pull bubhux/repository-student-manager:mongo-3.6

• Ou vous pouvez contruire l'image localement.

$ docker-compose build

• Lancez l'image en local une fois le conteneur Docker démarré, vous pourrez accéder à l'application.

$ docker-compose up --no-start
$ docker-compose start

• Accéder au dossier du conteneur Docker pour lancer l'application manuellement.

$ docker exec -it studentmanager-studentmanager-app-1 bash

• Une fois l'accès au conteneur effectué lancer l'application avec la commande suivante :

$ root@5acb437d420f:/app# python main.py

• Pour quitter l'application tapez :

$ root@5acb437d420f:/app# exit

• Pour arrêter les conteneurs Docker.

$ docker-compose stop

Note navigateur : Les tests ont était fait sur Firefox et Google Chrome.

---

Retour en haut 🡅

Auteur et contact

Pour toute information supplémentaire, vous pouvez me contacter.
Bubhux: bubhuxpaindepice@gmail.com