🩺 Clinician Manual · Patient Hub

📚 목차Contents

시스템 아키텍처 한눈에System Architecture at a Glance
환자 허브 사용법Using the Patient Hub
5가지 핵심 임상 워크플로우5 Core Clinical Workflows
모듈별 사용 가이드Module-by-Module Guide
환자 이메일 전송Sending Results to Patients
임상 윤리와 경계Clinical Ethics & Scope
문제 해결Troubleshooting
FAQ

🏗️ 시스템 아키텍처 한눈에System Architecture at a Glance

Boston Neuromind는 환자 한 명이 여러 평가 도구를 거쳐도 모든 결과가 한 곳에 통합되도록 설계됐어요. 핵심 개념은 단 하나: 중앙 환자 DB. Boston Neuromind is designed so that a single patient's data from multiple assessment tools is unified in one place. The core concept is simple: a central patient database.

🎯 핵심 원칙Core Principle 환자는 한 번만 등록 → 모든 모듈이 같은 환자 ID를 참조 → 세라피스트는 하나의 대시보드에서 모든 모달리티를 본다. Register a patient once → all modules reference the same patient ID → clinician sees all modalities in one dashboard.

📊 모듈 현황Module Status

🌸

Face Reading

얼굴 분석 + Big5 + DSM-5-TR 상관Face analysis + Big5 + DSM-5-TR correlation

✅ LIVE

환자 URL: https://neurocatchers.com/symptom_catcher/face-reading/face-reading-v3.5.htmlPatient URL: https://neurocatchers.com/symptom_catcher/face-reading/face-reading-v3.5.html
DB 테이블: face_sessionsDB table: face_sessions
결과 이메일 전송 지원Email delivery supported

🎯

ADHD Catcher

DSM-5-TR 기반 ADHD 평가DSM-5-TR based ADHD assessment

🔌 DB 연결됨

DB 테이블: adhd_sessions (스키마 준비 완료)DB table: adhd_sessions (schema ready)
프론트엔드 Supabase 연결 작업 대기 중Frontend Supabase wiring pending
Hub에서 데모 세션 추가 가능 (테스트용)Demo sessions can be added from Hub (testing)

📋

Symptom Catcher

다차원 증상 평가 (PHQ-9, GAD-7 등)Multi-dimensional symptoms (PHQ-9, GAD-7, etc.)

🔌 DB 연결됨

DB 테이블: symptom_sessions (스키마 준비 완료)DB table: symptom_sessions (schema ready)
척도별 점수 + 의심 도메인 저장 구조Scale scores + suspected domain structure

🧠

QEEG

19채널 정량 뇌파 (Mitsar/HBI)19-ch quantitative EEG (Mitsar/HBI)

🔮 FUTURE

DB 테이블: qeeg_sessions (스키마 준비 완료)DB table: qeeg_sessions (schema ready)
Mitsar/HBI 자동 업로드 파이프라인 미구현Mitsar/HBI auto-upload pipeline not yet built

📝

임상 노트Clinical Notes

Intake, progress, assessment, plan 노트Intake, progress, assessment, plan notes

✅ LIVE

DB 테이블: clinical_notesDB table: clinical_notes
특정 세션에 연결 가능 (예: "이 Face 세션 후 계획 노트")Linkable to specific sessions (e.g., "plan note after this Face session")

🏥 환자 허브 사용법Using the Patient Hub

환자 허브(Patient Hub)는 모든 임상 활동이 시작되고 끝나는 중심 대시보드입니다. The Patient Hub is the central dashboard where all clinical activity begins and ends.

📍 접속 URLAccess URL

https://neurocatchers.com/symptom_catcher/face-clinic/patient-hub-v1.html

비밀번호Password: bnm2026 (Phase B 임시, 추후 정식 SSO 예정)(Phase B temporary; SSO planned)

🎨 화면 구성Layout

