Guia Funcional — Cadastros

O menu Cadastros concentra a base mestre usada pelos demais módulos: clientes, prospects, fornecedores, pessoas físicas, produtos, modelos de hardware e ativos.

Guia Funcional — Projetos e Operações

O menu Operações organiza a execução diária. Ele separa gestão operacional de projetos dos vínculos simples de projeto que existem dentro do cadastro do cliente.

Cockpit Operacional

• É o painel de ação do dia: pendências críticas, agenda operacional, riscos, projetos em atenção, saúde de clientes e filas de WorkItems.
• As filas usam nomes amigáveis para áreas como suporte ao cliente, marcos de projeto e CS mensal; códigos técnicos aparecem como detalhe.
• É diferente do Cockpit Executivo, que pertence ao Financeiro e olha carteira, contratos, receita e desvios executivos.

Projetos e cronogramas

• Operações > Projetos é o hub do portfólio operacional, com lista, cronograma e acompanhamento.
• Cronogramas usam etapas, entregáveis e atividades em rota própria, com modo de consulta ou edição conforme permissão.
• Templates de Cronograma guardam modelos reutilizáveis para projetos de setup e frentes recorrentes.

Execução, rastreabilidade e comunicação

• Gestão de Backlog integra demandas com Jira e diferencia visualização, edição, dimensionamento e edição completa.
• Comunicados envia e-mails operacionais para clientes e prospects usando seleção por filtros, preview, agendamento e rastreabilidade individual.
• Assistentes apoiam fluxos administrativos de abertura de projeto e entrega de setup/subscrição.
• Minha Área consolida ações atribuídas ao usuário, incluindo itens de suporte, operações e financeiro quando houver permissão.

Guia Funcional — Suporte e Atendimento

Esta seção consolida a documentação que antes ficava separada no módulo de suporte. O cockpit de suporte continua com um atalho visível, agora apontando para esta Central de Ajuda.

Canal oficial e histórico

• O suporte ao cliente acontece por e-mail via suporte@zapt.tech.
• Responda sempre na mesma thread do chamado para preservar histórico, contexto e rastreabilidade.
• Chamados externos geram comunicação com cliente; chamados internos são operacionais e podem evoluir no cockpit e no Jira sem e-mail automático ao cliente final.

Tipos de abertura

Registro expresso

Use quando o atendimento aconteceu por WhatsApp, telefone ou outro canal. O e-mail deve conter #expresso, #cliente: email@dominio.com, canal, data/hora, solicitação e solução. A IA confere dados essenciais; depois do #ok, o sistema cria o ticket já fechado, envia resumo ao cliente e solicita avaliação 1-4.

Fluxo de atendimento e tags

• #encerrar fecha chamado externo e envia pesquisa; em ticket interno de produto, PO Team também pode usar sem pesquisa.
• #semretorno fecha sem avaliação.
• #remover fecha e remove de analytics, útil para spam ou falso chamado.
• #repassar email@zapt.tech transfere o atendimento e notifica o novo responsável.
• A IA classifica assunto e prioridade; atendentes autorizados podem corrigir no detalhe do ticket.

SLA, alertas, analytics e avaliação

• O SLA considera horas úteis em America/Sao_Paulo e aplica-se ao suporte ao cliente; tickets internos não entram no mesmo job automático de alertas.
• Prioridades: Crítico, Alto, Médio, Baixo e Planejado, com tempos configuráveis por usuários autorizados.
• Analíticos mostram desempenho, SLA, suporte direto versus Jira, clientes e assuntos; tickets removidos não entram nas métricas.
• Ao fechar chamado externo com #encerrar, o cliente avalia de 1 a 4; nota 4 reabre o chamado.

Integração com Jira

• Tickets podem ser promovidos ao Jira quando exigem correção de produto, evolução, priorização de backlog ou acompanhamento formal.
• PO Team promove para qualquer épico e pode rejeitar tickets internos de produto; atendentes usam apenas épicos liberados.
• Webhooks do Jira registram retorno quando issue é concluída ou excluída, mantendo rastreabilidade no ticket.

Guia Funcional — Contratos e Assinaturas

Contratos e assinaturas conectam venda, operação e financeiro. A documentação separa a leitura operacional da assinatura da gestão financeira do contrato.

Assinaturas

