opyra← voltar ao site

Manual do Opyra

O Opyra é a plataforma de inteligência de Departamento Pessoal da Nokware® — Soluções Definitivas. Ele recebe os dados do seu ERP uma vez por competência e, a partir deles, confere, vigia, explica e presta contas — o mês inteiro.

Encontrou um erro ou algo estranho? Escreva para [email protected] contando o que você fazia e em qual tela. A equipe recebe, investiga e responde.

Três princípios valem em todas as telas:

• Regra calcula, IA narra — todo número nasce de cálculo determinístico e auditável; a inteligência artificial só redige explicações em português.
• Humano aprova — nada sai da plataforma para o mundo (books, respostas, consultas ao ERP) sem um gate humano.
• Honestidade — quando o Opyra não tem o dado, ele mostra "—" e diz por quê. Nunca um zero falso, nunca um 100 falso.

---

Como entrar no Opyra

• Passo 1 — Abra opyra.com.br/app no navegador.
• Passo 2 — Na tela de login, informe e-mail e senha. No 1º acesso, o Opyra força a troca de senha e mostra uma splash rápida (a "Forja") explicando o produto.
• Passo 3 — Depois do login, você cai no Cockpit (a home). O menu fica à esquerda; os botões do topo (📊 Relatório, 🔎 Conferência, 📖 Books) mudam conforme a tela.
• Passo 4 — Para sair, clique no e-mail (canto inferior esquerdo, junto ao "Nokware®") e em Sair. Sessão dura 8 horas desde o último clique.

Se o menu mostrar itens em cinza sem clique, seu perfil não tem acesso a eles (ver a tabela Perfis, adiante).

---

Como o menu está organizado

O menu agrupa as telas por assunto — de que se trata —, não por quando olhar. São sete grupos, nesta ordem:

No rodapé do menu, fora dos grupos: Ajuda & sobre e ← Site do Opyra.

Grupo cujas telas estejam todas fora do seu perfil some inteiro — você não vê um rótulo "Folha" sem nada embaixo. Por isso o seu menu pode ter menos de sete grupos, e isso é o esperado, não falta de acesso mal configurada.

Cada seção abaixo é passo-a-passo, na ordem do menu. Se você é gestor/operador de cliente, algumas telas não aparecem — pule-as sem culpa.

---

Cockpit — sua home

A home de todo mundo. 6 espaços, preenchidos com os indicadores que VOCÊ escolheu — escassez é estratégia.

Adicionar um indicador ao Cockpit

• Passo 1 — Vá em Conversas (menu, à esquerda).
• Passo 2 — Pergunte em português (ex.: "quanto foi o custo de horas extras por filial em junho?"). O ANVOR responde na tela.
• Passo 3 — Na resposta, clique em ⭐ Salvar como indicador. Dê um nome curto.
• Passo 4 — Volte ao Cockpit — o novo indicador está lá, com o número e a leitura.

Reexecutar um indicador

• Passo 1 — No Cockpit, encontre o card do indicador.
• Passo 2 — Clique no ícone ↻ no canto do card. O Opyra roda a consulta de novo (o "trace" novo aparece).

Remover ou trocar um indicador

• Passo 1 — Passe o mouse sobre o card e clique em ⋮ (três pontinhos).
• Passo 2 — Escolha Remover do Cockpit — ele sai da sua grade e volta a ser um "fantasma" sugerido no fim da lista.
• Passo 3 — Com os 6 espaços ocupados, adicionar mais um exige tirar outro do lugar (troca ritual). O Opyra pergunta qual sai.

Arrastar e focar

• Passo 4 — Arraste um card para outro espaço. A posição é sua e fica gravada: o buraco que você deixar continua ali, não é fechado automaticamente.
• Passo 5 — Clique no gráfico de um card para abrir o foco em tela cheia — o indicador em tamanho de apresentação, com ← → para andar pelos seus cards, na sua ordem, e Imprimir para projetar ou levar impresso.

Se você tinha mais de 6 antes: o teto baixou de 9 para 6 em agosto/2026 e ninguém perdeu card por causa disso. Os espaços acima do 6 continuam existindo e preenchíveis enquanto estiverem ocupados; cada um some sozinho quando esvaziar.

---

Visão geral — o pulso da competência

O apanhado macro do mês: o Health Score em destaque, o placar do que está crítico e os cards agrupados por assunto — cada um abrindo por uma pergunta e fechando com uma ação.

• Passo 1 — Menu → Visão geral.
• Passo 2 — No herói, o Payroll Health Score (0–100), o rótulo que ele merece (Saudável · Atenção · Crítico) e a variação vs. a competência anterior. Ao lado, o placar do cliente: quantos cards estão críticos, em atenção e saudáveis.
• Passo 3 — Abaixo, os tiles-resumo — Compliance eSocial, Fechamento, Rotinas, Book de Entrega e Metas e planos de ação. Cada um leva à tela correspondente pela seta.
• Passo 4 — Role até os cards, agrupados por assunto (Pessoas, Custos, Movimentação…). Cada card abre por uma pergunta de gestão — "a rotatividade está saudável?" —, traz os números, o selo de severidade e uma leitura em português.
• Passo 5 — Todo card fecha com AÇÃO →: o que fazer com aquilo. Card que só informa e não sugere nada é card pela metade.
• Passo 6 — Clique em qualquer card para abrir o detalhe: tabela completa, filtros por filial/CC e o histórico. O botão ✨ Analisar com IA escreve a leitura longa daquele card (com máscara de dados pessoais).

Cuidado: o Health Score usa a lista COMPLETA de cards, não a que seu perfil vê — o número não muda por causa de restrição de visibilidade. Isso é proposital (a diferenciação é só visibilidade, nunca o número).

⚠ Há um segundo tipo de restrição, e nele o número MUDA de propósito. O escopo de dados (docs/139) limita a conta a uma filial e a certos centros de custo — e aí os indicadores passam a ser calculados só com essas pessoas, porque o contrário seria mostrar a empresa inteira a quem foi restrito. Conta com escopo exibe o selo do recorte no alto da tela, e as visões que não se dividem por filial (metas, Books, Briefing, e a nota de saúde) ficam disponíveis apenas para contas sem restrição.

---

Conferidor da Folha — a auditoria contínua

