Painel Financeiro ASV

Onde encontrarInstalação → Licença ASV

1. O painel e o tema oficial aceitam PHP 8.3 ou superior. A instalação protegida atual do AstraGuard exige PHP 8.4 NTS, preparado automaticamente pelo instalador.

2. Use MySQL e configure a pasta public como raiz pública do domínio.

3. Preencha a conexão do banco e os dados solicitados pelo instalador sem publicar o arquivo de ambiente.

4. Informe a licença, conclua a verificação e confirme que o painel abre sem mensagens de indisponibilidade.

5. Configure o agendador do Laravel para executar a cada minuto; ele processa cobranças, avisos e rotinas automáticas.

6. Em hospedagem compartilhada, mantenha storage gravável e use o comando PHP CLI indicado na tela de Automações.

Onde encontrarConfigurações → Empresa

1. Informe nome, documento, e-mail, telefone e demais dados comerciais da empresa.

2. Escolha a cor principal e confira a prévia de contraste antes de salvar.

3. Envie logo grande, logo pequena, favicon e mascote nos formatos aceitos.

4. Revise o resultado no site público, no painel administrativo, na área do cliente e no checkout.

5. Mantenha todos os elementos de marca centralizados nessa tela para que módulos e plugins herdem o mesmo visual.

Onde encontrarConfigurações → Empresa / Suporte → Equipe

1. Personalize o caminho administrativo e guarde o novo endereço antes de encerrar a sessão.

2. Crie cada administrador com uma conta individual; não compartilhe o acesso do proprietário.

3. Atribua permissões por área para clientes, pedidos, financeiro, produtos, suporte e configurações.

4. Use a suspensão para bloquear um membro sem remover o histórico de suas ações.

5. Revise sessões, bloqueios e atividades quando houver troca de equipe ou suspeita de acesso indevido.

Onde encontrarConfigurações → Comunicação e suporte

1. Informe o e-mail de suporte e configure host, porta, criptografia, usuário e senha do SMTP.

2. Envie um teste pela própria tela e só continue depois da confirmação.

3. Personalize os modelos mantendo os campos dinâmicos exigidos por cada mensagem.

4. Confira remetente, resposta e aparência em um endereço real antes de iniciar as vendas.

5. Use os logs de e-mail para diferenciar falha de envio, rejeição do provedor e endereço inválido.

Onde encontrarClientes → Gerenciar clientes

1. Crie o cliente manualmente ou permita o cadastro pela área pública.

2. Revise nome, documento, endereço, telefone e e-mail antes de emitir cobranças ou registrar domínios.

3. Use o perfil para consultar serviços, faturas, mensagens e alterações da conta no mesmo lugar.

4. Suspenda o cliente quando precisar bloquear o acesso sem apagar pedidos, pagamentos ou histórico.

Onde encontrarProdutos → Planos de produtos

1. Crie um grupo com nome, descrição, ordem e visibilidade pública.

2. Adicione o produto, escolha seu tipo e defina preço, ciclo, descrição e disponibilidade.

3. Use campos do produto para pacote e limites vendidos; use campos do pedido para escolhas feitas pelo comprador.

4. Quando houver integração, selecione o módulo e uma conexão testada e ativa.

5. Abra a prévia da contratação e confirme resumo, valor, campos obrigatórios e fluxo de checkout.

Onde encontrarPedidos / Financeiro → Assinaturas

1. O pedido registra a contratação; a fatura controla o pagamento; a assinatura representa o serviço recorrente.

2. Pagamento confirmado não significa que o recurso externo já foi criado.

3. Acompanhe o estado de provisionamento e use a nova tentativa administrativa somente após corrigir a causa da falha.

4. Quando existir um identificador externo, o painel consulta o serviço antes de tentar criá-lo novamente.

5. Para cancelar, encerre primeiro o recurso remoto e preserve fatura, pagamento e histórico do pedido.

Onde encontrarFinanceiro → Faturas / Configurações → Pagamentos

1. Defina moeda, vencimentos e ciclos disponíveis; mensal permanece o ciclo padrão.

