HBImed Questionnaire App

1. Overview

The HBImed Questionnaire App is a web-based platform for administering, collecting and evaluating clinical questionnaires. Clinicians create patients, assign questionnaire packages, and send the patient a link. Patients complete the questionnaires in their preferred language; the clinician then receives the results as an on-screen report, as raw data, or as a Report-Generator (RG) Excel file for the downstream MATLAB analysis.

The app runs at https://hbimed-fragebogen.gtsg.ch.

2. User roles and access

The app uses a three-role model:

Role	Scope	Can do
Superadmin	All practices	Full access; sees and manages everything across practices.
Practice Admin (`praxis_admin`)	Own practice	Manages the practice, creates staff accounts of the own practice, manages packages, patients and surveys.
Practice User (`praxis_user`)	Own account	Creates and manages own patients and surveys.

Key visibility rules:

Packages are bound to the practice.
Patients and surveys are bound to the creating user (a superadmin sees all).
Questionnaires and translations are global (shared across all practices).

New users receive an initial password and are prompted to set their own on first login.

3. Core concepts

Practice — the organisational unit; staff and packages belong to it.
Patient — created with name, date of birth, gender and (optionally) handedness. The age is derived automatically from the date of birth.
Package — a named collection of questionnaires assigned to a patient for a survey.
Survey — one run of a package for one patient. A survey has a status (open while being filled, completed when finished) and a language.

4. Typical workflow

Create / select the patient (name, date of birth, gender, handedness).
Assign a package (or individual questionnaires) to start a survey.
Send the link to the patient (or have them fill it on site). Reminder e-mails can be sent automatically in the patient’s language.
Patient completes the questionnaires in their chosen language.
On completion the patient receives a thank-you e-mail; the survey becomes completed.
Review the results and export as needed (see section 6).

5. The patient portal

Languages. The portal supports German, English, French, Italian, Spanish, Japanese, Macedonian, Persian/Farsi, Albanian and Serbian. The interface language is auto-detected; the patient can switch with the ?lang=XX selector, and the choice is remembered for the survey.
Progress. A progress bar and per-questionnaire counter show how many required items are answered. Answers are saved continuously.
Question types. Depending on the questionnaire: Likert scale, Yes/No, multiple choice, free text, number entry with a unit (e.g. SDSC sleep hours — the ordinal score is derived automatically), matrix (multiple selections per row), age/code field (ADI-R) and plain section headers.

6. Results, reports and export

For each completed survey the following outputs are available from the admin area:

On-screen report (PDF/HTML) — per survey with patient header, all answers and subscale scores.
Raw data (CSV) — per questionnaire with item number, question, subscale, answer and score.
Score summary (CSV) — one row per questionnaire with subscale scores and percentages.
Report-Generator export (RG / Excel) — answers are written into the official, byte-preserving Excel template, in the exact format the MATLAB Report Generator expects.
Dropbox sync — the RG files can be exported directly to a Dropbox folder. (If a questionnaire is not yet wired for RG, the path falls back to a raw-data CSV.)

7. Managing translations (admin)

Each questionnaire’s title, instructions, item texts and answer labels can be translated per language. Every translation has a status:

Status	Meaning	Visible to patients?
`entwurf` (draft)	Not yet reviewed	No
`geprueft` (reviewed)	Checked, not released	No
`freigegeben` (released)	Approved for use	Yes

Only translations with status freigegeben are shown in the patient portal. Newly imported or machine-assisted translations start as entwurf and must be reviewed (for clinically sensitive or non-Latin-script languages, additionally by a native speaker with clinical background) before being released.

Questionnaire catalogue

All questionnaires active in the system. This list is generated automatically from the database and is therefore always current. “RG” = wired for the Excel export to the MATLAB Report Generator. The HBI numbering follows the internal coding scheme.

