Pré-requisitos e ambiente

Antes de publicar qualquer artefato, garanta o ambiente do tenant e a estação de trabalho que vai rodar os scripts de deploy.

No tenant Fluig

Item	Detalhe
Acesso administrador	usuário com permissão para publicar widget, datasets, listas, formulários e processos
Grupos	controle_maritimo_view e controle_maritimo_edit criados (ver Segurança e grupos)
Datasource MySQL	AppDS/FluigDS (MySQL 8) e, se aplicável, FluigDSRO (réplica read-only)
Conector RM (SOAP)	serviço RealizarConsultaSQL (WSConsultaSQL) acessível, com as sentenças LOAX cadastradas (ver Integração RM)

:::note Datasources (JNDI) Apenas o prefixo java:/jdbc/<nome> resolve neste tenant (java:jboss/datasources/... e java:comp/env/jdbc/... falham). AppDS/FluigDS apontam para MySQL 8.0.34; como o MySQL roda em Linux, nomes de tabela são case-sensitive (as listas geram tabelas ML001<id>). :::

Na estação que roda o deploy

Ferramenta	Versão / observação	Usado para
Node.js	>= 20 (o build do widget usa Node v22.19.0, instalado automaticamente pelo Maven)	scripts de dataset, build da vue-app
JDK + Maven	JDK 11+ e Maven	mvn clean install do widget
Python 3	com requests e requests_oauthlib	deploy.py (upload do .war)
Playwright / Chromium	já instalado na vue-app (@playwright/test)	deploy_dataset.cjs e smoke_fase11.cjs (sessão logada)

Instale as dependências Python uma vez:

pip install requests requests_oauthlib

Credenciais e .env.local

Os scripts de dataset leem o arquivo wcm/widget/wd_controle_maritimo/src/main/vue-app/.env.local:

FLUIG_SERVER_URL=<TENANT_URL>          # ex.: https://<tenant>.fluig.cloudtotvs.com.br:1250
FLUIG_ADMIN_USER=<ADMIN_USER>
FLUIG_ADMIN_PASS=<ADMIN_PASS>

O deploy.py (upload do widget) usa autenticação OAuth1 com CONSUMER_KEY/CONSUMER_SECRET/ACCESS_TOKEN/TOKEN_SECRET e a SERVER_URL.

:::danger Segredos Hoje esses tokens estão hardcoded no deploy.py. Antes de qualquer publicação real: rotacione os tokens no painel de apps do Fluig, mantenha-os fora do versionamento (ex.: variáveis de ambiente ou um arquivo ignorado pelo git) e nunca os exponha em documentação ou prints. O mesmo vale para FLUIG_ADMIN_USER/FLUIG_ADMIN_PASS do .env.local. :::

Verificação do ambiente

• node -v ≥ 20, mvn -v e python --version respondem.
• .env.local preenchido com a URL e o admin do tenant alvo.
• Login manual no portal Fluig funciona com FLUIG_ADMIN_USER/FLUIG_ADMIN_PASS.
• Datasources e conector RM ativos (testar uma sentença LOAX no console do RM).

Com o ambiente pronto, siga para o build e deploy do widget — ou, num tenant novo, comece pela infra na ordem descrita na visão geral.