Calendário — Guia do usuário

Para que serve o módulo «Calendário»

Um calendário completo dentro do YoBench: eventos, agendas recorrentes, importação e assinaturas iCalendar (.ics), lembretes e calendários de trabalho com feriados. Integrado ao Rastreador de tarefas — tarefas com prazo aparecem na linha do tempo.

O que você obtém:

Cinco visualizações — Ano, Mês, Semana, Dia, Agenda.
Recorrências flexíveis — diária, dias úteis, semanal (com dias escolhidos), mensal, anual ou intervalo personalizado.
Importação/exportação ICS — abrir calendários de terceiros ou exportar os seus.
Assinaturas de URLs ICS externas com auto-sync.
Lembretes do sistema — em 0/5/15/30/60/120/1440 minutos antes do evento.
Calendário de trabalho russo — dados de consultant.ru: útil / fim de semana / feriado / dia reduzido.
Tarefas do tracker — renderizadas na mesma linha do tempo por due_date.

Parâmetros do evento

Ao criar ou editar:

Título (obrigatório).
Descrição (opcional).
Data e hora de início / fim ou flag Dia inteiro.
Cor — HEX (padrão #3b82f6).
Categoria — trabalho / pessoal / reunião / aniversário / sem categoria.
Local/link — texto ou URL.
Status — confirmado / tentativo / cancelado.
Ocupado — flag de ocupação (para visão livre/ocupado).
Bloco de foco — marcação focus-time.
Lembretes — lista de minutos-antes: 0 (no momento do evento), 5, 15, 30, 60, 120, 1440 (um dia).
Recorrência — regra de repetição (ver abaixo).

Eventos recorrentes

Sem RRULE — um formato JSON simples:

Tipo: daily, weekdays, weekly (escolhe dias), monthly, yearly, custom.
Intervalo/unidade para custom — por exemplo, a cada duas semanas (unit: weeks, interval: 2).
Fim: nunca / por data / após N ocorrências.

As ocorrências virtuais são expandidas no ar ao renderizar uma faixa.

iCalendar (.ics)

Importar arquivo — escolha um .ics; eventos são deduplicados por external_uid.
Exportar — exporta eventos do ano atual em .ics (via ical-generator).
Assinaturas por URL — adicione uma URL com auth Basic opcional. O calendário é consultado automaticamente em um intervalo (padrão 60 minutos). Eventos removidos na origem também são removidos do YoBench.

Calendários de trabalho

Está conectado o provedor ru1 — calendário de trabalho russo via dados abertos do consultant.ru. Tipos de dia:

working — dia útil
weekend — fim de semana
holiday — feriado
short — dia reduzido

Usado para calcular horas trabalhadas e destacar dias não úteis nas visualizações Ano/Mês.

A arquitetura é extensível — provedores para outros países podem ser adicionados depois.

Lembretes

Pré-ajustes no formulário: 0, 5, 15, 30, 60, 120, 1440 minutos antes do evento. Quando chega a hora, é postada uma notificação do sistema operacional pelo serviço de notificações do YoBench. Canais Telegram/e-mail não são usados para lembretes do calendário.

Controlado pela flag Notificações do calendário (calendarNotificationsEnabled, ligada por padrão).

Integração com o tracker

A linha do tempo do calendário renderiza não só eventos, mas também tarefas do Tracker que possuem due_date. Clicar em uma tarefa abre seu detalhe no Tracker.

Configurações globais do módulo

Em Configurações → Calendário:

Notificações do calendário (calendarNotificationsEnabled) — liga/desliga os lembretes.
Intervalo de sync das assinaturas ICS (calendarIcalSyncIntervalMinutes) — padrão 60 minutos.
O último ano aberto e o provedor de calendário de trabalho selecionado também ficam salvos.

Fluxo de uso

1. Crie um evento

Abra Calendário no menu lateral esquerdo.
Clique em uma célula de dia vazia ou em + Evento.
Preencha título, hora, descrição.
Opcionalmente configure recorrência e lembretes.
Salve.

2. Mude de visualização

No cabeçalho do calendário — alternador Ano / Mês / Semana / Dia / Agenda.

3. Arraste e redimensione

Arraste o cartão de um evento para outra data/hora. Arraste a borda inferior para mudar a duração.

4. Conecte um calendário externo

Na seção Assinaturas, adicione a URL ICS e (se necessário) credenciais. Clique em Sincronizar agora ou aguarde o auto-sync.

5. Import/export

Importar ICS — botão Importar, escolha um arquivo. A deduplicação por UID evita duplicatas.
Exportar ICS — botão Exportar, salva os eventos do ano atual.

6. Ative o calendário de trabalho

Em configurações escolha o provedor ru1 — dias não úteis ficam destacados e feriados aparecem nas visualizações Mês/Ano.

Próximos passos

Conecte o Rastreador de tarefas — prazos aparecem automaticamente na linha do tempo.
Use Email se quer criar eventos a partir de mensagens.

Ajuda e feedback

Quer um calendário de trabalho de outro país ou suporte a RRULE? Escreva para nós pelo formulário de contato.