찾아줘 메디 (findmedi.co.kr) — 지금 문 연 병원·약국을 찾아드려요
야간·휴일·명절에 지금 영업 중인 병원·약국을 3초 안에 찾고, 한 번의 탭으로 전화 확인까지 끝내며, 그 확인 결과를 다음 사람에게 남기는 서비스.
- 폴더명
open-clinic-now는 작업용 코드명이다. 서비스명·도메인은 ROADMAP의 결정 항목에서 확정한다.
- 기획 원본은
D:\planning에 있고, 이 저장소의 docs/planning은 2026-10-18 시점 사본이다.
왜 이 서비스인가
- 2026년 추석에도 응급실 내원의 51.3%가 경증이었다. 응급실 밖에서 갈 곳을 못 찾는 수요가 구조적이다.
- 공휴일 진료시간을 등록한 병의원은 전국의 10.6%뿐이고(2026-10 API 실측), 공식 앱(응급똑똑, 구글플레이 평점 2.8)의 2026년 추석 주된 불만은 "진료 중으로 떠서 갔는데 닫혀 있었다"였다.
- 그래서 핵심은 원탭 전화 자체가 아니라 통화 결과를 데이터로 되돌리는 확인 루프다: 전화 → 1탭 확인 → "○분 전 통화로 확인됨".
핵심 원칙
| 원칙 | 내용 |
|---|
| 3초 룰 | 첫 화면부터 전화 버튼까지 3탭·3초 이내 |
| 확인 루프 | 통화 후 1탭 응답(진료 중 / 휴진 / 안 받음)을 모은다. 다음 사용자에게 보여줄지는 소프트 런칭 실측 후 결정(D16) |
| 정직한 상태 표시 | '등록 기준 / 정보 없음 / 통화로 확인됨'을 구분. 정보 없음은 휴무가 아니다 |
| 웹 우선 | 수요 순간의 행동은 검색이다. SEO 반응형 웹 먼저, 앱은 설 연휴 지표 게이트 통과 후 |
범위
- MVP (2027년 설 연휴 전): 지금 영업 중 필터, 병원/약국·과목 필터, 소아 진료 자체 분류, 카드 리스트(지도 뷰 없음), 원탭 전화, 통화 후 질문(수집만, 표시는 실측 후), 길찾기 딥링크, 동네 이름 검색, SEO 페이지 체계(기관 상세 약 10.4만, 지역 랜딩, 연휴 특집)
- v1.1: 확인 루프 고도화, 즐겨찾기·공유, 큰 글씨 모드, PWA 웹 푸시(앱 수요 실험)
- 앱 (게이트 통과 시): React Native(Expo) — 푸시, 위젯, iOS 통화 결과 감지
- 하지 않는 것: 예약·접수, 비대면진료, 약 재고, 커뮤니티, 병원 노출 순위에 금전 개입
기술 방향
- 웹: Next.js(SSR/ISR) 반응형 웹 — 정적 정보(진료시간표·전화)는 서버 렌더링, "지금 영업 중"은 요청 시점에 계산
- 데이터: 국립중앙의료원 전국 병·의원 찾기(15000736)·전국 약국 정보 조회(15000576) API를 수집 워커가 FullData로 매시간 동기화(1회 11호출). 클라이언트는 공공 API를 직접 호출하지 않는다
- DB: PostgreSQL + PostGIS (위치 반경 쿼리), 자체 보정 테이블(통화 확인·휴진 제보)
- 구조: 모노레포 —
apps/web, apps/mobile(앱 단계), packages/core, packages/ui-tokens
- 인프라(월 0원 시작): Vercel Hobby(웹) · Supabase Free 서울(DB) · GitHub Actions(수집 워커) · GA4 + 자체 이벤트. 지도 API는 Phase 1b 전에 정한다(DECISIONS D11~D15)
문서
개발 환경
- Node.js 24, npm 11 (pnpm은 미설치 — 필요하면 corepack으로 활성화)
- 공공데이터포털 인증키는
.env.local의 DATA_GO_KR_KEY에 사용자가 직접 넣는다(Decoding 키). 저장소에 커밋하지 않는다. 형식은 .env.example 참고
미리보기 주소에서 확인 (평소)
평소 확인은 Vercel 미리보기 주소에서 한다(2026-10-21부터): https://munyeon-git-feat-main-list-yongbinkim.vercel.app (브랜치마다 munyeon-git-<브랜치>-yongbinkim.vercel.app). 브랜치에 push하면 1분 안팎으로 갱신된다. 로그인 보호가 있어 Vercel에 로그인한 브라우저에서 열린다. 휴대폰 위치 권한도 여기서 시험한다(https). 로컬 서버는 상시로 켜 두지 않고, push 전 점검할 때만 잠깐 띄운다.
로컬에서 확인 (push 전 점검)
기본은 Supabase dev DB를 쓴다(2026-10-21부터). .env.local에 munyeon-dev의 Session pooler(포트 5432) 접속 문자열을 DATABASE_URL로 사용자가 직접 넣는다. 비밀번호 자리의 [ ] 괄호는 지우고, 비밀번호에 @ : / ? # % 같은 문자가 있으면 URL 인코딩한다.
처음 한 번 테이블을 만들고 전국 데이터를 받는다(공공 API 13호출, 몇 분).
npm run db:migrate
npm run sync -- all
npm run sync -- holidays
그다음부터는 한 줄로 빌드 → 실행(포트 3001, 같은 와이파이의 휴대폰에서도 접속)까지 된다. 접속 주소가 화면에 나오고, Ctrl + C로 꺼진다.
npm run local
- 빌드 없이 다시 띄우기:
npm run local -- --no-build
- Supabase 무료 프로젝트는 1주일 쓰지 않으면 일시정지된다. 접속이 안 되면 대시보드에서 Restore를 누른다.
- 인터넷 없이 로컬 DB(PGlite + PostGIS,
.pglite/)로 띄우기: npm run local -- --pglite. .env.local에 DATABASE_URL이 없어도 로컬 DB로 뜬다. 로컬 DB에 데이터를 받으려면 node apps/worker/src/dev-db.ts --real을 켜 둔 채 다른 터미널에서 DATABASE_URL=postgres://postgres:[email protected]:54329/postgres npm run sync -- all(셸에서 준 값이 .env.local보다 우선한다).
로컬 DB(--pglite)를 쓸 때만 해당:
- 끌 때는
Ctrl + C 한 번. 로컬 DB는 정상적으로 닫힌 뒤 꺼진다(강제로 끄면 .pglite/가 손상될 수 있다). 이미 켜져 있으면 두 번째 DB는 데이터 폴더를 열지 않고 멈춘다.
- 로컬 DB(PGlite)는 세션이 하나라, 연결이 둘 이상 동시에 붙으면 쿼리가 섞인다(
bind message supplies … parameters 오류). 웹 서버는 연결 하나만 쓰도록 되어 있으니, npm run sync처럼 다른 연결을 여는 작업은 웹을 끄고 실행한다. 실서비스 DB(진짜 Postgres)에는 이 제약이 없다.
- 로컬 DB가
RuntimeError: Aborted()로 열리지 않으면 폴더가 손상된 것이다. .pglite/를 다른 이름(예: .pglite.broken-날짜)으로 바꾸고, 처음 받을 때처럼 npm run sync -- all과 npm run sync -- holidays로 다시 받는다(공공 API 13호출).
- 표본 16곳만으로 빠르게 보기:
node apps/worker/src/dev-db.ts(인메모리) + npm run dev -w @munyeon/web
- 응답 코드·noindex·격자 JSON 점검:
node scripts/check-routes.mjs http://localhost:3001
- 휴대폰의 '현재 위치'는
https:// 주소에서만 된다. 같은 와이파이의 http://192.168.x.x:3001로는 위치 권한이 막혀 최근 지역 또는 서울 중구 명동으로 시작한다. PC의 http://localhost:3001에서는 위치를 쓸 수 있다. 휴대폰 위치 확인은 배포 주소(또는 Vercel 미리보기 주소)에서 한다.
- 실데이터 DB를 켜 둔 채 표본 DB를 따로 띄우기:
node apps/worker/src/dev-db.ts --port=54330
