Salmonbus 기술 문서
연어버스는 경기 광역버스 1650·3330의 탑승 예보 서비스다. 이 사이트는 좌석 예보·탑승 판정·대기열 추정의 기술 문서를 모은다. 현재 자료를 앞세우고, API 초안은 보존 문서로 남긴다.
수집 정상 · 오늘 API 호출 46회 · 일일 평가 2일째 · 만석 누적 173건 · 승자 없음
배포 시점 값 · 일일 평가 2026-08-16분 · 생성 08-17 00:15 KST지금 보는 것
- LIVE 수집 현황두 노선 실시간 수집·일일 모델 평가
- 후보 모델 7개아이디어·구조·오늘 성적 — 1차 운영 선택 반영
- 확정 도메인 설계모듈 경계와 계약 — 구현 기준
- 데이터 스택 해부실측으로 검증한 데이터와 그 근거
- 보드 화면 가이드응답이 화면 요소로 이어지는 방법
공공 데이터 명세
현행 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
API 초안 — 보존
확정 계약은 위 v3다. 아래 v2·v1은 확정 전 명세 초안으로 보존한다.
v2
이전 초안검토와 FE 피드백을 반영한 개정안. 프론트엔드 타입은 Client API 명세로만 생성.
변경 이력 →- 보드를 운행 중 / 운행 종료로 나눔
- freshness 상태 enum 제거 — 낡음은 staleAt으로 판정
- features 2개로 축소 — 예보(판정 포함)·대기열