Pós-deploy: smoke-test e troubleshooting

Com todos os artefatos publicados, valide a instalação sem gravar dados e confira o funcionamento ponta a ponta.

Smoke-test (scripts/smoke_fase11.cjs)

Rode após o deploy de ds_evento_save e ds_periodo_save, da raiz do repositório:

node scripts/smoke_fase11.cjs

Ele verifica os gates de servidor sem persistir nada:

• (A) via OAuth1, com um usuário fora do grupo de edição: create em ds_evento_save e ds_periodo_save deve retornar ERRO "sem permissão de edição" (gate de grupo).
• (B) via sessão de browser logada como admin (no grupo): ds_evento_save passa do gate de grupo e cai na regra de período ("Não há período aberto…", quando não houver) ou na validação seguinte; ds_periodo_save com acao=close id=999999 retorna "Período não encontrado" (gate de grupo ok, nenhuma gravação).

Resultado esperado: o gate de grupo barra quem está fora; quem está dentro passa e é barrado pelas regras de negócio — nada é gravado.

Checklist ponta a ponta

• Widget carrega no ViewMode (cabeçalho, banners, filtros, calendário).
• Filtros buscam: período + zoom de Marítimo/Centro de Custo (dados do RM).
• Calendário pinta status; férias/afastamento do RM aparecem.
• Período: criar e abrir um período em Configurar períodos.
• Inclusão: com período aberto, incluir um embarque e ver o ciclo pintar.
• Processar Folha: o processo gera o TXT/zip no GED e envia ao DP.
• Alerta 42 dias: o processo agendado dispara o e-mail quando há ocorrência.

Para roteiros detalhados de validação funcional, reaproveite o Roteiro de demonstração do Guia de Uso.

Troubleshooting

Sintoma	Causa provável	Ação
Calendário vazio / sem marítimos	datasets *_rm ou sentenças LOAX ausentes	conferir Integração RM e Datasets
Zoom de Centro de Custo/Porto vazio	falta search de 3+ caracteres	comportamento esperado; digitar 3+ chars
GET datasets retorna items: []	autenticação só por Bearer	usar deploy_dataset.cjs (sessão logada)
Dataset RM com erro de data	data fora de DD-MON-YYYY (Oracle)	usar o formato inglês (ex.: 25-SEP-2025)
Inclusão bloqueada / sem "+"	sem período aberto ou usuário sem grupo edit	abrir período / revisar grupos
ApplicationUpload falha	tokens OAuth1 inválidos	rotacionar tokens do tenant
Processo não gera TXT	ds_folha_movimento_query/ds_pasta_controle_maritimo ou GED	publicar datasets e conferir a pasta do GED
E-mail não sai	sessão de e-mail do servidor / template ausente	configurar e-mail e cadastrar os templates

Conclusão

Com o smoke-test verde e o checklist cumprido, a solução está instalada. Para o uso no dia a dia, encaminhe os usuários ao Guia de Uso.