docs: README e spec Longevity al 26/09

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-26 14:02:23 +00:00
parent 8f95a385d9 558def3d52
commit 880c928f43
2 changed files with 78 additions and 3 deletions
@@ -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.
@@ -487,6 +487,31 @@ parte.

 ---

+## 13. Il gestionale in produzione (26/09)
+
+Costruito e messo in linea il 26/09/2026 su `piattaforme.tielogic.xyz` (issue
+`gitea:Adriano/InsanityLab-web` #1 #2 #5 #7 #8 #9 #10, merge in `main` 12b2e91 e 8f95a38).
+Chiude o supera diversi punti delle §11 e §12:
+
+| Punto | Com'è stato chiuso |
+|---|---|
+| §12.1 conferma delle misure fuori range | colonne `verifica` (`confermata`/`scartata`), `verificata_da`, `verificata_at` su `misure`, aggiunte da `migra()` sui database esistenti; il trainer decide dalla scheda cliente; una conferma ricalcola quella sessione e le successive (#7) |
+| §12.6 e 12-bis, test fisici irraggiungibili | 24 test `f_` nel registro e `motore/fisici.ts` (`sottoDominiFisici(misure, eta, sesso)`), stessa mappatura della funzione dimostrativa dell'oracolo; fuori perimetro spirometria, milfit, 2 km walk, sit-to-stand, trazione isometrica (#1) |
+| §8 vista trainer | `/longevity/gestionale`: clienti, nuovo cliente, scheda, check-up, accesso del cliente al referto (#2 #8) |
+| §6 progressione e cambio di versione | `/longevity/progressione`, con il cambio di `model_version` segnato sul grafico (#5) |
+| §11.1 consenso art. 9 | firmato su carta prima dell'accesso, fuori dalla piattaforma: decisione di Adriano, 26/09 (#6) |
+
+**Una regola nuova, non prevista dalla §7:** check-up e questionario sono sessioni distinte. Il
+calcolo di una sessione usa, per ogni test, la **misura valida più recente del cliente fino alla
+data della sessione** (`misureValideAlla`); «valida» vuol dire dentro il range oppure confermata.
+Oggi una misura non scade (`FINESTRA_GIORNI = null`).
+
+🔲 **Ancora aperti, di Nicola:** la finestra di validità delle misure; il medico supervisore
+(§11.2); i file reali di Wellness Tower e dinamometro per gli import (#3); la definizione dei
+percentili interni (#4); le domande di 12-bis su `hrv` e sul plank.
+
+---
+
 ## 12. Decisioni prese, e da chi

 | Decisione | Chi | Quando |
@@ -502,3 +527,6 @@ parte.
 | Registro di misure invece di colonne fisse | Adriano | 21/08 |
 | Il progetto è unico: un framework sui dati del cliente | Adriano | 21/08 |
 | Calcolo in TypeScript, non Python | Tielogic (verificato sul codice) | 21/08 |
+| Piattaforme separate dal sito, su `piattaforme.tielogic.xyz` | Adriano | 03/09 |
+| Gestionale trainer in produzione | Adriano | 26/09 |
+| Consenso ai dati sanitari su carta, nessun registro in piattaforma | Adriano | 26/09 |