Manuel d’utilisation — Sys-Conv

Adresse : https://rr27.yaka.fr

Ce manuel est aussi une page du site : https://rr27.yaka.fr/manuel, et le lien 📖 Manuel y mène depuis l’accueil.

Sys-Conv est la plateforme des systèmes d’enchères : on y consulte les systèmes (le SEF, les systèmes du club, un système en cours d’écriture), on les imprime ou les exporte, on s’y entraîne, et — avec un compte — on les modifie.

Ce manuel suit l’écran, dans l’ordre où on le découvre : l’accueil, la lecture d’un système, la recherche d’une séquence, l’impression, l’édition.

Deux publics, deux usages. Sans compte, on consulte et on imprime tout ce qui est public. Avec un compte, on voit en plus les systèmes privés auxquels on vous a donné accès, et on peut modifier les systèmes. Il n’y a pas d’inscription en ligne : les comptes sont créés par l’administrateur.

1. La page d’accueil

Depuis la page d’accueil, trois liens en haut : ← Accueil (qui ramène ici), 📖 Manuel (cette page) et 🖨 Modèle de notes (des grilles vierges à imprimer, voir §8). Les pages d’un système ont leur propre barre, décrite au §2.

Sous le titre Sys-Conv :

• la zone Connexion (identifiant, mot de passe, bouton Se connecter) ;
• la liste des systèmes auxquels vous avez accès, une carte par système.

1.1 Lire une carte

Une carte porte cinq informations, dans cet ordre :

Le changement affiché est celui du dernier commit — un enregistrement, pas un brouillon. Un commit plus ancien, ou importé sans note, affiche seulement sa date.

1.2 Les deux boutons

• Consulter ouvre le système (voir §2).
• Historique déroule la liste des modifications enregistrées de ce système.

Dans la liste déroulée, chaque ligne est un commit : son raccourci (a3f91c2), sa date, son auteur, puis son message, et à droite le lien Voir qui ouvre le système. Le commit affiché en bleu avec ← actuel est la version que vous consultez aujourd’hui. Sous chaque ligne, les enchères touchées par ce commit — ajoutées en vert, modifiées en ambre, supprimées en rouge et barrées.

Pour un commit antérieur à cette convention (import, migration), un lien « changements non consignés — calculer » fait comparer les deux versions par le serveur : un clic, une réponse.

2. Ouvrir un système

Cliquer Consulter (ou taper /systems/<identifiant> dans la barre d’adresse) ouvre la première page du système.

En haut de la page :

Sous ce bandeau, si le système compte plusieurs pages (par exemple « Ouvertures » et « Interventions »), une rangée de pastilles permet de passer de l’une à l’autre. La page affichée est celle dont le titre apparaît en grand sous le bandeau.

3. Trouver une séquence : le sélecteur de contexte

C’est l’outil le plus utile de l’écran, et le premier qu’on montre à un joueur qui cherche « et après 1♣ – 1♥, on fait quoi ? ».

Le bloc SÉLECTEUR DE CONTEXTE propose les enchères une par une :

1. Il affiche d’abord les ouvertures possibles, triées dans l’ordre du bridge (1♣, 1♦, 1♥, 1♠, 1SA, 2♣…).
2. Vous cliquez 1♣ : la grille s’agrandit d’une case et affiche les enchères possibles après 1♣, dans l’ordre des joueurs O → N → E → S.
3. Vous cliquez 1♥ : la grille continue, et la page ne montre plus que les tableaux qui commencent par cette séquence.
4. La ligne du bas rappelle le filtre en cours : Filtre : 1C (P) 1H.

Trois détails qui font gagner du temps :

• Les parenthèses sont l’adversaire. 1♣ (P) 1♥ : la passe entre parenthèses est celle de l’adversaire ; 1♣ 1♥ sans parenthèses serait une enchère de votre camp. On ne clique donc que les enchères de son propre camp.
• Revenir en arrière : cliquez une case déjà remplie, plus haut dans la grille ; tout ce qui suivait s’efface. Le bouton ← Retour recule d’un cran, Réinitialiser efface tout et réaffiche toutes les tables.
• On ne peut choisir que ce que le système décrit. Le sélecteur ne propose pas toutes les enchères du bridge, seulement celles qui ont une suite dans le système : c’est déjà un premier renseignement.

4. Lire un tableau de développement

La page est faite de tableaux de développement, deux par rangée sur un grand écran, un seul sur un téléphone. Chaque tableau décrit une situation : des enchères déjà jouées (le contexte), puis les enchères possibles et leur signification.

4.1 Un tableau, de haut en bas