Índice de Saúde da Folha decomposto em 7 dimensões, 147 verificações determinísticas. A visibilidade para o cliente é um clique da equipe em Administração → Acessos.

Rodar/ler a conferência

• Passo 1 — Menu → Conferidor da Folha (ou botão do topo 🔎 Conferência).
• Passo 2 — Escolha a extração/competência no seletor do topo.
• Passo 3 — Leia o Índice de Saúde decomposto (cadastro, folha, férias, rescisões, tributos, encargos, eSocial). Cada dimensão tem seu peso e status.
• Passo 4 — Role até a lista de achados. Cada achado tem: severidade, regra, quem ela impacta, valor em R$ (quando aplicável), memória de cálculo.

Agir sobre um achado

• Passo 5 — Clique num achado para abrir o detalhe.
• Passo 6 — Três botões de desfecho:
• ✔ Corrigido no ERP — você já corrigiu; o Opyra reabre se detectar o problema de novo (delta > 25%).
• Não é problema — falso positivo; fecha.
• Suprimir com justificativa — mais forte; exige texto e vale por um período. Volta a aparecer se o valor mudar demais.
• Passo 7 — O veredito no topo é APTO / NÃO APTO a fechar. Só é APTO quando não há achado ALTO em aberto.

Relatório Gerencial (imprimível)

• Passo 8 — Na tela, clique em 📋 Relatório Gerencial — abre o dossiê imprimível da auditoria, indicador a indicador, com cobertura honesta (quais regras não puderam ser avaliadas e por quê).
• Passo 9 — Ctrl+P para imprimir/PDF. O relatório respeita o tema claro na impressão.

Catálogo e parâmetros

• Passo 10 — 📚 Catálogo de indicadores abre a ficha de cada uma das 147 verificações: o quê, por quê e como ela decide. A conferência não é caixa preta — o cliente pode contestar regra por regra.
• Passo 11 — Aba ⚙️ Parâmetros. Nem toda verificação roda em todo cliente: algumas precisam de um valor que só a operação sabe (piso da categoria, percentual de CCT, dia de fechamento). Preencha aqui.
• Passo 12 — O que não tiver parâmetro se declara "não avaliada" e aparece na cobertura do relatório. Ela nunca chuta, e nunca some calada.

Fail-closed: se a tabela fiscal da competência não estiver aprovada, as regras tributárias se declaram "não avaliadas" — nunca usam tabela velha para calcular.

Ausência de achado não é saúde. Se a cobertura estiver baixa, o índice diz isso antes de dizer que está tudo bem — 147 regras com metade não avaliada não é uma folha limpa, é uma folha pouco conferida.

---

Analisador de Encargos — o cadastro que origina o cálculo

Só equipe Nokware. Menu: Administração → Analisador de Encargos. A terceira perna do compliance (cadastro × norma).

A ideia em uma frase

O Analisador confronta a parametrização do ERP (o que está cadastrado) contra as tabelas oficiais (o que a norma manda) e aponta cada divergência com fundamento legal e valor em R$. Ele não recalcula a folha (isso é o Conferidor) e não decide recolher ou compensar — aponta com base, e a decisão é do profissional habilitado.

Regra de ouro: nada produz número sem aprovação humana

Toda tabela oficial entra no sistema como proposta e não vale para o cálculo enquanto alguém da equipe não conferir contra a fonte e clicar Aprovar. Enquanto a tabela estiver em proposta, o motor mostra o critério e o artigo, mas esconde o número.

Passo 1 — Conferir e aprovar as tabelas (o gate)

• 1.1 — Menu → Administração → Analisador de Encargos, aba Tabelas oficiais (o acervo normativo).
• 1.2 — No topo, leia o placar: quantas tabelas já valem, quantas aguardam sua aprovação (em âmbar), quantas versões estão arquivadas.
• 1.3 — Cada norma é um bloco. Nas tabelas em proposta, clique Inspecionar — abre o conteúdo (ex.: os 1.331 CNAEs do Anexo V, com o grau de risco de cada um). Use a busca para checar um CNAE ou código específico.
• 1.4 — Confira contra a fonte oficial. O link (Planalto, eSocial) está na linha, junto ao sha do conteúdo e à data da coleta.
• 1.5 — Se estiver certa, clique Aprovar. O Opyra grava seu nome e a data como responsável. A partir daí a tabela vale para o cálculo.
• 1.6 — Se veio torta, clique Descartar — só serve para proposta. Tabela aprovada nunca some; nova versão vira "proposta" e a antiga vira "arquivada".

As tabelas hoje disponíveis: CNAE → grau de risco (RAT), FPAS → código e alíquota de

terceiros, Classificação tributária, FPAS × classificação tributária, Desoneração/CPRB

(cronograma) e Selic mensal (correção de crédito/passivo).

Passo 2 — Manter atualizado (a recarga)

• 2.1 — Quando o eSocial publicar nova NT ou o Planalto uma nova portaria, clique ↻ Conferir com a fonte oficial no cabeçalho da tabela.
• 2.2 — O Opyra baixa a norma, confere os invariantes e:
• se nada mudou, avisa "a norma está igual" e só registra a conferência (não cria versão à toa).
• se mudou, grava uma proposta nova e mostra o diff (o que entrou, o que saiu e — o mais importante — o que foi alterado). Uma mudança de grau de risco muda dinheiro.
• 2.3 — Revise o diff e clique Aprovar (ou Descartar).

Passo 3 — Informar o FAP (aba "FAP por CNPJ")

• 3.1 — Abra o FAPWeb (fap.dataprev.gov.br, com procuração).
• 3.2 — Anote o FAP do CNPJ para o ano vigente.
• 3.3 — Aba FAP por CNPJ no Acervo. Clique ➕ Novo FAP.
• 3.4 — Informe CNPJ, ano e valor. Deve estar entre 0,5000 e 2,0000 (o Opyra recusa fora da faixa — art. 202-A do Regulamento).
• 3.5 — Salve. A regra do FAP passa a confrontar este valor contra o que está no ERP.

Passo 4 — Rodar uma análise

• 4.1 — Aba Rodar auditoria. Escolha cliente e competência.
• 4.2 — Clique Analisar. O Opyra puxa a parametrização do ERP (via conector), aplica as regras e devolve os achados.
• 4.3 — Se faltar acervo aprovado, o Opyra não chuta: declara "regra não avaliada" e diz o quê está faltando.

