Fase 0 · Validazione12 in coda · 1 in corsogenerato dal repository il 2026-11-11

FAMASalute

ἀνάπνει τὴν ζωήν · respira la vita

Postura, movimento e respiro da telefono e sensori, e piani di allenamento e alimentazione che imparano dalla settimana prima. Validato dal giudizio di un medico e di un osteopata e dallo spirometro.

Respiro a riposo, traccia illustrativa · Vt ≈ 0,5 L · 12 atti/min · inspirazione 40% del ciclo
01

Sintesi e visione

*ἀνάπνει τὴν ζωήν* · respira la vita

Panoramica in prosa del progetto. Moduli, regole, evidenze, ipotesi, decisioni e commesse sono note nelle cartelle accanto.

Sintesi

FAMASalute legge postura, movimento e respiro da telefono e sensori indossabili e costruisce piani di allenamento e alimentazione che imparano dalla settimana precedente. Il vantaggio non è una rete neurale, che parte da modelli già esistenti, ma ciò che nessuno ha già pronto: il giudizio di un medico e di un osteopata come etichette, i modelli di meccanica polmonare di un ingegnere biomedico, lo spirometro come misura di riferimento e un metodo di pianificazione già in uso su una persona.

Il progetto corre su due binari.

BinarioCosa faStato
A · Movimento e respiroStima della posa, qualità del movimento, respiro da video e orologio, screening periodicoIn validazione con il team (Fase 0)
B · Allenamento, alimentazione, recuperoPiano settimanale con tre cicli annidati, registro delle ipotesi e regole appreseGià in uso su una persona; metodo spostato qui

I binari si incontrano in due punti: lo screening periodico diventa un segnale di recupero per i piani (H7), e il coaching porta tutto sugli stessi dispositivi.

Il lavoro che la persona ci affida

Quando mi alleno o faccio i miei esercizi a casa, voglio sapere se li sto eseguendo e respirando nel modo giusto e cosa fare la settimana prossima, così da migliorare senza avere un professionista accanto ogni volta.

Perché postura e respiro insieme

Le app di movimento guardano le articolazioni, quelle di respirazione il ritmo. Postura del tronco e del collo, diaframma e schema respiratorio però sono legati, ed è un tema centrale per l'osteopatia. Esistono già servizi digitali di riabilitazione muscolo-scheletrica (Sword Health, Hinge Health, Kaia), ma lavorano sul movimento, non sul legame con il respiro.

Metodo e dati

Questo repository contiene il metodo, mai i dati. Le regole di alimentazione e allenamento sono state copiate da un metodo che Andrea S. usava su se stesso, ma qui ci sono solo la logica e le fonti: i vincoli alimentari, i dati fisici e le misure di una persona vivono nella sua memoria personale sul NAS e arrivano al pianificatore solo quando serve. Così il metodo si applica a un'altra persona cambiando il profilo, senza toccare una regola.

Ambito

Fuori perimetro in Fase 0. Volumi polmonari assoluti stimati dal video; diagnosi o indicazioni terapeutiche; pazienti o persone esterne al team; addestramento di modelli di posa da zero; pubblicazione sugli store e monetizzazione prima del G2.

Posizionamento regolatorio. Fase 0 e 1: ricerca e benessere, nessuna promessa diagnostica o terapeutica. Al G2 si decide se restare nel benessere o intraprendere il percorso da dispositivo medico software (MDR). Le prove raccolte servono in entrambi i casi.

Come lavoriamo

Ognuno lavora nel tempo libero, quindi niente sprint né scadenze (ADR-015): c'è una coda di commesse in ordine di priorità e ognuno prende la prossima che sa fare, una alla volta. Ogni commessa ha un solo responsabile e un criterio "fatto quando". Una commessa si può passare a chiunque del gruppo, sempre con il motivo e una nota per chi la riceve, oppure chiudere come non necessaria (ADR-017). Ognuno decide nelle sue aree dopo aver sentito chi ne subisce le conseguenze e lo annota nel diario condiviso; le decisioni di squadra passano solo all'unanimità (ADR-018). Chi non lavora nel repository usa l'hub: vede le sue commesse con la guida a passi e consegna con un modulo. A fine fase un gate decide se andare avanti, e ogni decisione diventa un ADR.

Domande aperte

DomandaPerché serve una risposta
Livelli di competenza di ciascunoPartono da una stima da confermare (C-13)
Approvazione delle decisioni di squadraSenza unanimità restano proposte (C-14)
Per chi è, all'inizioVoi stessi, i pazienti di Marco, i professionisti o un pubblico generico
AmbizioneProgetto per imparare e portfolio, o impresa
Dove stanno fisicamente i dati grezziNAS a casa di Andrea S. o PC nello studio di Francesco
Hosting dell'hubPagina privata su claude.ai o Cloudflare Pages con accesso limitato
02

Principi

