Redmine Reminders

Notifications

5.0 (0)·New instalações

Lembretes manuais, agendados e por regras para as tarefas que estão ficando para trás — enviados da própria tarefa, de uma consulta salva ou do console de administração, pelo servidor de e-mail que você já usa.

$199 / um servidor

Vários servidores: $399

Reembolso em 5 dias úteis12 meses de atualizaçõesCódigo-fonte incluído

Tipos de lembrete: 3
Modos de destinatário: 4
Agendamentos: Diário · semanal · mensal
Permissões: 4, por projeto
Dados fora do servidor: Nunca

Lembrar o responsável agora

Um botão na página da tarefa. Ele resolve o responsável — na falta dele, o autor e depois um administrador — e o e-mail já saiu antes de a página recarregar.

Lembrar alguém mais tarde

Escolha destinatário, data e uma nota, e o lembrete espera. Se a tarefa for fechada antes dessa data, ele é marcado como ignorado em vez de enviado.

Regras sobre uma consulta salva

Vincule uma regra a qualquer consulta de tarefas: diária, semanal nos dias escolhidos ou mensal nas datas escolhidas, em um horário fixo. As tarefas abertas do resultado recebem lembrete, no máximo uma vez por dia.

Enviar só a contagem

Aponte uma regra para várias consultas e mande os números em vez das tarefas — um pulso constante para quem coordena e quer a ordem de grandeza, não a lista.

Ninguém é cobrado duas vezes

Tarefas fechadas, módulos desativados e contas bloqueadas são filtrados na hora da entrega, e os destinatários são deduplicados antes de sair um único e-mail.

Quatro permissões, por projeto

Ver, gerenciar, enviar e ver estatísticas — concedidas por papel, sobre um módulo de projeto que você pode desligar por completo. Cada envio e cada pulo entra no registro de atividades.

Um clique, uma data ou uma regra

Todo lembrete é armazenado, entregue e registrado do mesmo jeito. O que muda é quem decide quando ele sai: você, agora; você, para uma data futura; ou uma regra que vigia uma consulta salva no seu lugar.

Manual — lembrar o responsável agora

Um botão na página da tarefa. Ele resolve o responsável, recorre ao autor e por fim a um administrador quando não há ninguém atribuído, e o e-mail sai antes de a página recarregar.

Agendado — lembrar alguém mais tarde

Escolha destinatário, data e uma nota, e o lembrete espera. Se a tarefa for fechada antes dessa data, ele é discretamente marcado como ignorado em vez de enviado: a nota falava de um trabalho que não existe mais.

Automático — uma regra sobre uma consulta salva

A consulta que você já mantém é a regra

Não existe uma segunda linguagem de filtros. Uma regra aponta para uma das suas consultas salvas — atrasadas, sem responsável há três dias, chamados de suporte parados — de modo que a definição de «está ficando para trás» continua onde seu time já a mantém. Mude a consulta e todas as regras apoiadas nela acompanham.

Ele vive em três lugares que você já usa

O plugin acrescenta coisas à página da tarefa, ao projeto e ao console de administração — e a nenhum outro lugar. Todas as telas abaixo são um Redmine 6 rodando o Redmine Reminders 1.0.0.

Na tarefa

view_issues_show_description_bottom · aba de histórico

A janela «Novo lembrete» aberta sobre uma tarefa do Redmine, com os campos Destinatário, Data do lembrete e Notas e um botão Criar. — Lembrar mais tarde Destinatário, data, nota — depois ele espera a data.

Uma tarefa do Redmine com a aba Lembretes selecionada, listando um lembrete agendado com horário de criação, tipo, autor, destinatário, situação pendente, data do lembrete e nota. — Aba Lembretes Todos os lembretes da tarefa, com situação e nota.

No projeto

Configurações › Lembretes · menu do projeto

As configurações de um projeto do Redmine com a seção Módulos expandida e a caixa Redmine Reminders marcada ao lado de Gestão de tarefas e Controle de tempo. — Primeiro passo O módulo aparece na lista de módulos do próprio projeto: ligado ou desligado, projeto a projeto.

A aba Lembretes nas configurações do projeto do Redmine: um formulário com assunto, enviar só a contagem, consulta personalizada, notas, destinatário, agendamento, horário e campo ativo, acima de uma tabela com seis regras existentes. — Configurações › Lembretes Monte uma regra a partir de uma consulta salva e acompanhe a tabela de regras — agendamento, destinatários, número de execuções, último resultado.

A página «Meus lembretes» em um projeto do Redmine, listando três lembretes pendentes com sua tarefa, data, autor e nota. — Meus lembretes Os lembretes pendentes de cada pessoa — tarefa, data, quem pediu e por quê.

A página de estatísticas de lembretes do projeto, com as contagens manuais e automáticas ao lado de uma tabela de gargalos por responsável listando usuários e suas tarefas abertas. — Estatísticas de lembretes Contagens por tipo, e tarefas abertas acumuladas por responsável.

