Central de gestao

Manual operacional

Roteiro simples para operar o Paglog One em homologacao, treinar usuarios e conferir o que falta antes de qualquer integracao real.

Empresa: Empresa de Homologacao
Ajuda
Modo demo ativoVoce esta navegando com dados ficticios. As integracoes reais continuam desligadas.
Sair do demo

Guias

8Fluxos principais

Checklist

10Publicacao e homologacao

Prontos

6Feitos pelo Codex

Externos

3Decisao ou credencial

Monitorar

1Rotina do VPS

Como usar

Treinamento e operacao diaria

Comece pelo guia do modulo que sera usado, confira os pontos de seguranca e abra os links do proprio sistema. O documento versionado fica em docs/MANUAL_USUARIO.md.

Ativo

So falta fora do codigo

Produto

Especificacao consolidada v0.5

Substituir o placeholder quando a especificacao completa for entregue.

Fornecedor

Gateway piloto e credenciais

Configurar Asaas como piloto e cadastrar somente o webhook Asaas no painel externo.

DevOps

Dominio final e GitHub remoto

Confirmar se mantem rota atual ou subdominio, autenticar gh e publicar repositorio privado.

Administrador da empresa

Primeiro acesso e empresa ativa

Entrar no sistema, confirmar a empresa correta e navegar sem depender de suporte tecnico.

Ativo

Passo a passo

  1. Entre pelo login liberado pela Yatta ou pelo acesso demo de homologacao.
  2. Confira no topo se a empresa ativa esta correta antes de cadastrar ou alterar dados.
  3. Abra Inicio para acessar os atalhos principais e use Ajuda quando precisar de orientacao curta.
  4. Se aparecer bloqueio por fatura, abra Faturamento para consultar segunda via simulada e proximos passos.

Conferir antes de concluir

  • Nao compartilhe senha local ou link de acesso com terceiros.
  • Use o seletor de empresa somente quando o usuario tiver acesso autorizado a mais de uma empresa.
  • Acesso demo serve para navegacao e nao deve ser tratado como login real de cliente.

Operacao

Clientes, veiculos, imoveis e lojas

Manter a base comercial organizada com historico auditavel por registro.

Ativo

Passo a passo

  1. Cadastre lojas antes de criar contratos para separar operacao por unidade.
  2. Cadastre clientes PF ou PJ com documento correto e mantenha dados de contato atualizados.
  3. Cadastre veiculos e imoveis vinculando o cliente correto quando houver proprietario relacionado.
  4. Use Abrir para revisar detalhes, editar dados e acompanhar o historico operacional do registro.
  5. Altere status com as acoes guiadas de ciclo de vida, sempre conferindo a confirmacao antes de concluir.

Conferir antes de concluir

  • Loja Digital publica nao mostra placa completa, chassi, renavam, endereco completo ou dados internos.
  • Cadastros arquivados preservam historico; use arquivar apenas quando o registro nao deve aparecer na operacao diaria.
  • Veiculos e imoveis so devem ser marcados como vendidos, locados ou em manutencao quando a operacao interna confirmar.

Financeiro e operacao

Contratos, parcelas e pagamentos

Criar contratos, acompanhar parcelas e registrar pagamentos internos sem acionar dinheiro real.

Ativo

Passo a passo

  1. Crie contrato somente para cliente ativo da empresa e, quando aplicavel, loja e ativo corretos.
  2. Cadastre parcelas com vencimento, valor e cliente derivados do contrato.
  3. Use Recebiveis para filtrar parcelas por cliente, loja, status e periodo.
  4. Registre pagamento somente quando houver confirmacao interna ou evento bancario simulado conciliado.
  5. Cancele pagamento apenas quando houver erro operacional; a parcela sera reaberta com controle quando for seguro.

Conferir antes de concluir

  • Pagamento vinculado so fecha parcela aberta ou em atraso.
  • Contrato nao deve ser finalizado quando ainda houver parcela aberta ou atrasada.
  • Pix, boleto, cartao e transferencia reais permanecem bloqueados ate credenciais, sandbox e decisao formal.

Cliente final e visitante publico

Portal de Pagamento e Loja Digital

Permitir consulta simples pelo navegador sem expor dados internos ou financeiros sensiveis.

Ativo

Passo a passo

  1. No Portal de Pagamento, o cliente consulta parcelas pelo proprio documento.
  2. Quando a parcela estiver aberta, o portal pode gerar segunda via simulada e orientar o proximo passo.
  3. Quando a parcela estiver paga, o portal informa que nao ha nova cobranca a gerar.
  4. Na Loja Digital, visitantes consultam veiculos e imoveis publicados com dados publicos seguros.

Conferir antes de concluir

  • Nunca tratar link simulado como comprovante bancario real.
  • Nao divulgar documentos internos, valor de compra, margem, auditoria ou observacoes internas na Loja Digital.
  • Mensagens do portal devem ser simples e explicar o proximo passo sem termo tecnico.

Cobranca, juridico e supervisao

Cobranca e juridico internos

Registrar contatos, acordos, escalonamentos e notas internas sem disparo automatico externo.

Ativo

Passo a passo

  1. Abra Cobranca para ver parcelas em atraso, risco, proxima acao e acordos ativos.
  2. Registre contato, acordo ou escalonamento vinculado a parcela correta.
  3. Abra Juridico para acompanhar acoes internas e registrar nota juridica quando autorizado.
  4. Use Auditoria para revisar quem criou ou alterou registros de cobranca e juridico.

