Painéis do Dia a Dia

Este capítulo documenta as telas que respondem "o que está acontecendo no negócio agora" e "o que precisa de mim hoje". Elas não fazem parte do fluxo operacional em si (recebimento no Paraguai, triagem com laudo e grade, assistência, expedição pra SP, venda) — são a camada de cima, que lê o que as outras telas já gravaram e devolve números, alertas e listas clicáveis. Nenhuma tela deste capítulo cadastra aparelho, bipa caixa ou fecha venda: quando você clica num item aqui, ela te leva pra tela funcional onde a ação de verdade acontece (o inventário, a expedição, as vendas, o Contas a Receber).

O módulo tem duas gerações convivendo hoje. A mais antiga é um conjunto de telas separadas — Raio-X do Dono, "O que está preso" (Pendências) e Command Center (Central) — cada uma com seu próprio propósito. A mais nova é o Painel do Dia, que funde as três (mais a fila de Aprovações) numa tela só para ADMIN/GERENTE, e dá a VENDEDOR e FINANCEIRO uma versão enxuta, pensada pro que cada um decide no dia a dia. As telas antigas continuam funcionando por trás — o Painel do Dia reaproveita exatamente os mesmos carregadores de dado (nenhuma consulta de negócio nova), então o mesmo número aparece nos dois lugares.

Existe também o Dashboard, um hub separado com 5 abas de indicadores (Operacional, Financeiro, Vendas, Estoque, Aprovações) — mais detalhado e histórico que os painéis de "o que fazer agora", e o único deste capítulo aberto a todos os perfis (com os cards de dinheiro bloqueados pra quem não tem a permissão).

Fluxo do módulo em 1 olhada

1. O usuário loga e, se o perfil for ADMIN, GERENTE, VENDEDOR ou FINANCEIRO, encontra o Painel do Dia no topo do menu ("Início").
2. ADMIN/GERENTE veem 6 cartões: capital parado, assistência travada, a receber vencido, aguardando aprovação, o que está preso, e atalhos de ferramentas (Central, Copiloto).
3. VENDEDOR vê só as próprias propostas (cotações) vencendo nas próximas 24h.
4. FINANCEIRO vê só as parcelas já vencidas.
5. Cada cartão do Painel do Dia linka pra sua tela funda: Raio-X do Dono (capital parado / assistência travada), O que está preso (contradições e itens parados), Command Center (fila de trabalho operacional) ou Financeiro / Vendas / Aprovações.
6. Quem quer o detalhe histórico completo (tabela por status, ranking de vendedor, distribuição por modelo) abre o Dashboard e navega pelas 5 abas — essas sim, restritas a quem tem a permissão de ver dinheiro (ADMIN, GERENTE, FINANCEIRO).
7. Uma configuração interna (o "Painel do Dia unificado") decide se Raio-X e Pendências continuam sendo telas próprias ou se viram um redirecionamento automático pro Painel do Dia — ver detalhe em cada tela abaixo.

Painel do dia

Pra que serve: hub único que junta, numa tela só, o que ADMIN/GERENTE antes abriam em 4 telas separadas (Raio-X, Pendências, fila de Aprovações, Central) — e dá a VENDEDOR e FINANCEIRO a versão deles (o que cada um decide no dia, não o negócio inteiro). É a tela mais nova do capítulo, lançada em 22–23/08.

Quem usa: ADMIN, GERENTE, VENDEDOR e FINANCEIRO — são os únicos 4 perfis liberados nesta tela. Qualquer outro perfil (das áreas operacionais: Operador PY, Operador SP, Testador, Técnico Próprio, Supervisor de Assistência) que tentar abrir a URL é redirecionado pro Dashboard sem aviso. O que aparece na tela muda por perfil:

• ADMIN/GERENTE ("gestão"): vê os 6 cartões completos.
• VENDEDOR: vê só o cartão "Propostas vencendo em 24h" (as próprias cotações).
• FINANCEIRO: vê só o cartão "Parcelas vencidas".

Ações principais:

• ADMIN/GERENTE: 5 cartões de leitura (Capital parado, Assistência travada, A receber vencido, Aguardando a sua aprovação, O que está preso) + 1 cartão "Ferramentas" com atalho pra Central da operação e pro Copiloto (assistente de IA do sistema).
• Cada cartão tem um link "abrir X" que leva pra tela funda correspondente.
• VENDEDOR: link "abrir Cotações" (ver Vendas).
• FINANCEIRO: link "abrir Contas a Receber" (ver Financeiro).

