dla-docs

Relatórios

1. Propósito

O módulo Relatórios fornece relatórios financeiros detalhados, ajudando você a:

• Ver visão geral financeira do mês atual
• Analisar renda e despesas
• Rastrear progresso de poupança
• Prever gastos no final do mês
• Ver relatórios por tipo (Renda, Despesas, Poupança, Empréstimos)

2. Quando Usar

Use este módulo quando você quiser:

• Ver visão geral financeira
• Analisar tendências de gastos
• Verificar progresso da meta de poupança
• Prever risco de ultrapassar orçamento
• Ver relatórios detalhados por tipo

3. Telas Relacionadas

• Relatório de visão geral
• Relatório de renda
• Relatório de despesas
• Relatório de poupança
• Relatório de empréstimo

4. Uso Principal

4.1 Ver Relatório de Visão Geral

1. Vá para a aba Relatórios na navegação inferior
2. Veja a seção Saúde Financeira:
   • Meta de poupança e poupança real (com barra de progresso e nível de conquista)
   • Fluxo de Caixa Líquido com fórmula detalhada
   • Orçamento restante (se o orçamento foi criado)
   • Ritmo de gastos comparado ao mês anterior (se dados disponíveis)
   • Obrigações de empréstimo deste mês (se houver)
   • Top 5 categorias de gastos por porcentagem
3. Veja a seção Previsão de Tendência Futura (se orçamento > 0):
   • Restante esperado no final do mês com fórmula detalhada
   • Probabilidade de alcançar meta de poupança
   • Pagamento de empréstimo próximo (se houver)
4. Toque nos cards para rolar até os relatórios detalhados correspondentes

4.2 Ver Relatório de Renda

1. Da tela Relatórios, toque no item de menu 💵 Renda na seção “Relatórios Detalhados”
2. Veja a renda real total deste mês
3. Veja a seção Renda Recorrente: Total, recebida, ainda não recebida, detalhes de cada item
4. Veja a seção Renda Extra (se houver): Total, detalhes de cada item, % aumento/diminuição
5. Veja Tendência de Renda de 3 Meses (se dados suficientes disponíveis)
6. Veja Histórico de Renda Mensal
7. Veja Análise de Renda (Insights): Porcentagem, nível de estabilidade, tendências

4.3 Ver Relatório de Despesas

1. Da tela Relatórios, toque no item de menu 🔥 Despesas na seção “Relatórios Detalhados”
2. Veja as despesas reais totais deste mês com % aumento/diminuição comparado ao mês anterior
3. Veja a seção Despesas Recorrentes: Total, pagas, ainda não pagas, detalhes de cada item
4. Veja a seção Despesas Diárias por Categoria: Principais categorias com valores e porcentagens
5. Veja a seção Aumento de Gastos (se dados do mês anterior disponíveis)
6. Veja Tendência de Despesas de 3 Meses (se dados suficientes disponíveis)
7. Veja Histórico de Despesas Mensal

4.4 Ver Relatório de Orçamento

1. Da tela Relatórios, toque no item de menu 📉 Orçamento na seção “Relatórios Detalhados” (apenas mostrado quando o orçamento foi criado)
2. Veja Visão Geral do Orçamento Este Mês: Orçamento mensal, gasto (com detalhamento), restante, barra de progresso
3. Toque em “Orçamento Mensal” para ver Diálogo de Detalhes do Orçamento com método de cálculo
4. Veja a seção Variação do Plano: Itens de renda e despesas com variações, variação total
5. Veja a seção Despesas por Categoria: Total, cada categoria com valor, porcentagem, barra de progresso
6. Toque na categoria para ver lista de despesas nessa categoria

4.5 Ver Relatório de Poupança

1. Da tela Relatórios, toque no item de menu 💾 Poupança na seção “Relatórios Detalhados” (apenas mostrado quando contas de poupança existem)
2. Veja Poupança Real Este Mês com fórmula de Fluxo de Caixa Líquido
3. Veja a seção Análise de Poupança: % da renda, comparação com mês anterior, previsão de final de mês
4. Veja a seção Lista de Contas de Poupança: Todas as contas ativas, ordenadas por data de vencimento mais próxima
5. Veja Gráfico de Crescimento de Poupança de 6 Meses (se mais de 1 mês de dados disponíveis)

4.6 Ver Relatório de Empréstimo

