Free Go est une association neuchâteloise à but non lucratif qui à comme objectifs d'aider les personnes en situations de précarité, ainsi que de diminuer le gaspillage alimentaire.
Pour ce faire, ils mettent à disposition des frigos, mis en place grâce à des soutiens (entreprises, privés, sponsors, etc.), où il est possible de donner les invendus ou de faire des dons alimentaires.
L'application développée dans le cadre de ce projet doit être une vitrine pour les frigos gérés par l'association. Les utilisateurs peuvent voir les positions et contenus des frigos, et les gestionnaires des frigos peuvent mettre à jour le contenu de leur frigo.
L’arborescence des fichiers importants pour la compréhension de la structurede l’application est séparée en trois dossiers:backend/, freego/ et frontend/. backend/ contient tout ce qui est relatif à l’API. freego/ contient la configuration de Django avec notamment les fichiers .env et settings.py. frontend/ contient l’application Vue.js.
git clone https://github.com/HE-Arc/FreeGo2.git
cd FreeGo2
pip install pipenv
pipenv install -r requirements
Il faut également installer GDAL. La version 3.2.2 a été utilisée.
Créer un .env dans /freego/.env. (un modèle est diponible .env.example).
Je conseille de toujours travailler dans l'environnement virtuel python de pipenv avec pipenv shell
.
Créer un superuser avec python manage.py createsuperuser
Une fois fait, lancer le backend avec python manage.py runserver
et le frontend avec:
cd frontend/vueapp
npm run serve
Ouvrir le navigateur et aller à localhost:8000/admin. Se connecter avec les identifiants du superuser et cliquer sur le bouton d'update/peuplement de la base donnée. Alternativement, le script d'update/peuplement peut être lancé avec python manage.py updatedb
sans créer de superuser.