Gamine Auditoria Meta Suite v3

EUREEKKA SA

Projeto Gamine --- Infraestrutura Digital

Auditoria à Presença da Gamine

na Suite Meta e Plataformas Adjacentes

Diagnóstico · Estratégia · Manual Operacional

Arquitetura Open-Source e Repurpose Multi-Plataforma

Edição v3

Entidade Legal: Eureekka SA · Stack VPS Open-Source · Distribuição Multi-Plataforma


Campo Valor


Data 16 de Maio de 2026

Versão 3.0 --- Open-Source Repurpose Architecture

Preparado por Sistema de Inteligência Gamine · Back Office

Destinatários João Brazão (Eureekka SA) · Marta Brazão (CEO Gamine) · Alice Brazão (COO Gamine)

Entidade legal Meta Eureekka SA --- NIF e documentação da Eureekka

Classificação Interno --- Estratégico

Substitui v2.0 (15 Maio 2026)


Histórico de Versões e Âmbito do v3

Este documento, na sua versão 3, mantém integralmente o conteúdo aprovado da v2 --- diagnóstico Meta, Bloco A-D de configuração da Eureekka SA, manual operacional e roadmap de automação --- e adiciona uma camada arquitectural nova que resulta da decisão estratégica de tomar como princípios fundadores: (1) maximização de soberania digital via stack open-source corrente no VPS Eureekka, (2) distribuição multi-plataforma do conteúdo produzido pela Marta no Instagram, e (3) eliminação total do risco de bloqueio por uso de ferramentas não-certificadas, através do recurso exclusivo a APIs oficiais com OAuth correto sob a Meta App da Eureekka.


Versão Data Conteúdo Principal Estado


1.0 Maio 2026 Auditoria inicial Meta --- primeiro Substituída diagnóstico

2.0 15 Maio Adoção de Eureekka SA como entidade Conteúdo 2026 legal Meta; Blocos A-D; verificação preservado empresarial

3.0 16 Maio Stack open-source no VPS; pipeline Versão 2026 repurpose multi-plataforma; estratégia Corrente anti-flag



O conteúdo da v2 está integralmente preservado nas Secções 1 a 9 deste documento. As Secções 10 a 14 são acrescentos exclusivos do v3 que resultam da discussão técnica de 16 de Maio de 2026 sobre arquitetura de repurpose e princípio de soberania digital.


Nota Prévia --- Estrutura Legal Adotada


DECISÃO ESTRATÉGICA: A Gamine opera atualmente como projeto de uma prestadora de serviços individual, sem empresa formalmente constituída. Para evitar o custo e a burocracia de criar uma nova entidade jurídica nesta fase de startup, será a Eureekka SA --- empresa investidora com mais de 20 anos de existência --- a servir de entidade legal para a verificação junto da Meta. Esta decisão é técnica e financeiramente sólida, sem implicações negativas para a operação da Gamine.


Por que Isto Funciona

A Meta distingue claramente a entidade legal (quem paga e quem é verificado) dos ativos de marca (o que aparece ao público). Este modelo --- holding verifica, marca opera --- é o standard do setor. Grupos como a LVMH, a Unilever ou a Sonae gerem dezenas de marcas sob um único Business Manager verificado pela entidade holding.

No caso da Gamine, a Eureekka SA é a entidade investidora na startup. A relação jurídica entre ambas já existe. Usar a Eureekka como entidade legal para os produtos Meta não é um artifício --- é o reflexo correto da estrutura de participação existente.


Camada Entidade Responsabilidade


Entidade legal Eureekka SA Verificação, faturação Meta Ads, Meta titularidade dos ativos

Gestão Marta Brazão (CEO Conteúdo, estratégia editorial, operacional Gamine) aprovação de posts

Gestão Alice Brazão (COO Calendário, agência, operações operacional Gamine) diárias

Infraestrutura João Brazão Business Manager, API, tokens, técnica (Eureekka) segurança

Futura transição Gamine (empresa a Quando a Gamine se constituir, os constituir) ativos transferem-se


Plano de Transição Futura

Quando a Gamine se constituir formalmente como empresa (Lda. ou Unipessoal Lda.), a transferência dos ativos Meta é um processo simples e documentado:

  • Criar novo Business Manager sob o NIF da Gamine

  • Transferir a Página Facebook, a conta Instagram e o Pixel para o novo Business Manager

  • Atualizar as credenciais de faturação --- as faturas de Meta Ads passam da Eureekka para a Gamine

  • A Eureekka deixa de figurar como entidade legal --- os ativos ficam inteiramente na Gamine


Esta transição futura não implica perder seguidores, histórico de posts, dados de Pixel, audiências acumuladas, nem configurações de anúncios. É uma operação administrativa, não uma migração técnica de dados.


1. Diagnóstico da Situação Atual

A Gamine produz conteúdo com uma voz autêntica e uma credencial rara: a Marta é enfermeira especialista hospitalar, bilingue, num mercado onde 85% dos profissionais de saúde operam exclusivamente em português. Esta é uma vantagem competitiva real e mensurável.


Diagnóstico central: a Gamine opera com um motor de alta performance ligado a uma transmissão avariada. O potencial existe --- o aproveitamento é mínimo. O bloqueador não é o conteúdo, é a infraestrutura à volta do conteúdo.


1.1 Situação das Contas Meta

Instagram


Indicador Situação Atual Situação Após Configuração


Tipo de conta ❌ Possivelmente ✅ Business ligada ao BM \'Criadora\' ou pessoal Eureekka

Acesso à Graph API ❌ Nenhum --- dados via ✅ Token permanente com raspagem HTML permissões completas

Métricas de ❌ Zero em todos os 2.459 ✅ Likes, saves, reach, engagement posts impressions, shares, plays

Cobertura de ⚠️ 19% dos posts têm ✅ 100% com estratégia de hashtags hashtags (477/2.459) 3 camadas

Meta Pixel no site ❌ Não existe ✅ Instalado em gamine.org

Publicação via API ❌ Impossível ✅ Via stack open-source no VPS Eureekka

Webhooks tempo real ❌ Não configurados ✅ Dashboard atualizado em \< 30 segundos


Facebook


Indicador Situação Atual Situação Após Configuração


