💰 Guia — Finanças da Família

1. Como tudo se encaixa

Tudo fica guardado numa planilha só, a Orcamento Familiar V2. O app é outra forma de ver e lançar nessa mesma planilha. Ele tem duas versões:

• 📱 Celular: para lançar rápido e ver o resumo do mês.
• 💻 Navegador (computador): versão completa, com painel, próximo mês e planejados, lançamentos, relatórios, faturas, contas fixas, investimentos e configurações.

Única exceção: o Formulário Google antigo do celular, se ainda for usado, guarda as respostas numa aba própria. O app já faz tudo o que o formulário fazia, então é melhor usar só o app.

2. Abrir o app

• Celular: use o ícone que você adicionou à tela inicial (o link termina em /exec).
• Computador: o mesmo link com ?p=web no final. No celular também tem o atalho em ⚙️ Mais → Abrir versão para navegador.

Só abre para quem tem acesso de edição à planilha. Ter só o link não basta.

3. Ver e entender o mês atual

No navegador: 📊 Painel

No topo, escolha o Mês. Os outros filtros mudam o que você enxerga:

• Pessoa: só os gastos do Allan, da Mayara ou da Família.
• Considerar mês de: pagamento (padrão) ou compra. Pelo pagamento, uma compra no cartão conta no mês do vencimento da fatura, e um gasto em conta conta no dia em que saiu. Pela compra, tudo conta no mês em que foi feito. O padrão mostra o que realmente pesa no caixa de cada mês.
• Conta (saldo): qual conta alimenta o saldo e o gráfico dia a dia.

Abaixo dos cartões:

• Gastos por categoria: clique numa fatia para ver os lançamentos.
• Saldo dia a dia: linha cheia até hoje e projeção depois, descontando as contas que faltam.
• Contas do mês: cada conta fixa com seu status. A vencer, Vence em breve (até 3 dias), Paga ou Vencida sem registro.
• Orçamento × real: a barra fica amarela acima de 85% do orçamento e vermelha acima de 100%.

No celular: 📊 Resumo

• Escolha Mês, Pessoa e "Pelo mês de pagamento" ou "Pelo mês da compra" (mesma regra do Painel).
• Quatro cartões: Gastos do mês (com variação), Entradas (com a sobra), Saldo em conta hoje (Itaú Conta Corrente) e Faturas a pagar.
• A lista mostra os gastos por categoria, com a variação contra o mês anterior e a % do orçamento. Toque numa categoria para ver as subcategorias, e numa subcategoria para ver os lançamentos.
• Em cada lançamento, Pendente (fatura dd/mm) significa compra de cartão cuja fatura ainda não foi paga. Pago significa que já saiu da conta.

4. Lançar um gasto (cartão ou conta corrente)

Toque em ＋ Lançar no celular, ou em ＋ Gasto no navegador. Os campos comuns são descrição, valor, data (a data da compra), quem gastou e categoria. A categoria pode ficar em branco: o app escolhe pelas regras e mostra "✓ vai entrar como…" enquanto você digita.

Gasto no cartão de crédito

1. Em Pagamento (celular) ou Forma (navegador), escolha Cartão de crédito.
2. Escolha o cartão.
3. Toque em Salvar gasto (celular) ou Salvar (navegador).

• O app descobre a fatura pela data da compra e pelo fechamento do cartão. Compra feita até o dia do fechamento entra na fatura que fecha naquele mês. Depois do fechamento, entra na fatura seguinte.
• O saldo da conta não muda. A compra fica Pendente (fatura dd/mm) até você registrar o pagamento da fatura (seção 7).
• Para forçar outra fatura, preencha o Vencimento da fatura. No celular ele fica em Mais opções. No navegador aparece só quando a forma é cartão.

Gasto na conta corrente

1. Em Pagamento ou Forma, escolha Pix/Débito (ou Conta).
2. Escolha a conta de onde o dinheiro saiu, por exemplo Itaú Conta Corrente.
3. Salve.

• O gasto conta no mês da data e baixa o saldo da conta nessa data. Lançamento com data futura só entra no saldo no dia dele.
• Use a data em que o dinheiro realmente saiu. Para débito automático, a data do débito.

5. Compra parcelada

Cada parcela é um lançamento separado. Exemplo: compra de R$ 4.690,00 em 3× no dia 04/11 no cartão.