1. La grille O N E S — la séquence déjà jouée, à la place géographique de chaque joueur, et à la fin le ? du joueur qui doit parler. Les enchères adverses y figurent entre parenthèses et sur fond gris.
2. Les descriptions du contexte — la signification des enchères déjà jouées, une ligne par enchère (1♣ : 3+♣, 12-23 HL…). On comprend ainsi où l’on est avant de lire ce qui suit.
3. Le bandeau DÉVELOPPEMENT — le titre du tableau.
4. Le tableau lui-même, en deux colonnes : à gauche l’enchère, à droite sa signification.

4.2 La colonne des enchères

Une enchère s’affiche toujours en symboles — 1♥, 3SA, jamais 1H.

• P, X, XX sont la passe, le contre, le surcontre. Dbl et Rdbl s’affichent X et XX.
• Une forme collective est développée sur une ligne, les cas séparés par / : un groupe 4M s’affiche 4♥/4♠, un ensemble 2CD s’affiche 2♣/2♦, un joker 3x s’affiche 3♣/3♦/3♥/3♠, une alternative 3S/4C s’affiche 3♠/4♣. Une seule enchère à écrire, plusieurs enchères à jouer : toutes se lisent d’un coup d’œil.
• Un suffixe entre crochets est une variante de l’enchère : 1SA [vuln]. Sans lui, deux variantes seraient indiscernables.
• Une enchère bleue ouvre un tableau de détail : cliquez-la pour descendre d’un cran dans le système (le + qui apparaît au survol le signale). Quand le détail est sur une autre page du système, le lien vous y conduit et met le tableau en évidence.
• Dans la grille du contexte, une enchère est cliquable aussi : elle ramène au tableau de ce moment-là.

4.3 La colonne des significations

De gauche à droite, dans la même cellule :

1. les pastilles — Alertable, Pré-Alertable, Artificiel : l’enchère doit être annoncée à l’adversaire (ou annoncée à l’avance), ou ne dit rien de la couleur annoncée ;
2. la force et la distribution, en gras, séparées par une virgule — par exemple F1, 4+♦, 5+ HL. Le premier mot est un code du système (voir §9) ;
3. la description en clair.

Deux mises en forme à connaître :

• un code entre parenthèses, comme (CONST), s’affiche en petite étiquette grise dans le texte ;
• une énumération ((a) … (b) …) est mise sur plusieurs lignes ; le reste du texte reste d’un seul tenant. Une description qui semble coupée au milieu d’une phrase est donc une énumération, pas une troncature.

4.4 « Forme illisible » : ce que ça annonce

Si une enchère ne peut pas être lue (une faute de frappe dans les données, une forme que la grammaire n’admet pas), elle s’affiche avec un avertissement ⚠ forme illisible et le système signale le problème aux administrateurs. C’est une donnée à corriger, pas un défaut d’affichage : signalez-la.

À l’inverse, un libellé inhabituel écrit par un auteur (2 shown, Other) s’affiche tel quel : c’est une annotation, pas une corruption.

5. S’entraîner

Le bouton 🎯 Entraînement (en haut d’une page système) tire une séquence complète au hasard dans le système, et vous demande de la reconnaître.

1. La séquence s’affiche seule, dans la grille O N E S habituelle ; le nombre d’enchères et le nom de l’arbre sont rappelés au-dessus.
2. Chaque enchère de la séquence est cliquable : elle ouvre les autres enchères possibles à ce moment-là, ce qui permet de vérifier une hésitation avant de répondre.
3. Réponse dévoile l’explication de chaque enchère de la séquence, l’une sous l’autre, avec les mêmes pastilles et les mêmes codes que dans les tableaux.
4. Suivant → tire une autre séquence et remasque les réponses.

Au clavier : Espace pour la réponse, Entrée ou → pour la suivante. C’est le geste qui rend l’entraînement utilisable en rafale.

Le compteur en haut à droite (Entraînement · 1105 séquences) indique combien de séquences complètes le système décrit. Rien n’est enregistré : le mode entraînement ne garde aucune trace de votre score ni de votre progression.

Un système dont aucune séquence n’est expliquée l’annonce franchement : « Ce système n’a aucune séquence complète expliquée ».

6. Imprimer et exporter

Les boutons d’export n’apparaissent que sur une page qui contient des tableaux, et ils portent sur la page affichée, pas sur le système entier.

Une fois un filtre actif (§3), seule l’impression reste disponible : la mention Filtré s’affiche, et les exports sont désactivés — un export partiel serait un fichier qui mentirait sur son contenu. Réinitialisez le filtre pour les retrouver.

Le lien 🖨 Modèle de notes de la page d’accueil mène à des grilles vierges (voir §8), à imprimer pour écrire à la main.

7. Modifier un système

L’édition demande un compte (voir §10). Sur un système public, n’importe quel compte peut modifier ; sur un système privé, il faut en plus y avoir accès.

7.1 Le geste

Cliquez une description dans un tableau. Une fenêtre s’ouvre — Modifier 1♥ — avec les champs de cette enchère :