Tipo de conta ❌ Perfil pessoal ✅ Página de Negócio no martabrazao3 BM Eureekka

Último post ❌ Julho 2022 --- 3 anos ✅ Cross-posting nativo de inatividade via API oficial

Meta Ads ❌ Impossível com perfil ✅ Campanhas faturadas à pessoal Eureekka SA

Meta Business ❌ Não existe ✅ Criado sob Eureekka Manager SA, NIF Eureekka

Business ❌ Não existe ✅ Documentos da Eureekka Verification --- 24-48h


1.2 Impacto Mensurável da Configuração Incorreta


Situação Impacto Estimado Causa


Posts sem hashtag −54% de alcance por Algoritmo não distribui sem strategy post sinais de classificação

Publicação fora do −40 a −60% de Janela de distribuição horário ótimo reproduções (Reels) algorítmica perdida

Ausência de saves nos Sem promoção para Sinal de qualidade não primeiros 30 min Explore gerado

Facebook inativo (3 0% de cross-reach na Audiência FB completamente anos) plataforma inexplorada

Sem Meta Pixel Atribuição de Ligação conteúdo → contacto receita impossível → venda invisível



Estimativa conservadora: 9.000 a 39.000 impressões mensais perdidas. Os dados reais da Gamine só serão conhecidos após ativação da API.


2. Estado Ideal --- Arquitetura Completa

2.1 Estrutura Meta sob a Eureekka SA


     **META BUSINESS MANAGER --- Entidade legal: EUREEKKA SA**

**NIF Eureekka SA · João Brazão (Admin) · Business Verification com
                       documentos Eureekka**

FACEBOOK PAGE \'Gamine\' (Página de negócio · gestão Marta + Alice · cross-posting via API) | INSTAGRAM BUSINESS \@gamine.pt (Conta Business · API + Insights · publicação via stack VPS) | WHATSAPP BUSINESS (Número dedicado · respostas automáticas · integração futura)

META APP (Graph API) · META PIXEL · META ADS (faturação → Eureekka SA)


2.2 Métricas Disponíveis com Configuração Correta

Por post (Graph API v18+)


Métrica O Que Mede Importância


Reach Pessoas únicas que viram o post 🔴 Crítica

Saves Vezes que o post foi guardado 🔴 Crítica --- sinal mais forte de qualidade

Shares Partilhas (especialmente Reels) 🔴 Crítica --- crescimento orgânico

Impressions Visualizações totais (inclui 🟠 Alta --- indica repetidas) viralidade

Comments Comentários 🟠 Alta --- engagement qualitativo

Likes Gostos 🟡 Média --- sinal fraco isoladamente

Video Views / Visualizações de vídeo e Reels 🔴 Crítica para Plays Reels

Profile Visits Visitas ao perfil vindas deste 🟠 Alta --- intenção post de seguir

Follows Seguidores ganhos por post 🔴 Crítica --- crescimento de audiência

Engagement Rate (saves+likes+comments) ÷ reach × 🔴 Crítica --- KPI 100 principal



O save rate (saves ÷ reach > 3%) classifica o post como \'conteúdo de valor\' e aciona a promoção para o Explore. Atualmente este valor é zero em todos os 2.459 posts --- impossível de medir sem API.


3. Manual de Implementação --- Step-by-Step

O manual está organizado em quatro blocos. O Bloco A cobre a preparação da Eureekka SA como entidade verificada pela Meta. Os Blocos B, C e D cobrem a configuração operacional das contas Gamine.


Bloco Foco Quem Tempo Custo


A Verificação Eureekka João 45 min + Gratuito SA na Meta 24-48h
revisão

B Fundação das contas Marta + João 30 min Gratuito Gamine

C Meta App + API + João / 90 min + 25 Gratuito Backfill Claude_Cowork min auto

D WhatsApp Business Marta 20 min Gratuito Gamine


BLOCO A --- Verificação da Eureekka SA na Meta


Este bloco é o mais importante. A verificação da Eureekka pela Meta é o que transforma o Business Manager de \'conta pessoal com nome de empresa\' em \'empresa verificada com acesso completo à API em modo de produção\'.


A1 --- Documentos a Preparar (Eureekka SA)

Quem: João · Tempo: 15 minutos

A Meta aceita qualquer combinação de dois documentos. A Eureekka SA, com mais de 20 anos de atividade, dispõe de todos:


Documento Onde Obter Validade Aceite pela Meta


Certidão Permanente do predial.rnpc.mj.pt --- Qualquer data (é Registo Comercial €25 permanente)

Cartão de Identificação Autoridade Tributária Documento original Pessoa Coletiva (NIPC) ou AT online

Declaração de Portal das Finanças → Última declaração Início/Alteração de e-fatura válida Atividade

Extrato bancário Banco da Eureekka Últimos 3 meses empresarial

Fatura de serviço Fornecedor de serviços Últimos 3 meses (eletricidade, telecom)



Recomendação prática: usar a Certidão Permanente do Registo Comercial (€25, obtida online em minutos) + extrato bancário da Eureekka.


A2 --- Criar Meta Business Manager sob a Eureekka SA

Quem: João · Tempo: 10 minutos · URL: business.facebook.com

  • Aceder a business.facebook.com com conta Facebook pessoal de João

  • Criar conta → Nome: Eureekka SA · Email institucional Eureekka

  • Definições → Informações da empresa: NIF Eureekka, morada legal, país Portugal

A3 --- Submeter para Meta Business Verification

Quem: João · Tempo: 20 minutos · Espera: 24-48 horas (aprovação Meta)

  • BM → Definições → Centro de Segurança → Verificar empresa

  • Método: \'Documento oficial da empresa\' → carregar 2 documentos de A1

  • Submeter e aguardar email Meta

A4 --- Adicionar Marta e Alice como Administradoras

Quem: João · Tempo: 5 minutos

  • BM → Definições → Utilizadores → Pessoas → Convidar

  • Alice e Marta como Administradoras (acesso total aos ativos Gamine)

A5 --- Configurar Conta de Anúncios com Faturação Eureekka

Quem: João · Tempo: 10 minutos

  • BM → Contas de Anúncios → Criar \'Gamine Ads\'

  • Fuso: Lisboa · Moeda: EUR · Pagamento: cartão Eureekka SA

BLOCO B --- Fundação das Contas Gamine


