경동맥초음파 결과지 사용 메뉴얼

1

개요와 핵심 가치

왜 이 도구를 쓰면 좋은가

학회 표준 양식의 종이 수기 작성을 디지털로 옮기고, 입력 → 표준 텍스트 자동 생성 → 차트 붙여넣기 흐름을 한 번에 처리합니다. 외부 의뢰·회신 레포트로도 활용 가능하도록 PDF·다국어 번역·이미지 첨부까지 지원합니다.

⚡

이중 작업 제거

종이에 그리고 차트에 다시 쓰는 이중 입력 폐지. 한 번 입력하면 표준 텍스트가 자동 생성되어 클립보드 복사 한 번에 차트 붙여넣기.

🧬

SVG 양방향 입력

모식도 부위를 클릭해서 입력하거나, 하단 표 셀에 직접 입력. 두 입력은 실시간 양방향 동기화.

🤖

AI 임상 정리

Gemini 2.5 Flash 로 수치·소견을 의학적 권고문으로 정리. 환자 안내문에 바로 활용.

🌐

외국 환자 응대

15+ 언어 자동 번역 + 새 창 인쇄. 외국인 환자에게 즉시 결과 안내.

2

빠른 시작 — 3분 흐름

최소 입력으로 결과지 한 장 만들기

👤환자 정보

→

🧬세그먼트 측정

→

📋표준 소견 자동 생성

→

📋복사·붙여넣기

환자 정보 카드에서 등록번호·성명·성별·생년월일·검사일 입력 (필수 항목).
경동맥 모식도에서 측정 부위를 클릭하면 우측에 입력 카드가 열림. IMT·PSV·EDV 값 입력.
플라크가 있으면 Plaque 있음 체크하고 표면·특성 선택.
모든 세그먼트 입력 후 📋 표준 소견 자동 생성 클릭.
상단 툴바 📋 복사 클릭 → 차트에 붙여넣기.

💡

팁: 모든 세그먼트를 채울 필요는 없습니다. 측정한 부위만 입력해도 표준 소견이 자동으로 정리됩니다. 미입력 항목은 정상으로 가정하거나 텍스트에서 자연스럽게 제외됩니다.

3

단계별 가이드

처음 사용 시 위에서 아래로 순서대로 진행

1

👤 환자 정보 입력 필수

차트 헤더로 들어가는 식별 정보입니다. 등록번호·성명·성별·생년월일·검사일 5개는 반드시 입력. 미입력 시 표준 소견 생성·인쇄·PDF·번역 단계에서 안내 메시지가 뜨고 부족 필드가 빨간 테두리로 강조됩니다.

생년월일은 YY-MM-DD 형식 (예: 64-03-15) — 자동 포맷 입력기.
병력·이전 검사일은 선택 입력, AI 정리·표준 소견 정확도를 높여 줍니다.

2

🩸 상지 혈압 측정 선택

양측 수축기·이완기 입력. 좌우 수축기 차이 ≥10 mmHg 시 쇄골하동맥 협착 의심 안내가 자동 표시됩니다.

3

🧬 경동맥 세그먼트 측정 핵심

모식도 클릭 방식: 좌측 SVG 모식도에서 측정 부위 클릭 → 우측에 입력 카드 열림 → IMT·PSV·EDV 입력. CCA 세그먼트에서만 IMT 입력칸이 노출됩니다 (학회 표준).

플라크 마킹: Plaque 있음 체크 시 표면(규칙·불규칙·궤양) + 특성(저반향·고반향·복합) 선택. 모식도에 자동 색상 표시.

표 직접 입력: 모식도 아래 전체 세그먼트 표에서 셀을 클릭해 직접 입력 가능. 모식도 ↔ 표 양방향 실시간 동기화.

전체 초기화: 표 우측 상단 ↺ 전체 세그먼트 초기화 또는 활성 카드의 ↺ 이 세그먼트 비우기 사용.

4

📐 협착도·속도비·추가 혈관 일부 자동

내경동맥 협착(%): 좌우 각각 0~100 입력. 50% 이상이면 모식도 ICA 가 빨간 표시로 자동 강조.