• Operações > Assinaturas acompanha recorrência, cliente, produto, tipo de cobrança, renovação, responsável e situação operacional.
• A assinatura ajuda a operação a entender continuidade e entrega, mas não substitui a agenda financeira.

Contratos

• Financeiro > Contratos mantém o cadastro contratual, produtos/hardware, datas, instrumento, link do contrato, observações e regras financeiras.
• A aba Financeiro concentra modelo de cobrança, setup, mensalidade, imposto, comissão, reajuste, indicador ARR e geração de agenda.
• Administradores não financeiros podem ter consulta contratual sem valores; usuários financeiros completos veem e editam valores, agenda e integrações.

Relação entre áreas

• Contrato define a regra; agenda financeira materializa parcelas; faturamento acompanha cobrança e recebimento; comissões dependem do pagamento do cliente.
• A operação usa contratos e assinaturas para entender escopo e continuidade, sem transformar o cockpit operacional em módulo financeiro.

Guia Funcional — Financeiro

O menu Financeiro é restrito por permissão e reúne cockpit executivo, contratos, faturamento, Bling Recebíveis e comissões.

Agenda e faturamento

• A agenda nasce das regras da aba Financeiro do contrato, com geração segura para preservar parcelas pagas, faturadas, manuais ou ajustadas.
• Faturamento mostra visão anual por cliente/contrato/mês e lista operacional de parcelas com competência, vencimento, valor, status e comissão.
• Status principais: Previsto, Faturado, Pago, Vencido e Cancelado.

Comissões e caixa

• Comissões consolida valores por comercial e pode ser lida por competência ou por caixa.
• A comissão é liberada quando a parcela do cliente é recebida, e pode evoluir para agendada e paga.
• O acompanhamento de caixa hoje aparece principalmente na leitura de faturamento, recebíveis, comissões e cockpit executivo.

Cockpit Executivo

• Consolida carteira ativa, MRR estimado, ARR estimado, receita futura, reajustes, alertas executivos e desvios relevantes.
• É uma visão de gestão e não substitui a rotina operacional do cockpit de projetos.

Integrações financeiras

• Bling Recebíveis está implementado para conciliar títulos realizados no Bling com parcelas planejadas no Back-Office, sinalizando títulos conciliados, ausentes, divergentes ou órfãos.
• A baixa automática aparece nos casos seguros do fluxo de reconciliação retroativa, conforme regras do sistema.
• Bling Contas a Pagar não aparece como tela/endpoint ativo neste Back-Office; tratar como pendente de validação antes de documentar como fluxo implementado.
• Itaú não foi encontrado como integração ativa no código analisado; documentar como em andamento para acompanhamento de fluxo de caixa.

Guia Funcional — Inteligência

O menu Inteligência transforma dados operacionais, uso do portal, qualidade, suporte e IA em indicadores de acompanhamento da carteira.

Apoio à decisão não dispensa contexto humano: eventos, sazonalidade, início recente de operação, dados cadastrais incompletos e mudanças de escopo precisam ser considerados na leitura.

Guia Funcional — Integrações

Integrações conectam o Back-Office a sistemas operacionais, financeiros e administrativos. Nem toda rotina de integração deve aparecer como fluxo principal para o usuário final.

Importações auxiliares

Importar Histórico, Importar Pipeline Comercial, Vincular Histórico e a importação financeira são rotinas auxiliares, técnicas ou administrativas. Elas existem para saneamento, carga inicial, correção e manutenção, mas não devem protagonizar a navegação principal da documentação.

Guia Funcional — Administração

A administração aparece principalmente em Configurações e nas permissões aplicadas pelo backend.

• Usuários autenticados com e-mail autorizado acessam o Back-Office conforme capacidades recebidas.
• Permissões controlam edição de clientes, contratos, financeiro, comunicados, backlog Jira, simulação de usuário e administração geral.
• O modo Ver como usuário ajuda administradores gerais a validar experiência e permissões em leitura.
• Configurações administram remetentes, assinaturas, consultas de e-mail, parâmetros operacionais e controles estruturais do sistema.

Guias por Papel

Os guias por papel são trilhas práticas. Eles indicam o que cada perfil precisa saber e quais partes do Guia Funcional servem de base, sem duplicar toda a documentação.

Boas Práticas