Configura as contas de marca Gamine dentro do BM da Eureekka. A \'casa\' onde os ativos vivem já foi criada no Bloco A.


B1 --- Converter Perfil Facebook em Página de Negócio

Quem: Marta · Tempo: 15 min · Risco: Baixo --- conteúdo preservado

  • Facebook pessoal Marta → Definições → Informações Pessoais e Conta

  • \'Converter perfil em Página\' → Categoria: Saúde e Bem-Estar → Serviços de Saúde

  • Nome: Gamine · Após conversão, adicionar ao BM Eureekka

B2 --- Converter Instagram para Conta Business

Quem: Marta (telemóvel) · Tempo: 5 min

  • IG → Perfil → Definições → Mudar para conta profissional

  • EMPRESA (não Criadora --- API mais completa)

  • Ligar à Página Facebook \'Gamine\' criada em B1


Funcionalidade Conta Conta Empresa Criadora


Graph API completa (métricas) ❌ Limitada ✅ Completa

Publicação via API ❌ ✅

Meta Ads / Boost posts ❌ ✅

Categoria de negócio no perfil ❌ ✅

Meta Business Verification ❌ ✅


BLOCO C --- Meta App, API e Backfill


O Bloco C é o desbloqueador central do dashboard. Sem o token gerado aqui, o back office mostra zeros em todas as métricas.


C1 --- Criar Meta App para Graph API

Quem: João · Tempo: 30-60 min · URL: developers.facebook.com

  • developers.facebook.com → Os meus Apps → Criar App

  • Tipo: Empresa · Nome: Gamine Analytics · BM: Eureekka SA

  • Adicionar: Instagram Graph API + Facebook Login + Webhooks

Permissões a solicitar:

instagram_basic, instagram_manage_insights, instagram_content_publish, pages_read_engagement, pages_manage_posts, pages_show_list, business_management, whatsapp_business_messaging


Com o BM Eureekka verificado, a Meta App pode ir directamente a modo Produção. É uma das principais vantagens de ter a verificação empresarial feita primeiro.


C2 --- Gerar Token Permanente de Acesso

Quem: João · Tempo: 20 min

Graph API Explorer → app \'Gamine Analytics\' → token utilizador → converter para token longa duração.

Guardar no Vaultwarden antes do .env:

META_ACCESS_TOKEN, META_APP_ID, META_APP_SECRET, META_PAGE_ID, META_IG_ACCOUNT_ID, META_PIXEL_ID, META_WEBHOOK_VERIFY_TOKEN


Estes 7 valores são as chaves de acesso à API Meta. Tratá-los como senhas: Vaultwarden, nunca por email, nunca commitar no git.


C3 --- Backfill de Métricas dos 2.459 Posts

Quem: Claude_Cowork (100% automático) · Tempo: \~25 min

Para cada post: GET /{media_id}?fields=like_count,comments_count,reach,impressions,saved,shares_count → grava em PostgreSQL. Aguarda 18s entre pedidos (rate limit 200/h). Processo retomável.

C4 --- Instalar Meta Pixel em gamine.org

Tempo: 15 min

  • Gestor de Eventos → Criar Pixel → \'Gamine Web Pixel\'

  • Eventos: ViewContent, Lead, Contact, Purchase

C5 --- Configurar Webhooks Tempo Real

Tempo: 45 min

Marta publica → Meta detecta → POST /gamine/api/v1/webhooks/instagram → BD atualizada → dashboard em \<30s.

BLOCO D --- WhatsApp Business

D1 --- Criar Conta WhatsApp Business

Custo: Gratuito até 1.000 conversas/mês

  • App WhatsApp Business (separada do pessoal)

  • Número dedicado de negócio

  • BM → Contas WhatsApp → Adicionar → verificar

4. Automação via Claude_Cowork

O back office da Gamine corre no mesmo servidor que o Claude_Cowork. Com os 7 valores do .env configurados (Bloco C2), o sistema opera de forma autónoma:


Tarefa Frequência Intervenção Estado Humana


Backfill métricas Diário, 06:00 Nenhuma Aguarda token posts novos C2

Relatório semanal Segunda, 08:00 Receber por Telegram Aguarda token performance C2

Alerta post alto Tempo real Receber notificação Aguarda webhook engagement (webhook) C5

Sugestão horário ideal Semanal Aprovar ou ignorar Aguarda dados reais

Análise hashtags Semanal Ler relatório Aguarda token alcance C2

Cross-posting FB ← IG Cada post Nenhuma Aguarda Página B1

Sugestões conteúdo por Semanal Marta aprova/edita Aguarda dados IA reais

Calendário editorial Mensal Alice/Marta aprovam Aguarda 6 sem mensal dados


5. Estratégia de Publicação Cross-Meta

5.1 Princípio: Publicação Única, Distribuição Múltipla

Publicar UMA VEZ de forma otimizada para Instagram (primário). O sistema distribui automaticamente e de forma adaptada para cada plataforma.


Instagram (primário) Facebook (distribuição automática)


Post/Reel com 10-15 hashtags Mesma imagem/vídeo, SEM hashtags estruturados (FB não usa hashtags)

Geotag Lisboa + localização Link para artigo do blog (se específica existir)

CTA \'guarda este post\' --- CTA diferente: \'Saber mais\' ou maximiza saves \'Contactar\'

Caption 150-300 palavras Caption mais curta e directa estruturada

Stories remix 24h depois Boost post €5-10 (fatura Eureekka SA)


5.2 Anatomia de um Reel --- Máxima Propagação


Elemento Descrição


GANCHO (Primeiros Frase que cria curiosidade ou tensão imediata. Ex: 3 segundos) \'O que a tua obstetra não te disse sobre o parto\'. O algoritmo decide em 3 segundos se promove.

CORPO (15-60 Conteúdo útil: técnica, resposta a dúvida, segundos) desmistificação de mito. A Marta é a única fonte autorizada --- autenticidade é o diferenciador.

CALL-TO-ACTION Texto dito e escrito: \'Guarda este post se ficares (Final) grávida em Lisboa\'. Saves são o sinal mais forte. Sem CTA explícito, saves caem 40-60%.

LEGENDA + Linha 1: repete o gancho. Espaço forçado. HASHTAGS Desenvolvimento em 3-5 pontos. Pergunta de engagement. Hashtags em 3 camadas (10-15 total).