영역Area	내용Contents
왼쪽 사이드바Left Sidebar	환자 목록 + 검색 + 추가 · 각 환자에 모듈별 활동 배지 (🌸3 🎯1 등)Patient list + search + add · activity pills per module (🌸3 🎯1 etc.)
환자 헤더Patient Header	이름, ID, 이메일, 전화, 생년월일, 주호소, 선호 언어Name, ID, email, phone, DOB, chief complaint, preferred language
모듈 탭Module Tabs	📊 Overview · 🌸 Face · 🎯 ADHD · 📋 Symptom · 🧠 QEEG · 📝 Notes
개요 탭Overview Tab	모든 모달리티 카운트 카드 + 최근 15개 활동 타임라인All-modality count cards + recent 15 activity timeline

➕ 환자 등록 (첫 단계)Registering a Patient (First Step)

왼쪽 위 "+ 추가" 버튼 클릭Click "+ Add" (top-left)
필수 아닌 선택사항: 이름, 이메일, 전화, 생년월일, 선호 언어, 주호소All optional: Name, email, phone, DOB, preferred language, chief complaint
ID는 자동 생성 (BNM-042 형태)ID auto-generated (BNM-042 format)
"등록" 클릭 → 환자 목록에 즉시 추가됨Click "Register" → appears in list immediately

💡 팁Tip 이메일은 나중에도 수정 가능하지만, 처음에 입력해두면 결과 이메일 전송이 버튼 한 번으로 끝나요. 첫 인테이크 때 수집 권장. Email can be edited later, but if added upfront, emailing results is just one click. Recommended to collect at intake.

🎯 5가지 핵심 임상 워크플로우5 Core Clinical Workflows

1️⃣ 초진 인테이크 (First Intake)First Intake Session

환자 등록Register Patient

Hub에서 이름, 이메일, 생년월일, 주호소 입력Name, email, DOB, chief complaint in Hub

Face ReadingFace Reading

환자 사진 업로드 → 분석 → 자동 저장Upload photo → analyze → auto-saved

Symptom 평가Symptom Assessment

PHQ-9, GAD-7 등 해당되는 척도 실시PHQ-9, GAD-7 etc. as indicated

Intake 노트Intake Note

Hub 노트 탭 → 종합 인상 기록Hub Notes tab → overall impression

2️⃣ ADHD 초기 평가ADHD Initial Assessment

환자 허브에서 환자 선택 → 🎯 ADHD 탭 이동Select patient in Hub → 🎯 ADHD tab
ADHD Catcher에서 DSM-5-TR 14문항 시행 (자가보고 또는 임상가 동반)Run DSM-5-TR 14-item in ADHD Catcher (self-report or therapist-administered)
결과 저장 → Hub에서 subtype, criteria count 확인Save → review subtype, criteria count in Hub
Face Reading 결과와 cross-reference (ADHD 위험도, 주의 관련 신호)Cross-reference with Face Reading (ADHD risk, attention signals)
필요 시 QEEG 녹화 예약Schedule QEEG recording if indicated

3️⃣ 진행 경과 추적 (Progress Tracking)Progress Tracking

치료 시작 후 주기적으로 (보통 4-6주마다) Face Reading 반복 → Hub 개요 탭의 타임라인에서 시계열 변화 확인. 예: Repeat Face Reading periodically (typically every 4-6 weeks) after treatment begins → check time-series change in Hub Overview timeline. E.g.:

N (신경증성)이 78% → 65% → 58% → 치료 반응 신호N (Neuroticism) 78% → 65% → 58% → treatment response signal
주요 감정이 sad → neutral → happy로 이동Dominant emotion shifts sad → neutral → happy
Top 증상 위험도 하락 (예: depression 72% → 45%)Top symptom risks declining (e.g., depression 72% → 45%)

4️⃣ 위기 신호 감지 (Crisis Flags)Crisis Flag Detection

⚠️ 이것은 자동 경보 시스템이 아닙니다This is NOT an automatic alert system 얼굴 분석에서 depression 85%+ 또는 급격한 부정적 변화가 나타나도 시스템이 자동으로 경보하지 않아요. 세라피스트가 Hub를 정기적으로 확인하며 판단해야 합니다. 자살 위험 평가는 별도의 표준 도구(C-SSRS 등)로 실시. Even if face analysis shows depression 85%+ or sharp negative changes, the system does NOT auto-alert. Clinician must review Hub periodically. Conduct suicide risk assessment with separate standard tools (C-SSRS, etc.).

