๐Ÿ“‹ Flexible Survey Engine

๋ชจ๋“  ์„ค๋ฌธ์„ ์œ ์—ฐํ•˜๊ฒŒ ์ฒ˜๋ฆฌํ•˜๋Š” ํ”Œ๋Ÿฌ๊ทธ์ธ ์‹œ์Šคํ…œ

๐ŸŽฏ ์„ค๊ณ„ ์ฒ ํ•™

ํ•ต์‹ฌ ์›์น™:
  • ๐Ÿ”Œ ํ”Œ๋Ÿฌ๊ทธ์ธ ๋ฐฉ์‹ - JSON๋งŒ ์ถ”๊ฐ€ํ•˜๋ฉด ์ฆ‰์‹œ ์‚ฌ์šฉ ๊ฐ€๋Šฅ
  • ๐ŸŽจ ์œ ์—ฐํ•œ ํ˜•์‹ - ์–ด๋–ค ์„ค๋ฌธ ๊ตฌ์กฐ๋„ ์ˆ˜์šฉ
  • ๐Ÿง  ์ž๋™ ํ†ตํ•ฉ - 3D Neural Cartography์— ์ž๋™ ์—ฐ๊ฒฐ
  • ๐ŸŒ ๋‹ค๊ตญ์–ด ์ง€์› - ๋ฒˆ์—ญ ์ž๋™ ๋งคํ•‘
  • ๐Ÿ“Š AI ํ•™์Šต ๊ฐ€๋Šฅ - ๋ชจ๋“  ์‘๋‹ต โ†’ ๋ฐ์ดํ„ฐ ์ž์‚ฐ

๋ฌธ์ œ: ๊ธฐ์กด ํ”Œ๋žซํผ์€ ๊ณ ์ •๋œ ์„ค๋ฌธ๋งŒ ์ง€์›. ์ƒˆ ์„ค๋ฌธ ์ถ”๊ฐ€ ์‹œ ์ฝ”๋“œ ๋ณ€๊ฒฝ ํ•„์š”.
์†”๋ฃจ์…˜: JSON ์Šคํ‚ค๋งˆ ๊ธฐ๋ฐ˜ + AI ์ž๋™ ํŒŒ์‹ฑ = ๋ฌดํ•œ ํ™•์žฅ ๊ฐ€๋Šฅ

๐Ÿ“ Survey JSON Schema (ํ‘œ์ค€ ํฌ๋งท)

๋ชจ๋“  ์„ค๋ฌธ์€ ์ด ํฌ๋งท์œผ๋กœ ์ •์˜ํ•˜๋ฉด ์ž๋™ ํ†ตํ•ฉ:

{
  "survey_id": "unique_identifier",
  "name": "Survey Display Name",
  "version": "1.0",
  "category": "screening/diagnostic/outcome",
  
  // ์ ์šฉ ๋Œ€์ƒ
  "target_conditions": ["adhd", "anxiety"],
  "target_age": ["adult", "adolescent"],
  "target_gender": ["all"],
  
  // ๋‹ค๊ตญ์–ด ์ง€์›
  "translations": {
    "en": { "title": "...", "description": "..." },
    "ko": { "title": "...", "description": "..." }
  },
  
  // ๋ฌธํ•ญ๋“ค
  "questions": [
    {
      "id": "q1",
      "type": "likert/multi/scale/text/yn",
      "text": { "en": "...", "ko": "..." },
      "options": [
        { "value": 0, "label": { "en": "Never", "ko": "์ „ํ˜€" }},
        { "value": 4, "label": { "en": "Always", "ko": "ํ•ญ์ƒ" }}
      ],
      "axis_contribution": { // 3D ์ถ• ๋งคํ•‘
        "arousal": 0.3,
        "valence": -0.5,
        "control": 0
      },
      "evidence": "Kessler et al. 2005"
    }
  ],
  
  // ์ฑ„์  ๊ทœ์น™
  "scoring": {
    "method": "sum/mean/weighted",
    "ranges": {
      "minimal": [0, 4],
      "mild": [5, 9],
      "moderate": [10, 14],
      "severe": [15, 21]
    }
  },
  
  // ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ
  "metadata": {
    "author": "Original creator",
    "citation": "DOI or reference",
    "estimated_time": 5, // minutes
    "validated": "true"
  }
}

