sinapse-ai 1.0.0

package/squad-finance/knowledge-base/agency-financial-models.md

@@ -0,0 +1,243 @@
+# Modelos Financeiros para Agencias Digitais
+
+> Referencia completa de estruturas de P&L, formulas de custo, impacto de utilizacao na margem e metodos de alocacao de overhead para agencias e negocios de servicos digitais.
+
+---
+
+## 1. Estrutura de P&L para Agencias
+
+### P&L Simplificado
+
+```
+RECEITA BRUTA
+  (-) Impostos sobre receita (ISS 2-5%, PIS 0.65%, COFINS 3%)
+= RECEITA LÍQUIDA
+
+  (-) COGS / Custo dos Servicos Prestados
+    - Folha de delivery (loaded)
+    - Freelancers e terceirizados
+    - Ferramentas diretas de projeto
+    - Infra direta (hosting, APIs)
+= LUCRO BRUTO (Gross Profit)
+  Gross Margin % = Lucro Bruto / Receita Liquida
+  TARGET: 50-70%
+
+  (-) DESPESAS OPERACIONAIS (OpEx)
+    - Folha admin e comercial (loaded)
+    - Aluguel e facilities
+    - Marketing e vendas
+    - SaaS corporativo
+    - Contabilidade e juridico
+    - Viagens e eventos
+= EBITDA
+  EBITDA % = EBITDA / Receita Liquida
+  TARGET: 15-25%
+
+  (-) Depreciacao e amortizacao
+  (-) Juros
+  (-) Impostos sobre lucro (IR + CSLL)
+= LUCRO LÍQUIDO
+  Net Margin % = Lucro Liquido / Receita Liquida
+  TARGET: 8-15%
+```
+
+### P&L por Projeto
+
+```
+RECEITA DO PROJETO
+  (-) Horas equipe × custo hora loaded
+  (-) Freelancers alocados ao projeto
+  (-) Ferramentas especificas do projeto
+  (-) Infra direta do projeto
+= MARGEM BRUTA DO PROJETO
+  Target: >= 50%
+
+  (-) Overhead alocado (ver metodos abaixo)
+= MARGEM LIQUIDA DO PROJETO
+  Target: >= 15%
+```
+
+---
+
+## 2. Formulas de Custo
+
+### Custo-Hora Loaded
+
+O custo-hora loaded e o custo REAL de uma hora de trabalho, incluindo TODOS os encargos.
+
+```
+CLT:
+  Custo_mensal_loaded = Salario_bruto × Fator_encargos
+  Fator_encargos = 1.70 a 2.00 (varia por regime tributario)
+
+  Decomposicao tipica (Lucro Presumido):
+  | Item | % sobre salario |
+  |------|----------------|
+  | INSS patronal | 20% |
+  | FGTS | 8% |
+  | 13o salario | 8.33% |
+  | Ferias + 1/3 | 11.11% |
+  | Provisao rescisao | 5-10% |
+  | VR/VA | 5-8% |
+  | Plano saude | 5-15% |
+  | TOTAL | 62-80% |
+
+  Custo_hora_loaded = Custo_mensal_loaded / Horas_uteis
+  Horas_uteis = 21 dias × 8h = 168h
+
+PJ:
+  Custo_mensal_loaded = Valor_nota × 1.05 a 1.15
+  (+5-15% para contabilidade PJ, ferias, etc.)
+  Custo_hora_loaded = Custo_mensal / 168h
+
+Freelancer:
+  Custo_hora_loaded = Valor_hora_negociado × 1.05
+  (+5% para gestao e overhead de coordenacao)
+```
+
+### Exemplos Praticos (Brasil, 2026)
+
+```
+| Funcao | Salario CLT | Loaded/mes | Loaded/hora |
+|--------|------------|-----------|-------------|
+| Dev Junior | R$ 4.000 | R$ 7.200 | R$ 43 |
+| Dev Pleno | R$ 8.000 | R$ 14.400 | R$ 86 |
+| Dev Senior | R$ 14.000 | R$ 25.200 | R$ 150 |
+| Tech Lead | R$ 18.000 | R$ 32.400 | R$ 193 |
+| Designer Jr | R$ 3.500 | R$ 6.300 | R$ 38 |
+| Designer Sr | R$ 12.000 | R$ 21.600 | R$ 129 |
+| PM | R$ 10.000 | R$ 18.000 | R$ 107 |
+| UX Researcher | R$ 9.000 | R$ 16.200 | R$ 96 |
+```
+
+---
+
+## 3. Impacto da Utilizacao na Margem
+
+### Formula Base
+
+```
+Utilizacao = Horas_faturadas / Horas_disponiveis × 100
+
+Impacto na margem:
+  Custo_hora_efetivo = Custo_mensal_loaded / (Horas_disponiveis × Utilizacao)
+
+  | Utilizacao | Custo_hora_efetivo (se loaded = R$ 86/h) |
+  |-----------|------------------------------------------|
+  | 100% | R$ 86 (teorico, impossivel) |
+  | 85% | R$ 101 |
+  | 75% | R$ 115 |
+  | 65% | R$ 132 |
+  | 50% | R$ 172 |
+
+Conclusao: cada 10% de queda na utilizacao aumenta o custo efetivo em ~15%
+```
+
+### Targets por Funcao
+
+```
+| Funcao | Utilizacao Target | Justificativa |
+|--------|------------------|---------------|
+| Desenvolvedores | 80-85% | Alta alocacao em projetos |
+| Designers | 75-80% | Tempo para exploracao criativa |
+| PMs | 70-75% | Gestao, reunioes, planejamento |
+| Tech Leads | 60-70% | Code review, mentoria, arquitetura |
+| Diretores | 30-40% | Comercial, estrategia, gestao |
+| Media da agencia | 70-75% | Weighted average |
+```
+
+### Simulacao de Impacto
+
+```
+Cenario: Agencia com 20 pessoas, custo medio loaded R$ 15.000/mes
+Receita mensal: R$ 500.000
+
+| Utilizacao | Custo efetivo | Gross Margin |
+|-----------|--------------|-------------|
+| 85% | R$ 255K | 49% |
+| 75% | R$ 289K | 42% |
+| 65% | R$ 334K | 33% |
+
+Delta de 10% na utilizacao = ~7% na margem = ~R$ 35K/mes
+```
+
+---
+
+## 4. Metodos de Alocacao de Overhead
+
+### Metodo 1: Proporcional a Receita
+
+```
+Overhead_projeto = Overhead_total × (Receita_projeto / Receita_total)
+
+Vantagem: Simples, projetos maiores absorvem mais overhead
+Desvantagem: Projeto grande com boa margem pode parecer pior
+```
+
+### Metodo 2: Proporcional a Horas
+
+```
+Overhead_projeto = Overhead_total × (Horas_projeto / Horas_totais)
+
+Vantagem: Reflete uso de recursos
+Desvantagem: Projetos longos sao penalizados
+```
+
+### Metodo 3: Percentual Fixo sobre COGS
+
+```
+Overhead_projeto = COGS_projeto × Overhead_rate
+Overhead_rate = Overhead_total / COGS_total (tipico: 25-40%)
+
+Vantagem: Previsivel, facil de calcular em propostas
+Desvantagem: Menos preciso para projetos atipicos
+```
+
+### Metodo 4: Activity-Based Costing (ABC)
+
+```
+Overhead alocado por atividade real:
+- Reunioes comerciais → proporcional a horas de pre-venda
+- Aluguel → proporcional ao headcount alocado
+- Ferramentas → por uso real
+- Admin → rateio igual
+
+Vantagem: Mais justo e preciso
+Desvantagem: Complexo de implementar e manter
+```
+
+### Recomendacao
+
+Para agencias de ate 50 pessoas: **Metodo 3 (% fixo sobre COGS)** com rate de 30%.
+Revisar rate anualmente. Usar ABC apenas se houver necessidade de maior precisao em projetos estrategicos.
+
+---
+
+## 5. Mix de Receita Saudavel
+
+```
+| Tipo de Receita | % Ideal | Caracteristica |
+|----------------|---------|---------------|
+| Retainer/recorrente | 40-60% | Previsivel, cashflow estavel |
+| Projetos | 30-40% | Margem potencialmente maior |
+| Consulting/advisory | 10-20% | Alta margem, baixo custo |
+
+Regra: retainer > 40% garante estabilidade
+Risco: projetos > 70% causa volatilidade de caixa
+```
+
+---
+
+## 6. Break-even Analysis
+
+```
+Break-even Mensal = Custos_fixos / Gross_Margin_%
+
+Exemplo:
+  Custos fixos mensais: R$ 200.000
+  Gross margin: 55%
+  Break-even = R$ 200.000 / 0.55 = R$ 363.636/mes
+
+Break-even por Projeto:
+  Horas_breakeven = Custo_fixo_alocado / (Rate_cobrado - Custo_hora_loaded)
+```