5️⃣ 결과 공유 (환자 이메일)Sharing Results (Patient Email)

환자 허브 → 환자 선택 → 🌸 Face Reading 탭Hub → select patient → 🌸 Face Reading tab
원하는 세션의 📧 버튼 클릭Click 📧 button on desired session
환자 이메일 자동 사용 (없으면 즉석 입력 가능)Patient email used automatically (inline entry if none)
환자 선호 언어(ko/en)로 HTML 이메일 자동 전송HTML email auto-sent in patient's preferred language (ko/en)
전송 로그는 email_logs 테이블에 자동 기록Send log auto-recorded in email_logs

🔧 모듈별 사용 가이드Module-by-Module Guide

🌸 Face Reading (v3.5)

환자 선택: 이름 입력 → 드롭다운 자동 완성 → 클릭Patient selection: type name → autocomplete dropdown → click
사진: 정면, 밝은 조명, 단독 얼굴, 20MB 이하Photo: front-facing, good lighting, single face, under 20MB
탭 구조: Overview / FACS / Big5 / Symptoms (+DSM) / Emotion·Wuxing / Growth / Clinical SummaryTabs: Overview / FACS / Big5 / Symptoms (+DSM) / Emotion·Wuxing / Growth / Clinical Summary
DSM-5-TR 박스: 각 증상 카드 펼치면 코드, criteria, 근거 수준, 후속 도구DSM-5-TR box: expand each symptom card for code, criteria, evidence level, follow-up tools
임상 요약 탭: 모든 주목 증상을 DSM 코드와 함께 테이블로Clinical Summary tab: all flagged symptoms with DSM codes in table

🎯 ADHD Catcher (연결 대기 중)

기존 ADHD Catcher가 Supabase의 adhd_sessions 테이블에 저장하도록 연결되면, Hub에서 자동으로 표시돼요. 연결 전에는 Hub에서 "데모 세션 추가" 버튼으로 테스트용 데이터 생성 가능. Once existing ADHD Catcher is wired to save to Supabase's adhd_sessions table, sessions auto-appear in Hub. Meanwhile, "Add demo session" in Hub creates test data.

📋 Symptom Catcher (연결 대기 중)

각 척도 (PHQ-9, GAD-7, ASRS, ISI 등) 점수를 scale_scores에 JSON으로 저장. 의심 도메인은 suspected_domains 배열에 저장. Each scale score (PHQ-9, GAD-7, ASRS, ISI, etc.) stored as JSON in scale_scores. Suspected domains stored as array in suspected_domains.

🧠 QEEG (미래)

Mitsar + Neuroguide 또는 HBI 녹화 후 수동 업로드 예정. 자동 파이프라인은 Phase D. Manual upload after Mitsar + Neuroguide or HBI recording (planned). Auto-pipeline in Phase D.

📝 임상 노트Clinical Notes

종류: intake / progress / assessment / plan / dischargeTypes: intake / progress / assessment / plan / discharge
세션 연결: 특정 Face/ADHD/Symptom/QEEG 세션 참조 가능Session linking: can reference specific Face/ADHD/Symptom/QEEG session
편집 추적: updated_at 자동 기록Edit tracking: updated_at auto-recorded

📧 환자 이메일 전송Sending Emails to Patients

한 번의 클릭으로 전문 결과 이메일Professional Result Email in One Click

기존에 mailto 링크를 여는 방식과 완전히 다릅니다. Resend API + Supabase Edge Function을 통해 실제 서버에서 HTML 이메일을 자동 발송해요. This is fundamentally different from opening mailto links. Real HTML email sent automatically via Resend API + Supabase Edge Function.

✉️ 전송 절차Send Procedure

