Previa por perfil
Abra a mesma plataforma pela visao de cada usuario.
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.
Guias
8Fluxos principaisChecklist
10Publicacao e homologacaoProntos
6Feitos pelo CodexExternos
3Decisao ou credencialMonitorar
1Rotina do VPSComo 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.
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.
Passo a passo
- Entre pelo login liberado pela Yatta ou pelo acesso demo de homologacao.
- Confira no topo se a empresa ativa esta correta antes de cadastrar ou alterar dados.
- Abra Inicio para acessar os atalhos principais e use Ajuda quando precisar de orientacao curta.
- 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.
Passo a passo
- Cadastre lojas antes de criar contratos para separar operacao por unidade.
- Cadastre clientes PF ou PJ com documento correto e mantenha dados de contato atualizados.
- Cadastre veiculos e imoveis vinculando o cliente correto quando houver proprietario relacionado.
- Use Abrir para revisar detalhes, editar dados e acompanhar o historico operacional do registro.
- 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.
Passo a passo
- Crie contrato somente para cliente ativo da empresa e, quando aplicavel, loja e ativo corretos.
- Cadastre parcelas com vencimento, valor e cliente derivados do contrato.
- Use Recebiveis para filtrar parcelas por cliente, loja, status e periodo.
- Registre pagamento somente quando houver confirmacao interna ou evento bancario simulado conciliado.
- 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.
Passo a passo
- No Portal de Pagamento, o cliente consulta parcelas pelo proprio documento.
- Quando a parcela estiver aberta, o portal pode gerar segunda via simulada e orientar o proximo passo.
- Quando a parcela estiver paga, o portal informa que nao ha nova cobranca a gerar.
- 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.
Passo a passo
- Abra Cobranca para ver parcelas em atraso, risco, proxima acao e acordos ativos.
- Registre contato, acordo ou escalonamento vinculado a parcela correta.
- Abra Juridico para acompanhar acoes internas e registrar nota juridica quando autorizado.
- 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.
Passo a passo
- Use Relatorios para comparar aberto, atraso, pago, links e percentual de atraso por loja.
- Use Repasses para gerar lotes semanais internos com itens rastreados por pagamento confirmado.
- Use Antecipacao para simular solicitacao, limites e revisao interna sem liberar dinheiro real.
- 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.
Passo a passo
- Use Back Office para criar empresa, assinatura, perfis padrao e admin local de homologacao.
- Gerencie planos, suporte interno, empresas recentes e acompanhamento de pilotos pelo Back Office.
- Use Seguranca para perfis, permissoes por modulo/acao e senha local de usuario autorizado.
- 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.
Passo a passo
- Abra Homologacao Financeira e confirme que a trava de gateway real continua bloqueada.
- Execute o roteiro com gateway simulado para conferir link, evento, baixa, split, extrato e comprovante.
- Confira Conciliacao e Webhooks para revisar eventos internos e reprocessamento seguro.
- 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.
| Item | Evidencia | Proximo 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. |