Document Debian deploy update steps

This commit is contained in:
Wira Basalamah
2026-06-08 16:19:52 +07:00
parent 4bbe3f6807
commit fdc3e15a36

View File

@ -6,6 +6,9 @@ Dokumen ini adalah snapshot kerja terakhir untuk melanjutkan project tanpa perlu
## Update Terbaru - 2026-06-08 ## 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`. - `soundbox-backend-mqtt-spec.md` sekarang mendokumentasikan device command QF100 category `5` untuk `reboot` dan `poweroff`.
- Backend sudah sinkron dengan spec command tersebut: - Backend sudah sinkron dengan spec command tersebut:
- `POST /admin/devices/{id}/commands` menerima `device.poweroff`; - `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; - `node scripts/ui-qa-check.mjs`: pass;
- direct script parse `ui/device-registry-monitoring/index.html`: pass; - direct script parse `ui/device-registry-monitoring/index.html`: pass;
- headless Chrome screenshot desktop/mobile `/ui/soundbox-ops/?preview=1`: pass visual sanity. - 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 ## Update Terbaru - 2026-06-07