territories-dashboard-lib 0.1.3__py3-none-any.whl → 0.1.5__py3-none-any.whl

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/layout/footer.html

@@ -1,5 +1,5 @@
 <footer role="contentinfo" id="page-footer">
-    {% if view_name != "website:superset" %}
+    {% if view_name != "website:superset" and main_conf.show_footer_contact_banner and main_conf.newsletter_link and main_conf.contact_email %}
         <div class="fr-follow fr-pt-8w">
             <h2 class="fr-sr-only">Contact</h2>
             <div class="fr-container">

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/comparaison/[theme]/components/histogram.html

@@ -0,0 +1,28 @@
+{% load other_filters %}
+
+<section class="fr-accordion tdbmd-indicator-accordion tdbmd-indicator-accordion-comparison">
+    <h3 class="fr-accordion__title">
+        <button
+            class="fr-accordion__btn border-top"
+            aria-expanded="false"
+            aria-controls="accordion-{{indicator.id}}"
+            aria-label="Répartition des valeurs - {{ indicator.title }}"
+        >
+            Répartition des valeurs
+        </button>
+    </h3>
+    <div
+        class="fr-collapse"
+        id="accordion-{{indicator.id}}"
+    >
+        {% include "territories_dashboard_lib/website/pages/indicators/components/title.html" with title="Répartition des territoires selon les valeurs de l'indicateur (graphique en “miroir”)" key=indicator.name h4=True text="Survolez les barres du graphique pour afficher le nombre de territoires dans chaque classe de valeurs (le nom des territoires s'affiche s'il y a moins de 6 territoires). Le graphique du haut correspond à la répartition pour le territoire 1 sélectionné, alors que le graphique du bas (en “miroir”) correspond à la répartition pour le territoire 2 de comparaison. Précisions : Ce graphique varie selon la maille sélectionnée." %}
+        {% if params|should_mesh_analysis:indicator %}
+            <div style="width: 100%; height: 500px; margin-top: -1rem;">
+                <canvas class="comparison-chart" aria-describedby="{{indicator.id}}comparison-histogram-export-csv"></canvas>
+            </div>
+            {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Comparaison de la répartition" route="comparison-histogram" indicator=indicator pattern="show" tracking_objet="comparison-histogram" %}
+        {% else %}
+            <div style="margin-top: 16px;">L'histogramme de comparaison n'est pas disponible à la maille sélectionnée.</div>
+        {% endif %}
+    </div>
+</section>

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/comparaison/[theme]/components/indicateur-card.html

@@ -16,32 +16,11 @@
         <div style="height: 300px;">
             <canvas class="history-chart" aria-describedby="{{indicator.id}}values-export-csv"></canvas>
         </div>
-        {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Historique comparaison" route="values" indicator=indicator pattern="show" %}
+        {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Historique comparaison" route="values" indicator=indicator pattern="show" tracking_objet="comparaison-historique" %}
 	{% endhtmlparam %}
 
     {% htmlparam footer %}
-        <section class="fr-accordion tdbmd-indicator-accordion tdbmd-indicator-accordion-comparison">
-            <h3 class="fr-accordion__title">
-                <button
-                    class="fr-accordion__btn border-top"
-                    aria-expanded="false"
-                    aria-controls="accordion-{{indicator.id}}"
-                    aria-label="Répartition des valeurs - {{ indicator.title }}"
-                >
-                    Répartition des valeurs
-                </button>
-            </h3>
-            <div
-                class="fr-collapse"
-                id="accordion-{{indicator.id}}"
-            >
-                {% include "territories_dashboard_lib/website/pages/indicators/components/title.html" with title="Répartition des territoires selon les valeurs de l'indicateur (graphique en “miroir”)" key=indicator.name h4=True text="Survolez les barres du graphique pour afficher le nombre de territoires dans chaque classe de valeurs (le nom des territoires s'affiche s'il y a moins de 6 territoires). Le graphique du haut correspond à la répartition pour le territoire 1 sélectionné, alors que le graphique du bas (en “miroir”) correspond à la répartition pour le territoire 2 de comparaison. Précisions : Ce graphique varie selon la maille sélectionnée." %}
-                <div style="width: 100%; height: 500px; margin-top: -1rem;">
-                    <canvas class="comparison-chart" aria-describedby="{{indicator.id}}comparison-histogram-export-csv"></canvas>
-                </div>
-                {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Comparaison de la répartition" route="comparison-histogram" indicator=indicator pattern="show" %}
-            </div>
-        </section>
+        {% include "./histogram.html" %}
     {% endhtmlparam %}
 
     {% include "territories_dashboard_lib/website/pages/indicators/components/indicator-card.html" with indicator=indicator %}

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html

@@ -2,6 +2,7 @@
     <button
         aria-label="Exporter le graphique {{ name }} en png{% if not one_indicator %} - {{ indicator.title }}{% endif %}"
         data-title="{{ name }}"
+        data-trackingobjet="{{ tracking_objet }}"
         data-type="export-png"
         class="fr-btn fr-btn--secondary fr-btn--sm fr-icon-image-line fr-btn--icon-right btn-download">
         Exporter le graphique en png

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/details/components/histogram.html

@@ -0,0 +1,21 @@
+{% load other_filters %}
+
+{% if params.mesh != params.territory_mesh and params|should_mesh_analysis:indicator %}
+    <div id="histogramContainer" class="subtheme">
+        <div class="fr-px-md-4w fr-px-2w fr-py-2w">
+            {% include "territories_dashboard_lib/website/pages/indicators/components/title.html" with title="Répartition des territoires selon les valeurs de l'indicateur" key="repartition" text="Le nom des territoires s'affiche au survol ds'il y a moins de 6 territoires. Précisions : Ce graphique varie selon la maille sélectionnée." %}
+            <div style="width:100%; height: 400px;">
+                <canvas id="histogramChart" aria-describedby="histogram-export-csv"></canvas>
+            </div>
+            {% include "./filters-reminder.html" %}
+        </div>
+        {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Répartition par valeurs" route="histogram" one_indicator=True tracking_objet="repartition-valeurs" %}
+    </div>
+{% else %}
+    <div class="subtheme">
+        <div class="fr-px-md-4w fr-px-2w fr-py-2w">
+            <h3 class="fr-mt-4w">Répartition par territoires</h3>
+            <div>La répartition n'est pas disponible pour la maille sélectionnée.</div>
+        </div>
+    </div>
+{% endif %}

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/details/components/map.html

@@ -0,0 +1,10 @@
+{% load other_filters %}
+
+<div class="subtheme fr-px-md-4w fr-p-2w">
+    {% if params|should_mesh_analysis:indicator %}
+        <div id="indicator-map"></div>
+    {% else %}
+        <h3 class="fr-mt-4w">Carte</h3>
+        <div>La carte n'est pas disponible pour la maille sélectionnée.</div>
+    {% endif %}
+</div>

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/details/components/proportions.html

@@ -0,0 +1,21 @@
+{% load other_filters %}
+
+{% if indicator.filters %}
+    <div class="subtheme">
+        {% if params|should_mesh_analysis:indicator %}
+            <div class="fr-px-md-4w fr-px-2w fr-py-2w">
+                {% include "territories_dashboard_lib/website/pages/indicators/components/title.html" with title="Répartition des valeurs de l'indicateur selon ses modalités" key="proportions" text="Survolez le graphique pour afficher les valeurs de l'indicateur pour chaque modalité. Cliquez sur les catégories de la légende pour afficher/masquer des modalités." %}
+                <div style="width:100%; height: auto;">
+                    <canvas id="proportionsChart" aria-describedby="proportions-export-csv"></canvas>
+                </div>
+                {% include "./filters-reminder.html" %}
+            </div>
+            {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Répartition par dimensions" route="proportions" pattern="show" one_indicator=True tracking_objet="repartition-dimension" %}
+        {% else %}
+            <div class="fr-px-md-4w fr-px-2w fr-py-2w">
+                <h3 class="fr-mt-4w">Proportions</h3>
+                <div>Le graphique de proporition n'est pas disponible pour la maille sélectionnée.</div>
+            </div>
+        {% endif %}
+    </div>
+{% endif %}

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/details/components/sankey.html

@@ -0,0 +1,17 @@
+{% load other_filters %}
+
+{% if indicator.flows_db_table_prefix %}
+    <div class="subtheme">
+        <div class="fr-px-md-4w fr-px-2w fr-py-2w">
+            {% include "territories_dashboard_lib/website/pages/indicators/components/title.html" with title="Top 10 des flux par origine-destination (diagramme de Sankey)" key="sankey" text="Survolez les flux sur le graphique pour afficher les valeurs. Vous pouvez filtrer selon le mode de déplacement en sélectionnant les filtres disponibles sous le titre du graphique. Précisions : Seuls les flux entre les 10 territoires qui génèrent le plus de flux depuis/vers le territoire sélectionné sont affichés." %}
+            <div style="width:100%; height: auto;">
+            <div id="sankey-graph"></div>
+            </div>
+        </div>
+        <button
+            data-title="Sankey"
+            class="fr-btn fr-btn--secondary fr-btn--sm fr-icon-line-chart-line fr-btn--icon-right fr-mx-4w fr-mt-4w fr-mb-4w btn-download">
+            <span>Exporter le graphique</span>
+        </button>
+    </div>
+{% endif %}

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/details/components/table-flows.html

@@ -0,0 +1,8 @@
+{% if indicator.flows_db_table_prefix %}
+    <div class="subtheme">
+        <div class="fr-px-md-4w fr-px-2w fr-py-2w">
+            <h3 class="fr-mt-4w">Tableau des flux</h3>
+            <div class="data-table" data-source="flows"></div>
+        </div>
+    </div>
+{% endif %}

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/details/components/table-values.html

@@ -0,0 +1,17 @@
+{% load other_filters %}
+
+{% if params|should_mesh_analysis:indicator %}
+    <div class="subtheme" id="values-table-section">
+        <div class="fr-px-md-4w fr-px-2w fr-py-2w">
+            <h3 class="fr-mt-4w">Tableau des valeurs de l'indicateur</h3>
+            <div class="data-table" data-source="indicator"></div>
+        </div>
+    </div>
+{% else %}
+    <div class="subtheme">
+        <div class="fr-px-md-4w fr-px-2w fr-py-2w">
+            <h3 class="fr-mt-4w">Tableau des valeurs de l'indicateur</h3>
+            <div>Le tableau n'est pas disponible pour la maille sélectionnée.</div>
+        </div>
+    </div>
+{% endif %}

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/details/components/top10.html

@@ -0,0 +1,19 @@
+{% load other_filters %}
+
+<div class="subtheme">
+    {% if params.mesh != params.territory_mesh and params|should_mesh_analysis:indicator %}
+        <div class="fr-px-md-4w fr-px-2w fr-py-2w">
+            {% include "territories_dashboard_lib/website/pages/indicators/components/title.html" with title="Top 10 des territoires" key="top10" text="Survolez les graphiques pour afficher les valeurs de l'indicateur pour chaque modalité. Cliquez sur les catégories de la légende pour afficher/masquer des modalités. Précisions : Ce graphique varie selon la maille sélectionnée." %}
+            <div style="width:100%; height: auto;">
+                <canvas id="top10Chart" aria-describedby="top-10-export-csv"></canvas>
+            </div>
+            {% include "./filters-reminder.html" %}
+        </div>
+        {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Top 10" route="top-10" pattern="show" one_indicator=True tracking_objet="top_10" %}
+    {% else %}
+        <div class="fr-px-md-4w fr-px-2w fr-py-2w">
+            <h3 class="fr-mt-4w">Top 10</h3>
+            <div>Le top 10 n'est pas disponible pour la maille sélectionnée.</div>
+        </div>
+    {% endif %}
+</div>

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/details/page.html

@@ -93,70 +93,13 @@
                             {% endfor %}
                     </div>
                 </div>
-                <div class="subtheme fr-px-md-4w fr-p-2w">
-                    <div id="indicator-map"></div>
-                </div>
-                {% if indicator.flows_db_table_prefix %}
-                <div class="subtheme">
-                    <div class="fr-px-md-4w fr-px-2w fr-py-2w">
-                        {% include "territories_dashboard_lib/website/pages/indicators/components/title.html" with title="Top 10 des flux par origine-destination (diagramme de Sankey)" key="sankey" text="Survolez les flux sur le graphique pour afficher les valeurs. Vous pouvez filtrer selon le mode de déplacement en sélectionnant les filtres disponibles sous le titre du graphique. Précisions : Seuls les flux entre les 10 territoires qui génèrent le plus de flux depuis/vers le territoire sélectionné sont affichés." %}
-                        <div style="width:100%; height: auto;">
-                        <div id="sankey-graph"></div>
-                        </div>
-                    </div>
-                    <button
-                        data-title="Sankey"
-                        class="fr-btn fr-btn--secondary fr-btn--sm fr-icon-line-chart-line fr-btn--icon-right fr-mx-4w fr-mt-4w fr-mb-4w btn-download">
-                        <span>Exporter le graphique</span>
-                    </button>
-                </div>
-                {% endif %}
-                {% if indicator.filters %}
-                    <div class="subtheme">
-                        <div class="fr-px-md-4w fr-px-2w fr-py-2w">
-                            {% include "territories_dashboard_lib/website/pages/indicators/components/title.html" with title="Répartition des valeurs de l'indicateur selon ses modalités" key="proportions" text="Survolez le graphique pour afficher les valeurs de l'indicateur pour chaque modalité. Cliquez sur les catégories de la légende pour afficher/masquer des modalités." %}
-                            <div style="width:100%; height: auto;">
-                                <canvas id="proportionsChart" aria-describedby="proportions-export-csv"></canvas>
-                            </div>
-                            {% include "./components/filters-reminder.html" %}
-                        </div>
-                        {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Répartition par dimensions" route="proportions" pattern="show" one_indicator=True %}
-                    </div>
-                {% endif %}
-                <div class="subtheme">
-                    <div class="fr-px-md-4w fr-px-2w fr-py-2w">
-                        {% include "territories_dashboard_lib/website/pages/indicators/components/title.html" with title="Top 10 des territoires" key="top10" text="Survolez les graphiques pour afficher les valeurs de l'indicateur pour chaque modalité. Cliquez sur les catégories de la légende pour afficher/masquer des modalités. Précisions : Ce graphique varie selon la maille sélectionnée." %}
-                        <div style="width:100%; height: auto;">
-                            <canvas id="top10Chart" aria-describedby="top-10-export-csv"></canvas>
-                        </div>
-                        {% include "./components/filters-reminder.html" %}
-                    </div>
-                    {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Top 10" route="top-10" pattern="show" one_indicator=True %}
-                </div>
-                <div id="histogramContainer" class="subtheme">
-                    <div class="fr-px-md-4w fr-px-2w fr-py-2w">
-                        {% include "territories_dashboard_lib/website/pages/indicators/components/title.html" with title="Répartition des territoires selon les valeurs de l'indicateur" key="repartition" text="Le nom des territoires s'affiche au survol ds'il y a moins de 6 territoires. Précisions : Ce graphique varie selon la maille sélectionnée." %}
-                        <div style="width:100%; height: 400px;">
-                            <canvas id="histogramChart" aria-describedby="histogram-export-csv"></canvas>
-                        </div>
-                        {% include "./components/filters-reminder.html" %}
-                    </div>
-                    {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Répartition par valeurs" route="histogram" one_indicator=True %}
-                </div>
-                <div class="subtheme" id="values-table-section">
-                    <div class="fr-px-md-4w fr-px-2w fr-py-2w">
-                        <h3 class="fr-mt-4w">Tableau des valeurs de l'indicateur</h3>
-                        <div class="data-table" data-source="indicator"></div>
-                    </div>
-                </div>
-                {% if indicator.flows_db_table_prefix %}
-                <div class="subtheme">
-                    <div class="fr-px-md-4w fr-px-2w fr-py-2w">
-                        <h3 class="fr-mt-4w">Tableau des flux</h3>
-                        <div class="data-table" data-source="flows"></div>
-                    </div>
-                </div>
-                {% endif %}
+                {% include "./components/map.html" %}
+                {% include "./components/sankey.html" %}
+                {% include "./components/proportions.html" %}
+                {% include "./components/top10.html" %}
+                {% include "./components/histogram.html" %}
+                {% include "./components/table-values.html" %}
+                {% include "./components/table-flows.html" %}
             </div>
             {% include "territories_dashboard_lib/website/pages/indicators/components/side_panel_geo.html" %}
             {% include "territories_dashboard_lib/website/pages/indicators/components/side_panel_methodo.html" %}

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/themes/components/indicateur-card.html

@@ -33,36 +33,33 @@
                 </div>
             </div>
         </div>
-        <section class="tdbmd-indicator-card__comparisons fr-grid-row fr-grid-row--gutters">
-            <h4 class="fr-sr-only">Statistiques</h4>
-            {% include "./extremum.html" with title="Minimum" prefix="min" %}
-            {% include "./extremum.html" with title="Mediane" prefix="med" %}
-            {% include "./extremum.html" with title="Maximum" prefix="max" %}
-        </section>
+        {% include "./stats.html" %}
 	{% endhtmlparam %}
 
     {% htmlparam footer %}
-        <section class="fr-accordion tdbmd-indicator-accordion">
-            <h4 class="fr-accordion__title">
-                <button
-                    class="fr-accordion__btn"
-                    aria-expanded="false"
-                    aria-controls="accordion-{{indicator.id}}"
-                    aria-label="Historique - {{ indicator.title }}"
+        {% if indicator.show_evolution %}
+            <section class="fr-accordion tdbmd-indicator-accordion">
+                <h4 class="fr-accordion__title">
+                    <button
+                        class="fr-accordion__btn"
+                        aria-expanded="false"
+                        aria-controls="accordion-{{indicator.id}}"
+                        aria-label="Historique - {{ indicator.title }}"
+                    >
+                        Historique
+                    </button>
+                </h4>
+                <div
+                    class="fr-collapse"
+                    id="accordion-{{indicator.id}}"
                 >
-                    Historique
-                </button>
-            </h4>
-            <div
-                class="fr-collapse"
-                id="accordion-{{indicator.id}}"
-            >
-                <div style="height: 300px;">
-                    <canvas class="history-chart" aria-describedby="{{indicator.id}}values-export-csv"></canvas>
+                    <div style="height: 300px;">
+                        <canvas class="history-chart" aria-describedby="{{indicator.id}}values-export-csv"></canvas>
+                    </div>
+                    {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Historique" route="values" indicator=indicator no_pb=True tracking_objet="historique" %}
                 </div>
-                {% include "territories_dashboard_lib/website/pages/indicators/components/chart-buttons.html" with name="Historique" route="values" indicator=indicator no_pb=True %}
-            </div>
-        </section>
+            </section>
+        {% endif %}
         <a
             class="fr-btn fr-btn--tertiary fr-icon-external-link-fill fr-btn--icon-right tdbmd-indicator-btn"
             href="/indicateurs/details/{{indicator.name}}/"

territories_dashboard_lib/website_lib/templates/territories_dashboard_lib/website/pages/indicators/themes/components/stats.html

@@ -0,0 +1,12 @@
+{% load other_filters %}
+
+{% if params.mesh != params.territory_mesh and params|should_mesh_analysis:indicator %}
+    <section class="tdbmd-indicator-card__comparisons fr-grid-row fr-grid-row--gutters">
+        <h4 class="fr-sr-only">Statistiques</h4>
+        {% include "./extremum.html" with title="Minimum" prefix="min" %}
+        {% include "./extremum.html" with title="Mediane" prefix="med" %}
+        {% include "./extremum.html" with title="Maximum" prefix="max" %}
+    </section>
+{% else %}
+    <div>Les statistiques ne sont pas disponibles à cette maille.</div>
+{% endif %}

territories_dashboard_lib/website_lib/templatetags/other_filters.py

@@ -1,5 +1,6 @@
 from django import template
 from django.urls import reverse
+from territories_dashboard_lib.indicators_lib.enums import get_all_meshes
 
 register = template.Library()
 
@@ -28,3 +29,10 @@ def indicator_api_urls(indicator_dict):
         )
         for view_name in view_names
     }
+
+
+@register.filter
+def should_mesh_analysis(params, indicator):
+    meshes = get_all_meshes()
+    above_min_mesh = meshes.index(params["mesh"]) <= meshes.index(indicator["min_mesh"])
+    return above_min_mesh

{territories_dashboard_lib-0.1.3.dist-info → territories_dashboard_lib-0.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: territories-dashboard-lib
-Version: 0.1.3
+Version: 0.1.5
 Summary: Librairie pour la visualisation d'indicateurs territoriaux.
 Author-email: Bastien <bastien@prune.sh>
 License: LICENCE OUVERTE 2.0/OPEN LICENCE 2.0
@@ -85,20 +85,122 @@ Classifier: License :: Other/Proprietary License
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 
-# territories-dashboard-lib
+# Tableau de bord des indicateurs territoriaux
 
-**Librairie Python pour créer rapidement un dashboard d'indicateurs territoriaux.**
+## Présentation
 
-Cette librairie permet d’analyser facilement des indicateurs sur un territoire donné, ou bien de se concentrer sur un indicateur spécifique pour une analyse détaillée.
+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 :
 
-## ✨ Fonctionnalités
+### 1. `territories_dashboard_lib`
 
--   Création rapide de dashboards interactifs
--   Vue globale par territoire ou focus par indicateur
--   Pensée pour les projets liés à l’aménagement, à la planification ou à l’analyse territoriale
+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.
 
-## 🔧 Installation
+### 2. `territories_dashboard_template`
 
-```bash
-pip install territories-dashboard-lib
+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
+
+-   [Tableau de bord des mobilités durables](https://mobilite-durable-tdb.din.developpement-durable.gouv.fr)
+-   [Boussole énergétique de la rénovation des logements](https://boussole-renovation.din.developpement-durable.gouv.fr)
+
+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 :
+
+1. Avoir un compte PyPI.
+
+2. Être membre du projet sur PyPI.
+
+3. Lancer : `uv run twine upload dist/*`