2. Ative semanal, trimestral, semestral, anual ou pagamento único somente nos produtos compatíveis.

3. Cadastre cupons com validade, limite e produtos elegíveis para evitar descontos fora do planejado.

4. A baixa automática deve vir do webhook ou da consulta validada do gateway.

5. Use a fatura para conferir itens, tentativas, forma escolhida, vencimento e comprovantes.

Onde encontrarConfigurações → Afiliados

1. Ative o programa e defina regras de comissão coerentes com sua margem.

2. Acompanhe cada indicação até a confirmação do pagamento elegível.

3. Ajustes de saldo e bloqueios devem ser feitos pela ação administrativa registrada.

4. Analise a solicitação e os dados do recebedor antes de aprovar um saque.

Onde encontrarConfigurações → Módulos → Gateways de pagamento

1. Escolha o provedor, confira ambiente de teste ou produção e preencha somente as credenciais solicitadas.

2. Salve a configuração; o módulo continuará inativo e não testado até a validação.

3. Execute o teste de conexão e ative o gateway somente depois da confirmação.

4. Cadastre a URL de webhook exibida pelo painel na conta do provedor.

5. Faça uma cobrança de baixo valor e confirme criação, retorno, baixa e idempotência antes de vender.

Onde encontrarConfigurações → Módulos → Gerenciamento

1. Abra o módulo compatível com seu provedor e leia as orientações exibidas no cartão.

2. Cadastre host, porta, protocolo, usuário e credencial com permissão mínima suficiente.

3. Salve, teste e ative a conexão; uma alteração posterior exige novo teste.

4. No produto, escolha módulo, conexão e campos específicos do plano.

5. Faça uma contratação de teste e valide criação, sincronização, ações do cliente, suspensão e encerramento.

Onde encontrarMódulo → Conexões de provisionamento

1. Mantenha a conexão principal ou adicione um servidor com nome fácil de reconhecer.

2. Teste e ative cada conexão separadamente.

3. Escolha Servidor / conexão no cadastro do produto.

4. O serviço contratado guarda a conexão usada na criação e continua nela mesmo após mudanças no produto.

5. Desative uma conexão para impedir novas vendas; conexões em uso não devem ser removidas.

Onde encontrarConfigurações → Módulos → Domínios

1. Escolha Registro.br, eNom, GoDaddy, ResellerClub ou outro módulo disponível.

2. Preencha a credencial e requisitos específicos, como IP autorizado ou ambiente de testes.

3. Teste e ative o registrador antes de importar extensões e preços.

4. Revise valores de registro, transferência e renovação antes de publicar a pesquisa.

5. Faça um teste completo, incluindo consulta, registro e alteração de nameservers.

Onde encontrarProdutos → Upgrades / Configurações → Automações

1. Crie grupos de upgrade somente entre planos do mesmo tipo e módulo compatível.

2. Defina recursos adicionais com unidade, valor e limites permitidos pelo provedor.

3. Conexões diferentes não devem ser tratadas como upgrade; use migração explícita entre servidores.

4. Configure geração de faturas, avisos, suspensão e encerramento conforme a política comercial.

5. Confirme na saúde do agendador que a execução ocorre no intervalo esperado.

Onde encontrarÁrea do cliente → Meus serviços → Gerenciar serviço

1. O cliente consulta assinatura, renovação, valor e situação financeira em Meus serviços.

2. Ao gerenciar, o ASV escolhe a apresentação pelo contrato do módulo: hospedagem, VPS, jogos ou serviço geral.

3. Somente dados normalizados e autorizados aparecem; tokens e payloads do provedor permanecem protegidos.

4. Ações como reiniciar, acessar painel, console ou trocar senha aparecem apenas quando declaradas e implementadas.

5. Dados externos são atualizados em segundo plano para a primeira abertura não depender da API.

Onde encontrarConfigurações → Empresa

1. Altere a cor principal pela configuração compartilhada, sem editar cores diretamente nas páginas.

2. Use logos com boa leitura em fundos claros e escuros e um favicon quadrado.

3. Módulos e plugins devem herdar as variáveis de marca; cores próprias servem apenas para representar o provedor.

