From f2b5171ea2be42fc3f1bc51abb6733c36c92c3be Mon Sep 17 00:00:00 2001 From: Emanuel Almeida Date: Tue, 24 Feb 2026 11:12:07 +0000 Subject: [PATCH] feat(gestao): skill /today v8.3.1 - TOConline e plataformas multi-fornecedor MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- gestao/.claude-plugin/plugin.json | 2 +- gestao/skills/today/SKILL.md | 117 ++++++------------------------ 2 files changed, 25 insertions(+), 94 deletions(-) diff --git a/gestao/.claude-plugin/plugin.json b/gestao/.claude-plugin/plugin.json index 3800143..97c9883 100644 --- 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" diff --git a/gestao/skills/today/SKILL.md b/gestao/skills/today/SKILL.md index d985e27..c439463 100644 --- 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): - - 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]" +3. FACTURA/RECIBO → Auto-processar despesa (ver secção Auto-Despesas IMAP) + - Subject: factura, invoice, recibo, receipt, pagamento, paid + - 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: [NOME EMPRESA]" -2. "Emitente:[NOME EMPRESA]" -3. "De: [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®*