Painel MMC

📊 Esteira de Aprovação

Todos os lotes de conteúdo, de todos os clientes, num lugar só. Semáforo de prazo e erros em destaque.

O caminho de uma peça

Produção → Aprovação do CS → link para o cliente → Aprovação do cliente → distribuição automática → publicado

A distribuição dispara no instante em que o cliente aprova o último item do lote. Não existe robô passando depois: lote aprovado ontem não é distribuído hoje sozinho.

Prazo de aprovação

O prazo é de 3 dias úteis a partir da geração do link.
Ele nunca passa das 18h de dois dias antes da primeira postagem — assim sobra um dia útil inteiro para reagir se o cliente aprovar em cima do prazo.
Se o lote for montado muito em cima da data, o Painel avisa na hora de gerar o link. Se aparecer esse aviso, adie as datas em vez de seguir.

E se o cliente aprovar depois da data de publicação?

Acontece, e o sistema resolve sozinho — de um jeito diferente por canal, porque o risco é diferente:

Canal	O que acontece
📝 Blog	Conteúdo atemporal. Vai para o próximo dia útil, no mesmo horário. Sem perguntar.
📷 Instagram / Facebook 📍 Google Meu Negócio	Pode ser datado (Black Friday, prazo do Simples). Reprograma só se o atraso for de até 2 dias. Passou disso, a peça para com erro e espera uma data nova sua.
📄 Documento	Não tem data de publicação — é marcado como entregue na aprovação.

Toda reprogramação fica registrada na peça (data antiga, data nova e motivo). Nada é movido em silêncio.

Por que nunca publicamos "no passado"

Agendar com data vencida faz o Instagram, o Facebook e o Google publicarem na hora. Já aconteceu de um lote antigo soltar dezenas de posts de uma vez no perfil do cliente. Por isso a regra é: ou reprograma para frente, ou para e avisa. Nunca solta.

Quando a peça trava — e o que fazer

O que você vê	O que fazer
“a data prevista passou há X dias”	Escolha uma data nova na peça e mande distribuir de novo.
“cliente X sem token do GHL cadastrado”	Cadastrar o token na aba 🔌 Acessos do cliente.
“não está conectado no Social Planner”	Conectar a rede na subconta do cliente no GHL.
Post de evento ou oferta saiu como “novidade”	Normal: o Google exige data de evento / cupom. Sem esses dados, publicamos como novidade em vez de inventar.

Boas práticas

Monte o lote com folga. A primeira postagem deve estar a pelo menos 4 dias da geração do link.
Nada de conteúdo datado em cima da hora. Campanha com data fixa precisa de aprovação com semanas, não dias.
Confira a coluna “Foi ao ar?”. Se o time publicou por fora, marque ali — é assim que o Painel aprende.
Peça vermelha na Lista não some sozinha. Alguém precisa resolver e mandar distribuir de novo.

Kanban acompanha o lote · Lista acompanha cada peça

👥 Usuários e Grupos

Admin vê tudo. Membros veem só os clientes dos grupos que você liberar. Clientes são atribuídos a um grupo no cadastro.

Grupos de clientes

Convidar pessoa

Só quem for convidado consegue entrar. A pessoa faz login com o Google e já entra com o nível e os grupos definidos aqui. E-mail de fora da MMC (ex.: Gmail) também pode — mas o Gmail precisa estar como usuário de teste no app "Painel MMC" do Google Cloud.
Admin = tudo · Editor = trabalha nos clientes dos grupos (escreve dados, documentos, aprovações) · Leitor = só consulta (pode comentar e anotar).

Membros

⚡ Skills da Agência

Skills instaladas no Claude Code. Edições no painel atualizam o Supabase — use "Baixar" para salvar o SKILL.md localmente.

⚡

Carregando skills...

🧠 Aprendizado

Regras que a IA aprendeu com as reprovações dos clientes. Ela aplica isso ao gerar novos conteúdos. Ajuste a categoria, o escopo ou arquive — e escreva uma observação se precisar.

🧠

Carregando…

📊 Carteira

Performance de todos os clientes, direto do banco próprio. O relatório de cada cliente fica dentro dele (aba Relatório).

📈

Selecione um cliente.

📖 Guia de Uso — Painel MMC

Como o painel funciona, como usar as skills e o fluxo de trabalho com clientes.

O que é o Painel MMC

Ferramenta exclusiva do time interno para centralizar histórico de entregas, documentos estratégicos e interações com o Claude para cada cliente.

Não é um CRM de vendas nem substituto do ClickUp. É a memória do Claude sobre cada cliente — para que qualquer membro do time retome o contexto sem buscar em planilhas ou WhatsApp.

Estrutura: Cliente → Pastas → Histórico & Artefatos

Dentro de cada cliente, o conteúdo é organizado em 📁 Pastas (ex.: Demandas Gerais, Social Media, Google Meu Negócio). A visão 📂 Todos é a padrão e soma tudo.

Só aparecem pastas com conteúdo (com contador de itens)
+ Nova pasta cria uma pasta na hora (ex.: um projeto novo)
A pasta selecionada filtra o Histórico e os Artefatos ao mesmo tempo
Demandas Gerais é o destino padrão do que não tem pasta específica

