Utilisateur:Thierry46/Finances Locales

Logo de l'outil Finances locales version 4.

Bienvenue sur la page de description de l'outil Finances locales :

Cet outil a pour objectif de faciliter la rédaction de la section Finances locales des communes de France avec pour référence le site officiel data.gouv.fr.

Introduction modifier

Au , la plupart des communes de France, même les grandes villes ou celles qui ont été évaluées articles de qualité, ne possèdent pas de sous-section Finances locales. Voir par exemple Lyon.

Le travail de rédaction est pénible car il faut synthétiser un grand nombre d'informations disponibles sur le site du Ministère de l'Économie et des Finances. Il faut aussi générer un Wikicode complexe pour les tableaux et les graphiques. En bref, un travail de bot !

Pour le rayonnement de Wikipedia, Il me semblait bon que les sections Finances locales présentent une synthèse, claire, cohérente, neutre et basée sur des références officielles, de l'état de chaque commune de France.

Description modifier

Rôle modifier

Le projet Finances locales permet d'aider le contributeur à utiliser plus facilement les informations du site data.gouv.fr pour compléter les sections de finances locales, voir description sur la page de conseil de rédaction du portail du projet Communes_de_France.

Sources des données modifier

Les données proviennet du site data.gouv.fr :

Fichiers produits en V4 modifier

On trouvera sur le site Web indépendant des fichiers pour les communes et pour les groupement de communes :

  • du wikicode qui pourra servir à enrichir Wikipédia
  • du code HTML et des graphiques au format SVG directement visibles sur le site Web.

Informations techniques modifier

 
Cet outil utilise Python pour lire les données au format CSV du site Web data.gouv.fr et produire du Wikitexte.

Exécutables en V4 modifier

Ce logiciel se compose de plusieurs scripts :

  • Pour les communes :
    • initBdFomListeDep : initialisation de la base de données avec des listes de villes à traiter ;
    • updateDataMinFi : récupère les données des fichiers [Comma-separated values|CSV]] du site Web data.gouv.fr et les stocke dans une base de données relationnelle SQLite ;
    • updateScoreWikipedia : récupère des données dans Wikipedia ;
    • genCode : génère le texte, les tableaux des données sur 4 ans, de pictogrammes, les graphiques sur des périodes de plus de 18 ans ;
    • genIndexSite : génère un index pour le site WEB de déploiement.
  • Pour les groupements de communes :
    • updateGroupementsCommunes : met à jour dans la base les groupements de communes en recherchant dans Wikipedia les informations pour chaque ville enregistrée dans la base de données.
    • updateDataMinFiGroupementCommunes : Met à jour les données de groupement de communes de à partir du fichier .csv passé en paramètre pour tous groupement présents dans la base.
    • genCodeGroupement : transforme les données traitées par updateDataMinFiGroupementCommunes en wikicode et HTML pour enrichir les sections "Finances locale" des articles de Wikipedia.fr concernant les groupements.

Dépendances modifier

Il est basé sur les logiciels et composants suivants :

Sources et notice d'installation et d'utilisation modifier

Les fichiers sources sont librement accessibles sur la page du projet finances-Locales sous GitHub. Une notice sommaire est incluse en format texte Markdown dans le paquet contenant les sources sur github.

Qualité et mesures logicielles modifier

En version 4.0.1, le logiciel est constitué de 7 714 lignes de code et 5 897 lignes pour 350 tests unitaires.

  • Maintenabilité : le logiciel Pylint permet de vérifier le respect des standards et la détection de bugs. En version 3.0.0, l'outil obtient la note globale de 9,77/10 ; il subsiste cependant des problèmes (nombre d'instructions et de paramètres excessifs) nécessitant une reconception de certaines parties qui dépassent les seuils de complexité des métriques standards.
  • Test unitaire : py.test pour la vérification. En v4.0.1, cet outil permet de jouer les 350 tests unitaires. Il participent à la vérification des non-régression lors des modifications.
  • Couverture de code : en v4.0.1, Pycoverage mesure que 95 % des 5 360 instructions sont couvertes par la batterie de tests décrite au-dessus.
  • Portabilité : l'outil fonctionne sur tout ordinateur : Mac, PC Windows, Linux...

Format des fichiers et volumes modifier

Les fichiers de sortie graphiques sont tous en format SVG et HTML, encodés en UTF-8 et lisibles avec un éditeur simple ou un navigateur web :

Des Modèles définissent la génération du wikicode et du HTML.

Les résultats déployés sur le site web occupent 864 Ko par commune et 864 Ko par groupement pour environ 3 Go au total.

Licence modifier

 
copyleft
 
GNU GPL v3