Fluxo correto:

1. Fazer login — o Painel do Dia é o primeiro item do menu "Início" pros 4 perfis liberados.
2. ADMIN/GERENTE: olhar os cartões com número — priorizar os que têm algo diferente de "tudo em dia"/"nada preso" (capital parado maior que zero, assistência travada maior que zero, fila de aprovação não vazia, algo preso).
3. Clicar no cartão certo pra abrir a tela onde se resolve (ex.: clicar em "Capital parado" abre o Raio-X do Dono, que mostra os itens específicos).
4. VENDEDOR: abrir, ver quais propostas vencem nas próximas 24h, decidir se reenvia a cotação ao cliente antes de expirar.
5. FINANCEIRO: abrir, ver as parcelas já vencidas, cobrar o cliente ou registrar acordo em Contas a Receber.

Se pular ou errar: cada cartão isola o próprio erro — se um cartão falhar ao carregar, ele mostra "Não carregou: <mensagem>" mas os outros continuam normais (a tela inteira não cai por causa de 1 consulta ruim). Se a sessão ou a empresa não resolver (usuário deslogado, empresa não encontrada), a página inteira mostra "Não autorizado." Ignorar os cartões de alerta tem a mesma consequência de ignorar o Raio-X, as Pendências ou as Aprovações diretamente — dinheiro parado, aparelho preso, aprovação atrasada — só que agora está tudo visível num lugar só, então ignorar fica mais difícil de justificar.

Detalhes e estados:

• Uma configuração interna decide se as telas antigas Raio-X e Pendências continuam abrindo sozinhas ou se viram um redirecionamento automático pra esta tela. O Painel do Dia em si sempre está no ar e no menu, independente dessa configuração — só os dois redirecionamentos dependem dela.
• Quando chega redirecionado, aparece um banner explicando: "O Raio-X agora mora aqui" ou "O painel de pendências agora mora aqui" — e avisa que os links antigos continuam funcionando.
• Os Painéis Paraguai e SP ficam fora desta fusão de propósito — são tratados como o "modelo a seguir", não o problema.
• O cartão "Aguardando a sua aprovação" cruza 2 fontes: as 5 vendas mais antigas esperando aprovação, e a contagem (não a lista) de movimentações de aparelho pendentes de aprovação — as duas somadas na mesma lista.
• Os valores em R$ desta tela usam uma formatação própria, ligeiramente diferente da usada no resto do sistema — mas isso é seguro aqui porque os valores exibidos são sempre agregados positivos (a diferença entre as duas formatações só aparece em valores negativos, que não acontecem nesta tela).
• Reaproveita os mesmos carregadores de dado do Raio-X do Dono e das Pendências — não existe consulta de negócio nova aqui, é composição das mesmas informações.

Raio-X do Dono

Pra que serve: "o pulso do negócio + o que precisa de ação agora" — uma faixa com 5 métricas grandes (valor em estoque, vendas do mês, lucro do mês, a receber, em assistência) e 4 cartões de atenção (capital parado, assistência travada, a receber vencido, pendências operacionais), cada um com o top 5 dos piores itens.

Quem usa: ADMIN e GERENTE — a tela verifica uma "capacidade" (um poder de negócio específico, liberado só pra uma lista fechada de perfis; aqui, ADMIN e GERENTE) chamada "ver o Raio-X do Dono". Qualquer outro perfil que digitar a URL é redirecionado pro Dashboard, sem mensagem — "a rota some, não só o menu".

Ações principais:

• Cada item da faixa de pulso (5 métricas) é um link pra tela detalhada (Estoque, Vendas e Financeiro — as abas do Dashboard —, Contas a Receber e o Painel da Assistência).
• Cada item do top 5 dos 4 cartões de atenção é um link direto pro registro (o aparelho no Inventário, a ordem de serviço — ver OS, Garantia e RMA —, ou a parcela em Contas a Receber).
• Botão "Encalhe: N dia(s)" no canto superior direito abre um formulário inline pra editar o limiar de "capital parado" (quantos dias parado no estoque disponível já conta como alerta).