5.3 Estratégia de Hashtags --- 3 Camadas


Camada Exemplos Função


Broad (2-3 tags) #maternidade #gravidez Alcance alargado --- #bebe audiência maior mas menos específica

Niche (5-7 tags) #enfermeiraobstetrica Audiência de qualidade --- #partonatural #amamentacao procuram exactamente este #recemnascido conteúdo

Brand (2-3 tags) #gamine #gaminept Identidade --- posts #saudeperinatal agrupáveis, marca pesquisável


5.4 Calendário Editorial --- Estrutura Base


Dia Formato Conteúdo Horário PT


Segunda Post / Carrossel Educacional --- tema semanal 12:00 ou em profundidade 20:00-22:00

Quarta Reel Valor alto --- maior alcance 19:00-21:00 orgânico

Sexta Story Poll, pergunta, quiz --- 08:00-09:00 ou interactivo engagement rápido 21:00

Domingo Post Testemunho, bastidores, 20:00-21:00 inspiracional reflexão

Diário Stories Resposta a DMs, bastidores, 08:00 e 21:00 momento do dia


6. Ferramenta de Publicação --- Princípio Revisto v3


REVISÃO v3: A v2 recomendava o Metricool como ferramenta primária de scheduling. O v3 mantém o Metricool exclusivamente para analytics consolidado e desloca o motor de publicação para um stack open-source no VPS Eureekka, que recorre apenas a APIs oficiais OAuth. Esta revisão tem dois motivos: (1) reduzir dependência de SaaS, (2) eliminar qualquer risco de flag por uso de ferramenta intermediária.


6.1 Por Que Esta Revisão

O receio operacional é legítimo e correto: a Meta, o YouTube e plataformas similares bloqueiam contas quando detectam publicação via ferramentas não-auditadas --- é o motivo pelo qual os Meta Marketing Partners (Buffer, Hootsuite, Metricool) existem como categoria. A análise feita pela primeira vez em v2 propunha resolver isto via partner certificado. O v3 propõe uma alternativa estrategicamente superior: usar APIs oficiais directamente com a Meta App \'Gamine Analytics\' já registada sob o Business Manager Eureekka.

6.2 Como as Plataformas Distinguem Publicadores


Tipo de Publicador Tratamento das Risco de Plataformas Bloqueio


App OAuth oficial Idêntico a uma agência ou Zero registada (Gamine Meta Marketing Partner ---
Analytics sob BM chamada legítima
Eureekka)

Tool de scheduling Idêntico --- mas com Zero certificado (Buffer, mensalidade e perda de
Metricool, Hootsuite) controlo

Scraping ou automação web Detecção e bloqueio em Alto / sem OAuth (instagrapi, prazo curto Garantido login bots)



O stack v3 está na categoria 1. É mais seguro que qualquer SaaS porque o controlo sobre rate limiting, retries e respeito por políticas é nosso e auditável.


6.3 Comparação de Abordagens


Critério v2 (Metricool v3 (VPS + API oficial) primário)


Custo recorrente €0-22/mês €0

Soberania digital Dados passam por Total --- tudo no VPS terceiros Eureekka

Risco de flag Baixo (partner Zero (API oficial directa) certificado)

Controlo sobre Limitado ao que a UI Total --- código próprio lógica permite

Esforço inicial Configuração rápida Sprint dev (\~40h, Claude Code)

Integração com Six Impossível (caixa preta) Nativa Eyes scoring

Auditoria RGPD Art. Dependente do parceiro Direta --- logs próprios 9


6.4 Papel Residual do Metricool

O Metricool não desaparece --- passa a ter um papel restrito e bem definido:

  • Dashboard analytics consolidado para Marta e agência (interface visual familiar)

  • Comparação de performance entre plataformas para leitura rápida

  • Backup operacional caso o stack VPS esteja em manutenção

A Marta e a Alice continuam a aceder ao Metricool para consultar números, mas a publicação propriamente dita corre pelo stack VPS. Isto preserva continuidade operacional e elimina dependência.

7. Agência Digital Numa Caixa --- Powered by Claude_Cowork

7.1 As Cinco Funções de uma Agência e Quem as Executa


Função O Que Faz Executor Human-in-the-Loop


Estratégia Define o que publicar, IA --- baseada em Marta/Alice aprovam quando e porquê métricas reais calendário

Produção Cria conteúdo visual e Marta --- N/A --- é humano por textual insubstituível definição

Aprovação Valida qualidade e Claude_Cowork + Marta aprova SEMPRE conformidade Marta

Distribuição Publica no horário e Stack VPS via APIs Apenas aprovação plataforma certos oficiais (v3) inicial

Análise Mede o que funcionou e Claude_Cowork Relatório semanal para ajusta (automático) equipa


7.2 Roadmap de Desenvolvimento


Componente Descrição Esforço Prioridade


Backfill métricas Dados reais dos 2.459 posts 2h 🔴 Crítico históricos

Webhook endpoint Métricas em tempo real no 3h 🔴 Crítico dashboard

Dashboard métricas Performance.html com dados 4h 🟠 Alta real reais

Gerador sugestões IA Próximos posts baseados em 6h 🟠 Alta dados

Pipeline repurpose Stack open-source 40h 🔴 Crítico v3 multi-plataforma

Fluxo aprovação Notif → aprova → publica 8h 🟡 Média Telegram/PWA

Relatório semanal Entregue por Telegram às 3h 🟡 Média auto segundas



Total: \~66 horas de desenvolvimento pelo Claude_Cowork, de forma incremental. Sem custo externo --- infraestrutura existente no VPS da Eureekka. O incremento de 40h face à v2 corresponde ao pipeline open-source multi-plataforma descrito nas Secções 10-14.


8. O Que Passa a Ser Possível Após Conversão Completa

8.1 Inteligência de Conteúdo

Identificar posts com mais saves --- o KPI mais valioso. Um save rate > 3% classifica o post como \'conteúdo de valor\' e aciona promoção para o Explore com efeito multiplicador de 3-8×. Atualmente este valor é zero em todos os 2.459 posts.