PrincipioPerché
P1Metodo separato dai dati
Il repository contiene il metodo: regole, evidenze, protocolli, moduli e decisioni. I dati su cui il metodo lavora (misure, video, spirometrie, vincoli e obiettivi di una persona) vivono nella memoria personale sul NAS. Se il metodo funziona, si applica a un'altra persona cambiando solo il profilo.
Regola generale di Andrea S. per tutti i suoi progetti: estrarre un modello che funziona senza doverlo ripulire dai dati.
P2Nessun dato sanitario in git
Video, tracciati, export di Salute ed etichette collegate a una persona non entrano mai nel repository, nemmeno per errore: il checker rifiuta i tipi di file e i tipi di nota riservati.
La storia di git non si cancella facilmente: è incompatibile con il ritiro del consenso.
P3Ogni regola dichiara la sua origine
Una regola nasce da un'evidenza citata, da una pratica concordata o da un'ipotesi confermata più volte sui dati. Senza origine non entra nel metodo.
Evita regole inventate o ricordate male, e permette di toglierle quando l'evidenza cambia.
P4Una variabile alla volta
Si cambia un intervento per volta e lo si valuta su una finestra adeguata: una settimana per il carico, quattro per la dieta, otto per i programmi di allenamento.
Con un campione di una persona è l'unico modo per distinguere l'effetto di un cambiamento dal rumore.
P5Criteri prima dei dati
Ogni ipotesi ha il suo criterio di superamento scritto prima di raccogliere i dati, e ogni misura stimata si confronta con una misura di riferimento (clinici, spirometro).
Impedisce di aggiustare la soglia dopo aver visto il risultato.
P6Nessuna diagnosi
FAMASalute suggerisce e segnala; le decisioni cliniche, gli integratori e la lettura degli esami spettano al medico. Davanti a un'anomalia il sistema indirizza al medico.
Sicurezza delle persone e confine con il regolamento sui dispositivi medici.
P7Attrito minimo per chi raccoglie i dati
Una registrazione costa un tocco. Tutto ciò che può essere passivo lo è. La dieta si traccia come aderenza al piano, non pesando il cibo.
L'attrito fa saltare la raccolta dopo due settimane, e senza dati il metodo non impara.
P8Locale per impostazione predefinita
I dati grezzi restano sul dispositivo o sul NAS. Al modello cloud arrivano solo riepiloghi aggregati e senza identificativi, quando servono per il giudizio.
Privacy delle persone e indipendenza dai servizi esterni.
P9Una commessa, un responsabile
Ogni commessa ha una sola persona responsabile e un criterio "fatto quando" verificabile da qualcun altro.
In un gruppo di amici con poco tempo, la responsabilità condivisa diventa responsabilità di nessuno.
P10Niente aggiornamenti a mano
Regola d'oro dell'area coordinamento (ADR-020). Tutto ciò che si può ricavare dalle note si genera da solo: sito, hub, moduli, stati delle commesse, accettazione delle decisioni. Una persona scrive un fatto una volta sola, attraverso un modulo o una nota; il resto lo aggiornano le automazioni. Se una nuova funzione richiede un aggiornamento manuale ricorrente, non è finita.
Ciò che richiede un aggiornamento manuale prima o poi resta indietro, e chi lo legge si fida di un dato vecchio.
03

Team e competenze

Andrea S.
Progettazione, sviluppo, project management, governance dei dati
Aree: Piani alimentari, Piani di allenamento, Ciclo di apprendimento, Coaching multidispositivo, Raccolta dati, Recupero e prontezza, Coordinamento
1 in corso
6 commesse non chiuse come responsabile · apri il suo hub
Francesco
Medico: validazione clinica, spirometria in studio, etichettatura
Aree: Validazione clinica e spirometria
0 in corso
1 commesse non chiuse come responsabile · apri il suo hub
Marco
Osteopata: validazione clinica, scheda di etichettatura, punto di vista dei professionisti
Aree: Movimento e postura, Screening periodico
0 in corso
0 commesse non chiuse come responsabile · apri il suo hub
Andrea F.
Meccanica polmonare, modelli, protocolli di validazione e statistica
Aree: Respiro
0 in corso
0 commesse non chiuse come responsabile · apri il suo hub

Competenze dichiarate

Livelli da 0 a 3 (○○○ mai fatto, ●○○ base, ●●○ autonomo, ●●● lo fa per lavoro), dichiarati da ciascuno e modificabili quando vuole. Nessun punteggio calcolato (ADR-016). I livelli iniziali sono stime da confermare (C-13).

CompetenzaAndrea S.FrancescoMarcoAndrea F.
Allenamento e preparazione fisica
clinical
●○○●○○●●○○○○
Nutrizione
clinical
●○○●●○○○○○○○
Spirometria
clinical
○○○●●●○○○●●○
Valutazione clinica del respiro
clinical
○○○●●●●●○○○○
Valutazione clinica di postura e movimento
clinical
○○○●●○●●●○○○
Governance dei dati e GDPR
data
●●●○○○○○○○○○
NAS, rete e infrastruttura dati
data
●●○○○○○○○○○○
Meccanica polmonare
engineering
○○○○○○○○○●●●
Modellazione in MATLAB
engineering
○○○○○○○○○●●●
Statistica e studi di validazione
engineering
●○○●○○○○○●●●
Sviluppo Python e pipeline dati
engineering
●●●○○○○○○●●○
Sviluppo di app mobile
engineering
●○○○○○○○○○○○
Visione artificiale e machine learning
engineering
●○○○○○○○○●○○
Esperienza d'uso e design
product
●●○○○○●○○○○○
Mercato dei professionisti (osteopati, fisioterapisti)
product
○○○○○○●●●○○○
Project management
product
●●●○○○○○○○○○
Regolatorio dei dispositivi medici
product
●○○●○○○○○●○○

Competenze che mancano

Nessuno del gruppo è sopra il livello 1: qui bisogna imparare o trovare qualcuno.

CompetenzaLivello più altoServe a
Sviluppo di app mobile●○○—
Regolatorio dei dispositivi medici●○○—
Visione artificiale e machine learning●○○—

Storia delle commesse

ChiusePassate ad altriRicevute
Andrea S.C-09——
Francesco———
Marco———
Andrea F.———
04

Moduli

Binario A · Movimento e respiro

M1 Movimento e postura
pianificato

Legge postura e qualità del movimento dal video del telefono: angoli articolari, compensi, asimmetrie. Binario A.

Responsabile
Marco
Componenti
C06 · Stima della posa sul dispositivo, C07 · Classificatore di movimento, C04 · Archivio cifrato sul NAS con DVC
Dispositivi
iPhone, AirPods Pro
Dipende da
—
Regole
0
M2 Respiro
pianificato

Frequenza, ritmo e tipo di respiro (toracico o addominale) da video e orologio, validati con lo spirometro. Il legame con la postura è il punto che distingue FAMASalute. Binario A.

Responsabile
Andrea F.
Componenti
C08 · Modello ibrido del respiro, C04 · Archivio cifrato sul NAS con DVC
Dispositivi
iPhone, Apple Watch, Spirometro dello studio
Dipende da
Movimento e postura
Regole
0
M3 Screening periodico
pianificato

Ogni 2–4 settimane: 5 movimenti standard e 3 schemi di respiro, con un punteggio che si segue nel tempo. Dati puliti e ripetibili per il binario A e un segnale lento per i cicli lunghi del binario B.

Responsabile
Marco
Componenti
C06 · Stima della posa sul dispositivo, C08 · Modello ibrido del respiro
Dispositivi
iPhone
Dipende da
Movimento e postura, Respiro
Regole
0

Binario B · Allenamento, alimentazione, recupero

M4 Piani di allenamento
in uso

Genera la settimana di allenamento: aggiusta il carico ogni settimana sui segnali di recupero e cambia programma per mesocicli di 8 settimane, valutati su indicatori di forza e resistenza. Binario B.

