# Comment lire le portail

::::summary{title="En bref" audience="Toute personne qui arrive sur le portail." reading="4 min" updated="10 novembre 2026"}

Ce que contient chaque onglet, comment lire une page et par où commencer selon votre rôle.

:::details[Données utilisées]
Aucune : cette page décrit le portail lui-même.
:::

::::

<ARetenir illustration="/matching/illustrations/mascotte.svg" titre="Ce qu'il faut retenir">
- Huit onglets, de gauche à droite : du cadre du hackathon jusqu'aux présentations.
- Chaque page a les mêmes repères : « En bref » en haut, « Comment lire » sous chaque graphique, « Limites » en bas.
- Un sigle inconnu ? Survolez-le, ou ouvrez le [glossaire](/hackathon/glossaire).
</ARetenir>

## Les huit onglets

<FeatureGrid cols={4}>
  <FeatureCard icon="mountain" title="Hackathon" description="Le cadre, les experts, les cinq problématiques et six propositions de projets." href="/hackathon" />
  <FeatureCard icon="database" title="Données" description="Les 748 fichiers du SSP Cloud, 76 sources publiques, les sites, les analyses et les codes d'accès." href="/donnees-ssp" />
  <FeatureCard icon="trending-up" title="DataViz" description="Les données croisées, problématique par problématique, en cartes et en graphiques." href="/dataviz" />
  <FeatureCard icon="git-compare" title="Matching" description="Comment l'application propose un autre lieu quand le premier est très fréquenté." href="/matching" />
  <FeatureCard icon="smartphone" title="Plutôt là" description="Le prototype d'application mobile : écrans, données, calculs et limites." href="/plutotla" />
  <FeatureCard icon="puzzle" title="Widgets" description="L'affluence prévue, affichée dans la page d'un office de tourisme." href="/widgets" />
  <FeatureCard icon="megaphone" title="Médias" description="Les supports prêts à publier : réseaux sociaux, affiches, kit des partenaires." href="/media" />
  <FeatureCard icon="presentation" title="Présentations" description="Les présentations du hackathon, à projeter en plein écran." href="/presentations" />
</FeatureGrid>

On part en général d'une [problématique](/problematiques). On regarde ensuite ce que montrent les données (DataViz), puis on descend dans les fichiers (Données). Plutôt là, Matching et Widgets montrent un exemple de réponse à la problématique P1.

## Comment lire une page

Quatre repères reviennent sur toutes les pages. Les voici tels qu'ils s'affichent.

**1. En haut, « En bref »** : pour qui est la page, ce qu'elle contient, la date de mise à jour et la durée de lecture. Les données utilisées sont repliées.

::::summary{title="En bref (exemple)" audience="Équipes qui travaillent sur P2." reading="3 min" updated="10 novembre 2026"}

Les mois et les jours où les sentiers des espaces naturels sensibles sont les plus fréquentés.

:::details[Données utilisées]
Compteurs des espaces naturels sensibles (bucket SSP Cloud).
:::

::::

**2. « Ce qu'il faut retenir »** : trois constats, avant le détail.

<ARetenir titre="Ce qu'il faut retenir (exemple)">
- Un constat chiffré, tiré du graphique principal de la page.
- Un deuxième constat.
- Ce que cela change pour la problématique.
</ARetenir>

**3. Sous chaque graphique ou tableau, « Comment lire »** : une ligne visible donne la source ; le détail (axes, couleurs, unité) s'ouvre d'un clic.

:::howto{caption="Source : compteurs des espaces naturels sensibles · (déduit)"}
Chaque barre est un mois ; sa hauteur est le nombre moyen de passages par jour.
:::

**4. En bas, « Limites »** : ce que les données ne permettent pas de dire. Les trois plus importantes sont visibles. Les limites communes à tout le portail sont réunies sur une seule page : [Limites des données](/dataviz/limites-des-donnees).

:::limits{title="À garder en tête (exemple)" link="/dataviz/limites-des-donnees"}
- Un compteur compte des passages, pas des personnes.
- Un compteur en panne laisse des jours vides.
- Tous les sentiers n'ont pas de compteur.
:::

### Les autres repères