No console de administração

Administração › Redmine Reminders

A aba de estatísticas da administração do Redmine Reminders: total de lembretes manuais e automáticos e uma tabela por usuário das notificações, com colunas manual e automático. — Estatísticas de lembretes Quem foi avisado, com que frequência e por qual tipo de lembrete — cada contagem desce até os e-mails exatos.

A aba Lembretes da administração listando uma regra de comunicado personalizada com data de notificação, data de término, agendamento diário, lista de destinatários e estado ativo. — Comunicados Lembretes escritos por administradores, com uma janela de datas.

O formulário de lembretes de gargalo, com nome, descrição, conteúdo do e-mail, datas de notificação e de término, tipo de notificação, horário, um seletor «Usuário bloqueado como» definido em Responsável ou autor, e um seletor de usuários. — Gargalos Vigiar tarefas abertas presas a contas bloqueadas.

Feito para as filas que você já mantém

Os lembretes leem suas consultas salvas, respeitam suas permissões e escrevem tudo o que fazem no próprio registro de atividades.

O que dá para pedir a uma regra
Aspecto	Recurso	Como se comporta
Quem	Responsável, autor, observadores ou uma lista escolhida	Cada regra escolhe seus destinatários. Usuários inativos e usuários sem endereço de e-mail são descartados antes de qualquer envio.
Quando	Diária, semanal ou mensal às HH:MM	Regras semanais escolhem dias da semana, as mensais escolhem datas, e uma data de início e uma de fim delimitam toda a série.
Resumo	Enviar só a contagem	Aponte uma regra para várias consultas e mande os números em vez das tarefas — um pulso constante para quem coordena.
Proteção	Tarefa fechada nunca é cobrada	Tarefas fechadas, módulos de projeto desativados e contas bloqueadas são filtrados na hora da entrega, e não na hora de agendar.
Prova	Um registro de atividades completo	Criado, enviado, ignorado, execução de regra iniciada, execução de regra concluída — cada um com o assunto e o corpo exatos que saíram.
Acesso	Quatro permissões, por projeto	Ver, gerenciar, enviar e ver estatísticas — concedidas por papel, sobre um módulo de projeto que você pode desligar por completo.

Entra um tique do cron, sai um e-mail

Quatro passos, todos dentro do seu Redmine. Nada sai do servidor além do e-mail que sua instância já envia.

Passo	O que acontece
1. O cron dispara	Uma linha de crontab roda rake redmine_reminders:queue, que enfileira um job em segundo plano. Sem nenhum worker rodando, a tarefa síncrona :run faz o mesmo trabalho ali mesmo.
2. As regras se perguntam	Cada regra ativa verifica se é a vez dela: dentro da janela de datas, batendo com o dia da semana ou a data de hoje, passado o horário agendado e ainda não executada hoje.
3. Os destinatários são resolvidos	A consulta roda, as tarefas fechadas caem fora e os destinatários viram usuários reais, ativos e com e-mail. Duplicatas se juntam: ninguém recebe a mesma cobrança duas vezes.
4. Enviar e então registrar	A entrega passa pelo próprio mailer do Redmine, então herda sua configuração de SMTP e os cabeçalhos de e-mail das tarefas. Cada envio — e cada pulo — é escrito no registro de atividades dos lembretes com assunto e corpo.

O que chega na caixa de entrada

