From fdc3e15a3674247d05e7067ce66b41b71208cf2c Mon Sep 17 00:00:00 2001 From: Wira Basalamah Date: Mon, 8 Jun 2026 16:19:52 +0700 Subject: [PATCH] Document Debian deploy update steps --- CODEX_HANDOFF.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/CODEX_HANDOFF.md b/CODEX_HANDOFF.md index cbdd0d3..cf3fc82 100644 --- a/CODEX_HANDOFF.md +++ b/CODEX_HANDOFF.md @@ -6,6 +6,9 @@ Dokumen ini adalah snapshot kerja terakhir untuk melanjutkan project tanpa perlu ## Update Terbaru - 2026-06-08 +- Commit terbaru yang sudah dipush ke `origin/main`: + - `4bbe3f6 Polish device registry identity displays`; + - `67dc286 Improve soundbox ops dashboard and registry editing`. - `soundbox-backend-mqtt-spec.md` sekarang mendokumentasikan device command QF100 category `5` untuk `reboot` dan `poweroff`. - Backend sudah sinkron dengan spec command tersebut: - `POST /admin/devices/{id}/commands` menerima `device.poweroff`; @@ -43,6 +46,27 @@ Dokumen ini adalah snapshot kerja terakhir untuk melanjutkan project tanpa perlu - `node scripts/ui-qa-check.mjs`: pass; - direct script parse `ui/device-registry-monitoring/index.html`: pass; - headless Chrome screenshot desktop/mobile `/ui/soundbox-ops/?preview=1`: pass visual sanity. +- Panduan update server yang benar untuk production/pilot: + - jangan pakai PM2; app server menggunakan Debian 13 + systemd service `qris-soundbox`; + - app directory: `/opt/qris-soundbox`; + - app user: `qrisapp`; + - env file: `/etc/qris-soundbox/qris-soundbox.env`; + - domain utama: `https://sms.bizone.id`. +- Command update server: + +```bash +cd /opt/qris-soundbox +sudo -u qrisapp git pull origin main +sudo -u qrisapp npm ci +sudo -u qrisapp npm run build +sudo -u qrisapp bash -lc 'cd /opt/qris-soundbox && set -a; source /etc/qris-soundbox/qris-soundbox.env; set +a; npm run db:migrate' +sudo systemctl restart qris-soundbox +sudo systemctl status qris-soundbox --no-pager +curl -fsS https://sms.bizone.id/health +curl -fsS https://sms.bizone.id/health/deep +curl -I https://sms.bizone.id/ui/soundbox-ops +journalctl -u qris-soundbox -n 100 --no-pager +``` ## Update Terbaru - 2026-06-07