docs: esclarecer build do frontend via docker no VPS

README.md

@@ -28,13 +28,29 @@ ng generate --help
 
 ## Building
 
+### Local (com Node instalado)
+
 To build the project run:
 
 ```bash
-ng build
+npm run build
 ```
 
-This will compile your project and store the build artifacts in the `dist/` directory. By default, the production build optimizes your application for performance and speed.
+### VPS/Servidor sem Node no host (recomendado neste projeto)
+
+Execute o build **dentro do container Docker do frontend**:
+
+```bash
+docker compose -f docker-compose.frontend.yml run --rm frontend-builder
+```
+
+Se quiser rodar exatamente o comando `npm run build` dentro do container:
+
+```bash
+docker compose -f docker-compose.frontend.yml run --rm frontend-builder sh -lc "npm run build"
+```
+
+Os artefatos serão gerados em `dist/line-gestao-frontend`.
 
 ## Running unit tests
 

docs/DEPLOY_VPS.md

@@ -47,9 +47,12 @@ export const environment = {
 };
 EOT
 
-# 3) build de produção via container Node
+# 3) build de produção via container Node (não rodar npm no host)
 docker compose -f docker-compose.frontend.yml run --rm frontend-builder
 
+# opcional: equivalente a executar `npm run build` dentro do container
+# docker compose -f docker-compose.frontend.yml run --rm frontend-builder sh -lc "npm run build"
+
 # 4) validar saída estática
 ls -lah dist/line-gestao-frontend/browser
 ```