Responsabile
Andrea S.
Componenti
C05 · Motore di calcolo deterministico, C09 · Pianificatore settimanale, C11 · Integrazione con il calendario
Dispositivi
Apple Watch, Calendario
Dipende da
Recupero e prontezza, Raccolta dati
Regole
5
M5 Piani alimentari
in uso

Genera piano settimanale, meal prep e lista della spesa rispettando i vincoli del profilo della persona; un solo intervento dietetico per blocco di 4 settimane; copertura dei micronutrienti a regole settimanali. Binario B. Il metodo vive qui, separato dal profilo personale (ADR-008).

Responsabile
Andrea S.
Componenti
C05 · Motore di calcolo deterministico, C09 · Pianificatore settimanale
Dispositivi
Bilancia a bioimpedenza
Dipende da
Raccolta dati
Regole
10
M6 Recupero e prontezza
pianificato

Indice di prontezza da FC a riposo, temperatura del polso, sonno, frequenza respiratoria notturna e, dalla Fase 1, qualità del movimento (H7). Decide se spingere o scaricare.

Responsabile
Andrea S.
Componenti
C05 · Motore di calcolo deterministico
Dispositivi
Apple Watch
Dipende da
Raccolta dati
Regole
3
M7 Ciclo di apprendimento
in uso

Ogni piano contiene ipotesi esplicite; la settimana dopo vengono chiuse; quelle confermate più volte diventano regole apprese. Tre cicli annidati: settimana, blocco di 4 settimane, mesociclo di 8. Lo stato ha dimensione fissa.

Responsabile
Andrea S.
Componenti
C10 · Registro ipotesi e regole apprese, C05 · Motore di calcolo deterministico
Dispositivi
—
Dipende da
Raccolta dati
Regole
5
M8 Raccolta dati
in uso

Export completo di Salute elaborato sul NAS, registrazioni a un tocco, check-in serale, RPE dall'app Allenamento, protocollo di pesata.

Responsabile
Andrea S.
Componenti
C01 · Comandi Rapidi di raccolta, C02 · Parser dell'export di Salute, C03 · Schema dati comune e adapter, C04 · Archivio cifrato sul NAS con DVC
Dispositivi
iPhone, Apple Watch, Bilancia a bioimpedenza
Dipende da
—
Regole
1

Punto d'incontro

M9 Coaching multidispositivo
pianificato

Porta il risultato dove serve: guida e correzioni sul telefono, aptica e richiami sull'orologio, voce negli auricolari, eventi in calendario, report per il clinico.

Responsabile
Andrea S.
Componenti
C11 · Integrazione con il calendario, C09 · Pianificatore settimanale
Dispositivi
iPhone, Apple Watch, AirPods Pro, Calendario, Report per il clinico
Dipende da
Movimento e postura, Respiro, Piani di allenamento, Piani alimentari
Regole
0
05

Architettura

Livelli e componenti

LivelloComponenti
S1Acquisizione
Sensori, fotocamera e registrazioni soggettive producono i dati grezzi
C01 · Comandi Rapidi di raccolta in uso
S2Ingestione e schema comune
Ogni fonte entra tramite un adapter e diventa uno schema dati unico
C02 · Parser dell'export di Salute in uso
C03 · Schema dati comune e adapter pianificato
S3Archivio e versioni dei dati
Dati cifrati sul NAS, dataset versionati e riproducibili
C04 · Archivio cifrato sul NAS con DVC pianificato
S4Calcolo deterministico
Medie, trend, zone di frequenza, aderenza: codice, non modelli
C05 · Motore di calcolo deterministico in uso
S5Modelli appresi
Stima della posa, classificatori di movimento, modello del respiro
C06 · Stima della posa sul dispositivo da esplorare
C07 · Classificatore di movimento da esplorare
C08 · Modello ibrido del respiro da esplorare
S6Pianificazione e apprendimento
Piano settimanale, registro delle ipotesi, regole apprese
C09 · Pianificatore settimanale in uso
C10 · Registro ipotesi e regole apprese in uso
S7Uscite
Telefono, orologio, voce, calendario, report per il clinico
C11 · Integrazione con il calendario in uso

Piani trasversali

PianoComponenti
Coordinamento
Coda delle commesse, gate, decisioni, diario e hub per il team
C12 · Hub guidato e consegne
C13 · Checker e generatore delle viste
Governance dei dati
Dove vive ogni classe di dato, chi vi accede, consenso e cancellazione
—
Validazione clinica e spirometria
Giudizio clinico sui protocolli e sulle etichette, spirometria come misura di riferimento; decide se un modulo è clinicamente affidabile
—

Dispositivi: ingressi e uscite

DispositivoDirezioneCosa portaModuli
iPhoneingresso e uscitaFotocamera per il video del movimento (stima della posa sul dispositivo), Comandi Rapidi, app Salute; in uscita guida agli esercizi e report.Coaching multidispositivo, Movimento e postura, Raccolta dati, Respiro, Screening periodico
Apple Watchingresso e uscitaFC, FC a riposo, HRV, sonno, frequenza respiratoria notturna, temperatura del polso, RPE di fine allenamento; in uscita segnali aptici e complicazioni di registrazione rapida.Piani di allenamento, Coaching multidispositivo, Raccolta dati, Recupero e prontezza, Respiro
AirPods Proingresso e uscitaOrientamento della testa per la postura del collo senza telecamera; in uscita correzioni vocali in tempo reale.Coaching multidispositivo, Movimento e postura
Spirometro dello studioingressoMisura di riferimento del respiro, nello studio di Francesco. Serve a validare e calibrare, non è un ingresso quotidiano.Respiro
Bilancia a bioimpedenzaingressoPeso e composizione corporea, scritti in Salute. Affidabile per il peso, solo indicativa per la composizione.Piani alimentari, Raccolta dati
CalendariouscitaIl piano della settimana diventa eventi in calendario.Piani di allenamento, Coaching multidispositivo
Report per il clinicouscitaSintesi per l'osteopata o il medico che segue la persona.Coaching multidispositivo

Confini di fiducia

