client

web-client/README.md

@@ -0,0 +1,41 @@
+# Robot Installer Web Client
+
+Web Client public cho user cài, cập nhật và gỡ app thông qua Local Installer Agent.
+
+## Chạy local
+
+```bash
+npm install
+npm run dev
+```
+
+Mặc định khi chạy dev, client gọi package server qua Vite proxy:
+
+```text
+robot.package API: http://localhost:5173/api -> http://localhost:3000/api
+Local Agent:       http://127.0.0.1:5010
+```
+
+Có thể đổi trong UI hoặc qua `.env`:
+
+```env
+VITE_PACKAGE_BASE_URL=
+VITE_AGENT_BASE_URL=http://127.0.0.1:5010
+PACKAGE_PROXY_TARGET=http://localhost:3000
+```
+
+Khi deploy `robot.installer` thật, đặt `VITE_PACKAGE_BASE_URL=https://robot.package` để browser gọi thẳng package server.
+
+## Test thật
+
+1. Chạy `web-server` tại `http://localhost:3000`.
+2. Chạy hoặc cài Local Installer Agent tại `http://127.0.0.1:5010`.
+3. Khi test local, Agent nên có:
+
+```env
+ROBOT_PACKAGE_BASE_URL=http://localhost:3000
+ALLOWED_ORIGINS=http://localhost:5173,http://localhost:4173
+ALLOWED_DOWNLOAD_HOSTS=localhost,127.0.0.1
+```
+
+4. Mở Web Client, bấm `Retry`, chọn app đã `Released`, rồi bấm `Install`.