Format simple de collecte des photos scellées

Statut : format court de transmission au 2026-05-21.

Template : modèle CSV de collecte

Principe

Les associés ne préparent pas directement le manifest backend. Ils envoient un lot simple :

• un dossier par produit ;
• des photos originales ;
• une ligne CSV par produit ;
• des droits clairs.

Le renommage propre, l'OCR/IA éventuel, la création du manifest et la séparation inbox / labeled sont faits ensuite par l'équipe technique.

Structure du lot

sealed-field-batch-YYYY-MM-DD/
  photos/
    item-001-base-set-blastoise-booster-pack/
      IMG_3021.jpg
      IMG_3022.jpg
    item-002-prismatic-evolutions-etb/
      IMG_4101.jpg
      IMG_4102.jpg
  sealed-field-collection-template.csv

Les fichiers peuvent garder leurs noms téléphone. Le nom du dossier produit suffit pour le premier tri.

CSV minimum

item_folder,expected_product_name,product_type,language,set_or_series,variant_or_artwork,rights,owner_or_source,usable_for_public_display,notes
item-001-base-set-blastoise-booster-pack,Base Set Blastoise Booster Pack,booster_pack,fr,base1,Blastoise,explicit_permission,AB,false,photos prises au telephone

Champs

Champ	Obligatoire	Exemple
item_folder	Oui	item-001-base-set-blastoise-booster-pack
expected_product_name	Si connu	Base Set Blastoise Booster Pack
product_type	Si connu	booster_pack
language	Si connu	fr
set_or_series	Si connu	base1
variant_or_artwork	Si connu	Blastoise
rights	Oui	owned_by_skn ou explicit_permission
owner_or_source	Oui	initiales, prénom, équipe
usable_for_public_display	Oui	false par défaut
notes	Optionnel	reflet, doute, produit inconnu

Si une information est inconnue, laisser vide ou écrire unknown. Ne pas deviner.

Types produit

booster_pack
booster_display
booster_bundle
elite_trainer_box
blister
collection_box
tin
mini_tin
deck
other
unknown

Promotion technique dans le repo

Après réception, l'équipe technique normalise les noms et déplace les fichiers utiles vers :

tcg-collector-backend/src/api/tests/fixtures/sealed-eval/
  images/inbox/
  images/labeled/
  manifest.json

Ne pas mettre les photos terrain directement dans sealed-samples sauf décision explicite. sealed-samples sert aux références bootstrap indexables.

Règles de droits

Accepter uniquement :

• owned_by_skn : SKN possède la photo ou le produit ;
• explicit_permission : le propriétaire autorise SKN à utiliser la photo.

Refuser :

• images internet ;
• screenshots marketplace ;
• images reçues sans permission claire ;
• photos avec droits publics supposés mais non validés.

Premier lot utile

Objectif simple :

• 5 à 10 produits physiques ;
• 6 à 10 photos par produit ;
• au moins 3 types produit ;
• droits clairs pour chaque produit.