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).

Desde a atualização de 21/09/2026 (v3.0), existe também uma camada de alerta específica pro caminho pacote → assistência → reteste: uma rotina automática que detecta quando algo travou e avisa em 2 níveis (primeiro o sino, depois o WhatsApp da gestão), mais duas telas novas — o Placar da Assistência (pensado pra ficar numa TV da bancada) e o Painel de erros (pro gestor investigar onde o processo está falhando mais). As três estão descritas em seções próprias, logo depois de "O que está preso".

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, GERENTE e SUPERVISOR_ASSISTENCIA — a mesma capacidade de "ver pendências" (ver_pendencias).

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 10 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; e (desde 21/09/2026) um incidente do circuito parado ainda sem resolução — ver a seção "Circuito parado — alerta em 2 níveis", logo abaixo, pra entender como esse incidente nasce.

⚠️ 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.

Circuito parado — alerta em 2 níveis

Pra que serve: isto não é uma tela — é uma rotina automática (v3.0, 21/09/2026) que roda sozinha a cada 5 minutos e varre 7 situações diferentes de "aparelho ou lote parado tempo demais" no caminho pacote → assistência → reteste. Quando encontra uma, abre um alerta (um "incidente") e avisa quem devia ter agido — primeiro baixinho, depois alto, se ninguém se mexer.

Quem usa: ninguém "abre" esta rotina, ela roda sozinha. Quem recebe o alerta é sempre o dono da etapa parada (o técnico, o Operador PY, a testadora de plantão etc.) e, se ninguém resolver a tempo, ADMIN/GERENTE.

Ações principais: nenhuma — é 100% automático pra abrir. A ação de verdade é resolver o que travou (aceitar a remessa, confirmar o lote, recolher o aparelho…) na tela funcional certa — mas isso resolve o problema operacional, não fecha o alerta: hoje não existe nenhum botão de "marcar como resolvido" nem fechamento automático (ver "Detalhes e estados" abaixo).

Fluxo correto:

1. Uma das 7 situações passa do prazo dela (ver "Detalhes e estados" abaixo). A rotina abre 1 incidente.
2. Nível 1 — o sino: toca no sino (a mesma central de notificações que já avisa de custo extra em OS, desconto pendente etc. — o ícone de sino no topo da tela, também em Notificações) pro responsável da etapa, ou pro substituto dele se o sistema não achar um responsável direto. Repete a cada turno do dia (manhã/tarde/noite) enquanto o incidente continuar aberto — mas nunca duas vezes no mesmo turno.
3. Nível 2 — o WhatsApp: se passarem mais 24h corridas sem ninguém resolver, a rotina manda WhatsApp pra todo ADMIN e GERENTE ativo da empresa — não só quem já tinha recebido o sino — e continua tentando a cada rodada até entregar pra todo mundo.
4. Enquanto estiver aberto, o mesmo incidente aparece na seção "Parados" de "O que está preso" (acima) e, pra quem tem a permissão, vira uma linha no Painel de erros (logo abaixo).
5. Resolver a ação real resolve o problema operacional — mas hoje não fecha o incidente: ele continua aparecendo em "O que está preso" e no Painel de erros, e o sino continua tocando a cada turno, até alguém ligar o fechamento no sistema (ver "Detalhes e estados" abaixo).

Se pular ou errar: ignorar o sino é o pior lugar pra ignorar um alerta deste sistema — 24h corridas depois ele vira WhatsApp pra toda a gestão da empresa, não só pra quem devia ter agido primeiro. Um incidente destes sempre tem um dono e um prazo — não é alarme genérico.

Detalhes e estados:

