Tableau de bord des indicateurs territoriaux
Présentation
Bienvenue dans ce projet visant à faciliter la création de tableaux de bord territoriaux interactifs à partir de données d’indicateurs. Ce dispositif est composé de deux briques complémentaires :
1. territories_dashboard_lib
Une librairie Django réutilisable, contenant des applications modulaires pour afficher rapidement un tableau de bord d'indicateurs territoriaux. Elle permet d’analyser des données à différentes mailles géographiques : nationale, régionale, départementale, et communale.
Elle comprend des fonctionnalités prêtes à l'emploi pour visualiser des données sur des thématiques comme la mobilité durable, la rénovation énergétique ou d'autres indicateurs liés au développement territorial.
2. territories_dashboard_template
Un template de projet Django clef en main, conçu pour permettre à des équipes techniques de démarrer rapidement leur propre tableau de bord. Ce template utilise la librairie territories_dashboard_lib comme fondation.
Les utilisateurs peuvent cloner ce dépôt, l’adapter à leurs besoins, et configurer leur tableau de bord directement depuis l’interface d’administration (titre, organisme, pages de contenu statique, indicateurs à afficher...).
Le template constitue un point de départ standard, mais n’impose aucune restriction technique en dehors du choix de Django comme framework. Les développeurs sont libres d'étendre ou de modifier les composants selon leurs besoins.
Prérequis
Pour utiliser la librairie ou le template, vous devez disposer de :
- Une base de données PostgreSQL contenant les données des indicateurs territoriaux.
- Une capacité à déployer une application Django (hébergement, serveur web, etc.).
Pour obtenir des informations détaillées sur les prérequis techniques ou les données :
- Marina Ribeiro – Directrice de projet Mission Connaissance
marina.ribeiro@developpement-durable.gouv.fr - Louise Columelli – ECOLAB
louise.columelli@developpement-durable.gouv.fr - Olivier Rousseau – Expert données
olivier.rousseau@i-carre.net - Bastien – Développeur web
bastien@prune.sh
Exemples de projets utilisant ce dispositif
L’objectif de ce projet est d’encourager la réutilisation et l’essaimage de nouveaux tableaux de bord territoriaux, en mettant à disposition un socle technique commun, facilement adaptable et extensible.
Structure de la librairie
La librairie est composée de plusieurs applications Django indépendantes et complémentaires :
website_lib
Contient le code principal d’affichage des pages du tableau de bord :
- Templates HTML Django : dans
website_lib/templates, organisés par page. - Fichiers statiques (JS, CSS) : dans
website_lib/static. Le JS est modulaire grâce à l’extension.mjs. - Vues Django : dans
website_lib/views, associées aux templates et fichiers statiques.
tracking_lib
Gère le tracking backend : enregistrement en base de données des visites de pages, avec leurs paramètres (indicateur sélectionné, territoire, etc.) pour permettre des analyses d’usage.
superset_lib
Permet d’intégrer des dashboards Superset dans les pages du site.
Superset est un outil permettant à des utilisateurs non techniques de construire des visualisations depuis une base de données.
geo_lib
Permet d’ajouter des couches géographiques personnalisées (points, lignes, polygones) à la carte :
- Points : ex. stationnements vélo.
- Lignes : ex. pistes cyclables.
- Polygones : ex. zones ZFE.
indicators_lib
Contient le code pour l’accès et la requête des données d’indicateurs dans la base PostgreSQL dédiée.
Composants React
Certaines visualisations complexes sont développées en React (ex. cartes interactives, diagrammes de Sankey).
- Les composants sont dans
website_lib/react-components/. - Le bundling est effectué via Webpack
- Les composants React sont ensuite inclus dans les templates Django.
cd website_lib/react-components && npm install && npm run webpack
Installation
La librairie est publiée sur PyPI. Elle s’installe dans un projet Django via le package manager uv :
uv add territories_dashboard_lib
Figer la version en production
Pour éviter les mises à jour inattendues, il est conseillé de figer la version dans le fichier pyproject.toml :
# Par exemple :
territories_dashboard_lib == 1.0.3
Développement local
Pour tester une version locale de la librairie (ex : modifications en cours) :
uv add --editable ~/territories-dashboard/territories-dashboard-lib
Publication PyPI
Pour builder la librairie avant publication :
uv run python -m build
Pour déployer sur PyPI, vous devez :
-
Avoir un compte PyPI.
-
Être membre du projet sur PyPI.
-
Lancer :
uv run twine upload dist/*
3 maintainers
Metadata
3 maintainers
Release files for territories-dashboard-lib 1.2.23
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| territories_dashboard_lib-1.2.23.tar.gz | 5.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| territories_dashboard_lib-1.2.23-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.3 MB
Release files / territories_dashboard_lib-1.2.23.tar.gz
| Download URL | territories_dashboard_lib-1.2.23.tar.gz |
|---|---|
| Size | 5.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
64a5f404d316c322b404bcbf4e948287068217be8ec51ef0b7462930c33a76f0
|
|
BLAKE2b-256 checksum How to use checksums |
40b9f079806a02a5a3e5450eb2d5b113ba1c873371e618ba3ed13f04d533be91
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.1
|
Release files / territories_dashboard_lib-1.2.23-py3-none-any.whl
| Download URL | territories_dashboard_lib-1.2.23-py3-none-any.whl |
|---|---|
| Size | 5.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
da88e7032a57a7b0bd389b4d9bf678f0d583ece42ad355c8f1adc65b5b1a7431
|
|
BLAKE2b-256 checksum How to use checksums |
4b7d28627b7b09046fb83501d2d3f1e76bf4276d33d6f0d1cc65f478db49d446
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.1
|
