knowledge-base — Índice mestre¶
Base de conhecimento da Bepex (revestimentos de fachadas). Fonte única da verdade da documentação: só Markdown, versionado em Git. Este arquivo orienta a navegação — não carrega o conteúdo. Se você (humano ou IA) está entrando agora, comece por aqui.
Antes de operar, leia
PRINCIPIOS.md— as regras de como esta base é operada (remote-first, anti-rot, vendor-neutral). Elas moram no repo, não em ferramenta nenhuma.
Como está organizado¶
Árvore por disciplina no topo. Cada disciplina contém projetos (uma pasta por projeto).
Recortes cruzados (por tipo, status, tecnologia) ficam em indices/.
Automação é transversal — não é uma pasta. Cada automação mora na disciplina de negócio que
ela serve; o backbone técnico (n8n, Make, Chatwoot, SES, banco) mora em infra/.
As 8 disciplinas¶
| Pasta | O que é |
|---|---|
comercial/ |
Vendas, negociação, inteligência comercial. |
marketing-de-relacionamento/ |
Comunicação com quem já está na base. |
prospeccao/ |
Geração de leads novos / outbound frio. |
marketing/ |
Marketing outbound e inbound / aquisição (inclui tráfego pago). |
canais-digitais/ |
Locais onde clientes/prospects interagem conosco (chatbots, ecommerce, site). |
operacao/ |
ERP, pedidos, processos internos. |
infra/ |
Backbone técnico: instâncias, credenciais (ponteiros), stack, padrões de automação. |
dados/ |
BI, pipelines de dados, análises transversais. |
Onde vive cada projeto¶
| Projeto | Disciplina | Status |
|---|---|---|
| Caramelo | comercial | ativo |
| Conteúdo Infinito | marketing-de-relacionamento | ativo |
| Ofertas | marketing-de-relacionamento | ativo |
| Rede de Representantes | prospeccao | pausado |
| Prospecção de Arquitetos | prospeccao | pronto p/ ativar |
| Mapeamento de Decisores | prospeccao | arquivado (arquivo único) |
| Gestão de Tráfego Bepex (Google Ads) | marketing | ativo |
| Calendário Editorial / Blog | marketing | stub → Drive |
| Bê | canais-digitais | ativo |
| IA Chatwoot | canais-digitais | ativo |
| Ecommerces | canais-digitais | ativo |
| Agente Sobe Obras | canais-digitais | planejamento |
| Pedido de Compra Omie | operacao | ativo |
| Integração Pedidos de Venda | operacao | ativo |
| Pipedrive → BigQuery | dados | em montagem |
Visões cruzadas: indices/por-tipo.md · indices/por-status.md · indices/automacoes.md.
Anatomia de um projeto¶
<disciplina>/<projeto>/
├── README.md visão executiva + frontmatter (fonte de metadados)
├── referencia-tecnica.md IDs, endpoints, campos, workflows (SEM segredos — só placeholders)
├── estrategia.md (opcional) análise/decisões estratégicas do projeto
├── historico.md (opcional) cronologia de bugs, fixes, decisões
└── ARQUIVOS.md manifesto dos anexos que vivem no Drive
One-offs mortos = arquivo único na disciplina (ex.: prospeccao/mapeamento-decisores-jun2026.md), status: arquivado.
Convenções¶
Frontmatter (todo README de projeto começa com isto):
---
projeto: <nome>
disciplina: <slug>
tipo: [automacao-n8n, ...] # automacao-n8n | automacao-make | trafego | comercial | analise | integracao...
status: ativo # ativo | pausado | pronto | concluido | arquivado | planejamento
tecnologias: [n8n, pipedrive, ses, chatwoot, omie, ...]
anexos_drive: <link da pasta no Drive>
---
Arquivos (binários) não são versionados: PDF, planilha, imagem, dataset e proposta ficam fora do
Git (o .gitignore barra, porque binário incha o repo pra todo mundo). Um binário nasce na pasta
do projeto quando é gerado (lugar natural de escrita), mas a cópia durável e compartilhável vive no
Google Drive, sob a raiz BEPEX_DRIVE_ROOT, espelhando disciplina/projeto. No fim da sessão os
binários novos são copiados pro Drive (mão única, sem levar o .git); o repo nunca é sincronizado
com o Drive. Cada anexo aparece no ARQUIVOS.md do projeto com link/ID do Drive + caminho
relativo sob BEPEX_DRIVE_ROOT. Para abrir um anexo, resolva pelo link do Drive ou pela pasta
local sincronizada.
BEPEX_DRIVE_ROOT: pasta local knowledge-base-anexos/, irmã do repo (mesmo pai, fora
da árvore do Git, pra o Drive nunca ver o .git), com uma subpasta por disciplina (mesma árvore do
repo). O Google Drive Desktop está configurado pra acompanhar essa pasta, então tudo que cai nela
sobe pro Drive sozinho. Ela é marcada como "qualquer um com o link vê", pra os anexos serem
compartilháveis. Os segredos ficam numa raiz separada e não compartilhável. A cópia dos binários
repo → anexos é feita pelo .claude/sync-anexos.sh, disparado no fim da sessão pelo hook Stop.
Segredos (nunca no Git): o repo só tem placeholders (OMIE_APP_KEY_DALE). Os valores reais
vivem num arquivo restrito no Drive. .claude/settings.json bloqueia a leitura de .env/secrets.
Commits: tipo(escopo): descrição (ex.: docs(caramelo): adiciona referência técnica).
Escrita: não use travessões (—) no conteúdo; prefira vírgula, dois-pontos ou parênteses. Vale para todo mundo (humano ou IA) que escreve aqui.
O que NÃO está aqui¶
- Skills — moram no diretório de skills da empresa/usuário, não no repo.
- Arquivos/anexos — no Drive
rafael@bepex.com.br. - Segredos — no Drive restrito.
- Fora de escopo: dashboard de métricas, transcrições de sessões, dados de outras empresas.