#Scripts da raiz
| Comando | Finalidade |
|---|---|
npm run setup | Instala raiz/web e compila tudo. |
npm run build | Backend TypeScript → dist/. |
npm run build:web | TypeScript da interface e SPA Vite. |
npm run build:all | Backend e interface. |
npm start | CLI compilado; bind padrão 0.0.0.0. |
npm run typecheck | Tipos da raiz sem emissão. |
npm test | Suíte Vitest configurada, incluindo testes encontrados em tests/. |
npm run test:e2e | Dois arquivos de smoke/frontend e controle de workspace definidos no script; não todos os testes de tests/e2e/. |
npm run test:watch | Vitest em acompanhamento. |
npm run test:coverage | Cobertura; pode exigir provider compatível com a versão do Vitest. |
npm run prepublishOnly | Hook de compilação pré-publicação; não publica sozinho. |
#Desenvolvimento da interface
Depois de npm run setup, use dois terminais na raiz. Backend:
node bin/cockpit.js --host 127.0.0.1 --port 4000 --headless --no-open
Vite:
npm --prefix web run dev
Abra http://localhost:5173. O proxy encaminha /api e /ws para 127.0.0.1:4000; mudar a porta exige ajustar web/vite.config.ts. Mudanças no backend exigem npm run build e reinício; não há script de watch do backend declarado.
Outros scripts web:
npm --prefix web run build
npm --prefix web run preview
Preview serve a SPA compilada e não substitui backend; o proxy acima pertence ao servidor de desenvolvimento.
#Verificações
npm run typecheck
npm run build:all
npx playwright install chromium
npm run test:e2e
Testes de navegador precisam do Chromium do Playwright. No Linux, se faltarem bibliotecas do sistema, use npx playwright install --with-deps chromium em ambiente com permissão para instalar dependências.
Para selecionar suítes:
npx vitest run tests/unit
npx vitest run tests/integration
npx vitest run tests/e2e
Alguns testes criam servidores, processos e repositórios temporários. Leia a suíte antes de adaptar o ambiente. A presença dos testes não comprova homologação de todos eles no Windows nativo/macOS.
Gerador de relatório:
node scripts/generate-compliance-report.js
O script grava .cockpit/compliance/audit-report.json e .cockpit/compliance/audit-report.md. Ele monta um relatório com checks declarados como aprovados e metadados predefinidos; não executa os testes. Gerar o relatório não comprova conformidade da revisão atual. Execute as verificações relevantes separadamente e confira o script antes de automatizar.