Hub Grupo CSV

Tema

Guia Operacional: Gerar Signal™ ​

Propósito: Gerar e publicar uma nova edição do Signal™, o resumo semanal de inteligência estratégica do Grupo CSV.

Regras Invioláveis ​

  1. O PDF do Signal™ deve ter exatamente 1 (uma) página. Essa restrição é absoluta. Ajustar diagramação, tamanho de fonte e comprimento dos resumos para garantir que todo o conteúdo caiba em uma única página A4.

  2. Português brasileiro com acentuação e cedilha em TODOS os artefatos. Isso inclui: PDF (títulos, resumos, observações), signal.md, metadata.yml, corpo do e-mail (text e html), assunto do e-mail, from_name, e qualquer outro texto gerado. Nunca omitir diacríticos por receio de encoding. A API csv-mail e a biblioteca fpdf2 aceitam UTF-8 nativamente. Violação desta regra invalida a edição.

  3. Consultar o Dicionário Oficial antes de gerar qualquer texto para garantir grafias corretas de nomes, instituições, projetos e siglas.

  4. Nunca usar replace_content para edições pontuais no Notion. Para correções de grafia ou atualizações parciais, usar exclusivamente o comando update_content com content_updates. O comando replace_content substitui TODO o conteúdo da página e só deve ser usado para reescrita total intencional. Violação desta regra causa perda de dados (incidente S11/2026).

  5. A numeração da edição é sempre a última edição publicada + 1. Consultar o sidebar (docs/.vitepress/config.mts) ou o docs/signal/index.md para confirmar o número correto antes de criar a pasta. NÃO usar a semana ISO do calendário. Exemplo: se a última edição publicada é S18, a próxima é S19, independentemente da semana do ano em que estamos.

  6. Logo no PDF: usar SEMPRE a versão negativa (branca) sobre o header azul. O arquivo correto é grupo_csv_logo_negative.png (logo horizontal full-color negative com fundo transparente). Nunca usar a logo azul padrão (grupo_csv_logo.png) sobre fundo azul — resulta em logo ilegível. Caminho do asset de referência: assets/visual-identity/grupo-csv/logo/png/grupo-csv_logo_horizontal_full-color_negative_transparent.png.

  7. Sidebar do VitePress é obrigatório. Toda nova edição DEVE ser adicionada ao arquivo docs/.vitepress/config.mts na seção /signal/. Sem essa entrada, a edição não aparece na navegação lateral do Hub.

Workflow de Geração ​

Este processo é executado semanalmente, tipicamente às segundas-feiras, para cobrir a semana anterior (D-7 a D-1).

Fase 1: Coleta de Sinais ​

  1. Varredura Notion: Buscar por todas as páginas criadas ou editadas na última semana que contenham palavras-chave relevantes (RADAR, EVS, Axys, decisão, estratégia, projeto, etc.).
  2. Varredura Gmail: Buscar por todas as threads de e-mail no mesmo período com os mesmos critérios de palavra-chave.
  3. Consolidação Bruta: Agregar todo o conteúdo textual (páginas do Notion e corpos de e-mail) em um único arquivo de trabalho (e.g., varredura_sNN.md).

Fase 2: Análise e Síntese ​

  1. Identificação de Fatos: Ler o conteúdo consolidado e identificar os 5 a 7 acontecimentos mais relevantes da semana. Um "fato" pode ser uma reunião importante, uma decisão tomada, o avanço de um projeto, uma nova parceria, ou uma movimentação de mercado.
  2. Categorização: Atribuir a cada fato uma tag de categoria, conforme o padrão-editorial.md.
  3. Síntese: Para cada fato, escrever um título claro e um resumo de 2 a 4 frases que capture o essencial do acontecimento.
  4. Outras Movimentações: Listar outros pontos relevantes, mas de menor impacto estratégico, em formato de bullet points.

Fase 3: Criação da Edição ​

  1. Determinar Número da Edição: Consultar docs/signal/index.md ou docs/.vitepress/config.mts. O número é a última edição publicada + 1. NÃO calcular pela semana ISO.
  2. Criar Estrutura de Pastas: No diretório signal/edicoes/AAAA/, criar uma nova pasta SNN (e.g., S19). Dentro dela, criar a subpasta assets.
  3. Criar signal.md: Usar o templates/signal_template.md para criar o arquivo signal/edicoes/AAAA/SNN/signal.md. Preencher com os fatos e movimentações sintetizados na Fase 2.
  4. Criar metadata.yml: Usar o templates/metadata_template.yml para criar o arquivo signal/edicoes/AAAA/SNN/metadata.yml. Preencher todos os campos.

Fase 4: Geração do PDF ​

  1. Atualizar Script: Atualizar o script tools/signal-pdf/signal-pdf-gen.py com o conteúdo da nova edição.
  2. Verificar Logo: Confirmar que LOGO_PATH aponta para grupo_csv_logo_negative.png (logo branca para header azul).
  3. Verificar Acentuação: Confirmar que TODOS os textos no script (PERIODO, EXECUTIVO, FATOS, OBSERVACOES) contêm acentuação e cedilha corretas em PT-BR.
  4. Executar Script: Rodar o script para gerar o PDF.
    bash
    python3 tools/signal-pdf/signal-pdf-gen-sNN.py
  5. Validar 1 Página: Confirmar que o PDF gerado tem exatamente 1 página. Se ultrapassar, reduzir resumos e reexecutar.
  6. Mover PDF: Copiar o arquivo PDF gerado (e.g., Signal_S19_2026.pdf) para a pasta signal/edicoes/AAAA/SNN/assets/.

