약 봉투 한 장이면, 해외 의약품 반입 준비가 끝납니다.
“약 때문에 여행을 망설이지 않도록.”
약 봉투를 촬영하면 복용 중인 의약품을 인식하고, 여행 국가의 규정에 따라 반입 가능 여부 · 준비 서류 · 현지 대응 정보를 한곳에서 안내하는 해외여행 의약품 관리 서비스입니다.
MediPass는 식약처 의약품 정보와 국가별 정부 원천 데이터를 바탕으로 의약품 성분을 확인합니다. 여행 전에는 필요한 준비를 체크리스트로 관리하고, 여행 중에는 재외공관 연락처와 현지어 설명문을 통해 긴급 상황에 대응할 수 있습니다.
| 레포지토리 | 설명 | 기술 스택 |
|---|---|---|
| MediPass-FE | 모바일 웹 프론트엔드 | React · TypeScript · Vite |
| MediPass-BE | 백엔드 서버 | Spring Boot · Java 21 |
📷 약 봉투 촬영
↓
🔎 OCR 인식 · 식약처 의약품 매칭
↓
💳 한글·영문 복약 카드 생성
↓
✈️ 여행 국가 · 복용 의약품 선택
↓
🚦 국가별 반입 가능 여부 판정
↓
✅ 준비 서류 체크 · 증빙 서류 보관
↓
🆘 재외공관 연락처 · 현지어 설명문 제공
의약품의 성분, 소지량, 목적지 국가의 규정을 종합해 다음 3단계로 안내합니다.
| 판정 | 의미 | 안내 내용 |
|---|---|---|
✅ 반입 가능ALLOWED | 별도 제한 없이 반입 가능한 의약품 | 기본 휴대 및 보관 안내 |
📄 서류 준비 필요PREP_REQUIRED | 처방전·의사 소견서·허가서 등이 필요한 의약품 | 준비 항목과 공식 신청 페이지 제공 |
⛔ 반입 제한NOT_ALLOWED | 반입이 제한되거나 관계 기관 확인이 필요한 의약품 | 판정 근거와 확인 기관 안내 |
MediPass의 판정은 여행 준비를 돕기 위한 정보이며, 실제 반입 가능 여부는 출국 전 해당 국가의 최신 공식 지침을 함께 확인해야 합니다.
| 로그인 · 온보딩 | ||
 |  |  |
| 로그인 | 서비스 소개 | 약관 동의 |
| 약 봉투 스캔 · 복약 카드 | ||
 |  |  |
| 약 봉투 촬영 | OCR 결과 확인 | 복약 카드 |
| 여행 등록 · 반입 체크로그 | ||
 |  |  |
| 여행 정보 입력 | 의약품 선택 | 여행별 체크로그 |
| 반입 판정 · 준비 체크리스트 | ||
 |  |  |
| 신호등 판정 | 판정 근거 | 준비 서류 체크리스트 |
| 서류함 · 긴급 도움 | ||
 |  |  |
| 서류함 | 재외공관 연락처 | 현지어 긴급 설명문 |
- 카카오 OAuth2 소셜 로그인
- JWT 기반 사용자 인증 및 로그인 상태 유지
- 서비스 이용 전 온보딩과 약관 동의
- 카메라 촬영 또는 이미지 업로드를 통한 약 봉투 스캔
- CLOVA OCR로 약품명과 복용 정보를 추출
- 식약처 의약품 API를 활용한 제품·성분 매칭 및 검증
- 인식 결과 수정, 후보 의약품 선택, 직접 입력 지원
- 복용량·복용 횟수·처방 기관·조제일을 담은 한글·영문 복약 카드 제공
- 출발지·목적지와 여행 기간 등록
- 여행에 가져갈 의약품 선택
- 성분별 반입 가능·서류 준비 필요·반입 제한 판정
- 수량 제한이 있는 성분의 소지량 계산과 한도 비교
- 정부 원천 문서, 규정 기준일 등 판정 근거 제공
- 판정 결과에 따른 준비 서류·행동 항목 자동 생성
- 항목별 완료 상태 관리 및 정부 공식 신청 페이지 연결
- 처방전·의사 소견서·반입 허가서 등 PDF 증빙 서류 업로드
- 의약품별 서류 조회, 미리보기, 다운로드 및 삭제
- 외교부 데이터를 활용한 현지 재외공관 연락처 조회
- 의약품 분실·부족 등 상황별 대응 안내
- 병원·약국·세관에서 제시할 수 있는 현지어 의약품 설명문 생성
📱 MediPass Mobile Web (React · TypeScript)
│ 카카오 OAuth · JWT
│ 복약 카드 · 여행 체크로그 · 서류함 · 긴급 도움
▼
💊 MediPass Backend (Spring Boot · Java 21)
│
├─▶ 🗄️ MySQL 사용자 · 의약품 · 여행 · 규제 데이터
├─▶ 🪣 AWS S3 증빙 서류 · Presigned URL
│
├─⇄ 📷 CLOVA OCR 약 봉투 인식
├─⇄ 🏥 식약처 API 의약품 품목 · 성분 검증
├─⇄ 🏛️ 외교부 API 재외공관 연락처
└─⇄ 🤖 OpenAI 현지어 설명문 생성
백엔드는 외부 API를 전용 클라이언트로 분리해 도메인 로직과 외부 명세의 결합을 낮췄습니다. 규제 판정은 미리 정규화해 적재한 데이터베이스를 기준으로 수행하며, 서류는 S3 객체 키만 저장한 뒤 요청 시 만료형 URL을 발급합니다.
📄 국가별 정부 원천 문서
│ 오프라인 추출 · 정규화
▼
📋 TSV 규제 데이터
│ 애플리케이션 시작 시 UPSERT
▼
🗄️ 성분 규제 · 준비 서류 템플릿
│
▼
⚖️ 반입 판정 엔진 ──▶ 🚦 판정 결과 + ✅ 준비 체크리스트
국가별 데이터 소스와 준비 서류 템플릿을 분리해 새로운 국가의 규정을 확장할 수 있도록 설계했습니다.
 김예나 |  장현서 |  정종진 |  조윤지 |
| Frontend | Frontend | Backend | Backend |
| @a-neey | @atelier-hs | @ThreeeJ | @yj-044 |