Repositório

Estrutura do Repositório SIRIUS

Para quem é: Todo membro do time Sirius — comercial, conteúdo, automação, gestão ou growth. O que você consegue ao final: Saber exatamente onde encontrar qualquer documento, onde salvar qualquer entrega e por que cada pasta existe.

O conceito central

O repositório SIRIUS é o cérebro operacional da empresa. Tudo que a Sirius produz, decide ou aprende vive aqui — de workflows de automação a contratos de clientes, de referências técnicas a notas de reunião.

A estrutura foi pensada para responder uma pergunta simples: "Onde fica X?" sempre ter uma resposta óbvia.

Mapa Geral

SIRIUS/
├── clientes/          → Material de clientes ativos
├── comercial/         → Prospects e modelos comerciais
├── produtos/          → Software e ferramentas da Sirius
├── automacoes/        → Workflows n8n e scripts
├── operacional/       → Como a Sirius opera (playbooks, guias, templates)
├── docs/              → Documentação de projeto e produto
├── financeiro/        → Planilhas, pleitos e reuniões financeiras
├── archive/           → Histórico de clientes encerrados e legados
└── triagem/           → Arquivos ainda sem classificação

Cada pasta em detalhe

`clientes/`

O que é: Hub de tudo que existe sobre cada cliente ativo.

Regra de ouro: Se o cliente assinou contrato, tem pasta aqui. Se ainda é prospect, fica em comercial/.

Clientes atuais:

clientes/
├── anmv/
├── comport/
├── foco-vet/
├── king/
├── lt-pneus/
├── map/
├── naves/
├── sirius/        ← cliente interno (operação da própria Sirius)
└── vh/

Dentro de cada cliente:

clientes/[nome]/
├── contexto.md        ← LEIA PRIMEIRO. Resumo do cliente, contatos, status, histórico
├── contratos/         ← PDFs e minutas assinadas
├── propostas/         ← Propostas enviadas
├── reunioes/          ← Notas de reunião (YYYY-MM-DD-tema.md)
├── trafego/           ← Configs Meta Ads, pixels, GTM
├── criativos/         ← Referências de assets
│   ├── feeds/
│   ├── stories/
│   └── videos/
├── n8n/               ← Workflows exportados deste cliente
└── docs/              ← Docs técnicos específicos do cliente

Antes de qualquer tarefa de um cliente: leia o contexto.md dele.

`comercial/`

O que é: Material de prospects (ainda não são clientes) e modelos reutilizáveis.

comercial/
├── modelos/           ← Templates de proposta e contrato para copiar
│   ├── deploy/        ← Propostas publicadas online
│   └── modelo-contrato-ecossistema.md

Quando um prospect assina contrato: cria a pasta em clientes/, move as propostas e contratos para lá.

`produtos/`

O que é: Todo software e ferramenta que a Sirius constrói e opera.

produtos/
├── dashboard/             ← App web principal (porta 3003 local, Vercel em prod)
│   └── dist-hostgator/    ← Build espelho para HostGator (sincronizar antes do deploy)
├── ze-bot/                ← Servidor do Zé Bot (WhatsApp — Express/Node.js)
├── crm/                   ← Pesquisa e decisões sobre stack de CRM
├── repteis/               ← Landing page Répteis
├── ze-lp/                 ← Landing page do Zé Bot
└── cc-nlm/                ← Projeto de NLM com Claude Code

Atenção: produtos/ze-bot/ é um repositório git separado (submódulo). Ao clonar o SIRIUS, rode git submodule update --init para baixar o código do ze-bot.

`automacoes/`

O que é: Tudo relacionado a n8n e automações de processos.

automacoes/
├── workflows/
│   ├── ze-bot/       ← JSONs dos workflows do Zé Bot
│   ├── mel/          ← Workflows da Melanie / Vet Selvagem
│   ├── comport/      ← Workflows do Comport Ensino
│   └── sirius/       ← Workflows internos da Sirius
└── scripts/          ← Scripts Python e Node utilitários

Para exportar um workflow do n8n: Abra o workflow → menu "..." → "Export" → salve o JSON na pasta correspondente do cliente.

`operacional/` ⭐

O que é: Como a Sirius opera. É aqui que o time aprende a executar com qualidade e consistência.

operacional/
├── playbooks/            ← Processos passo-a-passo com checklist
├── guias/                ← Como usar ferramentas (este arquivo está aqui)
├── templates/            ← Modelos prontos para copiar e preencher
└── referencias-tecnicas/ ← APIs, specs e documentação técnica

Quando usar cada subpasta:

Tenho uma dúvida sobre...	Vá para...
Como executar um processo (onboarding, disparo, lançamento)	`playbooks/`
Como usar uma ferramenta (Claude Code, dashboard, GHL)	`guias/`
Modelo para preencher (novo cliente, proposta, briefing)	`templates/`
Como uma API funciona (GHL, Meta Ads, n8n)	`referencias-tecnicas/`

`docs/`

O que é: Documentação de projeto e produto — contexto, tarefas ativas, reuniões e screenshots.

docs/
├── contexto-operacional.md   ← Visão geral do negócio (leitura obrigatória para novos membros)
├── contexto-vivo.md          ← Estado atual por cliente (atualizado frequentemente)
├── stories/                  ← Tarefas ativas no formato AIOS (*.story.md)
├── prd/                      ← Requisitos e épicos de produto
├── reunioes/YYYY-MM/         ← Notas de reunião internas da Sirius
├── screenshots/              ← Capturas de tela organizadas por contexto
│   ├── clientes/{nome}/
│   ├── gtm/
│   ├── meta-ads/
│   ├── ghl/
│   └── misc/
├── brief/                    ← Briefings de produto
└── ze/                       ← Documentação técnica do Zé Bot

Diferença entre docs/ e operacional/: docs/ descreve o que existe e o que está sendo feito. operacional/ ensina como fazer.

`financeiro/`

O que é: Planilhas, pleitos bancários e acompanhamento financeiro.

financeiro/
├── planilhas/            ← DRE.xlsx, OBRIGAÇÕES SIRIUS.xlsx
├── pleitos/
│   └── sicoob-150k/      ← Projeção e documentação do pleito Pronampe
├── reunioes/             ← Notas e tarefas de reuniões com o financeiro
├── dashboard.html        ← Dashboard financeiro local
└── README.md

Acesso: Planilhas são de uso exclusivo do João. Dashboard financeiro tem senha.

`archive/`

O que é: Histórico e legados — clientes encerrados/pausados, versões antigas de produto, backups.

archive/
├── clientes/             ← Clientes que pausaram ou encerraram (ex: mel/)
├── backups/              ← Backups pontuais de workflows e configs
├── produtos-dashboard-dist-dash/  ← Versão antiga do build HostGator (Abr/2026)
└── [outros legados]

Regra: Nada aqui é deletado, apenas arquivado. Se precisar resgatar algo, está aqui.

`triagem/`

O que é: Área de entrada para arquivos que ainda não foram classificados.

Fluxo: Arquivo entra na triagem/ → responsável classifica → move para a pasta correta.

Não deixe arquivos aqui por mais de 48h.

Convenções de nomenclatura

Tipo	Padrão	Exemplo
Pastas	`kebab-case`	`foco-vet/`, `lt-pneus/`
Notas de reunião	`YYYY-MM-DD-tema.md`	`2026-04-14-estrategia-meta.md`
Notas de reunião de pasta `docs/reunioes/`	Por mês em `YYYY-MM/`	`docs/reunioes/2026-04/`
Proposta	`proposta-v[N].html`	`proposta-v2.html`
Contrato	`contrato-[data].pdf`	`contrato-2026-03.pdf`
Workflow n8n	`[cliente]-[funcao].json`	`mel-capi-venda.json`
Screenshots	Subpasta por contexto em `docs/screenshots/`	`docs/screenshots/clientes/anmv/`

Regras rápidas

✅ Faça:

Leia o contexto.md do cliente antes de qualquer tarefa
Salve screenshots em docs/screenshots/clientes/{nome}/
Use triagem/ quando não souber onde colocar — mas classifique logo depois
Crie pasta do cliente em clientes/ assim que o contrato for assinado

❌ Não faça:

Salvar arquivos soltos na raiz do repositório
Criar subpastas fora do padrão sem documentar no contexto.md do cliente
Deixar propostas de clientes ativos em comercial/ (mover para clientes/{nome}/propostas/)
Usar docs/ para guardar playbooks ou guias operacionais (esses vão em operacional/)

Novato no time? Leia nesta ordem:

Este guia — você está aqui
docs/contexto-operacional.md — visão geral do negócio
operacional/playbooks/onboarding-cliente.md — como incorporamos um cliente
operacional/manual-do-time/como-usar-claude-code.md — como o time usa IA no dia a dia
contexto.md dos clientes pelos quais você será responsável

O conceito central

Mapa Geral

Cada pasta em detalhe

clientes/

comercial/

produtos/

automacoes/

operacional/ ⭐

docs/

financeiro/

archive/

triagem/