1. Da tela Relatórios, toque no item de menu 💸 Empréstimos na seção “Relatórios Detalhados” (apenas mostrado quando empréstimos existem)
2. Veja Visão Geral do Empréstimo: Saldo de dívida atual, custo do empréstimo deste mês (com detalhamento de principal + juros)
3. Veja a seção Pagamento Mais Próximo: Data de vencimento, status, dias até próximo pagamento
4. Veja a seção Cronograma de Pagamento Mensal: Últimos 3 meses com valores e status
5. Veja a seção Análise de Empréstimo (Insights): Total pago, tendência de saldo de dívida, taxa de juros, risco de atraso no pagamento
6. Veja Gráfico de Redução de Dívida de 6 Meses (se mais de 1 mês de dados disponíveis)

5. Exemplos e Ilustrações de UI

5.1 REPORT-01: Ver Visão Geral de Saúde Financeira e Previsão de Tendência

Objetivo: Ver visão geral financeira do mês atual, incluindo progresso de poupança, fluxo de caixa líquido, orçamento restante e previsão de final de mês.

Passos:

1. Vá para a aba Relatórios na navegação inferior
2. Veja a seção Saúde Financeira:
   • Meta de poupança: €540 (20% da renda)
   • Poupança real: €378
   • Barra de progresso: 70% - NÍVEL DE CONQUISTA: MÉDIO
   • Fluxo de Caixa Líquido: +€252 [POSITIVO] com fórmula detalhada
   • Orçamento restante: €558 [ESTÁVEL] (62% orçamento ≈ 60% tempo)
   • Ritmo de gastos: 12% maior que o mês anterior
   • Obrigações de empréstimo: €378 [PAGO]
   • Top 5 categorias: Alimentação (32%), Compras (25%), Entretenimento (18%), Transporte (15%), Outro (10%)
3. Veja a seção Previsão de Tendência Futura:
   • Restante esperado no final do mês: +€207 [EXCEDENTE] com fórmula detalhada
   • Probabilidade de alcançar meta: 82% [QUASE ALCANÇAR]
   • Pagamento de empréstimo próximo: Dia 25: €378 [FUNDOS SUFICIENTES]

---

5.2 REPORT-02: Ver Relatório de Renda

Objetivo: Ver análise detalhada da renda deste mês, incluindo renda recorrente, renda extra, tendências e insights.

Passos:

1. Da tela Relatórios, toque no item de menu 💵 Renda na seção “Relatórios Detalhados”
2. Veja Renda Real Total Este Mês: €1.890
3. Veja a seção Renda Recorrente: Total €1.350 (Recebida: €1.170, Ainda não recebida: €180), detalhes de cada item
4. Veja a seção Renda Extra: Total €540 (Freelance: €270, Venda de itens: €90, Pequeno bônus: €180), 5% de aumento do mês anterior
5. Veja Tendência de Renda de 3 Meses (gráfico sparkline)
6. Veja Histórico de Renda Mensal: Este mês, mês anterior, 2 meses atrás
7. Veja Análise de Renda (Insights): Porcentagem de renda recorrente, avaliação de estabilidade, % aumento/diminuição

---

5.3 REPORT-03: Ver Relatório de Despesas

Objetivo: Ver análise detalhada das despesas deste mês, incluindo despesas recorrentes, despesas diárias por categoria, tendências e categorias de aumento de gastos.

Passos:

1. Da tela Relatórios, toque no item de menu 🔥 Despesas na seção “Relatórios Detalhados”
2. Veja Despesas Reais Totais Este Mês: €1.638 (12% de aumento do mês anterior)
3. Veja a seção Despesas Recorrentes: Total €765 (Pagas: €675, Ainda não pagas: €90), detalhes de cada item
4. Veja a seção Despesas Diárias por Categoria: Alimentação €585 (36%), Compras €270 (16%), Transporte €189 (12%), Entretenimento €126 (8%), Outro €90 (5%)
5. Veja a seção Aumento de Gastos: Alimentação (+€108, +22%), Compras (+€72, +35%)
6. Veja Tendência de Despesas de 3 Meses (gráfico sparkline)
7. Veja Histórico de Despesas Mensal: Este mês, mês anterior, 2 meses atrás

---

5.4 REPORT-04: Ver Relatório de Orçamento

Objetivo: Ver visão geral do orçamento deste mês, incluindo orçamento gasto, restante, variação do plano e despesas por categoria.

Passos:

1. Da tela Relatórios, toque no item de menu 📉 Orçamento na seção “Relatórios Detalhados”
2. Veja Visão Geral do Orçamento Este Mês:
   • Orçamento mensal: €900 (toque para ver detalhes de cálculo)
   • Gasto: €342 (Despesas diárias: €225, Variação de despesas: +€45, Variação de renda: -€18)
   • Restante: €558
   • Barra de progresso: 38,0% com texto de dica dinâmico