4. Confira contraste, foco, textos longos, celular e ampliação de fonte antes de publicar.

Onde encontrarConfigurações → Empresa → Template do site público

1. Copie o tema base para templates/<slug> e mantenha o nome da pasta em letras minúsculas e hífens.

2. Crie template.json com slug, nome, versão, autor, tipo, páginas e folhas de estilo.

3. Mantenha views em views/, arquivos públicos em assets/ e declare até cinco CSS no manifesto.

4. Use layouts.app, componentes landing:: e rotas nomeadas; nunca consulte banco ou API na view.

5. Incremente a versão ao alterar assets, selecione o tema na Empresa e teste todas as páginas públicas.

Onde encontrarSuporte → Tickets / Equipe / Categorias

1. Crie categorias claras e atribua permissões de atendimento à equipe.

2. Responda dentro do ticket para manter mensagens e anexos ligados ao cliente.

3. Use prioridade e situação para organizar a fila; feche apenas quando a solicitação estiver resolvida.

4. Mensagens de erro ao cliente devem ser curtas e seguras; detalhes técnicos ficam nos logs administrativos.

Onde encontrarmodulos/gerenciamento/<slug>

1. Crie uma pasta kebab-case com module.php, README.md, config/settings.php e src/Client.php.

2. No manifesto, declare client_class, service_contract, client_service, service_fields e order_fields.

3. Implemente ProvisioningModule e a interface do contrato: HostingServiceModule, VpsServiceModule, GameServiceModule ou GeneralServiceModule.

4. Implemente provision, serviceExists e terminate de forma idempotente; grave a referência remota somente pelo retorno do provisionamento.

5. Implemente serviceDetails, servicePresentation e serviceAction retornando dados estruturados e capacidades reais.

6. Use HTTPS, timeouts, validação TLS, credenciais criptografadas e IntegrationApiLogger no canal management_api.

7. Teste conexão, criação, repetição segura, sincronização, ações, suspensão, upgrade e encerramento antes de ativar.

Onde encontrarservice_contract + ClientServiceModule

1. Use asv.hosting-service para hospedagem, asv.vps-service para VPS, asv.game-service para jogos ou asv.general-service para outros serviços.

2. Declare somente capacidades implementadas, como start, stop, restart, console, password, sso, nameservers ou ações gerais seguras.

3. Para serviço geral, componha seções grid ou list e itens detail, metric, progress, badge e action.

4. Nunca envie HTML, JavaScript, CSS, token, segredo, URL arbitrária ou payload bruto na apresentação.

5. Adicione um novo normalizador compartilhado apenas quando criar um novo tipo de contrato; provedores do mesmo tipo não alteram a Blade central.

Onde encontrarmodulos/gateways/<slug>

1. Crie module.php, README.md, config/settings.php e src/Client.php dentro da pasta do gateway.

2. Declare métodos de checkout, moedas compatíveis, política de URL segura, client_class e webhook quando houver.

3. Mantenha credenciais em campos secret com prefixo gateway_<slug>_ e nunca as envie ao navegador.

4. Implemente teste de conexão, criação de checkout e confirmação de pagamento conforme o cliente consumido pelo PaymentGatewayService.

5. Valide assinatura do webhook, valor, moeda, referência e estado; processe repetições de forma idempotente.

6. Teste sandbox e produção separadamente, inclusive cancelamento, expiração e retorno tardio.

Onde encontrarmodulos/dominios/<slug>

1. Crie manifesto, configuração e cliente dentro da pasta exclusiva do registrador.

2. Implemente DomainRegistrarModule com testConnection, listTlds, getPricing e checkAvailability.

3. Quando houver venda e gerenciamento, implemente também provisionamento, renovação, nameservers e painel do serviço pelas capacidades declaradas.

4. Use o prefixo domain_<slug>_ nas configurações e consulte dados de CPF, CNPJ e e-mail já preparados pelo cadastro autorizado.

5. Normalize respostas e mantenha códigos ou mensagens brutas do registrador apenas nos logs protegidos.

6. Teste disponibilidade, preço, registro, renovação e mudança de DNS em ambiente oficial de testes quando disponível.