Fluxo correto:

1. Abrir o Raio-X do Dono (ou chegar via cartão do Painel do Dia).
2. Ler a faixa do pulso — 5 números com o estado geral do negócio no mês.
3. Ler os 4 cartões coloridos: verde = "tudo em dia"; âmbar/vermelho = tem algo pra ver, com contagem e (quando aplicável) soma em R$/US$.
4. Clicar no item da lista (top 5) pra abrir o registro exato e agir (ex.: abrir o aparelho parado, ver por que ele não vendeu).
5. Se o limiar de "dias parado" configurado não bate com o que a operação considera razoável, clicar em "Encalhe: N dia(s)", digitar o novo valor e salvar.

Se pular ou errar:

• Se a fusão de painéis (Painel do Dia unificado) estiver ativada, esta página nunca chega a aparecer — ela redireciona direto pro Painel do Dia antes de mostrar qualquer coisa.
• Perfil sem a capacidade de ver o Raio-X que tenta acessar por URL é jogado de volta pro Dashboard — sem explicação na tela (é assim de propósito, pra fechar a brecha de "abrir por URL direta").
• Salvar um valor errado no campo de encalhe muda o critério de "capital parado" pra toda a empresa, inclusive no cartão equivalente do Painel do Dia — é a mesma configuração nos dois lugares.
• Se a leitura do valor atual de encalhe falhar, o formulário não é mostrado como editável — aparece um aviso de erro em vez do botão. Isso é proposital: antes de uma correção feita em 14/07, uma falha de leitura virava silenciosamente "60 dias" no formulário, e quem salvasse sobrescrevia o valor real (por exemplo, 90) por um valor chutado.

Detalhes e estados:

• A severidade do cartão "Capital parado" é diferente dos outros 3: ela olha a idade do pior item (o mais velho no estoque), não a contagem — até o limiar configurado é verde, até o dobro do limiar é âmbar, acima do dobro é vermelho. Os outros 3 cartões (Assistência travada, A receber, Pendências operacionais) usam contagem simples: 0 é verde, de 1 a 4 é âmbar, 5 ou mais é vermelho.
• "Capital parado" mede aparelhos com status DISPONIVEL_PY ou DISPONIVEL_SP cuja data de entrada no sistema é mais antiga que o limiar configurado (o padrão, se a empresa não tiver configurado nada, é 60 dias).
• "Assistência travada" mede ordens de serviço abertas (ABERTA/EM_ANDAMENTO/AGUARDANDO_PECA/AGUARDANDO_APROVACAO) mais antigas que o limiar de dias em reparo configurado pra assistência (padrão: 7 dias) — é uma configuração separada da de encalhe.
• "A receber vencido" usa a mesma lógica de "vencido de verdade" que a tela de Contas a Receber — decide se uma parcela está vencida pela data, não só pelo status cru salvo no banco — o que evita que este cartão mostre um número diferente do resto do sistema.
• "Pendências operacionais" tem um formato diferente dos outros — 4 subcontadores (caixas aguardando liberação, aparelhos em triagem há mais de 2 dias, aprovações pendentes, vendas aguardando aprovação), não uma lista de top 5.

O que está preso

Pra que serve: cruza várias tabelas do banco atrás de dois tipos de problema, que a tela nunca mistura: Contradições (o sistema discorda de si mesmo — sempre um defeito, sem explicação boa) e Parados (nada anda há tempo demais — pode ter motivo, mas motivo não registrado vira aparelho invisível). A tela nasceu de uma investigação de causa-raiz (31/07) que achou 4 bugs no mesmo dia (aparelho sumido, botão de apagar que não apagava, 275 etiquetas com selo errado, reserva que não expirava) — e viu que todos vinham da mesma origem: uma decisão registrada num canto do sistema e nunca fechada.

Quem usa: ADMIN e GERENTE — a mesma capacidade de "ver pendências".

Ações principais: nenhuma ação de escrita acontece nesta tela — é puramente diagnóstico. Cada linha da lista linka pra tela onde o problema se resolve (a venda, o aparelho, a expedição, a reserva). Cada bloco de tipo de problema mostra explicitamente "Quem fecha" (o dono da resolução) e "Como fechar" (o passo concreto, não "verificar").

Fluxo correto:

1. Abrir a tela de pendências.
2. Ler o resumo no topo — quantas contradições, quantas coisas paradas, e qual é a espera mais longa (em dias).
3. Se aparecer um banner vermelho no topo dizendo que alguma verificação "não rodou" — ler primeiro. É um aviso de que uma parte da checagem falhou, e o que está abaixo dele está incompleto (não é "nada preso", é "não consegui olhar").
4. Ler a seção Contradições primeiro — sempre na frente, porque é sempre defeito.
5. Dentro de cada tipo de contradição, ler "Quem fecha" e "Como fechar" e agir na tela linkada.
6. Ler a seção Parados depois, mesma lógica — mas aqui pode haver motivo legítimo (ex.: cliente sumiu, falta peça); mesmo assim, alguém precisa registrar o motivo ou destravar.

Se pular ou errar: deixar uma contradição sem fechar mantém o estado do banco mentindo.

⚠️ Atenção: foi assim que 8 aparelhos ficaram presos 17 dias sem que ninguém soubesse (uma reserva de grade segurando estoque de um pacote já cancelado) e que 275 etiquetas saíram com o selo errado — a etiqueta dizia "conserto" enquanto o estoque dizia "disponível". A tela deliberadamente não mostra "nenhuma pendência" quando a consulta falhou de verdade — mostrar isso seria repetir o mesmo problema que a tela existe pra resolver.

Detalhes e estados:

• Existem 9 tipos de checagem, cada uma rodando isolada (uma falhando não derruba as outras):
  • Contradições (sempre defeito, sem motivo bom): reserva de grade "órfã" (presa a um pacote ou cotação que já não existe mais); reserva vencida há mais de 48h e nunca liberada; etiqueta com selo diferente do status real do aparelho; aparelho disponível mas sem grade cadastrada (A/AB/B/C/MIX); cotação aceita que já devia ter expirado; e o robô que expira reservas de cotação, quando parado (ver abaixo).
  • Parados (pode ter motivo, mas precisa ser registrado): pacote parado há mais de 3 dias; venda aberta parada há mais de 7 dias; passagem de aparelho entre estações sem confirmação de recebimento há mais de 3 dias.

⚠️ Atenção: um aparelho com status DISPONIVEL_* mas sem grade cadastrada fica invisível pro despacho do Paraguai pra SP — ele simplesmente não aparece pra ser enviado, mesmo estando disponível no sistema. Casos novos já são barrados na entrada do sistema; esta checagem é só o estoque legado (mais antigo) que ainda precisa de correção.

• Existe uma checagem específica pra pegar "o instrumento mentindo": se a rotina automática que expira reservas de cotação não rodar há mais de 30 minutos, isso vira um alarme aqui — silêncio da rotina automática não pode virar silêncio na tela.
• Se a fusão de painéis estiver ativada, esta rota também vira redirecionamento pro Painel do Dia, mesma mecânica do Raio-X do Dono.

Command Center

Pra que serve: "o que precisa de você agora" — 6 métricas de fila de trabalho, cada uma clicável e levando direto pra tela (já filtrada, quando aplicável) que resolve.

Quem usa: ADMIN e GERENTE. Foi removida do menu de VENDEDOR, FINANCEIRO, Operador SP e Operador PY em 22/08, quando ganhou essa trava — antes esses perfis viam o item no menu; hoje quem precisa dela chega pelo atalho "Ferramentas" do Painel do Dia (que também é só ADMIN/GERENTE).

Ações principais: 6 cartões clicáveis — Pacotes a separar, Pacotes atrasados, Pacotes em rota, Aprovações pendentes, Parcelas vencidas, Remessas em rota. Os 3 primeiros já levam pra Expedição com o filtro certo pré-aplicado (ex.: clicar em "atrasados" abre só os atrasados, sem precisar refiltrar na mão).

Fluxo correto:

1. Abrir o Command Center (ou o cartão "Ferramentas → Central da operação" no Painel do Dia).
2. Bater o olho nos cartões em vermelho (os que têm alerta ativo: atrasados, aprovações pendentes, parcelas vencidas).
3. Clicar no cartão pra abrir a fila já filtrada.
4. Resolver na tela funcional.

Se pular ou errar: nada quebra tecnicamente por não visitar esta tela — mas ADMIN/GERENTE perde a visão consolidada de filas e pode não notar pacotes atrasados ou parcelas vencidas a tempo.

