Aller au contenu

Édition des cartes et items

English version
← Retour au sommaire

Accéder à l'éditeur de cartes

  1. Depuis la liste des langues → bouton ✏️ "Éditer" sur la langue souhaitée
  2. Ou directement : /admin/languages/[id]/cards

L'éditeur affiche toutes les cartes de la langue (mots et phrases), avec leurs items.

Vue de la liste des cartes

Pour chaque carte : - Numéro de carte - Type : mot (word) ou phrase (phrase) - Thème (pour les mots) - Nombre d'items - Progression audio : combien d'items ont un audio

Modifier le texte d'un item

Via l'interface admin

  1. Cliquez sur une carte pour l'ouvrir
  2. Vous voyez tous les items de la carte (liste des positions)
  3. Cliquez sur un item pour entrer en mode édition
  4. Modifiez :
  5. texte_original : le texte en langue africaine
  6. traduction : la traduction en français
  7. Cliquez sur "Sauvegarder"

Via PostgreSQL directement

UPDATE items
SET
  original_text = 'Nouveau texte en langue',
  translation   = 'Nouvelle traduction'
WHERE id = 'uuid-de-l-item';

Modifier l'URL audio d'un item

Si vous souhaitez pointer un item vers un fichier audio existant dans MinIO :

Via l'interface admin

Dans la vue item → champ "URL audio" → modifier → sauvegarder.

Via PostgreSQL

UPDATE items
SET audio_url = 'https://[minio-public-url]/audios/[chemin-du-fichier].mp3'
WHERE id = 'uuid-de-l-item';

Format de l'URL audio :

https://[MINIO_PUBLIC_URL]/[MINIO_BUCKET]/[code_langue]/[carte_id]/[position].mp3

Exemple :

https://racines-s3.id2real.net/audios/pul/carte-123/pos-1.mp3

⚠️ L'URL doit être accessible publiquement (bucket MinIO en mode public-read).

Ajouter une nouvelle carte

L'ajout de nouvelles cartes ne se fait pas depuis l'éditeur. Pour ajouter des cartes à une langue existante, utilisez l'import Excel depuis la page de création de langue.

→ Voir Import Excel

Supprimer un item ou une carte

⚠️ La suppression d'une carte est irréversible et cascade sur ses items et ses statistiques.

Via l'interface admin

Bouton "Supprimer" sur la carte ou l'item → confirmation requise.

Via PostgreSQL

-- Supprimer un item
DELETE FROM items WHERE id = 'uuid-de-l-item';

-- Supprimer une carte (cascade automatique sur les items)
DELETE FROM cards WHERE id = 'uuid-de-la-carte';

Note : La suppression d'une carte via PostgreSQL entraîne la suppression en cascade des items, mais pas des fichiers audio dans MinIO. Nettoyez manuellement le bucket si nécessaire.

Cas d'usage courants

Corriger une faute de frappe dans un mot

Admin UI → Carte → Item → Éditer → Corriger → Sauvegarder.

Remplacer un audio de mauvaise qualité

Admin UI ou SQL → Modifier audio_url de l'item pour pointer vers le nouveau fichier dans MinIO. Ou bien : demandez au locuteur de ré-enregistrer via son interface (voir Gestion des locuteurs).

Ajouter un thème manquant

SQL → UPDATE cards SET theme = 'Nouveau thème' WHERE id = 'uuid';

Étapes suivantes