Um assunto que carrega o projeto e a tarefa — [Support — #4821] Redmine Reminder: SSO login fails on Safari — sobre um corpo que leva direto de volta à tarefa e cita a nota escrita por quem criou o lembrete. É o mailer da sua instância, sua configuração de SMTP e seu endereço remetente; o plugin não acrescenta nenhum caminho de entrega próprio.

Ninguém é cobrado duas vezes

Um plugin de lembretes se justifica pelo que ele deixa de enviar. Entre uma regra vencida e uma caixa de entrada existem quatro verificações.

Filtrado na entrega, não no agendamento

Tarefas fechadas, projetos com o módulo desligado e contas bloqueadas são reconferidos no instante em que o e-mail vai sair — um chamado resolvido há uma hora já está fora do lote.

Só usuários reais e alcançáveis

Os destinatários são expandidos em contas de verdade e depois caem os usuários inativos e os sem endereço de e-mail. Um grupo de observadores em que metade já saiu da empresa alcança a outra metade.

No máximo uma vez por dia, por regra

Uma regra que já rodou hoje não roda de novo, faça o cron o que fizer. Dentro de uma execução, destinatários repetidos se juntam: quem aparece em três das tarefas encontradas recebe uma única mensagem.

Os pulos também ficam registrados

Um lembrete agendado para uma tarefa que fechou antes é registrado como ignorado, com o motivo. O registro responde a «por que ninguém foi cobrado?» tão bem quanto a «quem foi cobrado?».

Comunicados, gargalos e prova

O console de administração acrescenta as três coisas que só fazem sentido olhando todos os projetos de uma vez.

Comunicar a quem precisa

Escreva assunto e corpo, escolha destinatários e uma janela de datas, e quem entrega é o mesmo agendador que roda as regras. Sem ferramenta de disparo separada, e com o mesmo registro de atividades depois.

Achar as contas que travam

Uma regra vigia toda tarefa aberta atribuída a uma conta bloqueada, ou criada por ela, e manda a lista para quem deve reatribuir o trabalho. Desligamentos param de virar backlog silencioso.

Estatísticas que dizem nomes

Contagens manuais e automáticas por pessoa, no período que você escolher, com detalhamento do assunto e do corpo exatos que cada usuário recebeu. Útil quando alguém diz que nunca foi avisado.

As quatro permissões, atribuíveis por papel
Permissão	O que permite
Ver lembretes	Ver os lembretes e as regras ligados às tarefas de um projeto
Gerenciar lembretes	Criar, editar, pausar e excluir as regras colocadas sobre as consultas salvas de um projeto
Enviar lembretes	Usar o botão manual em uma tarefa e agendar um para mais tarde
Ver estatísticas	Abrir as contagens por pessoa e o registro de atividades por trás delas

Instalação em três passos

Requer acesso por shell e permissão para executar tarefas rake. Sempre faça backup antes de instalar um complemento.

Descompactar na pasta de plugins

cd /path/to/redmine
# the package arrives by email, or from your download link
unzip redmine_reminders-1.0.0.zip -d plugins/
bundle install

Migrar e reiniciar

RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=redmine_reminders
touch tmp/restart.txt   # or systemctl restart redmine

Acrescentar a linha de crontab

# every minute: enqueue due rules and scheduled reminders
* * * * * cd /path/to/redmine && RAILS_ENV=production \
  bundle exec rake redmine_reminders:queue >> log/redmine_reminders_cron.log 2>&1

# no ActiveJob worker? use the synchronous task instead
# bundle exec rake redmine_reminders:run

Precisamos de um worker em segundo plano?

Não. A entrada do cron roda redmine_reminders:queue, que enfileira um ActiveJob e retorna na hora — o formato certo se você já mantém um worker. Se não mantém, aponte a mesma linha do crontab para redmine_reminders:run e o trabalho acontece de forma síncrona naquele processo. As duas tarefas podem rodar a cada minuto sem risco.

O que acontece se a tarefa for fechada antes do lembrete agendado disparar?

Nada é enviado. O lembrete é marcado como ignorado e escrito no registro de atividades com o motivo, então a intenção fica documentada sem ninguém ser cobrado por trabalho já concluído. A mesma checagem vale para os lembretes por regra: tarefas fechadas saem do resultado da consulta na hora da entrega.

Quem realmente recebe um lembrete?

Cada regra escolhe um dos quatro modos de destinatário: o responsável, o autor, os observadores ou uma lista de usuários que você indicar. Os lembretes manuais resolvem primeiro o responsável, depois recorrem ao autor e por fim a um administrador. Em todos os modos, usuários inativos e sem endereço de e-mail são descartados antes da entrega, e destinatários repetidos viram uma única mensagem.

Uma regra pode cobrir várias consultas e mandar só os números?

Pode. Uma regra no modo «somente contagem» pode apontar para várias consultas salvas e envia os totais em vez das tarefas — doze atrasadas, três sem responsável, uma bloqueada — que costuma ser exatamente o que quem lidera quer encontrar na caixa de entrada às nove da manhã.

Alguma coisa passa por um serviço externo?

Não. O e-mail é entregue ao próprio mailer do Redmine, então usa a configuração de SMTP e o endereço remetente que sua instância já tem. Não há serviço externo, não há chave de API para conseguir e não há telemetria: o plugin acrescenta tabelas e tarefas rake, não um caminho de entrega.

Como evitar avalanche de e-mails?

De três formas. Uma regra dispara no máximo uma vez por dia, não importa com que frequência o cron rode; os destinatários são deduplicados dentro de cada execução, então quem aparece em trinta tarefas recebe uma mensagem; e os filtros da hora da entrega tiram tarefas fechadas, módulos desativados e contas bloqueadas antes de endereçar qualquer coisa.

Quem pode criar regras?

Quem você definir. Quatro permissões — ver, gerenciar, enviar e ver estatísticas — são concedidas por papel e só valem onde o módulo Lembretes tiver sido habilitado no projeto. Um projeto que nunca liga o módulo não tem lembretes, nem item de menu, nem regras.

Quais versões do Redmine ele suporta e o que acrescenta ao banco?

Redmine 4.0 e mais recentes, pela API padrão de plugins — nenhum arquivo do core é alterado. Ele acrescenta três tabelas próprias por migrações comuns; desinstalar é remover o diretório do plugin e reverter essas migrações.