Detalhes e estados:

• "Aprovações pendentes" soma duas fontes diferentes: vendas com status AGUARDANDO_APROVACAO + movimentações de aparelho marcadas como precisando de aprovação e ainda sem aprovação registrada.
• "Parcelas vencidas" aqui filtra pelo status cru salvo no banco (PENDENTE/ATRASADO) com vencimento antes de hoje — isso é diferente do critério usado no Raio-X do Dono e no Dashboard Financeiro, que calculam o vencimento pela data em vez de confiar só no status salvo. Se o processo que atualiza o status das parcelas atrasar, os números de "Parcelas vencidas" no Command Center e no Raio-X/Financeiro podem divergir por um período.

Dashboard (Resumo)

Pra que serve: hub de 5 indicadores-chave (KPI, sigla de "indicador-chave de desempenho") num resumo só, com abas de navegação pros 5 painéis detalhados (Operacional, Financeiro, Vendas, Estoque, Aprovações) e um card extra de distribuição do estoque por grade.

Quem usa: todos os perfis do sistema — é a única tela deste capítulo sem trava de perfil na própria página; qualquer usuário autenticado entra. O que muda por perfil é dentro da tela: quem não tem a capacidade de ver dinheiro (só ADMIN, GERENTE e FINANCEIRO têm; os perfis operacionais, incluindo VENDEDOR, não têm) vê os cards de Financeiro, Vendas, Estoque, Operacional e Aprovações como uma caixa cinza "🔒 acesso restrito" — não clicável — em vez de link.

Ações principais: 6 cards de resumo (Operacional, Financeiro, Vendas, Estoque, Aprovações, Distribuição por grade) + abas de navegação pros 5 painéis internos.

Fluxo correto:

1. Abrir o Dashboard (item de menu disponível a qualquer perfil).
2. Ler os 6 cards — cada um mostra um destaque grande e um subtítulo.
3. Clicar no card (se não estiver bloqueado) ou na aba pra abrir o painel detalhado correspondente.

Se pular ou errar: nada trava — é visão consolidada, não ação. Se uma consulta falhar ao montar o resumo, aparece um banner vermelho com a mensagem de erro (nunca esconde silenciosamente atrás de "0").

Detalhes e estados:

• Quem não vê dinheiro ainda enxerga o card "Estoque" — mas com a contagem de unidades em vez do valor em R$ (o destaque muda de "R$ X" pra "N em estoque" conforme a permissão).
• Um detalhe encontrado no menu: o menu do perfil Operador SP inclui o item "Dashboard Operacional", mas essa página exige a capacidade de ver dinheiro (só ADMIN/GERENTE/FINANCEIRO têm) — um Operador SP que clicar nesse item do próprio menu é redirecionado de volta pro Dashboard sem nenhuma explicação. É o mesmo padrão de "o menu promete, a trava recusa" já visto (e corrigido) em outros lugares do sistema. Vale reportar pro time técnico se você notar isso acontecendo.
• "Distribuição por grade" soma tudo que está fisicamente no estoque, ordenado A → AB → B → C → resto, e é a mesma fonte usada no total "em estoque" (antes era calculado duas vezes em lugares diferentes; hoje é uma fonte só).

Dashboard · Operacional

Pra que serve: pipeline (quantos aparelhos em cada status ativo da operação), tempo médio de permanência em cada etapa (em dias), percentual de aparelhos parados há mais de 7 dias (meta: abaixo de 2%) e quantas aprovações foram criadas hoje (meta: abaixo de 10/dia).

Quem usa: ADMIN, GERENTE e FINANCEIRO (a capacidade de ver dinheiro) — o mesmo perfil que abre esta aba do Dashboard vê também a de Financeiro, Vendas, Estoque e Aprovações; a trava é a mesma nas 5 abas do hub.

Ações principais: só leitura — uma tabela ordenada por quantidade (status com mais aparelhos primeiro) com 3 colunas (status, quantidade, tempo médio na etapa).

Fluxo correto:

1. Abrir a aba "Operacional" do Dashboard.
2. Olhar os 3 cartões do topo (% parados há mais de 7 dias, total de aparelhos ativos, aprovações criadas hoje).
3. Se algum estiver marcado em vermelho (acima da meta), abrir a tabela de pipeline por status pra achar onde o estoque está empacando.
4. Ir pra tela funcional certa (ex.: Inventário, Triagem) pra investigar e destravar.

