사용자 매뉴얼
20-19 Orthodontics AI 플랫폼의 모든 기능을 단계별로 설명합니다.
1. 시작하기 — 환자 등록
플랫폼의 모든 진단은 현재 활성 환자에 종속됩니다. 좌측 사이드바 또는 상단 우측의 "환자 변경" 버튼으로 환자를 입력하세요.
입력 항목
- 이름 — 식별용. 익명화 시 ID로 대체 가능.
- 생년월일 — 자동으로 만 나이를 계산합니다.
- 연령 구분 — 자동(만 17세 이하 어린이) 또는 수동 지정.
- 성별 — 성장 예측 시 mid-parental 계산에 사용.
localStorage에 저장되며, 별도의 서버 동기화는 SaaS 플랜에서 활성화됩니다.2. 3D 뷰어 사용법
Three.js 기반 STL 뷰어. 드래그앤드롭 또는 클릭으로 STL을 업로드하면 자동으로 EZL-STL 엔진이 측정값을 산출합니다.
지원 측정값
- 치열궁 길이 (Arch Length, mm) — 좌측 부조화 분석에 사용
- 치아 너비 합 (Sum of MD widths, mm)
- 부조화 (Discrepancy = Arch − Tooth)
- Bolton 비율 (전치 77.2%±2, 전체 91.3%±2)
- Spee 만곡 (Curve of Spee, mm)
- Crowding 분류 (Mild/Moderate/Severe)
조작법
- 마우스 드래그 — 회전
- 휠 — 줌
- Shift + 드래그 — 패닝
- 상단 툴바 — 정면/상단/측면/3D 프리셋, 와이어프레임 토글, PNG 스크린샷
3. 발치 판단 AI
Tweed/Steiner/Down 분석을 통합한 룰베이스 사전 점수 + Gemini 정밀 분석.
핵심 입력값
- ANB — 골격 관계 (정상 2°±2)
- Crowding — 4mm 미만 비발치 우선, 8mm 이상 발치 강력 권장
- FMA / IMPA — Tweed 분석 핵심
- Profile / Lip strain — 안모 영향 평가
성인/어린이 분기
어린이 환자는 자동으로 -25점 가중치가 적용되어 비발치/2단계 치료가 우선 권장됩니다. 골성숙이 진행 중일 때는 발치보다 성장 활용이 효과적입니다.
4. 성장 예측 AI
CVMS 단계 + 부모 키 + 골연령으로 잔여 성장량과 peak velocity 시점을 추정합니다. 어린이 전용.
CVMS 단계 가이드
- CS1 — 사춘기 가속 전 (8-9세)
- CS2 — 가속 시작 (9-10세)
- CS3 — Peak velocity ★ 골격 치료 골든타임
- CS4 — Peak 직후 (12-13세)
- CS5 — 감속 (14-15세)
- CS6 — 성장 완료 (16세 이상)
차트의 주황 점선이 peak velocity 시점이며, 이 구간에 기능 장치(Twin Block, Headgear 등)를 적용하는 것이 가장 효과적입니다.
5. 안모 시뮬레이션
측면 안모 SVG에 5개 슬라이더(상악 후방, 하악 전후방, 상순/하순, 턱)를 조정하면 실시간으로 프로파일이 변형됩니다.
핵심 지표
- E-line (Ricketts) — 코끝(NoseTip)과 턱끝(Pog)을 잇는 미적 기준선. 상순은 -4mm, 하순은 -2mm 후방이 이상적.
- 코-턱 비율 — 코 길이 / 하안면부 높이. 0.45-0.55 범위가 균형.
"📷 스냅샷" 버튼으로 변형된 프로파일을 PNG로 저장하여 환자 상담에 활용할 수 있습니다.
6. 재발 예측 AI
치료 종료 시점의 IMPA, 보정 장치, 환자 협조도 등을 입력하면 1·3·5·10년 시점의 재발 확률을 산출합니다.
위험도별 권장 프로토콜
- 저위험 (<30%) — Essix 24개월 야간 착용 후 점진적 중단.
- 중위험 (30-50%) — Essix + 1년 정기 검진.
- 고위험 (>50%) — Bonded 3-3 + 야간 Essix + 6개월 검진.
7. RAG 챗봇 활용 팁
Gemini 1.5/2.0 + Supabase pgvector 기반 검색증강생성. 답변에는 참조한 출처가 우측 패널에 함께 표시됩니다.
좋은 질문 예시
- "성인 환자 Crowding 5mm, 발치 vs 비발치 판단 기준은?"
- "Bolton 비율 91.3%가 의미하는 바와 임상적 활용을 설명해줘"
- "CVMS 3단계 어린이의 권장 치료 시기는?"
파일 첨부
구강 사진(JPG/PNG)을 첨부하면 Gemini Vision이 5가지 임상적 특징을 추출합니다. STL 첨부 시 메타데이터(삼각형 수, 크기)가 자동 추출됩니다.
8. FAQ
GEMINI_API_KEY 하나로 모든 모델 호출이 가능합니다.