Passo 5 — Ler o laudo

• 5.1 — Botão 📄 Laudo na tela do resultado. Abre um documento imprimível no mesmo padrão do Laudo de Compliance do Ponto (dois temas, versão para tela e para impressão).
• 5.2 — Leia a Capa: perfil fiscal (FPAS, RAT, FAP, terceiros, regime), nota A–E, cobertura, e os dois blocos de dinheiro (a recuperar × a regularizar).
• 5.3 — Página de Exposição: waterfall, rosca de severidade e a projeção acumulada (o mesmo erro repetido mês a mês desde o cadastro até o limite da decadência de 5 anos, cada mês com sua Selic).
• 5.4 — Página das divergências principais — o que está errado, o valor cadastrado × oficial, o artigo, o impacto por competência e o sentido (a maior = crédito recuperável / a menor = passivo). Cada divergência diz qual filial.
• 5.5 — Coerência da parametrização — mostra a cadeia CNAE → RAT → ×FAP → RAT ajustado e FPAS → terceiros → classificação tributária, sinalizando onde a corrente se rompe.
• 5.6 — Uniformidade entre filiais — matriz mostrando a mesma atividade parametrizada de formas diferentes; destaca o fora-da-curva.
• 5.7 — Plano de correção — passos priorizados por impacto + oportunidades de ganho (ex.: convênio de terceiros não aproveitado, FAP a revisar), agregadas por tipo (várias filiais no mesmo achado, não um cartão repetido).
• 5.8 — Dossiê final — dois totais separados: a recuperar (crédito, via PER/DCOMP) × a regularizar (passivo). São caminhos jurídicos diferentes — nunca some um do outro como se fosse líquido.
• 5.9 — Ctrl+P para PDF.

O que o Analisador verifica hoje

RAT × CNAE preponderante (Anexo V) · FAP declarado × oficial · RAT ajustado = RAT × FAP (aritmética) · alíquota de terceiros × código (resolvida por FPAS) · Simples sem terceiros · classificação tributária × FPAS (compatibilidade do eSocial) · enquadramento que mudou entre competências sem justificativa · terceiros suspensos sem processo cadastrado · coerência da desoneração (CPRB) com o cronograma da lei.

Limites honestos (o que ainda depende de mais dado)

Algumas verificações precisam da folha ou de um arquivo do governo que o cadastro não traz, e por isso ficam declaradas como "não avaliadas" em vez de chutar:

• a alíquota praticada de terceiros e o teto de 20 salários (Temas STJ) vêm da folha;
• a aposentadoria especial cruza a exposição a agente nocivo com a folha;
• o confronto ERP × governo (S-5011) depende do XML de retorno baixado do portal.

Quando a regra não tem o insumo, ela diz exatamente o que falta — nunca acusa no escuro.

---

Compliance eSocial — o cenário do TAF virado gestão

Índice de Conformidade decomposto fator a fator, scorecard por evento (S-2200/2299/2230/1200), erros do governo com ação corretiva.

Ler o painel

• Passo 1 — Menu → Compliance eSocial.
• Passo 2 — No topo, leia o Índice de Conformidade (0–100, com faixa verde/amarelo/laranja/vermelho) e a decomposição fator a fator.
• Passo 3 — Abaixo, o scorecard por evento. Cada linha diz total, sucesso, erro e o bucket "outros" (status 6 = erros que não somam nem em sucesso nem em erro comum).
• Passo 4 — Role até Trabalhadores-fantasma e Erros do governo — cada erro traz a ação corretiva ao lado.

Atualizar o painel direto do ERP

• Passo 5 — Clique ⟳ Coletar do ERP (só aparece se seu cliente tem conector apto e dialeto do banco cadastrado). O Opyra roda 7 queries agregadas contra o ERP.
• Passo 6 — O painel se atualiza. Se alguma seção falhar, aparece um aviso honesto ("scorecard truncado", "seção X indisponível") — nunca esconde a falha.

---

Compliance Ponto — a fiscalização do ponto antes do fiscal

Só equipe Nokware. 41 verificações determinísticas sobre os arquivos oficiais do ponto eletrônico (AFD, AFDT, ACJEF, AEJ, eSocial).

Iniciar uma auditoria

• Passo 1 — Menu → Compliance Ponto.
• Passo 2 — Clique ➕ Nova auditoria. Escolha o cliente e a competência.
• Passo 3 — Suba os arquivos:
• Pode arrastar múltiplos de uma vez (também aceita .zip).
• O Opyra detecta o tipo de cada arquivo pelo cabeçalho — não precisa nomear certo.
• Até 25 MB por arquivo. Vários AFDs do mesmo REP são aceitos com conferência de continuidade de NSR.
• Passo 4 — Clique Iniciar processamento. Uma barra de progresso mostra o passo atual (parsing → carga em massa → regras → score → laudo).
• Passo 5 — Se o processamento travar (5 min sem heartbeat), o Opyra marca como erro reprocessável no próximo boot — nada fica órfão.

Ler o resultado na tela

• Passo 6 — Aberta a auditoria, você vê:
• Nota geral em faixa A–E (letra grande).
• Cobertura por bloco — quantas regras de cada bloco puderam ser avaliadas.
• Achados agrupados por regra e por severidade.
• Passo 7 — Clique num achado para ver a evidência: cada linha diz arquivo e número da linha de origem — nada de "recálculo · linha —" genérico. Se o achado é uma ausência (D1, D3, D5, A8), a evidência declara "não consta nos arquivos entregues".
• Passo 8 — Descartar um achado exige justificativa e fica na trilha (não some sem rastro).

Gerar o Laudo de Compliance do Ponto

• Passo 9 — No topo da auditoria, clique 📄 Gerar laudo.
• Passo 10 — Escolha o modo:
• completo — as duas partes (Síntese + Anexo).
• executivo — só a Síntese (12 páginas).
• analitico — só o Anexo (100% dos achados).
• Passo 11 — Escolha o tema: claro (para imprimir) ou escuro (para tela). Impressão força o claro automaticamente.
• Passo 12 — Ctrl+P para PDF.

