# darkennel/dashboardgit architecture

> Architecture diagram of the GitHub repository darkennel/dashboardgit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/darkennel/dashboardgit
- Repository: https://github.com/darkennel/dashboardgit

## Overview

DashboardGit is a web dashboard for exploring SICOVAL land-use and construction data. Users choose a theme and filters, then inspect commune-level map layers and summary tables; the dashboard also provides map, table, and definition exports. The six thematic datasets and their styling, popups, legends, and table callbacks are represented in the theme configuration. The excerpts show the main page invoking calculations and map operations, but do not show the HTML wiring or all initialization details. The repository also contains a standalone permit-to-parcel geometry preparation script; its relationship to dashboard data is not established.

Main entry points: [`js/themesConfig.js`](https://github.com/darkennel/dashboardgit/blob/main/js/themesConfig.js) (Theme configuration), [`js/main.js`](https://github.com/darkennel/dashboardgit/blob/main/js/main.js) (Dashboard workflow), [`js/map.js`](https://github.com/darkennel/dashboardgit/blob/main/js/map.js) (Interactive map), [`js/util.js`](https://github.com/darkennel/dashboardgit/blob/main/js/util.js) (Data utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Dashboard interface"]
  node_main["Dashboard workflow<br/>[main.js]"]
  node_map["Interactive map<br/>[map.js]"]
  node_utilities["Data utilities<br/>[util.js]"]
end

subgraph group_themes["Thematic analysis"]
  node_themes["Theme configuration<br/>[themesConfig.js]"]
  node_calculations["Summary calculations<br/>[calcul.js]"]
end

subgraph group_data["Geospatial data"]
  node_communes["Commune boundaries"]
  node_enaf["ENAF surfaces<br/>[Enaf2022.geojson]"]
  node_effective["Effective consumption"]
  node_built["Effective construction"]
  node_planned["Planned consumption"]
  node_potential["Densification potential"]
  node_permit_tool["Permit geometry preparation<br/>[PermisGeometrie.py]"]
end

node_analyst(("Dashboard user"))
node_osm["OpenStreetMap tiles"]

node_analyst -.->|"selects filters"| node_main
node_main -->|"loads communes"| node_utilities
node_main -->|"selects theme"| node_themes
node_main -->|"updates layers"| node_map
node_main -->|"calculates summaries"| node_calculations
node_themes -->|"configures source"| node_enaf
node_themes -->|"configures source"| node_effective
node_themes -->|"configures source"| node_built
node_themes -->|"configures source"| node_planned
node_themes -->|"configures source"| node_potential
node_map -->|"loads map tiles"| node_osm
node_utilities -.->|"fetches boundaries"| node_communes

click node_main "https://github.com/darkennel/dashboardgit/blob/main/js/main.js"
click node_map "https://github.com/darkennel/dashboardgit/blob/main/js/map.js"
click node_utilities "https://github.com/darkennel/dashboardgit/blob/main/js/util.js"
click node_themes "https://github.com/darkennel/dashboardgit/blob/main/js/themesConfig.js"
click node_calculations "https://github.com/darkennel/dashboardgit/blob/main/js/calcul.js"
click node_communes "https://github.com/darkennel/dashboardgit/blob/main/datageojson/CommunesSico2.geojson"
click node_enaf "https://github.com/darkennel/dashboardgit/blob/main/datageojson/Enaf2022.geojson"
click node_effective "https://github.com/darkennel/dashboardgit/blob/main/datageojson/ConsoEnaf0922vf.geojson"
click node_built "https://github.com/darkennel/dashboardgit/blob/main/datageojson/Sicoval_SCEP_vf.geojson"
click node_planned "https://github.com/darkennel/dashboardgit/blob/main/datageojson/ConsoPlanifieevf.geojson"
click node_potential "https://github.com/darkennel/dashboardgit/blob/main/datageojson/PotentielDensifBrut.geojson"
click node_permit_tool "https://github.com/darkennel/dashboardgit/blob/main/script/PermisGeometrie.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_map,node_utilities,node_analyst toneBlue
class node_themes,node_calculations toneAmber
class node_communes,node_enaf,node_effective,node_built,node_planned,node_potential,node_permit_tool toneMint
class node_osm toneIndigo
```

## Components

### Dashboard interface

- [Dashboard workflow](https://github.com/darkennel/dashboardgit/blob/main/js/main.js): `js/main.js`
- [Interactive map](https://github.com/darkennel/dashboardgit/blob/main/js/map.js): `js/map.js`
- [Data utilities](https://github.com/darkennel/dashboardgit/blob/main/js/util.js): `js/util.js`

### Thematic analysis

- [Theme configuration](https://github.com/darkennel/dashboardgit/blob/main/js/themesConfig.js): `js/themesConfig.js`
- [Summary calculations](https://github.com/darkennel/dashboardgit/blob/main/js/calcul.js): `js/calcul.js`

### Geospatial data

- [Commune boundaries](https://github.com/darkennel/dashboardgit/blob/main/datageojson/CommunesSico2.geojson): `datageojson/CommunesSico2.geojson`
- [ENAF surfaces](https://github.com/darkennel/dashboardgit/blob/main/datageojson/Enaf2022.geojson): `datageojson/Enaf2022.geojson`
- [Effective consumption](https://github.com/darkennel/dashboardgit/blob/main/datageojson/ConsoEnaf0922vf.geojson): `datageojson/ConsoEnaf0922vf.geojson`
- [Effective construction](https://github.com/darkennel/dashboardgit/blob/main/datageojson/Sicoval_SCEP_vf.geojson): `datageojson/Sicoval_SCEP_vf.geojson`
- [Planned consumption](https://github.com/darkennel/dashboardgit/blob/main/datageojson/ConsoPlanifieevf.geojson): `datageojson/ConsoPlanifieevf.geojson`
- [Densification potential](https://github.com/darkennel/dashboardgit/blob/main/datageojson/PotentielDensifBrut.geojson): `datageojson/PotentielDensifBrut.geojson`
- [Permit geometry preparation](https://github.com/darkennel/dashboardgit/blob/main/script/PermisGeometrie.py): `script/PermisGeometrie.py`

### Other components

- **Dashboard user**
- **OpenStreetMap tiles**

## Connections

- Dashboard user → Dashboard workflow: selects filters
- Dashboard workflow → Data utilities: loads communes (evidence: `js/main.js`)
- Dashboard workflow → Theme configuration: selects theme (evidence: `js/main.js`)
- Dashboard workflow → Interactive map: updates layers (evidence: `js/main.js`)
- Dashboard workflow → Summary calculations: calculates summaries (evidence: `js/main.js`)
- Theme configuration → ENAF surfaces: configures source (evidence: `js/themesConfig.js`)
- Theme configuration → Effective consumption: configures source (evidence: `js/themesConfig.js`)
- Theme configuration → Effective construction: configures source (evidence: `js/themesConfig.js`)
- Theme configuration → Planned consumption: configures source (evidence: `js/themesConfig.js`)
- Theme configuration → Densification potential: configures source (evidence: `js/themesConfig.js`)
- Interactive map → OpenStreetMap tiles: loads map tiles (evidence: `js/map.js`)
- Data utilities → Commune boundaries: fetches boundaries
