๐Ÿ“– Clinician Manual ยท v2.0

Symptom Admin ์‚ฌ์šฉ ๋งค๋‰ด์–ผ Symptom Admin User Manual

์ฆ์ƒ ๊ธฐ๋ฐ˜ ๋‹ค์ค‘ ์ง„๋‹จ ํ†ตํ•ฉ ์‹œ์Šคํ…œ โ€” ADHD ยท ์šฐ์šธ ยท ๋ถˆ์•ˆ ยท PTSD ยท OCD ๋“ฑ Symptom-based multi-diagnosis integrated system โ€” ADHD ยท Depression ยท Anxiety ยท PTSD ยท OCD ยท etc.

โ† Symptom Admin์œผ๋กœ ๋Œ์•„๊ฐ€๊ธฐBack to Symptom Admin

๐Ÿš€ ์‹œ์ž‘ํ•˜๊ธฐGetting Started

Symptom Admin์€ ์ฆ์ƒ๋ถ€ํ„ฐ ์‹œ์ž‘ํ•ด์„œ ์—ฌ๋Ÿฌ ์ง„๋‹จ์„ ๋™์‹œ์— ํ‰๊ฐ€ํ•˜๋Š” ํ†ตํ•ฉ ๊ด€๋ฆฌ ๋„๊ตฌ์ž…๋‹ˆ๋‹ค. ํ™˜์ž๊ฐ€ ํ˜ธ์†Œํ•˜๋Š” ์ฆ์ƒ์„ ๋ฐ›์•„์„œ, ์ฐจ๋ณ„ ์ง„๋‹จ(Differential Diagnosis)๊ณผ ๊ณต์กด ์งˆํ™˜(Comorbidity) ๋กœ์ง์œผ๋กœ ADHD, ์šฐ์šธ, ๋ถˆ์•ˆ, PTSD, OCD, ์–‘๊ทน์„ฑ, ์žํ, ์ˆ˜๋ฉด์žฅ์•  ๋“ฑ ์ˆ˜์‹ญ ๊ฐœ ์ง„๋‹จ ์ค‘ ํ•ด๋‹น๋˜๋Š” ๊ฒƒ์„ ์‹๋ณ„ํ•ฉ๋‹ˆ๋‹ค.

๐Ÿงฌ
ADHD Admin๊ณผ ๋‹ค๋ฅธ ์—ญํ•  ADHD Admin์€ ADHD ์ง„๋‹จ์ด ํ™•์ •๋œ ํ›„์˜ ๊นŠ์€ ์ž„์ƒ ๊ด€๋ฆฌ. Symptom Admin์€ ์ง„๋‹จ ์ „์˜ ์ฆ์ƒ ํŠธ๋ฆฌ์•„์ง€ + ๋‹ค์ค‘ ์ง„๋‹จ ํ†ตํ•ฉ ์‹œ์Šคํ…œ.

๐ŸŽฏ ์ฒซ 5๋ถ„ ์ฒดํฌ๋ฆฌ์ŠคํŠธ

  1. ๐Ÿงฉ ๋ชจ๋“ˆ ํƒญ โ†’ ๊ธฐ๋ณธ ํƒ‘์žฌ๋œ ์ง„๋‹จ ๋ชจ๋“ˆ ํ™•์ธ (ADHD, Depression, Anxiety ๋“ฑ)
  2. ๐Ÿ“‹ Intake ํƒญ โ†’ ์ฆ์ƒ ๊ธฐ๋ฐ˜ triage ์„ค๋ฌธ์ง€ ํ™•์ธ
  3. โš–๏ธ ํŒ๋ณ„ ๊ทœ์น™ โ†’ ๊ฐ ๋ชจ๋“ˆ์˜ ์ง„๋‹จ ๊ฒฐ์ • ๊ทœ์น™ ํ™•์ธ
  4. ๐Ÿงฌ Fusion ํƒญ โ†’ ์ฐจ๋ณ„ ์ง„๋‹จ + ๊ณต์กด ๋กœ์ง ๋งคํŠธ๋ฆญ์Šค ์ดํ•ด
  5. ์™„๋ฃŒ! ๋‹ค์Œ ์„น์…˜์˜ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ์ฝ์–ด๋ณด์„ธ์š”.

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.