ConfineControllo
CF1Dai dispositivi al NAS
Il punto in cui i dati grezzi lasciano il telefono. Passano solo verso il NAS, mai verso altri servizi.
Tailscale o WireGuard; dati cifrati a riposo sul NAS
CF2Dal NAS al repository
Il repository vede che un dataset esiste e quale versione ha addestrato un modello, non il suo contenuto.
Solo impronte DVC e risultati aggregati anonimi; il checker blocca i file di dati
CF3Dal NAS al modello cloud
La pianificazione usa un modello di frontiera perché tiene insieme molti vincoli meglio di un modello locale. Gli passa il minimo indispensabile.
Solo il riepilogo settimanale senza nomi né identificativi; il profilo solo per la singola richiesta, mai conservato
CF4Dallo studio clinico al progetto
I dati dei pazienti sono dati sanitari di terzi (art. 9 GDPR).
Chiuso in Fase 0. Poi solo con protocollo scritto, consenso informato ed eventuale comitato etico
CF5Dall'hub al repository
Le consegne arrivano nel repository solo come materiale di metodo o risultati anonimi.
Modulo di consegna con dichiarazione obbligatoria, controllo automatico, revisione del responsabile
06

Metodo: regole

Le regole contengono solo logica e fonti. I numeri che dipendono da una persona (peso, obiettivi, vincoli) si calcolano al momento dal suo profilo, che vive sul NAS.

Piani di allenamento

RegolaOrigineStatoFonte
Costanza prima di volume e intensità
Obiettivi ridotti a ciò che si riesce a fare davvero battono piani ambiziosi che vengono saltati.
praticaattiva—
Le abitudini automatiche non si usano per compensare
Un'attività che regge perché è automatica (come andare al lavoro in bici) resta com'è: allungarla nelle settimane difficili la rompe.
praticaattiva—
Nella base aerobica guida la frequenza cardiaca
In fase di base aerobica il passo non conta: la variabile da seguire è la FC, anche a ritmi molto lenti.
praticaattiva—
Ogni sessione chiude con un defaticamento
La curva della FC dopo la sessione deve scendere in modo graduale; una chiusura brusca viene segnalata.
praticaattiva—
Riferimento settimanale di attività
Il piano tende a 150–300 minuti di attività moderata (o 75–150 vigorosa) e ad almeno 2 giorni di rafforzamento muscolare, partendo da dove è la persona.
evidenzaattivaOMS: attività fisica e sedentarietà

Piani alimentari

RegolaOrigineStatoFonte
Adattamento sul trend del peso
Con obiettivo di calo: 0,3–0,7 kg a settimana si mantiene il piano; oltre 1 kg a settimana si aggiungono 150–200 kcal; stabile da almeno 2 settimane si riducono i carboidrati del 15–20%, mai le proteine. Massa magra in calo: proteine verso la fascia alta e verifica dell'intensità.
praticaattiva—
Cambi calorici graduali
Mai più di 200 kcal di variazione per volta.
praticaattiva—
Dose e distribuzione delle proteine
Per chi si allena 1,4–2,0 g/kg al giorno; in deficit calorico la fascia alta. Per dose 0,25–0,40 g/kg, ogni 3–4 ore. Il peso viene dal profilo, il numero si calcola al momento.
evidenzaattivaISSN: proteine ed esercizio
Esami del sangue come input, non come diagnosi
La verifica oggettiva si fa con il medico, circa due volte l'anno. I referti orientano il piano alimentare; FAMASalute non li interpreta clinicamente.
praticaattiva—
I vincoli del profilo sono assoluti
Esclusioni e allergie si leggono dal profilo personale a ogni piano e non si violano mai, nemmeno citando un alimento escluso come esempio. Il metodo non conosce i vincoli di nessuno: li riceve.
praticaattiva—
Il peso si legge sulla media settimanale
Mai il singolo valore: media settimanale con protocollo di pesata fisso; almeno 2–3 settimane prima di concludere. La composizione da bilancia vale solo come trend.
evidenzaattivaFluttuazione giornaliera del peso, Limiti della bioimpedenza
Micronutrienti a regole settimanali
Nessun conteggio pasto per pasto: regole di copertura settimanale verificabili a colpo d'occhio. I riferimenti si scelgono per sesso ed età della persona. Le stime hanno un margine di circa ±20% e servono a trovare buchi sistematici.
evidenzaattivaLARN, IV revisione, EFSA, valori dietetici di riferimento
Pasto dopo l'allenamento
Carboidrati e proteine entro 1–2 ore; la finestra dei 30 minuti è un mito. Prima di un allenamento mattutino a digiuno di 60–90 minuti basta uno spuntino leggero di carboidrati.
evidenzaattivaISSN: nutrient timing
Prima il piano, poi le abitudini, poi il medico
Si corregge prima il piano alimentare, poi luce del giorno e abitudini; l'integrazione si valuta solo con il medico, che decide anche i dosaggi.
praticaattiva—
Un buco che si ripete è un difetto del piano
Un buco isolato non conta. Se lo stesso buco compare tre settimane di fila si correggono le ricette, non si aggiunge un integratore.
praticaattiva—

Recupero e prontezza

RegolaOrigineStatoFonte
Alcol e caffeina tardiva sul recupero
Il motore incrocia orario dell'ultimo caffè e bevande alcoliche con sonno e FC notturna, e segnala la correlazione senza affermare una causa.
evidenzapropostaAlcol, caffeina tardiva e recupero notturno
Quando indirizzare al medico
SpO2 notturna sotto il 95% o disturbi respiratori ricorrenti nel sonno: il piano suggerisce una visita medica e non va oltre.
praticaattiva—
Segnali di scarico
FC a riposo in salita per più giorni o temperatura del polso oltre 0,5 °C sopra la baseline: settimana più leggera e attenzione a una possibile malattia. L'HRV dell'orologio si legge solo come trend.
evidenzaattivaAccuratezza di Apple Watch su FC a riposo e HRV

Ciclo di apprendimento

RegolaOrigineStatoFonte
Correlazione non è causalità
FAMASalute segnala pattern nei dati, mai cause certe.
praticaattiva—
Da ipotesi a regola
Un'ipotesi confermata più volte diventa una regola appresa con origine learned. Le regole apprese attive sono al massimo 25: oltre si fondono o si ritirano.
praticaattiva—
Ogni piano contiene le sue ipotesi
Il piano della settimana dichiara 2–3 ipotesi con l'esito atteso. La settimana dopo ognuna viene chiusa: confermata, smentita o non conclusiva.
praticaattiva—
Prima si misura l'aderenza
Senza sapere se il piano è stato seguito, un risultato non dice nulla sul piano. Nessun apprendimento automatico prima di avere l'aderenza (ADR-012).
praticaattiva—
Un intervento dietetico per blocco
Ogni blocco di 4 settimane cambia un solo aspetto della dieta, valutato sulle medie del blocco.
praticaattiva—

