Appearance
Carte fonctionnelle PRD
Date : 2026-05-13. Statut : carte fonctionnelle canonique. Migration source : condensé depuis poc-tcg-collector/doc/tcg_spec_notion_complete.md et poc-tcg-collector/doc/tcg_complete_final_v3.md.
Objectif produit
Construire une app Pokémon-first de collection et pricing où un utilisateur peut identifier un item, l'ajouter à une collection privée, suivre sa valeur dans le temps et comprendre l'estimation derrière cette valeur.
Le MVP doit ressembler à une app complète, pas à une démo scanner. Il doit supporter la boucle collection end-to-end, même si certaines sources data sont d'abord lab-grade.
Groupes de features MVP
1. Identification d'item
L'utilisateur peut identifier :
- cartes raw ;
- slabs / cartes gradées plus tard dans la même coque scanner ;
- produits scellés quand le catalogue scellé existe.
Le résultat doit mener à une confirmation, pas à une insertion aveugle :
- identité item ;
- langue ;
- condition ;
- quantité ;
- variante/version ;
- ajout à collection ou quick price check.
2. Entrée manuelle
L'entrée manuelle n'est pas un fallback secondaire. Elle est requise pour :
- scans échoués ;
- items non présents physiquement ;
- saisie en masse ;
- nettoyage d'inventaire.
L'app a besoin de recherche rapide, filtres, quantité, condition, langue et données d'achat.
3. Catalogue unifié
Le catalogue doit inclure des classes d'objet distinctes :
- carte raw ;
- slab / carte gradée ;
- produit scellé.
Le catalogue doit normaliser TCG, set, langue, collector number, type produit, source image, provenance source et identifiants.
4. Inventaire collection
La collection stocke les holdings possédés par l'utilisateur :
- référence item ;
- type d'item ;
- quantité ;
- condition ;
- langue ;
- prix d'acquisition ;
- date d'acquisition ;
- label de stockage ;
- notes ;
- références preuve/photo ;
- snapshots de valorisation.
Private-by-default est une exigence produit, pas seulement un détail backend.
5. Dashboard portfolio
Le dashboard répond :
- valeur totale de collection ;
- split scellé, cartes raw et graded ;
- gain/perte depuis achat ;
- top movers ;
- valeur par set ou type produit ;
- fraîcheur et confiance data.
Le portfolio est l'écran héros pour la persona investisseur scellé.
6. Pricing et valorisation
Le produit doit séparer :
- estimation carte raw ;
- estimation graded ;
- estimation scellé.
L'UI doit expliquer breakdown source, confiance et fraîcheur. Les alertes sont des candidates premium quand le pricing engine est crédible.
7. Historique et récupération
La collection a besoin de :
- historique d'actions ;
- audit des edits ;
- corbeille/restore ;
- import/export ;
- futur cloud backup et sync multi-device.
Cela protège la confiance. Les utilisateurs ne stockeront pas un inventaire de valeur dans une app qui rend l'historique fragile.
Groupes de features plus tard
| Feature | Timing | Raison |
|---|---|---|
| Alertes prix | Après confiance pricing solide | Fort driver premium |
| Wishlist | Après stabilité catalogue et pricing | Utile, mais pas boucle coeur |
| Collection completion | Après UX catalogue cartes raw solide | Plus collectionneur que investisseur scellé |
| Calendrier releases | Après pipeline source fiable | Utile pour acheteurs scellé |
| Marketplace | Beaucoup plus tard | Paiements, litiges, réputation, fraude |
| Cloud sync | Après modèle local/privé sain | Driver premium et rétention |
| Mode slab | Après stabilité raw scan et collection | Requiert OCR label et pricing graded |
| Scan scellé | Après catalogue/index scellé | Problème de reconnaissance séparé |
Principes d'acceptation
Chaque feature doit répondre à au moins une question :
- Est-ce que cela aide l'utilisateur à ajouter son inventaire plus vite ?
- Est-ce que cela rend la valorisation plus crédible ?
- Est-ce que cela rend le scellé first-class ?
- Est-ce que cela préserve confiance et privacy ?
- Est-ce que cela améliore l'habitude quotidienne portfolio ?
Si une feature ajoute seulement de la largeur et ne renforce pas ces boucles, elle attend.
Mapping des slices actuelles
| Slice | Repo | But |
|---|---|---|
| UX scanner lab bottom-sheet | poc-tcg-collector | Rendre le test des cinq endpoints actuel plus rapide et clair |
| Feedback scan-case | backend + app | Transformer les vrais scans Android en preuves d'accuracy |
| Catalogue lab scellé | backend | Garder la reconnaissance scellée séparée du raw-card |
| Observations et estimations pricing | backend | Construire une valorisation explicable avant d'ajouter beaucoup de providers |
| Holdings collection privés | backend + app | Sécuriser l'inventaire utilisateur avant marketplace |