ModularReports: Jornadas dos Atores

Documentos da família

• DRS (modularreports), o que o sistema faz.
• Roadmap de Implementação (modularreports-roadmap), em que ordem construir e como verificar.
• Inventário de Artefatos (modularreports-inventario), tudo que precisa existir e como cada item deve ser.
• Plano de Testes (modularreports-testes), o que validar antes de entregar.
• Questionário de Elicitação (modularreports-questionario), decisões de produto em aberto.

Este documento descreve como cada papel opera o ModularReports, função por função, na cadeira do operador. Complementa o DRS (bloco 2, catálogo de atores e capacidades) com o passo a passo real: como a função começa, onde ela acontece, e o que a pessoa faz. Serve treinamento, onboarding e validação (o Plano de Testes usa uma jornada como base de cada item Beta).

Como ler

Cada papel é uma seção; cada função do papel é uma subseção com três perguntas: Como entra (o gatilho, quando a função começa), Onde entra (a tela, o sistema ou o canal) e O que faz (as ações e o resultado). Os papéis são canônicos do ModularHub (nenhum papel novo foi criado para o Reports, RF-ADM-002); os nomes usados aqui são funções, nunca pessoas.

Atores em uma linha

Super Admin

Ligar o módulo Reports para uma agência

• Como entra: uma agência nova (Company) precisa começar a usar o Reports, ou uma agência existente pede o módulo.
• Onde entra: painel do Super Admin, seção de entitlements do Hub.
• O que faz: liga o entitlement reports para a Company; a partir daí a entrada do Reports aparece para os usuários daquela agência sem novo deploy.

Criar a agência e o primeiro admin

• Como entra: uma agência parceira nova assina o uso do ModularReports.
• Onde entra: painel do Super Admin, cadastro de Company.
• O que faz: cria a Company e o primeiro usuário com papel admin; a partir daí o próprio admin gerencia o restante da agência (self-service).

Auditar uso

• Como entra: revisão periódica de uso do módulo, ou investigação pontual.
• Onde entra: painel do Super Admin e log de auditoria (reports.*).
• O que faz: consulta os eventos de publicar, republicar, revogar e encerrar cliente de qualquer agência; acompanha limites e retenção configurados por agência.

Ajustar limites, retenção e allowlist de fontes

• Como entra: necessidade de calibrar um limite global (ex.: teto de verbosidade) ou a allowlist de fontes de benchmark/pesquisa de mercado.
• Onde entra: painel do Super Admin, configuração global.
• O que faz: edita os parâmetros de escopo global do bloco 11 do DRS (allowlist, teto de verbosidade); parâmetros de escopo por agência ficam com o admin daquela agência.

Admin de agência

Gerenciar usuários da agência

• Como entra: um operador novo entra na agência, ou alguém sai.
• Onde entra: chrome do Reports, seção Usuários.
• O que faz: cria, edita e desativa usuários da própria agência; não enxerga nem altera usuários de nenhuma outra agência.

Definir a identidade visual da agência e dos clientes

• Como entra: onboarding da agência ou de um cliente novo, ou atualização de marca.
• Onde entra: chrome do Reports, seção Identidade da agência e ficha de cada cliente.
• O que faz: define logo e cor da própria agência (brandiza o chrome e o link público); preenche ou revisa a ficha de identidade visual e o tom de voz de cada cliente; declara a identidade padrão da agência para os casos em que a ficha do cliente está vazia.

Montar e manter templates

• Como entra: a agência tem um tipo de relatório recorrente (fechamento de campanha, comparativo, trimestral, sazonal) que quer padronizar.
• Onde entra: chrome do Reports, biblioteca de templates.
• O que faz: cria, edita, duplica e exclui templates (blocos padrão por tipo); também aprova quando um operador salva um relatório existente como template novo.

Acompanhar o painel de analytics agregado

• Como entra: rotina de acompanhamento da operação da agência.
• Onde entra: chrome do Reports, seção Analytics.
• O que faz: vê visualizações, último acesso, comentários não lidos e duração de produção dos relatórios da própria agência; não vê dados de nenhuma outra agência.

Decidir e executar o offboarding de um cliente

• Como entra: um cliente encerra o contrato com a agência.
• Onde entra: ficha do cliente, ação de encerrar.
• O que faz: encerra o cliente, revogando todos os links publicados de uma vez e disparando o processo de eliminação (apagar snapshots, anonimizar a origem: comentários, watermark, Contact) conforme a retenção configurada; o log de auditoria não é mutado, suas referências apenas deixam de resolver (RN-007).

