# assets/

Tutto il materiale sorgente del progetto. Niente di qui viene pubblicato: il
deploy parte da `pwa/`, questa cartella resta in locale.

Riordinata il 03/08/2026 e ripulita il 24/09/2026: via le foto e i ritagli
fatti prima che Catch Up mandasse l'arte, che non servivano più.

## official/

L'arte ufficiale Catch Up, **come la manda l'editore**: Regioni 827x827,
Santuari 520x803, 300 dpi, sRGB, angoli arrotondati incisi su fondo bianco.
Non modificare questi file: sono la sorgente di tutto il resto.

- `base/regions/` 69 file. Sono 68 carte più il retro (`_69.jpg`, quello con la
  freccia). Il file senza numero è la carta 1. La corrispondenza col numero di
  carta è in `data/region_image_map.json`.
- `base/sanctuaries/` 46 file. 45 carte più il retro, rinominati coi numeri di
  `reference/santuari.xlsx`. Da quel numero all'id della carta ci pensa
  `data/sanctuary-numbering.json`.
- `peuple-du-dessous/` e `sous-un-ciel-detoiles/` le due espansioni, arrivate il
  03/08/2026. Qui i file sono in ordine di numero di carta, e la corrispondenza
  è scritta in testa a `recognition/import_official_art.py`. C'è anche il
  regolamento francese del Peuple du Dessous.

## squared/

Le stesse carte con gli **angoli squadrati**, che è la forma che vuole l'app: il
CSS arrotonda la card con un raggio fisso, quindi un arrotondamento inciso nel
file lascia uscire una lunetta bianca appena la carta si disegna più grande.

Le 77 Regioni le ha rifatte Paolo a mano in Photoshop; i 53 Santuari sono
l'output di `squadra()` (inpaint OpenCV), che ha confrontato con la versione
fatta a mano e ha approvato.

Da qui si installa nell'app con `recognition/install_squared.py`. Dopo
l'installazione **i descrittori ORB non corrispondono più**: rigenerare con
`recognition/orb_gallery.py --all` e ricontrollare con `recognition/test_gallery.py`.

## photos/

`tableaus/` le foto di tavoli di fine partita che servono per i test:

- `tavolo.jpg` (e l'HEIC originale): il riferimento della regressione del
  riconoscimento, l'unica inquadrata dentro la griglia dell'app. È anche la
  foto della prima slide degli store.
- `IMG_6527.HEIC`: il tavolo da 120 punti che valida il calcolo del punteggio.
  Scattata a mano libera, con la griglia fissa non si può usare per il
  riconoscimento.
- `panno.heic` e `tovaglia.heic`: sfondi difficili (feltro verde, tovaglia a
  fantasia), per quando si vorrà migliorare il riconoscimento.

## logo/

- `faraway-logo-ufficiale.png`: il logo di Catch Up, da cui nasce
  `pwa/img/faraway-logo.png` (ritagliato a filo).
- `icona-catchup-F.jpg`: la F sulla carta ruvida, sorgente di tutte le icone
  (`build-icone.py`).
- `faraway-logo-originale.png` e `faraway-logo-rifatto.png`: le versioni di
  prima dell'autorizzazione, tenute come storico.

## store/

`icon.png`, `splash.png`, `splash-dark.png`: i file che `build-icone.py`
genera per le app native.

## reference/

- `santuari.xlsx`: la numerazione dei Santuari.
- `Faraway_analysis.xlsx`: il foglio di BoardGameGeek da cui è nato `cards.js`
  (non ufficiale, con errori corretti a mano: vedi il README).
- `Faraway_Reference_terms.pdf`: il glossario dei termini del gioco.