Raccolta dati

RegolaOrigineStatoFonte
Un tocco per registrazione
Caffè, bevanda alcolica e acqua con un tocco, senza distinzioni di tipo o dose. La dieta si registra come aderenza e sgarri, non pesando il cibo.
praticaattiva—
07

Evidenze

EvidenzaFonteLivelloUsata da
Bland e Altman: accordo tra metodi di misura
Limiti di accordo tra una misura nuova e una di riferimento.
Bland J.M., Altman D.G., Statistical methods for assessing agreement between two methods of clinical measurement, Lancet 1986metodo2
EFSA, valori dietetici di riferimento
Integra i LARN dove servono riferimenti europei.
EFSA, Dietary Reference Values for nutrients, Summary report, 2017linea guida2
ISSN: nutrient timing
Pre e post allenamento; la distribuzione regolare delle proteine conta più del numero di pasti.
Kerksick C.M. et al., International Society of Sports Nutrition Position Stand: Nutrient Timing, JISSN 2017position stand2
ISSN: proteine ed esercizio
Dose giornaliera, dose per pasto e distribuzione delle proteine per chi si allena.
Jäger R. et al., International Society of Sports Nutrition Position Stand: Protein and Exercise, JISSN 2017position stand2
Koo e Li: scelta e lettura dell'ICC
ICC tra 0,75 e 0,90 indica affidabilità buona, sopra 0,90 eccellente.
Koo T.K., Li M.Y., A guideline of selecting and reporting intraclass correlation coefficients for reliability research, J Chiropr Med 2016metodo1
LARN, IV revisione
Riferimenti per la popolazione italiana, per sesso ed età.
SINU, Livelli di Assunzione di Riferimento di Nutrienti ed energia, IV revisione, 2014linea guida2
Landis e Koch: accordo tra osservatori
Scala di interpretazione del kappa di Cohen: da 0,61 accordo sostanziale.
Landis J.R., Koch G.G., The measurement of observer agreement for categorical data, Biometrics 1977metodo1
OMS: attività fisica e sedentarietà
Riferimento per adulti: 150–300 minuti di attività moderata o 75–150 vigorosa a settimana, più rafforzamento muscolare almeno 2 giorni.
WHO guidelines on physical activity and sedentary behaviour, 2020linea guida3
Accuratezza di Apple Watch su FC a riposo e HRV
Le stime di partenza indicano FC a riposo risultava affidabile (errore intorno al 6%) e l'HRV molto meno (intorno al 29%). Va citata la fonte originale prima di usarla come evidenza.
Fonte originale da recuperareda verificare2
Alcol, caffeina tardiva e recupero notturno
Effetti dipendenti dalla dose su FC notturna, HRV e sonno.
Fonte originale da recuperareda verificare1
Fluttuazione giornaliera del peso
Il peso varia di giorno in giorno per l'acqua; le due stime di partenza danno ordini di grandezza diversi (circa 0,4 kg contro 1–2 kg). Conta solo la media settimanale, ma il numero va verificato.
Fonte originale da recuperareda verificare1
Limiti della bioimpedenza
La composizione corporea da bilancia dipende dall'idratazione (errore indicato del 3–5%); il rapporto vita/altezza è un indicatore migliore del grasso viscerale.
Fonte originale da recuperareda verificare2
Tempo nel verde (shinrin-yoku)
Tempo nel verde con frequenza superiore al mensile come fattore di recupero.
Studi di Qing Li sullo shinrin-yoku: riferimenti da completareda verificare0
08

Ipotesi da verificare

Ogni criterio è scritto prima di raccogliere i dati (P5).

IpotesiTestSuperata seResp.Stato
H1I clinici concordano sullo stesso movimento
Il modello impara dalle etichette di Francesco e Marco: se divergono, impara rumore. È l'ipotesi che può fermare il binario A.
20 video etichettati in cieco con la stessa schedaκ di Cohen ≥ 0,60 sulle categorie
ICC ≥ 0,75 sulle scale
Soglie proposte, da confermare nel protocollo C-04
Andrea F.aperta
H2La frequenza respiratoria dal video coincide con lo spirometro
È la prima misura di respiro che si può promettere.
Registrazioni simultanee video + spirometro sui 4 membriBland-Altman: limiti di accordo entro ±2 atti/min (proposta)Andrea F.aperta
H3Il video distingue respiro toracico e addominale
È il ponte tra postura e respiro.
Sequenze di respiro guidato etichettate dai cliniciClassificazione corretta ≥ 80% sui casi etichettati (proposta)Andrea F.aperta
H4La posa da telefono è precisa sugli angoli che contano
Senza precisione sugli angoli il punteggio di postura non regge.
Confronto con la misura goniometrica del clinico su 5 movimentiSoglia di errore in gradi da fissare con Marco e Francesco nella C-03Marcoaperta
H5Il team regge un ritmo costante nel tempo libero
Quattro persone con lavoro a tempo pieno che lavorano nel tempo libero: il ritmo, non le ore, dice quanto durerà il progetto.
Commesse chiuse al mese e tempo in corso, calcolati dal repositoryAlmeno 3 commesse chiuse al mese per due mesi di fila (proposta)
Nessuna commessa in corso da più di 4 settimane senza consegne
Andrea S.aperta
H6Qualcuno è disposto a pagare
Decide se FAMASalute resta un progetto o diventa un'impresa.
Interviste a osteopati e fisioterapistiCriterio da definire al gate G1Marcoaperta
H7La qualità del movimento peggiora con la fatica
Se è vera, lo screening diventa un segnale di recupero per i cicli del binario B e unisce i due binari.
Screening ripetuto a inizio e fine di settimane di carico diversoPunteggio di screening più basso nelle settimane con indice di prontezza basso, in almeno 3 confronti su 4 (proposta)Andrea S.aperta
H8L'aderenza si misura con un tocco al giorno senza perdere dati
Prerequisito dell'apprendimento: senza aderenza i risultati non si possono attribuire al piano.
Check-in serale sul binario BCheck-in serale compilato in almeno 6 sere su 7 per 4 settimane di filaAndrea S.aperta
09

Requisiti