Se pular ou errar: esta tela não corrige nada sozinha — é termômetro. Ignorar o alerta de "% parados acima de 7 dias" significa só perceber o acúmulo de estoque parado quando ele já aparecer grande no cartão "Capital parado" do Raio-X do Dono (que usa um limiar mais alto, o "dias de encalhe" configurável).

Detalhes e estados:

• Exclui aparelhos com status VENDIDO, CANCELADO, DEVOLVIDO ou SUCATA do pipeline (não estão mais "na operação").
• Os limiares "2% parados" e "10 aprovações/dia" são fixos no sistema — diferente do "dias de encalhe" do Raio-X do Dono, que é configurável pela interface.

Dashboard · Financeiro

Pra que serve: total a receber (parcelas abertas), percentual de parcelas vencidas (meta: abaixo de 5%), lucro do mês (ou margem bruta) e projeção de recebimento futuro.

Quem usa: ADMIN, GERENTE e FINANCEIRO.

Ações principais: leitura dos 4 cards; link "Contas a Receber" pro detalhamento parcela a parcela (aqui é só o resumo, a cobrança de fato acontece lá — ver Financeiro).

Fluxo correto:

1. Abrir a aba "Financeiro".
2. Ler os 4 cards: A receber, Parcelas vencidas, Lucro/Margem do mês, Projeção a receber.
3. Se "Parcelas vencidas" estiver vermelho (5% ou mais), clicar em "Contas a Receber" pra ver quais e cobrar.
4. Prestar atenção no rótulo do 3º card — ele muda sozinho entre "Lucro líquido do mês" e "Margem bruta do mês".

Se pular ou errar: nada é cobrado automaticamente por esta tela — é acompanhamento. Deixar de visitar significa não perceber a inadimplência subindo até ela aparecer em outro lugar (Raio-X do Dono, Command Center).

Detalhes e estados:

• O rótulo do 3º card muda sozinho: vira "Lucro líquido do mês" quando existe pelo menos um lançamento de custo fixo no mês de referência; vira "Margem bruta do mês" (com aviso de que custos fixos não foram lançados) quando não existe — isso evita mostrar margem bruta disfarçada de lucro líquido.
• Valores em dólar (US$) aparecem sempre separados do valor em real (nunca somados na mesma soma) — e só aparecem quando existe parcela ou venda em dólar de fato na carteira.

Dashboard · Vendas

Pra que serve: vendas de hoje e do mês, ticket médio (valor médio por venda) e ranking de vendedor.

Quem usa: ADMIN, GERENTE e FINANCEIRO.

Ações principais: leitura; 3 cards de resumo + 1 tabela de ranking (posição, vendedor, total vendido).

Fluxo correto:

1. Abrir a aba "Vendas".
2. Olhar os 3 cards (hoje, mês, ticket médio).
3. Olhar o ranking pra ver quem está vendendo mais no período.

Se pular ou errar: nada quebra — é só acompanhamento de desempenho.

Detalhes e estados:

• O ranking une vendas em real e em dólar por vendedor, mas sem somar as duas moedas — um vendedor que só vende em dólar aparece com o valor certo em US$, não com "R$ 0,00".
• Considera só vendas com status ABERTA, PARCIALMENTE_PAGA ou PAGA — vendas canceladas ou ainda não concretizadas não entram no número.

Dashboard · Estoque

Pra que serve: valor de custo x valor de venda do estoque atual, margem potencial, giro (quantos aparelhos vendidos no mês proporcionalmente ao estoque atual), e distribuição por modelo e por localização.

Quem usa: ADMIN, GERENTE e FINANCEIRO.

Ações principais: leitura; 4 cards (custo, venda, margem potencial, giro) + 2 tabelas (valor por modelo, valor por localização).

Fluxo correto:

1. Abrir a aba "Estoque".
2. Olhar os 4 cards do topo.
3. Se "Margem potencial" estiver negativa (em vermelho), ler o aviso amarelo abaixo e ir em Precificação cadastrar o preço faltante.
4. Olhar as 2 tabelas pra entender onde o estoque está concentrado (modelo e localização).