3. Toque em “Orçamento Mensal” para ver Diálogo de Detalhes do Orçamento com fórmula: Orçamento = Renda - Despesas
4. Veja a seção Variação do Plano: Cada item de renda/despesa com variação, variação total
5. Veja a seção Despesas por Categoria: Total, cada categoria com valor, porcentagem, barra de progresso
6. Toque na categoria para ver lista de despesas nessa categoria

---

5.5 REPORT-05: Ver Relatório de Poupança

Objetivo: Ver análise detalhada da poupança deste mês, incluindo poupança real, análise de poupança, lista de contas de poupança e tendências.

Passos:

1. Da tela Relatórios, toque no item de menu 💾 Poupança na seção “Relatórios Detalhados”
2. Veja Poupança Real Este Mês: €378 com fórmula detalhada de Fluxo de Caixa Líquido
3. Veja a seção Análise de Poupança: Conta de poupança para 20% da renda, 12% de aumento do mês anterior, previsão de final de mês: €459 (≈85% da meta)
4. Veja a seção Lista de Contas de Poupança: 3 contas (€3.600, €450, €1.800), ordenadas por data de vencimento mais próxima
5. Veja Gráfico de Crescimento de Poupança de 6 Meses (gráfico de linha)

---

5.6 REPORT-06: Ver Relatório de Empréstimo

Objetivo: Ver análise detalhada de empréstimos, incluindo saldo de dívida atual, custo do empréstimo deste mês, cronograma de pagamento, insights e tendências.

Passos:

1. Da tela Relatórios, toque no item de menu 💸 Empréstimos na seção “Relatórios Detalhados”
2. Veja Visão Geral do Empréstimo: Saldo de dívida atual €58.500, Custo do empréstimo deste mês €378 (Principal: €315 + Juros: €63)
3. Veja a seção Pagamento Mais Próximo: Dia 25 → PAGO, Próximo pagamento em 14 dias
4. Veja a seção Cronograma de Pagamento Mensal: Últimos 3 meses com valores e status
5. Veja a seção Análise de Empréstimo (Insights): Pago nos últimos 3 meses: €1.134, Tendência de saldo de dívida diminuindo constantemente, Juros representam 17% do pagamento, Risco de atraso no pagamento: BAIXO
6. Veja Gráfico de Redução de Dívida de 6 Meses (gráfico de linha)

---

5.7 REPORT-07: Analisar Despesas por Categoria do Relatório de Visão Geral

Objetivo: Do relatório de visão geral, toque na seção “Despesas por Categoria” para ver relatório de despesas detalhado e análise mais profunda.

Passos:

1. Da tela de visão geral de Relatórios, role até a seção Despesas por Categoria
2. Veja as top 5 categorias com maiores porcentagens
3. Toque no card “Despesas por Categoria” (com ícone chevron-right)
4. O aplicativo rola automaticamente para a seção Relatório de Despesas na mesma tela
5. Veja detalhes completos: Total de despesas, despesas recorrentes, despesas diárias por categoria (mais que top 5), aumento de gastos, tendências e histórico

---

5.8 REPORT-08: Ver Relatórios Quando Dados Insuficientes (Primeiro Mês)

Objetivo: Novos usuários do aplicativo veem relatórios no primeiro mês, quando há dados insuficientes para comparação e análise de tendências.

Passos:

1. Vá para a aba Relatórios
2. Veja a seção Saúde Financeira:
   • Meta de poupança e poupança real (se orçamento existir)
   • Fluxo de Caixa Líquido com fórmula
   • Orçamento restante (se existir)
   • NÃO exibido: “Ritmo de Gastos” (sem dados do mês anterior)
3. Veja a seção Previsão de Tendência Futura (se orçamento > 0)
4. Toque em Relatório de Renda: Total de renda deste mês, renda recorrente e extra, NÃO exibido “Tendência de 3 Meses”, APENAS exibido “Este Mês” no histórico
5. Toque em Relatório de Despesas: Total de despesas deste mês, despesas recorrentes e diárias, NÃO exibido “Aumento de Gastos”, “Tendência de 3 Meses”, APENAS exibido “Este Mês” no histórico

6. Lógica e Regras

6.1 Cálculo de Fluxo de Caixa Líquido

Fórmula:

Fluxo de Caixa Líquido_mês = 
  (Renda recorrente realmente recebida no mês + Renda extra no mês)
  - (Despesas recorrentes realmente pagas no mês + Despesas diárias no mês + Pagamentos reais de empréstimo no mês)

Detalhes:

• Renda: SOMA(ocorrência_renda_recorrente.amount_snapshot) ONDE status = ‘COMPLETED’ E due_date no mês + SOMA(renda_extra.amount) ONDE occurred_at no mês
• Despesas: SOMA(ocorrência_despesa_recorrente.amount_snapshot) ONDE status = ‘COMPLETED’ E due_date no mês + SOMA(despesa_diária.amount) ONDE occurred_at no mês + SOMA(pagamento_empréstimo_bancário.total_amount) ONDE due_date no mês E status != ‘CANCELLED’
• Poupança Real: max(Fluxo de Caixa Líquido_mês, 0) - Se Fluxo de Caixa Líquido positivo: Poupança = Fluxo de Caixa Líquido, Se Fluxo de Caixa Líquido negativo: Poupança = 0 (gastos excessivos)

6.2 Nível de Conquista da Meta de Poupança

Fórmula:

ratio = Poupança_mês / orçamento.savings_amount
progress% = round(ratio × 100)

Limiares:

• BOM: progress% ≥ 90
• MÉDIO: 70 ≤ progress% < 90
• RUIM: progress% < 70

6.3 Orçamento Restante

Fórmula:

• % Orçamento Restante = (Orçamento Restante / Orçamento Total) × 100
• % Tempo Restante = (Dias Restantes / Total de Dias no Mês) × 100

Conclusão:

• Se % orçamento ≈ % tempo: Ritmo de gastos é RAZOÁVEL
• Se % orçamento < % tempo: Gastando MAIS RÁPIDO que o ritmo
• Se % orçamento > % tempo: Gastando MAIS LENTO que o ritmo

Nota: Este card só é exibido quando o orçamento foi criado para este mês.

6.4 Previsão de Final de Mês

Gastos Esperados:

Gastos_Esperados = 
  (Gastos_Diários_Médios × Dias_Restantes_no_Mês)
  + Total_Despesas_Recorrentes_Pendentes_Restantes_Mês
  + Total_Pagamento_Empréstimo_Bancário_Pendente_no_Mês

Detalhes:

• Gastos_Diários_Médios = (Total despesa_diária.amount do início do mês até hoje) / Dias_Decorridos_no_Mês
• Total_Despesas_Recorrentes_Pendentes = SOMA(ocorrência_despesa_recorrente.amount_snapshot) ONDE status = ‘PENDING’ E due_date entre amanhã e final do mês
• Total_Pagamento_Empréstimo_Bancário_Pendente = SOMA(pagamento_empréstimo_bancário.total_amount) ONDE due_date entre amanhã e final do mês E status = ‘PENDING’

Restante Esperado no Final do Mês:

Restante_Esperado_Final_do_Mês = Fluxo de Caixa Líquido_mês - Gastos_Esperados

Probabilidade de Alcançar Meta de Poupança:

ratio = Restante_Esperado_Final_do_Mês / orçamento.savings_amount
progress% = round(ratio × 100)

Rótulos:

• ≥ 90% → ALCANÇARÁ
• 70–89% → QUASE ALCANÇAR
• < 70% → DIFÍCIL DE ALCANÇAR

Nota: A previsão só é exibida quando orçamento > 0.

6.5 Dados Reais vs Plano

• Todos os dados do relatório usam dados REAIS:
  • Renda: Ocorrências COMPLETED + renda_extra
  • Despesas: Ocorrências COMPLETED + despesa_diária
  • Pagamentos de empréstimo: pagamento_empréstimo_bancário com due_date no mês (independentemente de ter sido pago ou não)
• NÃO usa dados do plano (ocorrências PENDING ainda não vencidas)

7. Notas Importantes

• Apenas Dados do Mês Atual: Os relatórios exibem apenas dados do mês atual
• Condições de Exibição:
  • Card “Orçamento Restante” só é exibido quando o orçamento foi criado para este mês
  • Card “Ritmo de Gastos” só é exibido quando dados do mês anterior estão disponíveis para comparação
  • Card “Obrigações de Empréstimo” só é exibido quando empréstimos existem
  • Item de menu “Orçamento” só é exibido quando o orçamento foi criado
  • Item de menu “Poupança” só é exibido quando contas de poupança existem
  • Item de menu “Empréstimos” só é exibido quando empréstimos existem
  • Seção “Previsão de Tendência Futura” só é exibida quando orçamento > 0
• Previsão é Apenas para Referência: Baseada em tendências atuais e itens PENDING
• Primeiro Mês: Alguns cards/seções não são exibidos devido à falta de dados de comparação (ex.: “Ritmo de Gastos”, “Tendência de 3 Meses”, “Aumento de Gastos”)
• Cards são Clicáveis: Clicar em um card rola até o relatório detalhado correspondente na mesma tela