RequisitoPrioritàStatoFase
Analisi su finestre storiche lunghe
Ricalcolo su 6 mesi o più dall'export completo.
mustapertaFase 0 · Validazione
I dati grezzi non lasciano il NAS
Video, tracciati ed export restano sul dispositivo o sul NAS.
mustapertaFase 0 · Validazione
Ingressi e uscite su più dispositivi
Telefono, orologio, auricolari e spirometro in ingresso; telefono, orologio, voce, calendario e report in uscita, sopra uno schema dati comune.
mustapertaFase 1 · Prototipo
Piano settimanale che valuta la settimana prima
Allenamento e alimentazione della settimana successiva, con il confronto tra cosa era stato consigliato e cosa è successo.
mustapertaFase 0 · Validazione
Registrazioni soggettive con un tocco
Comando Rapido di registrazione già costruito.
mustsoddisfattoFase 0 · Validazione
Stima della posa sul telefono
Il video non lascia il telefono: si salvano solo i punti chiave.
mustapertaFase 1 · Prototipo
Il metodo vale per un'altra persona
Cambiando solo il profilo, senza toccare regole e moduli.
shouldapertaFase 1 · Prototipo
Il piano finisce in calendario
Allenamenti e momenti chiave come eventi.
shouldapertaFase 0 · Validazione
Report per il clinico
Sintesi leggibile da un osteopata o da un medico.
shouldapertaFase 1 · Prototipo
Import da Android
Adapter Health Connect sopra lo schema comune.
couldapertaFase 2 · Pilota esteso
10

Rischi, assunzioni, problemi, dipendenze

VoceCategoriaImpattoProbabilitàColpisceMitigata da
Dati di pazienti usati senza protocollo
Mitigazione: CF4 chiuso in Fase 0, accordo sui dati (C-02).
rischioaltobassoDallo studio clinico al progettoC-02 · Accordo sui dati tra i quattro
Esposizione di dati sanitari
Video o tracciati finiti nel repository o al modello cloud. Mitigazione: P2, checker sui tipi di file, CF2 e CF3.
rischioaltobassoDal NAS al repository, Dal NAS al modello cloudC-02 · Accordo sui dati tra i quattro
I dati grezzi non lasciano il NAS
Stima della posa sul telefono
Etichette incoerenti tra i clinici
Mitigazione: test di concordanza prima di qualsiasi addestramento.
rischioaltomedioI clinici concordano sullo stesso movimentoC-11 · Analisi di concordanza
Il NAS come punto unico di guasto
Mitigazione: backup cifrato fuori sede e ripristino di prova (C-07).
rischioaltobassoArchivio cifrato sul NAS con DVCC-07 · NAS pronto per i dati sanitari
Promesse cliniche e regolamento sui dispositivi medici
Se FAMASalute promette effetti terapeutici o diagnosi diventa software medico (MDR), con marcatura CE e tempi lunghi. Mitigazione: Fase 0 e 1 solo ricerca e benessere; decisione esplicita al G2.
rischioaltomedioCoaching multidispositivo, Respiro—
Tempo libero del team discontinuo
Mitigazione: coda flessibile senza scadenze, una commessa in corso a testa, commesse piccole, gate come unici traguardi (ADR-015).
rischioaltoaltoFase 0 · Validazione—
Aspettative sui volumi polmonari dal video
Volumi assoluti dal video sono molto difficili. Fuori perimetro in Fase 0: si parte da frequenza e tipo di respiro.
assunzionemediomedioRespiro—
Codice del binario B fuori dal repository
health_check.py è nel repository dal 2026-11-11 (C-09). La skill personal trainer non è mai esistita: il metodo di allenamento si scrive con la C-12.
dipendenzamedioaltoParser dell'export di SaluteC-09 · Portare nel repository health_check.py
HRV dell'orologio poco affidabile
Si usa solo come trend; la FC a riposo pesa di più. Fonte da verificare (ev-watch-accuratezza).
assunzionemediomedioRecupero e prontezza—
Lavoro in MATLAB da riscrivere
Mitigazione: decisione presa presto, con la C-06 (ADR-005).
rischiomediomedioModello ibrido del respiroC-06 · Decisione MATLAB o Python
Risultati su una sola persona
Il binario B impara su una persona: le regole apprese valgono per lei finché non si provano su altre.
assunzionemedioaltoCiclo di apprendimento—
11

Fasi e gate

Niente date: ognuno lavora nel tempo libero (ADR-015). I gate sono i traguardi, e una fase si chiude quando i loro criteri sono soddisfatti.

Fase 0 · Validazione
da novembre 2026, senza data di fine: si chiude al gate G1
in corso

Binario A: regole sui dati, strumenti, scheda di etichettatura, protocollo, prime registrazioni sul team, test H1–H4. Binario B: il metodo di pianificazione gira su una persona mentre viene scritto qui.

Gate G1 in attesa
  • H1 e H2 superate
  • H3 e H4 almeno valutate
  • H5 valutata: il ritmo del team è noto
  • Decisione sulla migrazione del repository al NAS (ADR-001)
  • Criterio di H6 definito
Fase 1 · Prototipo
da iniziare

Video → punti chiave → punteggio di postura; respiro dal video; primo screening periodico; collegamento tra screening e recupero (H7); interviste ai professionisti (H6).

Gate G2 in attesa
  • Percorso scelto: benessere o dispositivo medico (MDR)
  • Per chi è il prodotto
  • H6 valutata
Fase 2 · Pilota esteso
da iniziare

Pazienti con protocollo approvato, prova con professionisti esterni, modello di ricavo.

Gate G3 in attesa
  • Progetto o impresa
12

Coda delle commesse

In ordine: prima quelle in corso, poi la coda per priorità. Chi ha tempo prende la prima libera che sa fare, una alla volta. Per le commesse libere, i due più adatti secondo il profilo delle competenze.

