E-NDP service personne

Description

Ce dépôt contient le service personnes e-NDP, qui se décline de la manière suivante : - la base de données (données intiales comprises) pour les personnes; - l'interface d'administration pour la BD des personnes; - l'API (+ documentation Swagger) pour interroger la BD des personnes.

Installation

En local, cloner le dépôt GitHub :

bash git clone git@github.com:chartes/endp-api.git

Puis exécuter les commandes suivantes :

bash virualenv --python=python3.8 venv source venv/bin/activate pip install -r requirements.txt

Lancer l'API

Les tâches courantes sont réalisées avec le script run.sh.

Pour une première initialisation de la base de données ou pour la recréer et lancer l'application :

bash ./run.sh dev -db

Pour lancer l'application seule (ignorer l'argument -db) :

bash ./run.sh dev

Pour contrôler le bon fonctionnement de l'application :

• la documentation de l'API se trouve à l'adresse : http://localhost:8888/endp-person/api/docs
• l'interface d'administration se trouve à l'adresse : http://localhost:8888/endp-person/admin/

Identifiants par défaut pour l'authentification à l'interface d'administration pour le développement et les tests :

• username : admin
• password : admin

[!WARNING]
Les identifiants par défaut ne sont pas sécurisés, il est recommandé de les modifier en dev ou en prod.

Gestion des utilisateurs

• Ajouter ou supprimer un utilisateur
• Modifier un mot de passe

Ces actions sont disponibles dans l'interface d'administration de l'application, si la connexion s'effectue avec un compte ayant les droits d'administration.

Autre méthodes de gestion utilisateur (deprecated)

• Ajouter des utilisateurs :

bash python3 manage.py create-user --username <username> --email <email> --password <password> - Modifier un mdp :

bash python3 manage.py reset-password -u <username> -p <new_password>

Contrôle de la qualité du code et tests unitaires

La qualité du code et les tests unitaires sont réalisés via la CI GitHub Actions. Cependant, pour lancer les tests en local :

```bash cd tests/

1. lancer le contrôle de la qualité du code

rendre le scripts exécutable (si nécessaire)

chmod +x linter.sh ./linter.sh

2. lancer les tests unitaires

pytest

3. lancer la couverture de code

pytest --cov ```