Enregistrer (local) valide la modification pour vous, sans rien publier. La barre d’édition, en haut de la page, tient le compte : 3 modifications en attente.

7.2 Le brouillon, et le commit

Vos modifications sont gardées dans votre navigateur, sur ce poste, tant que vous ne les publiez pas. Vous pouvez donc fermer l’onglet, changer de page, revenir : elles sont là.

• 💾 Tout commiter publie toutes les modifications en attente, en un seul enregistrement daté et signé de votre nom. C’est ce commit qui apparaîtra dans l’historique du système et sur la carte de l’accueil.
• Si, entre-temps, quelqu’un d’autre a enregistré une version, l’enregistrement est refusé et le message vous l’explique : Recharger (abandonner le brouillon) recharge la version du serveur et jette vos modifications locales. Recopiez-les s’il y a lieu.
• Si le système a changé depuis votre dernière édition, le brouillon est ignoré au chargement de la page, et le site vous le dit.

Deux règles de bonne conduite : un commit par sujet (finissez une idée avant de publier), et vérifiez votre brouillon avant de commiter — un commit est public pour tous ceux qui consultent le système.

7.3 Créer une copie

Le bouton ⧉ Créer une copie ouvre un petit formulaire :

La copie est autonome dès qu’elle existe : elle garde la trace de son original (d'après SEF(2014)) sur sa carte, mais modifier l’original ne la change pas, et l’inverse est vrai aussi. Vos modifications en attente, s’il y en a, sont appliquées à la copie — jamais à l’original.

8. Le modèle de notes

Le lien 🖨 Modèle de notes de l’accueil ouvre quatre grilles vierges de tableau d’enchères, de 1♣ à 5SA, précédées de leur grille O N E S vide. Elles servent de support papier : décortiquer une convention en réunion, noter une séquence entendue au club, préparer un système avant de le saisir.

L’impression en sort deux par page A4 ; il y a donc deux feuilles pour les quatre gabarits. Choisissez « Enregistrer au format PDF » si vous voulez les réimprimer plus tard.

9. Les codes que vous lirez dans les tableaux

Ces abréviations viennent du système lui-même : ce sont les auteurs qui les choisissent, et la plateforme les affiche sans les interpréter. Les plus fréquentes :

Un système peut en employer d’autres, ou les écrire autrement : en cas de doute, c’est sa description en clair qui fait foi.

10. Comptes et accès

• Il n’y a pas d’inscription. Le bouton Se connecter ne crée rien ; les comptes sont ouverts par l’administrateur du site, sur demande.
• La connexion se fait depuis la page d’accueil ; une fois connecté, un bandeau vert affiche Connecté : votre-nom et le lien Se déconnecter. La session reste ouverte dans ce navigateur tant que vous ne vous déconnectez pas.
• Un système privé n’existe pas pour vous tant qu’un accès ne vous a pas été accordé : il n’apparaît pas dans la liste, et son adresse répond Authentification requise ou Accès refusé.
• Un compte admin voit tous les systèmes, publics et privés.

11. Questions fréquentes

Je ne vois pas le système dont on m’a parlé. Il est probablement privé, ou votre accès n’a pas encore été ouvert. Vérifiez que vous êtes connecté (bandeau vert sur l’accueil), puis demandez l’accès à l’administrateur.

Une description est-elle à jour ? La carte de l’accueil porte la date du dernier commit, et son survol la liste des enchères touchées. Pour un système, l’historique (bouton Historique) donne toutes les versions, la plus récente en tête.

J’ai modifié des choses et elles ont disparu. Le brouillon vit dans le navigateur de ce poste. Un autre navigateur, un navigateur « privé », ou un nettoyage des données du site le perdent. Publiez avec 💾 Tout commiter quand votre modification est prête.

Le message dit « Conflit ». Quelqu’un a enregistré entre-temps. Cliquez Recharger (abandonner le brouillon), puis refaites votre modification sur la version à jour.

L’impression coupe un bord de tableau. Imprimez sans marges personnalisées (marges par défaut du navigateur) : la mise en page est calculée pour elles. Si votre imprimante a une marge matérielle large, choisissez « Ajuster à la page ».

L’enchère affichée est un avertissement « forme illisible ». C’est une erreur dans les données du système, déjà signalée aux administrateurs. Signalez-la si elle persiste : elle empêche de lire une enchère.

Puis-je utiliser le site sur un téléphone ? Oui : les cartes, les tableaux et les boutons s’empilent sur une colonne. Pour travailler une séquence, le sélecteur de contexte et le mode entraînement sont les plus confortables au doigt.

Ce manuel décrit l’usage du site. Les règles de la grammaire des données (syntaxe des arbres) ne concernent que les auteurs de systèmes et sont documentées séparément, dans le module BNF du projet.