๐Ÿงฌ
Different role from ADHD Admin ADHD Admin is for deep clinical management after an ADHD diagnosis is confirmed. Symptom Admin is the symptom triage + multi-diagnosis integrated system before diagnosis.

๐ŸŽฏ First 5-minute checklist

  1. ๐Ÿงฉ Modules tab โ†’ review built-in diagnosis modules (ADHD, Depression, Anxiety, etc.)
  2. ๐Ÿ“‹ Intake tab โ†’ review the symptom-based triage questionnaire
  3. โš–๏ธ Rules tab โ†’ review decision rules per module
  4. ๐Ÿงฌ Fusion tab โ†’ understand differential diagnosis + comorbidity matrix
  5. Done! Continue with the workflow below.

๐Ÿ’ก ํ•ต์‹ฌ ๊ฐœ๋… ยท Why Symptom Admin?Core Concept ยท Why Symptom Admin?

๐ŸŽฏ ์„ค๊ณ„ ์›์น™

์‹ค์ œ ํ™˜์ž๋Š” "ADHD๊ฐ€ ์˜์‹ฌ๋ฉ๋‹ˆ๋‹ค"๋ผ๊ณ  ์˜ค์ง€ ์•Š์Šต๋‹ˆ๋‹ค. "์ง‘์ค‘์ด ์•ˆ ๋ผ์š”", "๋ถˆ์•ˆํ•ด์š”", "์ž ์ด ์•ˆ ์™€์š”" ๊ฐ™์€ ์ฆ์ƒ์œผ๋กœ ์˜ต๋‹ˆ๋‹ค. ํ•œ ํ™˜์ž๋Š” ๋ณดํ†ต ์—ฌ๋Ÿฌ ์ง„๋‹จ ์š”๊ฑด์„ ๋™์‹œ์— ๋งŒ์กฑํ•ฉ๋‹ˆ๋‹ค. ์˜ˆ:

  • ์ง‘์ค‘ ๊ณค๋ž€ โ†’ ADHD ์˜์‹ฌ + ์šฐ์šธ ๊ฐ€๋Šฅ์„ฑ + ๋ถˆ์•ˆ ๊ฐ€๋Šฅ์„ฑ
  • ์ˆ˜๋ฉด ๋ฌธ์ œ โ†’ ์šฐ์šธ ์˜์‹ฌ + ๋ถˆ์•ˆ ์˜์‹ฌ + ์ˆ˜๋ฉด์žฅ์•  ์˜์‹ฌ
  • ๊ณผ๋ฏผํ•จ โ†’ ADHD + ์–‘๊ทน์„ฑ + PTSD

Symptom Admin์€ ์ด "ํ•˜๋‚˜์˜ ์ฆ์ƒ โ†’ ์—ฌ๋Ÿฌ ์ง„๋‹จ ํ›„๋ณด" ํ˜„์‹ค์„ ์žˆ๋Š” ๊ทธ๋Œ€๋กœ ๋‹ค๋ฃน๋‹ˆ๋‹ค.

๐Ÿงฌ ๋‘ ์ถ•์˜ ๋กœ์ง

โš–๏ธ
Differential Diagnosis (๊ฐ๋ณ„ ์ง„๋‹จ) ๋น„์Šทํ•œ ์ฆ์ƒ ์ค‘ ์–ด๋А ์ง„๋‹จ์ด ๋” ํƒ€๋‹นํ•œ๊ฐ€? ์˜ˆ: "์ง‘์ค‘ ๊ณค๋ž€"์ด ADHD์ธ๊ฐ€, ์šฐ์šธ ๋•Œ๋ฌธ์ธ๊ฐ€, ๊ฐ‘์ƒ์„  ๋ฌธ์ œ์ธ๊ฐ€?
๐Ÿ”—
Comorbidity (๊ณต์กด ์ง„๋‹จ) ์—ฌ๋Ÿฌ ์ง„๋‹จ์ด ๋™์‹œ์— ์„ฑ๋ฆฝํ•˜๋Š”๊ฐ€? ADHD + ๋ถˆ์•ˆ ๊ณต์กด์€ ๋งค์šฐ ํ”ํ•ฉ๋‹ˆ๋‹ค. ๋‘ ์ง„๋‹จ ๋ชจ๋‘ ์ธ์‹ํ•ด์•ผ ์˜ฌ๋ฐ”๋ฅธ ์น˜๋ฃŒ๊ฐ€ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

