Apprendre et progresser
Les leçons de « Mon chemin », les points, la série, les pauses, les quêtes et les badges.
Chaque algorithme est décrit avec les données qu’il lit, ses étapes, les valeurs qu’il utilise (avec leur emplacement dans le code), les résultats qu’il affiche et ses limites.
Mon chemin : points, série, pauses, quêtes et badges
Mon chemin propose des leçons d'une minute sur la drépanocytose. Chaque leçon réussie rapporte des points, fait grandir une série de jours, et une unité terminée ouvre un coffre. Les règles sont les mêmes dans le bot et dans l'application, et le serveur corrige les réponses. Une erreur ne coûte jamais rien.
Où tu le vois : Dans le bot : « Mes points et jeux », puis « Mon chemin ». Dans l'application : l'onglet Journal, puis « Mon chemin ». Tu vois ta série, tes pauses, tes quêtes du jour, tes points et tes badges.
Les données lues par l’algorithme
- Tes réponses aux questions d'une leçon (déclaration)
- Le jour de chaque leçon réussie (calcul sur la série ou résumé de la source)
- Tes jours de crise ou d'hospitalisation (pour protéger la série) (calcul sur la série ou résumé de la source)
- Ton suivi du jour (pour la troisième quête) (déclaration)
Le calcul, étape par étape
Les valeurs utilisées
| Nom dans le code | Valeur | Rôle | Où |
|---|---|---|---|
XP_LESSON | 10 | Points d'une leçon réussie pour la première fois | src/trevor/conversation/chemin.py:30 |
XP_PERFECT | 5 | Points de plus pour une première leçon sans aucune erreur | src/trevor/conversation/chemin.py:31 |
XP_CHEST | 20 | Points du coffre d'une unité terminée | src/trevor/conversation/chemin.py:34 |
XP_QUESTS | 10 | Points des trois quêtes du jour faites | src/trevor/conversation/chemin.py:35 |
XP_REVIEW_RIGHT | 1 | Point d'une bonne réponse en révision | src/trevor/conversation/chemin.py:32 |
XP_REVIEW_DAY_CAP | 5 | Plafond des points de révision par jour | src/trevor/conversation/chemin.py:33 |
QUEST_RIGHT_TARGET | 5 | Bonnes réponses visées par la quête du jour | src/trevor/conversation/chemin.py:36 |
FREEZE_EVERY | 7 | Jours de série pour gagner une pause | src/trevor/conversation/chemin.py:37 |
FREEZE_MAX | 2 | Pauses en réserve au plus | src/trevor/conversation/chemin.py:38 |
REVIEW_STEPS | (1, 3, 7) | Jours avant de reposer une question ratée | src/trevor/conversation/chemin.py:39 |
PASS_RATIO | 0.6 | Part de bonnes réponses pour réussir une leçon | src/trevor/conversation/chemin.py:42 |
Les résultats affichés
Pour chaque personne, Trévor suit les leçons faites et les points du chemin (ajoutés à « Mes points » et aux niveaux). Il suit aussi la série, les pauses, les quêtes du jour et les badges.
Un exemple chiffré
Tu réussis la première leçon avec 2 bonnes réponses sur 3 : 10 points. Tu la rejoues sans erreur : 5 points de plus. Tu la rejoues encore : 0 point. Le lendemain, tu fais une leçon : ta série passe à 2. Le jour d'après, tu es hospitalisé(e) : la série tient, sans pause dépensée.
Les limites de cet algorithme
- Les points récompensent le geste d'apprendre. Ils ne dépendent jamais d'une valeur de santé que tu déclares.
- Il n'y a aucun classement entre personnes et aucune récompense en argent.
- Les leçons viennent de cours et de recommandations citées sur chaque carte. Elles sont en cours de relecture par un médecin et ne remplacent pas l'avis de ton équipe de soins.
- L'âge ou la situation ne personnalisent pas encore le chemin : toutes les personnes vivant avec la drépanocytose voient les mêmes unités dans le même ordre.
Code : src/trevor/conversation/chemin.py (complete_lesson, settle, series_length, claim_quests, apply_review, earn_badges), src/trevor/conversation/chemin_screens.py (chemin_context, chemin_complete, chemin_state), data/chemin/drepanocytose.json, data/chemin/badges.json