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