| Repère | Ce qu'il signifie |
|---|---|
| **(déduit)** | Valeur calculée ou estimée par le portail, pas lue telle quelle. À vérifier avant de la citer. |
| **interprété** | Lecture ou proposition du portail, pas un fait mesuré. |
| <Src n={26} /> | Une source supplémentaire : titre au survol, fiche au clic. |
| <Problems ids="P2" labels={false} /> | La problématique concernée ; le clic ouvre sa page. |
| <Terme mot="ENS" /> | Mot défini dans le [glossaire](/hackathon/glossaire) : définition au survol ou au clavier. |
| Source : `dossier/fichier` | Chemin du fichier dans le bucket du SSP Cloud ; voir [Données SSP Cloud](/donnees-ssp). |

:::howto{caption="Ces repères ont le même sens sur toutes les pages."}
:::

## Par où commencer, selon votre rôle

<Parcours
  titre="Data scientist"
  etapes={[
    { titre: "Choisir une problématique", lien: "/problematiques", duree: "10 min", description: "Les cinq questions et leurs cas d'usage." },
    { titre: "Voir les données croisées", lien: "/dataviz", duree: "15 min", description: "Les rapprochements déjà faits, par problématique." },
    { titre: "Ouvrir les fichiers", lien: "/donnees-ssp", duree: "30 min", description: "Colonnes, volumes et périodes des 748 fichiers." },
    { titre: "Éviter les pièges", lien: "/sources/pieges", duree: "10 min", description: "Les erreurs relevées dans les sources." },
  ]}
/>

<Parcours
  titre="Développeur"
  etapes={[
    { titre: "SSP Cloud et dépôt", lien: "/hackathon/deposer-son-code", duree: "10 min", description: "Stockage, clés d'accès, branche de l'équipe." },
    { titre: "Les scripts d'accès", lien: "/codes", duree: "15 min", description: "Un script par API, avec son authentification." },
    { titre: "Les fonds de carte", lien: "/codes/ign", duree: "15 min", description: "BD TOPO, géocodage, services de l'IGN." },
    { titre: "Outils d'accès aux données", lien: "/sources/outils-d-acces-aux-donnees", duree: "15 min", description: "API data.gouv.fr, exports Parquet, API Géo." },
  ]}
/>

<Parcours
  titre="Chargé de mission tourisme"
  etapes={[
    { titre: "Les problématiques", lien: "/problematiques", duree: "10 min", description: "Ce que les territoires attendent du hackathon." },
    { titre: "La fiche d'un site connu", lien: "/sites", duree: "15 min", description: "Lac de Paladru, Bastille, Les 2 Alpes…" },
    { titre: "La grille Optimum touristique", lien: "/sites/optimum-touristique", duree: "10 min", description: "Trois dimensions pour juger d'un niveau de fréquentation." },
    { titre: "Les visualisations", lien: "/dataviz", duree: "15 min", description: "Les croisements de données, lisibles sans code." },
  ]}
/>

<Parcours
  titre="Jury"
  etapes={[
    { titre: "Le cadre du hackathon", lien: "/hackathon", duree: "5 min", description: "Organisateur, territoire, ressources." },
    { titre: "Les cinq problématiques", lien: "/problematiques", duree: "10 min", description: "Les questions auxquelles les équipes ont répondu." },
    { titre: "Les données disponibles", lien: "/hackathon/donnees-fournies", duree: "5 min", description: "Pour juger de ce qui était faisable." },
    { titre: "Ce qui a été produit", lien: "/hackathon/etat-du-projet", duree: "3 min", description: "L'état du projet après le hackathon." },
    { titre: "Plutôt là en 3 minutes", lien: "/presentations/plutotla-flash", duree: "3 min", description: "L'application présentée au jury." },
  ]}
/>

:::howto{caption="Chaque parcours se lit de haut en bas ; la durée est indicative."}
:::

## Limites

:::limits{link="/dataviz/limites-des-donnees"}
- Les durées de lecture sont indicatives : elles supposent une lecture rapide, sans manipuler les données.
- Quelques pages produites par script n'ont pas encore tous les repères décrits ici.
- Les exemples de cette page sont fictifs : ils montrent la forme des repères, pas des résultats.
:::
