m

docker/README.md

@@ -67,16 +67,27 @@ docker compose -f docker/docker-compose.yml exec app composer install
 
 ### 4.2. Khi cập nhật giao diện (CSS / JS / Tailwind classes mới)
 
-Do Docker container không cài Node.js, bạn cần chạy các lệnh compile frontend trực tiếp **ở máy thật (host)**:
+Cập nhật giao diện cần biên dịch lại tài nguyên frontend. Bạn có 2 cách:
 
-- **Chạy chế độ phát triển (Hot Reload):**
-    ```bash
-    npm run dev
-    ```
-- **Build production tĩnh:**
-    ```bash
-    npm run build
-    ```
+**1️⃣ Chạy trên máy host (đề xuất)**
+```bash
+npm install   # một lần, nếu chưa có các package
+npm run dev   # Vite dev server, hot‑reload
+```
+
+**2️⃣ Chạy trong Docker (sử dụng container `node`)**
+```bash
+# Cài đặt các package (chỉ chạy 1 lần)
+docker compose -f docker/docker-compose.yml exec node npm install
+
+# Chế độ phát triển (hot‑reload)
+docker compose -f docker/docker-compose.yml exec node npm run dev
+
+# Hoặc biên dịch bản production
+docker compose -f docker/docker-compose.yml exec node npm run build
+```
+
+Container `node` đã expose port **5173**, cho phép truy cập Vite dev server tại `http://localhost:5173`. Khi `npm run dev` đang chạy, mọi thay đổi CSS/JS sẽ tự động cập nhật trong container `app` nhờ volume mount.
 
 ### 4.3. Khi cập nhật Database (Migrations)