Hub → 환자 선택 → 🌸 Face Reading 탭Hub → select patient → 🌸 Face Reading tab
세션의 📧 버튼 클릭Click 📧 on session row
환자 이메일 자동 채우기 (없으면 prompt 표시)Patient email auto-filled (prompt if missing)
확인 → 서버에서 즉시 전송Confirm → sent from server immediately
✅ 배지가 뜨면 완료✅ badge = complete

📨 이메일 내용 (자동 생성)Email Contents (auto-generated)

환자 이름 + 세션 날짜Patient name + session date
상위 3개 증상 경향 (color-coded)Top 3 symptom tendencies (color-coded)
Big 5 성격 막대 그래프 (시각적)Big 5 personality bars (visual)
주요 감정 + 오행 유형Dominant emotion + Wuxing type
"다음 한 걸음" 문구"Next Step" message
필수 디스클레이머 (988 Crisis Line 포함)Required disclaimer (includes 988 Crisis Line)

🌐 자동 언어 선택Auto Language 환자 프로필의 preferred_lang에 따라 ko/en 이메일 자동 전환. 등록 시 선택한 언어 그대로. Email ko/en auto-selected per patient's preferred_lang. Same as chosen at registration.

⚠️ 전송 전 확인Before Sending 이메일은 되돌릴 수 없어요. 환자가 혼자 결과를 봤을 때 압도될 수 있는 내용(예: depression 85%)인지 먼저 세라피스트가 판단. 필요하면 대면 상담 후 전송. Email is irreversible. Clinician must first judge whether the patient viewing alone could be overwhelming (e.g., depression 85%). Send after in-person session if needed.

📊 전송 기록 확인Check Sent Log

Supabase Dashboard → Table Editor → email_logs. 상태 필드: Supabase Dashboard → Table Editor → email_logs. Status field:

pending: 전송 시도 중attempting
sent: Resend가 수락함 ✅accepted by Resend ✅
failed: 전송 실패 (error_message 확인)send failed (check error_message)
bounced: 수신함 없음 (이메일 주소 확인)no inbox (check email address)

⚖️ 임상 윤리와 경계Clinical Ethics & Scope

🚨 절대 원칙Absolute Principles

얼굴 기반 신호는 탐색적 단서, 진단 아님Face-based signals are exploratory cues, not diagnoses
BCN + PhD 자격 범위 내 임상적 판단 유지 (non-physician)Maintain clinical judgment within BCN + PhD scope (non-physician)
"진단" 용어 대신 "함께 탐색할 주제" 프레이밍 사용Use "topics to explore together" framing instead of "diagnosis" language
약물 처방·의학적 진단은 반드시 의뢰 (referral)Always refer out for medication / medical diagnosis

🎯 포지셔닝: 교육 + 수행 향상Positioning: Education + Performance

Boston Neuromind는 "학습력 보완 + 주의집중 강화"에 초점. 트라우마·정신과 치료가 아닌 performance optimization으로 포지셔닝. "훈련" / "코칭" / "수행 최적화" 언어 사용. Boston Neuromind focuses on learning support + attention enhancement. Positioned as performance optimization, not trauma/psychiatric treatment. Use "training" / "coaching" / "performance" language.

⚠️ 특별 주의 증상High-Caution Symptoms

얼굴 기반 프레이밍 사용 시 각별한 주의가 필요한 증상들: Conditions requiring extra care with face-based framing:

반사회성(Antisocial): 역사적 pseudoscience 배경, 낙인 위험. 절대 라벨링 금지.Antisocial: pseudoscience history, high stigma. Never use for labeling.
조현병(Schizophrenia): 얼굴 특징 연구 근거 강하나, 예측 목적 사용 금지.Schizophrenia: strong facial feature research, but not for predictive use.
경계성(Borderline): 높은 낙인. 단일 만남 진단 불가.Borderline: high stigma. Not diagnosable from single encounter.
섭식장애(Eating): 환자와 체중·BMI 구체 수치 논의 절대 금지.Eating disorders: never discuss specific weights/BMI with patients.

🏥 의뢰가 필요한 경우When to Refer Out

