Administração do Sistema

Disponível em:

• Post Affiliate Pro
• Post Affiliate Pro Ultimate
• Post Affiliate Network

Visão Geral da Administração do Sistema

Administração eficaz do sistema é essencial para manter um programa de afiliados de alto desempenho. O Post Affiliate Pro fornece ferramentas abrangentes para gerenciar tarefas agendadas, cache, logging, otimização de banco de dados e manutenção do sistema. Entender esses recursos ajuda a garantir que seu software de afiliados funcione suavemente e eficientemente.

Tarefas Agendadas e Cron Jobs

Como Cron Jobs Funcionam

O Post Affiliate Pro usa um sistema de agendamento de tarefas que processa jobs em background automaticamente. O ponto de entrada principal é o script jobs.php, que deve ser chamado regularmente pelo daemon cron do seu servidor.

O executor de tarefas executa tarefas pendentes dentro de um período de tempo configurável, tipicamente rodando pela duração do intervalo do cron menos um pequeno buffer. Tarefas que não podem ser completadas em um ciclo de execução são automaticamente retomadas na próxima execução.

Configurando Cron Jobs

Para configurar cron jobs para sua instalação:

1. Acesse seu servidor via SSH ou painel de controle de hospedagem
2. Adicione uma entrada de cron para executar o script de jobs:

* * * * * /usr/local/bin/php -q /caminho/para/sua/instalacao/scripts/jobs.php

Isso executa o processador de tarefas a cada minuto, que é a configuração recomendada. O sistema automaticamente calcula por quanto tempo cada execução deve rodar baseado no seu intervalo de cron configurado.

Opções de Configuração de Cron

No painel do comerciante em Ferramentas, você pode configurar:

• Intervalo de execução do cron - Com que frequência seu cron job executa (padrão: 1 minuto)
• Contagem de jobs paralelos - Número de workers de tarefas concorrentes para instalações de alto tráfego

O sistema monitora execução de cron e exibe um aviso se tarefas não foram processadas recentemente. Você também pode acionar manualmente execução de tarefas do painel admin para fins de teste.

Inclusão e Exclusão de Tarefas

Para configurações avançadas, você pode executar tarefas específicas ou excluir certas tarefas:

php jobs.php --include TaskClassName1 TaskClassName2
php jobs.php --exclude TaskClassName1 TaskClassName2

Isso é útil para distribuir carga de trabalho entre múltiplos workers de cron ou isolar tarefas problemáticas.

Gerenciamento de Cache

Sistema de Cache

O Post Affiliate Pro utiliza Redis para cache de alto desempenho, que melhora significativamente tempos de resposta para dados acessados frequentemente. O sistema de cache armazena:

• Dados de sessão de usuário
• Configurações
• Dados de afiliados e campanhas para rastreamento
• Associações de visitante-afiliado

Configuração de Cache

Configurações de cache são definidas no arquivo de configuração da sua instalação. O sistema suporta:

• Hosts Redis de cache - Endereços de servidor Redis para cache
• Hosts Redis de rastreamento - Configuração Redis separada para dados de rastreamento
• Configuração de porta - Configurações de porta personalizadas para conexões Redis

Limpeza de Cache

Ao fazer alterações de configuração ou solucionar problemas, você pode precisar limpar dados em cache. O sistema fornece opções para:

• Limpar entradas de cache específicas
• Esvaziar todo o cache
• Invalidação automática de cache quando configurações mudam

Para caches relacionados a rastreamento como links diretos e configurações de mod rewrite, limpe o cache após fazer alterações de configuração para garantir que novas configurações entrem em vigor imediatamente.

Configuração de Log de Debug

Níveis de Log

O Post Affiliate Pro fornece logging configurável para ajudar a diagnosticar problemas. Níveis de log disponíveis incluem:

• Erro (40) - Apenas erros críticos (padrão)
• Aviso (30) - Erros e avisos
• Info (20) - Mensagens de informação geral
• Debug (10) - Informações detalhadas de debugging

Níveis de verbosidade mais altos geram mais entradas de log, o que pode impactar desempenho. Use logging de debug apenas ao solucionar problemas específicos.

Modo Debug

Para diagnósticos detalhados de rastreamento, você pode habilitar modo debug que registra:

• Detalhes de processamento de cliques e impressões
• Informações de rastreamento de vendas e leads
• Detalhes de requisições de API
• Condições de erro e seu contexto

Modo debug desabilita automaticamente após uma hora para prevenir degradação de desempenho e crescimento de arquivos de log. A configuração de tipos de debug permite especificar quais categorias de eventos registrar (ex.: ações, banners, erros).

Gerenciamento de Log de Eventos

O sistema limpa automaticamente entradas antigas de log de eventos baseado na sua configuração:

• Excluir eventos após X dias - Remove entradas de log mais antigas que dias especificados (padrão: 7 dias)
• Máximo de registros de eventos - Mantém apenas o número especificado de registros mais recentes (padrão: 500.000)

Essas configurações ajudam a manter desempenho do banco de dados enquanto retêm dados históricos suficientes para solução de problemas.

Limpeza de Histórico de Login

Registros de histórico de login são automaticamente purgados após um número configurável de dias (padrão: 30 dias). Isso ajuda a manter o tamanho do banco de dados enquanto preserva informações recentes de auditoria de segurança.

Modo de Manutenção

Entendendo Modo de Manutenção

Modo de manutenção suspende temporariamente operações normais da aplicação durante upgrades ou manutenção crítica. Quando habilitado:

• Processamento de tarefas é pausado
• Requisições de API retornam HTTP 503 (Serviço Indisponível)
• Usuários veem uma notificação de manutenção
• Rastreamento continua a enfileirar dados para processamento posterior

Endpoints Isentos

Certos endpoints permanecem acessíveis durante manutenção:

• Endpoints de health check (/health, /health-check)
• Endpoints de documentação
• Especificação OpenAPI

Isso permite que sistemas de monitoramento verifiquem o status da aplicação mesmo durante janelas de manutenção.

Manutenção Automática

O sistema entra em modo de manutenção automaticamente durante:

• Upgrades de versão
• Migrações de banco de dados
• Revalidação de licença

Uma vez que a operação de manutenção completa, operação normal resume automaticamente.

Status e Otimização do Banco de Dados

Plugin Database Status

O plugin Database Status fornece visibilidade na saúde do seu banco de dados. Após ativação, navegue até Ferramentas > Status do Banco de Dados para visualizar:

• Nomes e tamanhos de tabelas
• Contagem de linhas para cada tabela
• Informações de índice
• Detalhes de engine de armazenamento

Operações de Banco de Dados

O plugin suporta várias operações de manutenção:

• Analisar Tabela - Atualiza estatísticas de tabela para otimização de queries
• Otimizar Tabela - Desfragmenta tabelas e recupera espaço não utilizado
• Reparar Tabela - Corrige estruturas de tabela corrompidas

Execute essas operações durante períodos de baixo tráfego pois podem temporariamente bloquear tabelas.

Requisitos do Plugin

O plugin Database Status requer que seu usuário de banco de dados tenha privilégios SELECT na tabela de sistema INFORMATION_SCHEMA.TABLES. Se a ativação falhar, verifique essas permissões com seu administrador de banco de dados.

Limpeza Automática de Dados

O Post Affiliate Pro gerencia automaticamente retenção de dados para desempenho ideal:

• Cliques brutos - Excluídos após dias configuráveis (padrão: 185 dias)
• Visitantes expirados - Limpos automaticamente
• Logs de visita e venda - Removidos após dias especificados (padrão: 60 dias)
• Registros de email antigos - Purgados após meses configuráveis (padrão: 2 meses)

Requisitos de Sistema

Requisitos de PHP

• PHP 8.0 ou superior
• Extensão PDO MySQL
• Biblioteca GD (para captcha e processamento de imagens)
• Extensão bcmath (para algoritmos de limitação de taxa)
• Extensão hash com suporte SHA-256
• Standard PHP Library (SPL)
• Função filter_var habilitada
• Mínimo 128MB de limite de memória

Funções PHP Requeridas

As seguintes funções devem estar habilitadas:

• tempnam
• mkdir
• imagettftext
• imagejpeg
• base64_decode
• mime_content_type

Requisitos de MySQL

• MySQL 5.7 ou superior (MySQL 8.0 recomendado)
• Conjunto de caracteres utf8mb4
• Collation utf8mb4_unicode_ci
• Driver PDO MySQL

Configuração de Sessão