Prior.CommessaResponsabileCompetenzeFatto quandoDipende daStato
1C-01Repository, schema e hub v0Andrea S.Sviluppo Python e pipeline dati, NAS, rete e infrastruttura dati, Project managementFrancesco, Marco e Andrea F. completano ciascuno una consegna di prova dall'hub—in corso
2C-13Profilo delle competenze: ognuno conferma i propri livelli
con Francesco, Marco, Andrea F.
Andrea S.Project managementI quattro profili sono confermati—aperta
3C-14Approvare le decisioni di squadra
con Francesco, Marco, Andrea F.
Andrea S.Project managementOgni decisione di squadra è accettata all'unanimità o ha un'opposizione motivata da discutere—aperta
4C-02Accordo sui dati tra i quattro
con Francesco, Marco, Andrea F.
Andrea S.Governance dei dati e GDPRApprovato da tutti e quattro—aperta
5C-07NAS pronto per i dati sanitariAndrea S.NAS, rete e infrastruttura dati, Governance dei dati e GDPRRipristino di prova riuscito da backup—aperta
6C-03Scheda di etichettaturalibera
adatti: Francesco, Marco
Valutazione clinica di postura e movimento, Valutazione clinica del respiroApprovata da Marco e Francesco; Andrea F. conferma che è misurabile—aperta
7C-04Protocollo del pilota spirometria + video + orologiolibera
adatti: Andrea F., Francesco
Statistica e studi di validazione, Spirometria, Meccanica polmonareProtocollo v1 nel repository, rivisto da Francesco—aperta
8C-05Prima sessione di registrazione
con Marco, Andrea S., Andrea F.
FrancescoSpirometria, Valutazione clinica di postura e movimentoFile sul NAS e versionati; nessun file sanitario nel repositoryC-02, C-03, C-04, C-07 bloccataaperta
9C-08Formato del profilo personale letto dal pianificatoreAndrea S.Nutrizione, Sviluppo Python e pipeline datiIl pianificatore produce una settimana usando solo le regole del repository e il profilo d'esempio; nel repository nessun dato reale—aperta
10C-06Decisione MATLAB o Pythonlibera
adatti: Andrea F., Andrea S.
Modellazione in MATLAB, Sviluppo Python e pipeline datiADR-005 approvato—aperta
11C-12Metodo di allenamento al posto della skill personal trainerlibera
adatti: Marco, Francesco
Allenamento e preparazione fisica, Valutazione clinica di postura e movimentoIl pianificatore genera una settimana di allenamento usando solo regole del repository e il profilo, e un clinico l'ha rivista—aperta
12C-10Etichettatura in cieco dei 20 videolibera
adatti: Francesco, Marco
Valutazione clinica di postura e movimento, Valutazione clinica del respiroEntrambi i file consegnati senza identificativiC-03, C-05 bloccataaperta
13C-11Analisi di concordanzalibera
adatti: Andrea F., Francesco
Statistica e studi di validazioneH1 chiusa come confermata, smentita o non conclusivaC-10 bloccataaperta

Chiuse o non necessarie

  • C-09 Portare nel repository health_check.py · Andrea S. · chiusa 2026-11-11
13

Registro decisioni

Decisioni di area: le prende chi è responsabile dell'area, dopo aver sentito chi ne subisce le conseguenze. Decisioni di squadra: passano solo con l'approvazione di tutti e quattro (ADR-018).

Decisione ed esitoTipoStatoData
ADR-001Dove vive il repository
GitHub privato adesso; migrazione a Forgejo sul NAS valutata al gate G1
squadraproposta
1/4 approvazioni: Andrea S.
ADR-002Dati sanitari fuori da git
Nessun dato sanitario in git; dataset sul NAS, versionati con DVC
squadraproposta
1/4 approvazioni: Andrea S.
ADR-003Modelli di posa
Modello di posa pre-addestrato sul telefono più una testa addestrata sulle etichette cliniche
areaproposta
ADR-004Chi sono i soggetti della Fase 0
Solo i quattro membri del team; pazienti dello studio solo con protocollo, consenso ed eventuale comitato etico
squadraproposta
1/4 approvazioni: Andrea S.
ADR-005Linguaggio dei modelli
Da decidere: MATLAB per la ricerca e Python per il prodotto, o tutto Python
areaaperta
ADR-006Hub e consegne
Hub guidato in sola lettura generato dal repository; consegne tramite moduli GitHub
squadraproposta
1/4 approvazioni: Andrea S.
ADR-007FAMASalute integra alimentazione e allenamento
Il progetto comprende un binario B: allenamento, alimentazione, recupero, raccolta e apprendimento
squadraproposta
1/4 approvazioni: Andrea S.
ADR-008Metodo nel repository, profilo sul NAS
Regole, evidenze e protocolli di alimentazione e allenamento vivono qui; profilo, vincoli e misure della persona solo nella memoria personale sul NAS
squadraproposta
1/4 approvazioni: Andrea S.
ADR-009Schema dati comune
Uno schema dati interno unico con adapter per fonte: Apple Health prima, Health Connect poi
areaaccettata
decisa da Andrea S.
2026-10-15
ADR-010Tre cicli e memoria a dimensione fissa
Settimana per il carico, blocchi di 4 settimane per la dieta, mesocicli di 8 per il programma; registro ipotesi e regole apprese con tetto a 25
areaaccettata
decisa da Andrea S.
2026-10-15
ADR-011Calcolo locale, giudizio nel modello
Il calcolo deterministico gira in locale; il giudizio di pianificazione usa un modello di frontiera sui soli riepiloghi aggregati
squadraproposta
1/4 approvazioni: Andrea S.
ADR-012Come impara il binario B
Niente machine learning classico sui dati settimanali; aggiornamento bayesiano o bandit contestuali, dopo aver misurato l'aderenza
areaproposta
ADR-013Nome del progetto
Pneuma: in greco il respiro
squadrasostituita2026-11-07
ADR-014Export completo invece di riepiloghi nei Comandi Rapidi
L'export completo di Salute viene elaborato da uno script sul NAS; i Comandi Rapidi non pre-aggregano
areaaccettata
decisa da Andrea S.
2026-10-22
ADR-015Coda flessibile al posto degli sprint
Niente sprint né scadenze: una coda di commesse in ordine di priorità, ognuno prende la prossima che sa fare, al massimo una in corso a testa; i gate sono gli unici traguardi
squadraproposta
1/4 approvazioni: Andrea S.
ADR-016Competenze per indirizzare il lavoro, non per dare voti
Le commesse dichiarano le competenze richieste e ognuno dichiara i propri livelli; nessun punteggio calcolato. Restano la storia delle commesse, i suggerimenti per la coda e la mappa delle competenze che mancano
squadraproposta
1/4 approvazioni: Andrea S.
ADR-017Passaggi con motivo e nota, commesse non necessarie
Una commessa si passa a chiunque del gruppo, Andrea S. compreso, sempre con il motivo e una nota per chi la riceve; chi la riceve può anche chiuderla come non necessaria, spiegando perché
squadraproposta
1/4 approvazioni: Andrea S.
ADR-018Decisioni distribuite e diario condiviso
Ognuno decide nella sua area dopo aver chiesto un parere a chi ne subisce le conseguenze, e lo annota nel diario condiviso; le decisioni di squadra passano solo all'unanimità
squadraproposta
1/4 approvazioni: Andrea S.
ADR-019Nome del progetto: FAMASalute
Il progetto si chiama FAMASalute, con il sottotitolo in greco antico ἀνάπνει τὴν ζωήν (respira la vita)
squadraproposta
1/4 approvazioni: Andrea S.
ADR-020Regola d'oro: niente aggiornamenti a mano
Nell'area coordinamento (sito, hub, moduli, stati delle commesse, decisioni) niente si aggiorna a mano; una funzione è finita solo quando non richiede aggiornamenti manuali ricorrenti
areaaccettata
decisa da Andrea S.
2026-11-11
ADR-021Sito live su una pagina del progetto
Il sito si pubblica su Cloudflare Pages a ogni modifica del repository, dopo ogni azione dei moduli e una volta al giorno; l'accesso è limitato alle email dei quattro con Cloudflare Access
areaaccettata
decisa da Andrea S.
2026-11-11
14