📋 Histórico & 🎨 Artefatos

Histórico: lista cronológica das entregas da pasta selecionada. Artefatos: material publicado com link direto em painel-mmc.pages.dev/artefatos/[código]/[slug] — o Cloudflare tira o .html da URL, então grave já sem a extensão.

Atenção: a pasta de artefatos é pública, sem login. Base de leads, exportação do CRM ou planilha com telefone/CNPJ em massa nunca vai para lá — só para o Histórico. Veja a regra base-de-contatos na aba ao lado.

📄 Documentos

4 docs por cliente — Tom de Voz, Contexto Estratégico, Memória Viva e 🔐 Credenciais. São do cliente inteiro (não de uma pasta): botão fixo no topo, ao lado de Editar.

Como usar no dia a dia

1

Início: Mencione o cliente — carregar-cliente ativa, carrega contexto e identifica o projeto.

2

Trabalho: Claude usa os documentos carregados para produzir com contexto completo.

3

Fim: registrar-no-painel grava a entrega. Não é automático — é o último passo obrigatório de toda skill, e ele consulta as Regras de Registro (aba ao lado) para saber onde gravar.

Se o Claude terminar sem dizer onde gravou, a entrega provavelmente não foi registrada. Cobre: "registrou no Painel?"

✅ Aprovações — esteira de conteúdo

Claude produz o lote (enviar-para-aprovacao) → designer anexa a arte no próprio Painel → CS revisa e gera o link (📲 botão de WhatsApp pronto) → cliente aprova/comenta num link sem login → aprovou 100% → distribuição automática em todos os canais: GMN (com botão CTA), Instagram/Facebook (feed, carrossel, story), Blog WordPress (agendado com SEO) e E-mail (GHL) + registro no Histórico + avisos no ClickUp.

Link do cliente: painel-mmc.pages.dev/aprovar/?t=… (válido 30 dias, escopo de 1 lote). Falha de publicação nunca é silenciosa — o item fica marcado "⚠️ Erro ao publicar".

As três skills que sustentam o ciclo

carregar-cliente

Abre o contexto. Ativa ao mencionar qualquer cliente por nome ou código (FRA, ROS…): lê os 4 documentos no próprio Painel, consulta os projetos e confirma antes de prosseguir. Cliente arquivado não recebe entrega nova.

"Abre o contexto da Franco""Vou trabalhar com o [FRA]"

a skill do trabalho

Produz a entrega: calendário, relatório, material rico, LP, proposta, criativos… Veja a lista completa e o que cada uma faz em ⚙️ Configurações → ⚡ Skills, que é a fonte viva (esta tela não repete a lista para não ficar desatualizada).

"Cria o calendário de julho""Relatório do mês da Aquino"

registrar-no-painel

Fecha o ciclo. Toda skill de produção termina chamando esta. Ela consulta as Regras de Registro (aba ao lado) para decidir os destinos — não improvisa. Publica primeiro, registra depois, e confirma dizendo onde gravou.

"Registra isso no painel"Obrigatória no fim de toda skill

Fluxo completo — exemplo

1. "Cria o calendário de social da Franco para julho"
   → carregar-cliente ativa e traz o contexto
   → Contexto: FRA | CS: Jorge | Projeto: Social Media
   → Calendário gerado com base na Memória Viva (mai/jun)
   → registrar-no-painel consulta a regra 'calendario-conteudo'
   → grava em Histórico + atualiza a Memória Viva
   → responde: "✅ Registrado: Calendário jul/2026 → 📋 Histórico"

O Google Drive não é mais usado em nenhuma etapa. Tudo — contexto, entrega e material — vive aqui no Painel.

Arquitetura do Sistema

💻 Local (Mac do Thiago)

📁 Google Drive

Tom de Voz · Contexto · Memória · Credenciais

⚡ SKILL.md files

