# Phiên bản & Cập nhật

> Đọc bảng About, hiểu sự lệch phiên bản giữa frontend/backend, và biết điều đó có ý nghĩa gì về mặt vận hành.

Mỗi bản dựng Xisom đều mang một phiên bản. Biết phiên bản nào đang chạy — và liệu
tất cả các thành phần của hệ thống có đồng nhất hay không — là điều đầu tiên cần kiểm tra sau một lần
cập nhật hoặc khi có gì đó hoạt động bất thường.

## Bảng About

Mở **Settings → About**. Nó hiển thị phiên bản đang chạy của nền tảng, cùng với
định danh bản dựng. Phiên bản tuân theo định dạng chuẩn `MAJOR.MINOR.PATCH` (ví dụ
`v1.5.0`).

Bạn cũng có thể xác nhận phiên bản backend từ health endpoint:

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

## Lệch phiên bản nghĩa là gì

Bảng About hiển thị **cả** phiên bản frontend (bảng điều khiển trong trình duyệt của bạn)
lẫn phiên bản backend (dịch vụ đang chạy). Khi chúng khác nhau, bảng sẽ làm nổi bật
sự không khớp này.

**Vì sao xảy ra lệch phiên bản**

Lệch phiên bản thường nghĩa là **một thành phần đã được cập nhật còn thành phần kia thì chưa**, hoặc
trình duyệt của bạn đang hiển thị một bảng điều khiển cũ đã được lưu trong cache. Đó là tín hiệu cho thấy hệ thống không ở
trạng thái nhất quán hoàn toàn.

Về mặt vận hành:

- **Tab trình duyệt cũ** — nguyên nhân phổ biến nhất và vô hại. Hãy tải lại mạnh (hard-refresh) bảng điều khiển
  (hoặc đóng rồi mở lại) để nạp phiên bản hiện tại.
- **Cập nhật một phần** — một dịch vụ đã được triển khai lại còn dịch vụ kia thì chưa. Hãy chạy lại
  quá trình cập nhật để tất cả các thành phần cùng về một phiên bản. Xem
  [Cài đặt từ gói offline → Cập nhật](/vi/install-deploy/offline-bundle-install/).

Khi còn nghi ngờ, hãy đồng bộ phiên bản frontend và backend trước khi xử lý các
hành vi khác — một sự không khớp có thể giải thích những triệu chứng trông giống như lỗi.

## Sau khi cập nhật

1. Mở lại **Settings → About**.
2. Xác nhận phiên bản frontend và backend **khớp nhau** và đọc đúng phiên bản bạn
   mong đợi.
3. Nếu chúng không khớp, hãy tải lại mạnh (hard-refresh); nếu vẫn còn, hãy chạy lại quá trình cập nhật.

## Nếu có gì đó sai sót

- Lệch phiên bản kéo dài sau khi đã tải lại và cập nhật lại — xem
  runbook [Troubleshooting](/vi/troubleshooting/).

## Tiếp theo

  - [Cập nhật box](/vi/install-deploy/offline-bundle-install/) — Triển khai một gói bản phát hành mới hơn.
  - [Ghi chú phát hành](/vi/release-notes/) — Những thay đổi trong mỗi bản phát hành.