• A mesma data em todas: sempre a data da compra.
• Escreva "(Parcela x/y)" na descrição. É assim que o app reconhece a parcela, mostra no "Próximo mês" e sabe quando ela termina.
• Centavos: se a divisão não for exata, a última parcela fica com a sobra, para o total fechar.
• Vencimento: a parcela 1 vai sozinha para a fatura certa. Nas outras, preencha o Vencimento da fatura em que cada uma vai cair (no celular, em Mais opções). Os vencimentos de cada cartão aparecem na tela 💳 Faturas.
• Como aparece nos relatórios: pelo "mês de pagamento" (padrão), cada parcela conta no mês da sua fatura. Pelo "mês da compra", as três contam em novembro, porque a data é a mesma.

Parcelado na conta corrente (boleto ou débito parcelado): é igual, mas a data de cada parcela é o dia em que ela é paga, e não há vencimento de fatura.

Cobrança mensal no cartão que não vem como parcelada

Mensalidade de faculdade ou pós-graduação, assinatura e coisas assim chegam todo mês na fatura, sem "parcela x/y". Elas não aparecem sozinhas na previsão. Para entrarem no planejamento dos meses seguintes, use Planejar com Repetir por vários meses (seção 9). Não use Contas fixas para isso: o app trata conta fixa como débito na conta corrente.

6. Lançar uma entrada

1. Em ＋ Lançar, troque para Entrada (no navegador: tela 💵 Entradas).
2. Preencha descrição, valor, data, quem pagou e a conta onde o dinheiro entrou.
3. A categoria é automática pelas regras, ou escolha uma.

7. Faturas do cartão e pagamento da fatura

Ler uma fatura

• A tela 💳 Faturas lista cada fatura com o total, o quanto falta pagar, o número de compras e o fechamento. Toque em Ver compras (celular) ou selecione a fatura na lista (navegador) para ver os itens. A divisão por categoria e por pessoa e a exportação em CSV existem só no navegador.
• Status: 🟢 Aberta (ainda recebe compras) → 🔒 Fechada — a pagar (passou o fechamento) → ⚠️ Vencida (passou o vencimento sem pagar) → ✅ Paga.
• As compras do cartão contam no orçamento do mês da fatura. O saldo da conta só muda quando a fatura é paga.

Registrar o pagamento

1. Celular: em Faturas, toque em Pagar fatura na fatura desejada. Navegador: em 💳 Faturas, selecione a fatura e clique em 💸 Registrar pagamento.
2. Confira o valor (vem preenchido com o que falta pagar), a data do pagamento e a conta debitada. No navegador há também um campo de observação, por exemplo "débito automático".
3. Confirme com Confirmar pagamento (celular) ou Registrar (navegador).

O que acontece: uma linha entra na aba Pagamentos, o saldo da conta cai na data do pagamento, a fatura vira ✅ Paga e as compras dela passam de "Pendente (fatura dd/mm)" para "Pago".

• Pagamento parcial: pode registrar mais de um pagamento para a mesma fatura. Ela só vira Paga quando a soma chega ao total.
• Débito automático: registre o pagamento depois que o banco debitar, com a data do débito.
• Registrei errado: no navegador, vá a Pagamentos registrados, no fim da tela de Faturas, e clique em Excluir. A fatura volta a ficar pendente. No celular, apague a linha na aba Pagamentos da planilha.

8. Contas fixas

São as contas que se repetem todo mês (condomínio, internet, financiamento, salário…). Elas aparecem em "Contas do mês" no Painel e entram na previsão do Próximo mês com o valor cadastrado.

• Palavra-chave: o app procura um lançamento em conta com essa palavra na descrição, perto do vencimento, para marcar a conta como paga. Para uma fatura de cartão, a palavra-chave é o nome do cartão.
• Ativa: desmarque para pausar uma conta sem apagar. Os meses anteriores também deixam de mostrá-la em "Contas do mês", mas os lançamentos reais continuam como estão.
• Mês anterior?: marque para algo que cai no fim do mês anterior, como o salário.

9. Planejar um gasto e efetivar

Planejar serve para registrar um gasto (ou entrada) que você já sabe que vai acontecer. O planejado não mexe no saldo, nas faturas nem nos relatórios. Ele só entra na previsão do 🗓️ Próximo mês. Só existe no navegador.

Planejar um gasto no cartão de crédito

1. Clique em 🗓️ ＋ Planejar (no topo de qualquer tela, ou dentro do Próximo mês).
2. Tipo: Saída. Mês: o mês em que a cobrança vai pesar. Descrição e Valor.
3. Forma: Cartão de crédito. O campo abaixo vira Cartão: escolha qual.
4. Se quiser, preencha a data prevista, quem, a categoria e observações.
5. Para algo que se repete (mensalidade, assinatura), preencha Repetir por quantos meses? (até 24). O app cria um planejado por mês, com o mesmo valor, a partir do mês escolhido.
6. Clique em Salvar.