๐Ÿ“š ๊ธฐ๋ณธ ํƒ‘์žฌ ํ‘œ์ค€ ์ฒ™๋„

๋Ÿฐ์นญ ์‹œ ๋ฐ”๋กœ ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๊ฒ€์ฆ๋œ ์ฒ™๋„๋“ค (JSON ์ค€๋น„ ์™„๋ฃŒ):

BPS-90

Biopsychosocial Intake

90๋ฌธํ•ญ ์ข…ํ•ฉ ํ‰๊ฐ€ (Adult 45 + Pediatric 45)

PHQ-9

Depression Scale

9๋ฌธํ•ญ ์šฐ์šธ์ฆ ์„ ๋ณ„, ํ•œ๊ตญํŒ ๊ฒ€์ฆ

GAD-7

Generalized Anxiety

7๋ฌธํ•ญ ๋ถˆ์•ˆ ์„ ๋ณ„

ASRS

Adult ADHD Self-Report

6 (short) or 18๋ฌธํ•ญ

PCL-5

PTSD Checklist

20๋ฌธํ•ญ PTSD ํ‰๊ฐ€

ISI

Insomnia Severity

7๋ฌธํ•ญ ๋ถˆ๋ฉด์ฆ ํ‰๊ฐ€

Conners

Conners 3 (์•„๋™)

์•„๋™ ADHD ํ‰๊ฐ€

BRIEF

Executive Function

์‹คํ–‰ ๊ธฐ๋Šฅ ํ‰๊ฐ€

DERS

Emotion Regulation

36๋ฌธํ•ญ ์ •์„œ ์กฐ์ ˆ

๐Ÿ’ก ํ–ฅํ›„ ํ™•์žฅ: ์ˆ˜๋ฐฑ ๊ฐœ์˜ ํ‘œ์ค€ ์ฒ™๋„ JSON ์ถ”๊ฐ€ ๊ฐ€๋Šฅ. ์ „๋ฌธ๊ฐ€๊ฐ€ ์ƒˆ ์ฒ™๋„ JSON ์ œ์ถœ โ†’ ๊ฒ€ํ†  ํ›„ ํ†ตํ•ฉ โ†’ ์ „์ฒด ์‚ฌ์šฉ์ž์—๊ฒŒ ์ฆ‰์‹œ ์ œ๊ณต.

๐ŸŽจ ์ปค์Šคํ…€ ์„ค๋ฌธ (Third-party)

๋ˆ„๊ตฌ๋“  JSON ํฌ๋งท ๋”ฐ๋ฅด๋ฉด ์ž๊ธฐ ์„ค๋ฌธ ์ถ”๊ฐ€ ๊ฐ€๋Šฅ:

์‚ฌ์šฉ ์ผ€์ด์Šค

๐Ÿฅ ํด๋ฆฌ๋‹‰ ๋‚ด๋ถ€

์‹ธ๋ถ€๋‹˜ ํด๋ฆฌ๋‹‰๋งŒ์˜ ํŠน๋ณ„ํ•œ ์„ค๋ฌธ (Intake v2 ๋“ฑ)

๐ŸŽ“ ์—ฐ๊ตฌ์ž

ํŠน์ • ์—ฐ๊ตฌ ๋ชฉ์  ์„ค๋ฌธ (IRB ์Šน์ธ ํ›„)

๐ŸŒ ํƒ€๋ฌธํ™” ์ ์‘

ํ•œ๊ตญ, ์ผ๋ณธ, ์ค‘๊ตญ ํŠนํ™” ์„ค๋ฌธ

๐Ÿ’ผ ๊ธฐ์—… ๊ณ ๊ฐ

์ง์› ์›ฐ๋น™ ํ‰๊ฐ€, ๋ฒˆ์•„์›ƒ ์Šคํฌ๋ฆฌ๋‹

๐ŸŽฏ ํŠน์ˆ˜ ์ฆ์ƒ

ํฌ๊ท€ ์ฆ์ƒ, ๋ณตํ•ฉ ์ƒํƒœ์šฉ

๐Ÿ”ฌ AI ์ž๋™ ์ƒ์„ฑ

ํ™˜์ž ํŠน์„ฑ ๊ธฐ๋ฐ˜ ๋งž์ถค ์„ค๋ฌธ

๐Ÿค– ์ž๋™ ํ†ตํ•ฉ ์—”์ง„

