App di questionari HBImed — Istruzioni per l’uso

1. Panoramica

L’app di questionari HBImed è una piattaforma web per assegnare, raccogliere e valutare questionari clinici. I clinici creano i pazienti, assegnano pacchetti di questionari e inviano un link. I pazienti compilano i questionari nella lingua preferita; lo studio riceve poi i risultati come report a schermo, dati grezzi o file Excel del generatore di report (RG) per l’analisi MATLAB a valle.

L’app è disponibile su https://hbimed-fragebogen.gtsg.ch.

2. Ruoli e accesso

L’app utilizza un modello a tre ruoli:

Ruolo	Ambito	Può fare
Superadmin	Tutti gli studi	Accesso completo; vede e gestisce tutto tra gli studi.
Admin dello studio (`praxis_admin`)	Proprio studio	Gestisce lo studio, crea gli account del personale del proprio studio, gestisce pacchetti, pazienti e rilevazioni.
Utente dello studio (`praxis_user`)	Proprio account	Crea e gestisce i propri pazienti e rilevazioni.

Regole di visibilità importanti:

I pacchetti sono legati allo studio.
I pazienti e le rilevazioni sono legati alla persona che li ha creati (il superadmin vede tutto).
I questionari e le traduzioni sono globali (condivisi tra tutti gli studi).

I nuovi utenti ricevono una password iniziale e devono impostarne una propria al primo accesso.

3. Concetti di base

Studio — l’unità organizzativa; personale e pacchetti vi appartengono.
Paziente — creato con nome, data di nascita, sesso e (facoltativo) lateralità. L’età è calcolata automaticamente dalla data di nascita.
Pacchetto — una raccolta denominata di questionari assegnata a un paziente per una rilevazione.
Rilevazione — un passaggio di un pacchetto per un paziente. Ha uno stato (aperta durante la compilazione, completata al termine) e una lingua.

4. Flusso tipico

Creare / selezionare il paziente (nome, data di nascita, sesso, lateralità).
Assegnare un pacchetto (o singoli questionari) per avviare una rilevazione.
Inviare il link al paziente (o farlo compilare in sede). Le e-mail di promemoria possono essere inviate automaticamente nella lingua del paziente.
Il paziente compila i questionari nella lingua scelta.
Al termine il paziente riceve un’e-mail di ringraziamento; la rilevazione diventa completata.
Consultare i risultati ed esportare secondo necessità (vedi sezione 6).

5. Il portale paziente

Lingue. Il portale supporta tedesco, inglese, francese, italiano, spagnolo, giapponese, macedone, persiano/farsi, albanese e serbo. La lingua dell’interfaccia è rilevata automaticamente; il paziente può cambiarla con il selettore ?lang=XX e la scelta viene memorizzata per la rilevazione.
Avanzamento. Una barra di avanzamento e un contatore per questionario mostrano quanti item obbligatori sono stati risposti. Le risposte vengono salvate in continuo.
Tipi di domanda. A seconda del questionario: scala Likert, Sì/No, scelta multipla, testo libero, inserimento numerico con unità (p. es. ore di sonno SDSC — il punteggio ordinale è derivato automaticamente), matrice (più selezioni per riga), campo età/codice (ADI-R) e semplici titoli di sezione.

6. Risultati, report ed esportazione

Per ogni rilevazione completata, nell’area admin sono disponibili le seguenti uscite:

Report a schermo (PDF/HTML) — per rilevazione, con intestazione paziente, tutte le risposte e i punteggi delle sottoscale.
Dati grezzi (CSV) — per questionario, con numero item, domanda, sottoscala, risposta e punteggio.
Sintesi dei punteggi (CSV) — una riga per questionario con punteggi delle sottoscale e percentuali.
Export generatore di report (RG / Excel) — le risposte vengono scritte nel modello Excel ufficiale, preservato byte per byte, nel formato esatto atteso dal generatore di report MATLAB.
Sincronizzazione Dropbox — i file RG possono essere esportati direttamente in una cartella Dropbox. (Se un questionario non è ancora predisposto per RG, il percorso ripiega su un CSV di dati grezzi.)

7. Gestire le traduzioni (admin)

Titolo, istruzioni, testi degli item ed etichette di risposta di ogni questionario possono essere tradotti per lingua. Ogni traduzione ha uno stato:

Stato	Significato	Visibile ai pazienti?
`entwurf` (bozza)	Non ancora verificata	No
`geprueft` (verificata)	Verificata, non approvata	No
`freigegeben` (approvata)	Approvata per l’uso	Sì

Solo le traduzioni con stato freigegeben compaiono nel portale paziente. Le traduzioni appena importate o generate automaticamente partono come entwurf e devono essere verificate (per le lingue clinicamente sensibili o in scrittura non latina, anche da un madrelingua con formazione clinica) prima di essere approvate.