Mapear o conteúdo \'evergreen\' --- o que funciona semanas depois. Posts que continuam a gerar alcance semanas após publicação têm valor editorial muito superior. O dashboard identifica automaticamente o top 10 com maior longevidade.

Correlação real entre hashtag e alcance. Saber que #maternidade é o mais usado não diz nada sobre se funciona. Com dados reais, descobre-se que #enfermeiraobstetrica (mais específico) gera 3× mais alcance.

8.2 Inteligência de Mercado

Rastreio de conversões site ← Instagram. Com Pixel: \'deste post específico vieram X visitas, das quais Y preencheram formulário\'. A ligação entre conteúdo orgânico e receita fica visível.

Audiências lookalike para anúncios de alta precisão. Com Pixel ativo 6 meses: a Meta cria audiências lookalike. Anúncio de €50 dirigido a esta audiência tem custo-por-resultado 3-5× inferior. Faturas à Eureekka SA.

8.3 Receita e Crescimento

Atribuição de receita a conteúdo orgânico específico. Quando cliente contrata workshop e Pixel confirma origem, o dado fica registado. \'Qual o conteúdo com maior retorno em receita?\' --- e produzir mais desse tipo.

Suporte à expansão Hub-and-Spoke. Modelo Lisboa → Porto → Algarve → 8 cidades requer audiências de base em cada mercado. Audiências Lisboa servem como modelo lookalike, reduzindo CAC em 40-60%.

WhatsApp como canal de activação. Taxa de abertura WhatsApp: 98% vs 22% email. Sequências automáticas para quem descarrega recursos gratuitos.

9. Resumo Executivo v2 --- Próximos Passos Base


SÍNTESE v2: Com Eureekka SA como entidade legal Meta (custo zero, sem nova empresa), e com \~95 minutos de trabalho humano, o back office da Gamine passa de arquivo histórico com zeros para dashboard de gestão com dados reais e automação operacional completa.


9.1 Sequência Crítica --- Esta Semana


Passo Acção Quem Tempo Resultado


A1-A2 Preparar docs + criar BM João 25 min BM verificável Eureekka criado

A3 Submeter Meta Business João 20 min Verificação Verification 24-48h

B1 Converter Facebook perfil Marta 15 min Página no BM → Página Gamine Eureekka

B2 Converter Instagram → Marta 5 min API desbloqueada Conta Business

A4 Adicionar Marta e Alice João 5 min Equipa com acesso como admins

C1-C2 Criar Meta App + token João 60 min Dashboard permanente desbloqueado

C3 auto Backfill 2.459 posts Claude_Cowork 25 min auto Métricas reais no (automático) DB


9.2 Tabela de Custos Consolidada (v2 + v3)


Item Custo Faturado a Observação


Meta Business Manager Gratuito --- Permanentemente gratuito

Certidão Permanente \~€25 (único) Eureekka SA Necessária para Registo Comercial verificação Meta

Instagram Business Gratuito --- Permanentemente Account gratuito

Meta App + Graph API Gratuito --- Permanentemente gratuito

Meta Pixel Gratuito --- Permanentemente gratuito

WhatsApp Business (até Gratuito --- API Cloud gratuita 1K/mês)

YouTube Data API v3 Gratuito --- 10.000 quota units/dia

Pinterest API v5 Gratuito --- Developer account gratuito

LinkedIn Marketing API Gratuito --- Aprovação developer

Metricool (só €0-22/mês Eureekka SA Plano grátis pode analytics) bastar

Meta Verified (azul) €21,99/mês Eureekka SA Credibilidade visual --- opcional --- fase 2

Meta Ads --- orçamento €50 (único) Eureekka SA Após 6 meses dados teste acumulados

Stack open-source v3 €0 --- Tudo no VPS Eureekka (ffmpeg, FastAPI...) existente

LLM local (Ollama) ou €0-5/mês Eureekka SA Decisão v3 --- Secção OpenRouter 12

Desenvolvimento €0 --- Infraestrutura VPS técnico (\~66h) (Claude_Cowork) existente

Constituição Gamine €360 (futuro) Gamine (quando Quando a startup tiver como empresa constituída) dimensão



Custo imediato total para dashboard Meta completo + pipeline repurpose v3: €25 (certidão permanente). Tudo o resto é zero ou marginal (até €5/mês opcional). A Eureekka SA --- com mais de 20 anos de existência --- é o ativo mais valioso nesta configuração: elimina a necessidade de constituir a Gamine como empresa nesta fase.


10. Arquitetura Open-Source de Repurpose Multi-Plataforma (v3)

A partir desta secção, o documento descreve a camada técnica acrescentada na v3. O princípio fundador é simples: a Marta continua a produzir uma única vez no Instagram (posts e Reels, com Canva Pro e a agência). A partir daí, o stack VPS adapta o conteúdo para cada plataforma destino e publica via API oficial, sempre com aprovação humana antes da publicação final.

10.1 Os Três Planos Lógicos

Toda a arquitetura assenta em três planos que têm de ser cuidadosamente separados --- misturá-los é o erro recorrente de propostas comerciais como Repurpose.io ou stacks compostos por SaaS empilhados.


Plano Função Onde Vive Quem Vê


Captura Lê o que a Marta publicou no VPS Eureekka Só código IG via webhook oficial (FastAPI) próprio

Transformação Adapta vídeo/imagem/legenda VPS Eureekka Só código para cada destino com regras (ffmpeg, Whisper próprio Brand Book local)

Distribuição Publica via APIs oficiais VPS Eureekka → Plataformas OAuth --- uma chamada por APIs externas destino plataforma


10.2 O Que a Marta Continua a Fazer

Nada muda no fluxo da Marta. Ela e a agência continuam o trabalho atual:

  • Produzir o Reel ou post no Canva Pro com Brand Book aplicado

  • Publicar nativamente no Instagram via app oficial (não há mudança no acto de publicação primária)

  • Aprovar as variantes que o sistema gera para outras plataformas, via PWA ou Telegram (5 segundos por peça)


O princípio é absoluto: a Marta nunca perde tempo a publicar duas vezes. O sistema produz as variantes e ela apenas confirma com um toque. Isto preserva autenticidade, evita burnout e respeita a fronteira humano-máquina.


10.3 Mapa de Fluxo End-to-End

O fluxo desde a publicação no Instagram até à distribuição nas restantes plataformas:


Passo Onde Acontece Tempo Intervenção Humana


1. Marta publica Reel Telemóvel da Marta Já acontece Total --- é o no Instagram via app hoje acto criativo

2. Meta dispara Meta → gam-ingest \<30 Nenhuma webhook para o VPS segundos

3. gam-ingest Redis no VPS \<5 Nenhuma enfileira segundos
processamento

4. gam-transform ffmpeg + Whisper local + 1-3 minutos Nenhuma extrai áudio e gera Ollama
variantes

5. Six Eyes scoring Worker no VPS \<30 Nenhuma autónomo segundos

6. gam-review VPS → Telegram \<10 Marta abre, vê notifica Marta segundos previews (Telegram + PWA)

7. Marta aprova (1 PWA 5-15 Total --- gate toque por peça) admin.joaoluisbrazao.com segundos humano

8. gam-publish VPS → APIs plataformas 2-5 minutos Nenhuma distribui via APIs
oficiais

9. gam-archive grava PostgreSQL + pgvector \<5 Nenhuma taxonomia + embedding segundos



Tempo total desde publicação IG até variantes propagadas (com aprovação rápida): aproximadamente 5 minutos. Esforço extra da Marta: 1 clique por peça, \~5 segundos. Esta proporção é o que torna o sistema sustentável.


11. Stack Técnico Open-Source

Cada componente é open-source, auditável, e corre no VPS Eureekka. A Meta e demais plataformas nunca vêem este código --- apenas as chamadas finais via API oficial.

11.1 Componentes no VPS Eureekka


Componente Função Stack Licença


gam-ingest Webhook Meta + polling FastAPI · Pydantic MIT fallback. Captura Reel/Post v2 · Redis
novo 30s após publicação

gam-transform Pipeline de adaptação Python asyncio · MIT / LGPL multi-formato (Pinterest, ffmpeg · MoviePy
YouTube Shorts, FB nativo,
LinkedIn)

Transcript engine Áudio → texto português faster-whisper · MIT europeu (Whisper local, sem modelo large-v3
terceiros)

Frame extraction Identifica frames-chave PySceneDetect · BSD / LGPL para thumbnails Pinterest ffmpeg

LLM Gera legenda adaptada e Ollama local OU MIT (Ollama) legendas/hashtags hashtags contextuais OpenRouter

Embedding Taxonomia automática para nomic-embed-text Apache 2.0 semântico gam-archive via Ollama

Storage media Armazena variantes geradas MinIO ou disco AGPL (3 dias retenção, depois directo
purga)

gam-review PWA de aprovação humana com React (vanilla) · MIT previews lado-a-lado FastAPI · Nginx

gam-publish Clientes API oficiais por Python · requests MIT plataforma · OAuth

gam-archive Catálogo editorial PostgreSQL · PostgreSQL / pesquisável + base para pgvector Apache 2.0 blog

Notificações Alerta Marta quando há Telegram Bot API --- peças para aprovar

Secrets Tokens OAuth de todas as Vaultwarden (já em AGPL plataformas produção)


11.2 APIs Oficiais por Plataforma

A regra é absoluta: para cada plataforma destino, ou existe API oficial OAuth, ou a publicação fica manual com o vídeo já adaptado e pronto na fila de aprovação. Nunca scraping, nunca automação de login.


Plataforma API Oficial Cliente Open-Source Estado para Gamine


Facebook Page Meta Graph API facebook-sdk (Python, ✅ Pronto --- usar oficial) BM Eureekka

Instagram Meta Graph API Wrapper Python sobre Graph ✅ Pronto --- após Business v18+ Bloco B2

YouTube Shorts YouTube Data API google-api-python-client ✅ Pronto --- criar v3 (oficial) projeto GCP

Pinterest Pinterest API v5 requests directo (REST ✅ Pronto --- simples) developer account

LinkedIn Marketing linkedin-api-python ✅ Pronto --- Developer Eureekka company Platform page

TikTok Content Posting TikTok for Developers ⚠️ Candidatura ou API (aprovação 2-6 semanas) manual

Snapchat Sem API orgânica --- 🔴 Manual ou skip

Telegram (HITL) Telegram Bot API python-telegram-bot ✅ Pronto


11.3 Diagrama Lógico

O diagrama abaixo representa o fluxo completo. Setas com \'auto\' são fluxos automáticos via API; setas com \'manual\' indicam acção da Marta.


Fluxo Lógico --- Gamine Repurpose Pipeline v3


Marta + Agência produzem em Canva → publicam em Instagram (manual) ↓ [webhook Meta Graph official] ↓ ┌─────────────────────────────────────────────────────────┐ │ VPS Eureekka (Hostinger → Hetzner) │ │ │ │ gam-ingest (FastAPI + Redis) │ │ ↓ │ │ gam-transform (ffmpeg + Whisper local + │ │ Ollama + MinIO + Brand Book) │ │ ↓ │ │ PostgreSQL + pgvector (gam-archive · taxonomia) │ │ ↓ │ │ Six Eyes scoring autónomo │ │ ↓ │ │ gam-review (React PWA + FastAPI) │ │ ↓ │ │ [Marta aprova via PWA ou Telegram --- 1 toque] │ │ ↓ │ │ gam-publish (clientes API oficiais OAuth) │ └─────────────────┬───────────────────────────────────────┘ │ ┌────────┬────────┼────────┬──────────┬──────────┐ ↓ ↓ ↓ ↓ ↓ ↓ Facebook YouTube Pinterest LinkedIn TikTok Snapchat Graph Data API v5 Mkt API manual manual (auto) (auto) (auto) (auto) (queue p/ (skip Marta) recomendado)


12. Soberania Digital e Decisões Open-Source

O princípio enquadrador desta arquitetura é a soberania digital máxima já adotada noutras dimensões do ecossistema (Vaultwarden, Joplin Server, WireGuard sovereign network, migração de Google e Microsoft para Proton). A v3 estende este princípio à camada de publicação social --- a última fronteira onde a Gamine dependia de terceiros.

12.1 Componentes 100% no VPS


Camada Componente Open-Source Substitui (SaaS comum)


Processamento vídeo ffmpeg + MoviePy + Repurpose.io engine, PySceneDetect Descript pago