Finances locales est un logiciel libre distribué en copyleft sous licence GNU GPL version 3.

Phase de test V0 modifier

Statut :   Depuis le jusqu'au dans :

Phase de pré-déploiement V0 modifier

Statut :  Vote terminé et favorable (voir Archive du vote du 29 juillet au 9 août 2015).

Du au , dans un panel représentatif de communes ont été choisies :

Phase de déploiement V1 modifier

Statut :   sur décision administrative.

Cette phase de déploiement dans les articles des communes de France dont les articles Wikipédia sont les plus avancés avait commencé suite au vote favorable du 29 juillet au 9 août 2015. Elle s'est arrêté le sur décision administrative des administrateurs de Wikipédia.

Phase de déploiement externe V2 et + modifier

Statut :  , version 3.0.0 réalisée et résultats accessibles sur site Web indépendant.

Cette phase concerne les 3 533 communes dont la rédaction est la plus avancée sur Wikipédia.

Les contributeurs de wikipédia disposeront du Wikicode à insérer avec des sources primaires et secondaires.

Remarques et problèmes modifier

  • Si vous voulez faire part d'une remarque ou si vous détectez un problème pour une section générée par cet outil, n'hésitez pas à laisser un message dans la page de discussion.

Évolutions modifier

Nommage des versions modifier

La version de l'outil est nécessaire pour des raisons de traçabilité. Elle est définie dans le fichier FinancesLocales.properties. Elle est indiquée en commentaire du Wikitexte généré et dans la première note dans les références de l'article de la commune.

Le nommage des versions est défini par :

  • un numéro : voir l'article Version d'un logiciel :
    • les numéros de versions x.y commençant par 0 étaient réservées à la phase interne de test ;
    • les numéros de versions x.0.z étaient des candidates déployées sur les communes de Lunegarde, Issendolus, Cahors et Toulouse.
    • les numéros de versions suivants, stables et déployables sur Wikipédia ;
  • un nom mnémotechnique qui qualifie chaque version.

Version 0.4 vers version 0.5 modifier

Version 0.5 vers version 0.6 modifier

Version 0.6 vers version 0.7 modifier

Version 0.7 vers version 0.8 modifier

Version 0.8 vers version 0.9 modifier

Version 0.9 vers version 0.10 modifier

  • Version 0.10 ; nom de code : capitalo-simplette
  • Statut :  
  • Problème : cette version porte des jugements de valeur inadmissibles : détectés par Harrieta qui a reçu cette récompense :
  Merci Harrieta pour ton aide, tes idées, remarques et conseils qui permettent la réalisation de l'outil Finances locales. Surgi de la nuit et du brouillard, tel l'archange Michel ou de façon plus prosaïquement un lanceur d'alerte, tu as terrassé la monstrueuse version 0.10, rebaptisée depuis la capitalo-simplette. Cette bête infâme ne prétendait-elle pas porter des jugements de valeur manichéens sur les finances locales avec son perfide système de couleurs et ternir à jamais l'image de Wikipédia ? Suite à tes remarques, elle sera métamorphosée en une v1.0 baptisée Yin yang en référence à ses pictogrammes tout en nuances. Gloire éternelle à toi ô Harrieta  . Additionnons nos forces, partageons nos connaissances --A+ Thierry (discuter) 18 juin 2015 à 08:45 (CEST).

Version 0.10 vers version 0.11 modifier

Version 0.11 vers version 1.0.0 modifier

Version 1.0.0 vers version 1.0.1 modifier

Version 1.0.1 vers version 1.0.2 modifier

Version 1.0.2 vers version 1.0.3 modifier

Version 1.0.3 vers version 1.0.4 modifier

Version 1.0.4 vers version 1.0.5 modifier

Version 1.0.5 vers version 1.0.6 modifier

Version 1.0.6 vers version 1.1.0 modifier

Version 1.1.0 vers version 1.2.0 modifier

Version 1.2.0 vers version 1.2.1 modifier

Version 1.2.1 vers version 2.0.0 modifier

Version 2.4.x vers version 3.0.0 modifier

Version 3.0.0 vers version 4.0.1 modifier

  • Version 4.0.1 ; nom de code : Yin Yang Tau   
  • Statut :   : Déployée sur site web perso.
  •   Analyse des finances des groupements de communes

Pour le futur modifier

  • Utilisateur:Arcyon37 6 juin 2015 à 11:45 :
    •     Attendre Est-il possible d'imaginer un système ou chacun pourrait, à partir d'une liste de données financières, sélectionner par exemple en cochant des cases pour générer automatiquement les tableaux et les graphiques des critères retenus ?

Articles en relation avec le sujet modifier

Notes et références modifier