์ƒˆ ์„ค๋ฌธ JSON ์—…๋กœ๋“œ โ†’ ์‹œ์Šคํ…œ์ด ์ž๋™์œผ๋กœ ์ฒ˜๋ฆฌ:

Step 1: JSON ์—…๋กœ๋“œ & ๊ฒ€์ฆ
  - Schema ๊ฒ€์ฆ
  - ๋ฌธํ•ญ ๊ตฌ์กฐ ํ™•์ธ
  - ๋ฒˆ์—ญ ์™„์„ฑ๋„ ์ฒดํฌ
    โ†“
Step 2: AI ๋ถ„์„
  - Claude๊ฐ€ ์„ค๋ฌธ ๋ชฉ์  ํŒŒ์•…
  - ์–ด๋–ค ์ฆ์ƒ๊ณผ ์—ฐ๊ด€?
  - 3D ์ถ• ์–ด๋–ป๊ฒŒ ๋งคํ•‘?
    โ†“
Step 3: DB ๋“ฑ๋ก
  - surveys ํ…Œ์ด๋ธ”์— ์ €์žฅ
  - ๊ด€๋ จ ์ฆ์ƒ ๋ชจ๋“ˆ์— ์—ฐ๊ฒฐ
    โ†“
Step 4: UI ์ž๋™ ์ƒ์„ฑ
  - ์„ค๋ฌธ ๋ Œ๋”๋ง
  - ์ง„ํ–‰ ํ‘œ์‹œ
  - ๊ฒฐ๊ณผ ๊ณ„์‚ฐ
    โ†“
Step 5: ๊ฒฐ์ • ์‹œ์Šคํ…œ ํ†ตํ•ฉ
  - Neural Cartography ์ถ• ์—…๋ฐ์ดํŠธ
  - ์ฆ์ƒ ํ™•๋ฅ  ๊ณ„์‚ฐ์— ํฌํ•จ
  - ํ”„๋กœํ† ์ฝœ ์ถ”์ฒœ์— ๋ฐ˜์˜

๐Ÿง  AI ๊ธฐ๋ฐ˜ ์ถ• ๋งคํ•‘

๊ฐ ๋ฌธํ•ญ์ด 3D Neural Cartography ์ถ•์— ์–ด๋–ป๊ฒŒ ๊ธฐ์—ฌํ•˜๋Š”์ง€ ์ž๋™ ๊ฒฐ์ •:

// ์˜ˆ์‹œ: PHQ-9 ์ฒซ ๋ฒˆ์งธ ๋ฌธํ•ญ
"text": "ํฅ๋ฏธ๋‚˜ ์ฆ๊ฑฐ์›€์ด ๊ฑฐ์˜ ์—†๋‹ค๊ณ  ๋А๋‚€๋‹ค",

// AI๊ฐ€ ์ž๋™ ๋ถ„์„:
"axis_contribution": {
  "arousal": -0.3,  // ๋‚ฎ์€ ๊ฐ์„ฑ (๋ฌด๊ธฐ๋ ฅ)
  "valence": -0.8,  // ๋งค์šฐ ๋ถ€์ •์  ์ •์„œ
  "control": -0.2   // ์•ฝ๊ฐ„ ๋‚ฎ์€ ํ†ต์ œ๊ฐ
}
๐Ÿ’ก ์˜๋ฆฌํ•œ ์ : AI๊ฐ€ ์„ค๋ฌธ์˜ ์˜๋ฏธ๋ฅผ ํŒŒ์•…ํ•ด์„œ ์ถ•์— ๋งคํ•‘. ์ „๋ฌธ๊ฐ€๋Š” ๊ฒ€ํ† ๋งŒ ํ•˜๋ฉด ๋จ. ๋ฏธ๋ž˜ ์„ค๋ฌธ์ด ์ถ”๊ฐ€๋  ๋•Œ๋งˆ๋‹ค ์ž๋™์œผ๋กœ ์ฒ˜๋ฆฌ.

๐Ÿ“‹ ์‹ค์ œ ์˜ˆ์‹œ

์˜ˆ์‹œ 1: ์‚ฌ์šฉ์ž๊ฐ€ ์„ค๋ฌธ ํ‘ธ๋Š” ํ๋ฆ„

์‚ฌ์šฉ์ž ๋กœ๊ทธ์ธ โ†’ ์ฆ์ƒ ์„ ํƒ (ADHD ์˜์‹ฌ)
    โ†“
