Glossário de status e regras de cálculo
Esta página reúne o significado de cada status do calendário e as regras de cálculo que o sistema usa para projetar embarque, folga e dobra. As regras vêm da especificação do processo (MIT098 — §Resumo) e do motor de cálculo do widget.
Glossário de status
São 12 status, exibidos na legenda sempre nesta ordem (ver Calendário — leitura de status):
| Status | Cor | Significado | Origem |
|---|---|---|---|
| Disponível | verde | Em terra e disponível para trabalho — não está em folga, férias, afastamento nem embarcado. | Automático |
| Folga | azul | Descanso calculado automaticamente a partir dos embarques registrados. | Automático |
| Hotel | roxo | Hospedagem no porto de embarque, antes do embarque; conta como embarque, independente da quantidade de dias. | Inclusão |
| Embarcado | laranja | A bordo, dentro do ciclo de 42 dias. | Inclusão (Embarque) |
| Dobra | laranja escuro | Dias embarcados que excedem 42 dentro do período de contabilização. | Automático |
| Férias | amarelo | Férias do colaborador. | Importado do RM |
| Afastamento | vermelho | Afastamento do colaborador. | Importado do RM |
| Curso | ciano | Curso/treinamento; gera evento de folha quando o marítimo está em folga/disponível ("Curso em folga"). Lançado com o marítimo embarcado (Embarcado, Dobra ou Hotel), não gera folha. | Inclusão |
| ASO | azul | Atestado de Saúde Ocupacional; pode ou não gerar evento de folha. Lançado com o marítimo embarcado (Embarcado, Dobra ou Hotel), não gera folha. | Inclusão |
| Geral | cinza | Demais eventos do RM (prêmio, falta, suspensão, ajuda de custo, etc.). | Inclusão |
| Desembarque | verde-azulado | Saída de bordo; o horário define se o dia conta como folga ou embarque. | Inclusão |
| Troca CC | índigo | Troca de Centro de Custo durante o embarque. | Inclusão |
:::info "Folga indenizada" não é um status A folga indenizada não tem pill própria no calendário — é um tratamento interno (ver a regra Sindimar abaixo) que gera apenas um evento de folha (códigos 0705/0333 no RM). :::
:::note Status de base e eventos sobrepostos Disponível, Folga, Hotel, Embarcado e Dobra são o status de base do dia: vêm do ciclo de embarques e decidem as ações do "+". Curso, ASO, Geral e Troca CC são eventos lançados que se sobrepõem ao dia: a célula mostra a cor deles e o rótulo traz os dois nomes (ex.: "Embarcado · Curso"). Férias e Afastamento (RM) também se sobrepõem, mas aparecem só com o próprio nome e sem ações. Ver Calendário — leitura de status. :::
O ciclo marítimo (42 + 42)
A regra-base do controle, resumida no banner Ciclo Marítimo no topo da tela:
- Ciclo padrão: 42 dias embarcado + 42 dias de folga.
- Teto de embarque: ao chegar a 42 dias embarcados no período de contabilização, os dias excedentes viram Dobra.
- Teto de folga: a folga prevista é limitada a 42 dias, mesmo quando houve dobra.
- Embarque menor que 42 dias: a folga prevista é igual ao número de dias embarcados (ex.: 30 dias embarcado → 30 dias de folga).
Hotel e Desembarque
- Hotel — a hospedagem no porto de embarque contabiliza como embarque, independente da quantidade de dias: cada dia de hotel lançado antes do Embarque conta como dia embarcado. Os dias de hotel seguidos, até o dia anterior ao Embarque, são os primeiros dias do embarque e entram na quantidade de dias informada (regra 9 da MIT041, "O dia de hotel será contabilizado como o primeiro dia de embarque", aplicada a todos eles; decisão do cliente de 06/10/2026, item 15 do relatório). Exemplo: hotel de 01/10 a 03/10 e Embarque em 04/10 com 42 dias → embarcado de 01/10 a 11/11, sem dobra. Um dia de hotel sem Embarque nem outro hotel no dia seguinte (ex.: o marítimo voltou para casa por um dia antes de embarcar) continua contando como dia embarcado, mas não abre intervalo em terra: não gera folga indenizada, continuidade Sindimar nem dobra no embarque seguinte (divergência D7).
- Desembarque — o horário informado decide como o próprio dia é contabilizado:
- Até 18:00 → o dia já conta como 1º dia de folga.
- A partir de 18:01 → o dia ainda conta como embarcado (ou dobra), e a folga começa no dia seguinte.
Regra Sindimar (continuidade e folga indenizada)
Quando o marítimo reembarca antes de terminar a folga, a quantidade de dias em terra define o tratamento (regra do sindicato — código 0011):
- Reembarque em até 7 dias de terra → os dias em terra contam como embarcados (a contagem não zera: é uma continuidade do embarque anterior).
- Reembarque com mais de 7 dias de terra → quebra a continuidade e os primeiros dias do novo embarque viram folga indenizada (evento de folha 0705/0333), sem pill no calendário.
Exemplos numéricos (MIT098 — §Resumo)
| Cenário | Resultado | Regra aplicada |
|---|---|---|
| 10 embarcado + 5 folga + 30 reembarque | 45 dias → 42 normais + 3 de dobra | reembarque ≤ 7 dias = continuidade; excedeu 42 → dobra |
| 10 + 5 folga + 27 reembarque | 42 dias de embarque normal (sem dobra) | continuidade; total exatamente no teto |
| 10 + 8 folga + reembarque | os 2 primeiros dias do novo embarque viram folga indenizada | folga > 7 dias quebra a continuidade |
| 10 + 10 terra + reembarque | regra especial não se aplica → cálculo padrão (dobra só se exceder o ciclo) | sem continuidade |
| Embarque único de 50 dias | 42 + 8 de dobra; folga limitada a 42 | excedeu 42 → dobra; teto de folga |
| Embarque único de 30 dias | folga prevista de 30 dias | embarque < 42 → folga = dias embarcados |
Eventos de folha do RM (ação Geral)
A ação Geral lança eventos do RM que não têm status próprio. Alguns exigem o campo Valor; outros são tratados automaticamente pelo sistema e não aparecem na lista de "Geral":
- Exigem Valor: 328 Prêmio, 366 Diária de viagem exterior, 422 Prêmio inspeção, 539 Gratificação especial.
- Têm tratamento próprio (fora da lista "Geral"): 0307/0331 dobras, 0705/0333 folgas indenizadas, 537/0537 lançamentos de meses anteriores (ASO/curso).
Veja o passo a passo de preenchimento em Inclusão de evento.
Próximos passos
- Para executar uma demonstração completa do sistema, siga o Roteiro de cenários de teste.
- Para revisar a leitura do calendário, volte a Calendário — leitura de status.