You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
도착 정보가 몇 초 전 것인지 "N초 전 정보"가 1초마다 올라가고, 새로고침 버튼으로 바로 다시 받을 수 있어요. 불러오지 못하면 다시 시도 버튼이 뜨고, 다시 시도도 실패하면 토스트로 알려줘요.
도착 빠른 순 / 도보 짧은 순 / 환승 적은 순으로 정렬할 수 있어요.
5. 환승: 바로 탈 확률
데스크톱
모바일
환승이 있는 경로는 경로 카드에 "바로 환승 N%"를 보여줘요. 첫 버스에서 내린 뒤 환승 버스를 기다리지 않고 바로 탈 수 있을 확률이에요.
확률은 환승 정류장에 쌓인 "버스가 예측보다 얼마나 일찍 왔나" 데이터로 계산해요. 환승 버스가 예측보다 일찍 와서 먼저 지나가 버릴 확률을 빼는 방식이에요.
후보 버스 중 확률이 80% 이상인 첫 버스를 탈 버스로 잡아요. 80%를 넘는 버스가 없으면 확률이 가장 높은 버스를 잡아요.
환승 정류장에 데이터가 없으면 확률은 보여주지 않고, 내린 뒤 1분 이상 여유가 있는 첫 버스로 잡아요.
확률은 환승 버스가 실시간 도착 정보에 잡혀 있을 때만 계산돼요. 환승까지 시간이 많이 남아 탈 버스가 아직 도착 정보에 없으면 "다음 차 정보 없음"으로 보여줘요.
경로 상세에서는 환승 구간마다 확률을 따로 보여주고, 환승이 두 번 이상이면 모두 바로 탈 확률도 함께 보여줘요.
6. 경로 상세: 출발부터 도착까지 시간 순서로
데스크톱
모바일
출발 전 대기 → 걷기 → 승차 정류장 → 하차 → 도착까지 시각과 함께 한 줄 타임라인으로 보여줘요.
지도에는 걷는 구간과 버스 구간이 노선 색으로 그려져요.
위쪽 탭으로 다른 경로로 바로 바꿔 볼 수 있어요.
7. 출발 알림: 나갈 때가 되면 푸시로
데스크톱
모바일
경로의 출발 알림 받기를 누르면 알림 권한을 묻고, 허용하면 "출발 알림 켜짐"으로 바뀌어요.
알림을 켜 두면 서버가 실시간 도착 정보로 나가야 하는 시각을 계속 다시 계산해요. 버스가 늦어지면 알림도 그만큼 늦게 와요.
나가야 하는 시각 2분 전에 푸시 알림을 한 번 보내요. 알림을 누르면 그 경로의 상세 화면이 열려요.
다시 누르면 알림이 꺼지고, 예약된 푸시도 취소돼요.
알림을 켜 둔 뒤 탈 버스가 사라지거나, 도착 정보 API에 장애가 나거나, 알림을 켠 지 3시간이 지나면 "출발 알림을 보내지 못했어요" 푸시로 이유와 함께 알려줘요. 이 푸시는 30분 동안 유효해서, 그 사이 폰이 다시 연결되면 받을 수 있어요.
알림 등록 자체가 실패하면(알림 권한·구독이 없거나 등록 개수를 넘으면) 화면에 토스트로 이유를 알려줘요.
데스크톱에서는 버튼 아래에 "알림은 이 컴퓨터로 와요" 안내가 붙어요. 폰으로 받으려면 폰에서 켜야 해요.
아이폰에서는 홈 화면에 추가한 앱에서만 알림을 받을 수 있어요. (iOS 16.4 이상)
8. 앱처럼 설치하기 (PWA)
아이폰 시작 화면
브라우저에서 홈 화면에 추가하면 주소창 없이 앱처럼 열려요. (아이폰: Safari 공유 → 홈 화면에 추가, 안드로이드: Chrome 메뉴 → 앱 설치)
실행할 때는 흰 화면에 서비스 아이콘과 이름이 뜨는 시작 화면이 보여요.
만든 방식
화면 (Next.js App Router · TypeScript): 카카오맵 위에 경로를 그리고, TanStack Query로 실시간 도착 정보를 25초마다 다시 받아요. PWA로 설치할 수 있고, 서비스 워커가 푸시를 받아요.
공공 API 중계 (Next.js Route Handler on Vercel): 카카오 길찾기·장소 검색, 대전 BIS·TAGO, 서울 버스 API를 서버에서 호출해 API 키가 브라우저로 나가지 않아요. 지역마다 같은 모양의 함수(정류장 찾기 · 도착 정보 받기)로 나눠, 서울을 더할 때 화면 코드는 바꾸지 않았어요.
AlertMonitor (Durable Object): 알림마다 하나씩 떠서 도착 정보를 다시 받고, 화면과 같은 출발 시각 계산 함수(src/shared)로 나가야 할 시각을 다시 계산해 2분 전에 Web Push(VAPID)를 보내요.
StopMonitor (Durable Object) + Cron: 정류장마다 1분 간격으로 "예측 도착 vs 실제 도착" 오차를 모아 정류장별 히스토그램으로 D1에 쌓아요. 도착 3·5·10분 전 예측은 출발 여유 계산에, 15·20분 전 예측은 환승처럼 먼 버스를 보기 위해 모으고 있어요. 매일 05:20 Cron이 대전 정류장 중 그날 지켜볼 11곳을 골라 돌아가며 수집해요.
여유 시간: 정류장별 오차에서 버스가 일찍 오는 쪽 P10(10번 중 9번은 놓치지 않는 기준)을 쓰고, 데이터가 100건 미만인 정류장은 2분을 둬요.