Conferir antes de concluir

  • Estrategia juridica e comentario interno nao devem aparecer para o cliente da plataforma.
  • Nenhum envio externo de cobranca acontece automaticamente nesta fase.
  • Acordo interno nao substitui contrato, gateway ou comprovante bancario real.

Financeiro e Back Office

Relatorios, repasses e antecipacao

Conferir saldos, repasses, simulacoes e indicadores antes de qualquer integracao financeira real.

Ativo

Passo a passo

  1. Use Relatorios para comparar aberto, atraso, pago, links e percentual de atraso por loja.
  2. Use Repasses para gerar lotes semanais internos com itens rastreados por pagamento confirmado.
  3. Use Antecipacao para simular solicitacao, limites e revisao interna sem liberar dinheiro real.
  4. Use Simulador de Split antes de ajustar politica comercial ou custo de fornecedor.

Conferir antes de concluir

  • Lotes de repasse exibem lastro interno, mas nao executam transferencia bancaria real.
  • Aprovacao de antecipacao registra decisao interna e mantem dinheiro real bloqueado.
  • Relatorios e CSV respeitam empresa ativa e registram auditoria quando exportam dados.

Time interno Paglog One

Back Office, permissoes e auditoria

Criar tenants, administrar planos, acompanhar pilotos e preservar rastreabilidade.

Ativo

Passo a passo

  1. Use Back Office para criar empresa, assinatura, perfis padrao e admin local de homologacao.
  2. Gerencie planos, suporte interno, empresas recentes e acompanhamento de pilotos pelo Back Office.
  3. Use Seguranca para perfis, permissoes por modulo/acao e senha local de usuario autorizado.
  4. Use Auditoria para filtrar por empresa, area, periodo, status, busca e usuario/e-mail.

Conferir antes de concluir

  • Back Office deve ser usado apenas por contas internas autorizadas.
  • Cliente da plataforma nao deve ver custo interno, margem, dados de outros tenants ou logs tecnicos.
  • CSV de auditoria e relatorios exige sessao, escopo correto e protecao contra formula em planilha.

Claudia, CTO e financeiro

Homologacao financeira guiada

Ensaiar cobranca, evento recebido, baixa, split, extrato e comprovante antes de ligar fornecedor real.

Ativo

Passo a passo

  1. Abra Homologacao Financeira e confirme que a trava de gateway real continua bloqueada.
  2. Execute o roteiro com gateway simulado para conferir link, evento, baixa, split, extrato e comprovante.
  3. Confira Conciliacao e Webhooks para revisar eventos internos e reprocessamento seguro.
  4. Somente depois de escolher fornecedor piloto, configure credenciais fora do Git e homologue sandbox ou valor baixo.

Conferir antes de concluir

  • Nao habilitar gateway real sem decisao formal, credenciais corretas e webhook cadastrado no painel externo.
  • Nao registrar segredo em codigo, docs, migrations, seeds, logs ou commits.
  • Se um evento real falhar, use reprocessamento interno e registre auditoria antes de qualquer acao manual.

Checklist final de publicacao

Itens que separam o que esta pronto no Paglog One do que depende de decisao, credencial ou operacao real.

Ativo
ItemEvidenciaProximo passo
DeployAtivo

Aplicacao publicada no VPS

Pronto

Container, Caddy, base path /paglog-one, healthcheck e paginas principais validados.

Manter validacao de health, status, backlog e logs apos cada deploy.

SegurancaAtivo

Tenant, permissoes e RLS

Pronto

Empresa ativa, perfis, permissoes server-side, auditoria tenant-safe e fallback por flag publicados.

Desligar demo e fallback de homologacao quando usuarios reais e tenant definitivo forem confirmados.

FinanceiroAtivo

Dinheiro real bloqueado

Pronto

Gateway real, Pix real, transferencia real e antecipacao real ficam bloqueados por feature flag e decisao externa.

Liberar somente depois de fornecedor piloto, credenciais, sandbox/valor baixo e decisao formal.

AuditoriaAtivo

CSV e auditoria controlados

Pronto

Auditoria, recebiveis e relatorios exportam CSV com sessao, escopo e protecao contra formula.

Usar filtros por usuario, loja, status e periodo nos pilotos reais.

Back OfficeAtivo

Acompanhamento de pilotos

Pronto

Back Office acompanha clientes piloto, suporte, faturas, parcelas, links e proximo contato.

Registrar acompanhamentos reais de homologacao pela fila interna.

OperacaoAtivo

Manual e checklist final

Pronto

Manual operacional publicado no app e versionado em docs/MANUAL_USUARIO.md.

Usar este roteiro nos primeiros treinamentos e revisar copy com usuarios reais.

ProdutoPendente

Especificacao consolidada v0.5

Decisao externa

Arquivo no VPS ainda esta como placeholder aguardando conteudo final.

Substituir o placeholder quando a especificacao completa for entregue.

FornecedorPendente

Gateway piloto e credenciais

Decisao externa

As rotas e adaptadores existem, mas falta escolher fornecedor e configurar credenciais fora do Git.

Configurar Asaas como piloto e cadastrar somente o webhook Asaas no painel externo.

DevOpsPendente

Dominio final e GitHub remoto

Decisao externa

O app roda em /paglog-one; GitHub CLI ainda depende de autenticacao local do responsavel.

Confirmar se mantem rota atual ou subdominio, autenticar gh e publicar repositorio privado.

OperacaoEm breve

Monitoramento de homologacao

Monitorar

Status, backlog, health, guardrail de recursos e logs do container estao disponiveis.

Continuar checando recursos antes de comandos pesados e revisar logs apos deploy.