Grades

Écrans : carte Grades d'un curriculum (/progression/:id), Système de grades (/progression/:id/grades), Progression d'un élève (/students/:id/progression), bloc Progression de la fiche d'un élève, vue Progression de la feuille de présence. Qui : le responsable configure le système de grades et remet les grades. Le responsable et l'instructeur ajoutent des barrettes. Tout le monde voit les grades, les conditions et l'historique.

Les grades (ceintures, sashes, cordes, kyu, dan, gup…) sont entièrement facultatifs. Une école sans système de grades ne voit rien de nouveau, sauf la carte Grades d'un curriculum, qui propose d'en ajouter un. Le suivi par éléments (Appris / Validé) fonctionne avec ou sans grades (voir l'article Progression).

Un système de grades par curriculum

Chaque curriculum (une discipline, ex. « Kung-fu ») peut avoir zéro ou un système de grades. Les élèves concernés sont ceux qui suivent ce curriculum (par leurs groupes, ou ajoutés à la main).
Une école qui ne veut que des grades, sans liste de formes, crée un curriculum sans éléments (ex. « Karaté ») et lui donne un système.
Un système est fait de séries (ex. « Kyu », « Dan ») qui contiennent des grades dans l'ordre. Une série peut être un parcours à part (badge Parcours, ex. « Demi-ceintures enfants ») : elle n'est pas sur la ligne principale (les autres séries, dans l'ordre).
Un grade a : un nom (1 à 120 caractères); une apparence : Une couleur, Deux couleurs (moitié-moitié), Avec bande (une bande d'une autre couleur au centre) ou Aucune (aucune distinction visible, ceinture en pointillé); des couleurs choisies dans une palette de 13 (blanche, jaune, orange, verte, bleue, violette, brune, noire, rouge, grise, argent, or, corail); un nombre maximal de barrettes (0 à 10); des conditions facultatives : âge minimum (0 à 99 ans), délai en mois depuis le grade précédent (0 à 600), présences minimales depuis le grade précédent (0 à 9 999).
Façons d'obtenir un grade : une liste propre au système (au plus 10, de 60 caractères au plus, ex. « Examen interne », « Batizado »), proposée à chaque remise.

Créer le système (responsable)

Ouvrir Progression (menu), puis le curriculum.
Dans la carte Grades, toucher Ajouter un système de grades.
Choisir un gabarit ou Partir de zéro (une série « Grades » vide). Le message « Système de grades créé » s'affiche, avec Annuler (environ 7 secondes) : un gabarit touché par erreur repart à la corbeille et la liste des gabarits réapparaît.

Les 10 gabarits : Sashes kung-fu, Duan wei, Kyu et dan générique, Judo (Judo Canada), Aïkido (Aikikai), Jiu-jitsu brésilien (IBJJF), Capoeira, Iaido (ZNKR), Taekwondo WT, Taekwondo ITF. Chacun montre ses ceintures, son nombre de grades par série et une phrase d'aide. Le gabarit est créé dans la langue de l'école. C'est un point de départ : noms, couleurs, barrettes, conditions et ordre se modifient ensuite. Les noms d'organisations décrivent l'usage du gabarit; Martialnote n'est affilié à aucune fédération et ne garantit pas que le gabarit suit ses règles à jour.

Modifier le système (responsable)

Sur Système de grades (carte Grades > Modifier le système) :

Modifier un grade : toucher sa ligne. La feuille montre un aperçu de la ceinture et les champs Nom du grade, Série (s'il y en a plusieurs), Apparence, les couleurs, Barrettes (max.), Âge minimum, Délai (mois), Présences min. Laisser vide un champ de condition = pas de condition. Enregistrer. Changer de série place le grade en dernier dans la nouvelle série.
Ordre : Monter / Descendre, ou faire glisser la poignée ≡, à l'intérieur d'une série.
Ajouter un grade · {série} sous chaque série; Ajouter une série (nom, note facultative de 300 caractères au plus, case « Parcours à part »).
Modifier la série (crayon à côté de son nom) : nom, note, parcours à part, ou Retirer la série. Seule une série vide se retire (même un grade à la corbeille compte), sinon « Cette série contient des grades : retirez-les ou déplacez-les d’abord. »
Renommer le système : crayon à côté de son nom.
Façons d'obtenir un grade : Ajouter, ou toucher le × d'une façon pour la retirer.
Retirer un grade (dans sa feuille) : il va à la corbeille; le message offre Rétablir.
Changer de gabarit et Retirer le système sont juste sous le nom du système.
Changer de gabarit : remplace toutes les séries et tous les grades, après confirmation. Possible seulement si aucun grade ni aucune barrette n'a jamais été remis dans ce système (même une remise mise à la corbeille compte). Sinon le bouton est remplacé par « Des grades ont déjà été remis : modifiez le système grade par grade. »
Retirer le système : après confirmation, le système va à la corbeille avec ses séries et ses grades; les remises des élèves sont cachées, pas effacées. Rétablir (dans le message) ou Restaurer depuis la Corbeille pendant 30 jours remet tout. La restauration est refusée si un nouveau système a été créé entre-temps pour ce curriculum.

L'instructeur ouvre Voir les grades en lecture seule (« Seul le responsable modifie le système de grades. »).

Niveau des éléments du curriculum

Quand le curriculum a un système, la feuille d'un élément (Modifier un élément du curriculum) montre le champ Niveau : un grade du système, ou « Libre : aucun grade rattaché » (par défaut). Les éléments rattachés à un grade comptent dans la condition « Éléments du curriculum » de ce grade. Le niveau s'affiche à côté de l'élément (petite ceinture et nom du grade). Si le grade va à la corbeille, l'élément s'affiche « libre » jusqu'à la restauration du grade (le lien est gardé). Sans système, le champ n'apparaît pas. Responsable seulement.

Grade actuel et barrettes

Le grade actuel d'un élève dans un système est sa remise de grade la plus récente : la date la plus récente; à date égale, la dernière enregistrée. Les remises à la corbeille et celles d'un grade à la corbeille ne comptent pas. Sans remise : « Aucun grade remis ».
Les barrettes affichées sont celles ajoutées au grade actuel après sa remise (même jour compris si elles sont enregistrées après), au plus le maximum du grade (« 2 barrette(s) sur 3 »). Remettre un nouveau grade repart donc à zéro barrette.

Prochain grade

Le prochain grade est le grade suivant dans la même série.
À la fin d'une série de la ligne principale : le premier grade de la série principale suivante (ex. dernier kyu → 1er dan).
À la fin d'un parcours à part : aucun, avec « Fin de ce parcours. » Utiliser Remettre un autre grade pour passer à un autre parcours (ex. des ceintures enfants aux ceintures adultes).
À la fin de la ligne principale : « Plus haut grade du système. »
Sans grade actuel : le premier grade de la ligne principale.

Conditions du prochain grade (des repères)

Chaque condition s'affiche avec une icône : remplie (crochet), non remplie (cercle) ou à vérifier (point d'interrogation), et un détail chiffré. Les conditions ne bloquent jamais la remise : le responsable garde le dernier mot.

Âge minimum : l'app ne connaît pas l'âge des élèves (pas de date de naissance). Pour un élève adulte et un âge minimum de 18 ans ou moins : « Atteint : élève adulte ». Dans tous les autres cas (mineur, ou âge minimum de 19 ans ou plus) : « À vérifier : l’app ne connaît pas l’âge des élèves ».
Délai : mois complets depuis la date du grade actuel (ex. du 15 janvier au 14 juillet = 5 mois). Sans grade actuel : « À vérifier : aucun grade précédent ».
Présences : présences comptées après la date du grade actuel (le jour même exclu), jusqu'à aujourd'hui; sans grade actuel, après la date d'inscription. Comptent : les statuts Présent et En retard (pas Motivé), à des séances non annulées et non supprimées, dont au moins un groupe est rattaché à ce curriculum, ou sans groupe (« Ouvert à tous »). Si aucun groupe n'est rattaché au curriculum, toutes les présences de l'élève comptent.
Éléments du curriculum : éléments rattachés au prochain grade, « X sur Y validés ». Seul Validé compte (pas Appris).
Sans aucune condition : « Aucune condition : le grade se remet quand vous jugez l’élève prêt. »

Remettre un grade (responsable)

Ouvrir Progression d'un élève (fiche de l'élève > Voir la progression).
Dans la carte du curriculum, sous Prochain grade, toucher Remettre : {grade}. Ou Remettre un autre grade pour choisir n'importe quel grade du système (grade d'arrivée d'un élève qui vient d'une autre école, saut de grade, passage à un autre parcours, retour en arrière).
Vérifier la Date (aujourd'hui par défaut, jamais dans le futur), la Façon d’obtenir le grade (liste du système, ou Autre avec un texte de 60 caractères au plus), l'Examinateur (un compte de l'école, Nom libre de 80 caractères au plus, ou Aucun; par défaut, la personne connectée) et une Note facultative (500 caractères au plus).
Toucher Remettre. Le message « {prénom} : {grade} remis » offre Annuler (la remise va à la corbeille).

Remettre un grade dans un curriculum que l'élève ne suit pas l'ajoute à ses curriculums (ajout manuel). L'instructeur voit « La remise d’un grade se fait par le responsable. »

Ajouter une barrette (responsable et instructeur)

Sous Grade actuel, toucher Ajouter une barrette : un seul toucher, datée d'aujourd'hui, avec la personne connectée comme examinateur. Le message « {prénom} : barrette 2 sur 3 ajoutée » offre Annuler. Le bouton n'apparaît pas si l'élève n'a pas de grade, si le grade n'a pas de barrettes, ou si le maximum est atteint.

Grades obtenus

La carte Grades obtenus liste les remises de l'élève dans ce système, la plus récente en haut : date, ceinture, nom du grade (« Barrette · {grade} » pour une barrette), façon et examinateur. Retirer (corbeille) : le responsable peut retirer toute remise; l'instructeur, seulement les barrettes qu'il a ajoutées. Le message offre Rétablir; ensuite, Restaurer depuis la Corbeille pendant 30 jours.

Où voir le grade

Fiche de l'élève, bloc Progression : pour chaque curriculum suivi qui a un système, la petite ceinture et le grade actuel (« Jaune · 2 barrettes »), ou « Aucun grade remis ».
Feuille de présence, vue Progression : la ceinture et le grade actuel de chaque élève pour le curriculum de la séance.

Corbeille

Une remise (grade ou barrette) à la corbeille disparaît de l'historique et des calculs; elle revient à sa restauration.
Un grade à la corbeille disparaît du système et du calcul du prochain grade; ses remises sont cachées et reviennent avec lui.
Un système à la corbeille emporte ses séries et ses grades; tout revient à sa restauration.
Après 30 jours, ils sont supprimés pour de bon : un système supprimé efface ses grades et toutes leurs remises.
Un élève à la corbeille : ses remises disparaissent avec lui et reviennent à sa restauration.
Un élève qui ne suit plus le curriculum garde son historique de grades (section « Autres curriculums » de sa progression).

Rôles

Action	Responsable	Instructeur
Voir systèmes, grades, conditions, historique	oui	oui
Créer, modifier, ordonner, retirer le système, ses séries et ses grades; changer de gabarit	oui	non
Rattacher un élément du curriculum à un grade (Niveau)	oui	non
Remettre un grade (y compris Remettre un autre grade)	oui	non
Ajouter une barrette	oui	oui
Retirer une remise	toutes	ses barrettes seulement

Limites

Voir limites. L'app ne connaît pas la date de naissance des élèves (l'âge reste « à vérifier »). Il n'y a pas de liste des « élèves prêts pour un grade », pas de filtre de la liste des élèves par grade, pas de certificat imprimable, pas de frais d'examen, pas d'inscription à un examen de fédération, pas de grade qui expire. Aucune donnée d'argent n'est liée aux grades.

Erreurs possibles

« Ce curriculum a déjà un système de grades. », « Des grades ont déjà été remis dans ce système : modifiez-le grade par grade au lieu de changer de gabarit. », « Cette série contient des grades : retirez-les ou déplacez-les d’abord. », « Ce grade n’existe plus : il a peut-être été mis à la corbeille. », « Cette série n’existe plus dans ce système. », « Toutes les barrettes de ce grade sont déjà remises. », « Une barrette se remet sur le grade actuel de l’élève : remettez d’abord un grade. », « Cet examinateur n’a pas de compte dans l’école : choisissez un compte ou écrivez un nom libre. », « La date ne peut pas être dans le futur. »