๐Ÿ“Š ๊ฒฐ๊ณผ UI๋กœ์˜ ์ „ํ™˜

Symptom Admin์ด ์ง„๋‹จ์„ ๊ฒฐ์ •ํ•˜๋ฉด, ๊ทธ์— ๋งž๋Š” ์น˜๋ฃŒ ํ”„๋กœํ† ์ฝœ UI๋กœ ๋‹จ๊ณ„๋ณ„ ์ „ํ™˜๋ฉ๋‹ˆ๋‹ค. ์˜ˆ: ADHD ํ™•์ • โ†’ ADHD Catcher๋กœ. ์šฐ์šธ ํ™•์ • โ†’ (ํ–ฅํ›„) Depression Catcher๋กœ.

๐Ÿ—๏ธ Roadmap (3๋‹จ๊ณ„)

  1. ADHD Catcher ์ž„์ƒ ๊ฒ€์ฆ โ†’ Gold Template ์™„์„ฑ (ํ˜„์žฌ ์ง„ํ–‰ ์ค‘)
  2. Template ๋ณต์ œ โ†’ Depression/Anxiety/PTSD ๋“ฑ ๋‹ค๋ฅธ ์ง„๋‹จ์œผ๋กœ (rules.json๋งŒ ๊ต์ฒด)
  3. 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

โš–๏ธ
Differential Diagnosis Among similar symptoms, which diagnosis best fits? E.g., is "difficulty focusing" ADHD, depression, or thyroid issue?
๐Ÿ”—
Comorbidity Do multiple diagnoses hold simultaneously? ADHD + anxiety comorbidity is very common. Both must be recognized for correct treatment.

๐Ÿ“Š 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)

  1. ADHD Catcher clinical validation โ†’ Gold Template complete (in progress)
  2. Template replication โ†’ Depression/Anxiety/PTSD (only rules.json swaps)
  3. 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
์™„์ „ ๋…๋ฆฝ โœ… ๋‘ ์‹œ์Šคํ…œ์€ ์„œ๋กœ ์˜ํ–ฅ ์—†์Œ
๐ŸŽฏ
์–ธ์ œ ์–ด๋А Admin์„ ์“ธ์ง€ ์ƒˆ ํ™˜์ž ์ž…๋ ฅ ์ดˆ๊ธฐ: Symptom Admin (์ง„๋‹จ ๊ฒฐ์ • ์ „). ADHD ํ™•์ • ํ™˜์ž ๊ด€๋ฆฌ: ADHD 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
๐ŸŽฏ
When to use which Early intake (before diagnosis): Symptom Admin. Confirmed ADHD patient management: ADHD Admin. Same patient may exist in both systems (normal workflow).

๐Ÿ”„ ์ „ํ˜•์  ์›Œํฌํ”Œ๋กœ์šฐTypical Workflow

ํ™˜์ž ์ฆ์ƒ ํ˜ธ์†Œ โ†“ [๐Ÿ“‹ Intake ์„ค๋ฌธ] โ€” ์ฆ์ƒ ๊ธฐ๋ฐ˜ triage ์งˆ๋ฌธ โ†“ [โš–๏ธ ํŒ๋ณ„ ๊ทœ์น™] โ€” ๊ฐ ์ง„๋‹จ ๋ชจ๋“ˆ์˜ ๊ทœ์น™ ํ‰๊ฐ€ โ†“ [๐Ÿงฌ Fusion] โ€” ๊ฐ๋ณ„/๊ณต์กด ๋กœ์ง ์ ์šฉ โ†“ ๊ฒฐ๊ณผ: "ADHD + ๊ณต์กด ๋ถˆ์•ˆ ์˜์‹ฌ" (์˜ˆ) โ†“ [์น˜๋ฃŒ UI ์ „ํ™˜] โ†’ ADHD Catcher ๋˜๋Š” ํ•ด๋‹น ์ „๋ฌธ UI

