Index des docs par repo — discoverability

Cette page indexe la documentation qui vit dans chaque repo, pas sur ce site documentation/. Utilise-la quand tu cherches une référence opérateur, un plan de build, ou le log d'ingénierie PR-par-PR pour un service précis.

La séparation est volontaire :

• Les pages de ce site (documentation/guide/{fr,en}/…) sont la narration transverse — vues d'architecture qui chevauchent plusieurs repos, ADR-light, comparaisons, récits de migration. Elles bougent quand une histoire bouge.
• Les docs par repo sont des références opérateur + contributeur collées au code qu'elles décrivent — env vars, formes de routes, codes d'erreur, plans de build, règles de branche, logs vivants CHANGELOG / DONE / TODO. Elles bougent dans la même PR que le code.

Nouveau contributeur ? Commence ici, puis plonge dans les docs du repo concerné.

poc-tcg-collector — POC Android React Native

github.com/snag-tcg/poc-tcg-collector

L'app scanner côté utilisateur. RN 0.84.1 JS / 0.73.6 Android-native, TypeScript strict, Hermes, mono-utilisateur, local-first.

Doc	Couvre
README.md	Point d'entrée — ce qu'est le POC, lien quick-start
CLAUDE.md	Contrat d'équipe d'agents — rôles Angelo / Mamo / Manu / Milana / Zaher, gate de review, règles dures
AGENTS.md	Même contrat pour la CLI Codex (parallèle de CLAUDE.md, pas un doublon)
doc/RUN.md	Du clone au scan — trois chemins d'exécution, vérification
doc/POC_NARRATIVE.md	Le « pourquoi on construit » — persona (sealed investor), flow de démo, gap concurrents
doc/POC_BUILD_PLAN.md	Découpage des sprints, planning des tâches
doc/INFRA.md	Décisions d'infrastructure backend Hetzner VPS, verrouillées
doc/SCANNER.md	Pipeline scanner on-device — src/scan/…, détection de carte, perspective warp
doc/SCAN_FLOW.md	Flow de scan pas-à-pas, capture → résultat
doc/BACKEND_SCAN.md	Comment l'app appelle chaque endpoint de scan backend
doc/SCHEMA.md	Modèle de données carte / collection / portfolio
doc/COMPETITORS_OVERVIEW.md	~100 entités inventoriées dans 7 catégories, matrice de menace
doc/COMPETITOR_DATA_SOURCES.md	Inventaire des sources de données par TCG (Scryfall, OPTCG API, Lorcast, etc.)
doc/HOW_WE_STAND_OUT.md	Positionnement vs concurrents
doc/POKEMON_API_REVIEW.md	Évaluation TCGdex / PokémonTCG.io / pokeapi.co
doc/PTCG_ASSETS_REVIEW.md	Évaluation des assets images
doc/BOILERPLATE_SETUP.md	Toolchain de build, config Metro / Babel, le mismatch React/RN volontaire
doc/VPS_CLAUDE_SETUP.md	Installation de Claude Code sur le VPS
doc/CHANGELOG.md	Log d'ingénierie par PR (living doc, mis à jour à chaque PR)
doc/DONE.md	Ce qui a été livré (living doc)
doc/TODO.md	Suite des tâches (living doc)
doc/competitor-watch/	Scans de concurrents hebdomadaires datés
doc/lp-winners-watch/	Scans de landing pages gagnantes datés

Traductions françaises des docs utilisateur sous doc.bkk/.

tcg-collector-backend — API Fastify + ingest + endpoints de scan

github.com/snag-tcg/tcg-collector-backend

Backend Node 22 + TypeScript sur VPS Hetzner. API HTTP Fastify, worker d'ingest idempotent, sidecar embeddings (Python + DINOv2-small), Postgres 16 avec pgvector, nginx en façade.