자살 사고/계획 명시Explicit suicide ideation/plan
정신증적 증상 (망상, 환각)Psychotic symptoms (delusions, hallucinations)
약물 처방이 임상적으로 필요Clinical need for medication
의학적 검사 필요 (갑상선, 수면무호흡 등)Medical workup needed (thyroid, sleep apnea, etc.)
급성 위기 (폭력, 아동 학대)Acute crisis (violence, child abuse)

📞 위기 자원 (미국)Crisis Resources (US)

988 — Suicide & Crisis Lifeline (24시간24/7)
911 — 긴급 (생명 위협)Emergency (life-threatening)
1-800-662-HELP — SAMHSA National Helpline

🛠️ 문제 해결Troubleshooting

🐛 일반적 이슈Common Issues

환자 목록이 비어 보여요Patient list appears empty

브라우저 콘솔(F12) 확인. "view not available" 경고가 있으면 Phase C 스키마 SQL이 실행 안 된 상태. Supabase → SQL Editor → schema_phase_c_central_db.sql 실행. Check browser console (F12). If "view not available" warning, Phase C schema SQL hasn't been run. Go to Supabase → SQL Editor → run schema_phase_c_central_db.sql.

이메일 전송이 실패해요 (❌)Email send fails (❌)

가능한 원인: (1) Edge Function 배포 안 됨 → supabase functions deploy send-face-reading-email (2) RESEND_API_KEY 미설정 → supabase secrets set RESEND_API_KEY=... (3) 환자 이메일 주소 잘못됨. email_logs 테이블의 error_message 확인. Possible causes: (1) Edge Function not deployed → supabase functions deploy send-face-reading-email (2) RESEND_API_KEY not set → supabase secrets set RESEND_API_KEY=... (3) Invalid email. Check error_message in email_logs.

환자가 분석했는데 Hub에 안 보여요Patient analyzed but not visible in Hub

Supabase face_sessions 테이블 직접 확인. 행이 있으면 Hub 새로고침 (Ctrl+Shift+R). 없으면 환자가 올바른 이름으로 선택했는지 확인. Check face_sessions table directly in Supabase. If rows exist, hard reload Hub (Ctrl+Shift+R). If not, verify patient selected correct name.

ADHD/Symptom 탭이 비어있어요ADHD/Symptom tabs are empty

해당 Catcher가 Supabase 저장 연결되기 전엔 정상. 지금은 Hub의 "데모 세션 추가" 버튼으로 테스트 데이터 생성 가능. 실제 연결 작업은 다음 Phase. Normal before those Catchers are wired to Supabase. For now, use Hub's "Add demo session" to create test data. Wiring pending next Phase.

Hub 접속 비밀번호 변경 필요Need to change Hub password

현재 하드코딩된 bnm2026. Phase C.2에서 Supabase Auth 기반 정식 로그인 시스템으로 교체 예정. 긴급 변경 필요 시 HTML 파일의 CLINIC_PASSWORD 상수 수정 후 재배포. Currently hardcoded bnm2026. Will be replaced with Supabase Auth login system in Phase C.2. For urgent change, edit CLINIC_PASSWORD constant in HTML and redeploy.

❓ FAQ

환자 데이터는 어디에 저장되나요?Where is patient data stored?

Supabase (PostgreSQL) 클라우드 DB. 프로젝트 ID: zatjbyeabxkfhmvopbtb. 현재 Free tier로 500MB까지 가능. Phase C에서 HIPAA BAA 필요 시 Pro tier ($25/월) 업그레이드 고려. Supabase (PostgreSQL) cloud DB. Project ID: zatjbyeabxkfhmvopbtb. Currently Free tier (500MB). Consider Pro tier ($25/mo) upgrade for HIPAA BAA in Phase C.

환자 데이터를 삭제하면 복구되나요?Can deleted patient data be recovered?

현재 시스템은 soft delete 아니고 hard delete (복구 불가). Supabase의 자동 백업은 Pro tier 이상. 삭제 전 반드시 확인 다이얼로그. Current system does hard delete, not soft (unrecoverable). Automatic backups only on Pro tier or higher. Confirmation dialog before delete.

HIPAA 준수 상태는?HIPAA compliance status?

