# Runbook

> Các việc vận hành thường gặp và nơi tìm quy trình tương ứng trong repo: triển khai, sao lưu, giám sát, khôi phục.

Trang này chỉ chỉ đường. Quy trình đầy đủ nằm trong repo, cạnh mã mà chúng vận hành, để cùng được review và cập nhật.

## Triển khai

Ứng dụng chạy bằng Docker image do Coolify dựng và chạy. Cách triển khai, đổi biến môi trường và quay lại bản trước ở `docs/deployment-guide.md`. Dockerfile từng ứng dụng nằm ở `infra/docker/`.

## Giám sát

Uptime Kuma kiểm tra trang chính, ứng dụng salon, admin, docs và API. Danh sách và trạng thái từng kiểm tra ở `infra/uptime-kuma/checks.md`; kiểm tra của trang docs nằm ở `infra/uptime-kuma/docs.json`. Cảnh báo gửi vào nhóm giám sát nội bộ.

## Sao lưu và khôi phục

Cơ sở dữ liệu được sao lưu định kỳ, có kiểm tra tuổi bản sao lưu gần nhất. Kịch bản diễn tập khôi phục và các thao tác liên quan ở `infra/backup/`. Diễn tập khôi phục là việc nên lặp lại định kỳ, không chỉ khi có sự cố.

## Chuyển hạ tầng

Các kịch bản và cổng kiểm tra cho đợt chuyển API và cơ sở dữ liệu nằm ở `infra/cutover/`.

## Lỗi và theo dõi

Lỗi ứng dụng được gom về hệ thống theo dõi lỗi, có kiểm tra sức khoẻ riêng. Khi báo lỗi cho nhóm, ghi mã lỗi ổn định (`code`) trong phản hồi và thời điểm xảy ra, đừng đính kèm mã thông báo hay dữ liệu khách.

## Trang docs

Trang docs là site tĩnh, triển khai bằng Cloudflare Workers với tài nguyên tĩnh. `pnpm --filter @beachoice/docs build` dựng site, sau đó `docs:check` và `docs:check:dist` kiểm nội dung và bản dựng.
