# 버전 및 업데이트

> 정보 패널을 읽고, 프런트엔드/백엔드 버전 불일치를 이해하며, 운영 관점에서 그것이 무엇을 의미하는지 파악합니다.

모든 Xisom 빌드에는 버전이 있습니다. 어떤 버전이 실행 중인지, 그리고
시스템의 모든 부분이 일치하는지 아는 것은 업데이트 후 또는 무언가가
예기치 않게 동작할 때 가장 먼저 확인해야 할 사항입니다.

## 정보 패널

**설정 → 정보**를 엽니다. 여기에는 실행 중인 플랫폼 버전과 함께
빌드 식별 정보가 표시됩니다. 버전은 표준 `MAJOR.MINOR.PATCH` 형식을
따릅니다(예: `v1.5.0`).

상태 엔드포인트에서 백엔드 버전을 확인할 수도 있습니다:

```bash
curl -s https://your-device-ip/api/system/health
# → { "version": "v1.5.0", "commit": "...", "buildTime": "..." }
```

## 버전 불일치가 의미하는 것

정보 패널은 프런트엔드 버전(브라우저의 대시보드)과 백엔드
버전(실행 중인 서비스)을 **모두** 표시합니다. 둘이 다를 경우 패널은
불일치를 강조 표시합니다.

**불일치가 발생하는 이유**

버전 불일치는 보통 **한 부분은 업데이트되었지만 다른 부분은 그렇지
않았음**을 의미하거나, 브라우저가 오래된 캐시된 대시보드를 표시하고
있음을 의미합니다. 이는 시스템이 완전히 일관된 상태가 아니라는
신호입니다.

운영 관점에서:

- **오래된 브라우저 탭** — 가장 흔하고 무해한 원인입니다. 대시보드를
  강력 새로고침(hard-refresh)하거나(또는 닫았다가 다시 열어) 현재
  버전을 로드합니다.
- **부분 업데이트** — 한 서비스는 재배포되었지만 다른 서비스는 그렇지
  않았습니다. 모든 부분이 동일한 버전에 도달하도록 업데이트를 다시
  실행합니다. [오프라인 번들 설치 → 업데이트](/ko/install-deploy/offline-bundle-install/)를
  참조하세요.

확신이 서지 않을 때는 다른 동작을 문제 해결하기 전에 프런트엔드와
백엔드 버전을 일치시키세요 — 불일치는 버그처럼 보이는 증상을 설명할 수
있습니다.

## 업데이트 후

1. **설정 → 정보**를 다시 엽니다.
2. 프런트엔드와 백엔드 버전이 **일치**하는지 확인하고 예상하는 버전을
   읽습니다.
3. 일치하지 않으면 강력 새로고침을 합니다. 문제가 지속되면 업데이트를
   다시 실행합니다.

## 문제가 발생하면

- 새로고침 및 재업데이트 후에도 버전 불일치가 지속되는 경우 —
  [문제 해결](/ko/troubleshooting/) 런북을 참조하세요.

## 다음 단계

  - [박스 업데이트](/ko/install-deploy/offline-bundle-install/) — 더 새로운 릴리스 번들을 배포합니다.
  - [릴리스 노트](/ko/release-notes/) — 각 릴리스에서 변경된 내용.