LinkOStar

변경 이력

호환성에 영향이 있을 만한 변경을 모읍니다. 모든 변경의 완전한 history는 backend repo의 git log를 보세요 — 여기는 통합 측이 액션을 취해야 할 항목만.

Breaking change 노티스 SLA

  • Path/method 제거 또는 이름 변경: 최소 30일 전 노티스 + 1 release 병행 유지.
  • 응답 key 제거/타입 변경: 최소 14일 전 노티스.
  • 응답 key 추가: 노티스 없이 즉시 — 통합 측은 unknown key를 무시해야 합니다.
  • 새 필수 query param/header: 14일 전 노티스 + 기본값 호환 기간.
  • 모든 노티스: 이 페이지 + LinkOStar 운영팀이 알고 있는 supplier 컨택에 메일/슬랙.

2026-06-04

  • fix: HubTokenAuthenticationFilter의 hub bearer 검증이 byte 단위 비교로 변경됨. VARBINARY 컬럼에 trailing zero-pad가 있던 row가 매번 401을 받던 버그 해결. 통합 측 액션 없음 — hub-agent의 telemetry/refresh 호출이 다시 정상.
  • feat: ProvisioningStep type에 INFO 추가. 별도 입력 없는 안내 단계. 기존 4종 (TEXT_INPUT, EXTERNAL_LIST_PICK, CONFIRM, CUSTOM) 그대로 호환.
  • feat: Hub-agent 의 BLE service UUID 가 00001801-... → 6d18c51f-0440-4e48-bbee-aa908ce6d0ef로 변경 (LinkOStar custom). 이전 image (hub-os ≤ v0.1.5) 가 깔린 hub는 모바일 BLE scan에서 안 보일 수 있음. v0.1.6+ 로 재flash 권장.
  • feat: Hub-agent telemetry/reconcile/self-update loop이 MQTT 활성화 여부와 무관하게 동작. mqtt.enabled: false로 두면 telemetry까지 같이 꺼지던 회귀 해결 (hub-agent v0.1.4 → v0.1.5).

2026-06-01

  • revert: /dashboard/stats endpoint 제거. 이런 cross-resource 집계는 supplier BFF의 책임이라 LinkOStar 측에서 빼고 supplier(EDS) BFF로 이전. 통합 가이드의 4-카드 대시보드 예시 참조.

2026-05-31

  • feat: POST /v1/hubs/{uuid}/telemetry 가 hub-agent의 flat reported-state 형태를 그대로 받게 변경 (이전 {payloadJson: ...} envelope는 호환 유지).
  • feat: GET /tenant/hubs 응답에 hubType,macAddress 추가. 기존 key 모두 유지.

버전 표기

  • Backend: rolling deploy. master push = production deploy. semver 태그 없음.
  • Hub-agent: vMAJOR.MINOR.PATCH 태그 (예: v0.1.5).
  • Hub-OS: hub-os-vMAJOR.MINOR.PATCH 태그. 최신 hub-agent를 자동 베이크.
  • OpenAPI spec: 별도 버전 번호 없음. 변경은 즉시 spec에 반영 + 이 페이지에 공지.