HBI code	Questionnaire	Area	Target group	RG	Languages (released)
`HBI-001-002`	Medical History Questionnaire	ADHD	Adults, Children	✓	DEENFRITJPMKFASQSR
`HBI-002-001`	van Deusen Self-Report (semantic differential)	ADHD	—	–	DEENFRJPMKSQSR
`HBI-003-005`	Clinical ADHD Questionnaire	ADHD	Adults, Children	✓	DEENFRITJP
`HBI-003-005-teacher`	Clinical ADHD Questionnaire — Teacher	ADHD	Teachers	✓	DEENFRJP
`HBI-004-001`	Personal and clinical data	Anamnese	—	–	DEENFRJPMKSQSR
`HBI-005-002`	SCL-90-R (Symptom Checklist-90-Revised)	Psychopathology	Adults	✓	DEENFRITJP
`HBI-006-002`	Child Behavior Checklist (CBCL)	Behaviour	Parents	✓	DEENFRITJP
`HBI-007-002`	Teacher Report Form (TRF)	Behaviour	Parents	✓	DE
`HBI-008-002`	Wender Utah Rating Scale (WURS)	ADHD	Adults	✓	DEENFRITJP
`HBI-009-001`	ADHD Self-Report	ADHD	—	✓	DEENFRJP
`HBI-010-001`	FLZ – Fragebogen zur Lebenszufriedenheit	Life context	—	✓	DEJP
`HBI-011-002`	Life Events Questionnaire	Life context	Adults	✓	DEENFRJPMKSQSR
`HBI-012-003`	Comorbidities – Adults	Comorbidity	Adults	✓	DEENFRITJPSQSR
`HBI-013-002`	Comorbidities – Children	Comorbidity	Parents	✓	DEENFRITJPSQSR
`HBI-014-003`	Hypomania Checklist (HCL-32)	Bipolar	Adults	✓	DEENFRITJP
`HBI-015-004`	Family History Questionnaire	Family history	Adults	✓	DEENFRITJPMKSQSR
`HBI-016-001`	Veränderungsfragebogen für Erwachsene	Course	—	✓	DEENFRITESJPMKSQSR
`HBI-017-001`	Veränderungsfragebogen für Kinder	Course	—	✓	DEENFRITJPMKSQSR
`HBI-018-001`	Change Interview	Course	Adults	✓	DEFRJPMKSQSR
`HBI-019-002`	Beck Depression Inventory II (BDI-II)	Depression	Adults	✓	DEENFRITJP
`HBI-020-002`	Beck Anxiety Inventory (BAI)	Anxiety	Adults	✓	DEENFRITJP
`HBI-022-001`	Sensitivity Questionnaire – Adults	Sensitivity	Adults	✓	DEENFRITJPMKSQSR
`HBI-025-001`	Sensitivity Questionnaire – Children	Sensitivity	Parents	✓	DEENITJPMKSQSR
`HBI-026-001`	Childhood Trauma Questionnaire (CTQ)	Trauma	Adults	✓	DEENFRITJP
`HBI-027-001`	Social Communication Questionnaire (SCQ)	Autism	Parents	✓	DEENFRJP
`HBI-028-001`	Marburg Rating Scale for Asperger's Syndrome (MBAS)	Autism	Parents	✓	DEFRJP
`HBI-029-001`	Observer Rating Scale – Pervasive Developmental Disorders (FBB-TES)	Autism	Parents	✓	DEFRJP
`HBI-029-002`	Observer Rating Scale – Pervasive Developmental Disorders (FBB-TES, Teacher Version)	Autism	Teachers	–	DEFRJP
`HBI-030-001`	Autism Spectrum Quotient (AQ-50)	Autism	Adults	✓	DEENFRITESJPMK
`HBI-031-001`	Camouflaging Autistic Traits Questionnaire (CAT-Q)	Autism	Adults	✓	DEENFRITESJPMK
`HBI-032-001`	Empathy Quotient (EQ-60)	Autism	Adults	✓	DEENFRITESJPMK
`HBI-033-001`	Ritvo Autism Asperger Diagnostic Scale–Revised (RAADS-R)	Autism	Adults	✓	DEENFRITESJPMK
`HBI-034-001`	Repetitive Behaviour Questionnaire (RBQ-2A)	Autism	Adults	✓	DEENFRITESJPMK
`HBI-036-001`	Marburg Asperger Syndrome Rating Scale (alternative source)	Autism	—	✓	DEENFRJP
`HBI-037-001`	Children Depression Test (DTK)	Depression	—	✓	DEENFRJP
`HBI-038-001`	Kessler Stress Questionnaire (K10)	Stress	—	–	DEENFRJP
`HBI-039-001`	Learning and achievement motivation	Lernen	—	–	DEENFRJP
`HBI-040-001`	Phobia Questionnaire for Children and Adolescents	Anxiety	—	–	DEENFRJP
`HBI-041-001`	Wender-Reimherr-Interview (WRI) — Evaluation form	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	—	Children	✓	DE
`HBI-054-001`	PDA-Checkliste für Erwachsene	—	Adults	✓	DE
`HBI-055-001`	EDA-Q (Extreme Demand Avoidance Questionnaire)	—	Parents	✓	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” = wired for the MATLAB Report-Generator export. “Languages” = languages with released item translations (German is the base language).