(nomes de cliente mascarados como Cliente A/B/C… nesta captura — na tela real da equipe aparecem os nomes verdadeiros.)

Não confie na nota isolada: leia junto a cobertura — bloco com nota alta e cobertura baixa é sinalizado (100 de 1 regra vale menos que 78 de 9).

Parâmetros por cliente

• Passo 13 — No menu de administração, aba Parâmetros do Ponto. Você edita CCT, feriados (com base legal), tolerâncias — sem tocar em JSON. Cada mudança pede autor+data.

---

Prognos — o amanhã do quadro, medido

Duas perguntas de gestão que o histórico responde: quantas pessoas devem sair e quanto vai custar a hora extra. Nasce restrito — a equipe libera por cliente.

Ler a previsão de saídas (aba Pessoas)

• Passo 1 — Menu → Prognos. A aba Pessoas abre primeiro.
• Passo 2 — Leia o período da projeção. São competências de folha à frente — mês fechado, não blocos de 30 dias.
• Passo 3 — O resultado vem em intervalo, nunca em número seco: "entre 9 e 11 pessoas devem deixar a empresa", com o equivalente em % do quadro.
• Passo 4 — Ao lado, o placar de acerto: em quantos dos trimestres passados o resultado real caiu dentro da faixa que teríamos publicado, e o erro típico em pessoas. Previsão sem placar é opinião — é ele que diz o quanto confiar nesta.
• Passo 5 — Role até os fatores: custo rescisório, natureza histórica das saídas (voluntária × involuntária) e sazonalidade da janela. Cada um mostra o valor que o disparou.

Simular um cenário

• Passo 6 — Mova os controles otimista / esperado / pessimista e o "quantas saídas você consegue evitar". O custo do cenário e a diferença para o cenário central recalculam na hora.
• Passo 7 — O que sai daí é aritmética sobre uma premissa sua — a tela diz isso — e não fica gravado. É rascunho de reunião, não previsão da casa.

Ler a previsão de hora extra (aba Hora extra)

• Passo 8 — Aba Hora extra. Mesma disciplina: intervalo, placar e fatores.
• Passo 9 — A pergunta que ela responde não é "quanto vem", é quando aperta — o mês em que o custo estoura, com tempo de agir.

Auditar o número

• Passo 10 — O método — qual regra produziu isso, e em que versão. É o que permite reler uma previsão antiga e saber por que regra ela nasceu.
• Passo 11 — Memorial de cálculo — cada número com a conta que o gerou.
• Passo 12 — Ver o dossiê — o material completo, imprimível.

Quando o Prognos não prevê: sem histórico suficiente ele não inventa faixa. Mostra o que falta, antes de qualquer gráfico. Tela vazia seria pior que resposta nenhuma.

---

Orkestra — a folha do mês que vem, antes de acontecer

Uma tela por loja e por semana (desde 05/09/2026, docs/168): o que a escala custa antes de acontecer, a escala por horário, a curva gente × venda do dia, os gestos que valem mais e o botão de publicar. Nasce restrito — a equipe libera por cliente. O manual completo, com o roteiro de apresentação ao cliente, é o docs/169.

Abrir e ler

• Passo 1 — Menu → Orkestra. A tela abre na primeira loja confirmada, na próxima semana. Troque a loja no seletor e a semana nas setas; o estado aparece ao lado: «SEM ESCALA», «RASCUNHO» ou «PUBLICADA».
• Passo 2 — Leia os três números: esta semana custa (estimativa: horas da escala × valor-hora da última folha × encargo da loja), hora extra que a loja paga (fato do trimestre, por semana) e o pico (o dia e a hora em que mais falta gente pelo que a venda pede). Todo cartão tem «como calculamos»; quando falta um insumo, o cartão diz o que falta, nunca zero.
• Passo 3 — A escala vem agrupada pelo horário cadastrado de cada pessoa, com a barra na linha do tempo e quantas pessoas em cada dia. Clique no horário para ver as pessoas.
• Passo 4 — A curva do dia: barras são a gente na loja pela escala, a linha tracejada é o que a venda pede. Âmbar sobra, rosa falta. As duas chamadas acima resumem («Das 07h às 11h · 34 a 56 pessoas a mais»).

Mexer

• Arrastar a barra de um horário move todas as pessoas dele no dia escolhido; a de uma pessoa move só ela. A faixa de confirmação diz quantas pessoas e o novo horário; «mover» grava e confere a escala de novo.
• Adotar um gesto registra a decisão desta semana (quem e quando); os gestos saem sempre em par, com o selo «simulado, não medido», e nunca entram no Book.
• Antes de publicar, a tela conta quem fica com pausa menor que 1 h ou descanso menor que 11 h, com «ver quem» e «corrigir».
• Publicar sela a versão. Para mudar, «mais» → «Versões desta semana».

O menu «mais»

Seis telas curtas, na mesma língua da tela da loja: Lojas lado a lado · Se a regra da jornada mudar (5 ou 6 dias, teto de horas) · Onde economizar, por lente · Planejado × realizado (aparece depois da primeira semana publicada) · Mandar o resumo ao gerente (WhatsApp, um sócio aprova antes de sair) · O que falta ligar (de qual loja é cada arquivo, e o envio da venda por horário). Quando falta o dado, o cartão diz o que falta; nenhuma abre vazia.

⚠ Três verbos e nenhum a mais. O produto diz o que custou, o que está em jogo e o que foi capturado; o simulado existe só na tela, em par e com selo. Ele não diz «você vai economizar» — nem na tela, nem no Book. ⚠ De onde vem o dado. O Orkestra lê a auditoria de ponto (AFD/AEJ enviados em Compliance Ponto), a folha da competência, a análise de encargos e a venda por hora que o cliente envia. Sem encargo não sai R$; sem venda não sai «o que a venda pede».

Jornada do Colaborador — a vida funcional inteira

Admissão, carreira, salário, férias, afastamentos e saída de UMA pessoa, numa linha do tempo — com a origem de cada fato.

Abrir a ficha de alguém

• Passo 1 — Menu → Jornada do Colaborador.
• Passo 2 — Se você é da equipe Nokware, escolha o cliente no seletor. Quem é do cliente já entra no próprio tenant.
• Passo 3 — Digite parte do nome ou a matrícula e escolha a pessoa na lista.