ICA/CCA 속도비: ICA-D PSV ÷ CCA-D PSV — 위에서 PSV 입력하면 자동 계산되어 readonly로 표시.

쇄골하·척추동맥: PSV cm/s 와 척추동맥 혈류 방향(전방·역전) 추가 측정 시 입력.

5

🖼 주요 소견 이미지 첨부 선택

좌·우 각 측 별도 갤러리. + 파일 추가 또는 📋 붙여넣기 (장비에서 Ctrl+C 로 복사한 이미지) 두 진입 방법.

이미지는 인쇄·PDF·번역 레포트에는 포함되지만 클립보드 텍스트 복사에는 포함되지 않습니다 (전자차트 텍스트 호환).

6

📋 표준 소견 자동 생성 핵심

측정 입력 완료 후 📋 표준 소견 자동 생성 클릭. IMT·플라크·협착·속도비·추가 혈관까지 학회 양식에 맞는 한국어 텍스트로 자동 정리. 텍스트 박스 안에서 추가 편집 가능.

전자차트(예: 이지스, 의사랑 등)에 그대로 붙여넣을 수 있는 형식으로 출력됩니다.

7

✨ AI 결과 정리 선택 · Gemini 키 필요

✨ AI 결과 정리 (Gemini) 클릭 → Gemini 2.5 Flash 가 수치·플라크·협착도를 종합해 임상 해석·권고문으로 정리.

180초 타임아웃 (긴 텍스트도 안정적). 결과는 표준 소견 박스에 추가됩니다.

키 등록 미완 시 🔑 Gemini 키 버튼으로 발급 키 저장. 키는 브라우저에만 보관 (외부 공유 X).

8

💾 저장·복사·인쇄·번역

상단 툴바에서 작업 마무리:

📋 복사 — 검사 소견 텍스트를 클립보드로 → 차트 붙여넣기
💾 저장 — 환자별 JSON 파일로 폴더 저장 (재방문 시 불러오기 가능)
🖨️ 인쇄 — 브라우저 인쇄 대화상자, 의원 로고·서명 포함
📄 PDF — PDF 저장 모드 (인쇄와 동일 레이아웃)
🌐 번역 — 15+ 언어로 번역 + 새 창 인쇄 (외국인 환자용)

4

핵심 기능 하이라이트

한 번에 살펴보는 11가지 표준 기능

🧬

SVG 12 세그먼트 클릭

좌·우 × CCA(P/M/D) + ECA + ICA(P/D) 총 12 부위를 모식도에서 클릭만으로 측정값 입력.

🔁

양방향 동기화

모식도 입력 ↔ 표 직접 입력 실시간 동기. 어디서 입력하든 같은 데이터.

🩸

플라크 마킹

표면(규칙·불규칙·궤양) + 특성(저반향·고반향·복합) 학회 표준 6분류. 모식도에 색상 표시.

📐

속도비 자동 계산

ICA-D PSV ÷ CCA-D PSV 입력 즉시 자동 계산, readonly 노출. 협착도 ≥50% 시 모식도 빨강 강조.

📋

표준 소견 자동 생성

학회 양식 기반 한국어 표준 텍스트 생성. 이지스·의사랑 전자차트 붙여넣기 호환.

✨

AI 임상 정리

Gemini 2.5 Flash — 수치·플라크·협착을 해석·권고문으로 변환. 환자 안내 활용.

🖼

좌·우 이미지 갤러리

파일 추가 + 클립보드 붙여넣기. 라이트박스로 확대. 인쇄·PDF·번역에만 포함.

🌐

15+ 언어 번역

영·일·중·러·베트남어 등 다국어 PDF + 새 창 자동 인쇄. Noto Sans 다국어 폰트.

💾

JSON 폴더 저장

File System Access API + IndexedDB. 환자별 결과지를 폴더에 저장, 재방문 시 불러오기.

🛡

필수 입력 안전장치

등록번호·성명·성별·나이·생년월일·검사일 7항목 미입력 시 명확 안내 + 부족 필드 빨간 강조.

