Raijin AtlasRaijin Atlas
Admin/Remplir les résumés d'effets (import en masse)

Remplir les résumés d'effets (import en masse)

Guide contributeur : écrire nos propres paraphrases d'effets de cartes (effectSummary) et les importer en masse pour débloquer l'encodeur IA de l'émulateur.

Ce guide s'adresse au contributeur qui remplit les résumés d'effets des cartes. Tu n'as pas besoin d'être développeur — juste de savoir lire l'effet d'une carte et le reformuler avec tes propres mots.

Pourquoi on fait ça

Raijin Atlas a un émulateur de parties : il simule des matchs pour analyser les decks. Pour simuler, le moteur doit savoir ce que fait chaque carte, sous une forme structurée. Une IA traduit automatiquement un résumé d'effet en clair vers cette structure — mais il faut d'abord lui fournir ce résumé.

Le catalogue est importé avec les infos factuelles (nom, coût, power, couleurs) mais sans le texte d'effet, pour une raison légale (voir la règle ci-dessous). Ton rôle : écrire, dans nos propres mots, un court résumé de l'effet de chaque carte. Plus on en remplit, plus l'émulateur et les analyses sont précis.

⚠️ Règle absolue (légale, non négociable)

Ne JAMAIS copier-coller le texte officiel imprimé sur la carte (Bandai). Toujours reformuler avec tes propres mots. Un résumé = notre paraphrase mécanique, jamais le texte officiel. C'est une contrainte de propriété intellectuelle stricte ; un import qui ressemble au texte Bandai sera rejeté.

Le format

Une ligne par carte : le cardId, une tabulation, puis le résumé en anglais.

OP15-001	On Play: draw 1 card, then trash 1 card from your hand.
OP15-005	When Attacking: this Leader gains +1000 power this turn.
OP14-013	[Activate Main] once per turn: rest 1 DON!! to give this character +2000 power.

Colonnes optionnelles ensuite (séparées par tabulation) : FR, puis JP. Seul l'anglais (en) est obligatoire.

Écris avec ce vocabulaire (= meilleur encodage)

L'IA comprend un vocabulaire fixe. T'appuyer dessus = des résumés bien encodés.

  • Déclencheurs : On Play, When Attacking, On Block, On KO, Activate Main, End of Turn, Trigger, Static.
  • Actions : draw N · KO a character (power ≤ X) · +X power (this turn / permanent) · gain N life · rest a character · give N DON!! · return to hand · search for a trait · grant a keyword (Blocker / Rush / Double Attack / Banish).
  • Conditions / coûts : if DON!! ≥ X · if life ≤ X · leader is [color] · target has [trait] · cost: rest/return N DON!!, rest this card · once per turn.

Si une carte a un effet impossible à exprimer avec ce vocabulaire, écris quand même un résumé honnête — l'IA le marquera « non encodable », c'est normal.

Quoi prioriser

  1. Sets récents d'abord : OP15, OP14, OP13 (puis EB04).
  2. Dans chaque set : les leaders en premier, puis les personnages et événements à effet. Ignore les cartes « vanilla » (sans texte d'effet).

Où trouver l'effet d'une carte

L'image officielle (site onepiece-cardgame.com, ou le Catalogue de l'app) montre l'effet imprimé. Tu le lis et tu le reformules en une ou deux phrases courtes, en t'appuyant sur le vocabulaire ci-dessus.

Bon vs mauvais résumé

  • ✅ Bon (notre paraphrase, mécanique) : OP15-005 When Attacking: this Leader gains +1000 power this turn.
  • ❌ Mauvais (copie du texte Bandai, verbatim) : recopier mot pour mot la phrase imprimée sur la carte.
  • ❌ Mauvais (vague, inutilisable) : OP15-005 good attacker card.

L'outil d'import

Page admin /admin/encoding-queue/bulk :

  1. Colle ton TSV dans la zone de texte.
  2. Le compteur affiche le nombre de lignes valides (et celles ignorées : il faut un cardId ET un résumé anglais non vide).
  3. Clique Importer. Le volume n'est pas limité (l'outil découpe tout seul).
  4. Le panneau Résultat liste le nombre importé + les éventuelles erreurs (card_not_found = mauvais cardId, empty_en = résumé manquant).

Étape suivante : lancer l'encodage IA

Important : l'import ne fait que stocker les résumés. L'encodage IA n'est PAS automatique — il faut le déclencher, sinon rien ne se passe et l'émulateur reste en mode « vanilla » (cartes sans effet).

  1. Va sur /admin/encoding-queue.
  2. Clique le bouton « Lancer l'encodage IA » (en haut à droite). Une confirmation prévient que ça appelle l'IA (Claude) et consomme du budget — confirme.
  3. L'IA encode en arrière-plan chaque carte publiée qui a un résumé : elle auto-publie les effets simples et met en file de revue les cartes méta / complexes. Le batch s'arrête tout seul s'il n'y a rien à encoder ou si le budget mensuel est atteint.

Tu peux relancer le bouton après chaque nouvel import. C'est sans risque (il ne ré-encode pas les cartes déjà traitées).

Suivre l'avancement

  • /admin/encoding-queue : les cartes passent de la file vers « encodé / publié » au fil de l'eau.
  • /admin/ai-monitor : état du service IA + budget consommé.
  • La couverture par palier (« X % machine · Y % vérifié humain ») affichée sur /encoder monte au fil des encodages.
  • Une fois des cartes encodées, l'émulateur montre leurs effets dans le panneau « Effets déclenchés » et les anime sur le playmat.
Admin encoding workflowCreate Testimonial