Emanuel Almeida
2cb3210962
Plugins: automacao, crm-ops, design-media, dev-tools, gestao, infraestrutura, marketing, negocio, perfex-dev, project-manager, wordpress + hello-plugin (existente). Totais: 83 skills, 44 agents, 12 datasets.json Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
467 lines
13 KiB
Markdown
467 lines
13 KiB
Markdown
---
|
|
name: today
|
|
description: >
|
|
Checkup diário v7.5 - IMAP triaging, auto-despesas, Obsidian note, Supabase.
|
|
Triagem emails 12 contas IMAP + tickets CRM + despesas auto + nota diaria.
|
|
Use when "checkup", "hoje", "today", "rotina", início de dia.
|
|
author: Descomplicar® Crescimento Digital
|
|
version: 7.5.0
|
|
quality_score: 92
|
|
user_invocable: true
|
|
category: productivity
|
|
tags: [rotina, checkup, dashboard, crm, tickets, invoices, timer, monday, saturday, imap, email]
|
|
desk_task: 1416
|
|
desk_project: 65
|
|
allowed-tools: Read, Write, mcp__desk-crm-v3, mcp__mcp-time, mcp__google-workspace, mcp__imap, mcp__memory-supabase
|
|
mcps: desk-crm-v3, mcp-time, google-workspace, imap, memory-supabase
|
|
dependencies:
|
|
skills: [ticket, invoice, time, crm, wp-update, cleanup-downloads]
|
|
---
|
|
|
|
# /today v7.5 - Checkup Diário
|
|
|
|
Hub central que orquestra skills Desk + IMAP para visao completa do dia.
|
|
|
|
---
|
|
|
|
## Protocolo Principal
|
|
|
|
> **REGRA FUNDAMENTAL:** Fases 1-2 sao SILENCIOSAS e OBRIGATORIAS.
|
|
> Executar TUDO antes de mostrar qualquer output ao utilizador.
|
|
> O utilizador so ve o resumo final com as accoes ja tomadas.
|
|
|
|
```
|
|
FASE 1 - SILENCIOSA (executar tudo, sem output)
|
|
1. mcp__mcp-time__current_time → Verificar dia da semana
|
|
2. Verificar ultima execucao (memory-supabase: "today checkup YYYY-MM-DD")
|
|
3. AUTO-PROCESSAR despesas de tickets (ver seccao Auto-Process)
|
|
4. AUTO-FECHAR Tickets SPAM
|
|
5. IMAP Triagem - 12 contas (ver seccao IMAP abaixo)
|
|
6. Limpeza Downloads (via /cleanup-downloads) → SE >10 ficheiros
|
|
|
|
FASE 2 - RECOLHA (queries em paralelo, sem output)
|
|
7. Timer Activo
|
|
8. Tickets abertos (status 1,2,3)
|
|
9. Facturas Vencidas
|
|
10. Tarefas Prioritarias (urgentes + alta + vencidas)
|
|
11. Leads Novos (status 7, 14)
|
|
12. Propostas pendentes (status 4)
|
|
13. Agenda do Dia (Google Calendar)
|
|
|
|
FASE 3 - OUTPUT + PERSISTENCIA
|
|
14. Resumo do auto-processamento (despesas, SPAM, emails)
|
|
15. Notificacoes de sistema que requerem revisao manual
|
|
16. Dashboard (timer, tickets, facturas, tarefas, leads, agenda)
|
|
17. 3 Prioridades do dia
|
|
18. SE SEGUNDA → Planeamento semanal + /wp-update
|
|
19. SE SEXTA → Sugerir manutencao WordPress
|
|
20. SE SABADO → Consolidacao memorias
|
|
21. Criar nota Obsidian (Passo 9)
|
|
22. Guardar em Supabase (Passo 10)
|
|
```
|
|
|
|
---
|
|
|
|
## Secções do Checkup
|
|
|
|
### 1. Timer Activo
|
|
|
|
```
|
|
Verificar ~/.claude-work/active-timer.json
|
|
Se activo:
|
|
🟢 Timer: #1446 - Documentação (2h 15m)
|
|
⚠️ Se >4h: "Timer activo há muito tempo!"
|
|
```
|
|
|
|
### 2. Tickets Abertos
|
|
|
|
```
|
|
mcp__desk-crm-v3__get_tickets({ status: [1,2,3] })
|
|
|
|
## 🎫 Tickets (4)
|
|
🔴 #234 - Erro login (TechCorp) - 2h
|
|
🟠 #232 - Bug funcionalidade (StartupX) - 1d
|
|
🟢 #230 - Dúvida (ClienteY) - 2d
|
|
```
|
|
|
|
### 3. Facturas Vencidas
|
|
|
|
```
|
|
mcp__desk-crm-v3__overdue_invoices_report()
|
|
|
|
## 💰 Facturas Vencidas (2)
|
|
| # | Cliente | Valor | Dias |
|
|
|---|---------|-------|------|
|
|
| INV-040 | OldClient | €950 | 15 |
|
|
| INV-038 | SlowPay | €2.100 | 22 |
|
|
**Total:** €3.050
|
|
```
|
|
|
|
### 4. Tarefas Prioritárias
|
|
|
|
```
|
|
mcp__desk-crm-v3__get_tasks({ status: [1,4], priority: [3,4] })
|
|
|
|
## 📋 Tarefas Prioritárias (5)
|
|
🔴 Urgentes
|
|
| # | Tarefa | Projecto | Deadline |
|
|
|---|--------|----------|----------|
|
|
| #1450 | Implementar API | SFV-360 | Hoje |
|
|
|
|
🟠 Alta
|
|
| # | Tarefa | Projecto | Deadline |
|
|
|---|--------|----------|----------|
|
|
| #1448 | Documentação | Stack | Amanhã |
|
|
```
|
|
|
|
### 5. Agenda do Dia
|
|
|
|
```
|
|
mcp__google-workspace__get_events({
|
|
user_google_email: "emanuelalmeidaa@gmail.com",
|
|
time_min: "hoje 00:00",
|
|
time_max: "hoje 23:59"
|
|
})
|
|
|
|
## 📅 Agenda Hoje
|
|
- 10:00 - Reunião Cliente X
|
|
- 14:30 - Call Equipa
|
|
```
|
|
|
|
---
|
|
|
|
## IMAP Triagem (FASE 1 - Passo 5)
|
|
|
|
> **OBRIGATORIO:** Processar 12 contas IMAP silenciosamente.
|
|
> Ver regras detalhadas em `config/email-triage-rules.md`
|
|
|
|
### Contas IMAP (12)
|
|
|
|
```
|
|
emanuel, it, help, suporte, contabilidade, financeiro,
|
|
info, rh, mkt, design, news, aiktop
|
|
```
|
|
|
|
### Para cada conta: imap_list_emails(account, folder="INBOX", limit=50)
|
|
|
|
```
|
|
Classificar cada email por ordem de prioridade:
|
|
|
|
1. SPAM → imap_delete_email(account, uid)
|
|
- Subject: lottery, winner, urgent money, bitcoin investment
|
|
- Remetente: *.ru, *.cn (excepto conhecidos)
|
|
- Subject todo em MAIUSCULAS
|
|
|
|
2. PROMOCIONAL → imap_move_email(account, uid, "Promotions")
|
|
- Subject: newsletter, promo, desconto, oferta
|
|
- Remetente: *@marketing.*, *@news.*, *@promo.*
|
|
|
|
3. FACTURA/RECIBO → Registar para contabilidade
|
|
- Subject: factura, invoice, recibo, receipt, pagamento, paid
|
|
- Remetente de servico conhecido (ver mapeamento abaixo)
|
|
- Registar para reencaminhar para contabilidade@descomplicar.pt
|
|
|
|
4. PRIORITARIO → Incluir no relatorio
|
|
- Remetente: cliente conhecido (verificar DeskCRM)
|
|
- Subject: urgente, problema, erro, critical, down
|
|
- Threads activas (RE:, FW:)
|
|
```
|
|
|
|
### Resumo IMAP no output
|
|
|
|
```
|
|
📧 Emails Processados
|
|
- X spam eliminados
|
|
- Y promocionais arquivados
|
|
- Z facturas para contabilidade
|
|
- W emails prioritarios pendentes
|
|
```
|
|
|
|
### Excepcoes (NUNCA processar automaticamente)
|
|
|
|
```
|
|
- *@descomplicar.pt (internos)
|
|
- *@gov.pt, *@at.gov.pt, *@seg-social.pt (governo)
|
|
- *@tribunais.org.pt (tribunais)
|
|
```
|
|
|
|
---
|
|
|
|
## Rotinas Semanais
|
|
|
|
### Segunda-feira
|
|
|
|
```
|
|
1. Checkup normal (acima)
|
|
2. Planeamento semanal:
|
|
- Todas as tarefas com deadline esta semana
|
|
- Capacidade vs carga
|
|
- Distribuicao por dia
|
|
- Verificar estimativas de tempo (set_task_estimated_time se em falta)
|
|
3. Invocar /wp-update
|
|
```
|
|
|
|
### Sexta-feira
|
|
|
|
```
|
|
1. Checkup normal (acima)
|
|
2. Sugerir manutencao WordPress:
|
|
- Listar os 10 sites da rede
|
|
- Oferecer checkup de seguranca
|
|
```
|
|
|
|
### Sabado
|
|
|
|
```
|
|
1. Checkup normal (acima)
|
|
2. Consolidacao de memorias:
|
|
- Listar ~/.claude/projects/*/memory/MEMORY.md
|
|
- Extrair "Padroes Descobertos" e "Solucoes"
|
|
- Comentario na discussao #46 (Memorias)
|
|
- Backup em memory-supabase
|
|
```
|
|
|
|
---
|
|
|
|
## Persistencia (FASE 3 - Passos 21-22)
|
|
|
|
### Passo 21: Nota Obsidian
|
|
|
|
```
|
|
Path: /media/ealmeida/Dados/GDrive/Cloud/EAL/Planeamento/00-Inbox/
|
|
Filename: YYYY-MM-DD-checkup.md
|
|
|
|
---
|
|
title: Checkup YYYY-MM-DD
|
|
date: YYYY-MM-DD
|
|
type: checkup
|
|
status: active
|
|
---
|
|
|
|
## Checkup Diario - YYYY-MM-DD
|
|
[Conteudo do relatorio com links CRM]
|
|
```
|
|
|
|
### Passo 22: Supabase
|
|
|
|
```
|
|
mcp__memory-supabase__save_memory:
|
|
- content: "Checkup diario - X tickets, Y tarefas, Z urgentes, W emails"
|
|
- tags: ["today", "checkup", "YYYY-MM-DD"]
|
|
- metadata: { tickets, tasks, urgent, emails_processed, is_monday }
|
|
```
|
|
|
|
---
|
|
|
|
## Output Final
|
|
|
|
```markdown
|
|
## Checkup Diario - 2026-02-06 (Quinta)
|
|
|
|
### Timer
|
|
#1446 - Documentacao (2h 15m)
|
|
|
|
### Emails (IMAP)
|
|
- Spam eliminado: 5
|
|
- Promocional arquivado: 3
|
|
- Facturas contabilidade: 2
|
|
- Prioritarios: 1
|
|
|
|
### Tickets
|
|
- Abertos: 4 (1 urgente)
|
|
|
|
### Facturas
|
|
- Vencidas: 3.050EUR
|
|
|
|
### Tarefas
|
|
- Urgentes: 1
|
|
- Alta prioridade: 4
|
|
|
|
### Leads + Propostas
|
|
- Leads novos: 2
|
|
- Propostas pendentes: 1
|
|
|
|
### Agenda
|
|
- 10:00 - Reuniao Cliente X
|
|
- 14:30 - Call Equipa
|
|
|
|
---
|
|
|
|
### 3 Prioridades Hoje
|
|
1. [ ] #1450 - Implementar API (Urgente)
|
|
2. [ ] Contactar OldClient (factura 15 dias)
|
|
3. [ ] #1448 - Documentacao Stack
|
|
```
|
|
|
|
---
|
|
|
|
## Auto-Process Tickets (FASE 1 - OBRIGATÓRIO)
|
|
|
|
> **EXECUTAR SILENCIOSAMENTE ANTES DE QUALQUER OUTPUT.**
|
|
> Nao perguntar, nao mostrar preview. Processar e reportar no resumo final.
|
|
|
|
### Passo 1: Recolher tickets abertos (status 1) de TODOS os departamentos
|
|
|
|
```
|
|
get_tickets({ status: 1, limit: 50 })
|
|
```
|
|
|
|
### Passo 2: Classificar cada ticket
|
|
|
|
Para cada ticket aberto, aplicar por ordem de prioridade:
|
|
|
|
```
|
|
1. NOTIFICAÇÃO SISTEMA? (verificar PRIMEIRO)
|
|
→ Subject contem padrao protegido E remetente conhecido
|
|
→ NAO fechar. Guardar para "Requer Accao" no resumo.
|
|
|
|
2. DESPESA? (verificar SEGUNDO)
|
|
→ Email do remetente contem padrao de fornecedor conhecido (ver mapeamento)
|
|
→ Processar como despesa (ver passos abaixo)
|
|
|
|
3. SPAM? (verificar TERCEIRO)
|
|
→ Subject contem padrao SPAM
|
|
→ Fechar (status 5) com motivo
|
|
|
|
4. NEWSLETTER/INFORMATIVO?
|
|
→ Newsletters, updates de produtos, notificacoes genericas
|
|
→ Fechar (status 5) com motivo
|
|
|
|
5. NENHUM MATCH → Manter aberto para revisao
|
|
```
|
|
|
|
### Passo 3: Processar Despesas
|
|
|
|
> **DADOS ESTAO NO HTML.** A maioria dos fornecedores (Anthropic, Canva, Elastic Email)
|
|
> envia os dados no corpo do email, NAO como PDF anexo.
|
|
> Extrair valor, referencia e data do HTML do ticket.
|
|
|
|
```
|
|
Para cada ticket identificado como despesa:
|
|
1. get_ticket(ticket_id) → ler HTML completo
|
|
2. Extrair do HTML: valor, invoice/reference number, data, descricao
|
|
3. Mapear email → categoria (tabela abaixo)
|
|
4. create_expense(category_id, amount, date, note, reference, currency=2, tax)
|
|
5. Fechar ticket (status 5) com "Despesa #ID criada"
|
|
6. SE existe ticket duplicado (mesmo subject) → fechar duplicado tambem
|
|
```
|
|
|
|
### Padroes SPAM (Fechar status 5)
|
|
|
|
```
|
|
Guest Post, SEO services, backlinks, partnership,
|
|
Purchase Order, WeTransfer, Prestige Awards
|
|
```
|
|
|
|
### Notificacoes de Sistema (NUNCA auto-fechar)
|
|
|
|
**Padroes protegidos (subject - case insensitive):**
|
|
```
|
|
Legal Update, Legal Notice, Policy Change, Policy Update,
|
|
Deprecation, End of Life, EOL, Breaking Change,
|
|
Migration Required, Action Required, Action Needed,
|
|
Security Alert, Security Advisory, Security Notice,
|
|
API Change, API Update, Terms Update, Terms Change,
|
|
Service Disruption, Maintenance Required,
|
|
Compliance, GDPR, Data Processing, Data Processor,
|
|
Infrastructure Change, Platform Update, Product Update
|
|
```
|
|
|
|
### Mapeamento Fornecedor → Categoria
|
|
|
|
> Verificar pelo **dominio do email** do remetente, nao pelo departamento.
|
|
> Tickets de fornecedores conhecidos podem estar em QUALQUER departamento.
|
|
|
|
| Padrao no Email | Categoria | ID | Tax |
|
|
|-----------------|-----------|-----|-----|
|
|
| anthropic | Servicos IA e APIs | 38 | 0 |
|
|
| openai | Servicos IA e APIs | 38 | 0 |
|
|
| hetzner | Alojamento de Servidores | 10 | 0 |
|
|
| meo, meoempresas | Telecomunicacoes | 1 | 1 |
|
|
| centos-webpanel, cwp | Licencas Software | 28 | 0 |
|
|
| elasticemail | E-mail MKT | 5 | 0 |
|
|
| freepik, envato, canva | Plugins e Recursos de Design | 9 | 0 |
|
|
| moloni | Software Facturacao | 11 | 1 |
|
|
| everhour | Softwares Gestao | 12 | 0 |
|
|
| ptisp, namecheap | Registo de Dominios | 13 | 0 |
|
|
| vimeo | Plataformas Armazenamento | 19 | 0 |
|
|
| payproglobal | Servicos IA e APIs (CapSolver) | 38 | 0 |
|
|
| bdthemes | Plugins e Recursos de Design | 9 | 0 |
|
|
| staples, multipapel | Material Escritorio | 15 | 1 |
|
|
|
|
### Tickets a Saltar (NAO criar despesa)
|
|
|
|
| Tipo | Indicador | Accao |
|
|
|------|-----------|-------|
|
|
| Payment Confirmation | "Payment Confirmation" de CWP/centos-webpanel | Fechar (confirmacao pagamento, nao fatura) |
|
|
| Payment Receipt | "Payment Was Successfully Processed" de elasticemail | Fechar (recibo pagamento recorrente sem dados de fatura) |
|
|
| Notificacao bancaria | "Notificação de transferência" de bancobpi | Fechar (notificacao, nao fatura) |
|
|
| Duplicado | reference_no ja existe no CRM | Fechar (ja processado) |
|
|
| Ticket duplicado | Mesmo subject que outro ticket ja processado | Fechar como duplicado |
|
|
|
|
> **NOTA:** Receipts de Anthropic e Canva contem invoice number e valor → SAO despesas.
|
|
> "Receipt" so e motivo para saltar quando e apenas confirmacao de pagamento sem dados de fatura.
|
|
|
|
### Campos Criticos
|
|
|
|
```
|
|
currency = 2 (EUR) → SEMPRE
|
|
tax = 1 → Fornecedores PT (MEO, Moloni, Staples)
|
|
tax = 0 → Fornecedores estrangeiros (Anthropic, Canva, Hetzner, etc.)
|
|
```
|
|
|
|
---
|
|
|
|
## Referência de Skills
|
|
|
|
| Secção | Skill | Comando |
|
|
|--------|-------|---------|
|
|
| Timer | /time | `/time` |
|
|
| Tickets | /ticket | `/ticket` |
|
|
| Facturas | /invoice | `/invoice overdue` |
|
|
| Tarefas/Leads | /crm | `/crm` |
|
|
| Downloads | /cleanup-downloads | SE >10 ficheiros |
|
|
| WordPress | /wp-update | Segundas |
|
|
|
|
---
|
|
|
|
## Anti-Patterns
|
|
|
|
- **NUNCA** executar checkup sem verificar data/hora
|
|
- **NUNCA** duplicar logica de outras skills
|
|
- **NUNCA** mostrar mais de 3 prioridades (PHDA)
|
|
- **NUNCA** mostrar resumo ANTES de processar despesas e SPAM
|
|
- **NUNCA** perguntar ao utilizador se deve processar despesas (e automatico)
|
|
- **NUNCA** assumir que so dept 3 tem tickets de contabilidade (verificar email do remetente)
|
|
- **NUNCA** saltar receipt que contem invoice number e valor (e despesa)
|
|
|
|
---
|
|
|
|
## Changelog
|
|
|
|
### v7.5.0 (2026-02-06)
|
|
- **IMAP TRIAGEM:** Protocolo completo para 12 contas IMAP (spam, promo, facturas, prioritarios)
|
|
- **NOTA OBSIDIAN:** Criar nota diaria em /media/ealmeida/Dados/GDrive/Cloud/EAL/Planeamento/00-Inbox/
|
|
- **SUPABASE SAVE:** Guardar resumo checkup em memory-supabase com metricas
|
|
- **LEADS + PROPOSTAS:** Adicionar verificacao de leads novos e propostas pendentes na Fase 2
|
|
- **SEXTA-FEIRA:** Rotina de manutencao WordPress sugerida as sextas
|
|
- **VERIFICAR EXECUCAO:** Passo 2 verifica ultima execucao via memory-supabase
|
|
- **EXCEPCOES IMAP:** Dominos gov.pt, at.gov.pt, tribunais nunca processados automaticamente
|
|
- **BUG FIX:** Corrigido MCP IMAP (seq.fetch→fetch para operacoes UID-based)
|
|
|
|
### v7.4.0 (2026-02-06)
|
|
- Protocolo 3 fases, scan todos departamentos, HTML fonte dados, mapeamento expandido
|
|
|
|
### v7.3.0 (2026-02-05)
|
|
- Notificacoes de sistema protegidas
|
|
|
|
### v7.2.0 (2026-02-05)
|
|
- Auto-despesas contabilidade (dept 3)
|
|
|
|
### v7.1.0 (2026-02-05)
|
|
- Integracao com skills Desk
|
|
|
|
---
|
|
|
|
*Skill v7.5.0 | 2026-02-06 | Descomplicar®*
|