Système de fiscalité minière française modélisé avec OpenFisca.
Ce paquet requiert Python 3.7 et pip.
Il est recommandé d'utiliser un environnement virtuel (virtualenv) avec un gestionnaire de virtualenv tel que Pew.
Afin d'installer OpenFisca-France-Fiscalite-Miniere
, il est nécessaire d'indexer son code et d'installer ses dépendances.
Si vous disposez d'un environnement virtuel, activez-le à cette étape.
Afin d'installer l'ensemble des librairies nécessaires au développement, dans un terminal, exécuter le commande suivante :
make install
Pour en savoir plus sur cette commande, consulter le tag install
et ses dépendances dans le fichier ./Makefile
.
make install-prod
Les tests du module OpenFisca-France-Fiscalite-Miniere
peuvent être vérifiés par la commande suivante :
make test
Pour en savoir plus sur cette commande, consulter le tag test
du fichier ./Makefile
.
Le résultat de cette commande doit afficher la ligne suivante :
...
Success: no issues found in X source files
...
============================== XX passed in X.XXs ==============================
🎉 Félicitations, OpenFisca-France-Fiscalite-Miniere
est prêt à être utilisé !
Afin d'installer les librairies spécifiques à l'API Web, exécuter cette commande :
make install-api
Puis, démarrer l'API Web avec cette commande :
make serve
Un port par défaut est défini dans le Makefile
(port 5000
).
Pour en savoir plus sur la commande openfisca serve
sous-jascente et ses options, consultez la documentation de référence.
Vous pouvez aussi utiliser Docker pour démarrer le serveur d'API Web. À l'intérieur du répertoire du dépôt openfisca-france-fiscalite-miniere
, exécuter les commandes suivantes :
//Build de l’image localement
docker build --no-cache -t openfisca-france-fiscalite-miniere .
//Lancement de l’image
docker run --rm -p 5000:8000 openfisca-france-fiscalite-miniere
L'API Web est alors accessible via le port 5000 de l'hôte (8000 du conteneur).
Elle peut être testée dans un autre terminal. Elle renvoie par exemple un message d'accueil au format JSON en cas de requête curl http://0.0.0.0:5000
.
Un exemple de requête simple est donné dans ce fichier :
./openfisca_france_fiscalite_miniere/examples/societe.json
Pour transmettre la requête à l'API Web démarrée, dans un autre terminal, aller dans le répertoire du fichier JSON et envoyer la requête avec les commandes suivantes :
cd ./openfisca_france_fiscalite_miniere/examples
curl -X POST http://localhost:5000/calculate -H 'Content-Type: application/json' -d @societe.json
Le modèle openfisca_france_fiscalite_miniere
est employé pour la simulation de réformes et l'estimation des effets de la loi sur la base de données de production minière protégées (non fournies).
Les scripts de simulation sont assemblés dans le répertoire ./simulations
.
Il s'agit d'estimations des effets de réformes réalisées début 2020 sur la base de données Camino.
Ce sont des simulations d'une réforme de répartition communale de la Redevance Communale des Mines (RCM) pour les exploitations de chaque type de sel : pour chaque concession (titre) d'une mine, les simulations évaluent la distribution de la production et du produit de la taxe au prorata de la surface du titre sur chaque commune.
Elles sont rassemblées dans le répertoire ./simulations/reformes
:
test_essai_selg.py
est dédié au sel par abattage,test_essai_selh.py
est dédié au sel en dissolution.La génération de CSV au format des matrices suivantes est exécutable sur la base de données Camino (données sécurisées non fournies) :
Les données Camino employées en entrée des calculs sont également au format CSV. Leur format est donné dans simulations/INPUT_DATA.md