Operador

Compor um relatório pelo wizard

• Como entra: chegou a hora de montar o relatório de um cliente (fechamento de campanha, comparativo, trimestral, sazonal).
• Onde entra: chrome do Reports, botão "Novo relatório", que abre o wizard de 4 passos.
• O que faz: escolhe cliente, período e template (passo 1); preenche o briefing canônico com KPI principal, intenção, destaques e identidade (passo 2); revisa o que a IA entendeu dos artefatos e a lista explícita "o que não achei" (passo 3); confirma a composição proposta bloco a bloco, cada número com a origem visível, e segue para o compositor (passo 4).

Curar o rascunho no compositor

• Como entra: a composição proposta pelo wizard está pronta para revisão humana.
• Onde entra: compositor, três colunas (artefatos e IA, preview, configuração).
• O que faz: edita o texto dos blocos, reordena, esconde o que não serve; pede para regenerar um bloco específico com uma instrução nova; insere criativos (imagens de anúncio); ajusta cor primária, logo e títulos do cliente dentro dos campos liberados; nunca edita à mão um número com proveniência.

Apresentar o rascunho em reunião

• Como entra: reunião de resultados com o cliente antes de publicar.
• Onde entra: compositor, modo apresentar.
• O que faz: abre a apresentação em tela cheia com o rótulo "rascunho" e sem os pins de comentário; navega pelos blocos; sai do modo apresentar sem ter publicado nada.

Publicar o link

• Como entra: o rascunho está curado e aprovado internamente.
• Onde entra: compositor, modal de publicação.
• O que faz: revisa a URL do link, define senha e expiração se quiser (opcionais), gera e confere o QR code, edita e revisa o card de compartilhamento (og:title, og:description, capa) com o preview de como aparece no WhatsApp, e publica; depois copia o link e o QR para enviar pelo canal que quiser (o sistema não envia automaticamente).

Republicar e revogar

• Como entra: um erro é corrigido no rascunho depois de já ter publicado, ou o cliente pede para tirar o link do ar.
• Onde entra: ficha do relatório publicado.
• O que faz: republica (o mesmo link passa a servir o snapshot novo, sem versionar a página, e fica registrado no histórico de alterações interno); ou revoga (o link passa a responder como revogado com página brandada, cache purgado).

Criar um cliente novo de dentro do Reports

• Como entra: um cliente novo chega enquanto o operador já está no fluxo de compor.
• Onde entra: chrome do Reports, atalho de criar cliente no wizard ou na lista de clientes.
• O que faz: cadastra o cliente (Account do Hub) sem sair do chrome do Reports; segue trabalhando no mesmo lugar.

Acompanhar e resolver comentários

• Como entra: o cliente comentou algo na página publicada.
• Onde entra: widget de comentário (drawer lateral) e a lista de comentários do relatório.
• O que faz: lê o comentário ancorado no bloco, responde ou age sobre o ponto levantado, e marca como resolvido; isso notifica o autor. Se o bloco comentado sumir numa republicação, o comentário continua visível com a marca "versão anterior".

Cliente final

Receber e ler a página de resultados

• Como entra: recebe o link (por WhatsApp, email ou qualquer canal, enviado manualmente pelo operador) ou lê o QR code.
• Onde entra: o link público, sem login.
• O que faz: lê o snapshot do relatório com a identidade visual da própria marca aplicada; se disponível, baixa o PDF; se o link estiver revogado ou expirado, vê uma página brandada da agência pedindo para solicitar um novo link.

Ativar acesso e comentar

• Como entra: quer comentar algo na página e ainda não tem sessão.
• Onde entra: a própria página pública, atalho de pedir acesso.
• O que faz: pede acesso, recebe um magic link do Hub, autentica; a partir daí o campo de comentário fica habilitado e consegue comentar ancorado num bloco específico da página; recebe notificação quando o comentário é resolvido pela agência.

Acompanhar os relatórios pelo portal logado

• Como entra: já tem acesso ativado e quer ver os relatórios num lugar só, sem depender de guardar cada link.
• Onde entra: o portal logado do cliente (opcional), pela sessão do Hub.
• O que faz: vê a lista dos relatórios publicados dos Accounts a que pertence, abre cada um pelo atalho e acompanha os comentários recentes; é só leitura, não compõe, não publica, não administra nada, e não enxerga relatório de cliente a que não pertence.