• As 7 situações, o prazo até o nível 1 e quem é avisado primeiro (o "substituto" é avisado junto, ou entra se o primeiro não for encontrado):
  • Remessa do pacote fechada e ninguém aceitou — 4h úteis (o único prazo desta lista que só conta horário comercial) — avisa o responsável pela assistência, substituto é o gerente.
  • Lote entregue e o técnico não confirmou — 30 min corridos — avisa o técnico, substituto é o gerente.
  • Aparelho parado com o técnico além do prazo de reparo — 7 dias corridos — avisa o técnico, substituto é o gerente.
  • Aparelho pronto e liberado, mas ninguém recolheu — 24h corridas — avisa o Operador PY responsável, substituto é outro Operador PY.
  • Reparo parcial sem ninguém designado pra continuar — 24h corridas — avisa o responsável pela assistência, substituto é o gerente.
  • Remessa chegou no reteste e ninguém conferiu — 24h corridas — avisa o reteste, substituto é a testadora de plantão.
  • Aparelho reprovado no reteste e ninguém recolheu — 24h corridas — avisa o Operador PY responsável, substituto é outro Operador PY.
• Todas usam prazo corrido (conta fim de semana e feriado) — só a primeira ("remessa fechada") usa prazo útil. O nível 2 (WhatsApp) é sempre 24h corridas depois do nível 1, mesmo nos casos de prazo útil.
• Existe uma 8ª situação parecida (aparelho não aceito numa passagem entre setores) que não é detectada por esta rotina — é outra rotina automática (a mesma que cuida do prazo da assistência) que cuida dela; o mecanismo de aviso é o mesmo.

⚠️ Atenção: a tela Configurações → Processo deixa editar 7 números relacionados a estes prazos (por exemplo, quantas horas até o nível 2). Hoje nenhum desses números é lido de verdade por esta rotina — os prazos de cada situação, e as 24h até o nível 2, estão fixos no sistema. Mudar o número nessa tela não muda o comportamento do alerta ainda — é uma peça que já existe na configuração, mas ainda sem o fio ligado até a rotina que dispara os avisos.

• Não depende de nenhuma configuração avançada ligada/desligada — já roda de verdade em produção, pra qualquer empresa, sem precisar ativar nada.

⚠️ Atenção: hoje não existe nenhum caminho — manual ou automático — que feche um incidente depois de aberto. A função que faria isso (encerrar_incidente_fn) já existe no banco, mas nenhuma tela do sistema chama ela ainda: é uma peça pronta, com o fio ainda não ligado, como o caso dos 7 números de prazo acima. Na prática, um incidente aberto fica aberto pra sempre — continua na seção "Parados" de "O que está preso", mantém a linha no Painel de erros, e o sino continua repetindo a cada turno, mesmo depois de alguém resolver o problema operacional real.

Painel de erros

Pra que serve: ranking de falhas de processo — bipar aparelho no lugar errado, lote não confirmado a tempo, pronto não recolhido, reparo parcial sem executor, entre outras — cruzadas por tipo de erro × setor, com uma taxa (quantas vezes aconteceu ÷ quantas vezes podia ter acontecido) e uma tendência semana a semana. Ajuda o gestor a achar qual etapa está falhando mais, diferente de "O que está preso" (que mostra o que está travado agora, não o padrão de erro ao longo do tempo).

Quem usa: ADMIN, GERENTE e SUPERVISOR_ASSISTENCIA — o mesmo trio de "O que está preso". O Supervisor da Assistência só vê o setor dele (Assistência); se ele tentar escolher outro setor no filtro, o sistema ignora e mostra só o dele mesmo assim. ADMIN/GERENTE veem todos os setores.

Ações principais:

• Clicar no número de ocorrências de uma linha do ranking abre a lista dos aparelhos por trás dela, com link direto pro IMEI de cada um.
• Validar causa: classificar manualmente por que aquilo aconteceu (Material, Anterior ao processo, Transporte, Teste, Execução ou Processo, além de "Indeterminada") — nunca automático, e depois de validada por alguém, a causa não muda mais.
• Filtrar por setor, pessoa, tipo de erro, hora do dia e dia da semana.

Fluxo correto:

1. Abrir a tela (ver "Detalhes e estados" — hoje só dá pra chegar por link direto).
2. Olhar o ranking: tipo de erro × setor, com a taxa e quantos ainda estão "a validar".
3. Clicar no número de uma linha pra ver os aparelhos envolvidos.
4. Escolher a causa real de cada evento e clicar "Validar causa".
5. Olhar a tendência semanal pra saber se está piorando ou melhorando.

