🧠 Catcher Treatment Engine — 엔진 매뉴얼 v2

★ 이번 업데이트에서 바뀐 것 읽고 시작

① 설계 철학

핵심 원칙 4가지

② 전체 흐름 (사용자 여정)

③ 3층 AI 구조 (경쟁력의 심장)

④ 판단 알고리즘 신규 핵심

3층 구조

상태공식(state_formula) 구조 — 예: 우울 무쾌감

{
  "id": "anhedonia",
  "name": "무쾌감 (anhedonia)",
  "formula": {
    "base": 100,
    "terms": [
      {"feature":"detection", "op":"add", "multiplier":0.6},
      {"feature":"frontal_alpha_asymmetry", "op":"add", "multiplier":40}
    ]
  },
  "evidence": [                       ← ★ 논문 근거 (이번 신규)
    {"indicator":"detection (보상/긍정 탐지)",
     "direction":"저하 → 무쾌감↑",
     "meta":"Halahakoon 2020 (JAMA Psychiatry 메타); Pizzagalli 2014",
     "effect":"복측선조체 보상반응 둔화 일관 (fMRI 메타)",
     "limit":"행동 탐지과제로 직접 측정한 표준 효과크기는 제한적"}
  ],
  "coefficient_status": "방향·관여는 논문 근거. 정밀 계수는 Genius 검수·실측 조정."
}

공식 문법 (terms의 op)

근거(evidence) 3요소 — 각 지표↔상태 연결마다

8증상 하위유형 (profile_matching)

⑤ 심장1 · 심장2 (슈퍼 관리) 신규

심장1 — 게임 엔진 관리

심장2 — 판단 알고리즘 관리 v2 이번 개편

심장2가 보여주는 패널

⑥ rules 구조 (game_module) 확장

game_module 섹션 (★ = 이번 추가)

5개 범용 게임 엔진

⑦ 코드 모듈 (전부 증상 무관 공통)

⑧ QEEG 세션 추적 신규

담은 것

QEEG 규준 (qeeg_norms) — 판단 축 보정용 신규

QEEG 규준 채우기 가이드 (Normative Database)

1. 개요

엔진은 측정된 QEEG 값을 각 증상의 정상 규준(healthy_mean·sd)과 비교해 z-score를 계산하고, 그 편차로 증상 관련성을 판단합니다. 즉 규준 수치가 정확할수록 판단이 정확합니다. QEEG는 단독 진단이 아니라 설문·임상과 합쳐 쓰는 보조 신호입니다(대역 패턴은 장애 간 중첩이 큼).

2. 현재 상태 (draft 들어가 있음)

qeeg_norms.metrics에는 각 증상 대표 마커·방향·draft 값이 논문 기반으로 이미 배선되어 보고서에 표시됩니다. 아래 값들은 방향은 논문 확정, 정밀 수치는 규준 DB로 정밀화 대상(draft)입니다.

3. 증상별 대표 마커 (논문 확정)

4. 규준 수치(mean·sd) 채우는 법

1. 규준 DB 사용: NeuroGuide(Thatcher), HBImed 등 정규 규준 데이터베이스에서 해당 마커·부위·연령대의 healthy mean·sd를 가져옴.
2. 논문 사용: 각 마커의 mean±SD를 보고한 검증 논문에서 인용 (조작 방지 — 실제 보고값만).
3. EC/EO 구분: 눈감음(EC)·눈뜸(EO)은 규준이 다름 — 마커별 조건 명시.
4. connectivity 마커(PTSD/autism)는 파워가 아닌 coherence/연결성 지표라 별도 규준 필요.

5. 필드 설명

• healthy_mean / healthy_sd: 정상군 규준 (z 계산 기준)
• condition_mean: 해당 증상군 평균 (참고)
• site: 전극 부위 (F3-F4 등)
• direction: 이상 방향 (증가/감소)
• interpret_ko/en: 화면 해석문
• citation: 근거 논문 (실제 출처만)

6. z-score 해석

z = (측정값 − healthy_mean) / healthy_sd. |z|>2는 통계적 이탈이나, QEEG 단독 판정이 아니라 설문·임상과 종합해야 함.

7. 참고 문헌

• Newson JJ, Thiagarajan TC. EEG Frequency Bands in Psychiatric Disorders: A Review of Resting State Studies. Front Hum Neurosci. 2019;12:521.
• 우울 resting-state EEG 체계적 문헌고찰·메타분석 (2025)
• 만성불면 주간 신경생리 과각성 qEEG 연구
• PTSD 피질 네트워크 disrupted resting-state EEG 연구
• 정동장애 QEEG 스펙트럴 파워–증상 상관 연구

원칙: 방향·마커·근거는 논문으로 확정(위 표). 정밀 mean·sd는 규준 DB + 임상 보정으로 채움 — 추측 수치 금지(조작 방지).

⑨ board 세션 추세 그래프 신규

동작

⑩ 진화 루프 (1세대 → 2세대)

블렌딩 공식

w_real = n_real / (n_real + K)   # K=50
blended = 문헌 × (1 - w) + 실측 × w   # 캡 95%

n=0   → 문헌 100%  (1세대)
n=500 → 실측 91%   (2세대)

⑪ 증상 복제 절차 상세 갱신

복사 시 바뀌는 것 = rules만

복사해도 그대로 = 코드 공유

각 증상 대표 QEEG 마커 (자동 추출)

복제 절차 (사이트당)

⑫ 로드맵

완료 (이번 세션 포함)

대기