๐ ์์ํ๊ธฐGetting Started
Symptom Admin์ ์ฆ์๋ถํฐ ์์ํด์ ์ฌ๋ฌ ์ง๋จ์ ๋์์ ํ๊ฐํ๋ ํตํฉ ๊ด๋ฆฌ ๋๊ตฌ์ ๋๋ค. ํ์๊ฐ ํธ์ํ๋ ์ฆ์์ ๋ฐ์์, ์ฐจ๋ณ ์ง๋จ(Differential Diagnosis)๊ณผ ๊ณต์กด ์งํ(Comorbidity) ๋ก์ง์ผ๋ก ADHD, ์ฐ์ธ, ๋ถ์, PTSD, OCD, ์๊ทน์ฑ, ์ํ, ์๋ฉด์ฅ์ ๋ฑ ์์ญ ๊ฐ ์ง๋จ ์ค ํด๋น๋๋ ๊ฒ์ ์๋ณํฉ๋๋ค.
๐ฏ ์ฒซ 5๋ถ ์ฒดํฌ๋ฆฌ์คํธ
- ๐งฉ ๋ชจ๋ ํญ โ ๊ธฐ๋ณธ ํ์ฌ๋ ์ง๋จ ๋ชจ๋ ํ์ธ (ADHD, Depression, Anxiety ๋ฑ)
- ๐ Intake ํญ โ ์ฆ์ ๊ธฐ๋ฐ triage ์ค๋ฌธ์ง ํ์ธ
- โ๏ธ ํ๋ณ ๊ท์น โ ๊ฐ ๋ชจ๋์ ์ง๋จ ๊ฒฐ์ ๊ท์น ํ์ธ
- ๐งฌ Fusion ํญ โ ์ฐจ๋ณ ์ง๋จ + ๊ณต์กด ๋ก์ง ๋งคํธ๋ฆญ์ค ์ดํด
- ์๋ฃ! ๋ค์ ์น์ ์ ์ํฌํ๋ก์ฐ๋ฅผ ์ฝ์ด๋ณด์ธ์.
Symptom Admin is an integrated system that starts from symptoms and evaluates multiple diagnoses simultaneously. Takes patient-reported symptoms and identifies applicable diagnoses among dozens (ADHD, Depression, Anxiety, PTSD, OCD, Bipolar, Autism, Sleep, etc.) using differential diagnosis and comorbidity logic.
๐ฏ First 5-minute checklist
- ๐งฉ Modules tab โ review built-in diagnosis modules (ADHD, Depression, Anxiety, etc.)
- ๐ Intake tab โ review the symptom-based triage questionnaire
- โ๏ธ Rules tab โ review decision rules per module
- ๐งฌ Fusion tab โ understand differential diagnosis + comorbidity matrix
- Done! Continue with the workflow below.
๐ก ํต์ฌ ๊ฐ๋ ยท Why Symptom Admin?Core Concept ยท Why Symptom Admin?
๐ฏ ์ค๊ณ ์์น
์ค์ ํ์๋ "ADHD๊ฐ ์์ฌ๋ฉ๋๋ค"๋ผ๊ณ ์ค์ง ์์ต๋๋ค. "์ง์ค์ด ์ ๋ผ์", "๋ถ์ํด์", "์ ์ด ์ ์์" ๊ฐ์ ์ฆ์์ผ๋ก ์ต๋๋ค. ํ ํ์๋ ๋ณดํต ์ฌ๋ฌ ์ง๋จ ์๊ฑด์ ๋์์ ๋ง์กฑํฉ๋๋ค. ์:
- ์ง์ค ๊ณค๋ โ ADHD ์์ฌ + ์ฐ์ธ ๊ฐ๋ฅ์ฑ + ๋ถ์ ๊ฐ๋ฅ์ฑ
- ์๋ฉด ๋ฌธ์ โ ์ฐ์ธ ์์ฌ + ๋ถ์ ์์ฌ + ์๋ฉด์ฅ์ ์์ฌ
- ๊ณผ๋ฏผํจ โ ADHD + ์๊ทน์ฑ + PTSD
Symptom Admin์ ์ด "ํ๋์ ์ฆ์ โ ์ฌ๋ฌ ์ง๋จ ํ๋ณด" ํ์ค์ ์๋ ๊ทธ๋๋ก ๋ค๋ฃน๋๋ค.
๐งฌ ๋ ์ถ์ ๋ก์ง
๐ ๊ฒฐ๊ณผ UI๋ก์ ์ ํ
Symptom Admin์ด ์ง๋จ์ ๊ฒฐ์ ํ๋ฉด, ๊ทธ์ ๋ง๋ ์น๋ฃ ํ๋กํ ์ฝ UI๋ก ๋จ๊ณ๋ณ ์ ํ๋ฉ๋๋ค. ์: ADHD ํ์ โ ADHD Catcher๋ก. ์ฐ์ธ ํ์ โ (ํฅํ) Depression Catcher๋ก.
๐๏ธ Roadmap (3๋จ๊ณ)
- ADHD Catcher ์์ ๊ฒ์ฆ โ Gold Template ์์ฑ (ํ์ฌ ์งํ ์ค)
- Template ๋ณต์ โ Depression/Anxiety/PTSD ๋ฑ ๋ค๋ฅธ ์ง๋จ์ผ๋ก (rules.json๋ง ๊ต์ฒด)
- Symptom Admin ์ข ํฉ ํ๋ณ ์์คํ ๊ตฌ์ถ โ ์์ญ ๊ฐ ์ง๋จ ํตํฉ (BPS + ์์ ๋งฅ๋ฝ ํ์ ํตํฉ)
๐ฏ Design principle
Real patients don't arrive saying "I suspect ADHD." They come with symptoms: "I can't focus," "I'm anxious," "I can't sleep." A single patient typically meets criteria for multiple diagnoses simultaneously. Examples:
- Difficulty focusing โ suspect ADHD + possible depression + possible anxiety
- Sleep problems โ suspect depression + anxiety + sleep disorder
- Irritability โ ADHD + bipolar + PTSD
Symptom Admin handles this "one symptom โ many diagnosis candidates" reality head-on.
๐งฌ Two axes of logic
๐ Transition to outcome UI
Once Symptom Admin determines diagnoses, it staged-transitions into the matching treatment protocol UI. E.g., ADHD confirmed โ ADHD Catcher. Depression confirmed โ (future) Depression Catcher.
๐๏ธ Roadmap (3 stages)
- ADHD Catcher clinical validation โ Gold Template complete (in progress)
- Template replication โ Depression/Anxiety/PTSD (only rules.json swaps)
- Symptom Admin integrated system โ unify dozens of diagnoses (BPS + clinical context mandatory integration)
๐ ADHD Admin๊ณผ Symptom Admin ๋น๊ตADHD Admin vs Symptom Admin
| ํญ๋ชฉ | ADHD Admin | Symptom Admin |
|---|---|---|
| ์ญํ | ADHD ํ์ ํ ๊น์ ์์ ๊ด๋ฆฌ | ์ฆ์๋ถํฐ ์์ํ๋ ๋ค์ค ์ง๋จ ํ๊ฐ |
| ๋์ ์ง๋จ | ADHD (I, HI, C ์ํ) | ADHD ยท ์ฐ์ธ ยท ๋ถ์ ยท PTSD ยท OCD ยท ์๊ทน์ฑ ยท ์ํ ยท ์๋ฉด ๋ฑ |
| ํต์ฌ ํจ๋ | ํ์ ยท QEEG ยท ์ธ์ ยท ๋ชฉํ + ํ๋ณ/Fingerprint/ํ๋กํ ์ฝ/์์ | ํ์ ยท ๋ชจ๋ ยท Intake ยท ํ๋ณ ยท Fusion ยท ์์ |
| ๋ ํนํ ํจ๋ | ๐ง QEEG ยท ๐ฏ ์ธ์ ๋ก๊ทธ ยท ๐ ๋ชฉํ ยท ๐งญ ํ๋กํ ์ฝ ์์ง | ๐งฉ ๋ชจ๋ (์ง๋จ๋ณ ํ๋ฌ๊ทธ์ธ) ยท ๐งฌ Fusion (๊ฐ๋ณ/๊ณต์กด ๋ก์ง) |
| localStorage ํค | bnm_adhd_admin |
bnm_symptom_admin |
| ์์ ๋ ๋ฆฝ | โ ๋ ์์คํ ์ ์๋ก ์ํฅ ์์ | |
| Aspect | ADHD Admin | Symptom Admin |
|---|---|---|
| Role | Deep clinical management after ADHD confirmed | Multi-diagnosis assessment starting from symptoms |
| Target diagnoses | ADHD (I, HI, C subtypes) | ADHD ยท Depression ยท Anxiety ยท PTSD ยท OCD ยท Bipolar ยท Autism ยท Sleep etc. |
| Core panels | Patients ยท QEEG ยท Sessions ยท Goals + Rules/Fingerprint/Protocol/Safety | Patients ยท Modules ยท Intake ยท Rules ยท Fusion ยท Safety |
| Unique panels | ๐ง QEEG ยท ๐ฏ Session Log ยท ๐ Goals ยท ๐งญ Protocol Engine | ๐งฉ Modules (per-diagnosis plugin) ยท ๐งฌ Fusion (diff-dx/comorbid logic) |
| localStorage key | bnm_adhd_admin |
bnm_symptom_admin |
| Fully independent | โ Zero impact between systems | |
๐ ์ ํ์ ์ํฌํ๋ก์ฐTypical Workflow
๐ ์ค์ ์ฌ๋ก ์ํฌํ๋ก์ฐ
์ฌ๋ก: 28์ธ ์ฌ์ฑ, "์ง์ค์ด ์ ๋๊ณ ๋ถ์ํ๋ค"
- ๐งโโ๏ธ ํ์ ํญ โ ์ ํ์ ๋ฑ๋ก (SY-001 / HL)
- ๐ Intake ํญ โ ์ฆ์ triage ์ค๋ฌธ ์ ๋ฌ โ ์๋ต ๋ฐ์
- โ๏ธ ํ๋ณ ๊ท์น ์๋ ํ๊ฐ: ADHD ๊ท์น ๋งค์น + ๋ถ์ ๊ท์น ๋งค์น
- ๐งฌ Fusion ๊ฒฐ๊ณผ: "ADHD-I ์ฃผ ์ง๋จ + GAD ๊ณต์กด"
- ๐จ ์์ ์ฒดํฌ: SI/SH ์๋ต ํ์ธ โ ์์ฑ โ ์ ์ ํ๋ก์ฐ
- ํ์๋ฅผ ADHD Admin์ผ๋ก ์ ๋ฌ + ๋ถ์ ๊ณต์กด ํ๋๊ทธ ๋จ๊น
๐ Real case workflow
Case: 28 y.o. female, "can't focus and feel anxious"
- ๐งโโ๏ธ Patients tab โ register new patient (SY-001 / HL)
- ๐ Intake tab โ deliver symptom triage survey โ receive responses
- โ๏ธ Rules auto-evaluate: ADHD rule matches + Anxiety rule matches
- ๐งฌ Fusion result: "ADHD-I primary + GAD comorbid"
- ๐จ Safety check: SI/SH response verified โ negative โ normal flow
- Transfer patient to ADHD Admin + flag anxiety comorbidity
๐๏ธ 7๊ฐ ํจ๋ ์์ธ ๊ฐ์ด๋7 Panels ยท Detailed Guide
1. ๐งโโ๏ธ ํ์ ๊ด๋ฆฌ
์ฆ์ triage๋ฅผ ๋ฐ์ ํ์ ๋ชฉ๋ก. ADHD Admin๊ณผ ๊ตฌ์กฐ๋ ์ ์ฌํ์ง๋ง ์์ง ์ง๋จ ํ์ ์ ์ ํ์๋ค.
- ์ฝ๋ (์: SY-001) + ์ด๋์ ๋ง ์ฌ์ฉ (HIPAA)
- ์ฆ์ ์์ฝ + ์ด๊ธฐ triage ์นดํ ๊ณ ๋ฆฌ
- ์ง๋จ ๊ฒฐ์ ํ ์ํ ๋ณ๊ฒฝ
2. ๐งฉ ๋ชจ๋ (์ง๋จ ํ๋ฌ๊ทธ์ธ)
Symptom Admin๋ง์ ๊ณ ์ ํจ๋. ๊ฐ ์ง๋จ(ADHD, Depression, Anxiety ๋ฑ)์ด ํ๋์ "๋ชจ๋"๋ก ํ๋ฌ๊ทธ์ธ๋จ.
๐ ๋ชจ๋ ๊ตฌ์กฐ
- Module ID: ADHD, DEPRESSION, ANXIETY, PTSD, OCD, BIPOLAR, AUTISM, SLEEP ๋ฑ
- ํ์ฑ/๋นํ์ฑ: ๋ชจ๋์ ๋๋ฉด ํด๋น ์ง๋จ ํ๊ฐ ์ ํจ
- Weight: Fusion ์ ๊ฐ์ค์น
- ๊ด๋ จ ๊ท์น/Intake ํญ๋ชฉ: ์ด ๋ชจ๋์ด ์ฐธ์กฐํ๋ ๊ฒ๋ค
๋ชจ๋์ ์ถ๊ฐํ๋ ค๋ฉด 3๊ฐ์ง๋ฅผ ํจ๊ป ์ค๋น:
- ๋ชจ๋ ์ ์ (์ฌ๊ธฐ)
- ํด๋น ์ง๋จ์ฉ Intake ์ง๋ฌธ (๐ Intake ํญ)
- ํ๋ณ ๊ท์น (โ๏ธ Rules ํญ)
3. ๐ Intake ์ค๋ฌธ
์ฆ์ triage ์ค๋ฌธ์ง. ๊ฐ ๋ชจ๋๋ณ ์ง๋ฌธ + ๊ณตํต ์ง๋ฌธ (์๋ฉด, ์๋์ง, ๊ธฐ๋ถ ๋ฑ). ํ์๋ ์ด ์ค๋ฌธ ํ๋๋ก ์ฌ๋ฌ ์ง๋จ์ ๋์์ ์คํฌ๋ฆฌ๋.
โฌ๏ธ JSON ๋ค์ด๋ก๋ โ GitHub์ catcher_rules/symptom_intake.json์ ์
๋ก๋.
4. โ๏ธ ํ๋ณ ๊ท์น
๊ฐ ๋ชจ๋์ ์ง๋จ ๊ฒฐ์ ๊ท์น. ADHD Admin์ ๊ท์น๊ณผ ๊ตฌ์กฐ ๋์ผ (JSON conditions).
๊ท์น๋ง๋ค ์ด๋ ๋ชจ๋์ ์ํ๋์ง ๋ช ์ ์ค์. ๊ฐ์ intake ์๋ต์ด ADHD ๊ท์น๊ณผ ์ฐ์ธ ๊ท์น ๋ ๋ค ๋งค์นํ ์ ์๊ณ , ๊ทธ๊ฒ ์ ์.
5. ๐งฌ Fusion ยท ๊ฐ๋ณ + ๊ณต์กด ๋ก์ง
Symptom Admin์ ์ฌ์ฅ๋ถ. ์ฌ๋ฌ ๊ท์น์ด ๋งค์น๋์ ๋ ์ด๋ป๊ฒ ํตํฉํ ์ง ๊ฒฐ์ .
๐ Fusion ๋งคํธ๋ฆญ์ค
- Differential rules: "ADHD + ์ฐ์ธ ๋งค์น โ ๋ ์ค ๋ ์ ์ ๋์ ๊ฒ์ primary"
- Comorbidity rules: "ADHD + ๋ถ์ ๋งค์น โ ๋ ๋ค ์ ์ง (ํํ ๊ณต์กด)"
- Exclusion rules: "์กฐ์ฆ ํ์ ์ โ ๋จ๊ทน์ฑ ์ฐ์ธ ์ ์ธ"
- Priority: Safety-first > Comorbidity > Differential
6. ๐จ ์์ ํ๋กํ ์ฝ
ADHD Admin์ ์์ ํจ๋๊ณผ ๊ฑฐ์ ๋์ผ. ์์ด/์ํด/์กฐ์ฆ/์ ์ ๋ณ ์๊ณ๊ฐ + ์์.
Symptom Admin์ ์ง๋จ ์ ๋จ๊ณ๋ผ ์์ ์ฒดํฌ๊ฐ ํนํ ์ค์ โ ์ง๋จ ๊ฒฐ์ ๋ณด๋ค ํญ์ ๋จผ์ .
7. โ๏ธ ๋ฐฑ์ ยท ๊ฐ์ฌ ยท ์ค์
ADHD Admin๊ณผ ์์ ๋
๋ฆฝ. ๊ฐ์ ๋ค๋ฅธ localStorage ํค ์ฌ์ฉ. ๋ฐฑ์
JSON์ _system: "symptom_admin" ํ๋๋ก ์๋ณ.
1. ๐งโโ๏ธ Patient Management
List of patients who completed symptom triage. Similar structure to ADHD Admin but pre-diagnosis confirmation.
- Code (e.g., SY-001) + initials only (HIPAA)
- Symptom summary + initial triage category
- Status change after diagnosis decided
2. ๐งฉ Modules (Diagnosis Plugins)
Unique to Symptom Admin. Each diagnosis (ADHD, Depression, Anxiety, etc.) plugs in as a "module."
๐ Module structure
- Module ID: ADHD, DEPRESSION, ANXIETY, PTSD, OCD, BIPOLAR, AUTISM, SLEEP, etc.
- Enabled/disabled: turn off to skip evaluating that diagnosis
- Weight: weighting during Fusion
- Linked rules/Intake items: what this module references
To add a module, prepare 3 things together:
- Module definition (here)
- Intake questions for this diagnosis (๐ Intake tab)
- Determination rules (โ๏ธ Rules tab)
3. ๐ Intake Assessment
Symptom triage questionnaire. Per-module questions + shared items (sleep, energy, mood). One survey screens for multiple diagnoses.
โฌ๏ธ Download JSON โ upload to catcher_rules/symptom_intake.json on GitHub.
4. โ๏ธ Determination Rules
Per-module decision rules. Same structure as ADHD Admin rules (JSON conditions).
Each rule must specify which module it belongs to. A single intake response may match both ADHD and depression rules simultaneously โ and that's normal.
5. ๐งฌ Fusion ยท Differential + Comorbidity Logic
Heart of Symptom Admin. Decides how to integrate when multiple rules match.
๐ Fusion matrix
- Differential rules: "ADHD + depression match โ higher score becomes primary"
- Comorbidity rules: "ADHD + anxiety match โ keep both (common comorbid)"
- Exclusion rules: "mania confirmed โ exclude unipolar depression"
- Priority: Safety-first > Comorbidity > Differential
6. ๐จ Safety Protocol
Nearly identical to ADHD Admin's safety panel. SI/self-harm/mania/psychosis thresholds + resources.
Because Symptom Admin is pre-diagnosis, safety checks are especially critical โ always before diagnosis decisions.
7. โ๏ธ Backup ยท Audit ยท Settings
Fully independent from ADHD Admin. Different localStorage keys. Backup JSON identified by _system: "symptom_admin".
๐งฌ Fusion ๋ก์ง ์ฌํFusion Logic ยท Deep Dive
Symptom Admin์ ๊ฐ์ฅ ๋ณต์กํ๊ณ ๊ฐ์ฅ ๊ฐ์น ์๋ ๋ถ๋ถ. ์ฌ๋ฌ ๊ท์น์ด ๋งค์น๋์ ๋, ๋จ์ํ "๊ฐ์ฅ ์ ์ ๋์ ๊ฒ"์ด ์ ๋ต์ด ์๋๋๋ค.
๐ฏ 3๊ฐ์ง Fusion ๊ท์น ์ ํ
A. Differential (๊ฐ๋ณ)
"A์ B๊ฐ ๋น์ทํ ์ฆ์์ ๊ณต์ ํ์ง๋ง ๋ ์ค ํ๋๋ง ์ง๋จ"
- ADHD vs Depression: ์ง์ค ๊ณค๋์ด ๊ณตํต์ด์ง๋ง, ๋๊ธฐ ์ ํ + ์๋ฉด ์ฆ๊ฐ + ์์ ๋ณํ๊ฐ ์์ผ๋ฉด ์ฐ์ธ ์ชฝ
- Bipolar vs Unipolar Depression: ์กฐ์ฆ ์ฝํ ์ด๋ ฅ์ด ์์ผ๋ฉด ์๊ทน์ฑ
- ADHD vs Anxiety: ๋ถ์ ์์ด ์์ ๋ถ์ฃผ์๋ง์ด๋ฉด ADHD ์ชฝ
B. Comorbidity (๊ณต์กด โ ๋ ๋ค ์ง๋จ)
"A์ B๋ ์์ฃผ ๊ฐ์ด ์ด โ ๋ ๋ค ์ง๋จํด์ผ ์ฌ๋ฐ๋ฅธ ์น๋ฃ"
- ADHD + Anxiety: 50% ์ด์ ๊ณต์กด (๋งค์ฐ ํํจ)
- ADHD + Depression: 30-40% ๊ณต์กด
- PTSD + Depression: ๊ฑฐ์ ํญ์ ๊ณต์กด
C. Exclusion (๋ฐฐํ โ ํ๋๊ฐ ๋ค๋ฅธ ๊ฒ์ ์ ์ธ)
"A๊ฐ ํ์ ๋๋ฉด B๋ ์๋ ์ ์ธ"
- Bipolar โ Unipolar Depression ์ ์ธ
- Substance-induced mood โ Primary mood disorder ์ ์ธ
- Medical cause (thyroid) โ Primary psychiatric disorder ์ ์ธ
๐ ์ฐ์ ์์
- Safety-first (SI/SH) โ ๋ชจ๋ ๊ฒ ์์
- Exclusion rules โ ๋จผ์ ์ ์ธ๋๋ ๊ฒ๋ค ์ฒ๋ฆฌ
- Comorbidity rules โ ๊ณต์กด ๊ด๊ณ ํตํฉ
- Differential rules โ ๋จ์ ๊ฒ๋ค ์ค ๊ฐ๋ณ
The most complex and most valuable part of Symptom Admin. When multiple rules match, "highest score wins" is NOT the right answer.
๐ฏ 3 types of Fusion rules
A. Differential
"A and B share similar symptoms โ diagnose only one"
- ADHD vs Depression: focus issues are common, but low motivation + hypersomnia + appetite changes โ depression
- Bipolar vs Unipolar Depression: manic episode history โ bipolar
- ADHD vs Anxiety: pure inattention without anxiety โ ADHD
B. Comorbidity (both diagnosed)
"A and B often co-occur โ must diagnose both for correct treatment"
- ADHD + Anxiety: >50% comorbidity (very common)
- ADHD + Depression: 30โ40% comorbidity
- PTSD + Depression: nearly always comorbid
C. Exclusion
"A confirmed โ automatically excludes B"
- Bipolar โ excludes unipolar depression
- Substance-induced mood โ excludes primary mood disorder
- Medical cause (thyroid) โ excludes primary psychiatric disorder
๐ Priority order
- Safety-first (SI/SH) โ above everything
- Exclusion rules โ handle exclusions first
- Comorbidity rules โ integrate co-occurring conditions
- Differential rules โ differentiate among the rest
๐จ ์์ ยท HIPAA ยท ๊ฐ์ธ์ ๋ณดSafety ยท HIPAA ยท Privacy
๐ HIPAA ์ฒดํฌ๋ฆฌ์คํธ (ADHD Admin๊ณผ ๋์ผ)
- โ ํ์ ์ฝ๋ + ์ด๋์ ๋ง (์: SY-001 / HL), ์ ์ฒด ์ด๋ฆ ๊ธ์ง
- โ ๋ชจ๋ ๋ฐ์ดํฐ๋ ๋ก์ปฌ ๋ธ๋ผ์ฐ์ ์๋ง โ ์๋ฒ ์์
- โ ํ์ ๋ฐ์ดํฐ๋ ์ ๋ GitHub์ ์ ๋ก๋ ๊ธ์ง
- โ ์ฃผ๊ฐ ๋ฐฑ์ โ ์ํธํ๋ ๋๋ผ์ด๋ธ
- โ ๊ณต์ฉ ์ปดํจํฐ ์ฌ์ฉ ๊ธ์ง
๐ซ ์ ๋ GitHub์ ์ฌ๋ฆฌ๋ฉด ์๋๋ ๊ฒ๋ค (Symptom Admin)
| โ ์ ๋ก๋ ๊ธ์ง | โ ์ ๋ก๋ ํ์ฉ |
|---|---|
| ํ์ ๋ฐ์ดํฐ (patients.json) | ๊ท์น (symptom_rules.json) |
| ํ์ ์๋ต ๊ธฐ๋ก | Intake ์ค๋ฌธ (symptom_intake.json) |
| ์ง๋จ ์ด๋ ฅ | ๋ชจ๋ ์ ์ (symptom_modules.json) |
| ๊ฐ์ฌ ๋ก๊ทธ | Fusion ๋งคํธ๋ฆญ์ค (symptom_fusion.json) |
| ๋ฉ๋ชจ | ์์ ํ๋กํ ์ฝ (symptom_safety.json) |
๐ HIPAA checklist (same as ADHD Admin)
- โ Patient code + initials only (e.g., SY-001 / HL), never full names
- โ All data in local browser only โ no server
- โ Patient data must never be uploaded to GitHub
- โ Weekly backup โ encrypted drive
- โ Never use on public computers
๐ซ Never upload these to GitHub (Symptom Admin)
| โ Do not upload | โ Safe to upload |
|---|---|
| Patient data (patients.json) | Rules (symptom_rules.json) |
| Patient response records | Intake (symptom_intake.json) |
| Diagnosis history | Module defs (symptom_modules.json) |
| Audit log | Fusion matrix (symptom_fusion.json) |
| Notes | Safety (symptom_safety.json) |
โ ์์ฃผ ๋ฌป๋ ์ง๋ฌธFAQ
Q1. ํ ํ์๋ฅผ Symptom Admin์ ๋จผ์ ๋ฃ๊ณ , ์ง๋จ ํ์ ํ ADHD Admin์ผ๋ก ์ฎ๊ธฐ๋ฉด ์๋ ์ด๋๋๋์?
A. ์๋์. ๋ ์์คํ ์ ์์ ๋ ๋ฆฝ์ด๋ผ ์๋ ์ด๋ ์์. ์๋์ผ๋ก: Symptom Admin์์ ํ์ ๋ฐ์ดํฐ ๋ด๋ณด๋ด๊ธฐ โ ADHD Admin์์ ์ ํ์๋ก ์ ๋ ฅ (ํ์ํ ์ ๋ณด๋ง ์ฎ๊ฒจ ์ ๊ธฐ). ํ์ฌ๋ ๊ฐ๋ณ ์ ๋ ฅ ๊ถ์ฅ.
Q2. ๊ฐ์ ํ์๊ฐ ๋ ์์คํ ์ ์กด์ฌํ๋ ๊ฒ ์ ์์ธ๊ฐ์?
A. ๋ค, ์ ์. Symptom Admin = ์ง๋จ ์ triage, ADHD Admin = ์ง๋จ ํ ์น๋ฃ. ๋ชฉ์ ์ด ๋ค๋ฅด๋ฏ๋ก ๊ฐ์ ํ์๊ฐ ๋ ๊ณณ์ ์์ ์ ์์. ์ฝ๋๋ ๋ค๋ฅด๊ฒ ํ ๊ฒ์ ๊ถ์ฅ (์: Symptom์ SY-001, ADHD๋ก ์ฎ๊ธฐ๋ฉด AD-001).
Q3. ์ ์ง๋จ(์: Depression)์ ์ถ๊ฐํ๋ ค๋ฉด ์ด๋ป๊ฒ ํ๋์?
A. 3๋จ๊ณ:
- ๐งฉ ๋ชจ๋ ํญ โ DEPRESSION ๋ชจ๋ ์ถ๊ฐ
- ๐ Intake ํญ โ ์ฐ์ธ์ฆ ์ง๋ฌธ ์น์ ์ถ๊ฐ (PHQ-9 ๊ธฐ๋ฐ ๊ถ์ฅ)
- โ๏ธ Rules ํญ โ ์ฐ์ธ ๊ท์น ์ถ๊ฐ (module_id: "DEPRESSION" ๋ช ์)
ํ์ ์ ๐งฌ Fusion์ comorbidity ๊ท์น๋ ์ถ๊ฐ (ADHD + Depression ๋ฑ).
Q4. Fusion ๊ท์น์ด ๋๋ฌด ๋ณต์กํด์. ์ด๋์๋ถํฐ ์์ํ์ฃ ?
A. ์ฒ์์ Fusion ์์ด ๊ทธ๋ฅ ํ๋ณ ๊ท์น๋ง ๋๋ ค๋ณด์ธ์. ์ค์ ํ์ 10โ20๋ช ์๋ต์ ๋ฐ์๋ณด๋ฉด "์, ์ด๋ฐ ํจํด์ด ์๊ตฌ๋" ํ๋ ๊ฒ ๋ณด์ ๋๋ค. ๊ทธ๋ Fusion ๊ท์น 1โ2๊ฐ์ฉ ์ถ๊ฐ. ์๋ฒฝํ ๋งคํธ๋ฆญ์ค๋ฅผ ์ ํ์ผ๋ก ๋ง๋ค๋ ค๊ณ ํ๋ฉด ์คํ๋ ค ๋งํ.
Q5. ADHD Admin์ด ์์ด๋ Symptom Admin๋ง ์จ๋ ๋๋์?
A. ๋ค. Symptom Admin์ ๋ ๋ฆฝ์ ์ผ๋ก ์๋. ๋จ, ์ง๋จ ํ ์น๋ฃ ๋จ๊ณ๋ก ๋์ด๊ฐ๋ฉด ๋ณ๋ ์์คํ ์ด ํ์ํจ. ADHD Catcher๊ฐ Gold Template์ด ๋๋ฉด ๋ค๋ฅธ Catcher๋ค๋ ๋ณต์ ์์ .
Q1. If I enter a patient in Symptom Admin first and confirm ADHD, does it auto-move to ADHD Admin?
A. No. The two systems are fully independent. Manual: export patient data from Symptom Admin โ re-enter in ADHD Admin (only necessary info). Currently manual entry is recommended.
Q2. Is it normal for the same patient to exist in both systems?
A. Yes, normal. Symptom Admin = pre-diagnosis triage; ADHD Admin = post-diagnosis treatment. Different purposes, so same patient can exist in both. Recommend different codes (e.g., SY-001 in Symptom, AD-001 when moved to ADHD).
Q3. How do I add a new diagnosis (e.g., Depression)?
A. 3 steps:
- ๐งฉ Modules tab โ add DEPRESSION module
- ๐ Intake tab โ add depression question section (PHQ-9 based recommended)
- โ๏ธ Rules tab โ add depression rules (specify module_id: "DEPRESSION")
Add comorbidity rule in ๐งฌ Fusion as needed (ADHD + Depression, etc.).
Q4. Fusion rules feel too complex. Where do I start?
A. Skip Fusion initially. Just run the basic determination rules. After seeing 10โ20 real patient responses, patterns will emerge ("ah, so these cluster together"). Then add Fusion rules 1โ2 at a time. Trying to build a perfect matrix upfront actually blocks progress.
Q5. Can I use Symptom Admin without ADHD Admin?
A. Yes. Symptom Admin works independently. However, post-diagnosis treatment needs a separate system. Once ADHD Catcher becomes the Gold Template, other Catchers will be cloned accordingly.