{
  "id": "dashboard",
  "title": "Dashboard",
  "description": "Visão diária do saldo financeiro, acertos pendentes, contatos cadastrados e notificações não lidas.",
  "type": "feature",
  "status": "observed",
  "visibility": "public",
  "tags": [
    "dashboard",
    "produto",
    "indicadores"
  ],
  "related": [
    "funcionalidades",
    "financas",
    "acertos",
    "contatos",
    "notificacoes"
  ],
  "sourceRefs": [
    "https://github.com/james-suite/james/blob/master/routes/web.php",
    "https://github.com/james-suite/james/blob/master/app/Http/Controllers/DashboardController.php",
    "https://github.com/james-suite/james/blob/master/resources/views/dashboard.blade.php",
    "https://github.com/james-suite/james/blob/master/app/Services/FinanceDashboardService.php"
  ],
  "authors": [],
  "updated": null,
  "diagram": null,
  "body": "## Para que serve\n\nO Dashboard (`/dashboard`) é a primeira visão depois da autenticação. Ele não substitui os módulos detalhados; funciona como um painel de triagem para decidir onde agir hoje.\n\nOs números são calculados na data atual e respeitam os registros ativos do usuário. Contatos com acertos arquivados não entram no resumo principal de acertos.\n\n## Indicadores principais\n\n### Finanças\n\nMostra o saldo atual das contas financeiras não classificadas como investimento e leva para o [Painel financeiro](doc:painel-financeiro). Esse cartão representa o saldo das contas, não o saldo líquido depois de faturas e compromissos pendentes.\n\nO painel financeiro detalhado calcula também o saldo líquido, descontando faturas abertas e despesas pendentes.\n\n### Acertos\n\nMostra o valor líquido agregado dos contatos com pendências e informa se o usuário tem a receber, tem a pagar ou está quite. O cálculo usa o mesmo `SettlementBalanceCalculator` da página de [Acertos](doc:acertos).\n\n### Contatos\n\nExibe a quantidade de contatos cadastrados e abre a listagem de [Contatos](doc:contatos). O contador não é uma soma de pessoas únicas em grupos; ele representa os registros da tabela de contatos.\n\n### Notificações\n\nExibe a quantidade de notificações não lidas e abre a central de [Notificações](doc:notificacoes).\n\n## Blocos de atenção\n\nQuando existem dados, o Dashboard apresenta dois blocos adicionais:\n\n- **Acertos pendentes**: até quatro contatos com saldo diferente de zero, ordenados pelo maior valor absoluto. Cada item abre o ledger do contato.\n- **Notificações não lidas**: até três notificações mais recentes, com título, mensagem e data. Abrir uma delas leva ao detalhe e marca a notificação como lida.\n\nSe não houver acertos pendentes nem notificações não lidas, esses blocos não ocupam espaço na página.\n\n## O que o Dashboard não faz\n\n- não edita transações, contatos ou acertos;\n- não apresenta o histórico financeiro completo;\n- não substitui os gráficos e projeções do Painel financeiro;\n- não inclui contatos arquivados no resumo de acertos;\n- não transforma notificações em tarefas ou mensagens enviadas automaticamente.\n\nUse o Dashboard para identificar uma pendência e siga o link para o módulo responsável pela operação.",
  "sections": [
    {
      "id": "para-que-serve",
      "level": 2,
      "title": "Para que serve",
      "text": "O Dashboard (`/dashboard`) é a primeira visão depois da autenticação. Ele não substitui os módulos detalhados; funciona como um painel de triagem para decidir onde agir hoje.  Os números são calculados na data atual e respeitam os registros ativos do usuário. Contatos com acertos arquivados não entram no resumo principal de acertos.",
      "line": 1
    },
    {
      "id": "indicadores-principais",
      "level": 2,
      "title": "Indicadores principais",
      "text": "",
      "line": 7
    },
    {
      "id": "financas",
      "level": 3,
      "title": "Finanças",
      "text": "Mostra o saldo atual das contas financeiras não classificadas como investimento e leva para o [Painel financeiro](doc:painel-financeiro). Esse cartão representa o saldo das contas, não o saldo líquido depois de faturas e compromissos pendentes.  O painel financeiro detalhado calcula também o saldo líquido, descontando faturas abertas e despesas pendentes.",
      "line": 9
    },
    {
      "id": "acertos",
      "level": 3,
      "title": "Acertos",
      "text": "Mostra o valor líquido agregado dos contatos com pendências e informa se o usuário tem a receber, tem a pagar ou está quite. O cálculo usa o mesmo `SettlementBalanceCalculator` da página de [Acertos](doc:acertos).",
      "line": 15
    },
    {
      "id": "contatos",
      "level": 3,
      "title": "Contatos",
      "text": "Exibe a quantidade de contatos cadastrados e abre a listagem de [Contatos](doc:contatos). O contador não é uma soma de pessoas únicas em grupos; ele representa os registros da tabela de contatos.",
      "line": 19
    },
    {
      "id": "notificacoes",
      "level": 3,
      "title": "Notificações",
      "text": "Exibe a quantidade de notificações não lidas e abre a central de [Notificações](doc:notificacoes).",
      "line": 23
    },
    {
      "id": "blocos-de-atencao",
      "level": 2,
      "title": "Blocos de atenção",
      "text": "Quando existem dados, o Dashboard apresenta dois blocos adicionais:  - **Acertos pendentes**: até quatro contatos com saldo diferente de zero, ordenados pelo maior valor absoluto. Cada item abre o ledger do contato. - **Notificações não lidas**: até três notificações mais recentes, com título, mensagem e data. Abrir uma delas leva ao detalhe e marca a notificação como lida.  Se não houver acertos pendentes nem notificações não lidas, esses blocos não ocupam espaço na página.",
      "line": 27
    },
    {
      "id": "o-que-o-dashboard-nao-faz",
      "level": 2,
      "title": "O que o Dashboard não faz",
      "text": "- não edita transações, contatos ou acertos; - não apresenta o histórico financeiro completo; - não substitui os gráficos e projeções do Painel financeiro; - não inclui contatos arquivados no resumo de acertos; - não transforma notificações em tarefas ou mensagens enviadas automaticamente.  Use o Dashboard para identificar uma pendência e siga o link para o módulo responsável pela operação.",
      "line": 36
    }
  ],
  "sourcePath": "content/dashboard.md",
  "visuals": [],
  "apiVersion": 1
}