S.T.A.T — 이해가 필요한 바로 그 순간에
"병원 안내문을 쉬운 말·사진·큰 글씨·음성(5개 언어) 으로 바꾸고, 캐릭터 또박이 선생님의 수업과 티치백(teach-back) 확인 질문으로 환자가 실제로 이해했는지 직접 점검하는 병원용 건강문해력 앱이다."
프로젝트를 시작하기 전에 docs/SETUP.md를 먼저 읽으세요.
1. 프로젝트 개요
한 줄 소개
병원 안내문을 쉬운 말·사진·큰 글씨·음성으로 바꾸고, 캐릭터 또박이 선생님의 수업과 티치백(teach-back) 확인 질문으로 환자가 실제로 이해했는지 그 자리에서 점검하는 병원용 건강문해력 앱이다.
왜 병원에 필요한가
병원은 시술과 진료 전후마다 안내문을 건넨다. 검사 전 준비 사항, 복약 방법, 시술 후 주의할 점까지 환자가 집에서 스스로 지켜야 할 내용이 대부분이다. 문제는 안내문을 건네는 것과 환자가 그 내용을 이해하는 것 사이에 간격이 있다는 점이다. S.T.A.T는 "이 안내문을 어떻게 하면 환자가 제대로 이해할 수 있을까?" 라는 현장의 질문에서 출발하였다.
| 현장에서 겪는 어려움 | S.T.A.T가 바꾸는 것 |
|---|
| 시술·진료 전후 안내문을 받아도, 환자가 무엇을 언제 해야 하는지 정확히 알지 못한 채 귀가한다 | 안내문의 핵심을 쉬운 말과 그림으로 다시 보여 주고, 꼭 지켜야 할 내용은 티치백으로 한 번 더 확인한다 |
| 외래·병동의 바쁜 흐름 속에서 간호사가 환자마다 같은 설명을 처음부터 반복한다 | 기본 안내는 앱이 맡고, 간호사는 환자가 헷갈려한 부분에 집중해 설명한다 |
| "설명했다"는 기록은 남지만, 환자가 실제로 이해했는지는 확인하기 어렵다 | 티치백 결과가 남아 누가 어떤 내용을 이해하지 못했는지 바로 알 수 있다 |
| 고령자·외국인·장애인에게 필요한 통역이나 별도 자료가 늘 준비되어 있지는 않다 | 큰 글씨·그림·다국어 안내를 한 화면에서 함께 제공해, 따로 준비하지 않아도 누구나 같은 안내를 받는다 |
누구를 위한 앱인가
- 구매·도입 주체 — 병원: 환자안전과 환자교육의 질을 관리해야 하는 의료기관
- 사용자 — 간호사: 짧은 시간에 많은 환자를 교육해야 하는 현장 간호사
- 수혜자 — 환자: 고령자·장애인·아동·외국인을 포함해, 아프고 불안한 상황에서 병원 문서를 이해하기 어려운 모든 사람
어떤 상황에서 쓰는가
- 간호사가 외래·병동에서 환자에게 필요한 안내 영역(일반검사·내시경·복용약)을 골라 교육 코드를 발급한다.
- 환자는 대기 중이나 귀가 후 코드와 생년월일만으로 안내를 열어 자기 속도로 다시 본다. 앱 설치는 필요 없다.
- 안내를 본 뒤 티치백 질문(예: "몇 시부터 물을 마시면 안 될까요?")에 답한다. 틀리면 다른 표현으로 다시 설명하고 다시 묻는다.
- 간호사는 결과 화면에서 환자가 이해하지 못한 항목만 확인해 짧게 보충 설명한다.
기획 의도
병원은 하루에도 수많은 문서를 건넨다. 대장내시경 전 안내문, 복약안내서, 입·퇴원 준비 안내문은 치료의 시작이자 안전의 조건이다. 같은 문서가 누군가에게는 한 번 읽으면 충분한 안내이지만, 고령자·장애인·아동·외국인에게는 넘기 어려운 벽이 된다. 금식 시간을 잘못 이해해 검사가 미뤄지고, 복용 시간을 혼동해 치료 효과를 잃는다. 이는 개인의 부주의가 아니라 정보 접근의 불평등에서 비롯된다. 건강문해력의 격차는 곧 건강형평성의 격차이다.
우리는 간호학도로서 이 문제를 '환자가 이해하지 못한 것'이 아니라 '우리가 이해시키지 못한 것' 으로 바라보았다. 팀에는 장애인복지 현장에서 5년간 일한 팀원이 있다. 그는 설명이 조금만 쉬웠다면 스스로 할 수 있었던 일을 포기하는 사람들을 가까이에서 지켜보았다. 그 경험이 우리에게 질문을 남겼다. "좋은 설명은 누구에게나 닿을 수 있는가?"
의료 현장에서 STAT은 '즉시'를 뜻한다. S.T.A.T는 이해가 필요한 바로 그 순간에 누구도 뒤처지지 않도록 돕는다.
왜 병원이 사용 주체인가 — 정보 취약계층일수록 스스로 앱을 찾아 설치하기 어렵다. 도움은 그들이 찾아오기를 기다려서는 안 되며, 그들이 이미 서 있는 자리, 곧 진료 현장에서 건네져야 한다.
| 대상 | S.T.A.T가 제공하는 가치 |
|---|
| 환자 | 이해와 안심 |
| 의료진 | 교육의 질 향상, 반복 설명 시간 절감 |
| 병원 | 환자안전과 신뢰 |
설계 원칙 — S.T.A.T는 개인정보가 아닌 보편적 설명과 접근성에 집중한다. 환자 이름·등록번호·전화번호를 저장하지 않으며, 기술이 사람을 가르는 도구가 아니라 사람을 잇는 다리가 되도록 설계하였다.
2. 주요 기능
| 과제의 꼭 있어야 하는 기능 | 화면(프론트엔드) | API(백엔드) · 저장 |
|---|
| 1. 병원 안내문을 이해하기 쉬운 형태로 제공 | ① 넣기 의료진이 환자별 안내(검사 종류·나이대·언어·검사일)를 골라 교육 코드 발급(/staff/new) → ② 목록 내 코드 목록(/staff/codes)에 바로 보임 → ③ 남음 새로고침·서버 재시작 후에도 유지 → ④ 고치기·지우기 잠금 풀기·코드 폐기(/staff/codes, /staff/admin). 환자는 받은 코드로 쉬운 안내문(/guide), 또박이 사진 수업(대장내시경 /video, 검진 전날 /day-before, 위내시경 /gastroscopy), 위험 신호(/danger)를 본다. 검진 전날·위내시경 수업을 포함한 화면 글자와 읽어 주는 목소리가 환자가 고른 5개 언어(한국어·영어·일본어·중국어·베트남어)로 나온다 | issueCode → createEducationCode(Supabase DB 저장, 생년월일 해시, 7일 만료), listCodesForStaff·listAllCodes(목록), unlockCodeAction·discardCodeAction(잠금 풀기·폐기), translateForPatient(미리 번역한 파일 → 저장된 번역 → Claude API 순서로 번역, 번역 뒤 숫자·시간·양이 원문과 같은지 검사하고 다르면 쓰지 않음) — src/app/staff/actions.ts, src/lib/education-store.ts, src/app/p/translate-actions.ts |
| 2. 티치백으로 이해 여부 확인 | ① 넣기 환자가 티치백 3문제에 답함(/p/코드/check), 틀리면 다른 표현으로 다시 설명 후 재질문 → ② 목록 의료진 결과 화면에 문제별 정답·오답 표시 → ③ 남음 DB에 저장되어 새로고침해도 유지 → ④ 지우기 시연 기록 초기화(/staff/admin) | recordTeachback → saveTeachbackResult, recordConfusion → addConfusionMark("헷갈려요"), completeGuide → markGuideCompleted(안내 완료), resetDemoRecordsAction(초기화) — src/app/p/records.ts, src/lib/education-store.ts |
| 3. 의료진이 환자별 안내를 지정하고 결과 확인 | 의료진 로그인(/staff) → 코드 발급·QR(/staff/issued/코드) → 내 코드 목록·결과 상세(/staff/codes) → 관리자 통계(통과율, 많이 틀린 문제 TOP 3, "헷갈려요" 많은 곳)(/staff/admin). 간호사는 자기가 발급한 코드만 보고 고칠 수 있고(남의 코드·없는 코드는 404), 관리자는 모든 코드를 관리한다 | loginStaff·logoutStaff, findCodeForStaff(남의 코드는 찾지 못해 404), 코드를 바꾸는 모든 동작(발급·잠금 풀기·폐기·초기화)은 서버가 로그인한 계정의 역할을 다시 확인 — src/app/staff/actions.ts, src/lib/code-access.ts |
더 만든 기능
| 기능 | 내용 |
|---|
| 간호사 계정 관리 | 관리자가 관리자 화면(/staff/admin)의 「간호사 계정」에서 새 간호사 계정(아이디·이름·비밀번호 8자 이상)을 만들고 「사용 중지」할 수 있다. 비밀번호는 해시로만 저장하고, 만들기·중지는 서버가 관리자인지 다시 확인한다. 시연 계정(nurse01·nurse02·admin01)은 그대로 쓸 수 있고, 새 간호사도 자기가 발급한 코드만 본다 (src/lib/staff-accounts.ts) |
| 또박이 선생님 수업 | 캐릭터 '또박이'가 대장내시경 준비(1~8교시), 검진 전날 준비, 복용 중인 약을 사진 수업 영상으로 차례대로 설명하고 깜짝 퀴즈를 낸다. 복용약 수업은 환자가 고른 약에 맞는 장면만 보여 준다. 글을 읽기 어려운 환자도 보고 들으며 따라갈 수 있다. |
| 사진·그림 안내 | 먹어도 되는 음식과 피해야 할 음식, 약 복용, 금연, 보호자 동반 등 중요한 행동을 실제 사진과 그림 카드로 보여 준다. |
| "헷갈려요" 버튼 | 이해되지 않는 문장에서 버튼을 누르면 더 쉬운 표현으로 다시 설명한다. 누른 기록은 간호사가 확인할 수 있다. |
| 지금 할 일 | 검사일을 기준으로 오늘 환자가 해야 할 일만 골라 홈 화면에 보여 준다. |
| 위험 신호 안내 | 바로 병원에 연락해야 하는 증상을 따로 강조하고, 누르면 병원으로 바로 전화가 연결된다. |
| 5개 언어 지원 | 한국어·영어·일본어·중국어·베트남어로 안내를 볼 수 있다. 번역 후 시간·용량 숫자가 원문과 같은지 자동으로 확인하고, 다르면 번역을 쓰지 않는다. |
| QR 코드 발급 | 간호사가 발급한 교육 코드를 QR 코드로 보여 주어, 환자가 휴대폰 카메라로 바로 열 수 있다. |
| 관리자 화면 | 의료진 로그인 화면을 함께 쓰되, 관리자 아이디로 로그인하면 관리자 화면으로 이동한다. |
| 개인정보 보호 | 이름·등록번호·전화번호를 받지 않고, 생년월일은 되돌릴 수 없게 해시로 저장한다. 5번 틀리면 잠기고 코드는 7일 뒤 만료된다. |
3. 기술 스택
- 프론트엔드: Next.js 16(App Router), React 19, TypeScript, Tailwind CSS 4
- 백엔드: Next.js 서버 기능(Server Actions), Prisma 7(DB 연결), Claude API(Claude Haiku, 안내문 다국어 번역)
- 데이터(어디에, 무엇을): Supabase PostgreSQL(서울 지역) 시연용 DB 하나에 교육 코드·고른 안내·해시로 저장한 생년월일, 환자가 체크한 복용약, 티치백 결과를 저장한다(환자 이름·등록번호·전화번호는 저장하지 않음). 실제 환자에게 쓸 때는 테스트용과 운영용 DB를 분리한다.
4. 실행 방법
자세한 환경 설정은 docs/SETUP.md를 따른다.
# 1. 저장소 내려받기
git clone https://github.com/dayoung1111/stat-health-literacy.git
cd stat-health-literacy
# 2. 패키지 설치
npm install
# 3. 환경 변수 설정 (.env.example을 복사해 아래 이름의 값을 채운다)
cp .env.example .env
# 4. DB 준비: 테이블 만들기(prisma/migrations의 마이그레이션을 DB에 적용)
npm run db:migrate:deploy
# 5. 개발 서버 실행
npm run dev
This is the beginning of the README. Read the rest at the original. Read the full README ↗
