Pular para o conteúdo principal

Administração de períodos (Configurar períodos)

Os períodos de contabilização definem quando a inclusão de eventos fica liberada. Só existe um período aberto por vez, e é ele que habilita o botão "+" no calendário (ver Inclusão de evento). Esta tela é exclusiva do perfil de edição (grupo controle_maritimo_edit).

Como acessar​

Há dois caminhos, dependendo de como o widget está publicado:

  • A partir do ViewMode — com perfil de edição, o botão "Configurar períodos" aparece no topo da tela (ao lado de "Processar Folha"). Ao clicar, o calendário dá lugar à administração de períodos e o próprio botão passa a se chamar "Voltar ao calendário".
  • Pelo EditMode da widget — o modo de edição abre direto na tela "Administração de Períodos", com o subtítulo "Crie e gerencie os períodos de contabilização do Controle Marítimo".

Nos dois casos o conteúdo é o mesmo card Períodos.

Administração de períodos: lista de períodos com intervalo, observação, matrícula e badge "Aberto"

A lista de períodos​

O card Períodos lista os períodos já cadastrados, do mais recente para o mais antigo. Cada item mostra:

  • Intervalo — dd/mm/aaaa até dd/mm/aaaa (em destaque).
  • Badge "Aberto" — selo verde que marca o único período aberto no momento.
  • Observação — o texto informado na criação (quando houver).
  • Matrícula e data/hora — "Matrícula <chapa> · <data/hora da gravação>", identificando quem registrou o período.

À direita de cada linha há uma ação: "Fechar" (no período aberto) ou "Abrir" (nos demais).

Quando ainda não existe nenhum período, o card mostra a mensagem "Nenhum período cadastrado. Use 'Novo período' para criar o primeiro.".

:::note Rolagem / carregar mais A lista carrega em páginas (30 por vez). Ao rolar até o fim, a próxima página é buscada automaticamente; se a rolagem automática não disparar, use o botão "Carregar mais". Quando não há mais o que buscar, aparece "Fim da lista". :::

Abrir e fechar um período​

Clique sobre a linha de um período para alternar o seu estado:

  • Período fechado → ação "Abrir". Como só pode haver um período aberto, abrir este fecha automaticamente o que estava aberto (o próprio botão avisa: "Abrir período de … (fecha o período aberto atual)").
  • Período aberto → ação "Fechar".

Ao concluir, o sistema mostra um toast — "Período aberto." ou "Período fechado." — e recarrega a lista para refletir o estado real (inclusive a regra de período único). Enquanto a gravação está em curso, as ações ficam desabilitadas.

:::tip Por que isso importa Sem período aberto, o botão "+" não aparece em nenhuma célula e a inclusão de eventos fica indisponível. Abrir o período correto é o que libera os lançamentos do mês. :::

Criar um novo período​

Clique em "Novo período" para abrir o modal de criação:

Modal &quot;Novo período&quot;: Data inicial, Data final, Observação e o switch &quot;Abrir período&quot;

  1. Data inicial e Data final — campos de calendário (formato DD/MM/AAAA).
  2. Observação — texto livre (opcional), útil para identificar o período (ex.: "Folha de maio/2026").
  3. Abrir período (fecha o período aberto atual) — switch opcional. Marcado, o novo período já nasce aberto e fecha o que estava aberto antes.
  4. No rodapé, Cancelar ou Salvar.

Validações​

SituaçãoMensagem
Falta a data inicial ou a data final"Informe a data inicial e a data final do período."
Data final anterior à inicial"A data final deve ser maior ou igual à data inicial."
Intervalo se sobrepõe a um período já existente"O período se sobrepõe a um período existente."

As duas primeiras são verificadas no próprio modal (toast amarelo) antes de salvar. A sobreposição é checada contra os períodos já carregados e, principalmente, confirmada pelo servidor — se houver conflito, a criação é recusada com toast e a lista permanece como estava.

Ao criar com sucesso, aparece o toast "Período criado com sucesso." e a lista é recarregada. Se a gravação falhar por outro motivo, o sistema exibe "Não foi possível gravar o período. Tente novamente.".

:::note Sem limite de 2 meses aqui O limite de 2 meses vale apenas para o filtro de busca do calendário (ver Filtros e busca). O período de contabilização pode ter qualquer intervalo, desde que a data final seja maior ou igual à inicial. :::

Próximos passos​