์‹œ์Šคํ…œ ์ž๋™ ์ถ”์ฒœ ์„ค๋ฌธ:
  - BPS-90 (ํ•„์ˆ˜, ์ข…ํ•ฉ)
  - ASRS (ADHD ํŠนํ™”)
  - DERS (๊ฐ์ • ์กฐ์ ˆ, ์„ ํƒ)
    โ†“
์‚ฌ์šฉ์ž ์™„๋ฃŒ
    โ†“
๊ฒฐ๊ณผ ์ž๋™ ๊ณ„์‚ฐ + 3D ์œ„์น˜ ์—…๋ฐ์ดํŠธ
    โ†“
Neural Cartography ์‹œ๊ฐํ™”์— ์ฆ‰์‹œ ๋ฐ˜์˜

์˜ˆ์‹œ 2: ์‹ธ๋ถ€๋‹˜์ด ์ปค์Šคํ…€ ์„ค๋ฌธ ์ถ”๊ฐ€

์‹ธ๋ถ€๋‹˜์ด ํŠน๋ณ„ํ•œ ์„ค๋ฌธ JSON ์ž‘์„ฑ
  (์˜ˆ: "Peak Performance Assessment for Athletes")
    โ†“
NeuroCatchers ๊ด€๋ฆฌ์ž ํŽ˜์ด์ง€์— ์—…๋กœ๋“œ
    โ†“
AI ๊ฒ€์ฆ + ์ž๋™ ๋งคํ•‘
    โ†“
์ฆ‰์‹œ ์‚ฌ์šฉ ๊ฐ€๋Šฅ
  - Peak Performance ๋ชจ๋“ˆ์— ์ž๋™ ์—ฐ๊ฒฐ
  - ๋ชจ๋“  ์‚ฌ์šฉ์ž์—๊ฒŒ ์˜ต์…˜์œผ๋กœ ์ œ๊ณต
  - ๊ฒฐ๊ณผ ์ž๋™ ๋ถ„์„

โš™๏ธ ๊ธฐ์ˆ  ๊ตฌํ˜„

ํŒŒ์ผ ๊ตฌ์กฐ

neurotracker_platform/
  data/
    surveys/
      bps_intake_90.json  // โœ… ์ด๋ฏธ ์žˆ์Œ
      phq9.json          // ์ถ”๊ฐ€ ์˜ˆ์ •
      gad7.json
      asrs.json
      custom/
        clinic_specific_1.json
  core/
    survey_engine.js    // ์ฒ˜๋ฆฌ ์—”์ง„
    survey_renderer.js  // UI ๋ Œ๋”๋Ÿฌ
    axis_mapper.js      // 3D ์ถ• ๋งคํ•‘
}

API ์—”๋“œํฌ์ธํŠธ

Endpoint๊ธฐ๋Šฅ
GET /surveys์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์„ค๋ฌธ ๋ชฉ๋ก
GET /surveys/:idํŠน์ • ์„ค๋ฌธ ๋ฐ์ดํ„ฐ
POST /surveys/:id/submit์‘๋‹ต ์ œ์ถœ
POST /surveys (admin)์ƒˆ ์„ค๋ฌธ ์ถ”๊ฐ€
GET /surveys/recommended์‚ฌ์šฉ์ž ๋งž์ถค ์ถ”์ฒœ

๐Ÿ’ฐ ๋น„์ฆˆ๋‹ˆ์Šค ๋ชจ๋ธ

์„ค๋ฌธ ์—”์ง„ ์ž์ฒด๊ฐ€ ์ˆ˜์ต์›์ด ๋  ์ˆ˜๋„:

ํ‹ฐ์–ด์„ค๋ฌธ ์ ‘๊ทผ๊ฐ€๊ฒฉ
Basic ๊ธฐ๋ณธ 5-10๊ฐœ ํฌํ•จ
Professional ๋ชจ๋“  ํ‘œ์ค€ ์ฒ™๋„ + $20/์›”
Enterprise ์ปค์Šคํ…€ ์„ค๋ฌธ ๋ฌด์ œํ•œ ํ˜‘์˜
Research IRB ์Šน์ธ + ๊ณ ๊ธ‰ ๋ถ„์„ ํ”„๋กœ์ ํŠธ๋ณ„