🎨

8테마·4폰트

다크 4종 + 라이트 4종 자유 전환. 폰트 4단계 (16~22px). 의료 시맨틱 컬러 보존.

5

12 세그먼트 구조 이해

왜 이렇게 나누는가, 어떻게 측정하는가

부위 약어 풀이

CCA: 총경동맥 (Common Carotid Artery) — 가장 굵은 줄기
ECA: 외경동맥 (External Carotid Artery) — 얼굴·두피 분지
ICA: 내경동맥 (Internal Carotid Artery) — 뇌 분지
P · M · D: 근위부 (Proximal) · 중간부 (Mid) · 원위부 (Distal)
IMT: 내막-중막 두께 (Intima-Media Thickness) — CCA 만 측정
PSV · EDV: 최대수축기 속도 · 최대이완기 속도

활성 선택 데이터 있음 Plaque 협착 ≥50%

📐

IMT 입력란이 보이지 않는다? ECA·ICA 세그먼트에서는 IMT 칸이 숨겨집니다. CCA(P/M/D) 세그먼트를 클릭해 보세요 — 학회 표준에 따라 IMT 는 CCA 만 측정합니다.

6

AI 결과 정리 (Gemini)

키 등록부터 임상 정리까지

🔑키 등록

→

📋표준 소견 생성

→

✨AI 정리 클릭

→

📋차트 붙여넣기

🔑 Gemini 키 클릭 → 발급 받은 Gemini API 키 입력 → 💾 저장. 키는 브라우저 로컬에만 보관됩니다.
📋 표준 소견 자동 생성으로 기본 텍스트 생성 (AI 입력 컨텍스트).
✨ AI 결과 정리 (Gemini) 클릭. Gemini 2.5 Flash 가 임상 해석·권고문을 추가.
응답 대기 (최대 180초 타임아웃). 결과가 소견 박스에 자동 추가.
필요 시 수동 편집 → 📋 복사로 차트 붙여넣기.

⚠️

AI 결과는 검토 후 사용하세요. Gemini 응답은 참고용입니다. 의학적 판단은 의료진의 직접 판단을 거쳐야 합니다.

7

JSON 폴더 저장 · 불러오기

환자별 결과지를 영구 보관

최초 설정: 📁 저장 폴더 클릭 → 결과지를 보관할 폴더 선택 (예: D:\carotid_us\).
저장: 결과지 작성 후 💾 저장 클릭. 파일명은 등록번호_성명_검사일.json 형식 자동 생성.
불러오기: 같은 환자 재방문 시 📂 불러오기 → 폴더 안 파일 목록에서 선택. 모든 입력값 자동 복원.
폴더 미설정 시 폴백: 📤 JSON 파일 직접 선택으로 개별 파일 업로드 가능.

🔒

로컬 저장: JSON 파일은 의원 PC 폴더에만 저장됩니다. 서버 업로드·외부 공유 없음. 환자 정보가 원장님 통제 안에서만 보관.

8

다국어 번역 + 인쇄

외국인 환자 응대용

🌐 번역 클릭 → 번역 모달 표시.
대상 언어 선택 (영어·일본어·중국어·러시아어·베트남어·태국어·인도네시아어 등 15+ 언어).
🌐 번역 + 새 창 인쇄 클릭. Gemini 가 결과지 전체를 번역.
번역된 결과지가 새 창에 표시되고 인쇄 대화상자 자동 실행.
환자에게 인쇄물 또는 PDF 로 전달.

🌏

Noto Sans 다국어 폰트가 자동 적용되어 한자·키릴·아랍어 등 모든 문자체계가 깨끗하게 표시됩니다.

9

툴바 버튼 한눈에

상단 우측 9 개 버튼의 역할