package/squad-finance/knowledge-base/budget-forecasting-methods.md

@@ -0,0 +1,256 @@
+# Metodos de Budget e Forecasting
+
+> Referencia de metodos de orcamento e projecao financeira: rolling forecast, zero-based budgeting, variance analysis e budget pacing.
+
+---
+
+## 1. Rolling Forecast (12 Meses)
+
+### Estrutura
+
+```
+O rolling forecast SEMPRE olha 12 meses a frente, independente do ano fiscal.
+
+| Jan | Fev | Mar | Abr | Mai | Jun | Jul | Ago | Set | Out | Nov | Dez | Jan+1 |
+| R   | R   | R   | R+P | P   | P   | P   | P   | P   | P   | P   | P   | P     |
+
+R = Real (valor confirmado)
+P = Projetado
+R+P = Mes corrente (mix de real ate a data + projecao restante)
+```
+
+### Regras de Atualizacao
+
+```
+1. MENSAL: atualizar apos fechamento do mes
+   - Mes que acabou: substituir projecao por real
+   - Adicionar novo mes 12 meses a frente
+   - Revisar projecoes dos proximos 3 meses com base em novos dados
+
+2. TRIGGERS de atualizacao extraordinaria:
+   - Perda de cliente > 10% receita
+   - Novo contrato > 10% receita
+   - Mudanca de headcount significativa (+/- 3 pessoas)
+   - Crise macroeconomica
+```
+
+### Componentes do Forecast
+
+```
+RECEITA:
+  = Receita recorrente (retainers × prob_renovacao)
+  + Pipeline ponderado (por estagio × probabilidade)
+  + Sazonalidade (fator historico por mes)
+  + Growth rate aplicado
+
+DESPESAS FIXAS:
+  = Folha (headcount planejado × custo loaded)
+  + Aluguel e facilities
+  + SaaS e ferramentas (contratos)
+  + Contabilidade, juridico, seguros
+
+DESPESAS VARIAVEIS:
+  = Marketing (% da receita ou budget fixo)
+  + Freelancers (proporcional a projetos)
+  + Comissoes (% de novos negocios)
+  + Viagens e eventos (por evento)
+```
+
+### Metricas de Qualidade do Forecast
+
+```
+Forecast Accuracy = 1 - |Forecast - Actual| / Actual
+  Target: >= 90% (mensal), >= 95% (trimestral)
+
+MAPE (Mean Absolute Percentage Error):
+  MAPE = media(|Forecast_i - Actual_i| / Actual_i) × 100
+  Target: <= 10%
+
+Bias:
+  Bias = media((Forecast - Actual) / Actual) × 100
+  Positivo = otimista, Negativo = pessimista
+  Target: Proximo de 0%
+```
+
+---
+
+## 2. Zero-Based Budgeting (ZBB)
+
+### Principio
+
+```
+Cada ciclo de budget comeca do ZERO.
+Nenhum gasto e automaticamente renovado.
+Cada rubrica precisa justificar sua existencia e valor.
+
+Diferente de budget incremental:
+  Incremental: "ano passado gastamos X, este ano X+5%"
+  ZBB: "por que gastar X? Qual o ROI? Qual a alternativa?"
+```
+
+### Processo ZBB para Agencias
+
+```
+1. LISTAR todos os gastos do ano anterior
+2. Para cada gasto, responder:
+   a) Este gasto e necessario? (eliminar se NAO)
+   b) O valor e adequado? (reduzir se excessivo)
+   c) Existe alternativa mais barata? (substituir se SIM)
+   d) Qual o ROI mensuravel? (documentar)
+3. PRIORIZAR gastos por impacto:
+   - Must-have: sem isso a operacao para
+   - Should-have: melhora significativamente eficiencia
+   - Nice-to-have: melhora marginalmente
+4. CORTAR Nice-to-have se budget nao fecha
+5. DOCUMENTAR justificativa para cada rubrica aprovada
+```
+
+### Quando Usar ZBB
+
+```
+- Anualmente para 100% do budget (ideal)
+- Semestralmente para categorias de alto custo (minimo)
+- Sempre que houver restricao de caixa
+- Na revisao de ferramentas e vendors
+```
+
+---
+
+## 3. Variance Analysis
+
+### Thresholds
+
+```
+| Variancia | Status | Acao |
+|-----------|--------|------|
+| |var%| <= 5% | VERDE | On track, monitorar |
+| 5% < |var%| <= 10% | AMARELO | Investigar causa |
+| 10% < |var%| <= 15% | LARANJA | Acao corretiva necessaria |
+| |var%| > 15% | VERMELHO | Acao imediata, escalar |
+```
+
+### Tipos de Variancia
+
+```
+VOLUME VARIANCE:
+  Diferenca causada por mudanca na quantidade
+  Ex: 15 projetos planejados, 12 realizados
+  Calculo: (Volume_real - Volume_plan) × Custo_plan
+
+PRICE VARIANCE:
+  Diferenca causada por mudanca no preco/custo unitario
+  Ex: custo hora subiu de R$ 80 para R$ 90
+  Calculo: (Preco_real - Preco_plan) × Volume_real
+
+MIX VARIANCE:
+  Diferenca causada por mudanca na composicao
+  Ex: mais projetos de alto custo que planejado
+  Calculo: Diferenca entre mix real e planejado × volumes
+
+TIMING VARIANCE:
+  Diferenca causada por antecipacao ou atraso
+  Ex: despesa de dezembro veio em novembro
+  Tende a se normalizar no acumulado
+```
+
+### Root Cause Analysis Template
+
+```
+Para cada desvio significativo:
+
+| Campo | Descricao |
+|-------|-----------|
+| Rubrica | Nome da rubrica |
+| Budget | R$ X |
+| Actual | R$ Y |
+| Variancia | R$ Z (N%) |
+| Tipo | Volume / Price / Mix / Timing |
+| Causa raiz | Descricao detalhada |
+| Classificacao | One-time / Recorrente / Estrutural |
+| Impacto anual | Se recorrente, projecao para o ano |
+| Acao corretiva | O que fazer |
+| Responsavel | Quem |
+| Prazo | Quando |
+```
+
+---
+
+## 4. Budget Pacing
+
+### Formula
+
+```
+% Ano decorrido = Mes_atual / 12 (ou dias_corridos / dias_ano)
+% Budget usado = Actual_YTD / Budget_anual
+Pacing Index = % Budget usado / % Ano decorrido
+
+| Pacing | Interpretacao |
+|--------|---------------|
+| < 0.90 | Subgasto — investindo menos que planejado |
+| 0.90 - 1.10 | On pace — dentro do esperado |
+| > 1.10 | Overpace — gastando mais rapido que planejado |
+```
+
+### Pacing Ajustado por Sazonalidade
+
+```
+Se gastos nao sao lineares (ex: contratacoes em Q1, eventos em Q2):
+
+Pacing_ajustado = Actual_YTD / Budget_YTD_proporcional
+
+Budget_YTD_proporcional = Σ budget_mensal de janeiro ate mes atual
+(considerando distribuicao nao-linear planejada)
+```
+
+### EAC — Estimate at Completion
+
+```
+EAC = Actual_YTD + Remaining_budget × Pacing_Index
+Ou: Actual_YTD + (Budget_anual - Budget_YTD) × (Actual_YTD / Budget_YTD)
+
+Se Pacing > 1.0:
+  EAC > Budget → vai estourar o budget
+  Acao: cortar gastos restantes ou solicitar budget adicional
+
+Se Pacing < 1.0:
+  EAC < Budget → vai sobrar budget
+  Acao: avaliar se subinvestimento e intencional
+```
+
+---
+
+## 5. Scenario Planning (3 Cenarios)
+
+### Estrutura
+
+```
+PESSIMISTA (Worst Case):
+  - Receita: -20% do base
+  - Churn: +50% do historico
+  - Custos: +10% (inflacao, contratacoes emergenciais)
+  - Probabilidade: 20%
+
+BASE (Most Likely):
+  - Receita: conforme forecast
+  - Churn: conforme historico
+  - Custos: conforme budget
+  - Probabilidade: 60%
+
+OTIMISTA (Best Case):
+  - Receita: +20% do base
+  - Churn: -30% do historico
+  - Custos: conforme budget
+  - Probabilidade: 20%
+
+EXPECTED VALUE = (Pessimista × 0.2) + (Base × 0.6) + (Otimista × 0.2)
+```
+
+### Regras
+
+```
+1. SEMPRE apresentar 3 cenarios em reports executivos
+2. NUNCA planejar com base no otimista
+3. Planejar despesas fixas com base no pessimista
+4. Planejar investimentos variaveis com base no base
+5. Reservar contingencia de 10% sobre o base
+```