b.santos/bot-pontos
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs

Browse Source
This commit is contained in:
Bruno Santos
2026-11-05 22:31:13 -03:00
parent f0560b1be4
commit e6603f2cb9
3 changed files with 85 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/MANUAL_USUARIO.md
View File

@@ -242,7 +242,7 @@ Faixas de alerta aparecem no topo quando:
- **a PontoMais está fora do ar:** ninguém é pausado; aguarde;
- **os feriados do ano não foram obtidos:** segunda a sexta estão valendo como dias úteis. Cadastre os feriados manualmente se precisar.
Os números são clicáveis e levam à lista filtrada.
A maioria dos números é clicável e leva à lista filtrada. Uma conta de leitura ligada a um usuário não vê esses contadores, só os avisos e os próprios lembretes de hoje.
## Aprovar um novo usuário
@@ -265,9 +265,9 @@ Quando alguém envia `/cadastrar`, os admins do bot recebem um aviso no Telegram
| Botão | O que faz |
| --- | --- |
| **Ativar** | Aprova o cadastro (exige credencial validada) |
| **Desativar** | Bloqueia o uso do bot e cancela os lembretes agendados. Não apaga o histórico |
| **Desativar** | Bloqueia o uso do bot e cancela os lembretes agendados. A pessoa recebe no Telegram o aviso de que o acesso foi desativado. Não apaga o histórico |
| **Ligar lembretes** | Liga os lembretes, zera o contador de falhas e retoma o dia, se ele estava "sem pontos" |
| **Pausar lembretes** | Desliga os lembretes e cancela os agendados. O `/status` do usuário mostra "pausado pelo painel" |
| **Pausar lembretes** | Desliga os lembretes e cancela os agendados. O `/status` do usuário mostra "pausados (por um administrador)" |
| **Tornar admin do bot** / **Remover admin do bot** | Define quem recebe os avisos operacionais no Telegram |
| **Retomar consultas de hoje** | Aparece quando o dia está "sem pontos". Volta a consultar até o fim da janela |
@@ -325,7 +325,7 @@ Ações:
- **Cancelar:** só para lembretes **agendados**.
- **Reenviar:** só para lembretes que **falharam** e são **do dia de hoje**.
- O usuário precisa estar ativo e com os lembretes ligados.
- Se o ponto seguinte já foi batido, o reenvio é bloqueado.
- Antes de reenviar, o sistema consulta a PontoMais. Se o ponto seguinte já foi batido, o reenvio é bloqueado; se a PontoMais não responder, tente de novo em alguns minutos.
- Atenção: se a falha foi um travamento no meio do envio, a pessoa **pode já ter recebido** a mensagem original. O painel pergunta antes de reenviar.
Lembretes **expirados** não podem ser reenviados.
@@ -334,7 +334,7 @@ Lembretes **expirados** não podem ser reenviados.
Registra quem fez o quê e quando: cadastros, ativações, mudanças de jornada e de credencial, envios, falhas, pausas, logins, alterações de configuração etc.
Filtre por período, origem (Telegram, painel, worker, terminal), tipo de evento e resultado. A partir da tela de um usuário, o link **Auditoria deste usuário** já abre filtrado. Use **Mais antigos →** para paginar.
Filtre por período, origem (Telegram, painel, worker, terminal), tipo de evento e resultado. O campo **Evento** precisa do nome exato, como aparece na coluna (ex.: `user_activated`, `notification_expired`, `web_login_failed`); a lista completa está na seção 18 do [documento de arquitetura](ARQUITETURA.md#18-referência-eventos-de-auditoria). A partir da tela de um usuário, o link **Auditoria deste usuário** já abre filtrado. Use **Mais antigos →** para paginar.
Senhas e tokens nunca aparecem na auditoria.