Production documentation

Tài liệu vận hành MYVMS v2

Tài liệu cho portal console, control plane, recorder HLS, worker AI, license integration, observability và kiến trúc bán Cloud Storage Camera AI.

Cloud Storage Camera AI API reference Runbook CCAI landing

Surface mapv2

Portalvmsclient.vnso.vn

Landingccai.vnso.vn

Core/v2/api, /v2/ws, /v2/hls

AI/ai, /triton, /ai-grafana

Licenselicense.vnso.vn

Bắt đầu tại đây

Các trang chính cho đội vận hành, developer plugin, frontend console và người đi bán pilot.

Cloud Storage Camera AI

Kiến trúc thương mại: cloud-only pilot, hybrid edge, CDN, retention, FinOps và rủi ro pháp lý.

Architecture

Thành phần core, worker, recorder, AI server, Redis, Postgres và Nginx.

API reference

REST, WebSocket, HLS playback, health, metrics và auth scopes.

Runbook

Deploy, reload, smoke test, log commands, rollback và secret rotation.

Plugin development

Mẫu plugin stateless, event schema và cách publish model logic mới.

Theme system

Shared localStorage keys: vms-theme và vms-color-mode.

Báo cáo các page public

Phân tách rõ website, portal, docs, license và observability để không nhầm landing với console.

Domain hoặc path	Vai trò	Nguồn triển khai
`https://ccai.vnso.vn/`	Website / landing page CCAI VMS	`landing/` → `/var/www/html/ccai-landing`
`https://vmsclient.vnso.vn/`	Portal console cho người dùng vận hành	`/var/www/html/vms-client`, không redirect sang landing
`https://vmsclient.vnso.vn/v2/*`	MYVMS-v2 API, WebSocket, HLS, health và status	Nginx proxy vào core `127.0.0.1:28080`
`https://docs-vmsclient.vnso.vn/`	Docs kỹ thuật VMS và Cloud Storage Camera AI	`docs/` → `/var/www/html/docs-vmsclient`
`https://docs-license.vnso.vn/`	Docs License Portal và Turnstile	`docs-license/` → `/var/www/html/docs-license`
`https://license.vnso.vn/`	License authority v1/v2 bridge	Next.js service `vms-license-server`
`https://vmsclient.vnso.vn/ai-grafana/`	Gateway Grafana AI metrics có basic auth	`ai-grafana/` + Nginx proxy tới AI host

Runtime endpoints

Đường dẫn frontend và integration nên dùng trong production.

Contract	Path
List cameras	`GET /v2/api/cameras`
Add camera	`POST /v2/api/cameras`
Query events	`GET /v2/api/events`
Playback timeline	`GET /v2/api/playback/timeline`
Realtime events	`WS /v2/ws/events`
HLS media	`GET /v2/hls/*`

Health checks

Smoke endpoints dùng để xác nhận proxy, core, docs và AI runtime.

curl -fsS https://vmsclient.vnso.vn/v2/health/ready
curl -fsS https://vmsclient.vnso.vn/ai/health
curl -fsS https://license.vnso.vn/api/security-config
curl -fsS https://docs-vmsclient.vnso.vn/version.json