Idee

IdeaStato
Coach di esecuzione in palestra
Mercato affollato, nessun vantaggio specifico del team.
parcheggiata
Ergonomia per lavori fisici
Prevenzione per chi solleva pesi; da riprendere dopo la Fase 1.
parcheggiata
Postura del collo con gli auricolari
Modalità senza telecamera con l'orientamento della testa degli AirPods.
da valutare
Semaforo "oggi sì / oggi no"
Una vista minima dell'indice di prontezza.
da valutare
Tempo nel verde come fattore
Uscite nel verde più frequenti che una volta al mese, tracciate come fattore di recupero.
adottata
15

Glossario

TermineSignificato
AderenzaQuanto il piano è stato seguito davvero: senza di essa un risultato non si attribuisce al piano.
Binario A e BA: movimento e respiro con il team. B: allenamento, alimentazione e recupero.
Bland-AltmanMetodo per confrontare una misura nuova con una di riferimento tramite limiti di accordo.
Blocco dieteticoQuattro settimane con un solo intervento alimentare, valutato sulle medie.
Coda delle commesseElenco delle commesse in ordine di priorità. Chi ha tempo prende la prima che sa fare; al massimo una in corso a testa.
CommessaUn pezzo di lavoro con un solo responsabile, un deliverable e un criterio "fatto quando".
DVCData Version Control: versiona i dataset lasciando nel repository solo le impronte.
GatePunto di decisione a fine fase: avanti, correggi o fermati.
HRVVariabilità della frequenza cardiaca: indice di recupero, poco affidabile da orologio.
ICCCoefficiente di correlazione intraclasse: accordo tra osservatori su scale numeriche.
Indice di prontezzaSintesi dei segnali di recupero che decide se spingere o scaricare.
Kappa di CohenMisura dell'accordo tra due osservatori su categorie, al netto del caso.
MDRRegolamento europeo sui dispositivi medici, che si applica anche al software con finalità cliniche.
MesocicloBlocco di allenamento di più settimane con un obiettivo; in FAMASalute 8 settimane.
Profilo delle competenzeLivelli da 0 a 3 che ognuno dichiara per sé, con la storia delle commesse chiuse e passate. Nessun punteggio: serve a indirizzare la coda e a vedere le competenze che mancano.
RPESforzo percepito da 1 a 10, registrato dall'app Allenamento a fine sessione.
Stima della posaRicostruzione dei punti chiave del corpo da un'immagine o da un video.
16

Diario

Annoto una scelta

2026-11-11 · Andrea S. · Validazione clinica e spirometria
Coda flessibile, decisioni distribuite, FAMASalute

Ognuno lavora nel tempo libero: gli sprint lasciano il posto a una coda senza scadenze (ADR-015). Il profilo delle competenze perde il punteggio e resta uno strumento per indirizzare il lavoro e vedere cosa manca (ADR-016). I passaggi di commessa portano sempre motivo e nota per chi riceve, e una commessa può essere chiusa come non necessaria (ADR-017). Ognuno decide nella sua area con un parere preventivo e annota nel diario condiviso; le decisioni di squadra passano all'unanimità (ADR-018). Il progetto diventa FAMASalute, indipendente: nessun collegamento ad altri progetti, solo copie (ADR-019). health_check.py entra nel repository con un test su export sintetico e chiude la C-09; la skill personal trainer non esiste ancora, il suo metodo diventa la C-12. Il progetto si scrive FAMASalute, con sottotitolo in greco antico. Andrea S. conferma il proprio voto sulle decisioni di squadra (ADR-001, 002, 004, 006, 007, 008, 011, 015–019) e propone a Francesco l'area validazione clinica e spirometria, da confermare nella C-14. Regola d'oro di Andrea S. per la sua area, il coordinamento: niente aggiornamenti a mano (P10, ADR-020); estenderla alle altre aree sarà una decisione di squadra. Il sito passa da claude.ai a Cloudflare Pages e si pubblica da solo (ADR-021); i moduli dell'hub si generano dalle note e i livelli di competenza si aggiornano con un modulo.

2026-11-07 ·
Nasce il repository e si uniscono i binari

Nasce il repository, allora chiamato Pneuma. Schema e checker sono copiati dal progetto Argo di Andrea S. e adattati a moduli, metodo e commesse; nessun collegamento ad Argo resta nel progetto. Il binario B parte dalla pipeline salute settimanale e dalla skill nutrizionista di Andrea S. (ADR-007): il metodo è stato copiato qui in regole ed evidenze, senza dati personali (ADR-008); quattro evidenze restano da verificare. Il repository resta su GitHub, con la migrazione al NAS da valutare al G1 (ADR-001).

2026-11-06 · · Respiro
Nasce l'idea e il team

Dal brainstorming sull'app di movimento esce la direzione postura e respiro, perché usa tutte e quattro le competenze. Francesco ha uno spirometro in studio: diventa la misura di riferimento. Il lavoro si organizza a commesse con un hub guidato in sola lettura; i dati sanitari vanno sul NAS, mai in git.