Se pular ou errar: os eventos continuam se acumulando como "a validar" — sem alguém validar a causa, o painel mostra que algo aconteceu, mas não diz se foi peça ruim, processo mal desenhado ou execução errada.

Detalhes e estados:

• Esta tela não tem link em nenhum menu. Hoje só existem 2 jeitos de chegar nela: digitar o endereço direto, ou clicar no link que aparece em "O que está preso" quando existe pelo menos 1 incidente do circuito parado ainda aberto. Se não houver nenhum incidente aberto no momento, não existe caminho de menu até aqui — vale reportar pro time técnico se você precisar abrir com frequência e achar isso incômodo.
• Uma mesma falha do mesmo aparelho não conta duas vezes no ranking, mesmo que tenha sido registrada mais de uma vez.
• Quando ainda não existe, no sistema, um "evento de sucesso" equivalente pra comparar, a taxa usa só a contagem do erro — não é bug, é honestidade: ainda não dá pra calcular uma taxa de verdade pra esse tipo de falha.

Placar da Assistência

Pra que serve: placar público pensado pra ficar numa TV fixa na bancada — 6 indicadores da semana atual comparados com a semana anterior (saída final, aprovação na 1ª passagem — FPY, a taxa de reparo que passa no reteste já na primeira tentativa —, erros de processo, tempo de ciclo, retrabalho por família de aparelho, pendências envelhecidas por etapa), sempre com o número de baixo (quantos casos) do lado do número de cima (%) — nunca uma porcentagem sozinha. Tem também uma seção "por pessoa" (técnico, pacote, reteste), sempre com o nome de quem.

Este placar é diferente dos outros dois que já existem no sistema: o placar de FPY por técnico (ver OS, Garantia e RMA) e o Placar de Grade por gradeador (ver Expedição e Logística). Este aqui é o placar do circuito inteiro pacote → assistência → reteste, e não substitui os outros dois.

Quem usa: ADMIN, GERENTE, SUPERVISOR_ASSISTENCIA, TECNICO_PROPRIO, OPERADOR_PY e TESTADOR — lista deliberadamente mais ampla que a dos outros painéis de gestão deste capítulo, porque esta tela mostra o desempenho dos próprios operacionais pelo nome: eles precisam poder abrir e ver o próprio número.

Ações principais: nenhuma — é só leitura. A tela atualiza sozinha a cada hora (mesmo mecanismo já usado no Painel SP) — ninguém precisa recarregar a página na mão.

Fluxo correto:

1. Deixar aberta numa TV ou monitor fixo da bancada, num endereço fixo.
2. Olhar os 6 indicadores e comparar com a semana anterior.
3. Na seção "por pessoa", cada técnico/pacote/reteste confere o próprio número.

Se pular ou errar: nada quebra — é vitrine, não ferramenta de ação. O risco é o oposto: ninguém saber que a tela existe, e a TV da bancada ficar apagada ou apontada pro endereço errado.

Detalhes e estados:

• Quando não existe histórico da semana anterior pra comparar, o indicador mostra "sem histórico" em vez de inventar um 0%.
• "Aprovação na 1ª passagem" reaproveita o mesmo cálculo de FPY já usado nas outras telas do sistema — não é uma conta nova e diferente.
• Esta tela também não tem link em nenhum menu — é pensada pra ficar num endereço fixo na TV, então quem for configurar a bancada precisa receber esse endereço de alguém; não dá pra chegar nela clicando pelo sistema.

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).
8. Achar que o Placar de FPY, o Placar de Grade e o Placar da Assistência são a mesma coisa. São três telas diferentes medindo três coisas diferentes — confundir uma com a outra faz procurar um número no lugar errado.
9. Editar um prazo em Configurações → Processo achando que o alerta do circuito parado vai passar a usar aquele número. Hoje a rotina de alerta ainda não lê essa configuração — os prazos de cada situação continuam fixos no sistema até isso mudar.
10. Não achar o Painel de erros nem o Placar da Assistência no menu e concluir que não existem. Nenhum dos dois tem entrada de menu — o Placar é feito pra ficar numa URL fixa na TV da bancada, e o Painel de erros só aparece linkado quando há um incidente do circuito parado aberto em "O que está preso".