Ler a linha da vida

• Passo 4 — No alto, a ficha: cargo, filial, matrícula, data de admissão e tempo de casa. Se a pessoa tem mais de um registro no ERP, o Opyra avisa ("2 identidades no ERP") e junta os dois — sem isso, uma transferência entre filiais apareceria como demissão.
• Passo 5 — A faixa de vida desenha a carreira inteira: a linha é o salário, cada marca é um evento. Clique numa marca para saltar até ela.
• Passo 6 — Os contadores resumem a trajetória: promoções, evolução salarial no período, transferências, períodos de férias, afastamentos e total de eventos.
• Passo 7 — Abaixo, as frases de leitura — o que a trajetória diz, em português.

Filtrar e imprimir

• Passo 8 — As abas Resumo · Carreira · Vida funcional · Financeiro · Completo mudam o recorte. Os chips coloridos ligam e desligam tipos de evento (admissão, transferência, carreira, salário, férias, afastamento, família, saída).
• Passo 9 — Compacto adensa a linha; Imprimir gera a ficha em papel ou PDF.

Cada evento diz de onde veio. A tabela e o campo do ERP aparecem no rodapé do evento (ex.: SRA · RA_ADMISSA) — é o que permite conferir a ficha contra o sistema de origem, em vez de acreditar nela.

---

Conversas — pergunte em português

A tela principal do ANVOR. Você pergunta, ele decide se reusa uma consulta homologada, adapta ou gera uma nova. Só gestor/admin.

Fazer uma pergunta

• Passo 1 — Menu → Conversas.
• Passo 2 — Se você é da equipe Nokware, escolha o cliente no seletor do rodapé (só clientes com conector apto aparecem). Cliente-usuário não vê seletor — já está no seu próprio tenant.
• Passo 3 — Digite a pergunta no campo de baixo (ex.: "quantos afastamentos por CID no 1º trimestre?"). Clique Enviar (ou tecla Enter).
• Passo 4 — Acompanhe as 4 estações do trace (busca → composição → aprovação → execução). Cada uma acende quando é vez dela.

Entrevista (quando o Opyra pede mais)

• Passo 5 — Se a pergunta for ambígua, o Opyra faz UMA pergunta focada com opções clicáveis. Clique numa opção.
• Passo 6 — A consulta reinicia com essa escolha.

Aprovação (Tier 2) — só admin/gestor

• Passo 7 — Se a consulta é nova (não estava homologada), aparece uma bolha de aprovação com o SQL. Clique Aprovar (a consulta roda) ou Rejeitar (para).
• Passo 8 — Aprovada, o Opyra executa no ERP (Tier 3) e mostra o resultado — tabela e gráfico se der.

Se a execução falhar

• Passo 9 — Aparece uma bolha vermelha com o motivo. Dois botões:
• 🔁 Reexecutar — tenta de novo.
• ✍️ Refazer — devolve a pergunta original para o campo, para você ajustar.

Transformar em algo permanente

• Passo 10 — Na resposta, dois botões:
• ⭐ Salvar como indicador — vira card no Cockpit.
• 📅 Agendar esta consulta — vira Rotina (ver adiante).

Se a tela travar (mais de 45s sem mexer): aparece "reconectando". Se aparecer "sessão encerrada", faça login de novo.

---

Biblioteca — toda resposta que o Opyra já sabe dar

O catálogo inteiro de indicadores, navegável por PERGUNTA — inclusive os que ainda não estão ligados para você, com o que falta para destravar cada um.

Procurar por pergunta

• Passo 1 — Menu → Biblioteca.
• Passo 2 — Digite a pergunta do seu jeito na caixa (atalho: tecla /) — "rotatividade", "férias vencidas", "quanto custa a folha". A Biblioteca fala a sua língua, não a do sistema.
• Passo 3 — Ou use os filtros: por estado (Prontas · A destravar · Em preparação · Do seu acervo) ou por assunto (Fechamento do mês · Pessoas e retenção · Compliance e risco).

Ler um card

• Passo 4 — O placar do topo diz, para este cliente: quantas respostas estão prontas, quantas estão a destravar e com quantas informações, e quantas estão em preparação pela Nokware.
• Passo 5 — Cada card traz a pergunta, as formas de ver aquela resposta e as informações de que ela depende — dizendo o que cada informação a mais acrescenta.
• Passo 6 — Card ainda não disponível aparece com figura de exemplo, sempre marcada como tal. Nunca é dado de cliente apresentado como real.
• Passo 7 — Quero este indicador avisa a equipe Nokware do seu interesse.

Modo apresentação projeta a Biblioteca em tela cheia — feito para mostrar a alguém, numa reunião, o que a plataforma cobre.

---

Consulta GED — chat sobre os documentos do cliente

Só equipe Nokware. Chat isolado que responde apenas com base nos documentos ingeridos (contratos, convenções, procedimentos) — cada resposta cita a fonte.

Perguntar

• Passo 1 — Menu → 📁 Consulta GED.
• Passo 2 — Escolha o cliente no seletor do topo (só aparecem clientes que têm documentos ingeridos no GED).
• Passo 3 — Marque os filtros se quiser (tipo de documento, filial, ☑ "apenas vigentes"). Sem filtro, o chat busca em todos.
• Passo 4 — Pergunte no campo (ex.: "qual a jornada da CCT vigente?"). O Opyra busca trechos, cita a fonte no formato [1] [2] [3] e escreve a resposta.
• Passo 5 — Se o Opyra não achar, ele diz literalmente: "Não localizei essa informação na documentação ingerida deste cliente." Isso é honesto — não é falha.

Ver o trecho citado

• Passo 6 — Ao lado da resposta, na coluna FONTES DESTA RESPOSTA, clique em abrir trecho de qualquer [n] — o chunk exato usado aparece.

Enviar novos documentos

• Passo 7 — No topo da tela, aba ⇪ Enviar documentos.
• Passo 8 — Escolha o cliente (aqui aparece até quem não tem doc ainda — o 1º envio cria a base dele).
• Passo 9 — Arraste o arquivo (PDF, DOCX, XLSX; até 25 MB por arquivo). O Opyra manda para o Oryzo, que ingere e vira chunks.
• Passo 10 — Acompanhe o card do envio: fila → processando → pronto (ou erro, ou duplicado — o Opyra reconhece pelo sha256 e não ingere dois iguais).

