Guide (Français)

Documentation du projet en français.

Direction technique

Préparation MEP et SRE - contrôles avant lancement, sécurité, reprise, batchs RGPD, automatisations et incidents ; validations encore à renseigner.
Confidentialité, traceurs et statistiques de scans - documents juridiques, consentement, valorisation privée et compteurs agrégés pour site/mobile/desktop.
Playbook CTO — réconciliation des audits, feuille de route, garde-fous d'équipe, sécurité/RGPD, tenue de charge, et les cinq variantes de workflow par budget. À lire en premier avant tout travail d'équipe ou de release.

Suivi des features et des fixes — chaque feature et chaque fix, du plus récent au plus ancien, généré à partir d'un fichier par entrée. Le format et le raisonnement sont dans tracking/README.md.

Le runner d'agents — comment le VPS ramasse les issues agent:ready, les implémente, les relit, et s'arrête avant de merger : le flux d'étiquettes, un cycle étape par étape, quels skills chaque dépôt donne à l'agent, la planification cron, le coupe-circuit, et ce qui vous protège réellement

Inventaire des containers (PC) — ce qui tourne localement sur le poste Windows aujourd'hui
Migration Docker PC → VPS — comment monter le stack sur le VPS
Déploiement VPS via Tailscale — plan concret : remplacer le laptop, garder le téléphone sur le tailnet, servir les images depuis notre nginx
Déploiement VPS public (domaine + HTTPS) — cible production : Caddy en reverse proxy avec TLS automatique, plus de Tailscale dans le chemin applicatif
Troubleshooting VPS / déploiement — pièges récurrents (groupe docker, whiptail, gpg, RTK, gh auth) et leurs fix

Build iOS TestFlight avec EAS — compte Expo invité, copie propre de staging, contrôles, build et suivi de la soumission.
État de préparation iOS — il n'existe aucun projet ios/ ; quels bloqueurs sont réels (licence Apple, pas de caméra sur le simulateur) et lesquels sont déjà résolus (builds macOS), et pourquoi Expo ne change pas la réponse

2026-05-05 — Déploiement Option B end-to-end — récit complet : Tailscale, fix nginx mountpoint, SSH key-only, debug image scan (cleartext, .env non chargé, FAISS coverage)

Renommages de l'org GitHub — tcg-alpha → skn-tcg → snag-tcg — les deux renommages (2026-05-13 et 2026-07-30), ce qui a bougé, ce qui n'a volontairement pas bougé, et comment mettre à jour les clones locaux

Architecture des moteurs produit — carte produit des moteurs identity, collection, pricing et future marketplace
Moteurs de valorisation M1, M2 et M3 — règles raw, scellé et gradé, état d'implémentation et adaptation aux API marketplace fermées
Persona et positionnement — persona investisseur scellé, avantage produit et narrative de démo
Paysage concurrentiel — concurrents directs, apps scanner à forte menace et critères de veille
Sources data et stratégie pricing — couches de sources, posture provider et règles de pricing explicable
Plan backend collection, pricing et alertes — domaines backend, tables, APIs et roadmap phasée pour valorisation portfolio et alertes marché
Registre des risques licences et sources d'assets — règles d'usage pour assets internes, serving public, termes provider et data production-safe
Carte fonctionnelle PRD — groupes de features MVP et limites roadmap
Registre complet des retours UI/UX mobiles — historique consolidé des demandes Nini/Lulu, décisions produit, état de livraison et dépendances restantes

Ressources scan — références externes scanner, prototypes communautaires et liens API/data à revoir avant usage
Protocole d'évaluation du scan — métriques répétables pour latence scanner, accuracy endpoints, captures téléphone et réussite via correction
Inventaire des algorithmes de scan — rôles actuels de Lab, Compat, Tormknd, Combined, Frame, Sealed, Booster Lab et des fixtures POC
Revue UI/UX concurrentielle du scanner — direction UX camera-first à partir des références MonPrice, TCG CardScanner, Iestims et Zebradex
Lab scanner scellé — path backend lab pour produits scellés avec embeddings DINOv2 bruts, pgvector et ptcg-assets internal-only
Format de collecte des photos terrain scellées — protocole photo, colonnes CSV, règles de droits et format de transmission pour les associés
Instructions photo scellés pour les associés — checklist simple non technique pour des photos utilisables par YOLO, DINOv2 et l'évaluation scanner
Brief produit & marketing — améliorer la détection des scellés — ce qu'il manque pour passer du lab scellé à une détection fiable en conditions réelles
Stratégie d'optimisation de la reconnaissance — direction de travail pour DINOv2/FAISS, YOLO, OCR, reranking, reconnaissance scellé/slab et améliorations guidées par benchmark