Planejar um gasto na conta corrente

Os passos são os mesmos, mas em Forma escolha Pix/Débito (ou Conta). O campo abaixo vira Conta: escolha a conta de onde vai sair.

Efetivar (vale para os dois)

Quando a cobrança acontecer de verdade:

1. Abra 🗓️ Próximo mês e escolha o mês no filtro Mês a planejar.
2. No quadro Planejados para [mês], clique em Efetivar na linha.
3. Informe a data do lançamento e clique em Efetivar.

• Cartão: vira uma compra no cartão. A fatura é definida pela data que você informar e pelo fechamento do cartão.
• Conta corrente: vira um gasto na conta e baixa o saldo a partir da data informada.
• Use a data real da compra ou do débito. Uma data depois do fechamento joga o gasto na fatura seguinte, e ele pode sair do mês que você planejou.
• O valor efetivado é o do planejado. Se a cobrança veio com valor diferente, clique em Editar e acerte o valor antes de efetivar.
• Depois de efetivado, ele sai da lista de planejados e passa a contar em "Já lançado". Não é contado duas vezes.

10. Ver e entender o mês planejado (Próximo mês)

Abra 🗓️ Próximo mês no navegador. Em Mês a planejar você escolhe qualquer mês, do atual até 12 meses à frente. O padrão é o mês seguinte. Escolher o mês atual (aparece "(atual)") mostra quanto dele já estava comprometido.

Duas caixas mudam o cálculo:

• incluir planejados: soma (ou não) os planejados do mês.
• incluir gasto variável estimado: soma a média dos gastos variáveis dos últimos meses (até 3, com pelo menos 10 lançamentos cada), menos o que já foi lançado no mês. É uma estimativa para o que ainda não aconteceu, como mercado e lazer.

Os quadros abaixo mostram de onde vem cada parte:

• Contas fixas: as contas fixas ativas com valor cadastrado, por dia de vencimento.
• Parcelas: as parcelas que caem no mês. As marcadas projetada ainda não apareceram na fatura: o app projetou a partir da última parcela vista. Só projeta séries com parcela nos últimos 2 meses, e só se a descrição tiver "(Parcela x/y)".
• Já lançado no mês: compras na fatura do mês e gastos em conta já lançados, sem as parcelas e sem o que já está nas contas fixas. Clique numa categoria para ver os lançamentos.
• Planejados: com os botões Efetivar, Editar e Excluir (seção 9).
• Próximos 6 meses: barras com o comprometido de cada mês e uma linha com a renda. Barras acima da linha são meses no vermelho.

11. Investimentos

• Em 🏦 Investimentos, lance o aporte, o resgate ou a atualização de saldo de cada investimento (cofrinho).
• No aporte, escolha a conta de origem, por exemplo Itaú Conta Corrente. O valor sai do saldo dessa conta. No resgate, o valor volta para a conta.
• A atualização de saldo só registra quanto o investimento vale hoje, e assim o app calcula o rendimento.

12. Categorias e regras

• Categorias têm dois níveis: Categoria › Subcategoria (ex.: Moradia › Utilidades da casa).
• Regras dizem "se a descrição contém X, use a categoria Y". Quem está mais em cima tem prioridade, e dá para mudar a ordem com ↑↓. A caixa Testar mostra qual regra pegaria uma descrição.
• Quando você troca a categoria de um gasto, o app oferece criar a regra na hora, para os próximos gastos virem certos.
• Orçamento: o limite mensal por categoria. O botão 💡 sugere valores pela média dos últimos 3 meses.

13. Usar direto na planilha

Pode lançar à mão quando quiser. O app lê tudo da mesma forma. Basta seguir estas regras:

14. Avisos de gravação (navegador)

Quando você salva, a tela muda na hora, e a gravação na planilha segue em segundo plano. O aviso na lateral mostra em que pé está:

Um item recém-criado fica bloqueado para edição por alguns segundos, até a releitura terminar.

15. Problemas comuns

16. Atualizar o app (quando houver código novo)

1. Abra a planilha logado na conta dona da planilha → Extensões → Apps Script.
2. Cole o conteúdo novo de Code.gs, Index.html e Desktop.html (pasta app_financas) por cima dos arquivos com o mesmo nome e salve (💾).
3. Implantar → Gerenciar implantações → lápis ✏️ → Versão: Nova versão → Implantar.

O link continua o mesmo. Recarregue o app no celular e no navegador. A primeira instalação está explicada em LEIA-ME.md.