๐Ÿ“ ์‹ค์ œ ์‚ฌ๋ก€ ์›Œํฌํ”Œ๋กœ์šฐ

์‚ฌ๋ก€: 28์„ธ ์—ฌ์„ฑ, "์ง‘์ค‘์ด ์•ˆ ๋˜๊ณ  ๋ถˆ์•ˆํ•˜๋‹ค"

  1. ๐Ÿง‘โ€โš•๏ธ ํ™˜์ž ํƒญ โ†’ ์ƒˆ ํ™˜์ž ๋“ฑ๋ก (SY-001 / HL)
  2. ๐Ÿ“‹ Intake ํƒญ โ†’ ์ฆ์ƒ triage ์„ค๋ฌธ ์ „๋‹ฌ โ†’ ์‘๋‹ต ๋ฐ›์Œ
  3. โš–๏ธ ํŒ๋ณ„ ๊ทœ์น™ ์ž๋™ ํ‰๊ฐ€: ADHD ๊ทœ์น™ ๋งค์น˜ + ๋ถˆ์•ˆ ๊ทœ์น™ ๋งค์น˜
  4. ๐Ÿงฌ Fusion ๊ฒฐ๊ณผ: "ADHD-I ์ฃผ ์ง„๋‹จ + GAD ๊ณต์กด"
  5. ๐Ÿšจ ์•ˆ์ „ ์ฒดํฌ: SI/SH ์‘๋‹ต ํ™•์ธ โ†’ ์Œ์„ฑ โ†’ ์ •์ƒ ํ”Œ๋กœ์šฐ
  6. ํ™˜์ž๋ฅผ ADHD Admin์œผ๋กœ ์ „๋‹ฌ + ๋ถˆ์•ˆ ๊ณต์กด ํ”Œ๋ž˜๊ทธ ๋‚จ๊น€
Patient presents with symptoms โ†“ [๐Ÿ“‹ Intake] โ€” symptom-based triage questions โ†“ [โš–๏ธ Rules] โ€” evaluate rules per diagnosis module โ†“ [๐Ÿงฌ Fusion] โ€” apply differential/comorbidity logic โ†“ Result: "ADHD + suspected comorbid anxiety" (example) โ†“ [Transition to treatment UI] โ†’ ADHD Catcher or specialized UI

๐Ÿ“ Real case workflow