---

Book de Entrega — a entrega formal do mês

A prestação de contas mensal do BPO, organizada em cadernos por assunto — cada cadeira da mesa lê o seu. 17 posições de capítulo, narrativa gerada por IA e aprovação humana antes do envio.

Cada cadeira, um caderno. Numa mesa com RH, DP, controller e TI, cada um desligava nos 75% que não eram dele. O Book passou a ter a mesma taxonomia do menu:

Caderno cujos capítulos ficarem todos vazios não aparece — o Book não abre uma divisória para não dizer nada atrás dela.

Gerar o Book

• Passo 1 — Botão do topo 📖 Books.
• Passo 2 — Clique ✨ Gerar Book. Escolha o cliente e a competência.
• Passo 3 — O Opyra monta os capítulos (números vêm dos cards; a IA só narra). Isso demora 1–3 minutos. Fica salvo como rascunho.

Revisar e editar

• Passo 4 — Abra o Book (📖 Books → Rascunhos). Cada capítulo mostra o texto e os gráficos ao lado.
• Passo 5 — Clique em qualquer trecho de narrativa para editar. O que você não pode editar são os números — eles vêm do cálculo, sempre.
• Passo 6 — Se quiser refazer a narrativa de um capítulo, clique ↻ Regerar narrativa.

Aprovar e enviar

• Passo 7 — No topo do Book, clique ✔ Aprovar. Sua digital fica registrada.
• Passo 8 — Clique 📤 Enviar. O Opyra pega os destinatários do cadastro-mestre Oryzo (contatos com autorização LGPD para receber Book) e envia por MS Graph.
• Passo 9 — Cada destinatário recebe o Book em HTML + a régua NPS de 0–10 no rodapé (voto em 1 clique).
• Passo 10 — O acompanhamento das recomendações do Book anterior aparece no Book seguinte, no caderno Serviço — o produto cobra o que ficou pendente.

Fantasma comum: se aparecer "sem destinatários" no envio, o cliente não tem contato recebe_book no cadastro-mestre do Oryzo. Cadastre lá antes.

---

Rotinas — agendar consultas

Consulta homologada + calendário. O Opyra roda no horário certo, manda o resultado no canal certo.

Criar uma rotina

• Passo 1 — Menu → Rotinas. Você vê o calendário mensal (domingo primeiro).
• Passo 2 — Clique ➕ Nova rotina (ou clique num dia).
• Passo 3 — Escolha a consulta. O Opyra só oferece consultas validadas do catálogo — nunca aceita SQL solto.
• Passo 4 — Defina a recorrência: única, semanal ou mensal.
• Passo 5 — Escolha o canal: e-mail e/ou WhatsApp. Adicione os destinatários (só aparecem usuários do mesmo tenant).
• Passo 6 — Salve. Aparece no calendário no dia certo.

Ajustar uma ocorrência específica

• Passo 7 — Arraste a ocorrência no calendário para movê-la (só aquela — a série não muda).
• Passo 8 — Duplo clique para editar a ocorrência.
• Passo 9 — A rotina-mãe segue igual; a exceção fica registrada.

Auditoria do que já rodou

• Passo 10 — Ícones no calendário:
• ✓ rodou e enviou;
• ✗ falhou (o e-mail explica);
• ∅ rodou mas não tinha dado (mesmo assim avisa — o silêncio é proibido).

Botão do chat "📅 Agendar"

• Passo 11 — Na tela de Conversas, qualquer resposta tem 📅 Agendar esta consulta — vira uma rotina já pré-preenchida.

Cuidado: no modo supervisionado atual, TODO e-mail de rotina vai para o dono (OPYRA_ROTINAS_EMAIL_OVERRIDE). O direcionamento a usuários é liberado sob demanda.

---

Metas e planos de ação — o que fazer e o que vigiar

O plano que o Book propôs, com prazo; e o limiar de cada indicador, com aviso quando é violado.

O plano de ação

As recomendações do Book de Entrega vivem nesta tela. Elas nascem quando um Book é gerado — até quatro por edição, cada uma com área, prazo e o resultado esperado — e o Book seguinte cobra o que ficou pendente. Aqui você as acompanha e marca o que já foi feito.

• Cada linha mostra a situação: no prazo · a vencer (7 dias) · vence hoje · vencida, com quantos dias de atraso · sem prazo.
• ✓ marca como concluída; ✖ descarta. É isso que alimenta o capítulo «Plano de Ação» do próximo Book.
• Recomendação de um Book ainda em rascunho não aparece para o cliente: ela só existe para ele depois que a Nokware aprova o Book que a gerou.
• O placar do topo diz quantas estão em aberto e quantas vencidas — sem nenhuma recomendação a tela diz isso com todas as letras, em vez de mostrar zero como se fosse estar em dia.

Criar uma meta

• Passo 1 — Menu → Metas e planos de ação. A extração escolhida no seletor do topo é a que fornece os indicadores e os valores de hoje.
• Passo 2 — O formulário fica na própria tela (não há janela separada). Escolha o cliente, quando você for da equipe.
• Passo 3 — Escolha o painel e, em seguida, o indicador — pelo nome dele, não pelo nome do painel. São coisas diferentes: o painel Férias críticas tem como primeiro indicador Períodos monitorados, que não é o que a maioria quer vigiar.
• Passo 4 — Confira a faixa que aparece logo abaixo: ela mostra o valor de hoje e a unidade em que a meta deve ser digitada (7,2 para 7,2 %; 2127995 para R$ 2.127.995). Se o indicador aparecer em âmbar, ele veio sem número nesta extração e não serve para meta — escolha outro.
• Passo 5 — Escolha o operador ≤ ou ≥ e o limite.
• Passo 6 — Escolha o(s) canal(is) — e-mail e/ou WhatsApp — e preencha o destino. Ele é obrigatório: sem destino o aviso não teria para onde ir.
• Passo 7 — Salve. Toda nova ingestão (upload ou API) avalia a meta.

Reavaliar manualmente

• Passo 8 — Botão ↻ Reavaliar extração selecionada dispara a checagem sem esperar a próxima ingestão. O resultado diz quantas metas foram avaliadas, quantas dispararam e quantas não mediram nada nesta extração.