• session.auto_start deve estar desabilitado
• session.save_path deve ser um caminho absoluto (não relativo)

Sistema de Arquivos

• Diretório de configuração deve ter permissão de escrita pelo servidor web
• Capacidade de criar arquivos e subdiretórios dentro do diretório accounts

Ajuste de Desempenho

Processamento de Visitas

Otimize processamento de visitas para seu volume de tráfego:

• Processamento offline - Processe visitas assincronamente para sites de alto tráfego
• Processamento online de vendas - Habilite para rastreamento imediato de comissões
• Workers multi-processador - Configure até 8 workers paralelos para visitas e impressões

Processamento de Estatísticas

O processador de estatísticas de vendas consolida dados de transação em intervalos configuráveis:

• Intervalo de processamento - Com que frequência stats são recalculadas (padrão: 15 minutos)
• Retenção de stats por hora - Dias para manter estatísticas horárias detalhadas
• Para impressões e cliques: padrão 365 dias
• Para vendas: padrão 180 dias

Desempenho de Grid

Configure limites de grid de dados para equilibrar usabilidade com desempenho:

• Limite de linhas - Máximo de linhas retornadas em grids (padrão: 500)
• Limite de exportação - Máximo de linhas para exportações CSV (padrão: 500)
• Limite de condições - Máximo de condições de filtro (padrão: 1000)

Throttling de Email

Controle taxas de envio de email para evitar sobrecarregar servidores de email:

• Emails de afiliados por minuto - Limite emails em massa para afiliados (padrão: 30)
• Emails do sistema por minuto - Máximo de notificações automatizadas (padrão: 10)

Interrupção de Tarefas

Configure comportamento de tarefas para operações de longa duração:

• Tempo de sleep de interrupção - Pausa entre segmentos de tarefas
• Tempo máximo de execução de tarefa - Timeout para tarefas travadas (15 minutos)

Tarefas automaticamente fazem checkpoint de seu progresso, permitindo retomada sem problemas se interrompidas.

Considerações de Backup

O Que Fazer Backup

Um backup completo inclui:

1. Banco de Dados MySQL

   • Todas as tabelas do Post Affiliate Pro
   • Dados de usuários, transações e configurações
   • Informações de campanhas e banners

2. Sistema de Arquivos

   • Arquivos de configuração no diretório accounts
   • Banners e materiais promocionais enviados
   • Temas e templates personalizados
   • Configurações de plugins

Melhores Práticas de Backup

• Agende backups automatizados regulares
• Armazene backups em localização separada do seu servidor
• Teste restauração de backup periodicamente
• Documente seus procedimentos de backup e recuperação
• Considere recuperação point-in-time para instalações críticas

Instalações Hospedadas

Para instalações hospedadas do Post Affiliate Pro, backups são gerenciados automaticamente pela infraestrutura de hospedagem. Entre em contato com o suporte para solicitações específicas de backup e restauração.

Considerações de Segurança

Restrições de IP

Configure controles de acesso baseados em IP para:

• Logins do painel admin
• Cadastros de afiliados
• Acesso à API

Limitação de Taxa

Proteja contra abusos com limites de taxa configuráveis:

• Tentativas de login por username/IP (padrão: 10 por hora)
• Tentativas de cadastro (padrão: 10 por hora)
• Envios de formulário de contato (padrão: 10 por hora)

Segurança de Sessão

• Sessões expiram após timeout configurável
• Sessões antigas são automaticamente limpas
• Armazenamento de sessão com Redis para alta disponibilidade

Monitoramento e Solução de Problemas

Health Checks

Monitore saúde do sistema através de:

• Status de execução do cron job
• Profundidade da fila de tarefas
• Status de conexão do banco de dados
• Disponibilidade de cache

Problemas Comuns

Cron não está executando:

• Verifique se a entrada de cron está configurada corretamente
• Confirme que o caminho do PHP está correto
• Garanta que scripts/jobs.php está executável

Alto uso de banco de dados:

• Habilite limpeza automática de dados
• Execute otimização de tabelas
• Revise logs de queries lentas

Problemas de cache:

• Verifique conectividade do Redis
• Confirme alocação de memória do Redis
• Limpe cache e reinicie se necessário

Para assistência adicional de solução de problemas, acesse o portal de suporte ou entre em contato com o suporte técnico.