Salmonbus 기술 문서
연어버스는 경기 광역버스 1650·3330의 탑승 예보 서비스다. 이 사이트는 좌석 예보·탑승 판정·대기열 추정의 기술 문서를 모은다. 현재 자료를 앞세우고, API 초안은 보존 문서로 남긴다.
수집 정상 · 오늘 API 호출 46회 · 일일 평가 2일째 · 만석 누적 173건 · 승자 없음
배포 시점 값 · 일일 평가 2026-08-16분 · 생성 08-17 00:15 KST지금 보는 것
- LIVE 수집 현황두 노선 실시간 수집·일일 모델 평가
- 후보 모델 8개아이디어·구조·오늘 성적 — 08번 좌석 분포 후보 추가(08-19)
- 확정 도메인 설계모듈 경계와 계약 — 구현 기준
- 데이터 스택 해부실측으로 검증한 데이터와 그 근거
- 보드 화면 가이드응답이 화면 요소로 이어지는 방법
공공 데이터 명세
현행 API 계약
v3
확정2026-08-17 팀 검토로 확정한 계약. 새 구현의 기준.
- Client API공개 HTTP 계약 — FE는 이것만
- Data Pipeline내부 DB·발행 계약 — 표 8개
- GBIS Upstream수집기 전용 외부 계약
- Operations상태 점검 — /actuator/health
- 차량 참조 제거 — 응답은 확률 하나
- 실시간 차량은 별도 엔드포인트(/vehicles · 60초) — 운행 종료 단정 없음
- 발행은 시간대 경계에서만 — 07 · 09 · 17 · 20시 KST
v4
검토 요청08번 후보(차량 상태 조건부 좌석 분포)를 채택할 경우에 필요한 개정안. 선택 필드를 더하는 증분안이 아니라 /board를 다시 만드는 파괴적 변경이다. 확정 계약은 위 v3이고 이것은 아직 제안이다. 팀 검토를 기다린다.
- Client API/board 재구성 — 파괴적 변경 2.0.0
- Data Pipeline표 2개 신설 · 발행 계층 동결 4.0.0
- 도메인 설계/board 의 원천이 발행본에서 관측으로
- 예보의 주어가 바뀐다 — 지금 오고 있는 그 버스가 그 정류장에 도착할 때 몇 석 남는지
- /board를 재구성한다 — 정류장당 확률 하나를 도착 예정 차량별 확률로 바꾼다
- 파괴적 변경이라 프론트엔드 수정이 필요하다. 정류장 골격과 /routes·/vehicles는 스키마가 그대로이고, 노선 메타는 방향마다 첫차·막차 시각이 는다
API 초안 — 보존
확정 계약은 위 v3다. 아래 v2·v1은 확정 전 명세 초안으로 보존한다.
v2
이전 초안검토와 FE 피드백을 반영한 개정안. 프론트엔드 타입은 Client API 명세로만 생성.
변경 이력 →- 보드를 운행 중 / 운행 종료로 나눔
- freshness 상태 enum 제거 — 낡음은 staleAt으로 판정
- features 2개로 축소 — 예보(판정 포함)·대기열