Quando uma meta aparece com aviso

Uma meta pode estar cadastrada e mesmo assim não medir — o indicador não veio naquela extração, veio sem número, ou a meta é antiga e não diz qual indicador vigia. Nesses casos ela aparece na lista com o motivo em texto claro, e é isso que se corrige: refaça a meta escolhendo o indicador pelo nome. Uma meta que não mede não protege ninguém, e a ausência de alerta não significa que está tudo bem.

Ver os alertas disparados

• Passo 9 — O bloco Histórico de alertas disparados, na mesma tela, lista os últimos. Um alerta por competência (dedupe automático — o Opyra não te bombardeia).

---

Briefing de urgência

"Tenho reunião em 1 hora": um one-pager projetável com talking points e Q&A.

• Passo 1 — Menu → Briefing.
• Passo 2 — Escolha o tema: custos, pessoas, compliance, férias ou turnover.
• Passo 3 — Escolha a competência.
• Passo 4 — Clique Gerar. O Opyra monta em ~30s com os números da competência ativa.
• Passo 5 — O briefing abre em tela cheia — PgUp/PgDown para navegar. É projetável.
• Passo 6 — Ctrl+P para PDF.

---

Extrações (equipe Nokware)

A governança do dado bruto. Todo pacote de dados que o Opyra recebeu vira uma extração aqui.

Ver o histórico

• Passo 1 — Menu → Extrações.
• Passo 2 — Filtre por cliente e/ou por competência. Cada linha mostra: cliente, tipo de pacote, competência, quem enviou, quando, tamanho, hash (dedupe), status.

Fazer upload manual

• Passo 3 — Clique ⬆ Enviar JSON.
• Passo 4 — Escolha o cliente e informe a competência (formato AAAA-MM).
• Passo 5 — Arraste ou selecione o arquivo .json.
• Passo 6 — O Opyra cifra em repouso, deduplica por hash e cria a extração. Se já existir uma igual (mesmo hash), avisa e não cria duplicata.

Download / renomear / excluir

• Passo 7 — Cada linha tem três ícones. Excluir exige confirmação e fica na trilha de auditoria.

Via API (o cliente extrai sozinho)

• Passo 8 — Menu → Administração → Clientes → abra o cliente → API Key (o token aparece uma vez; guarde). Endpoint: POST /api/v1/extracoes com header X-API-Key.

Por arquivo — para quem não pode abrir a API

Alguns clientes não liberam porta nenhuma para fora. Para eles o resultado é idêntico, não "equivalente": as consultas são as mesmas, geradas aqui; só o transporte muda.

• Passo 9 — Na tela de Extrações, painel Extrator por arquivo. Ele é a sequência inteira, com o estado de cada passo lido do servidor:
• ① Compilar o executor — uma vez, para sempre. O painel mostra a versão: é a única razão legítima para pedir uma recompilação ao cliente.
• ② Baixar o plano da rodada — um JSON com as consultas já prontas. Competência nova = plano novo, nunca uma recompilação.
• ③ Receber o arquivo que voltou — o cliente roda e devolve.
• ④ Compor o pacote — vira extração como qualquer outra.
• Passo 10 — Se o botão de compor estiver desabilitado, ele diz o que falta (qual seção não veio). Botão apagado e mudo seria defeito; aqui o motivo está escrito.

Coletar direto do ERP (conector ANVOR)

• Passo 11 — Para cliente com conector apto, a tela de Compliance eSocial tem ⟳ Coletar do ERP — o Opyra roda as consultas homologadas no ambiente do cliente e gera o pacote na hora, sem arquivo nenhum no meio.

---

Aprovações (equipe Nokware)

A fila Tier 2 de consultas geradas pelo ANVOR que aguardam aprovação humana antes de tocar o ERP.

• Passo 1 — Menu → Aprovações (badge no menu = tamanho da fila).
• Passo 2 — Cada item mostra: cliente, pergunta original, SQL proposto, confiança, cobertura e a trilha completa (como o ANVOR chegou nesse SQL).
• Passo 3 — Leia o SQL. Se estiver bom:
• ✔ Aprovar — o item volta ao trace do usuário e o Tier 3 executa no ERP.
• ✔ Aprovar + Homologar — mais forte: além de rodar agora, guarda no acervo para reuso automático da próxima vez que alguém perguntar igual.
• Passo 4 — Se estiver ruim: ✗ Rejeitar com justificativa. O usuário recebe a rejeição no chat.

---

Administração (equipe Nokware)

Usuários

• Passo 1 — Menu → Administração → Usuários.
• Passo 2 — ➕ Novo usuário: e-mail, nome, cliente (deixe em branco para equipe Nokware), perfil (admin/gestor/operador), e opcionalmente WhatsApp e as flags fiscal_simulado e admin_tenant.
• Passo 3 — O convidado recebe um e-mail de boas-vindas com um link para definir a própria senha, e o link explica o produto e o que o perfil dele abre. Senha em claro nunca trafega — nem para ele, nem para você.
• Passo 3b — Resetar senha manda o mesmo tipo de link. Quem esqueceu a senha resolve sozinho pelo "Esqueci minha senha" da tela de login, sem passar por você.
• Passo 4 — Desativar: derruba todas as sessões ativas dele.

Acessos por perfil (matriz)

• Passo 5 — Aba Acessos. A tabela mostra cards × perfis. Marca ✗ = restrito.
• Passo 6 — Você pode definir default global (cliente_id em branco) ou override por tenant (escolhendo o cliente).
• Passo 7 — Ausência de regra = PERMITIDO. Restringir = INSERT explícito.
• Passo 8 — Diferenciação de perfil aqui é só visibilidade — o Health Score não muda por causa disso (é proposital; o número é o mesmo).

Trilha de auditoria

• Passo 9 — Aba Auditoria. Filtre por usuário, ação, período. Toda ação side-effectful está aqui.

---

📊 Relatório Executivo (botão do topo)

Um one-pager imprimível de fechamento: evolução 12 meses, composição da folha, movimentação, heatmap de afastamentos.

