<?php
// Depto de Engenharia e Automacao - Master Automacao - Autor: Derlivon Silva
// Manual interativo do BI — adapta por segmento, ensina o cliente a usar
$empresa  = $config['empresa']  ?? 'sua empresa';
$segmento = $config['segmento'] ?? '';
$ehBar    = in_array($segmento, ['bar','restaurante','lanchonete','sushi','pizzaria','churrascaria'], true);
$ehVarejo = in_array($segmento, ['utilidades','supermercado','conveniencia','loja_geral','distribuidora','atacado','material_construcao'], true);
$temVendedor = $ehVarejo || in_array($segmento, ['pet_shop','oficina','automacao_comercial'], true);
?>
<style>
.man { max-width:1180px; margin:0 auto; padding:0 1rem; color:#1f2937; font-family:'Inter','Helvetica Neue',Arial,sans-serif; }
.man .hero { background:linear-gradient(135deg,#0f766e 0%, #14b8a6 100%); color:#fff; padding:2.5rem 2rem; border-radius:10px; text-align:center; margin-bottom:1.5rem; }
.man .hero h1 { font-size:2rem; font-weight:900; margin:0 0 .4rem 0; letter-spacing:-.01em; }
.man .hero .sub { font-size:1rem; opacity:.95; max-width:760px; margin:.3rem auto 0 auto; line-height:1.5; }
.man .hero .pill { display:inline-block; margin-top:1.2rem; background:rgba(255,255,255,.2); padding:.4rem 1rem; border-radius:999px; font-size:.8rem; font-weight:600; letter-spacing:.05em; text-transform:uppercase; }

.man .indice { background:#f8fafc; border:1px solid #e2e8f0; border-radius:8px; padding:1.2rem 1.4rem; margin-bottom:1.5rem; }
.man .indice h2 { margin:0 0 .8rem 0; font-size:1rem; color:#475569; text-transform:uppercase; letter-spacing:.05em; font-weight:800; }
.man .indice ul { columns:3; gap:1.5rem; list-style:none; padding:0; margin:0; }
@media (max-width:900px) { .man .indice ul { columns:2; } }
@media (max-width:560px) { .man .indice ul { columns:1; } }
.man .indice li { padding:.3rem 0; font-size:.88rem; break-inside:avoid; }
.man .indice li a { color:#0f766e; text-decoration:none; font-weight:600; }
.man .indice li a:hover { text-decoration:underline; }

.man .secao { margin-bottom:1.6rem; border:1px solid #e2e8f0; border-radius:10px; padding:1.4rem 1.6rem; background:#fff; scroll-margin-top:80px; }
.man .secao .cab { display:flex; align-items:center; gap:.9rem; margin-bottom:.8rem; }
.man .secao .ico { width:48px; height:48px; border-radius:10px; display:inline-flex; align-items:center; justify-content:center; color:#fff; font-size:1.4rem; flex-shrink:0; }
.man .secao h3 { margin:0; font-size:1.25rem; color:#0f172a; font-weight:800; line-height:1.2; }
.man .secao .tagline { font-size:.8rem; color:#64748b; margin-top:.15rem; }
.man .secao .corpo { display:grid; grid-template-columns:repeat(auto-fit,minmax(220px,1fr)); gap:.9rem; margin-top:.5rem; }
.man .bloco { background:#f8fafc; border-left:3px solid #14b8a6; padding:.7rem .9rem; border-radius:6px; }
.man .bloco .ttl { font-size:.65rem; text-transform:uppercase; letter-spacing:.06em; color:#0f766e; font-weight:800; margin-bottom:.3rem; }
.man .bloco .txt { font-size:.85rem; color:#1e293b; line-height:1.5; }
.man .dica { background:#fffbeb; border-left:4px solid #f59e0b; padding:.7rem .9rem; border-radius:6px; margin-top:.8rem; font-size:.82rem; color:#78350f; line-height:1.5; }
.man .dica strong { color:#b45309; }
.man .btn-tela { display:inline-block; margin-top:1rem; background:#14b8a6; color:#fff; padding:.55rem 1.1rem; border-radius:6px; font-weight:700; font-size:.88rem; text-decoration:none; }
.man .btn-tela:hover { background:#0f766e; color:#fff; }
.man .telas-multi { display:flex; gap:.5rem; flex-wrap:wrap; margin-top:1rem; }
.man .telas-multi a { background:#f1f5f9; color:#0f766e; padding:.4rem .8rem; border-radius:6px; font-weight:600; font-size:.8rem; text-decoration:none; border:1px solid #cbd5e1; }
.man .telas-multi a:hover { background:#0f766e; color:#fff; border-color:#0f766e; }

.man .glossario { background:#0f172a; color:#fff; padding:1.5rem 1.8rem; border-radius:10px; margin-top:2rem; }
.man .glossario h3 { color:#fff; margin:0 0 1rem 0; font-size:1.1rem; }
.man .glossario .g-grid { display:grid; grid-template-columns:repeat(auto-fit,minmax(260px,1fr)); gap:1rem; }
.man .glossario .g-item .termo { color:#facc15; font-weight:700; font-size:.85rem; }
.man .glossario .g-item .defin { color:#cbd5e1; font-size:.78rem; line-height:1.45; margin-top:.2rem; }
</style>

<div class="man">

<!-- ════ Hero ════ -->
<div class="hero">
    <h1>📘 Manual do Premium Express Gestão</h1>
    <div class="sub">Aprenda a usar todos os recursos do seu BI em 10 minutos. Cada módulo tem o <strong>que faz</strong>, <strong>quando usar</strong> e um <strong>botão pra abrir a tela direto</strong>.</div>
    <div class="pill">Cliente: <?= htmlspecialchars($empresa) ?> <?php if ($segmento): ?>· <?= htmlspecialchars(ucfirst(str_replace('_',' ',$segmento))) ?><?php endif; ?></div>
</div>

<!-- ════ Novidades ════ -->
<div class="indice" style="background:linear-gradient(135deg,#dcfce7,#ecfdf5);border-left:4px solid #16a34a;margin-bottom:1rem">
    <h2 style="color:#15803d">🆕 Novidades recentes</h2>
    <ul style="list-style:none;padding-left:0">
        <?php if ($ehBar): ?>
        <li style="margin:6px 0">⏰ <strong>Comparativo por Hora</strong> — compara hoje vs mesma hora 7 dias atrás vs ano passado. Vê na hora se a sexta tá indo melhor que a sexta passada. <a href="/mesas/comparativo-hora">Abrir →</a> <span style="background:#3b82f6;color:#fff;font-size:.6rem;padding:1px 5px;border-radius:3px">NOVO</span></li>
        <li style="margin:6px 0">🌙 <strong>Faixas de Horário</strong> — Esquenta (18-21h) · Pico (21-00h) · Madrugada (00-03h) · Saideira (03-06h). Mostra quanto rende cada período da noite. <a href="/mesas/faixas-horario">Abrir →</a> <span style="background:#8b5cf6;color:#fff;font-size:.6rem;padding:1px 5px;border-radius:3px">NOVO</span></li>
        <li style="margin:6px 0">🎁 <strong>Análise de Cortesia</strong> — quem dá cortesia, quanto, pra quem. Alerta quando um garçom passa de 2× a média do bar. <a href="/mesas/cortesias">Abrir →</a></li>
        <li style="margin:6px 0">🛡️ <strong>Exceções no Caixa</strong> — anti-fraude: ranking de garçons com cancelamento / desconto / comanda longa. <a href="/mesas/excecoes-caixa">Abrir →</a></li>
        <li style="margin:6px 0">🧾 <strong>Comandas por Garçom</strong> — escolha um garçom, veja todas as mesas que ele fechou, com <strong>10% (taxa de serviço) por mesa e total no período</strong>; clique numa linha pra expandir os itens consumidos. <a href="/mesas/comandas-por-garcom">Abrir →</a></li>
        <?php endif; ?>
        <li style="margin:6px 0">💳 <strong>Formas de pagamento unificadas</strong> — variações de caps (ex.: "Pix" e "PIX") agora aparecem como uma linha só nos gráficos de mix. Sem mais duplicidade no donut.</li>
        <li style="margin:6px 0">📊 <strong>Margem por Item — Compra × Venda</strong> — tela nova que responde "esse preço de compra ainda deixa lucro? quem está vendendo no prejuízo?". 6 KPIs (markup médio, margem R$, prejuízo, R$ vazado, CMV %), top/bottom 20 e tabela filtrável por faixa. <a href="/compras/margem">Abrir →</a> <span style="background:#f59e0b;color:#fff;font-size:.6rem;padding:1px 5px;border-radius:3px">NOVO</span></li>
        <li style="margin:6px 0">🚨 <strong>Rastreador de Ruptura</strong> — tela nova que responde "o que comprar HOJE pra não perder venda?". 6 KPIs, top 20 por venda perdida, sugestão de quantidade. <a href="/compras/ruptura">Abrir →</a> <span style="background:#f59e0b;color:#fff;font-size:.6rem;padding:1px 5px;border-radius:3px">NOVO</span></li>
        <li style="margin:6px 0">📊 <strong>Painel de Compras turbinado</strong> — KPIs YoY (mês anterior, mesmo mês ano passado, ticket médio), card de Devoluções, card de Impostos+Frete, badge de ruptura no menu, Curva ABC e Concentração Top 1 de fornecedor, alerta de variação de preço com sugestão de ação. <a href="/compras/dashboard">Abrir →</a> <span style="background:#f59e0b;color:#fff;font-size:.6rem;padding:1px 5px;border-radius:3px">NOVO</span></li>
        <li style="margin:6px 0">🩺 <strong>Raio-X do Cadastro</strong> — diagnostico interno mostra qualidade do cadastro de produtos da loja ativa (preço, custo, marca, NCM, foto, código de barras), com nota A/B/C/D e tabela detalhada com <strong>seletor de limite (30 / 100 / 500 / 2000)</strong>, <strong>busca por descrição ou código</strong>, <strong>exportação CSV pra Excel</strong> (BOM UTF-8, separador ";", decimal com vírgula) e <strong>exportação PDF</strong> (botão vermelho — gera relatório executivo com capa, KPIs, alertas, listas, tabela e recomendação, com header/footer Fire Sistemas em todas as páginas). <a href="/diag/cadastro">Abrir →</a> <span style="background:#f59e0b;color:#fff;font-size:.6rem;padding:1px 5px;border-radius:3px">NOVO</span></li>
        <li style="margin:6px 0">📚 <strong>Manual interativo</strong> — esta página, com tutorial de cada módulo. <a href="/manual">Você está aqui</a></li>
        <li style="margin:6px 0">🔔 <strong>Alertas inteligentes</strong> — meta, projeção, queda de vendas, mesas esquecidas. <a href="/alertas">Abrir →</a></li>
    </ul>
</div>

<!-- ════ Índice ════ -->
<div class="indice">
    <h2>🗺️ Índice — clique pra pular pro módulo</h2>
    <ul>
        <li>📊 <a href="#dashboard">Dashboard</a></li>
        <li>📈 <a href="#vendas">Vendas</a></li>
        <li>📦 <a href="#produtos">Produtos</a></li>
        <li>👥 <a href="#clientes">Clientes</a></li>
        <?php if ($ehBar): ?><li>🍽️ <a href="#mesas">Mesas</a> <span style="background:#16a34a;color:#fff;font-size:.6rem;padding:1px 5px;border-radius:3px">NOVO</span></li><?php endif; ?>
        <?php if ($temVendedor): ?><li>👤 <a href="#vendedor">Vendedor</a></li><?php endif; ?>
        <li>💳 <a href="#convenios">Convênios</a></li>
        <li>🛒 <a href="#compras">Compras</a> <span style="background:#f59e0b;color:#fff;font-size:.6rem;padding:1px 5px;border-radius:3px">NOVO</span></li>
        <li>📦 <a href="#estoque">Estoque</a></li>
        <li>💰 <a href="#financeiro">Financeiro</a></li>
        <li>📅 <a href="#previsao">Previsão</a></li>
        <li>🔔 <a href="#alertas">Alertas</a></li>
        <li>📚 <a href="#glossario">Glossário</a></li>
    </ul>
</div>

<!-- ════ DASHBOARD ════ -->
<div class="secao" id="dashboard">
    <div class="cab">
        <div class="ico" style="background:#1e40af"><i class="bi bi-speedometer2"></i></div>
        <div>
            <h3>📊 Dashboard</h3>
            <div class="tagline">A tela inicial — resumo de tudo num clique só</div>
        </div>
    </div>
    <p>O Dashboard é onde você <strong>chega de manhã e olha pra saber o estado do dia</strong>. Mostra os números essenciais: faturamento, vendas, ticket médio, evolução, e os principais gráficos.</p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">🎯 Quando usar</div><div class="txt">Toda manhã, antes de abrir a loja. Ou várias vezes ao dia se quiser acompanhar.</div></div>
        <div class="bloco"><div class="ttl">📖 Como ler</div><div class="txt">Cards no topo = KPIs (números resumo). Gráficos abaixo = evolução. Cores: verde tá ok, amarelo atenção, vermelho urgente.</div></div>
        <div class="bloco"><div class="ttl">⚙️ Filtros</div><div class="txt">Hoje / Semana / Mês / Ano. Ou escolhe intervalo personalizado.</div></div>
    </div>
    <div class="dica">💡 <strong>Dica do Master:</strong> compare o Dashboard de hoje com o mesmo dia da semana anterior. Vendas caindo na sexta? Vai descobrir o porquê nos outros módulos.</div>
    <a href="/dashboard" class="btn-tela">📊 Abrir Dashboard agora →</a>
</div>

<!-- ════ VENDAS ════ -->
<div class="secao" id="vendas">
    <div class="cab">
        <div class="ico" style="background:#16a34a"><i class="bi bi-cart-fill"></i></div>
        <div>
            <h3>📈 Vendas</h3>
            <div class="tagline">Tudo sobre o que entrou de dinheiro — em vários níveis de detalhe</div>
        </div>
    </div>
    <p>Aqui você vê o faturamento de várias formas: <strong>diário, mensal, por vendedor, por série fiscal, por hora do dia</strong>. Cada tela responde a uma pergunta diferente.</p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">📋 Gestão de Vendas</div><div class="txt">Visão executiva: KPIs + gráficos + tipos de pagamento + série fiscal.</div></div>
        <div class="bloco"><div class="ttl">📅 Vendas Diárias</div><div class="txt">Linha de tempo. Vê pico do mês, dia mais fraco, recuperação.</div></div>
        <div class="bloco"><div class="ttl">📆 Vendas Mensais</div><div class="txt">Comparativo de anos. Cresceu? Caiu? Em qual mês?</div></div>
        <div class="bloco"><div class="ttl">📃 Notas de Saída</div><div class="txt">Lista detalhada das notas emitidas. Pra conferir lançamentos.</div></div>
        <div class="bloco"><div class="ttl">🕐 Pré-Notas</div><div class="txt">Vendas em aberto (não fechadas como NF).</div></div>
        <div class="bloco" style="border-left:3px solid #16a34a"><div class="ttl">💳 Formas de Pagamento — 2 totais <span style="background:#f59e0b;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:4px">NOVO</span></div><div class="txt">No card de Formas de Pagamento (Consolidado e por loja) agora aparecem <strong>2 totais</strong>: <strong style="color:#16a34a">Total Vendas</strong> (bate com o card de Faturamento ao lado, só operações de venda real) e <strong>Total Geral</strong> (espelha o relatório fiscal do ERP Fire Sistemas — inclui crediário, cortesia e devoluções com troca). A diferença entre eles é o "valor fantasma" que confundia quem comparava os dois cards.<br><br>📋 <strong>Drill-down da diferença:</strong> clique em <em>"Ver detalhamento da diferença"</em> pra ver linha-a-linha de qual operação gerou cada centavo a mais (1 linha por TIPO_OPERACAO × FORMA, ordenado por valor desc). Funciona tanto no card por loja quanto no consolidado.</div></div>
        <div class="bloco" style="border-left:3px solid #8b5cf6"><div class="ttl">📅 Comparativos com datas exatas <span style="background:#3b82f6;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:4px">NOVO</span></div><div class="txt">No <strong>Consolidado</strong> (Todas as Lojas), os cards de Comparativos (<em>vs Semana</em>, <em>vs Mês</em>, <em>Mesma data ano anterior</em>) agora mostram <strong>as datas exatas</strong> do período comparado — não só o rótulo genérico. Exemplo: <em>"semana anterior (11/06 a 17/06/2026): R$ 12.345"</em>. Assim o gestor consegue conferir contra o ERP sem precisar abrir calculadora. Vale tanto no card por loja quanto no card consolidado.<br><br>🧾 <strong>Agora também mostra a quantidade de vendas</strong> ao lado de cada valor (atual e período anterior), pra bater 1-pra-1 com o "Qtd.Vendas" do relatório fiscal do ERP Fire Sistemas. Aparece em cinza claro, separado por "·", sem poluir o card.</div></div>
        <div class="bloco" style="border-left:3px solid #f59e0b;background:#fffbeb"><div class="ttl">⚠️ Reclassificou tipo de operação no ERP? Vendas antigas podem "sumir" do BI</div><div class="txt">O BI lê o <strong>cadastro atual</strong> de TIPO_OPERACAO pra decidir o que conta como venda. Se você mudou a classificação de uma operação no Fire (por exemplo: o código <em>289 — VENDA PARA GRUPO ATA D/E</em> passou a ser <strong>MOV_INTERNA=S</strong> hoje), <strong>todas as notas antigas</strong> daquela operação deixam de aparecer no faturamento do BI — inclusive em comparativos do ano passado.<br><br>O relatório histórico do ERP Fire pode mostrar essas mesmas notas usando a classificação <strong>da época</strong>, e aí os dois divergem em alguns por cento na <em>Mesma data ano anterior</em>. <strong>Não é bug do BI</strong>, é o efeito esperado da reclassificação: o BI sempre te mostra o passado <em>como ele seria hoje</em> com as regras de hoje. Por isso, no card "Mesma data ano anterior" tem um ícone <i class="bi bi-info-circle"></i> explicando isso quando o gestor passar o mouse em cima.</div></div>
    </div>
    <div class="dica">💡 <strong>Dica:</strong> se Vendas Mensais mostrar mês corrente bem abaixo do mesmo mês do ano passado, é hora de ligar pro time comercial. O BI te avisa.</div>
    <div class="telas-multi">
        <a href="/vendas/gestao">Gestão</a>
        <a href="/vendas/diarias">Diárias</a>
        <a href="/vendas/mensais">Mensais</a>
        <a href="/vendas/notas-saida">Notas Saída</a>
        <a href="/vendas/pre-notas">Pré-Notas</a>
    </div>
</div>

<!-- ════ PRODUTOS ════ -->
<div class="secao" id="produtos">
    <div class="cab">
        <div class="ico" style="background:#9333ea"><i class="bi bi-box-seam"></i></div>
        <div>
            <h3>📦 Produtos</h3>
            <div class="tagline">O que vende, o que dá lucro, o que está parado</div>
        </div>
    </div>
    <p>Conhecer seu mix de produtos é a base do varejo. O BI te mostra <strong>quem é campeão, quem está parado, quem te dá prejuízo</strong>.</p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">📚 Catálogo</div><div class="txt">Lista filtrável de todos os produtos com preço, custo, estoque.</div></div>
        <div class="bloco"><div class="ttl">💰 Mais Vendidos (R$)</div><div class="txt">Top 50 por faturamento. Quem traz mais grana.</div></div>
        <div class="bloco"><div class="ttl">📚 Top por Quantidade</div><div class="txt">Top 50 por qtd vendida. Volume.</div></div>
        <div class="bloco"><div class="ttl">⚠️ Margem Negativa</div><div class="txt"><strong>O mais importante:</strong> produtos vendendo abaixo do custo. Você está PERDENDO dinheiro em cada venda.</div></div>
        <div class="bloco"><div class="ttl">📊 Curva ABC</div><div class="txt">Pareto 80/20: produtos A (top 80%), B (15%), C (5%).</div></div>
        <div class="bloco"><div class="ttl">😴 Sem Movimento</div><div class="txt">Produtos sem venda há +X dias. Promoção ou descontinuar.</div></div>
        <div class="bloco"><div class="ttl">🏷️ Histórico de Preços</div><div class="txt">Como o preço de venda evoluiu ao longo do tempo.</div></div>
        <div class="bloco"><div class="ttl">🩺 Saúde do Cadastro</div><div class="txt">Produtos sem custo, sem foto, sem NCM, sem barras. Corrija pra BI não dar errado.</div></div>
    </div>
    <div class="dica">💡 <strong>Dica:</strong> rode "Saúde do Cadastro" uma vez por semana. Cada produto sem custo cadastrado distorce TODOS os relatórios de lucro.</div>
    <div class="telas-multi">
        <a href="/produtos/catalogo">Catálogo</a>
        <a href="/produtos/mais-vendidos">Mais Vendidos</a>
        <a href="/produtos/top-quantidade">Top Qtd</a>
        <a href="/produtos/margem-negativa">⚠️ Margem Negativa</a>
        <a href="/produtos/curva-abc">Curva ABC</a>
        <a href="/produtos/sem-movimento">Sem Movimento</a>
        <a href="/produtos/saude">🩺 Saúde</a>
    </div>
</div>

<!-- ════ CLIENTES ════ -->
<div class="secao" id="clientes">
    <div class="cab">
        <div class="ico" style="background:#0ea5e9"><i class="bi bi-people-fill"></i></div>
        <div>
            <h3>👥 Clientes</h3>
            <div class="tagline">Quem compra com você, quanto, há quanto tempo</div>
        </div>
    </div>
    <p>Manter um cliente vale 5× mais que conquistar um novo. O BI te mostra <strong>quem merece atenção e quem está sumindo</strong>.</p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">🔁 Frequência</div><div class="txt">Quem mais visita / mais compra. Fidelidade.</div></div>
        <div class="bloco"><div class="ttl">💵 Ticket Médio</div><div class="txt">Quanto cada cliente gasta em média. Quem é "gastador".</div></div>
        <div class="bloco"><div class="ttl">⚠️ Inadimplentes</div><div class="txt">Quem deve e há quanto tempo. Pra cobrança ativa.</div></div>
        <div class="bloco"><div class="ttl">😴 Inativos</div><div class="txt">Quem comprava e parou. Lista pra recuperar.</div></div>
        <div class="bloco"><div class="ttl">📇 Cadastro</div><div class="txt">Busca rápida + dados completos.</div></div>
    </div>
    <div class="dica">💡 <strong>Dica:</strong> a cada 10 clientes inativos contatados (Whats / ligação), 1-2 voltam a comprar. Receita "perdida" recuperada.</div>
    <div class="telas-multi">
        <a href="/clientes/cadastro">Cadastro</a>
        <a href="/clientes/frequencia">Frequência</a>
        <a href="/clientes/ticket-medio">Ticket Médio</a>
        <a href="/clientes/inadimplentes">⚠️ Inadimplentes</a>
        <a href="/clientes/inativos">😴 Inativos</a>
    </div>
</div>

<?php if ($ehBar): ?>
<!-- ════ MESAS ════ -->
<div class="secao" id="mesas">
    <div class="cab">
        <div class="ico" style="background:#ea580c"><i class="bi bi-grid-3x3-gap-fill"></i></div>
        <div>
            <h3>🍽️ Mesas</h3>
            <div class="tagline">O coração da operação do bar/restaurante</div>
        </div>
    </div>
    <p>Acompanhamento em tempo real do que está rolando no salão. <strong>Cores indicam urgência:</strong> 🟢 recente · 🟡 atenção (+1h) · 🟠 demorada (+2h) · 🔴 crítica (+3h) · ⚫ esquecida (+24h, limpar no ERP Fire Sistemas).</p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">📺 Monitor em Tempo Real</div><div class="txt">A TELA pra pendurar na TV da gerência. Atualiza a cada 15s. Cronômetro vivo por mesa.</div></div>
        <div class="bloco"><div class="ttl">🕐 Histórico de Mesas</div><div class="txt">Todas as comandas fechadas. Filtro por data + busca.</div></div>
        <div class="bloco"><div class="ttl">👤 Por Garçom</div><div class="txt">Ranking dos garçons: comandas atendidas, ticket médio, gorjeta.</div></div>
        <div class="bloco"><div class="ttl">🧾 Comandas por Garçom</div><div class="txt">Escolha um garçom na lista e veja TODAS as mesas que ele fechou no período, com <strong>10% (taxa de serviço) por mesa e total</strong>. <strong>Clique numa linha</strong> e abre os itens consumidos da mesa (qtd, preço, desconto, subtotal). Útil quando o gerente pergunta "o que essa mesa do garçom X consumiu?".</div></div>
        <div class="bloco" style="border-left:3px solid #dc2626"><div class="ttl">🛡️ Exceções no Caixa</div><div class="txt">Anti-fraude. Ranking de garçons com <strong>score de 0 a 100</strong> combinando taxa de cancelamento, % de desconto e comandas longas (&gt;4h). <strong>Verde &lt;30 / amarelo 30-59 / vermelho ≥60.</strong> Clique num garçom e abre as mesas problemáticas dele, cada uma com flag (cancelada, desconto alto, comanda longa).</div></div>
        <div class="bloco" style="border-left:3px solid #ec4899"><div class="ttl">🎁 Análise de Cortesia</div><div class="txt">Lista TODAS as notas fechadas como cortesia ("casa pagou"). <strong>Ranking por garçom</strong>: quem mais marca, quanto valor, vs média do bar. <strong>Alerta vermelho</strong> quando passa de 2× a média do bar.</div></div>
        <div class="bloco" style="border-left:3px solid #3b82f6"><div class="ttl">⏰ Comparativo por Hora <span style="background:#3b82f6;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:4px">NOVO</span></div><div class="txt">Mostra 3 linhas sobrepostas: <strong>hoje</strong> (azul), <strong>7 dias atrás</strong> (cinza tracejada) e <strong>1 ano atrás</strong> (pontilhada). Vê na hora se essa sexta-feira tá batendo a sexta passada — hora a hora.</div></div>
        <div class="bloco" style="border-left:3px solid #8b5cf6"><div class="ttl">🌙 Faixas de Horário <span style="background:#8b5cf6;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:4px">NOVO</span></div><div class="txt">Quanto rende cada período do bar noturno: <strong>🍻 Esquenta</strong> (18h-21h) · <strong>🔥 Pico</strong> (21h-00h) · <strong>🌙 Madrugada</strong> (00h-03h) · <strong>🍺 Saideira</strong> (03h-06h). Útil pra escalar pessoal, ajustar promoção do Esquenta e decidir se vale ficar aberto até a Saideira.</div></div>
        <div class="bloco"><div class="ttl">⏱️ Tempo Médio</div><div class="txt">Quanto tempo a mesa fica aberta em média. Pra giro.</div></div>
    </div>
    <div class="dica">💡 <strong>Dica do bar:</strong> Mesa marcada como "esquecida" (+24h) = mesa que ficou aberta no sistema e nunca foi fechada. Vá no <strong>ERP Fire Sistemas</strong> e feche. O BI já te denuncia automaticamente.</div>
    <div class="dica" style="background:#fef2f2;border-left-color:#dc2626"><strong>🛡️ Como ler "Exceções no Caixa":</strong> o que importa é a <strong>diferença entre garçons</strong>. Se a média do bar é 5% de cancelamento e um garçom tá em 15%, ele é o suspeito — não o número absoluto. Os limites (% Canc, % Desc, Horas Longa) são ajustáveis no filtro.</div>
    <div class="telas-multi">
        <a href="/mesas/monitor">📺 Monitor</a>
        <a href="/mesas/historico">Histórico</a>
        <a href="/mesas/por-garcom">Por Garçom</a>
        <a href="/mesas/comandas-por-garcom">🧾 Comandas por Garçom</a>
        <a href="/mesas/excecoes-caixa">🛡️ Exceções no Caixa</a>
        <a href="/mesas/cortesias">🎁 Cortesias</a>
        <a href="/mesas/comparativo-hora">⏰ Comparativo por Hora</a>
        <a href="/mesas/faixas-horario">🌙 Faixas de Horário</a>
        <a href="/mesas/tempo-medio">Tempo Médio</a>
    </div>
</div>
<?php endif; ?>

<?php if ($temVendedor): ?>
<!-- ════ VENDEDOR ════ -->
<div class="secao" id="vendedor">
    <div class="cab">
        <div class="ico" style="background:#dc2626"><i class="bi bi-person-badge-fill"></i></div>
        <div>
            <h3>👤 Vendas por Vendedor</h3>
            <div class="tagline">Desempenho do time comercial</div>
        </div>
    </div>
    <p>Quem está vendendo bem, quem precisa de treinamento, quem está abaixo da meta. Pra <strong>premiar, treinar ou conversar</strong>.</p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">🏆 Ranking</div><div class="txt">Top vendedores: faturamento, qtd, ticket médio, clientes únicos.</div></div>
        <div class="bloco"><div class="ttl">📊 Desempenho</div><div class="txt">Como cada um evolui mês a mês. Tendência.</div></div>
        <div class="bloco"><div class="ttl">💵 Comissões</div><div class="txt">Cálculo automático baseado em %.</div></div>
        <div class="bloco"><div class="ttl">🎯 Metas</div><div class="txt">Vendedor × meta. Falta quanto pra bater.</div></div>
    </div>
    <div class="dica">💡 <strong>Dica:</strong> compartilhe o ranking publicamente com a equipe. Competição saudável = +18% no mês seguinte (média de mercado).</div>
    <div class="telas-multi">
        <a href="/vendas/por-vendedor">Ranking</a>
        <a href="/pessoal/performance">Desempenho</a>
        <a href="/pessoal/comissoes">Comissões</a>
        <a href="/metas">Metas</a>
    </div>
</div>
<?php endif; ?>

<!-- ════ CONVÊNIOS ════ -->
<div class="secao" id="convenios">
    <div class="cab">
        <div class="ico" style="background:#7c3aed"><i class="bi bi-credit-card-2-front-fill"></i></div>
        <div>
            <h3>💳 Convênios</h3>
            <div class="tagline">Grancard, VR, Alelo, Sodexo, Ticket — o que ainda não entrou no caixa</div>
        </div>
    </div>
    <p>Sua loja vende, mas o convênio paga depois. <strong>Quanto está esperando? Quanto atrasou? Quem mais usa?</strong> O BI te mostra por convênio.</p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">📋 Painel</div><div class="txt">KPIs: Vendido / Recebido / Em Aberto / Vencido. Tabela por convênio com % recebido.</div></div>
        <div class="bloco"><div class="ttl">⏳ Aging (atrasos)</div><div class="txt">Faixas: A vencer · 0-15 dias · 16-30 · 31-60 · +60 dias. Vermelho = perigo.</div></div>
        <div class="bloco"><div class="ttl">👥 Top Conveniados</div><div class="txt">Quem mais consumiu via convênio. Pessoas / empresas.</div></div>
    </div>
    <div class="dica">💡 <strong>Dica:</strong> se Vencido > 0, você tem dinheiro parado. Cobre o convênio (atendimento) ou avise o cliente da operadora pra forçar o repasse.</div>
    <div class="telas-multi">
        <a href="/convenios/painel">Painel</a>
        <a href="/convenios/aging">⏳ Aging</a>
        <a href="/convenios/top-conveniados">Top Conveniados</a>
    </div>
</div>

<!-- ════ COMPRAS ════ -->
<div class="secao" id="compras">
    <div class="cab">
        <div class="ico" style="background:#f59e0b"><i class="bi bi-truck"></i></div>
        <div>
            <h3>🛒 Compras <span style="background:#f59e0b;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:6px;vertical-align:middle">ATUALIZADO</span></h3>
            <div class="tagline">O que está saindo do caixa pra estocar e revender</div>
        </div>
    </div>
    <p>O outro lado da moeda. <strong>De quem você mais compra? Está pagando caro? Estoque vai durar? O que precisa comprar HOJE pra não perder venda?</strong></p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">📋 Dashboard</div><div class="txt">Total comprado, qtd notas, fornecedores ativos.</div></div>
        <div class="bloco" style="border-left:3px solid #f59e0b"><div class="ttl">📈 KPIs YoY no Painel <span style="background:#f59e0b;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:4px">NOVO</span></div><div class="txt">Logo abaixo dos cards principais, 3 cartões comparativos: <strong>vs mês anterior</strong> (compras R$ + delta %), <strong>vs mesmo mês ano anterior</strong> e <strong>ticket médio vs ano anterior</strong>. <strong>Vermelho</strong> = gastou mais (alerta), <strong>verde</strong> = gastou menos.</div></div>
        <div class="bloco" style="border-left:3px solid #dc2626"><div class="ttl">↩️ Card Devoluções <span style="background:#f59e0b;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:4px">NOVO</span></div><div class="txt">Novo KPI no painel mostrando o <strong>total de devoluções de compra</strong> no período: R$ devolvido + qtd de notas + % sobre o total de compras. Pico aqui = problema com fornecedor (qualidade/quebra/erro de pedido).</div></div>
        <div class="bloco" style="border-left:3px solid #7c3aed"><div class="ttl">🧾 Card Impostos + Frete <span style="background:#f59e0b;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:4px">NOVO</span></div><div class="txt">Novo KPI somando <strong>ICMS + IPI + ST + Frete</strong> (entrada e saída) com % do valor bruto. Mostra o "custo invisível" que come margem — útil pra renegociar CIF/FOB e revisar substituição tributária com o contador.</div></div>
        <div class="bloco"><div class="ttl">📃 Notas de Entrada</div><div class="txt">Lista detalhada de compras.</div></div>
        <div class="bloco" style="border-left:3px solid #f59e0b"><div class="ttl">🏢 Por Fornecedor + Curva ABC <span style="background:#f59e0b;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:4px">NOVO</span></div><div class="txt">Ranking de fornecedores agora tem coluna <strong>Curva (A/B/C)</strong> pela regra <strong>80/15/5</strong> do gasto acumulado. Card novo <strong>"Concentração Top 1"</strong> mostra o % do principal fornecedor — alto = risco de dependência. Replicado no painel e na tela /compras/por-fornecedor.</div></div>
        <div class="bloco" style="border-left:3px solid #ef4444"><div class="ttl">📊 Alerta de Variação de Preço <span style="background:#f59e0b;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:4px">NOVO</span></div><div class="txt">Tabela "Variação de Preço" no painel agora pinta a linha + sugere ação: <strong>Alta &gt;10%</strong> 🔴 "Renegociar fornecedor / cotar concorrente" · <strong>Alta 5-10%</strong> 🟠 "Monitorar próximas compras" · <strong>Queda -5 a -10%</strong> 🟢 "Manter fornecedor" · <strong>Queda &lt;-10%</strong> 🔵 "Confirmar preço (queda incomum)".</div></div>
        <div class="bloco"><div class="ttl">📊 Compras × Vendas</div><div class="txt">Comparativo. Comprou demais? Falta?</div></div>
        <div class="bloco" style="border-left:3px solid #16a34a"><div class="ttl">🟢 Margem por Item <span style="background:#f59e0b;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:4px">NOVO</span></div><div class="txt">Cruza <strong>Preço de Venda × Custo de Compra</strong> em cada SKU do estoque + vendas reais do período. Mostra <strong>quem dá lucro</strong>, <strong>quem está apertado (markup &lt; 20%)</strong> e <strong>quem está vendendo no prejuízo</strong> (PV &lt; custo) — com R$ vazado/mês. Filtros por faixa, busca, top 20 e bottom 20 em barras horizontais. <strong>Use antes de receber representante</strong>: prejuízo vira renegociação imediata, margem baixa vira reajuste planejado.</div></div>
        <div class="bloco" style="border-left:3px solid #991b1b"><div class="ttl">⭐ Top 100 Críticos <span style="background:#f59e0b;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:4px">NOVO</span></div><div class="txt">Ranking dos <strong>SKUs que mais vendem nos últimos 90 dias E estão com cadastro furado</strong> (sem custo / sem preço / em prejuízo / custo suspeito / sem marca). Mostra EAN, descrição, marca, qtd e R$ vendido, % de participação no top 100, último fornecedor e os problemas. Botão <strong>"Exportar pra Fornecedor"</strong> gera CSV pronto pra anexar no email do representante. <strong>É o foco da limpeza de cadastro</strong>: cada item dessa lista é margem perdida ou prejuízo virando rotina. <a href="/cadastro/top-criticos">Abrir agora →</a></div></div>
    </div>

    <div class="dica">💡 <strong>Dica:</strong> identifique o fornecedor que leva 50%+ do volume. Marca uma reunião e pede 5% de desconto. Funciona.</div>
    <div class="dica" style="background:#fef2f2;border-left-color:#dc2626">🚨 <strong>Dica do Master (NOVO):</strong> o item "Sugestão de Compra" do menu agora mostra um <strong>selo vermelho com a quantidade de itens em risco de ruptura</strong> (atualizado a cada 5 min). Selo aceso = abra agora e veja o que precisa entrar no próximo pedido — antes que falte e o cliente compre do concorrente.</div>
    <div class="dica" style="background:#fef2f2;border-left-color:#dc2626">🛑 <strong>Como ler o Alerta de Variação de Preço:</strong> a cor diz o que <em>fazer</em>, não só o que <em>aconteceu</em>. Antes de renegociar, confirme se a alta não é IPI / ST nova / câmbio — pra não queimar o relacionamento por engano. Quedas anormais (&lt;-10%) podem ser <strong>erro de digitação no XML</strong> — sempre confirme.</div>

    <div class="telas-multi">
        <a href="/compras/dashboard">📋 Dashboard</a>
        <a href="/compras/ruptura">🚨 Rastreador de Ruptura</a>
        <a href="/cadastro/top-criticos">⭐ Top 100 Críticos</a>
        <a href="/compras/margem">📊 Margem por Item</a>
        <a href="/compras/notas-entrada">📃 Notas Entrada</a>
        <a href="/compras/por-fornecedor">🏢 Por Fornecedor</a>
        <a href="/compras/compras-vendas">📊 Compras × Vendas</a>
    </div>
</div>

<!-- ════ RUPTURA (subseção dentro de Compras) ════ -->
<div class="secao" id="ruptura" style="border-left:4px solid #dc2626">
    <div class="cab">
        <div class="ico" style="background:#dc2626"><i class="bi bi-exclamation-octagon-fill"></i></div>
        <div>
            <h3>🚨 Rastreador de Ruptura <span style="background:#f59e0b;color:#fff;font-size:.65rem;padding:2px 6px;border-radius:4px;margin-left:6px;vertical-align:middle">NOVO</span></h3>
            <div class="tagline">"O que eu preciso comprar HOJE pra não perder venda?"</div>
        </div>
    </div>
    <p>Tela nova dentro do menu <strong>Compras → Rastreador de Ruptura</strong>. Responde direto a pergunta que mais dói no varejo: <strong>"de que eu estou sem, ou prestes a ficar, e que ainda está vendendo?"</strong>. Critério de "crítico": estoque ≤ 0 com venda recente <em>ou</em> estoque abaixo do mínimo com venda recente.</p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">📊 6 Cards no topo</div><div class="txt"><strong>Itens em ruptura</strong> · <strong>Venda perdida R$/dia</strong> · <strong>Cobertura média</strong> · <strong>SKUs Classe A em risco</strong> · <strong>Lead time médio</strong> · <strong>% ruptura sobre ativos</strong>. Resumo executivo da dor.</div></div>
        <div class="bloco"><div class="ttl">📈 Top 20 por Venda Perdida</div><div class="txt">Gráfico de barras horizontais — quais SKUs estão "queimando dinheiro" enquanto faltam na prateleira. Atacar de cima pra baixo.</div></div>
        <div class="bloco"><div class="ttl">🏷️ Top 20 por Marca</div><div class="txt">Mesma análise agrupada por marca. Útil pra fechar pedido por fornecedor / representante.</div></div>
        <div class="bloco" style="border-left:3px solid #dc2626"><div class="ttl">🏷️ Badges + Sugestão de Compra</div><div class="txt">Tabela com cada item classificado: <strong>CRÍTICO</strong> (vermelho) · <strong>ALTO</strong> · <strong>MÉDIO</strong> · <strong>BAIXO</strong> + coluna <strong>"quantidade sugerida a comprar"</strong> calculada por venda média e lead time. Lê de cima pra baixo e já vira pedido.</div></div>
    </div>
    <div class="dica">💡 <strong>Dica do Master:</strong> abra essa tela <strong>toda segunda de manhã, antes de receber representante</strong>. Os "CRÍTICO" são pedido urgente. Os "ALTO" entram no próximo pedido normal. Os "MÉDIO/BAIXO" entram na cotação da semana. Isso transforma compra reativa ("acabou, manda mais") em compra planejada.</div>
    <div class="dica" style="background:#fef2f2;border-left-color:#dc2626">🛡️ <strong>Confiabilidade do dado:</strong> a ruptura é tão boa quanto seu <strong>estoque atual</strong> e <strong>mínimo cadastrado</strong>. Se a tela acusar falsos críticos, é sinal de inventário desatualizado ou estoque negativo no ERP Fire Sistemas — vale rodar "Saúde do Cadastro" antes.</div>
    <a href="/compras/ruptura" class="btn-tela">🚨 Abrir Rastreador de Ruptura →</a>
</div>

<!-- ════ ESTOQUE ════ -->
<div class="secao" id="estoque">
    <div class="cab">
        <div class="ico" style="background:#0d9488"><i class="bi bi-boxes"></i></div>
        <div>
            <h3>📦 Estoque</h3>
            <div class="tagline">O que está parado consumindo capital</div>
        </div>
    </div>
    <p>Cada produto parado é <strong>dinheiro investido sem retorno</strong>. O BI revela quanto tempo o estoque dura e o que está há muito tempo lá.</p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">⏱️ Giro de Estoque</div><div class="txt">Dias de cobertura: estoque atual vai durar X dias. Identifica excesso/falta.</div></div>
        <div class="bloco"><div class="ttl">💡 Sugestão de Compra</div><div class="txt">BI sugere o que repor com base em tendência de venda.</div></div>
    </div>
    <div class="dica">💡 <strong>Dica:</strong> produtos com cobertura > 90 dias devem ser promovidos. Produtos com cobertura < 7 dias precisam ser comprados antes que falte.</div>
    <div class="telas-multi">
        <a href="/estoque">Estoque</a>
        <a href="/sugestao-compra">💡 Sugestão</a>
    </div>
</div>

<!-- ════ FINANCEIRO ════ -->
<div class="secao" id="financeiro">
    <div class="cab">
        <div class="ico" style="background:#16a34a"><i class="bi bi-bank2"></i></div>
        <div>
            <h3>💰 Financeiro</h3>
            <div class="tagline">A receber, a pagar, fluxo de caixa, DRE</div>
        </div>
    </div>
    <p>O dinheiro que vai entrar e sair. A <strong>visão de tesouraria</strong> da empresa.</p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">💸 A Receber</div><div class="txt">Quem te deve, vencidos × a vencer.</div></div>
        <div class="bloco"><div class="ttl">💳 A Pagar</div><div class="txt">Compromissos futuros.</div></div>
        <div class="bloco"><div class="ttl">📈 Fluxo de Caixa</div><div class="txt">Entradas × saídas no tempo.</div></div>
        <div class="bloco"><div class="ttl">📋 DRE</div><div class="txt">Demonstrativo de Resultados (lucro real do mês).</div></div>
    </div>
    <div class="dica">💡 <strong>Dica:</strong> imprima a DRE mensal e leve pro contador. Vai surpreender (e ele vai economizar imposto com isso).</div>
    <div class="telas-multi">
        <a href="/financeiro">Financeiro</a>
    </div>
</div>

<!-- ════ PREVISÃO ════ -->
<div class="secao" id="previsao">
    <div class="cab">
        <div class="ico" style="background:#06b6d4"><i class="bi bi-graph-up-arrow"></i></div>
        <div>
            <h3>📅 Previsão de Vendas</h3>
            <div class="tagline">Olhar pro futuro com base nos últimos 24 meses</div>
        </div>
    </div>
    <p>O BI usa <strong>regressão linear + sazonalidade</strong> pra projetar o quanto você vai faturar nos próximos 12 meses. Útil pra planejar estoque, pessoal, fluxo.</p>
    <div class="corpo">
        <div class="bloco"><div class="ttl">📊 O que mostra</div><div class="txt">Mês a mês: valor previsto, faixa mínima e máxima.</div></div>
        <div class="bloco"><div class="ttl">🎯 Pra que serve</div><div class="txt">Antecipar compras, contratar mais gente em meses bons, segurar em meses fracos.</div></div>
    </div>
    <div class="dica">💡 <strong>Dica:</strong> compare a previsão com a meta. Se previsão < meta, a equipe precisa esforço extra. Se previsão > meta, hora de subir a meta no próximo trimestre.</div>
    <a href="/previsao" class="btn-tela">📅 Ver Previsão →</a>
</div>

<!-- ════ ALERTAS ════ -->
<div class="secao" id="alertas">
    <div class="cab">
        <div class="ico" style="background:#dc2626"><i class="bi bi-bell-fill"></i></div>
        <div>
            <h3>🔔 Alertas</h3>
            <div class="tagline">O BI te avisa quando algo precisa de atenção</div>
        </div>
    </div>
    <p>Em vez de você ficar olhando todo dia, o BI te avisa <strong>quando algo muda</strong>: meta atingida, queda anormal, vencimentos próximos, produtos sem custo cadastrado, etc.</p>
    <div class="dica">💡 <strong>Dica:</strong> o número no badge vermelho ao lado de "Alertas" mostra quantos alertas você ainda não viu. Não deixa acumular.</div>
    <a href="/alertas" class="btn-tela">🔔 Ver Alertas →</a>
</div>

<!-- ════ GLOSSÁRIO ════ -->
<div class="glossario" id="glossario">
    <h3>📚 Glossário — termos que você verá pelo BI</h3>
    <div class="g-grid">
        <div class="g-item"><div class="termo">Ticket Médio</div><div class="defin">Valor médio por venda. Faturamento ÷ qtd vendas. "R$ 50 por compra".</div></div>
        <div class="g-item"><div class="termo">Faturamento</div><div class="defin">Total vendido em R$ no período. Soma do valor das notas.</div></div>
        <div class="g-item"><div class="termo">Margem</div><div class="defin">Lucro por venda. Preço de venda − custo. Pode ser % ou R$.</div></div>
        <div class="g-item"><div class="termo">Margem Negativa</div><div class="defin">Preço de venda < custo. Você perde dinheiro em cada unidade.</div></div>
        <div class="g-item"><div class="termo">Curva ABC</div><div class="defin">Pareto 80/20. A = top que faz 80% do faturamento. B = 15%. C = 5%.</div></div>
        <div class="g-item"><div class="termo">Aging</div><div class="defin">"Envelhecimento" dos títulos a receber. Faixas: 0-15, 16-30, 31-60, +60 dias.</div></div>
        <div class="g-item"><div class="termo">Sem Movimento</div><div class="defin">Produto que não vende há X dias. Candidato a promoção / descontinuar.</div></div>
        <div class="g-item"><div class="termo">Convênio</div><div class="defin">Empresa intermediária (Grancard, VR, Alelo) que paga depois da venda. Risco de atraso.</div></div>
        <div class="g-item"><div class="termo">Mesa Esquecida</div><div class="defin">Bar: comanda aberta há +24h. Funcionário esqueceu de fechar no ERP Fire Sistemas.</div></div>
        <div class="g-item"><div class="termo">DRE</div><div class="defin">Demonstrativo de Resultados do Exercício. Lucro real do mês após impostos e custos.</div></div>
        <div class="g-item"><div class="termo">Fluxo de Caixa</div><div class="defin">Entradas × saídas de dinheiro ao longo do tempo. Saúde financeira.</div></div>
        <div class="g-item"><div class="termo">KPI</div><div class="defin">Sigla em inglês de "Indicador-Chave de Desempenho". Os "números-chave" pra decisão.</div></div>
        <div class="g-item"><div class="termo">Vendas do dia (Gestão de Vendas)</div><div class="defin">Soma de TOTAL_NOTA das notas com data 00:00 a 23:59 do dia. Critério: <strong>dia</strong>.</div></div>
        <div class="g-item"><div class="termo">Vendas do turno (Caixa)</div><div class="defin">Soma de TOTAL_NOTA das notas dentro do turno de UM caixa (ex.: 16:24 → 02:15). Critério: <strong>turno</strong> — pode virar a madrugada.</div></div>
        <div class="g-item"><div class="termo">Recebido em formas</div><div class="defin">Soma do que entrou em cada forma de pagamento (dinheiro, cartão, Pix). Não inclui taxa de serviço (10%) — ela vai pro garçom separado.</div></div>
        <div class="g-item"><div class="termo">Total Vendas vs Total Geral (Formas de Pagamento)</div><div class="defin"><strong style="color:#facc15">Total Vendas</strong> = soma só das operações de venda real (mesmo filtro do card de Faturamento) — é o número que bate com Faturamento. <strong style="color:#facc15">Total Geral</strong> = soma de tudo que aparece nas formas, espelhando o relatório fiscal do ERP Fire Sistemas (inclui crediário, cortesia e devoluções com troca). A diferença entre os dois é o "valor fantasma" — não some, é negócio real, só não bate com Faturamento porque não é venda no sentido contábil.</div></div>
        <div class="g-item"><div class="termo">Taxa de serviço (10%)</div><div class="defin">Acréscimo cobrado do cliente em bar/restaurante. Entra no TOTAL_NOTA mas não vira forma de pagamento — é repassada ao garçom.</div></div>
        <div class="g-item"><div class="termo">Cortesia</div><div class="defin">Forma de pagamento "casa pagou". Não entra dinheiro no caixa, mas conta como venda. Investigar quem dá muita cortesia.</div></div>
        <div class="g-item"><div class="termo">Ruptura</div><div class="defin">Produto que está em falta (estoque ≤ 0) ou abaixo do mínimo <strong>e ainda tem venda recente</strong>. Cada dia de ruptura = venda perdida pro concorrente.</div></div>
        <div class="g-item"><div class="termo">Lead time</div><div class="defin">Tempo médio entre fazer o pedido ao fornecedor e a mercadoria chegar. Usado pra calcular quanto comprar antes de faltar.</div></div>
        <div class="g-item"><div class="termo">Cobertura de estoque</div><div class="defin">Quantos dias o estoque atual vai durar mantida a venda média. Ex.: cobertura = 12 dias significa que sem repor, acaba em 12 dias.</div></div>
        <div class="g-item"><div class="termo">Concentração Top 1</div><div class="defin">% do gasto total que vai pro principal fornecedor. Acima de 50% = risco de dependência (se ele atrasar ou fechar, você quebra).</div></div>
        <div class="g-item"><div class="termo">YoY (Year over Year)</div><div class="defin">Comparativo entre o período atual e o mesmo período do ano anterior. Tira o efeito da sazonalidade — junho vs junho, não vs maio.</div></div>
        <div class="g-item"><div class="termo">Markup</div><div class="defin">Quanto você acrescenta ao custo pra chegar no preço de venda — em %. <strong>Markup = (Preço − Custo) ÷ Custo × 100</strong>. Ex.: comprou a R$10 e vende a R$15 → markup 50%. Diferente de margem, que é sobre o preço (margem 33% no mesmo exemplo). <strong>Markup &lt; 20%</strong> = pouco fôlego pra suportar imposto, frete e taxa de cartão.</div></div>
        <div class="g-item"><div class="termo">CMV (Custo da Mercadoria Vendida)</div><div class="defin">Soma do <strong>custo</strong> de tudo que saiu do estoque na venda — não o que está parado, só o que vendeu. <strong>CMV % = CMV ÷ Faturamento × 100</strong>. Em bar/restaurante, CMV alto (acima de 35-40%) indica preço de cardápio errado ou cadastro de custo ruim. CMV ≥ Faturamento por vários meses = custo cadastrado errado.</div></div>
    </div>
    <div style="margin-top:1rem;padding:.8rem;background:#1e293b;border-radius:8px;color:#cbd5e1;font-size:.78rem">
        <strong style="color:#facc15">⚠️ Por que valores podem diferir entre telas?</strong><br>
        • <strong>Gestão de Vendas</strong> filtra por DIA (00h-23h59) e operações de venda. Mostra o faturamento bruto.<br>
        • <strong>Caixa (drill-down)</strong> filtra por TURNO específico (ex.: 16h-2h do dia seguinte). Pega notas de 2 dias diferentes.<br>
        • <strong>Mix de Pagamento</strong> mostra TODAS as formas (cortesia, fiado, delivery), sem filtro de operação.<br>
        • Mesmo número de notas em telas diferentes pode ser <em>coincidência</em> — os conjuntos podem ser diferentes.
    </div>
</div>

<div style="text-align:center; margin-top:2rem; padding:1.5rem; color:#64748b; font-size:.85rem;">
    📞 Dúvidas sobre o BI? Fale com a <strong>Fire Sistemas</strong> ou com a <strong>Master Automação</strong>.<br>
    <span style="opacity:.7">Premium Express Gestão v<?= htmlspecialchars((string)\App\Core\Versao::ATUAL) ?> · Manual atualizado em <?= date('d/m/Y') ?></span>
</div>

</div><!-- /.man -->
