docs: README piattaforme e spec Longevity aggiornati al gestionale in produzione

README: host piattaforme.tielogic.xyz, conteggio test, sezione Longevity (ruoli,
pagine, regola della misura valida più recente), procedura di aggiornamento con
backup, dati nel volume, apertura pigra del DB, trappole dei test e node_modules.
Spec: §13 con i punti di §11/§12 chiusi da #1 #2 #5 #6 #7 #8 e quelli ancora aperti;
decisioni del 03/09 e 26/09.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

apps/platforms/README.md

@@ -1,4 +1,4 @@
-# InsanityLab — aree riservate (`apps.insanitylab.it`)
+# InsanityLab — aree riservate (`piattaforme.tielogic.xyz`)
 
 Applicazione Astro autosufficiente con le tre aree riservate: **Biohacking Campus**,
 **Stress Index** e **Longevity**. Nasce il 03/09/2026 separando dal sito
@@ -8,7 +8,7 @@ Applicazione Astro autosufficiente con le tre aree riservate: **Biohacking Campu
 
 | | Sito | Quest'app |
 |---|---|---|
-| Host | `insanitylab.it` | `apps.insanitylab.it` |
+| Host | `insanitylab.it` | `piattaforme.tielogic.xyz` (in futuro anche `apps.insanitylab.it`) |
 | Utenti | 3 redazionali (`admin`, `superuser`, `user`) | uno per ogni cliente del centro (`piattaforme`, `cliente`, `trainer`, `admin`) |
 | Database | `insanitylab.db` (contenuti, articoli, utenti del sito) | `piattaforme.db` + `longevity.db` + `identity.db` |
 | Login | `/admin/login`, solo redazione | `/login`, ed è l'unica porta |
@@ -22,12 +22,31 @@ separazione, non un difetto. Le due `lib/auth.ts` sono parenti ma non sono la st
 ```bash
 npm ci
 npm run dev                      # http://localhost:4321
-npm test                         # 26 file, 197 test
+npm test                         # 32 file, 261 test (26/09/2026)
 npm run create-user -- <nome> <password> <ruolo>   # ruoli: piattaforme, cliente, trainer, admin
 ```
 
 I dati stanno in `data/` (gitignorata): `piattaforme.db`, `longevity.db`, `identity.db`.
 
+## Longevity: cosa c'è
+
+| Chi | Dove | Cosa fa |
+|---|---|---|
+| `trainer`, `admin` | `/longevity/gestionale` | elenco clienti, nuovo cliente (apre il fascicolo su identity e longevity), scheda cliente con referto, sessioni e **misure da verificare** (conferma/scarta), nuovo check-up con i 24 test fisici `f_`, **crea accesso** al referto (password mostrata una volta) |
+| `cliente` | `/longevity/io`, `/longevity/progressione`, `/longevity/questionario` | il proprio referto (radar, macro-score, Fitness Age), l'andamento nel tempo, il questionario |
+
+`/longevity` smista: staff al gestionale, cliente al referto. Ogni pagina ha un'uscita:
+il referto porta «Piattaforme» e, allo staff, «← Gestionale».
+
+Il calcolo di una sessione usa, per ogni test, **la misura valida più recente del cliente fino
+alla data della sessione** (`misureValideAlla` in `lib/longevity/motore/index.ts`): check-up e
+questionario sono sessioni separate e si combinano. Una misura fuori dal range di plausibilità
+non conta finché il trainer non la conferma; confermarla ricalcola quella sessione e le
+successive. `FINESTRA_GIORNI = null`: oggi una misura non scade — la durata la decide Nicola.
+
+Fuori per ora: import Wellness Tower e dinamometro (#3), percentili interni (#4). Il consenso ai
+dati sanitari è firmato su carta prima dell'accesso (decisione di Adriano, 26/09, #6).
+
 ## Rilascio
 
 ⚠️⚠️ **Il DNS viene prima del container.** `apps.insanitylab.it` deve già risolvere verso
@@ -42,6 +61,24 @@ node scripts/migra-utenti.mjs                        # prova a vuoto
 node scripts/migra-utenti.mjs --applica              # porta gli utenti dal DB del sito
 ```
 
+**Aggiornare una versione già in linea** (checkout `/opt/docker/insanitylab-apps`, su `main`):
+
+```bash
+D=/opt/docker/insanitylab-platforms/data; B=/opt/docker/insanitylab-platforms/backup/$(date -u +%Y%m%dT%H%M%SZ)
+mkdir -p $B && for f in longevity identity piattaforme; do sqlite3 $D/$f.db ".backup '$B/$f.db'"; done
+git pull --ff-only origin main
+cd apps/platforms && docker compose up -d --build
+```
+
+⚠️ **I dati veri sono in `/opt/docker/insanitylab-platforms/data`** (il volume del compose), non
+in `apps/platforms/data` del checkout: quella è una copia vecchia che il container non legge.
+
+⚠️ **Il database di Longevity si apre alla prima richiesta autenticata**, non all'avvio: le
+migrazioni (`migra()` in `lib/longevity/db.ts`, colonne aggiunte con `ALTER TABLE`) e il seed del
+registro partono solo allora. Per farle subito, dopo il deploy:
+`docker exec -w /app insanitylab-platforms node --input-type=module -e 'const m = await import("/app/dist/server/chunks/<chunk db>.mjs"); m.<getLongevityDb>()'`
+(nome del chunk e dell'export con `grep -l registro_test -r dist/server/chunks`).
+
 ## Trappole già pagate
 
 ⚠️ **Le versioni si fissano esatte.** `^7.0.5` sulla nuova app aveva risolto ad **astro
@@ -65,5 +102,15 @@ qualcuno. Una rotta nuova senza regola risulta **vietata**, e lo si scopre prova
 ⚠️ **Le API rispondono con uno stato, non con un redirect** (401/403 su `/api/*`): mandare
 un 302 verso il login a chi ha chiesto del JSON produce un 200 con dentro dell'HTML.
 
+⚠️ **Due test vietano parole, non codice.** `tests/longevity/anagrafica.test.ts` fallisce se un
+file `.ts`/`.astro` contiene insieme «Identity» e «Longevity» (anche in un commento): solo
+`lib/longevity/anagrafica.ts` e `db.ts` possono aprire i due database insieme.
+`tests/longevity/referto.test.ts` intercetta «select» come SQL, anche l'HTML `<select>`: nei
+form si usano i radio.
+
+⚠️ **`node_modules` non si traccia.** Il pattern era `node_modules/`, che ignora le cartelle ma
+non i symlink: un symlink verso il checkout di produzione era finito in git e un `npm ci` in un
+clone svuotava la cartella di produzione (#9). Ora il pattern è `node_modules`.
+
 ⚠️ **Stress Index non ha un backend**: `src/lib/stress-index/data.ts` sono dieci clienti
 inventati scritti a mano. In linea c'è la sua interfaccia, non i suoi dati.