• Passo 1 — Topo → 📊 Relatório.
• Passo 2 — Escolha a competência no seletor.
• Passo 3 — Leia:
• Evolução 12m — série temporal via snapshots (só carrega meses que já existem).
• Composição — rosca dos grupos de verbas.
• Movimentação — admissões × desligamentos.
• Heatmap — afastamentos por semana.
• Waterfall — custo de MO com decomposição.
• Passo 4 — Ctrl+P para PDF.
• Passo 5 — Para enviar por e-mail, clique 📤 Enviar — mesmo fluxo do Book (destinatários do Oryzo, MS Graph, auditado).

---

🔔 Alertas & avisos — o sino do topo

O sino fica no canto superior direito de todas as telas, com o número do que espera por você.

• Passo 1 — Clique no 🔔. A lista abre por cima da tela, sem tirar você de onde está.
• Passo 2 — Ela traz duas coisas:
• Metas estouradas — qual indicador, qual valor observado contra a meta, e em que competência.
• Sugestão de indicador — "você pediu X 3 vezes — fixar no cockpit?", com o botão Fixar ali mesmo.
• Passo 3 — Sem nada pendente, ele diz "✅ Tudo em dia". Sino que não distingue vazio de quebrado não serve para nada.

---

WhatsApp — o Opyra no seu bolso

O número oficial da Nokware (016 99600-6209) é uma extensão do Opyra: você recebe os avisos e consulta a sua folha por mensagem, com consentimento LGPD dado — e revogável — na própria conversa.

Ativar o canal (uma vez só)

• Passo 1 — A equipe Nokware cadastra o seu número na sua ficha (peça ao seu consultor).
• Passo 2 — Chega o convite oficial no seu WhatsApp, explicando o canal e a finalidade dos dados (imagem abaixo).
• Passo 3 — Responda CONCORDO para ativar. Não quer? Responda RECUSO — nada mais é enviado.
• Passo 4 — Para desligar depois, a qualquer momento, responda REVOGAR (ou SAIR). O canal desativa na hora, com registro datado (art. 8º §5º da LGPD).

Perguntar sobre a sua folha

• Passo 5 — Com o canal ativo, pergunte em português ("como está o custo da minha folha este mês?"). A resposta vem em segundos, sempre com números agregados — nunca dado pessoal de colaborador.
• Passo 6 — Palavras-chave levam a cards prontos: experimente férias, custo, turnover ou resumo (o Health Score da competência).
• Passo 7 — Quer receber um indicador toda semana sem pedir? Crie a rotina em Menu → Rotinas e escolha o canal WhatsApp — a entrega cai no seu zap no horário.
• Passo 8 — As metas (seção anterior) também podem avisar pelo WhatsApp: é só marcar o canal ao criar a meta.

O que o canal nunca faz

• Nunca envia dado pessoal de colaborador (CPF, salário, nome com valor) — agregados e links para o portal, sempre.
• Nunca manda mensagem da Nokware para você sem aprovação humana do nosso lado.
• Nunca reativa um canal recusado ou revogado por insistência — reativar exige novo pedido seu à equipe.

(equipe Nokware) — o zap interno

• O mesmo número atende a equipe com o assistente Jarvis: radar da operação, números vivos do financeiro e do fechamento, consultas ANVOR homologadas e a fila de aprovações — digite menu no zap para ver o cardápio. O guia completo interno foi distribuído por e-mail (30/07/2026) e vive em agentes/whatsapp/CLAUDE.md.

---

Ajuda & sobre

• Passo 1 — Menu → Ajuda & sobre (rodapé do menu, abaixo do separador).
• Passo 2 — A janela diz o que o Opyra é e traz o canal para reportar um erro: escreva para [email protected] contando o que você fazia e em qual tela.
• Passo 3 — Três botões:
• 📖 Manual do Opyra — este manual, sempre na versão de hoje.
• 🔒 Política de privacidade — a /privacidade.
• 🎬 Conheça o Opyra — a apresentação do produto, tela por tela.

Logo abaixo, ← Site do Opyra leva ao site público.

---

Perfis e o que cada um vê

Há três perfis: operador e gestor (do cliente) e equipe Nokware (admin). A tabela abaixo é o padrão de fábrica — a equipe muda qualquer linha por cliente, num clique em Administração → Acessos.

¹ Restrito por padrão, liberável por cliente. O Conferidor e o Prognos nascem fechados porque mostrar a auditoria da folha e a previsão de saída ao próprio cliente é decisão comercial, não de engenharia. Liberar é um clique — não é mudança de código.

Duas regras que valem sempre:

• Ausência de regra = PERMITIDO. Restringir é um ato explícito e registrado.
• Diferença de perfil é só visibilidade, nunca o número. O Health Score usa a lista COMPLETA de cards, não a que o seu perfil enxerga — quem vê menos telas não vê uma nota diferente. Isso é proposital.
• ⚠ Escopo de dados é outro eixo, e nele o número muda. Restringir uma conta a uma filial e a certos centros de custo (docs/139) recalcula os indicadores dentro desse recorte — perfil decide o que aparece, escopo decide o que entra na conta. As duas restrições convivem e não se substituem.

Ações reservadas a admin/gestor (aprovar uma consulta Tier 2, gerar Book, disparar envio) permanecem fechadas ao operador mesmo quando a tela está visível.

O isolamento entre clientes é garantido em duas camadas — aplicação e banco.

---

De onde vêm os dados

O extrator BookOpyra é executado pelo cliente no próprio ambiente do ERP e gera pacotes por competência: mestre (cadastro, folha, férias, afastamentos, admissões/desligamentos), verbas (analítico verba a verba, com roteiro de cálculo), ausências, eSocial (TAF) e auditoria (rescisões, alterações salariais, insumos de validação). Os pacotes chegam por API (X-API-Key do cliente) ou upload, são deduplicados por hash e cifrados em repouso. Para dados ao vivo, o conector ANVOR executa consultas agregadas e homologadas no ERP — somente leitura, fail-closed, com aprovação humana para consultas novas.

---

Segurança e privacidade em uma linha cada

Dados cifrados em repouso · identificadores pessoais cifrados nas críticas · CID de afastamento só por grupo · CPF/PIS nunca trafegam (somente flags de validade) · máscara LGPD em toda análise de IA · trilha de auditoria em cada ação · política completa em /privacidade.

---

Opyra · um produto Nokware® — Soluções Definitivas. Suporte e reporte de erros: [email protected].