Transcrição áudio faster-whisper local OpenAI Whisper API, (modelo large-v3) Otter.ai

LLM Ollama local (Llama 3.3 ou OpenAI API, Anthropic legendas/hashtags Qwen 2.5) directa

Embedding semântico nomic-embed-text via Ollama OpenAI text-embedding-3

Storage media MinIO local AWS S3, Cloudinary

Queue Redis (já em produção) Celery Cloud, AWS SQS

Web framework FastAPI ---

Base de dados PostgreSQL + pgvector Supabase, Pinecone

Frontend HITL React vanilla + Tailwind --- CDN

Notificações HITL Telegram Bot API Slack, Discord

Secrets Vaultwarden (já em AWS Secrets Manager, produção) Doppler


12.2 Decisão Pendente --- LLM Local vs OpenRouter

Esta é a única decisão arquitectural que continua em aberto à data desta versão. As legendas e hashtags contextuais geradas pelo pipeline podem correr de duas formas:


Critério Ollama Local OpenRouter (Gemini 2.5 Flash)


Soberania Total --- nada sai do Metadados enviam-se a VPS terceiros

Custo recorrente €0 \~€2-5/mês total Gamine

PII risk Zero Baixo (sem PII no input)

Latência 20-90s por peça (CPU) / 1-3s 5-15s (GPU)

Recursos VPS Precisa de >32GB RAM ou Negligível GPU

Qualidade output Boa (Llama 3.3 70B) Excelente (Gemini 2.5)

Plano B --- Mac Possível via WireGuard ao --- home server MBP15 home



Recomendação técnica: começar com OpenRouter no Sprint 2 (rápido de pôr em produção, custo trivial, sem PII no input), e migrar para Ollama local quando o Hetzner com GPU adequada estiver provisionado ou o Mac home server estiver integrado via WireGuard como backend Ollama. Esta migração é uma troca de URL endpoint --- não é refactor.


12.3 SaaS Excluídos Explicitamente

A v3 elimina ou exclui os seguintes serviços, listados com a razão da exclusão:


Serviço Função Original Razão da Exclusão


Repurpose.io Distribuição Substituível por ffmpeg + APIs multi-plataforma oficiais; €15-25/mês recorrente; opaco a logs

Buffer Scheduling Idem; API oficial elimina cross-platform necessidade

Hootsuite Scheduling Sobre-engineering para escala da enterprise Gamine; €49+/mês

OpenAI Whisper Transcript faster-whisper local atinge API qualidade idêntica, custo zero

Cloudinary CDN + transformações ffmpeg local resolve; vídeo armazenamento curto via MinIO

Zapier / Make Orquestração entre n8n já deprecado para tools intelligence engines; FastAPI workers nativos


13. Estratégia Anti-Flag e Segurança Operacional


Este capítulo é o mais importante do v3. A preocupação fundadora do João --- \'que a Meta ou outras plataformas vendo posts efectuados por plataformas não certificadas façam flag como spam\' --- é tecnicamente legítima e estatisticamente fundada. A arquitetura v3 é desenhada precisamente para eliminar este risco a zero.


13.1 Por Que a Categoria \'App OAuth Própria\' é Mais Segura que Qualquer SaaS

Existe um equívoco comum: assumir que \'tool certificado\' é sempre mais seguro que \'código próprio\'. Não é. A certificação Meta Marketing Partner garante que o software respeita as APIs --- mas as APIs são as mesmas que a Gamine Analytics App da Eureekka usa directamente. A diferença é apenas de embalagem comercial.

A Meta avalia três sinais quando classifica um publicador:

  • Identidade OAuth (qual App ID está a fazer a chamada)

  • Padrão de comportamento (rate, horários, diversidade, conteúdo)

  • Histórico de denúncias e qualidade do conteúdo

Para os três sinais, a Gamine sob o BM Eureekka é tratada exactamente como qualquer Meta Marketing Partner --- está dentro das regras formais da Meta.

13.2 Regras de Ouro do gam-publish

Estas regras estão hard-coded no módulo gam-publish e são auditáveis no código. Não são \'best practices\' opcionais --- são parte da especificação.


Regra Implementação Razão


Respeitar rate 200 req/h IG Graph, É o sinal mais forte de boa limits oficiais 10K quota/dia YouTube, fé etc.

User-Agent Gamine-Publisher/1.0 Transparência valorizada identificado e (contact: pelas plataformas contactável marta@gamine.org)

Cap de publicações Máximo 4-5 Padrões superiores são diárias por peças/dia/plataforma spam-like para marca pequena plataforma

Jitter de 2-15 random.uniform(120, Padrões cronométricos ao minutos nos horários 900) antes de cada segundo são sinal de bot call

Captions distintas Pipeline gera caption Facebook penaliza cross-post por plataforma próprio por destino detectado

Hashtags removidas Regra hard no FB não usa hashtags e para FB transform layer penaliza-as como sinal de cross-post

Logs de auditoria de Tabela publish_audit Disputas futuras com cada publicação no PostgreSQL plataformas têm evidência

Backoff exponencial Wait 2\^n * jitter, Sinal de respeito pelas APIs em erros 429/503 máximo 3 retries

Webhook de Captura rejeições da Reage rápido a problemas bounceback plataforma e notifica
Marta


13.3 RGPD Art. 9 --- Saúde

A Gamine opera com conteúdo de saúde materno-infantil. Embora os Reels públicos da Marta não contenham PII de clientes individuais, qualquer pipeline que processe áudio ou texto desse domínio tem de respeitar o quadro RGPD Art. 9 já adoptado para o ecossistema MedVault.


Risco Mitigação no Stack v3


Transcript de áudio a faster-whisper local --- áudio nunca sai do VPS passar por terceiros

Hashtags/legendas a Input desinfectado: sem nome de clientes, sem passar por LLM externo dados clínicos; só metadata pública do post

Storage de variantes em MinIO local com retenção 3 dias; depois purgado CDN externo

Logs com PII de Apenas IDs públicos; nunca payload completo de seguidores ou DMs comentadores

Backups a sair do Backups via rsync para Hetzner (Alemanha) ou território UE disco home Lisboa


13.4 Segurança das Credenciais OAuth