Case: 28 y.o. female, "can't focus and feel anxious"

  1. ๐Ÿง‘โ€โš•๏ธ Patients tab โ†’ register new patient (SY-001 / HL)
  2. ๐Ÿ“‹ Intake tab โ†’ deliver symptom triage survey โ†’ receive responses
  3. โš–๏ธ Rules auto-evaluate: ADHD rule matches + Anxiety rule matches
  4. ๐Ÿงฌ Fusion result: "ADHD-I primary + GAD comorbid"
  5. ๐Ÿšจ Safety check: SI/SH response verified โ†’ negative โ†’ normal flow
  6. 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๊ฐ€์ง€๋ฅผ ํ•จ๊ป˜ ์ค€๋น„:

  1. ๋ชจ๋“ˆ ์ •์˜ (์—ฌ๊ธฐ)
  2. ํ•ด๋‹น ์ง„๋‹จ์šฉ Intake ์งˆ๋ฌธ (๐Ÿ“‹ Intake ํƒญ)
  3. ํŒ๋ณ„ ๊ทœ์น™ (โš–๏ธ 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:

  1. Module definition (here)
  2. Intake questions for this diagnosis (๐Ÿ“‹ Intake tab)
  3. 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 ์ œ์™ธ

๐Ÿ”‘ ์šฐ์„ ์ˆœ์œ„

  1. Safety-first (SI/SH) โ€” ๋ชจ๋“  ๊ฒƒ ์œ„์—
  2. Exclusion rules โ€” ๋จผ์ € ์ œ์™ธ๋˜๋Š” ๊ฒƒ๋“ค ์ฒ˜๋ฆฌ
  3. Comorbidity rules โ€” ๊ณต์กด ๊ด€๊ณ„ ํ†ตํ•ฉ
  4. Differential rules โ€” ๋‚จ์€ ๊ฒƒ๋“ค ์ค‘ ๊ฐ๋ณ„
๐Ÿ’ก
์„ค๊ณ„ ํŒ ์ฒ˜์Œ์—๋Š” Differential๋งŒ 1โ€“2๊ฐœ ์ •์˜ํ•˜๊ณ  ์‹œ์ž‘ํ•˜์„ธ์š”. ์‹ค์ œ ํ™˜์ž ์ผ€์ด์Šค๋ฅผ 10โ€“20๊ฐœ ๋ณธ ํ›„ comorbidity ๊ทœ์น™์„ ์ถ”๊ฐ€ํ•˜๋Š” ๊ฒƒ์ด ์ข‹์Šต๋‹ˆ๋‹ค. ์ฒ˜์Œ๋ถ€ํ„ฐ ์™„๋ฒฝํ•œ ๋งคํŠธ๋ฆญ์Šค๋ฅผ ๋งŒ๋“ค๋ ค๊ณ  ํ•˜์ง€ ๋งˆ์„ธ์š”.

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

  1. Safety-first (SI/SH) โ€” above everything
  2. Exclusion rules โ€” handle exclusions first
  3. Comorbidity rules โ€” integrate co-occurring conditions
  4. Differential rules โ€” differentiate among the rest
๐Ÿ’ก
Design tip Start with just 1โ€“2 differential rules. Add comorbidity rules after seeing 10โ€“20 real cases. Don't try to build a perfect matrix from scratch.

๐Ÿšจ ์•ˆ์ „ ยท HIPAA ยท ๊ฐœ์ธ์ •๋ณดSafety ยท HIPAA ยท Privacy

๐Ÿšจ
์ง„๋‹จ ๊ฒฐ์ •๋ณด๋‹ค ํ•ญ์ƒ ๋จผ์ € ์•ˆ์ „ ํ™•์ธ Symptom Admin์€ ์ง„๋‹จ ์ „ ๋‹จ๊ณ„๋ผ ์ž์‚ด์‚ฌ๊ณ /์žํ•ด ์ฒดํฌ๊ฐ€ ๊ฐ€์žฅ ์ค‘์š”. Intake ์‘๋‹ต์— SI/SH ์žˆ์œผ๋ฉด ์ง„๋‹จ ํ‰๊ฐ€ ์ค‘๋‹จ โ†’ ๐Ÿšจ ์•ˆ์ „ ํ”„๋กœํ† ์ฝœ๋กœ ์ฆ‰์‹œ ์ด๋™.

๐Ÿ“‹ 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)
๐Ÿšจ
Safety checks always precede diagnosis decisions Since Symptom Admin is pre-diagnosis, SI/self-harm checks are paramount. If Intake response shows SI/SH, halt diagnostic evaluation โ†’ switch to ๐Ÿšจ Safety Protocol immediately.

๐Ÿ“‹ 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 recordsIntake (symptom_intake.json)
Diagnosis historyModule defs (symptom_modules.json)
Audit logFusion matrix (symptom_fusion.json)
NotesSafety (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๋‹จ๊ณ„:

  1. ๐Ÿงฉ ๋ชจ๋“ˆ ํƒญ โ†’ DEPRESSION ๋ชจ๋“ˆ ์ถ”๊ฐ€
  2. ๐Ÿ“‹ Intake ํƒญ โ†’ ์šฐ์šธ์ฆ ์งˆ๋ฌธ ์„น์…˜ ์ถ”๊ฐ€ (PHQ-9 ๊ธฐ๋ฐ˜ ๊ถŒ์žฅ)
  3. โš–๏ธ 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:

  1. ๐Ÿงฉ Modules tab โ†’ add DEPRESSION module
  2. ๐Ÿ“‹ Intake tab โ†’ add depression question section (PHQ-9 based recommended)
  3. โš–๏ธ 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.

โ† Symptom Admin์œผ๋กœ ๋Œ์•„๊ฐ€๊ธฐBack to Symptom Admin