Fase 5: Publicação no Repositório ​

  1. Espelhar Arquivos: Copiar a pasta da nova edição (signal/edicoes/AAAA/SNN/) para o diretório docs/signal/edicoes/AAAA/SNN/.
  2. Atualizar Índice: Editar o arquivo docs/signal/index.md, adicionando a nova edição à tabela de "Edições publicadas".
  3. Atualizar Sidebar: Editar o arquivo docs/.vitepress/config.mts para adicionar a nova edição na barra lateral do Signal™. Formato: { text: 'SNN — DD-DD Mês', link: '/signal/edicoes/AAAA/SNN/signal' }.
  4. Commit e Push:
    bash
    git add .
git commit -m "signal: publica Signal SNN/AAAA (DD-DD/MMM)"
git push

Fase 6: Envio por E-mail e Entrega ​

Obrigatório: O envio do Signal™ deve ser realizado exclusivamente pela skill /csv-mail (/home/ubuntu/skills/csv-mail/SKILL.md). Ler a skill antes de executar o envio.

  1. Enviar E-mail via csv-mail: Usar a API POST /send-template (template institucional) com o PDF anexo em base64. O header User-Agent: csv-mail-client/1.0 é obrigatório para evitar bloqueio Cloudflare 1010.
    • Endpoint: https://mail-api.grupocsv.com/send-template
    • Lista de distribuição:
      • guilherme@grupocsv.com
      • guilherme.thome@unimedgv.com.br
      • naline@grupocsv.com
      • naline.rocha@unimedgv.com.br
    • Tags obrigatórias: source:manus, project:signal
    • from_name: Guilherme Thomé (com acento obrigatório)
    • from_email: guilherme@mail.grupocsv.com
    • reply_to: guilherme@grupocsv.com
  2. Assunto do E-mail: Signal™ SNN/AAAA — Resumo Semanal Estratégico (DD a DD de mês) — com acentos e ™.
  3. Corpo do E-mail (text): Parágrafo breve indicando a edição, o período, o número de fatos estratégicos e os destaques principais. OBRIGATORIAMENTE em português brasileiro com acentuação e cedilha completas.
  4. Confirmar e Entregar: Após a confirmação do envio (verificar success: true e id retornado), o PDF é disponibilizado ao usuário para download.

Fluxo de Correção ​

Quando uma edição publicada contiver erro (formato, conteúdo, grafia), seguir este fluxo:

  1. Corrigir o PDF e o signal.md no repositório, substituindo a versão anterior. Não versionar a versão incorreta.
  2. Commit com mensagem: fix(signal): corrige edição SNN/AAAA — [descrição breve]
  3. Reenviar e-mail com assunto: Signal™ SNN/AAAA — Versão pós-correção
  4. O corpo do e-mail segue o padrão normal, sem menção explícita ao erro corrigido.
  5. Entregar o PDF corrigido ao usuário para download.

Salvaguardas para Edição no Notion (MCP) ​

Esta seção documenta o uso correto dos comandos de edição de conteúdo do MCP Notion, após incidente de perda de dados em S11/2026.

Comandos de Edição de Conteúdo ​

ComandoUso corretoParâmetrosRisco
update_contentEdições pontuais (search-and-replace)content_updates: array de {old_str, new_str, replace_all_matches}Baixo — altera apenas o trecho encontrado
replace_contentReescrita total da páginanew_str: conteúdo completo novoALTO — apaga todo o conteúdo existente

Exemplo Correto — Correção de Grafia ​

json
{
  "page_id": "2fcdc8a9-...",
  "command": "update_content",
  "content_updates": [
    {
      "old_str": "Relay",
      "new_str": "Relay™",
      "replace_all_matches": true
    }
  ]
}

Exemplo ERRADO — Nunca Fazer ​

json
{
  "page_id": "2fcdc8a9-...",
  "command": "replace_content",
  "old_str": "Relay",
  "new_str": "Relay™"
}

Este comando apaga todo o conteúdo da página e substitui por "Relay™". O parâmetro old_str não pertence ao comando replace_content.

Regra Geral ​

  • Para correções de grafia, adição de termos ou atualizações parciais: sempre update_content.
  • Para reescrita total intencional (raro): replace_content com new_str contendo o conteúdo completo.
  • Antes de qualquer edição no Dicionário, fazer fetch da página para confirmar o conteúdo atual.

Checklist de Qualidade ​

  • [ ] O PDF tem exatamente 1 (uma) página? (REGRA INVIOLÁVEL)
  • [ ] A logo no PDF é a versão negativa (branca) sobre o header azul?
  • [ ] Acentuação e cedilha estão corretas em TODO o conteúdo (PDF, Markdown, e-mail)?
  • [ ] O número da edição foi confirmado via index.md/config.mts (última + 1)?
  • [ ] O PDF foi gerado em alta qualidade e revisado visualmente?
  • [ ] O nome do arquivo PDF segue o padrão Signal_SNN_AAAA.pdf?
  • [ ] O arquivo signal.md está preenchido e formatado corretamente?
  • [ ] O arquivo metadata.yml está completo e válido?
  • [ ] A nova edição foi adicionada ao docs/signal/index.md?
  • [ ] A sidebar do VitePress (config.mts) foi atualizada com a nova entrada?
  • [ ] Todos os links funcionam como esperado?
  • [ ] Todos os nomes conferem com o Dicionário Oficial?
  • [ ] O e-mail foi enviado para os 4 destinatários da lista de distribuição?
  • [ ] O assunto e corpo do e-mail contêm acentuação correta em PT-BR?