# Il gestionale dei contatti, per Valentina

Dal 29/9/2026 il foglio "🎲 Editori BoardGame" diventa un gestionale: stessi editori, autori e illustratori, più i
giochi collegati e la cronologia di ogni contatto (chi ha scritto cosa, quando, con quale canale).

## A mano

- Indirizzo: **https://bg-perspective.it/gestionale**
- Nome: `valentina`. La password te la passa Paolo.
- **Editori**: in alto chi è da ricontattare nelle prossime due settimane (i tuoi), sotto l'elenco con lo stato di
  Paolo e il tuo, come le vecchie colonne P e V. Nella scheda di un editore cambi il tuo stato (in attesa, mandano,
  no) e la data in cui ricontattarlo, e aggiungi alla cronologia i messaggi mandati e ricevuti.
- **Persone** e **Giochi**: autori, illustratori e giochi, collegati fra loro e agli editori.
- Ognuno cambia solo il proprio stato e i propri messaggi; i dati di editori e persone sono di tutti e due.
- **Correggere i dati di un editore** (nome, Instagram, mail, sito, come contattarli, scheda): nella sua scheda, sotto
  i dati, c'è il link **"Modifica i dati"**; si cambia e si preme **Salva**. Resta scritto chi l'ha modificato e quando.

- **Follow** (dal 2/10): in alto chi ha ricambiato il follow di Paolo dopo un suo DM, account attivi da seguire;
  quando ne segui uno premi **Seguito**. Sotto ci sono i tuoi ricambiati e vedi quali ha già seguito Paolo. I tuoi li
  carica il tuo Claude, ogni lunedì (vedi sotto).

## Con il tuo Claude

Metti la chiave che ti passa Paolo in una variabile d'ambiente (per esempio nel file `~/.zshrc`:
`export GESTIONALE_CHIAVE="..."`), non in un file che condividi. Poi aggiungi queste righe alle istruzioni del tuo
Claude (il file `CLAUDE.md`, o le istruzioni del progetto):

```
## Gestionale contatti con Paolo (bg_perspective)
Editori, autori, illustratori e la cronologia dei contatti stanno su https://bg-perspective.it/api/gestionale.
La guida delle API si legge con: curl -s https://bg-perspective.it/api/gestionale
Ogni altra richiesta vuole l'intestazione: -H "Authorization: Bearer $GESTIONALE_CHIAVE"
(la chiave non si stampa e non si scrive mai in chiaro nei comandi o nei file).
Quando scrivo o ricevo un messaggio da un editore, lo registro con
POST /api/gestionale/editori/{nome}/contatti {"tipo":"inviato|ricevuto|nota","canale":"mail","testo":"..."}
e aggiorno il mio stato con PUT /api/gestionale/editori/{nome}/stato {"stato":"attesa|si|no","ricontatto_il":"AAAA-MM-GG"}.
Prima di scrivere a un editore leggo la sua scheda (GET /api/gestionale/editori/{nome}) per vedere cosa gli ha già
scritto Paolo.
Ogni lunedì carico chi ha ricambiato il mio follow dopo un DM nella settimana, con POST /api/gestionale/follow
{"account":[{"handle":"...","ricambiato_il":"AAAA-MM-GG","lingua":"...","descrizione":"di cosa parla, in italiano"}]},
e leggo quelli di Paolo da seguire con GET /api/gestionale/follow?di=paolo&da_seguire=1.
```

Tutto quello che scrive il tuo Claude risulta a tuo nome, come se l'avessi scritto tu dalla pagina.