feat(gestao): skill /today v8.3.1 - TOConline e plataformas multi-fornecedor

- Adiciona TOConline (#25) ao mapeamento de fornecedores - Protocolo plataformas multi-fornecedor: TOConline, Stripe, PayPal, FastSpring, PayPro Global - CUBIC CHOICES LDA (GONDOOFFICE) → cat 21 Contabilidade - Emitentes desconhecidos via TOConline → priority_flagged - Corrige header: 16 → 25 fornecedores activos - bump plugin gestao 1.2.0 → 1.2.1 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-24 11:12:07 +00:00
parent e2c3afd4e2
commit f2b5171ea2
2 changed files with 25 additions and 94 deletions
--- a/gestao/.claude-plugin/plugin.json
+++ b/gestao/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
  "name": "gestao",
  "description": "Project management, time tracking, daily checkups, worklogs, reflections, knowledge management, archiving and compliance auditing. Backed by 6 Dify KB datasets.",
-  "version": "1.2.2",
+  "version": "1.2.1",
  "author": {
    "name": "Descomplicar - Crescimento Digital",
    "url": "https://descomplicar.pt"
--- a/gestao/skills/today/SKILL.md
+++ b/gestao/skills/today/SKILL.md
@@ -5,7 +5,7 @@ description: >
  Triagem emails 13 contas IMAP + deduplicação via imap_processed_emails (Supabase) + tickets CRM + despesas auto com PDF + health check MCPs (Sab/Dom) + sugestões workflows + nota diaria.
  Use when "checkup", "hoje", "today", "rotina", início de dia.
 author: Descomplicar® Crescimento Digital
-version: 8.3.2
+version: 8.3.0
 quality_score: 92
 user_invocable: true
 category: productivity
@@ -247,18 +247,10 @@ Classificar cada email por ordem de prioridade:
   - Remetente: *@marketing.*, *@news.*, *@promo.*
   - EXCEPÇÃO: conta "rh" → imap_delete_email (sem pasta Promotions)

-3. FACTURA/RECIBO → (2 sub-casos por ordem)
-
-   3a. REMETENTE = fornecedor conhecido (dominio na tabela de fornecedores):
+3. FACTURA/RECIBO → Auto-processar despesa (ver secção Auto-Despesas IMAP)
   - Subject: factura, invoice, recibo, receipt, pagamento, paid
-       - Dominio do remetente bate com entrada da tabela de fornecedores
-       → Auto-processar despesa directamente (ver secção Auto-Despesas IMAP)
-
-   3b. REMETENTE = plataforma multi-fornecedor (toconline.pt, stripe.com, paypal.com, fastspring.com, payproglobal.com):
-       - Dominio do remetente e uma plataforma de faturacao (nao um fornecedor directo)
-       → LER email completo → EXTRAIR emitente real (ver padroes abaixo)
-       → SE emitente encontrado na tabela de fornecedores: processar como despesa desse fornecedor
-       → SE emitente desconhecido: priority_flagged com nota "[Plataforma] - emitente desconhecido: [nome empresa]"
+   - Remetente de servico conhecido (ver mapeamento completo abaixo)
+   - Criar despesa + anexar PDF automaticamente

 4. PRIORITARIO → Incluir no relatorio
   - Remetente: cliente conhecido (verificar DeskCRM)
@@ -294,14 +286,7 @@ Classificar cada email por ordem de prioridade:
 ### Fluxo completo

 ```
-1. DETECTAR origem:
-   1a. Fornecedor directo: dominio remetente bate tabela de fornecedores
-       → fornecedor, categoria e moeda ja conhecidos, avancar para passo 2
-   1b. Plataforma multi-fornecedor: dominio remetente e toconline.pt, stripe.com, etc.
-       → LER email (passo 2) → EXTRAIR emitente real (padroes da secção "Plataformas Multi-Fornecedor")
-       → Procurar emitente na tabela "Emitentes Conhecidos por Plataforma"
-       → SE encontrado: usar categoria/moeda dessa entrada, avancar para passo 3
-       → SE desconhecido: registar action="priority_flagged", nota="[Plataforma] - emitente: [nome]", PARAR
+1. DETECTAR: Email de fornecedor conhecido com subject de factura/recibo
 2. LER: imap_read_email(account, uid) → conteudo HTML + anexos
 3. EXTRAIR do HTML:
   - Valor (procurar padroes: $XX.XX, XX,XX EUR, USD XX.XX)
@@ -354,9 +339,8 @@ CSVs: {BASE}/YYYY/MAPA-DESPESAS-YYYY.csv

 ### Mapeamento Completo Fornecedores (IMAP + Tickets)

-> **24 fornecedores activos.** Verificar pelo dominio do email remetente.
+> **25 fornecedores activos.** Verificar pelo dominio do email remetente.
 > Mesma tabela usada para triagem IMAP E para auto-process tickets.
-> **NOTA:** Plataformas de faturação (TOConline, Stripe, PayPal...) NAO sao fornecedores - ver secção "Plataformas Multi-Fornecedor" abaixo.

 | # | Fornecedor | Padrao Email Remetente | Conta IMAP | Cat ID | Categoria | Tax | Moeda | Notas |
 |---|-----------|----------------------|------------|--------|-----------|-----|-------|-------|
@@ -384,6 +368,7 @@ CSVs: {BASE}/YYYY/MAPA-DESPESAS-YYYY.csv
 | 22 | Moloni | moloni.pt | contabilidade | 28 | Licencas Software | 1 | EUR | Facturacao PT com IVA |
 | 23 | YouTube Premium | google.com (YouTube) | gmail | 14 | Subscricoes e Servicos Digitais | 0 | EUR | Mensal ~6.99 EUR |
 | 24 | PTisp | ptisp.pt, almourol.com | gmail, contabilidade | 37 | Dominios | 1 | EUR | Dominios PT com IVA |
+| 25 | TOConline | toconline.pt, no-reply@toconline.pt | emanuel | — | (ver nota) | 1 | EUR | Plataforma faturas eletronicas PT. Ler email para identificar emitente real. CUBIC CHOICES LDA → cat 21 (Contabilidade). Outros emitentes → mapear manualmente ou flag priority. |

 ### Moedas

@@ -396,68 +381,21 @@ CRITICO: currency=1 NAO existe e causa despesas invisiveis nos relatorios.

 ### Plataformas Multi-Fornecedor (protocolo especial)

-> Plataformas de faturacao sao intermediarios — nao sao fornecedores.
-> O dominio do remetente identifica a plataforma; o CORPO do email identifica o fornecedor real.
-> Activado pelo passo 3b da triagem IMAP.
+> Algumas plataformas entregam faturas de qualquer empresa. NAO mapear para categoria fixa.
+> Ler o email para identificar o emitente real, depois categorizar.

-#### Dominios de Plataformas Conhecidas
+| Plataforma | Dominio | Protocolo |
+|-----------|---------|-----------|
+| TOConline | toconline.pt | Ler email → extrair "Emitente: [empresa]" → mapear empresa → se desconhecida: flag priority |
+| Stripe | stripe.com | Ler subject/corpo → identificar fornecedor (Cursor, Descript, OpenRouter...) → usar entrada do fornecedor real |
+| PayPal | paypal.com | Ler corpo → identificar fornecedor → categorizar por fornecedor real |
+| FastSpring | fastspring.com | Ler corpo → identificar fornecedor (BdThemes...) → categorizar por fornecedor real |
+| PayPro Global | payproglobal.com | Ler corpo → identificar fornecedor (CapSolver...) → categorizar por fornecedor real |

-```
-toconline.pt          → sistema faturacao electronica PT (e-fatura B2B)
-stripe.com            → processador pagamentos (Cursor, Descript, OpenRouter...)
-paypal.com            → processador pagamentos (Canva via PayPal...)
-fastspring.com        → loja software (BdThemes...)
-payproglobal.com      → loja software (CapSolver...)
-```
+**Emitentes TOConline conhecidos:**
+- CUBIC CHOICES LDA → cat 21 (Contabilidade), tax=1

-#### Padroes de Extracao do Emitente Real
-
-**TOConline** (`toconline.pt`):
-```
-Procurar no HTML (por ordem):
-1. "Emitido por:</strong> [NOME EMPRESA]"
-2. "Emitente:</td><td>[NOME EMPRESA]"
-3. "De:</strong> [NOME EMPRESA]"
-Exemplo: "CUBIC CHOICES LDA" → procurar na tabela de fornecedores pelo nome
-```
-
-**Stripe** (`stripe.com`):
-```
-Procurar no subject: "[Nome Empresa] invoice" ou "Receipt from [Nome Empresa]"
-Exemplo subject: "Your receipt from Cursor" → fornecedor = Cursor
-```
-
-**PayPal** (`paypal.com`):
-```
-Procurar no subject: "You paid [Nome Empresa]" ou "Receipt for your payment to [Nome Empresa]"
-Exemplo: "You paid Canva" → fornecedor = Canva
-```
-
-**FastSpring** (`fastspring.com`):
-```
-Procurar no subject ou corpo: "Order from [Nome Empresa]" ou "purchased [Nome Produto] from [Nome Empresa]"
-Exemplo: "purchased Element Pack from BdThemes" → fornecedor = BdThemes
-```
-
-**PayPro Global** (`payproglobal.com`):
-```
-Procurar no subject ou corpo: nome do produto/empresa
-Exemplo: "CapSolver" no corpo → fornecedor = CapSolver
-```
-
-#### Emitentes Conhecidos por Plataforma
-
-| Plataforma | Emitente | Fornecedor na Tabela | Cat | Notas |
-|-----------|---------|---------------------|-----|-------|
-| TOConline | CUBIC CHOICES LDA | — (nao esta na tabela) | 21 | Contabilidade GONDOOFFICE, tax=1, EUR |
-| Stripe | Cursor | Cursor (#10) | 28 | — |
-| Stripe | Descript | Descript (#9) | 28 | — |
-| Stripe | OpenRouter | OpenRouter (#2) | 38 | — |
-| PayPal | Canva | Canva (#7) | 28 | — |
-| FastSpring | BdThemes | BdThemes (#15) | 14 | — |
-| PayPro Global | CapSolver | CapSolver (#3) | 38 | — |
-
-> **NOTA:** CUBIC CHOICES LDA nao tem entrada na tabela de fornecedores (nao e um servico digital recorrente com dominio proprio). Usar directamente cat 21, tax=1, EUR.
+**Emitentes TOConline desconhecidos:** flag `priority_flagged` com nota "TOConline - emitente desconhecido: [empresa]"

 ### Emails a IGNORAR (nao sao despesas)

@@ -1066,17 +1004,10 @@ send_invoice_to_customer = 0 → OBRIGATORIO na BD (sem default)

 ## Changelog

-### v8.3.2 (2026-02-24)
- **FLUXO IMAP PASSO 3b:** Detecção de plataformas multi-fornecedor integrada na triagem IMAP
- **EXTRACAO EMITENTE:** Padroes HTML especificos por plataforma (TOConline, Stripe, PayPal, FastSpring, PayPro Global)
- **TABELA EMITENTES:** Mapeamento plataforma→emitente→fornecedor/categoria para 6 casos conhecidos
- **AUTO-DESPESAS:** Fluxo actualizado — passo 1 distingue fornecedor directo vs plataforma intermediaria
- **CUBIC CHOICES LDA:** Documentado fora da tabela de fornecedores (cat 21, tax=1, EUR, via TOConline)
-
 ### v8.3.1 (2026-02-24)
- **PLATAFORMAS MULTI-FORNECEDOR:** Protocolo para plataformas de faturação (TOConline, Stripe, PayPal, FastSpring, PayPro Global) — NAO sao fornecedores, sao sistemas de entrega de faturas
- **TOConline:** Detectar pelo dominio → ler email → extrair emitente real → categorizar pelo emitente (nao pela plataforma). CUBIC CHOICES LDA → cat 21. Emitente desconhecido → flag priority
- **Regra:** NUNCA adicionar uma plataforma de faturacao multi-fornecedor à tabela de fornecedores
+- **PLATAFORMAS MULTI-FORNECEDOR:** Novo protocolo para plataformas que entregam faturas de qualquer empresa (TOConline, Stripe, PayPal, FastSpring, PayPro Global)
+- **TOConline adicionado (#25):** Ler email para identificar emitente real. CUBIC CHOICES LDA → cat 21. Desconhecido → flag priority
+- **Regra:** NUNCA mapear plataforma multi-fornecedor para categoria fixa sem ler o emitente real

 ### v8.3.0 (2026-02-14)
 - **WORKFLOWS SUGERIDOS:** Analisa tarefas prioritárias e sugere workflows/componentes relevantes
@@ -1148,4 +1079,4 @@ send_invoice_to_customer = 0 → OBRIGATORIO na BD (sem default)

 ---

-*Skill v8.3.2 | 2026-02-24 | Descomplicar®*
+*Skill v8.3.1 | 2026-02-24 | Descomplicar®*