버스래핑 광고 시스템

핵심 컬럼은 노선번호, 등급, 공개 여부(isOpen), 관리자 메모, 생성/수정 시각입니다.

API 응답 시에는 경유 정류장 배열 stops 와 최근 30일 기준 avgDailyRiders 가 자동 병합됩니다.

노선과 정류장 관계를 저장하며 busRouteId, stopName, arsId, xCoord, yCoord, stopOrder, busStopArsId 를 사용합니다.

busStopArsId 는 common DB bus_stop.arsId 를 참조해 자동 연결됩니다.

정류장 순서는 공공데이터만으로 완전히 보장되지 않으므로 관리자가 직접 지정합니다.

가격 테이블은 grade, wrappingType, monthlyPrice, productionFee, installationFee 를 중심으로 운영합니다.

등급과 래핑유형 조합은 UNIQUE KEY (grade, wrappingType)로 upsert 관리합니다.

bus_vehicle_spec 은 차종 × 래핑면별 규격을 저장해 제작 가이드와 UI 표시에 사용합니다.

bus_ridership_logs 는 nodeId, arsNo, rteNo, stationNm, useYmd, gtonCount, gtoffCount 를 포함한 대용량 로그입니다.

bus_stop 은 정류장명, ARS 번호, 좌표, 유형 코드 마스터로 자동완성과 좌표 매칭에 사용됩니다.

가격표와 할인 규칙만 API로 가져오고, 월 비용·할인·총 비용 계산은 클라이언트에서 즉시 처리합니다.

월 비용 = monthlyPrice × volume
할인 적용 = 기간 할인율 + 볼륨 할인율
최종 월 비용 = 월 비용 × (1 - 할인율)
총 비용 = 최종 월 비용 × duration
1회성 비용 = (productionFee + installationFee) × volume

노선번호를 기준으로 common DB의 최근 30일 로그를 집계해 RouteCard에 평균 일 승차 인원을 보여줍니다.

SELECT rteNo,
       ROUND(SUM(gtonCount) / COUNT(DISTINCT useYmd)) AS avgDaily
FROM bus_ridership_logs
WHERE rteNo IN (...)
  AND useYmd >= DATE_SUB(CURDATE(), INTERVAL 30 DAY)
GROUP BY rteNo

공공데이터만으로는 실제 운행 순서를 완전히 복원하기 어려워, 관리자가 stopOrder를 직접 지정하는 구조입니다.

유저용 읽기 API, 세션 기반 어드민 API, AI/CLI용 manage API를 분리해 사용성과 운영 편의성을 함께 확보합니다.

Cafe24 Object Storage에 webp 변환본과 small/base/original 버전을 저장하고, 프론트는 base.dataURL과 key를 조합합니다.

manage API는 자연어 지시를 받은 에이전트가 직접 curl 호출로 노선, 정류장, 가격, 할인, 이미지 데이터를 갱신할 수 있게 설계됩니다.