현재 Phase B 상태는 HIPAA BAA 체결 전. Supabase Free tier와 Resend Free tier 모두 BAA 제공 안 함. Boston Neuromind가 실제 PHI(개인 의료정보) 저장 시작하기 전에 Phase C 진입 → Supabase Pro + Resend Pro로 업그레이드 필요. Phase B is before HIPAA BAA. Supabase Free and Resend Free don't offer BAA. Before storing actual PHI, enter Phase C → upgrade to Supabase Pro + Resend Pro.

여러 세라피스트가 동시에 쓸 수 있나요?Can multiple clinicians use it simultaneously?

기술적으로 가능하지만 현재는 단일 비밀번호(bnm2026) 방식이라 누가 뭘 했는지 추적 불가. Phase C에서 세라피스트별 로그인 + 감사 로그 추가 예정. Technically possible, but current single password (bnm2026) doesn't track who did what. Per-clinician login + audit log planned for Phase C.

환자가 자기 결과를 직접 볼 수 있나요?Can patients view their own results directly?

현재는 이메일로 요약본만 받을 수 있음 (이것도 세라피스트가 버튼을 눌러야 전송). 환자 전용 로그인 포털은 Phase D 고려 중. 주의: 환자가 우울 위험 등을 혼자 보면 심리적 부담될 수 있어 세라피스트 게이트키핑 권장. Currently only receive summary via email (and clinician must click send). Patient-only login portal under consideration for Phase D. Note: patient viewing risk scores alone can be psychologically burdensome — clinician gatekeeping recommended.

💜 마치며Closing

이 시스템은 자기가 만든 모든 조각들 — Face Reading, ADHD Catcher, Symptom Catcher, QEEG 비전 — 을 한 환자를 중심으로 연결하는 지속 구축 중인 플랫폼이에요. Phase별로 계속 성장해요. This system is a continuously evolving platform connecting all your pieces — Face Reading, ADHD Catcher, Symptom Catcher, QEEG vision — around each individual patient. It grows phase by phase.

🌸 Boston Neuromind · Canton, MA · 학습력 보완 · 주의집중 향상Learning Support · Attention Enhancement

Boston Neuromind 통합 임상 시스템

Boston Neuromind Integrated Clinical System

📚 목차Contents

🏗️ 시스템 아키텍처 한눈에System Architecture at a Glance

📊 모듈 현황Module Status

🏥 환자 허브 사용법Using the Patient Hub

📍 접속 URLAccess URL

🎨 화면 구성Layout

➕ 환자 등록 (첫 단계)Registering a Patient (First Step)

🎯 5가지 핵심 임상 워크플로우5 Core Clinical Workflows

1️⃣ 초진 인테이크 (First Intake)First Intake Session

2️⃣ ADHD 초기 평가ADHD Initial Assessment

3️⃣ 진행 경과 추적 (Progress Tracking)Progress Tracking

4️⃣ 위기 신호 감지 (Crisis Flags)Crisis Flag Detection

5️⃣ 결과 공유 (환자 이메일)Sharing Results (Patient Email)

🔧 모듈별 사용 가이드Module-by-Module Guide

🌸 Face Reading (v3.5)

🎯 ADHD Catcher (연결 대기 중)

📋 Symptom Catcher (연결 대기 중)

🧠 QEEG (미래)

📝 임상 노트Clinical Notes

📧 환자 이메일 전송Sending Emails to Patients

한 번의 클릭으로 전문 결과 이메일Professional Result Email in One Click

✉️ 전송 절차Send Procedure

📨 이메일 내용 (자동 생성)Email Contents (auto-generated)

📊 전송 기록 확인Check Sent Log

⚖️ 임상 윤리와 경계Clinical Ethics & Scope

🎯 포지셔닝: 교육 + 수행 향상Positioning: Education + Performance

⚠️ 특별 주의 증상High-Caution Symptoms

🏥 의뢰가 필요한 경우When to Refer Out

🛠️ 문제 해결Troubleshooting

🐛 일반적 이슈Common Issues

❓ FAQ

💜 마치며Closing