Home

Vacances ?

Vacances ? Oui, mais pas pour vous !

Comité de pilotage

Membres du groupe :

• Mayer Sarah
• Allemann Jonas
• Guyaz Loïc

Superviseurs :

• Wohlfahrt Alexander
• Grunenwald David

Liens importants

• Description du projet : https://github.com/HE-Arc/slides-devweb/wiki/Projets-2022-2023

Site de production : https://vacances.k8s.ing.he-arc.ch

• API Django REST framework : https://vacances.k8s.ing.he-arc.ch/api/
• Admin. Django : https://vacances.k8s.ing.he-arc.ch/api/admin/

Données SSH

• Container Docker : 157.26.64.211
• Utilisateur : django
• Port : 30343
• Commande : ssh [email protected] -p30343

Contenu du wiki

• Cahier des charges
• Schémas

Documents importants

• Vacances_UserDoc.pdf

Présentation

Présentation.pptx

Logiciels et versions

Serveur

Nom	Version (local)	Version (VM)
NGINX	-	1.18.0
Image Docker	-	Ubuntu 22.04.1 LTS
Gunicorn	-	20.1.0
Python	3.11.1	3.10.6
pip	22.3.1	22.0.2
Node.js	18.13.0	18.13.0
NPM	8.19.3	8.15

Logiciels pour la documentation

Nom	Version	Utilité
dbdiagram.io	Outil en ligne	Pour le diagramme de la BdD
Draw.io	20.6.2	Pour les maquettes, schémas
Excel	Office 365	Pour le schéma d'interaction

Logiciels pour le développement

Nom	Version	Utilité
VS Code	1.75.1	IDE pour le développement
Git	2.38.0	Pour le gestionnaire de version, couplé avec GitLab
Django Framework	4.1.5	Framework utilisé pour le projet (BackEnd)
VueJS	3.2.45	Framework utilisé pour le projet (FrontEnd)

Bibliothèques ajoutées

Aucune spécifique en dehors des dépendances automatiques lors de la création d'un projet Django

Commandes utiles

Getting started

Après avoir cloné le projet :

• Configuration :
  • Dans le dossier frontend, copier le fichier .env.example et le renommer .env et l'adapter si nécessaire
  • Faire de même avec le fichier .env.example dans le dossier api/vacances
• Partie frontend (VueJS) :
  • Ouvrir un terminal
  • cd frontend (se déplacer dans le projet Vue.js)
  • npm install (installe toutes les dépendances nécessaires)
  • npm run dev (lance le serveur sur le port 5371)
• Partie backend (Django) :
  • Ouvrir un autre terminal
  • cd api (se déplacer dans le projet Django)
  • pip install -r requirements.txt (installe les packages nécessaires)
  • Base de données :
    • python manage.py migrate (appliquer les migrations de la base de données)
    • python manage.py createsuperuser --email [email protected] --username admin (créer un nouveau superuser)
      • choisir un mot de passe
      • Si la commande ne marche pas, ajoutez winpty devant la commande
    • python manage.py loaddata pokemon_data.json (charge des données dans la base de données)
    • python manage.py runserver (lance le serveur sur le port 8000)
    • Lié le compte admin précédemment créer à un joueur (pour l'utiliser dans l'app.)
      • Accéder à la page d'administration http://127.0.0.1:8000/api/admin/vacancesapp/player/
      • Ajouter une entrée pour l'utilisateur admin : ⚠️ le "username" du Player doit être le même que le nom du User ⚠️
        • 

Comptes existants

Sur le serveur de production

‼️ Uniquement à titre d'informations pour l'évaluation du projet, en temps normal ces comptes ne devrait pas être partagés et plus sécurisés.

⚠️ Le compte et le mot de passe sont sensible à la casse.

Compte administrateur Gestion de l'API	https://vacances.k8s.ing.he-arc.ch/api/admin/
Compte	admin
Mot de passe	admin

Compte Manager Gestion des pokémons sur le front	https://vacances.k8s.ing.he-arc.ch/pokemons
Compte	Manager
Mot de passe	Manager

Sources

• Déploiement du site sur le Docker : https://github.com/HE-Arc/slides-devweb/wiki/D%C3%A9ploiement-:-Django
• Images, polices, tuto, etc