Table des matières
Cette application a été concue par deux étudiants ingénieurs belges dans le cadre de leur mémoire. Ce travail a été le fruit d'un partenariat entre l'Université de Louvain-La-Neuve et l'Université d'état d'Haïti. Ce projet a pour mission d'aider la population haïtienne à accéder aux données pluviométriques à l'aide d'une carte interactive du pays affichant les différentes stations pluviométriques.
Vous trouverez premièrement une carte interactive d'Haïti sur laquelle vous distinguerez les différentes stations répertoriées. Vous aurez aussi l'opportunité de comparer les différentes données présentes sur notre site web et de réaliser des statistiques au travers de tableaux comparatifs et de graphiques qui seront à votre disposition.
Les prérequis pour cette application sont légers et se limitent à avoir Make et Docker ( Engine + Compose ) installés au préalable.
- make ( sous MacOS ou Linux)
brew install make
- make ( sous Windows)
scoop install make
Rendez-vous sur le site officiel de Docker Engine, à l'adresse: https://docs.docker.com/engine/install/. Pour Windows/MacOS, vous pourrez simplement installer l'application Docker desktop, tandis que pour Linux, différents fichiers d'installation (.deb ou .rpm) sont disponibles à l'adresse précédente.
Enfin, il vous suffira de finir par installer Docker Compose, dont les détails selon les systèmes d'exploitation sont disponibles à l'adresse: https://docs.docker.com/compose/install/. Il s’agit de l’adresse officielle du guide d’installation de Docker Compose. Un autre lien utile de Compose propre au framework que nous utilisons, Django, est: https://docs.docker.com/compose/django/
- Obtenez une clef d'API gratuite aurpès de SendGrid
- Clonez le répertoire
git clone https://github.com/nverbois/TFE21-232.git
- Construisez l'application
Make build
- Entrez votre clef d'API dans
EPL21232/settings.pySENDGRID_API_KEY = 'ENTREZ VOTRE CLEF API';
-
Construire l'application (la première fois)
make build
-
Lancer l'application
make compose-start
-
Arrêter l'application
make compose-stop
-
Créer un super-utilisateur
make compose-manage-py cmd="createsuperuser" -
Créer les migrations de la base de données
make compose-manage-py cmd="makemigrations" -
Appliquer les migrations
make compose-manage-py cmd="migrate" -
Ouvrir le Shell de PostGreSQL
docker-compose exec postgres psql -U postgres -
Lister les volumes de Docker
docker volume ls
-
Remettre à zéro la base de données
docker volume rm tfe21-232_db-data
-
Lancer les tests unitaires
make compose-manage-py cmd="test EPL21232.apps.data.tests"
Ce projet est distribué sous licence MIT. Consultez la section LICENSE pour plus d'informations.
Nicolas Verbois - nicolasverbois@student.uclouvain.be
Florian Duprez - florianduprez@student.uclouvain.be
Project Link: https://github.com/nverbois/TFE21-232