@betagouv/aides-velo
v0.2.0
Published
Modèle Publicodes pour le calcul des aides vélo en France
Downloads
1,039
Maintainers
Keywords
Readme
@betagouv/aides-velo
Modèle Publicodes pour le calcul des aides vélo en France.
[!NOTE] Ce modèle est la continuité de celui de Mes Aides Vélo rédigé par Maxime Quandalle. Il a été rapatrié dans l'organisation Beta.gouv pour faciliter sa maintenance et son évolution.
[!WARNING] Ce modèle est en cours de développement et n'est pas encore complet. L'API d'utilisation est susceptible d'évoluer, veuillez en tenir compte lors de l'utilisation de ce paquet. (N'hésitez pas à ouvrir une issue si vous avez des suggestions ou des retours à faire).
Installation
yarn install @betagouv/aides-velo
Utilisation
Par soucis de praticité, ce paquet expose en plus des règles Publicodes
(accessible depuis
./src/rules
),
une classe
AidesVeloEngine
qui encapsule un moteur Publicodes afin de faciliter
l'utilisation des règles.
En exposant notamment la méthode
computeAides
qui permet de calculer et récupérer la liste de toutes les aides éligibles
pour une situation donnée, ainsi que la méthode
setInputs
qui permet de définir les valeurs des questions du modèle de manière au format
JS et type-safe (voir le type
Questions
).
[!NOTE] To see the full API documentation, please refer to jsDocs.io.
Avec la classe AidesVeloEngine
import { AidesVeloEngine } from "@betagouv/aides-velo";
// Initialisation du moteur
const engine = new AidesVeloEngine();
// Définition de la situation
engine.setInputs({
"localisation . code insee": "33119", // Code INSEE de la commune, permet de récupérer les aides communales
"localisation . epci": "Bordeaux Métropole", // Permet de récupérer les aides intercommunales
"localisation . département": "33", // Permet de récupérer les aides départementales
"localisation . région": "75", // Permet de récupérer les aides régionales
"localisation . pays": "France", // Permet de récupérer les aides nationales
"vélo . type": "électrique",
"vélo . état": "neuf",
"vélo . prix": 1000,
"revenu fiscal de référence par part . revenu de référence": 20000,
"revenu fiscal de référence par part . nombre de parts": 2,
});
// Calcul des aides
engine
.computeAides()
.forEach(({ title, amount }) => console.log(`Aide ${title} : ${amount}€`));
// Aide Bonus vélo : 300€
// Aide Prime à la conversion : 400€
// Aide Bordeaux Métropole : 200€
// Aide Ville de Bègles : 200€
[!TIP] Pour récupérer les informations de localisation (code INSEE, EPCI, etc...) nécessaires pour le calcul des aides, il est possible d'utiliser le paquet
@etalab/decoupage-administratif
.
Avec les règles Publicodes
Il est également possible d'utiliser les règles Publicodes directement avec
@betagouv/aides-velo/rules
.
import Engine, { formatValue } from "publicodes";
import rules from "@betagouv/aides-velo/rules";
const engine = new Engine(rules);
// Permet de définir les valeurs de chaques règles et pas seulement celles qui
// correspondent à des questions.
engine.setSituation({
"localisation . epci": "'CA du Grand Angoulême'",
"vélo . type": "'électrique'",
"vélo . état": "'occasion'",
"vélo . prix": 1000,
"revenu fiscal de référence par part": 2000,
});
const result = engine.evaluate("aides . grand angouleme");
console.log(result.nodeValue);
// 400
console.log(formatValue(result));
// 400 €
Développement
// Install the dependencies and run postinstall scripts
yarn install
// Compile the Publicodes rules
yarn run compile:rules
// Run the tests
yarn run test
// Compile the whole package (rules + wrapper function)
yarn run compile
// Run the documentation server
yarn run doc