Onde encontrarplugins/<slug>

1. Crie plugin.json, README.md e src/Plugin.php em uma pasta kebab-case.

2. No manifesto, declare schema_version, slug, nome, descrição, versão semântica, autor, categoria, recursos, requisitos e bootstrap.

3. A classe de inicialização deve implementar AsvPlugin e fornecer register e boot.

4. Use register para bindings e serviços; use boot para listeners, rotas e namespaces de views depois da inicialização.

5. Salve opções com prefixo plugin_<slug>_ e criptografe segredos.

6. O proprietário ativa o plugin em Configurações → Plugins; falhas devem ficar isoladas sem derrubar o painel.

Onde encontrarplugin.json → admin_route / Plugin::boot()

1. Crie o controller e a Blade dentro do próprio plugin e registre um namespace de view exclusivo com View::addNamespace.

2. No boot, registre rotas nomeadas sob admin_base_path(), nunca usando /admin fixo.

3. Proteja as rotas com web, auth.admin, access.ban:admin e track.admin.session; acrescente owner.admin quando a ação exigir o proprietário.

4. Declare o nome da rota de entrada em admin_route no plugin.json para o botão Configurar abrir a tela.

5. Na Blade, reutilize layouts.app, a sidebar administrativa, o rodapé compartilhado, ícones Lucide, variáveis de marca e admin-ui.js.

6. Ações mutáveis usam POST, CSRF, validação no servidor e mensagens laterais do padrão toast-stack.

Onde encontrarPlugins → Assistente ASV

1. Conecte Codex ou Claude no Licenciador e confirme no painel que a conta está disponível.

2. Escolha a área permitida: catálogo, temas ou módulos de gerenciamento.

3. Selecione modelo e esforço, descreva a mudança e anexe imagens quando ajudarem a explicar o resultado.

4. Revise a proposta antes de aplicar; ações fora do escopo continuam bloqueadas.

5. A autorização temporária para edição de temas e módulos vale pelo período definido e pode ser revogada.

Onde encontrarConfigurações → Logs gerais

1. Filtre atividades, acessos, e-mails, pagamentos e módulos pelo período e tipo.

2. Em falhas de API, confira módulo, operação, horário e resposta já mascarada.

3. Corrija credencial, permissão, endereço, porta, certificado ou indisponibilidade antes de repetir a ação.

4. Não copie tokens, senhas, documentos ou payloads sensíveis para tickets públicos.

5. Preserve o último snapshot válido do serviço enquanto a integração estiver temporariamente indisponível.

Onde encontrarImportação WHMCS

1. Gere um backup MySQL completo e use sempre o mesmo nome para a instalação de origem.

2. Envie o arquivo dentro do limite indicado pelo servidor e aguarde a análise privada.

3. Revise clientes, grupos, produtos e vínculos detectados antes de selecionar.

4. Importe em lotes coerentes e confira totais, relacionamentos e avisos após cada execução.

5. Aumente upload_max_filesize e post_max_size no PHP quando o backup ultrapassar o limite atual.

Onde encontrarInformações do sistema → Atualizações

1. Faça backup do banco, storage e arquivo de ambiente antes de iniciar.

2. Confirme requisitos de PHP, espaço e permissões e leia as notas da versão.

3. Aplique a atualização pelo fluxo oficial e execute as migrations previstas.

4. Confira login, catálogo, checkout, agendador, pagamentos e um serviço integrado.

5. Em falha, use o backup e o procedimento de reversão preparado antes da mudança.

Onde encontrarRevisão final

1. Empresa, marca, moeda, e-mail, política, termos e contatos estão preenchidos.

2. Produto, preço, ciclo, campos, estoque, módulo e conexão estão corretos.

3. Gateway, webhook, agendador e envio de e-mail foram testados.

4. Cadastro, login, checkout, pagamento, provisionamento e gerenciamento funcionam em uma conta de teste.

5. Cancelamento, falha de API e tentativa repetida preservam fatura, pagamento e histórico.

6. Desktop e celular não apresentam texto cortado, sobreposição ou rolagem horizontal indevida.