Se pular ou errar: uma margem potencial negativa não investigada pode ser lida como prejuízo real quando na verdade é ausência de preço cadastrado.

⚠️ Atenção: o card já avisa isso, mas só quem abre a tela vê o aviso — normalmente uma "margem negativa" aqui é aparelho sem preço de venda cadastrado, não prejuízo de verdade. Antes de alarmar o time, confira se o aparelho tem preço lançado.

Detalhes e estados:

• O valor de custo nunca é recalculado aqui — a tela lê o valor já consolidado por outra parte do sistema, não refaz a conta.
• O valor de venda resolve o preço vigente (o preço específico do aparelho, se cadastrado, tem prioridade sobre a tabela de preços geral) e cai pra zero — nunca pro valor de custo — quando não há preço cadastrado. Essa escolha é deliberada: se caísse pro custo, "Valor de venda" ficaria sempre igual a "Valor de custo" e a margem sempre daria R$ 0,00, escondendo o problema real (falta de preço) atrás de um número que parece neutro.

Dashboard · Aprovações

Pra que serve: quantas aprovações foram criadas hoje (meta: abaixo de 10/dia) e quantas estão na fila total, agrupadas por tipo.

Quem usa: ADMIN, GERENTE e FINANCEIRO.

Ações principais: leitura; link "Abrir fila completa" que leva pra tela de Aprovações — é lá, não aqui, que se aprova ou rejeita de fato.

Fluxo correto:

1. Abrir a aba "Aprovações".
2. Olhar "Criadas hoje" contra a meta (menos de 10/dia).
3. Olhar "Pendentes por tipo" pra saber que tipo de aprovação está acumulando.
4. Clicar em "Abrir fila completa" pra agir de fato.

Se pular ou errar: esta tela não aprova nada sozinha — é só um contador. Confundir "vi o número aqui" com "resolvi" deixa a fila real crescendo na tela de Aprovações.

Detalhes e estados: reutiliza exatamente a mesma regra de negócio da fila completa de Aprovações (movimentação marcada como precisando de aprovação e ainda sem aprovação registrada) — não reescreve o critério, só soma e agrupa por tipo.

Erros comuns e como evitar

1. Achar que Painel do Dia e Raio-X/Pendências mostram dados diferentes. Não mostram — são a mesma fonte (os mesmos carregadores de dado), só com embalagem diferente. Ajustar o limiar de "dias de encalhe" no Raio-X do Dono muda o mesmo número no Painel do Dia.
2. Ler só o número do card "Lucro do mês" sem ler o rótulo. O card do Dashboard Financeiro alterna sozinho entre "Lucro líquido do mês" e "Margem bruta do mês" — são conceitos diferentes, e o rótulo muda conforme o custo fixo do mês já foi lançado ou não.
3. Ver "nada preso" na tela de pendências e não perceber que uma checagem falhou. Se o banner vermelho de "verificações não rodaram" aparecer no topo, a lista abaixo dele está incompleta — não é a mesma coisa que "está tudo certo".
4. Clicar em Dashboard Operacional sendo Operador SP e achar que é bug do sistema. O menu mostra o item, mas a rota exige a permissão de ver dinheiro (que Operador SP não tem) — o clique volta pro Dashboard sem aviso. Não é erro do usuário; é um descompasso entre o menu e a trava da rota que vale reportar.
5. Comparar "Parcelas vencidas" do Command Center com o mesmo número no Raio-X do Dono ou no Dashboard Financeiro esperando bater sempre. Os dois usam critérios ligeiramente diferentes pra decidir "vencido" (status cru salvo no banco x status calculado pela data) — podem divergir por um tempo se algum processo automático atrasar.
6. Esperar que o Raio-X do Dono ou a tela de pendências sumiram quando a fusão de painéis está ativada. Elas viram redirecionamento automático pro Painel do Dia — o conteúdo não desapareceu, só mudou de endereço (com aviso na tela de destino).
7. Achar que o Command Center está sumido do menu por engano. Foi removido de propósito do menu de VENDEDOR, FINANCEIRO, Operador SP e Operador PY em 22/08 quando a rota ganhou a trava ADMIN/GERENTE — hoje é só o atalho "Ferramentas" do Painel do Dia (também restrito a esses 2 perfis).