maj

parcoursup/README.md

@@ -4,7 +4,12 @@ Application web permettant de consulter les données ouvertes de Parcoursup pour
 
 Ce projet a été réalisé dans le cadre des modules R4.01 et R4.A.10.
 
+## 🌐 Démo en ligne
+
+👉 **[https://dwarves.iut-fbleau.fr/~yolou/parcoursup2/public-html2/parcoursup/#/](https://dwarves.iut-fbleau.fr/~yolou/parcoursup2/public-html2/parcoursup/#/)**
+
 ## 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)
@@ -20,12 +25,12 @@ L'application est construite de façon déclarative et modulaire avec le framewo
 
 ### 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.
+* **Fonction :** Gère le routage principal, 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 :** 
+* **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`
+  * Charge `<comparateur-view>` sur la route `/comparateur`
 
 ### 2. `components/search-bar.riot`
 * **Fonction :** Moteur de recherche et filtres.
@@ -34,7 +39,7 @@ C'est le chef d'orchestre de l'application.
 
 ### 3. `components/result-list.riot`
 * **Fonction :** Affiche la liste paginée des formations correspondant à la recherche.
-* **Props :** 
+* **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
@@ -44,7 +49,7 @@ C'est le chef d'orchestre de l'application.
 
 ### 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 :** 
+* **Props :**
   * `formation` : l'objet complet de la formation courante.
 * **Sorties (Events) :**
   * `onback()` : Demande de retour à l'écran de recherche principal.
@@ -52,17 +57,26 @@ C'est le chef d'orchestre de l'application.
 
 ### 5. `components/map-view.riot`
 * **Fonction :** Affiche une carte interactive Leaflet.
-* **Props :** 
+* **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 :** 
+* **Props :**
   * `user` (objet utilisateur Firebase passé par `<app>`).
-* **Sorties (Events) :** 
+* **Sorties (Events) :**
   * `onauth()` et `onlogout()` pour notifier `<app>` des changements de session, ce qui déclenche la synchronisation de la sélection `localStorage` <-> `Firestore`.
 
+### 7. `components/comparateur.riot`
+* **Fonction :** Comparateur de formations permettant à l'utilisateur d'estimer ses chances d'admission selon son profil (note, série de bac).
+* **Props :**
+  * `formations` : le tableau des formations sélectionnées (passé par `<app>`).
+  * `onretirer(id)` : callback pour retirer une formation de la sélection.
+  * `onvider()` : callback pour vider toute la sélection.
+* **État interne (State) :** Gère `note`, `serie` et `sortBy` — paramètres propres à l'affichage du comparateur, sans impacter le reste de l'app.
+* **Logique :** Calcule un score sur 100 pour chaque formation (taux d'accès + note + proportion de la série) via `calculerScore()`, puis retourne une estimation textuelle (`"Favorable"`, `"Possible"`, etc.).
+
 ---
 
 ## Modèle de Données et API