Manual Completo do Zenith

Passo a passo de cada módulo, alinhado com o que o app faz hoje. Este mesmo conteúdo alimenta o assistente de IA.

Módulos

Visão Geral e Ordem Recomendada

Rota: /modulos/dashboard

O AppZenith organiza o negócio do MEI e do profissional autônomo em módulos (Motores).

Não tente usar tudo de uma vez. Siga esta ordem:

  • Configurações — cadastre CNPJ/CPF, endereço e Zenith ID.
  • CRM — cadastre clientes (e fornecedores se precisar).
  • Orçamentos — faça propostas e aprove quando o cliente fechar.
  • Financeiro — registre receitas/despesas (ou deixe a aprovação do orçamento gerar a receita).
  • Fiscal — prepare a colinha NFS-e a partir de orçamentos aprovados e conclua a emissão no portal oficial; gere DAS no PGMEI.
  • Meu Contador — se não quiser emitir sozinho, peça o serviço ao contador por mensagem.
  • Agenda — marque atendimentos (pode gerar receita ao concluir).

    • Extras: Metas, Investimentos, Ciclo, Documentos (PRO), Vacinas (PRO),

    Eventos (produção/escalas — perfil Eventos, PRO ou modo operação Contador),

    Músicos (shows — perfil/beta).

    Regras gerais para o assistente

  • Você é um guia: explique o passo a passo e indique o menu/rota. Não execute ações na conta.
  • Sempre termine com um link markdown para o módulo certo, no formato [Abrir Nome](/modulos/slug).
  • Dashboard usa [Abrir Dashboard](/dashboard).
  • Se pedirem "faça por mim", explique que no momento você só orienta e direcione ao módulo certo.
  • Pedidos de NF: oriente o Fiscal; se não quiser emitir, leve a [Abrir Meu Contador](/modulos/contador).
  • Nunca invente botões, telas ou campos que não existem neste manual.
  • Se o módulo estiver PRO e o usuário for Free, explique o bloqueio e ofereça [Assinatura](/modulos/configuracoes).

    • Configurações

    Rota: /modulos/configuracoes

    Rota: /modulos/configuracoes

    Abas

  • Meu Perfil
  • Plano de Contas
  • Assinatura & Plano
  • Personalização
  • Sair

    • Rotina: Completar o perfil (obrigatório antes de NFS-e)

  • Abra Configurações no menu.
  • Na aba Meu Perfil, preencha:

    • - Nome

    - Telefone

    - E-mail

    - CPF ou CNPJ

    - Inscrição Municipal (se PJ / emissão NFS-e)

    - Endereço (use o CEP — busca automática)

    - Zenith ID (usado no link público da Agenda: /agendar/@seu_id e exigido para se candidatar como prestador em /evento/[id])

  • Clique em Salvar Alterações.

    • Rotina: Assinar Zenith PRO

  • Aba Assinatura & Plano.
  • Escolha PIX (1 mês ou 3 meses com desconto) ou cartão.
  • Ou use um código de ativação, se tiver.

    • Rotina: Personalizar cor do tema

  • Aba Personalização.
  • Escolha a cor — fica salva no navegador.

    • Rotina: Sair da conta

  • Aba Sair (ou logout no menu).

    • Erros comuns

  • Sem CNPJ no perfil → Fiscal não gera colinha completa de NFS-e.
  • Zenith ID vazio → link público de agendamento não funciona bem.
  • Cadastro incompleto (nome, telefone ou Zenith ID) → bloqueia candidatura de prestador no link de Eventos e o agendamento público da Agenda.

    • CRM (Contatos)

    Rota: /modulos/crm

    Rota: /modulos/crm

    Rotina: Cadastrar contato

  • Abra CRM.
  • Clique em Adicionar Contato (ou “Cadastrar Meu Primeiro Contato” se a lista estiver vazia).
  • Preencha:

    • - Papel: Cliente | Prestador/Equipe | Fornecedor

    - Status: Ativo / Inativo

    - Nome (obrigatório)

    - Tipo: Pessoa Física ou Jurídica

    - CPF ou CNPJ

    - Inscrição Municipal (se PJ e for emitir nota)

    - E-mail, Telefone

    - CEP → preenche endereço; complete Número

    - Gênero (opcional), Observações

  • Salve.

    • Rotina: Editar ou excluir

  • Na lista, use os ícones de editar ou excluir no contato.

    • Para que serve

  • Orçamentos precisam de um cliente do CRM.
  • Fiscal usa dados do tomador (cliente) na colinha da NFS-e.
  • Vacinas/Agenda podem vincular dono/cliente.

    • Erros comuns

  • Cadastrar só o nome sem documento → dificulta nota fiscal.
  • Esquecer Inscrição Municipal do cliente PJ → portal NFS-e pode exigir.

    • Orçamentos

    Rota: /modulos/orcamentos

    Rota: /modulos/orcamentos

    Preview: /modulos/orcamentos/preview/[id]

    Status do orçamento (fluxo)

    Draft (Rascunho) → Sent (Enviado) → Approved (Aprovado) ou Recusado → Invoiced (após NF) / Cancelled

    Rotina: Criar orçamento

  • Abra Orçamentos → Novo Orçamento.
  • Selecione o Cliente (precisa existir no CRM).
  • Adicione itens: descrição, quantidade, valor unitário.
  • Opcional: desconto, observações/termos, código de tributação nacional, válido até.
  • Salve (fica em Draft).

    • Rotina: Enviar ao cliente

  • No orçamento Draft, marque como Enviado (Sent).
  • Use Ver / Imprimir (preview) ou WhatsApp (abre wa.me com link do preview).

    • Rotina: Aprovar (gera receita)

  • Com status Sent, clique em Aprovar.
  • Confirme se deseja gerar a receita no Financeiro (geralmente pendente).
  • Status vira Approved.

    • Rotina: Recusar / Excluir / Editar

  • Recusar: disponível em Sent.
  • Editar/excluir: não disponível se já Invoiced ou Cancelled.

    • Rotina: Ir para emissão de nota

  • Orçamento Approved → botão/link para Emitir Nota (leva ao Fiscal).

    • Erros comuns

  • Criar orçamento sem cliente no CRM.
  • Tentar emitir NF antes de Aprovar.

    • Financeiro

    Rota: /modulos/financeiro

    Rota: /modulos/financeiro

    Atalho: /modulos/financeiro?new=true abre o modal de lançamento.

    Abas

  • Visão Geral (lançamentos)
  • Contas
  • Categorias

    • Rotina: Registrar receita

  • Botão Receita.
  • Campos: Descrição, Valor, Data, Conta, Categoria, Situação (Recebido | Pendente).
  • Opcional: parcelar (qtd de parcelas), aquisição de bem.
  • Salve.

    • Rotina: Registrar despesa

  • Botão Despesa.
  • Mesmos campos; Situação = Pago | Pendente.

    • Rotina: Transferir entre contas

  • Botão Transferir.
  • Informe conta origem, conta destino, valor e data.

    • Rotina: Editar ou excluir lançamento

  • Na lista da Visão Geral, use os ícones no item.

    • Rotina: Criar conta

  • Aba Contas → Nova Conta.
  • Nome, Tipo (Corrente / Digital / Poupança / Cartão / Dinheiro / Investimentos), Saldo inicial.

    • Rotina: Criar categoria

  • Aba Categorias → Nova Categoria.
  • Nome, tipo Receita ou Despesa, cor.
  • Categorias de sistema não são editáveis.

    • Integrações

  • Aprovar orçamento pode criar receita.
  • Concluir agendamento na Agenda pode criar receita “Atendimento: …”.

    • Erros comuns

  • Lançar tudo sem conta → saldos ficam inconsistentes.
  • Marcar como Recebido/Pago sem ter entrado o dinheiro.

    • Fiscal / Impostos

    Rota: /modulos/fiscal · Requer plano PRO

    Rota: /modulos/fiscal

    Abas

  • Emissão NFs
  • Histórico NFs
  • Guia DAS
  • Consulta Simples (optantes / desenquadramento)

    • Pré-requisitos para NFS-e

  • CNPJ (e dados) em Configurações > Meu Perfil.
  • Cliente completo no CRM (documento e endereço).
  • Orçamento com status Approved.

    • Rotina: Emitir NFS-e (Colinha + Portal)

  • Aba Emissão NFs.
  • Localize o orçamento aprovado → Emitir NF (Colinha).
  • No modal, copie os blocos (login CNPJ, tomador, serviço).
  • Clique Emitir Nota Fiscal (Abrir Portal) → nfse.gov.br.
  • Preencha no portal oficial com a colinha.
  • Volte ao Zenith e confirme Já emiti a NFS-e no Portal → status Invoiced.

    • Rotina: Cancelar nota no histórico

  • Aba Histórico NFs.
  • Cancelar Nota Fiscal e informe o motivo.

    • Rotina: Gerar DAS (MEI)

  • Aba Guia DAS.
  • Copiar CNPJ.
  • Abrir o portal PGMEI e gerar a guia lá (o Zenith facilita o acesso; a guia oficial sai no governo).

    • Rotina: Declaração Anual MEI (DASN-SIMEI)

  • Aba Guia DAS.
  • Copiar CNPJ (somente números).
  • Clique em Fazer Declaração Anual MEI (DASN-SIMEI) e conclua no portal oficial.

    • Rotina: Consultar optante Simples Nacional

  • Aba Consulta Simples.
  • Confirme o CNPJ (pré-preenchido do perfil) → Consultar.
  • Veja se permanece optante pelo Simples / SIMEI ou se há exclusão (desenquadramento).
  • Para confirmação oficial, use o link Consulta Optantes (Receita Federal).

    • Dashboard: alerta de limite MEI

  • Com base em Receitas Totais Ano, o painel avisa quando o faturamento se aproxima de R$ 81.000 (teto MEI).
  • Ex.: no mês 08, com ~R$ 73 mil, o aviso indica proximidade do limite.

    • Importante

  • O Zenith NÃO transmite a NFS-e sozinho nesta versão: ele monta a colinha e registra que você emitiu.
  • Certificado digital A1 é exigência dos portais oficiais, não um recurso “dentro” do app.
  • A consulta de optantes usa base pública de CNPJ e pode atrasar; o portal da Receita é a fonte oficial.

    • Contador / Meu Contador

    Rota: /modulos/contador

    Rota: /modulos/contador

    Para o MEI / profissional (Meu Contador)

  • Abra Meu Contador.
  • Escolha o tipo (emissão de NF, parcelamento, lançamentos ou geral).
  • Escreva a mensagem e envie.
  • Acompanhe a conversa na lista de solicitações.
  • Alternativa: tente sozinho no [Fiscal](/modulos/fiscal) ou peça orientação no [Assistente](/modulos/assistente).

    • Para o Contador (hub do escritório)

  • Veja Solicitações dos clientes no topo.
  • Responda a mensagem; se precisar, use Abrir conta completa do cliente (com autorização ativa).
  • Cadastre clientes e cola de NF/gov.br como de costume.

    • Modo operação (conta do cliente)

  • Com autorização ativa, o Contador pode abrir a conta completa do cliente (faixa amarela "Modo operação").
  • Nesta sessão ficam liberados Fiscal, Documentos e Eventos, mesmo se o cliente for Free — sem elevar o plano do titular.
  • Ao sair ("Voltar para minha conta de contador"), o cliente volta às regras do plano dele.

    • Autorizações

  • Cliente aceita o vínculo em /aceitar-acesso e pode revogar em /autorizacoes.

    • Agenda

    Rota: /modulos/agenda

    Rota: /modulos/agenda

    Link público: /agendar/@{zenith_id} (Zenith ID em Configurações)

    Abas

  • Agendamentos
  • Meus Serviços

    • Rotina: Cadastrar serviço

  • Aba Meus Serviços → Novo Serviço.
  • Nome, Preço, Duração (minutos).
  • Pode ativar/desativar depois.

    • Rotina: Novo agendamento

  • Aba Agendamentos → Novo Agendamento.
  • Nome do cliente, WhatsApp, Serviço, Data, Horário (faixa típica 08–18h).
  • Salve.

    • Rotina: Bloquear horário

  • Bloquear Horário — reserva o slot sem atendimento.

    • Rotina: Compartilhar agenda pública

  • Copie o link ou QR Code na tela de Agendamentos.
  • Cliente (com conta Zenith e cadastro completo) agenda sozinho em /agendar/@seu_id.
  • O agendamento cria o horário e sincroniza o cliente no CRM do prestador (role cliente).
  • Cadastro incompleto do cliente → tela pede finalizar nome, telefone e Zenith ID.

    • Rotina: Reagendar, concluir ou cancelar

  • Abra o detalhe do compromisso.
  • Reagendar, Cancelar, ou Concluir.
  • Ao Concluir, o sistema pode lançar receita no Financeiro (“Atendimento: …”).
  • WhatsApp disponível no detalhe.

    • Erros comuns

  • Sem serviços cadastrados → agendamento fica limitado.
  • Zenith ID vazio → link público fraco/quebrado.

    • Metas

    Rota: /modulos/metas

    Rota: /modulos/metas

    Seções

  • Financeiras
  • Investimento
  • Saúde & Hábitos

    • Rotina: Criar meta

  • Nova Meta.
  • Categoria, Título, Objetivo (número), Unidade (R$, vezes, dias, etc.), Prazo.
  • Salve.

    • Rotina: Avançar meta de hábitos

  • Em Saúde & Hábitos, use +1 para registrar progresso.
  • Excluir meta: ícone de excluir.

    • Limitações atuais

  • Não há edição completa após criar — exclua e recrie se precisar mudar o objetivo.

    • Investimentos

    Rota: /modulos/investimentos

    Rota: /modulos/investimentos

    Rotina: Adicionar ativo

  • Adicionar Ativo.
  • Tipo: Imóveis, Automóveis, Terrenos, Aluguéis, Ações, Dinheiro, Cripto, Renda Fixa, Outros.
  • Nome, Valor, Data de aquisição, Rendimento mensal (opcional), Observações.
  • Opcional: parcelado (qtd + dia de vencimento).
  • Salve. Edite ou exclua depois na lista.

    • Ciclo Feminino

    Rota: /modulos/ciclo

    Rota: /modulos/ciclo

    Rotina: Configurar ciclo

  • Informe última menstruação, duração do ciclo e duração do período.
  • Marque sintomas do dia (cólica, cabeça, espinhas, irritabilidade, desejo, cansaço).
  • Salvar.

    • O que a tela mostra

  • Previsão da próxima menstruação
  • Ovulação e janela fértil no calendário

    • Documentos

    Rota: /modulos/documentos

    Rota: /modulos/documentos

    Disponível no plano Free — inclusive para baixar NF e arquivos que o Contador enviar após um serviço pago.

    Rotina: Enviar arquivo

  • Fazer Upload.
  • Selecione o arquivo.

    • Rotina: Baixar ou excluir

  • Na lista: Download ou Excluir.

    • Entrega do Contador

    Quando o Contador conclui um serviço pago com arquivo, o PDF aparece aqui automaticamente.

    Limitações atuais

  • Sem pastas, tags ou filtros avançados — lista simples (nome, tamanho, data).

    • Controle de Vacinas

    Rota: /modulos/vacinas · Requer plano PRO

    Rota: /modulos/vacinas

    Abas

  • Revacinações Programadas
  • Cadastro de PETs

    • Rotina: Cadastrar PET

  • Aba PETs → cadastrar.
  • Nome, raça, peso, nascimento, dono (CRM ou manual), telefone.

    • Rotina: Programar revacinação

  • Programar Revacinação.
  • PET (ou dados manuais), tipo de vacina, data.
  • Pode criar compromisso na Agenda automaticamente.

    • Outras ações

  • Buscar/filtrar na lista
  • Marcar SMS enviado
  • Emitir Laudo / Termo (impressão)
  • Excluir programação

    • Eventos (produção e escalas)

    Rota: /modulos/eventos · Requer plano PRO

    Rota do organizador: [Abrir Eventos](/modulos/eventos)

    Presenças do convidado: [Abrir Meus Eventos](/meus-eventos)

    Link público de um evento: /evento/{id}

    Acesso: perfil Eventos, plano PRO, admin (beta), ou modo operação do Contador na conta do cliente (libera Eventos sem tornar o cliente PRO).

    Abas no módulo

  • Projetos (lista de eventos)
  • Escala de Prestadores

    • Rotina: Criar evento e compartilhar link

  • Abra [Abrir Eventos](/modulos/eventos) → Novo Evento.
  • Preencha nome, data, local, valor e custos.
  • Copie o link público do evento (/evento/{id}?ref=...). O parâmetro ref é o UUID do organizador.
  • O mesmo link serve para convidados e prestadores.
  • Se um visitante criar conta por esse link e depois assinar PRO/Simples, a comissão cai em [Indicar & Ganhar](/indicacoes) do organizador (regra de referral já existente).

    • Proteção: exclusão com partes envolvidas

  • Evento com prestador Confirmado, vínculo Zenith (staff_user_id), lançamento financeiro ou presenças confirmadas → não pode excluir.
  • Prestador confirmado / com financeiro → não remove da escala com 1 clique.

    • Aceite mútuo de alterações

  • Prestador Confirmado com conta Zenith: mudar diária/ajudas/função ou desconfirmar não aplica na hora.
  • O organizador cria um pedido (event_change_requests). O prestador vê em [Meus Eventos](/meus-eventos) e Aceita/Recusa.
  • Organizador acompanha pedidos pendentes no módulo Eventos.
  • Ao aceitar termos com financeiro Pending, os valores das txs vinculadas são atualizados.
  • Migration: 202608101400_event_change_requests.sql (aplicar no Supabase).

    • Rotina: Convidado confirma presença

  • Pessoa abre /evento/{id} e faz login/cria conta.
  • Clica Confirmar presença.
  • Entra em event_attendees e no CRM do organizador como cliente.
  • Aparece em [Abrir Meus Eventos](/meus-eventos) e no widget "Meus Eventos (inscrições)" do Dashboard.

    • Rotina: Prestador se candidata à escala

  • Prestador (outra conta Zenith) abre o mesmo /evento/{id}.
  • Precisa de cadastro completo: nome, telefone e Zenith ID em [Abrir Configurações](/modulos/configuracoes). Se faltar, a tela bloqueia e pede finalizar cadastro.
  • Clica Quero trabalhar neste evento.
  • Entra na Escala do organizador como Pendente, com vínculo de usuário; CRM do organizador recebe como prestador.
  • Organizador preenche a diária (e ajudas, se houver) e confirma na Escala (Pendente → Confirmado).

    • Regra financeira ao confirmar prestador (contratação)

    Ao marcar Confirmado (com valor > 0):

  • Organizador (dono do evento) → lançamento de despesa a pagar no [Financeiro](/modulos/financeiro) (categoria "Eventos / Prestadores").
  • Prestador com conta Zenith (veio pelo link / tem staff_user_id) → receita a receber no Financeiro dele + orçamento Approved em [Orçamentos](/modulos/orcamentos) (caminho para [Fiscal](/modulos/fiscal) / NFS-e se precisar emitir nota).
  • Prestador só no CRM (sem conta Zenith vinculada) → gera apenas a despesa do organizador.
  • Diária/custo zerado → confirma a escala sem criar lançamentos (edite o valor antes se quiser financeiro).
  • Não volte o status para Pendente para “desfazer” o financeiro: os lançamentos já criados ficam no Financeiro (cancele/edite lá se precisar).
  • No orçamento gerado automaticamente, não aprove de novo só para gerar receita — a receita já foi lançada na confirmação.

    • Rotina: WhatsApp na Escala

  • Em Eventos → Escala de Prestadores, use o botão WhatsApp da linha.
  • Abre conversa com mensagem casual (sem emoji) pedindo confirmação real da presença.
  • Telefone vem do CRM / telefone da escala. Sem telefone → oriente completar CRM/cadastro.

    • Dashboard do organizador

  • Widget Eventos & Escalas Operacionais mostra próximo evento real, escala confirmada e custo (não é mock).
  • Perfil Eventos (e admin) vê esse bloco.

    • O que NÃO fazer / não confundir

  • Confirmar presença ≠ entrar na escala. Presença = convidado/público. Escala = prestador.
  • Shows de músico → use [Abrir Músicos](/modulos/musicos), não Eventos.
  • Não diga que o assistente cria evento ou escala sozinho — oriente o usuário nas telas acima.

    • Motor Músicos

    Rota: /modulos/musicos · Requer plano PRO

    Rota: /modulos/musicos

    Abas

  • Shows & Cachets
  • Repertório

    • Rotina: Cadastrar um show

  • Aba Shows → Novo Show.
  • Preencha título, data, local, cidade, cachet, contratante e status.
  • Status possíveis: Proposta, Confirmado, Realizado, Cancelado, Pago.
  • Quando receber o cachet, registre a receita em [Abrir Financeiro](/modulos/financeiro) (não duplique lançamento aqui).

    • Rotina: Montar repertório

  • Aba Repertório → Nova Música.
  • Título, artista, tom, BPM, gênero.
  • Desmarque "Ativa" para arquivar sem excluir.

    • O que NÃO fazer

  • Não use o módulo Eventos genérico para shows de músico — use Músicos.
  • Eventos = produção/escalas de equipe; Músicos = shows e cachet.
  • Não lance cachet duas vezes (aqui + Financeiro). O cachet no show é referência; o caixa fica no Financeiro.

    • Fluxos cruzados (receita ponta a ponta)

    Rota: /modulos/dashboard

    1) Do zero até a NFS-e

  • Configurações → perfil com CNPJ/IM.
  • CRM → cadastrar cliente completo.
  • Orçamentos → criar → enviar → aprovar.
  • Fiscal → Colinha → portal oficial → confirmar emissão.

    • 2) Orçamento vira caixa

  • Aprovar orçamento.
  • Confirmar geração de receita no Financeiro.
  • Quando receber, edite o lançamento para Recebido/Completed.

    • 3) Atendimento na Agenda vira caixa

  • Agendar serviço.
  • No dia, Concluir.
  • Conferir receita criada no Financeiro.

    • 4) DAS do MEI todo mês

  • Fiscal → Guia DAS → copiar CNPJ → PGMEI → pagar.

    • 5) Vacina + Agenda (PRO)

  • Cadastrar PET.
  • Programar revacinação (cria compromisso na Agenda).

    • 6) Show do músico (PRO / beta)

  • CRM → cadastrar contratante (casa/produtor), se ainda não existir.
  • Músicos → Novo Show (data, local, cachet).
  • Financeiro → registrar receita do cachet quando receber.

    • 7) Evento: presença ou prestador pelo link

  • Organizador cria o evento em [Abrir Eventos](/modulos/eventos) e copia o link /evento/{id}.

    • 2a. Convidado → Confirmar presença → vê em [Abrir Meus Eventos](/meus-eventos); CRM do dono recebe cliente.

    2b. Prestador (cadastro completo) → Quero trabalhar neste evento → Escala Pendente; CRM do dono recebe prestador.

  • Organizador confirma na Escala e usa WhatsApp para alinhar presença de verdade.