São pelo menos 8 tokens OAuth distintos a gerir (Meta, YouTube, Pinterest, LinkedIn, TikTok caso aprovado, Telegram bot, MinIO, PostgreSQL). A regra é absoluta:

  • Todos os tokens vivem no Vaultwarden, nunca no .env em texto plano

  • O .env carrega placeholders; o app resolve via Vaultwarden Bitwarden Secrets Manager API

  • Rotação automática trimestral onde a plataforma o permite

  • Alertas Telegram em tentativas de uso fora do IP do VPS

  • Nunca commitar tokens --- pre-commit hook verifica e bloqueia

14. Six Eyes e Faseamento v3

14.1 Six Eyes --- Pressure Test da Arquitetura

Aplicação do framework Six Eyes à arquitetura v3 --- identificação dos pontos onde pode falhar e mitigações já incorporadas no design.


Eye Risco Identificado Mitigação na v3


Atenção Marta ignora fila SLA 4h; alerta Telegram escalado pendente, conteúdo morre a Alice; relatório semanal de na review queue variantes não-aprovadas

Emoção Conteúdo sobre tema Hashtag oculta #gam-sensitive no sensível (perda IG bloqueia auto-distribuição; gestacional, depressão fica só em IG nativo pós-parto) mal recortado
para Pinterest/LinkedIn

Enquadramento Variantes parecem AI slop Brand Book aplicado via e perdem autenticidade templates fixos (não geração Gamine visual); só re-encode e re-recorte, nunca composição nova

Estrutura Facebook detecta Upload nativo, caption cross-post e penaliza reescrito, hashtags removidas (Regras 13.2)

Contraste Pinterest puxa público OK para vouchers (gifters fora de Lisboa --- geograficamente dispersos); desperdício para serviço bloqueado para Reels de serviço domiciliário directo

Integridade RGPD Art. 9 --- saúde. faster-whisper local; só Transcripts via API metadata pública passa por LLM externa violam quadro externo


14.2 Faseamento de Implementação

O desenvolvimento segue o padrão Software Factory do João --- sprints curtos, TDD por hábito, gates de qualidade entre fases.

Sprint 1 (Semana 1-2) --- Captura e Arquivo

  • gam-ingest com webhook Meta funcional

  • Backfill dos 2.459 posts (já estava no plano v2 --- completar)

  • gam-archive com PostgreSQL + pgvector populado

  • Painel \'histórico editorial pesquisável\' como vista no admin

  • Candidatura à TikTok Content Posting API (prazo longo, começa já)

  • Criar projetos no Google Cloud (YouTube), Pinterest Developer, LinkedIn Developer

Saída do Sprint 1: métricas reais no dashboard + ingestão automática de posts novos. Ainda não há distribuição, mas a Marta já vê valor (analytics reais).

Sprint 2 (Semana 3-4) --- Transform + 2 destinos

  • gam-transform com pipeline completo: re-encode, transcript, frame extraction, legenda LLM

  • Distribuição apenas para Facebook nativo + YouTube Shorts (validar com universo controlado)

  • HITL via Telegram simples --- sem PWA ainda

  • Six Eyes scoring autónomo a funcionar

Saída do Sprint 2: Marta publica 1 Reel no IG → recebe Telegram com 2 variantes → aprova → publicam no FB e YouTube em \<5 minutos. Loop fechado.

Sprint 3 (Semana 5-6) --- PWA + Pinterest

  • gam-review PWA com previews lado-a-lado

  • Roles: Marta (aprovar), Alice (fallback), agência (sugerir)

  • Pinterest entra no pipeline (foco vouchers/gifters)

  • Edição inline de captions e hashtags antes de aprovar

Sprint 4 (Semana 7-8) --- LinkedIn + Newsletter feed

  • LinkedIn corporate (apenas peças com tag #gam-corporate)

  • Feed RSS do gam-archive → Brevo/Mailchimp para newsletter

  • TikTok entra se API aprovada; senão, fica fila manual com vídeos prontos

Sprint 5+ (Mês 3+) --- Refinamento e Integração CMS

  • Integração com Directus quando o CMS Astro estiver migrado (plano Hostinger→Hetzner)

  • Migração de OpenRouter para Ollama local se decisão 12.2 for tomada

  • Análise mensal de performance multi-plataforma e ajuste de regras

14.3 Tabela de Decisões Pendentes

Estas quatro decisões precisam de confirmação do João para fechar a especificação técnica final:


# Decisão Recomendação v3 Confirmação


D1 LLM: Ollama local ou OpenRouter inicial, Pendente OpenRouter para migrar Ollama quando
legendas/hashtags? GPU disponível

D2 TikTok: candidatar à Content Skip por agora Pendente Posting API ou skip? (alinhado com
diagnóstico
Marketing); revisitar
Mês 6

D3 Snapchat: incluir manual ou Excluir --- audiência Pendente excluir definitivamente? residual para Gamine

D4 Metricool: manter (só Manter no Sprint 1-4; Pendente analytics) ou eliminar e eliminar no Sprint 5
construir dashboard? se dashboard próprio
bastar


Síntese Executiva v3

A versão 3 deste documento mantém integralmente o trabalho da v2 (diagnóstico Meta, configuração Eureekka SA, manual operacional) e acrescenta a camada arquitectural que estava em falta: o motor de repurpose multi-plataforma.

O resultado é um sistema completo onde a Marta produz uma única vez no Instagram com a Canva Pro e a agência, e o stack open-source no VPS Eureekka --- usando exclusivamente APIs oficiais OAuth --- distribui as variantes adaptadas para Facebook, YouTube Shorts, Pinterest e LinkedIn, com 5 segundos de aprovação humana por peça.

O custo recorrente é €0-5/mês, o risco de bloqueio por flag é eliminado a zero, e a soberania digital fica preservada como princípio fundador. O sistema é integralmente auditável, integralmente português em jurisdição, e integralmente substituível porque é open-source.


Próximo passo imediato: confirmar as quatro decisões pendentes (Secção 14.3) e arrancar Sprint 1 --- Captura e Arquivo. Esta especificação está pronta para entrar em desenvolvimento via Claude Code SSH no fluxo habitual.



Gamine Back Office · Sistema de Inteligência de Conteúdo · Eureekka SA

v3.0 --- 16 de Maio de 2026 --- Arquitetura Open-Source · Repurpose Multi-Plataforma