Doc	Couvre
README.md	Point d'entrée
CLAUDE.md	État du repo, commandes, conventions de branchement
docs/ARCHITECTURE.md	Diagrammes mermaid — stack Docker, séquences de requêtes, schéma DB (ERD), state machine d'auth
docs/BACKEND.md	Référence des endpoints (/cards, /sets, /stats, /audit, /healthz, /metrics)
docs/SCAN.md	Référence opérateur POST /scan — request/response, codes d'erreur, pipeline OCR, pipeline vision-embedding, invariants sécurité, troubleshooting
docs/RUNNING.md	Démarrer la stack — recettes Docker compose
docs/OPERATIONS.md	Runbook ops — ingest longue durée, backups, recovery
docs/INGEST.md	Runbook ingest unifié — pipeline, modes fire-and-forget + since, sources par TCG (Pokémon/TCGdex avec multi-langues, One Piece/OPTCG, Magic/Scryfall), roadmap Option B stockage per-langue
docs/ROADMAP.md	Roadmap backend (vit uniquement sur les branches docs/… — voir CLAUDE.md)
docs/scanner/	Deep-dives scanner : TCG_VISION.md, SCANNER_ACCURACY_OPTIONS.md, SCAN_PATHS.md, BACKEND_SCAN.md, COMPETITOR_SCAN_ARCHITECTURE.md, POKEMON_CARD_SCANNING_PRIMER.md, pipeline d'ingest, etc.
docs/features/next.md	Notes sur les features à venir
CHANGELOG.md	Log d'ingénierie par release
PROGRESS.md	Ce qui est en cours maintenant
DONE.md	Ce qui a été livré
TODO.md	Suite des tâches
PRODUCT.md	Contexte produit
DESIGN.md	Tokens de design / handoff UI admin Cardex

Note de branchement : selon le CLAUDE.md backend, CHANGELOG.md, PROGRESS.md et docs/ROADMAP.md ne bougent que sur les branches docs/…, jamais sur les branches feature.

routines — monorepo Go pour les routines de signaux concurrents

github.com/snag-tcg/routines

Repo Go multi-binaire. Chaque routine est un binaire, packagé en service Docker distroless, déclenché par cron VPS. Écrit des rapports datés bilingues EN/FR sous out/. Pas de DB, pas d'API LLM, pas de queue.

Doc	Couvre
README.md	Point d'entrée — liste des routines, quick-start
doc/ARCHITECTURE.md	Layout du monorepo Go, structure des binaires, diagrammes C4
doc/DEPLOYMENT.md	Setup VPS, Docker, scheduling cron (français)
doc/BRAINSTORM.md / .fr.md	Living doc — idées de futures routines, suivi du statut
doc/competitor-watch/	Sous-doc competitor-watch

tgc-app — app scanner de référence de Tormknd

github.com/Tormknd/tgc-app (upstream ; commit pinné dans notre container tcg-vision)

Scanner Python + FastAPI de référence utilisant DINOv2 ViT-S/14 + FAISS. On l'a cloné comme base de tcg-vision, notre sidecar de scan-comp.

Doc	Couvre
README.md	Point d'entrée du projet de Tormknd
BACKEND_SPECS.md	Spec ML d'implémentation figée — FastAPI, FAISS, prétraitement OpenCV, perspective transform

Pour notre adaptation, voir scan-comp et tcg-collector-backend/docs/scanner/TCG_VISION.md.

create-best-product — toolkit niche-agnostique d'intel concurrents

github.com/snag-tcg/create-best-product

Toolkit Go self-hosted qui mine les reviews 1-étoile + les plaintes Reddit + les signaux de nouveaux entrants pour alimenter une roadmap produit. Standalone — a son propre README/BUSINESS/HONEST_TAKE parce qu'il est conçu pour être clonable. Le setup TCG-collector est préservé en exemple sous examples/tcg/.

Doc	Couvre
README.md / .fr.md	Point d'entrée + proposition de valeur (bilingue)
doc/ARCHITECTURE.md	Architecture du toolkit, layout monorepo Go
doc/DEPLOYMENT.md	Setup Docker, scheduling cron
doc/BRAINSTORM.md / .fr.md	Living doc des futures routines
doc/BUSINESS.md / .fr.md	Avis honnête sur la vente — trois pistes viables, positionnement marché
doc/HONEST_TAKE.md / .fr.md	Évaluation honnête, sans vernis marketing
doc/ADAPT_TO_YOUR_NICHE.md / .fr.md	Comment customiser le catalogue de thèmes pour une autre niche

frontend — site marketing public

github.com/snag-tcg/frontend

Doc	Couvre
README.md	Instructions de setup et de lancement

Comment garder cette page utile

Quand une nouvelle doc côté repo est ajoutée, append une ligne à la bonne table ici dans la même PR. Quand une doc est renommée ou supprimée, mettre à jour ou retirer la ligne. La page n'est pas exhaustive — les rapports datés competitor-watch, les assets de design-handoff et autres artéfacts générés sont liés au niveau du dossier plutôt qu'au fichier.

En cas de doute sur l'endroit où une nouvelle doc doit vivre :

• Transverse aux repos, en forme de récit, je le linkerais depuis une roadmap ? → documentation/guide/{fr,en}/
• Lié à des chemins de code précis, des env vars, des formes de routes, ou des logs vivants ? → doc/ ou docs/ dans le repo