~/Library/.../skills/*/SKILL.md

🐍 sync_skills.py

painel-mmc/sync_skills.py

🔧 Claude Hook

PostToolUse → Edit/Write → SKILL.md

REST API →

← Supabase JS

hook dispara sync →

deploy → CF Pages

☁️ Cloud

🗄️ Supabase (PostgreSQL)

clients · projects · deliveries · documents · artifacts · skills

🌐 Cloudflare Pages

painel-mmc.pages.dev · /artefatos/[código]/[slug].html

🔐 Supabase Auth

Login por e-mail/senha — RLS em todas as tabelas

Banco de Dados — Estrutura

clients

id UUID PK

name · code · plan

health · cs · instagram · notes

→ projects, documents, deliveries, artifacts

projects

id UUID PK

client_id FK → clients

name · type · is_default

→ deliveries, artifacts

deliveries

id UUID PK

client_id · project_id FK

type · title · content (Markdown)

created_at TIMESTAMPTZ

documents

id UUID PK

client_id FK → clients

type · content (Markdown)

UNIQUE (client_id, type)

tipos: tom_de_voz · contexto_estrategico · memoria_viva · credenciais

artifacts

id UUID PK

client_id · project_id FK

title · url · slug · type

url: painel-mmc.pages.dev/artefatos/[código]/[slug].html

skills

id UUID PK

slug UNIQUE · name · description

content (SKILL.md completo)

updated_at TIMESTAMPTZ

sincronizado via sync_skills.py

Fluxos Principais

📥 Carregar cliente

Usuário menciona cliente

↓

carregar-cliente ativa (skill)

↓

Busca no ClickUp (dados)

↓

Lê Drive: Tom de Voz + Contexto + Memória

↓

Consulta projects no Supabase

↓

Confirma contexto + projeto ativo

📤 Registrar entrega (texto)

Entrega concluída (calendário, análise...)

↓

registrar-no-painel ativa (Fluxo A)

↓

POST /rest/v1/deliveries

↓

Aparece em Histórico no painel

🎨 Publicar artefato visual

Claude gera HTML visual

↓

Salva em /artefatos/[código]/[slug].html

↓

wrangler pages deploy (~10s)

↓

POST /rest/v1/artifacts (URL permanente)

↓

Aparece em Artefatos com botão "Abrir"

⚡ Sincronizar skills

Claude edita um SKILL.md

↓

Hook PostToolUse dispara

↓

sync_skills.py lê todos os SKILL.md

↓

PATCH /rest/v1/skills (upsert)

↓

Painel atualizado em tempo real

Stack Tecnológico

🌐

Cloudflare Pages

Hosting do painel e artefatos. Deploy via wrangler CLI. Domínio: painel-mmc.pages.dev

🗄️

Supabase

PostgreSQL gerenciado. Autenticação, REST API, RLS por usuário autenticado. Projeto: xcazywmzpqjmosptkwpz

⚡

Claude Code Skills

SKILL.md locais em ~/Library/.../skills/. Sincronizados via hook automático ao editar.

📁

Google Drive

Fonte de verdade dos documentos (.md). Lidos via carregar-cliente, importados via Python script.

📄

SPA (index.html)

Single-page app em HTML/JS/CSS puro. Supabase JS v2 + marked.js via CDN. Sem frameworks.

🐍

Python Scripts

sync_skills.py (skills → Supabase). Env vars: SUPABASE_MMC_URL e SUPABASE_MMC_KEY em ~/.zshrc

Carregando…

Histórico

🔌 Acessos e integrações

Token de integração privada do GHL (PIT)

ID da subconta — opcional, mas evita erro

Deixando em branco, o Painel tenta adivinhar a subconta testando o token contra as que ele já conhece — e cliente novo no GHL ainda não está nessa lista. Se souber o ID (fica na URL da subconta, em /location/ID/), cole aqui: a conferência vira direta e não depende de lista nenhuma.

O Painel mostra as redes conectadas para você conferir antes de salvar. Depois de salvo o token não é mais exibido — nem para você. Quem lê o valor é só a automação que agenda os posts.

Dashboard

📊 Esteira de Aprovação

O caminho de uma peça

Prazo de aprovação

E se o cliente aprovar depois da data de publicação?

Por que nunca publicamos "no passado"

Quando a peça trava — e o que fazer

Boas práticas

👥 Usuários e Grupos

Grupos de clientes

Convidar pessoa

Membros

⚡ Skills da Agência

🧠 Aprendizado

📊 Carteira

📖 Guia de Uso — Painel MMC

O que é o Painel MMC

Estrutura: Cliente → Pastas → Histórico & Artefatos

📋 Histórico & 🎨 Artefatos

📄 Documentos

Como usar no dia a dia

✅ Aprovações — esteira de conteúdo

As três skills que sustentam o ciclo

Fluxo completo — exemplo

Onde cada coisa é gravada

Arquitetura do Sistema

Banco de Dados — Estrutura

Fluxos Principais

Stack Tecnológico

Painel MMC

Histórico

Artefatos

Lotes de conteúdo

✍️ Blog do MHubOne

📚 Histórico de conversas

🔌 Acessos e integrações

Dashboard

📊 Esteira de Aprovação

O caminho de uma peça

Prazo de aprovação

E se o cliente aprovar depois da data de publicação?

Por que nunca publicamos "no passado"

Quando a peça trava — e o que fazer

Boas práticas

👥 Usuários e Grupos

Grupos de clientes

Convidar pessoa

Membros

⚡ Skills da Agência

🧠 Aprendizado

📊 Carteira

📖 Guia de Uso — Painel MMC

O que é o Painel MMC

Estrutura: Cliente → Pastas → Histórico & Artefatos

📋 Histórico & 🎨 Artefatos

📄 Documentos

Como usar no dia a dia

✅ Aprovações — esteira de conteúdo

As três skills que sustentam o ciclo

Fluxo completo — exemplo

Onde cada coisa é gravada

Arquitetura do Sistema

Banco de Dados — Estrutura

Fluxos Principais

Stack Tecnológico

Painel MMC

Histórico

Artefatos

Lotes de conteúdo

✍️ Blog do MHubOne

📚 Histórico de conversas

🔌 Acessos e integrações

✏️ Editar copy

Novo Cliente

Registrar Entrega

Nova Skill