Dépôt de code du back de la startup d'état Mobilic incubée à la Fabrique Numérique du Ministère de la Transition Écologique.

Ce README contient essentiellement des informations pour installer un environnement de développement local du back Mobilic.

C'est plutôt ici pour des informations concernant :

• l'architecture logicielle du projet
• l'infrastructure et les différents technos ou outils utilisés
• le guide d'installation du front

• Python 3.9
• pip 21.2
• PostgreSQL 12.0, avec sa ligne de commande psql

Démarrer un serveur PostgreSQL local.

Exécuter le script d'installation depuis la racine du projet :

./setup_local_docker.sh

• DATABASE_URL : URL de la base de données. Par défaut c'est l'URL de la base de données mobilic locale (telle que créée par le script d'installation)
• MOBILIC_ENV : environnement (dev, test, staging, prod, sandbox). "dev" par défaut
• SIREN_API_KEY : jeton de connexion à l'API Sirene pour l'inscription entreprise. Facultatif
• MAILJET_API_KEY : jeton de connexion à l'API Mailjet pour l'envoi de mails. Facultatif (certaines requêtes renverront des erreurs ceci dit).
• MAILJET_API_SECRET : facultatif
• FRONTEND_URL : URL du serveur front (utilisé pour générer des liens dans des mails par exemple)
• JWT_SECRET_KEY : secret utilisé pour générer les jetons d'authentification. Facultatif.

Ne sont listées ici que les variables les plus importantes. L'intégralité des variables de configuration peut être trouvée dans le fichier config.py.

Il est possible de définir les variables d'environnement à partir d'un fichier texte qu'il faut rajouter à la racine du projet. Il faut ensuite passer le nom du fichier à l'application via la variable DOTENV_FILE.

DOTENV_FILE=.env flask run ...

Un fichier d'exemple détaille la structure attendue pour ce fichier.

Créer un fichier dans .env/.env.local avec :

# use development values
SENTRY_ENVIRONMENT=development
SENTRY_SAMPLE_RATE=1
SENTRY_DSN=

# disable sending emails
DISABLE_EMAIL=true

Lancer le serveur de développement qui recompile à la volée :

DOTENV_FILE=.env/.env.local flask run --host 0.0.0.0

flask test

L'ORM SQLAlchemy utilise Alembic pour la gestion des migrations de la base.

Les fichiers de migration sont situés ici.

Pour ajouter une migration il y a deux possibilités :

flask db migrate -m "message de migration"

qui va automatiquement générer un nouveau fichier de migration à partir de l'analyse du code, ou

flask db revision -m "message de migration"

qui va créer un fichier vide de migration à remplir manuellement

Pour mettre à jour la DB avec les dernières migrations la commande à exécuter est la suivante :

flask db upgrade

Pour injecter des données en base

flask seed

Utilisateurs créés:

• busy.admin@test.com [password]: Gérant de 10 entreprises employant chacune 10 employés

Pour vider la base

flask clean

Les différentes technos/frameworks utilisés par le back sont :

• graphene pour la couche API (GraphQL)
• Flask comme framework web
• SQLAlchemy comme ORM
• XlsxWriter pour générer des fichiers Excel (.xlsx)
• Jinja le moteur de templating de Flask (pour générer des html)
• xhtml2pdf pour générer des PDF

L'organisation s'inspire indirectement du motif Modèle-Vue-Contrôleur :

• models contient la représentation interne des différentes entités "métier" (utilisateurs, entreprises, activités, ...)
• domain contient la logique métier lorsque celle-ci devient un peu trop complexe
• data_access définit la structure des données exposées dans l'API
• controllers définit les actions de l'API
• services contient des services secondaires
• templates contient les templates html servant aux emails ou à la génération de PDF

• Documentation technique de l'API
• Conditions d'interfaçage

Licence MIT