버튼	역할	입력 데이터 영향
🎨 테마	8 테마 + 4 폰트 토글 팝오버	화면만 (영구 localStorage)
📁 저장 폴더	JSON 저장 폴더 선택 (최초 한 번)	로컬 폴더 권한 부여
📂 불러오기	저장된 결과지 파일 목록 모달	현재 입력 덮어쓰기 (확인 후)
💾 저장	현재 결과지 JSON 으로 저장	폴더에 새 파일 또는 덮어쓰기
📋 복사	검사 소견 텍스트 클립보드로	차트 붙여넣기용 (이미지 미포함)
🌐 번역	다국어 번역 모달 (Gemini)	번역 + 새 창 인쇄
📄 PDF	PDF 저장 모드 인쇄 대화상자	이미지·로고 포함 풀 레이아웃
🖨️ 인쇄	브라우저 인쇄 (메인 동작)	이미지·로고 포함 풀 레이아웃

10

자주 묻는 질문

초기 사용 시 자주 막히는 부분

표준 소견 자동 생성 버튼을 눌렀는데 빈 텍스트가 나옵니다.

측정값을 하나도 입력하지 않은 상태일 가능성이 큽니다. 모식도에서 부위를 선택하고 IMT/PSV/EDV 중 최소 한 값이라도 입력하신 뒤 다시 시도해 주세요. 환자 정보 필수 항목 미입력 시에도 부족 필드가 빨간 테두리로 강조됩니다.

AI 정리 버튼이 응답이 없습니다.

① 우측 상단 🔑 Gemini 키 가 등록되었는지 확인. ② 키가 유효한지(Google AI Studio 에서 발급) 확인. ③ 최대 180초 대기 (긴 텍스트). ④ 키 무효 시 콘솔(F12) 에 오류가 찍힙니다.

저장 폴더를 설정했는데 다음 방문 시 다시 묻습니다.

브라우저 보안 정책상 일부 환경에서 폴더 권한이 세션 단위로 만료됩니다. 📁 저장 폴더 재선택 한 번으로 권한이 복원되며 기존 파일은 그대로 보존됩니다.

이미지를 붙여넣기 했는데 표준 소견 텍스트에는 안 들어갑니다.

의도된 동작입니다. 이미지는 인쇄·PDF·번역 레포트에만 포함되고, 📋 복사로 차트에 붙여넣는 텍스트에는 포함되지 않습니다. 전자차트는 일반적으로 텍스트만 받기 때문입니다.

SVG 모식도에서 ECA 영역이 너무 좁아서 클릭이 어렵습니다.

모식도 아래 전체 세그먼트 표에서 ECA 셀을 직접 클릭하시면 동일하게 입력 카드가 열립니다. 표·모식도 양방향 동기화로 입력 결과는 같습니다.

다크 테마에서 색상이 어떻게 변하나요?

의료 시맨틱 컬러(정상·주의·위험)는 다크 배경에서 가독성을 위해 자동으로 밝은 톤(에메랄드·앰버·살몬)으로 변환됩니다. 의미는 동일하게 유지되며, 화면 환경(테마·폰트)은 의원 전용 페이지로 영구 저장됩니다.

번역된 결과지의 PDF 폰트가 깨집니다.

Noto Sans 다국어 폰트가 자동 임포트되지만 브라우저 캐시 또는 네트워크 일시 차단으로 폰트 로딩 실패 시 발생할 수 있습니다. 페이지 새로고침(Ctrl+F5) 후 재시도해 주세요.

🩺 경동맥초음파 결과지 사용 메뉴얼

이중 작업 제거

SVG 양방향 입력

AI 임상 정리

외국 환자 응대

👤 환자 정보 입력 필수

🩸 상지 혈압 측정 선택

🧬 경동맥 세그먼트 측정 핵심

📐 협착도·속도비·추가 혈관 일부 자동

🖼 주요 소견 이미지 첨부 선택

📋 표준 소견 자동 생성 핵심

✨ AI 결과 정리 선택 · Gemini 키 필요

💾 저장·복사·인쇄·번역

SVG 12 세그먼트 클릭

양방향 동기화

플라크 마킹

속도비 자동 계산

표준 소견 자동 생성

AI 임상 정리

좌·우 이미지 갤러리

15+ 언어 번역

JSON 폴더 저장

필수 입력 안전장치

8테마·4폰트

부위 약어 풀이