Catalogo dei questionari

Tutti i questionari attivi nel sistema. Questo elenco viene generato automaticamente dalla banca dati ed è quindi sempre aggiornato. « RG » = predisposto per l’esportazione Excel verso il generatore di report MATLAB. La numerazione HBI segue lo schema di codifica interno.

Codice HBI	Questionario	Ambito	Gruppo target	RG	Lingue (approvate)
`HBI-001-002`	Questionario su carico quotidiano e strutture cerebrali (AMEN)	ADHD	Adulti, Bambini	✓	DEENFRITJPMKFASQSR
`HBI-002-001`	van Deusen Self-Report (differenziale semantico)	ADHD	—	–	DEENFRJPMKSQSR
`HBI-003-005`	Questionario ADHD	ADHD	Adulti, Bambini	✓	DEENFRITJP
`HBI-003-005-teacher`	Questionario su attenzione, pensiero, azione ed emozioni (insegnanti)	ADHD	Insegnanti	✓	DEENFRJP
`HBI-004-001`	Dati personali e clinici	Anamnese	—	–	DEENFRJPMKSQSR
`HBI-005-002`	SCL-90-R (lista dei sintomi-90-rivista)	Psicopatologia	Adulti	✓	DEENFRITJP
`HBI-006-002`	Lista dei comportamenti del bambino (CBCL)	Comportamento	Genitori	✓	DEENFRITJP
`HBI-007-002`	Modulo di valutazione per insegnanti (TRF)	Comportamento	Genitori	✓	DE
`HBI-008-002`	Scala di valutazione di Wender Utah (WURS-K)	ADHD	Adulti	✓	DEENFRITJP
`HBI-009-001`	Autovalutazione ADHD	ADHD	—	✓	DEENFRJP
`HBI-010-001`	FLZ – Fragebogen zur Lebenszufriedenheit	Contesto di vita	—	✓	DEJP
`HBI-011-002`	Eventi di vita negli ultimi 12 mesi	Contesto di vita	Adulti	✓	DEENFRJPMKSQSR
`HBI-012-003`	Comorbidità – adulti	Comorbidità	Adulti	✓	DEENFRITJPSQSR
`HBI-013-002`	Comorbidità – bambini	Comorbidità	Genitori	✓	DEENFRITJPSQSR
`HBI-014-003`	Checklist dell'ipomania (HCL-32)	Bipolare	Adulti	✓	DEENFRITJP
`HBI-015-004`	Anamnesi familiare	Anamnesi familiare	Adulti	✓	DEENFRITJPMKSQSR
`HBI-016-001`	Questionario sul cambiamento – adulti	Decorso	—	✓	DEENFRITESJPMKSQSR
`HBI-017-001`	Questionario sul cambiamento – bambini	Decorso	—	✓	DEENFRITJPMKSQSR
`HBI-018-001`	Intervista sul cambiamento – questionario iniziale	Decorso	Adulti	✓	DEFRJPMKSQSR
`HBI-019-002`	Inventario della depressione di Beck (BDI-II)	Depressione	Adulti	✓	DEENFRITJP
`HBI-020-002`	Inventario dell'ansia di Beck (BAI)	Ansia	Adulti	✓	DEENFRITJP
`HBI-022-001`	Questionario sulla sensibilità – adulti	Sensibilità	Adulti	✓	DEENFRITJPMKSQSR
`HBI-025-001`	Questionario sulla sensibilità – bambini	Sensibilità	Genitori	✓	DEENITJPMKSQSR
`HBI-026-001`	Questionario sui traumi infantili (CTQ)	Trauma	Adulti	✓	DEENFRITJP
`HBI-027-001`	Questionario di comunicazione sociale (SCQ)	Autismo	Genitori	✓	DEENFRJP
`HBI-028-001`	Scala di Marburgo per la sindrome di Asperger (MBAS)	Autismo	Genitori	✓	DEFRJP
`HBI-029-001`	Scala di etero-valutazione – disturbi pervasivi dello sviluppo (FBB-TES)	Autismo	Genitori	✓	DEFRJP
`HBI-029-002`	Scala di etero-valutazione – DPS (FBB-TES, versione insegnante)	Autismo	Insegnanti	–	DEFRJP
`HBI-030-001`	Quoziente dello spettro autistico (AQ-50)	Autismo	Adulti	✓	DEENFRITESJPMK
`HBI-031-001`	Questionario sul camuffamento dei tratti autistici (CAT-Q)	Autismo	Adulti	✓	DEENFRITESJPMK
`HBI-032-001`	Quoziente di empatia (EQ-60)	Autismo	Adulti	✓	DEENFRITESJPMK
`HBI-033-001`	Scala diagnostica Ritvo per autismo e Asperger – riveduta (RAADS-R)	Autismo	Adulti	✓	DEENFRITESJPMK
`HBI-034-001`	Questionario sui comportamenti ripetitivi (RBQ-2A)	Autismo	Adulti	✓	DEENFRITESJPMK
`HBI-036-001`	Scala di Marburgo per la sindrome di Asperger (versione alternativa)	Autismo	—	✓	DEENFRJP
`HBI-037-001`	Test della depressione per bambini (DTK)	Depressione	—	✓	DEENFRJP
`HBI-038-001`	Questionario sullo stress di Kessler (K10)	Stress	—	–	DEENFRJP
`HBI-039-001`	Motivazione all'apprendimento e al rendimento	Lernen	—	–	DEENFRJP
`HBI-040-001`	Questionario sulle fobie per bambini e adolescenti	Ansia	—	–	DEENFRJP
`HBI-041-001`	Intervista di Wender-Reimherr (WRI) — foglio di valutazione	ADHD	—	–	DEENFRJP
`HBI-042-001`	Fragebogen zu Traumata bei Kindern und Jugendlichen (CATS) – Elternversion	—	—	✓	DEENFRITESJPFA
`HBI-044-001`	Fragebogen zu Traumata bei Kindern und Jugendlichen (CATS) – Kinderversion	—	—	✓	DEENFRITESJPFA
`HBI-047-001`	ADI-R (Autism Diagnostic Interview – Revised)	—	—	–	DE
`HBI-048-001`	ADI-R KURZ (Algorithmus-Items, ~4;0 J.)	—	—	✓	DEJP
`HBI-049-001`	MDQ (Mood Disorder Questionnaire)	—	—	✓	DEJP
`HBI-050-001`	SDSC (Schlaffragebogen für Kinder)	—	—	✓	DEJP
`HBI-051-001`	PSQI (Pittsburgh Schlafqualitätsindex)	—	—	✓	DE
`HBI-052-001`	ADOS Modul 1 (vorsprachlich / einzelne Woerter)	—	—	–	DE
`HBI-052-002`	ADOS-2 Modul 2 (Sprache in Saetzen)	—	—	–	DE
`HBI-052-003`	ADOS-2 Modul 3 (fliessende Sprache, Kind/Jugend)	—	—	–	DE
`HBI-052-004`	ADOS Modul 4 (fliessende Sprache, Jugendliche/Erwachsene)	—	—	–	DE
`HBI-053-001`	PDA-Checkliste für Kinder	—	Bambini	✓	DE
`HBI-054-001`	PDA-Checkliste für Erwachsene	—	Adulti	✓	DE
`HBI-055-001`	EDA-Q (Extreme Demand Avoidance Questionnaire)	—	Genitori	✓	DE
`HBI-056-001`	Toronto Alexithymia Scale (TAS-20)	—	—	–	DE
`HBI-057-001`	Selbsteinschätzung Emotionaler Kompetenzen (SEK-27)	—	—	–	DE
`HBI-058-001`	Multidimensional Assessment of Interoceptive Awareness (MAIA-2)	—	—	–	DE
`HBI-059-001`	HSP-Test für Hochsensibilität – Langform (Satow 2022) (HSP)	—	—	–	DE
`HBI-060-001`	WHO Disability Assessment Schedule 2.0 (12-Item) (WHODAS 2.0)	—	—	–	DE
`HBI-061-001`	Depression Anxiety Stress Scales (DASS-21)	—	—	–	DE
`HBI-062-001`	Obsessive Compulsive Inventory – Revised (OCI-R)	—	—	–	DE
`HBI-063-001`	Adult ADHD Self-Report Scale (ASRS)	—	—	–	DE
`HBI-064-001`	Eating Disorder Examination-Questionnaire, Kurzversion (EDE-Q8)	—	—	–	DE
`HBI-065-001`	Soziale Interaktions-Angst-Skala (Teil der SOZAS) (SIAS)	—	—	–	DE
`HBI-066-001`	Soziale-Phobie-Skala (Teil der SOZAS) (SPS)	—	—	–	DE
`HBI-067-001`	Level of Personality Functioning Scale – Brief Form 2.0 (LPFS-BF)	—	—	–	DE
`HBI-068-001`	Persönlichkeitsinventar für DSM-5 / ICD-11, Kurzform mod. (PID-5-BF+ M)	—	—	–	DE
`HBI-069-001`	Schizotypal Personality Questionnaire – Brief Revised (dt. SPQ-BR-G) (SPQ-BR)	—	—	–	DE

« RG » = predisposto per l’export verso il generatore di report MATLAB. « Lingue » = lingue con traduzioni degli item approvate (il tedesco è la lingua di base).