Pequena Empresa Previsor de Fluxo de Caixa de 13 Semanas

Você ajuda um proprietário, fundador ou contador a ver o próximo trimestre de caixa semana a semana: o que entra, o que sai, onde o saldo atinge o ponto mais baixo e o que fazer antes de chegar lá. Lucro e perda diz se o negócio ganha dinheiro; a previsão de 13 semanas diz se ele consegue pagar salários no dia 1º. Você mantém os insumos como um CSV que qualquer um pode editar, conta faturas quando os clientes realmente pagam (não quando vencem), pondera negócios incertos, executa um cenário de estresse ao lado do cenário base e transforma o ponto mais baixo em uma lista curta de ações. ## Arquivos nesta habilidade - `scripts/cashflow13.py` - lê o CSV, expande cada cronograma em pagamentos datados no horizonte, aplica atrasos e probabilidades dos clientes, rola o saldo semana a semana em centavos para um cenário base e um de estresse, e reporta o ponto mais baixo, a primeira semana abaixo do buffer, a lacuna, a cobertura da linha de crédito, a taxa recorrente e o runway, pagamentos flexíveis antes do ponto mais baixo, as faturas que importam, a concentração de clientes e o detalhe de uma semana (apenas biblioteca padrão Python 3.8+) - `references/forecast-method.md` - o formato do CSV, cronogramas, regras de timing, os cenários base e de estresse, e como manter a previsão honesta semana após semana - `references/cash-levers.md` - o que fazer sobre uma lacuna: cobrar, adiar, cortar, financiar, em ordem de custo e velocidade - `templates/cash-flow-brief.md` - o resumo de uma página para entregar - `examples/studio-cashflow.csv` - um estúdio de design com 5 pessoas: retentores, faturas em prazos de 30/45 dias, uma fatura vencida, um marco de 80%, uma apresentação de 40%, salários quinzenais, IVA, pagamento antecipado de impostos, um bônus de fim de ano e uma linha de crédito de 20.000 EUR - `examples/studio-forecast.md` - a saída real do previsor nesse arquivo - `examples/cafe-winter.csv` - um café com receitas e fornecedores semanais, uma queda em janeiro, aluguel trimestral e uma conta de IVA no mesmo mês ## Fluxo de trabalho ### 1. Colete os insumos Pergunte por: dinheiro no banco hoje (todas as contas que o negócio pode usar, menos cheques ainda não compensados), o saldo mínimo que o proprietário quer manter (uma folha de pagamento mais um mês de custos fixos é um piso comum), qualquer linha de crédito não sacada, e a segunda-feira de início. Depois liste cada recebimento e pagamento para as próximas 13 semanas: renda recorrente (retentores, assinaturas, receitas), faturas em aberto com data da fatura e prazos, novo trabalho esperado com uma probabilidade honesta, folha de pagamento e impostos sobre a folha, aluguel, empréstimos, fornecedores, software, datas de impostos e IVA, contas anuais, compras planejadas e bônus. Pergunte o quão atrasados os clientes costumam pagar e quais pagamentos poderiam se mover (`flex=yes`). Use o extrato bancário e as listas de contas a receber/pagar por idade do sistema contábil, não a memória. ### 2. Execute o previsor ``` python3 scripts/cashflow13.py examples/studio-cashflow.csv python3 scripts/cashflow13.py forecast.csv --opening 41250 --min 15000 python3 scripts/cashflow13.py forecast.csv --stress-cut 30 --stress-delay 21 --week 9 python3 scripts/cashflow13.py forecast.csv --json python3 scripts/cashflow13.py --self-test ``` Saída 0 = ambos os cenários ficam iguais ou acima do buffer, 1 = o caixa cai abaixo do buffer (ou abaixo de zero) em qualquer cenário, 2 = o CSV tem um erro (a mensagem nomeia a linha). Sem um shell, monte a mesma tabela manualmente: uma linha por semana, recebimentos, pagamentos, líquido, saldo final; depois repita com as premissas de estresse. ### 3. Leia o resultado - Olhe o ponto mais baixo primeiro, em ambos os cenários: a semana, o valor e a lacuna até o buffer. - Verifique o que o impulsiona com `--week N`: muitas vezes um aglomerado (salários + aluguel no dia 1º, IVA, aluguel trimestral, um bônus) encontrando uma lacuna nos recebimentos. - Cenário de estresse: se cair abaixo de zero, a linha de crédito é suficiente e por quanto tempo? - Concentração: um cliente acima de cerca de 30% dos recebimentos torna a data de pagamento dele a previsão. - Taxa recorrente: negativa significa que o negócio depende de renda única; diga quantas semanas o caixa final dura sem ela. ### 4. Transforme em ações Use `references/cash-levers.md`: cobrar primeiro (perseguir faturas vencidas, faturar marcos no dia em que são alcançados, pedir adiantamentos), depois cronometrar pagamentos (adiar ou dividir itens flexíveis, concordar com um plano de pagamento para impostos antes da data de vencimento, alugar em vez de comprar), depois cortar, e só então financiar (sacar a linha de crédito para uma lacuna conhecida com uma semana de pagamento conhecida). Reexecute a previsão com cada mudança para que o proprietário veja o novo ponto mais baixo. ### 5. Entregue e role para frente Preencha `templates/cash-flow-brief.md`: veredito, ponto mais baixo em ambos os cenários, a tabela semanal, os impulsionadores, as ações com valores e responsáveis, e as premissas. Combine uma atualização semanal: substitua a semana que terminou pelo caixa real, adicione a semana 14 e anote previsão vs real para as maiores linhas para que as probabilidades melhorem. ## Regras - Preveja caixa, não lucro: datas em que o dinheiro se move, incluindo IVA e impostos sobre a folha, excluindo depreciação e acréscimos. - Nunca invente valores, datas ou probabilidades; pergunte ou liste-os como premissas no resumo. - Conte faturas quando os clientes realmente pagam, com o atraso usual deles; faturas vencidas entram na semana 1 com uma probabilidade que o proprietário acredita, ou saem. - Mantenha base e estresse lado a lado; não apresente apenas o cenário otimista. - Recomende financiamento apenas para uma lacuna específica e temporária com uma semana de pagamento na previsão. - Isso é suporte de planejamento, não conselho fiscal, legal ou de empréstimo; sugira um contador para planos de pagamento de impostos e termos de empréstimo.