public-html2/parcoursup

Parcoursup Explorer

Application web permettant de consulter les données ouvertes de Parcoursup pour aider à l'orientation des lycéens.

Ce projet a été réalisé dans le cadre des modules R4.01 et R4.A.10.

Fonctionnalités principales

• Recherche de formations par mots-clés (via l'API OpenData)
• Visualisation cartographique des établissements avec Leaflet
• Consultation détaillée d'une formation (taux d'accès, profil des admis, évolution multi-années)
• Graphiques statistiques intégrés avec Charts.css
• Comparateur de sélection pour estimer ses chances d'admission
• Espace utilisateur connecté avec Firebase Auth et Firestore (persistance avancée)

---

Architecture et Composants (Riot.js)

L'application est construite de façon déclarative et modulaire avec le framework Riot.js (v9) et utilise le routeur officiel @riotjs/route pour la navigation SPA (Single Page Application).

1. app.riot (Composant Racine)

C'est le chef d'orchestre de l'application.

• Fonction : Gère le routage principal (<router>, <route>), l'état global (données de recherche, sélection) et coordonne les autres composants.
• État (State) : Stocke les résultats de recherche (state.results), la formation active (state.selected), la sélection pour comparaison (state.selectedFormations), et l'utilisateur connecté (state.user).
• Enfants :
  • Charge <search-bar>, <map-view>, <result-list> sur la route /
  • Charge <detail-view> sur la route /formation/:id
  • Gère seule la route /comparateur

2. components/search-bar.riot

• Fonction : Moteur de recherche et filtres.
• Entrées : L'utilisateur tape sa requête (mot clé) et peut appliquer des filtres avancés (filière, sélectivité, région...).
• Sorties : Déclenche l'événement onsearch qui remonte jusqu'à <app> pour lancer la requête API (lancerRecherche).

3. components/result-list.riot

• Fonction : Affiche la liste paginée des formations correspondant à la recherche.
• Props :
  • results : tableau des données renvoyées par l'API
  • loading : booléen pour l'état d'attente
  • hasSearched : détermine si la liste doit s'afficher
• Sorties (Events) :
  • ondetail(index) : L'application navigue vers la vue détaillée d'une formation.
  • onselect(index) : Ajoute la formation au tableau "Comparateur".

4. components/detail-view.riot

• Fonction : Affiche une fiche complète de la formation sélectionnée avec statistiques approfondies et graphiques via Charts.css.
• Props :
  • formation : l'objet complet de la formation courante.
• Sorties (Events) :
  • onback() : Demande de retour à l'écran de recherche principal.
• Interactions : Fait un appel API supplémentaire (via window.chargerHistoriqueFormation) pour récupérer l'historique sur 6 ans depuis l'API Parcoursup.

5. components/map-view.riot

• Fonction : Affiche une carte interactive Leaflet.
• Props :
  • results : La liste courante des formations de la vue recherche.
• Interactions : Instancie Leaflet dans onMounted, place les marqueurs sur carte selon les coordonnées latitude/longitude récupérées, et se redessine automatiquement avec onUpdated(). Fournit également une API window globale (window.mapFocus) que result-list utilise pour recentrer la carte.

6. components/auth-panel.riot

• Fonction : Panneau de connexion / inscription de l'utilisateur (Bonus Firebase).
• Props :
  • user (objet utilisateur Firebase passé par <app>).
• Sorties (Events) :
  • onauth() et onlogout() pour notifier <app> des changements de session, ce qui déclenche la synchronisation de la sélection localStorage <-> Firestore.

---

Modèle de Données et API

api.js (Modèle de communication HTTP)

Contient les modules d'appel réseau fetch.

• chargerFormations() : Requete paginée avec filtres croisés vers l'API Data ESR.
• chargerHistoriqueFormation() : Requete intelligente multi-datasets (2020-2025) ciblant le code UAI d'un établissement précis pour en extraire l'historique d'admission.

formation.js (Modèle Métier)

• Fonction : Isoler et abstraire la complexité du schéma JSON renvoyé par l'API Parcoursup.
• Transforme brut.acc_tot ou brut.lib_for_voe_ins en un objet lisible clair pour les composants (ex: formation.admis ou formation.nom), et y précalcule certains champs de base (comme le tauxAcces).

firebase.js (Service Backend As a Service)

• Gère l'authentification (Emai/Password) avec firebase-auth.
• Gère la persistance cloud de la sélection de vœux dans users/{uid} via firebase-firestore.

Routing (Hash Router)

L'application utilise un système de routage manuel basé sur l'API native window.location.hash :

• Écoute de l'événement natif hashchange dans app.riot.
• Routage conditionnel géré par la fonction gererRoute() (#/, #/formation/:id, #/comparateur).
• Affichage conditionnel des composants via les directives natives if={ state.view === ... }.