BB Baterias · Mapa de Conhecimento

Segundo Cérebro

Conexões entre projetos · Padrões reutilizáveis · Lições aprendidas

16
Projetos ativos
8
Padrões prontos
61
Erros mapeados

// Mapa de conexões — passe o mouse sobre as trilhas

Reutilizar sempre

Cloudflare Pages + wrangler
Deploy em ~5min, grátis, URL estável. Token e account ID já salvos na memória.
Worker como proxy CORS
Resolve CORS de qualquer API sem mexer no backend. Reutilizar o padrão do Painel Unificado.
🔑
Autenticação GM + Estagiários
GM com senha hash · Estagiários só com nome. Mesmo padrão nos 3 painéis de equipe.
🟢
Semáforo visual de metas
Verde/amarelo/vermelho validado com o usuário. Já usado em Portal de Provas e Painel Unificado.
📊
Google Sheets como banco
API Key pronta. Apps Script para lógica. Persistência leve sem backend real.
Cache KV na frente de Apps Script lento
Worker com Cron Trigger grava em KV; Pages Function serve na hora, com bypass manual. Nunca mais tela de erro por Apps Script congestionado.

O que funciona

HTML único sem framework Zero build, zero dependência — atualiza arrastando um arquivo
Audit-based para Zendesk Único jeito correto de contar produção diária por agente. updated_at falha.
Gabarito com array de respostas Aceitar múltiplas respostas corretas evita injustiça com o aluno
overflow-x auto no container do heatmap width:fit-content no grid interno + overflow-x:auto no container
Correção retroativa via painel admin Corrigir gabarito sem apagar histórico — doPost update no Apps Script
localStorage para estado leve Preferências, login, gabarito alternativo — sem banco de dados
Ler dado exato de um endpoint em vez de OCR de print action=alts do Apps Script devolve o JSON certo — nunca transcrever código de imagem pixelizada
Catálogo VTEX público pra conferir código real /api/catalog_system/pub/products/search?ft= — código de verdade, sem inventar de cabeça

Erros mapeados

Copiar Apps Script do chat Caracteres invisíveis causam SyntaxError. Sempre usar o arquivo .gs salvo em disco.
Chamar script.google.com direto do navegador Quem tem 2+ contas Google pode cair em 404 imprevisível. Sempre proxy via Cloudflare Pages Function.
wrangler kv get/list sem --remote Lê o KV simulado local, não o de produção — parece vazio mesmo com dado real salvo.
updated_at do ticket Zendesk Falsos positivos — conta tickets onde outro agente respondeu hoje
Vídeo Drive embutido em iframe de outro domínio Capa carrega, reprodução falha com cookie de terceiros bloqueado. Preferir link direto como fallback.
Gabarito de prática em texto livre Time treinado a responder com código — "DDR4 16GB" derrubou acerto pra 0-12%. Usar código BB.
GitHub Pages e Netlify Conta excluída / confusão com domínio pago. Cloudflare é o padrão definitivo.
Modal ampliado só se TODAS as lições forem PDF Treinamento com PDF+vídeo misturado nunca alargava — checar também o caso misto.

// mostrando um recorte curado — a lista completa das 61 lições e 8 padrões vive em knowledge_lessons_learned.md / knowledge_stack_patterns.md (memória do Claude)

Checklist — antes de começar qualquer projeto novo

Qual é a fonte de dados? (Sheets / API / Firebase)
Precisa de proxy CORS? → usar padrão Worker
Tem autenticação? → usar padrão GM + Estagiários
Tem metas visuais? → usar semáforo verde/amarelo/vermelho
Tem histórico por período? → considerar heatmap
Precisa de lógica backend? → Apps Script salvo em disco (.gs)
Deploy: Cloudflare Pages via wrangler
Endpoint lento sob carga? → cache KV + Worker com Cron Trigger
Atualizar Hub de Projetos após criar