PALPANEL — PAINEL SAAS COMPLETO PARA SERVIDORES PALWORLD

Descrição do item

PalPanel é um painel de administração web completo e pronto para monetizar, feito para donos de servidores dedicados de Palworld. Não é um script solto nem um bot de Discord: é uma plataforma SaaS multi-tenant, com assinatura via Stripe, login social, controle de acesso por permissão, monitoramento em tempo real, automação por cron e até um marketplace de Pals entre os players do servidor. Tudo em português, com interface moderna e 136 testes automatizados cobrindo o backend.

O produto sai da caixa funcionando como negócio, não só como ferramenta: landing page com pixel de conversão, cadastro, trial de 3 dias sem cartão, checkout recorrente, portal de gerenciamento de assinatura e histórico de pagamentos — tudo já implementado.

NÚMEROS DO PROJETO

• Cerca de 33.500 linhas de código (TypeScript, TSX e SQL)
• 194 arquivos de código
• 136 testes automatizados (Vitest + Supertest)
• Mais de 80 endpoints REST
• 11 migrations de banco versionadas
• 25 telas no painel
• 129 opções do PalWorldSettings.ini mapeadas
• 24 conquistas automáticas
• 8 categorias de ranking

GESTÃO DO SERVIDOR EM TEMPO REAL

• Dashboard ao vivo com status do servidor, players online, FPS, uptime e top players atualizados por WebSocket, sem precisar atualizar a página.
• Controle total do processo: broadcast in-game, save manual, shutdown, restart e detecção automática do PalServer.exe, com start, kill e restart pelo painel.
• Dupla via de comunicação: integra a REST API oficial (porta 8212) e o RCON (porta 25575), com fallback entre as duas.
• Monitoramento de saúde: detecta quando o servidor cai e dispara alerta automático.

MAPA INTERATIVO COM RASTRO DE JOGADOR

• Mapa real do Palworld renderizado em Leaflet, com projeção de coordenadas calibrada.
• Marcadores ao vivo de cada player, com popup de estatísticas ao clicar.
• Rastro de trajetória que reconstrói todo o caminho percorrido pelo jogador, com gradiente de tempo, filtro por sessão e decimação automática de pontos.
• Página de calibração protegida por token, para ajustar a projeção sem tocar em código.

GESTÃO DE PLAYERS

• Lista completa de todos que já entraram no servidor, com busca, avatar e ordenação.
• Ficha individual com histórico de sessões, evolução de nível, ping, HP, contagem de construções e gráficos temporais.
• Moderação direta: kick, ban e unban pelo painel, sem abrir console.
• Histórico de conexão persistido em snapshots, com retenção configurável.

EDITOR VISUAL DE CONFIGURAÇÕES

• As 129 opções do PalWorldSettings.ini mapeadas uma a uma, com rótulo e explicação em português, tipo de campo correto (slider, enum, booleano, senha), faixa mínima e máxima, unidade e aviso de "requer reinício".
• Preview de diff antes de salvar: você vê exatamente o que vai mudar.
• Histórico de alterações e rollback com um clique para qualquer versão anterior.
• Validação completa por schema, tornando impossível gravar um .ini quebrado.

BACKUPS E SAVES

• Criar, restaurar e apagar backups pelo painel.
• Backup pré-restauração automático: restaurar nunca destrói o estado atual sem rede de segurança.
• Política de retenção configurável (manter os N mais recentes mais 1 por dia dos últimos M dias), aplicada automaticamente.
• Leitura de metadados dos saves: tamanho, data e mundo ativo.

AUTOMAÇÃO E TAREFAS AGENDADAS

• Tarefas agendadas por expressão cron: restart, save, backup e broadcast.
• Aviso em cascata antes do restart, com mensagens in-game a 10, 5 e 1 minuto, para ninguém perder progresso.
• Execução manual sob demanda e histórico de sucesso ou falha por tarefa.

INTEGRAÇÃO COM DISCORD

Webhook configurável com liga e desliga por evento:

• Player entrou
• Player saiu
• Player banido
• Conquista desbloqueada
• Ranking diário automático
• Tarefa agendada executada ou com falha
• Servidor caiu

Inclui botão de teste do webhook direto na interface.

GAMIFICAÇÃO E RETENÇÃO DA COMUNIDADE

• 24 conquistas desbloqueadas automaticamente: tempo de jogo (de 1h a 500h), número de sessões, maratonas de 2h, 6h e 12h seguidas, veterania de 7, 30 e 180 dias, nível alcançado, exploração do mapa e mais. São recalculadas a cada 5 minutos e anunciadas no Discord na hora.
• 8 rankings com pódio visual: Mais Tempo, Maior Nível, Mais Sessões, Maior Maratona, Veteranos, Explorador, Dias Ativos e Construtor.

MARKETPLACE DE PALS (DIFERENCIAL EXCLUSIVO)

Um mercado interno para a comunidade do servidor negociar Pals:

• Catálogo completo de Pals com número da Paldeck, elementos, aptidões de trabalho e artes oficiais.
• Anúncios com todos os atributos do exemplar: nível, HP, ataque corpo a corpo, ataque à distância, defesa, velocidade de trabalho, habilidades passivas e ativas, variante (normal, alpha, lucky ou boss) e gênero.
• Preço na moeda do servidor, sistema de ofertas com mensagem, aceitar ou recusar e fechamento de venda.
• Todas as operações registradas no log de auditoria.

CONTAS, EQUIPE E SEGURANÇA

• Login por e-mail e senha ou por Google, com recuperação de senha por e-mail e token válido por 1 hora.
• Três níveis de acesso (owner, admin e moderator) somados a permissões granulares por tela: você define exatamente quais páginas cada membro da equipe enxerga.
• Convites por e-mail com token e expiração. O convidado entra com o Google e já cai no servidor certo.
• Audit log completo, com 38 tipos de ação registrados com identidade do admin, IP e data e hora. Nada acontece sem rastro.
• Segurança de produção: JWT em cookie httpOnly, bcrypt, Helmet, CORS restrito e rate limiting por rota.

MONETIZAÇÃO PRONTA (SAAS)

• Multi-tenant de verdade, com isolamento por tenant em todas as tabelas, incluindo chaves primárias e estrangeiras compostas. Um login pode gerenciar vários servidores, e a tela de seleção já existe.
• Stripe integrado: checkout de assinatura recorrente, portal do cliente para upgrade e cancelamento, webhook de sincronização de status e histórico de pagamentos.
• Ciclo de vida completo do cliente: trial, ativo, suspenso e cancelado, com trial de 3 dias sem cartão e bloqueio automático ao expirar.
• Landing page de conversão já construída: hero animado, prova social, grade de recursos, seção "como funciona", tabela de preço e Meta Pixel instalado.
• Onboarding guiado que conecta o servidor do cliente em poucos minutos.

O GANHO: POR QUE ISSO SUBSTITUI A GESTÃO MANUAL

Sem painel, administrar um servidor de Palworld é editar o .ini no bloco de notas e torcer, reiniciar no braço, avisar no Discord na mão, copiar a pasta de save antes de mexer em qualquer coisa, descobrir que o servidor caiu porque um player reclamou e não ter ideia de quem joga, quanto joga ou por que parou de jogar.

Com o PalPanel:

• Zero acesso ao servidor no dia a dia. Configuração, moderação, restart e backup saem todos do navegador, inclusive do celular.
• Erro de configuração vira impossível: campos validados, diff antes de salvar e rollback instantâneo.
• Nada se perde: backup automático antes de restaurar, política de retenção rodando sozinha e saves versionados.
• Você sabe da queda antes do player: alerta no Discord no momento em que o servidor para de responder.
• Manutenção sem revolta: restart agendado com aviso em cascata in-game, então a comunidade se prepara em vez de perder progresso.
• Delegação segura: moderadores moderam sem poder mexer em cobrança ou configuração, e cada ação fica registrada com nome e IP.
• Retenção mensurável: rankings, conquistas e marketplace dão motivo para o player voltar, e as métricas históricas de 30 dias mostram se está funcionando.
• Decisão baseada em dado: FPS, CPU, RAM e curva de players online em janelas de 1h, 6h, 24h, 7 dias e 30 dias dizem se a máquina aguenta, se a taxa de XP está boa e qual é o horário de pico.
• Escala sem trabalho extra: a arquitetura multi-tenant já suporta cobrar de outros donos de servidor pelo mesmo painel.

STACK TÉCNICA

Backend: Node.js 20+, TypeScript, Fastify 5, PostgreSQL (postgres.js), Socket.IO e WebSocket, node-cron, Zod, JWT com cookies, bcrypt, Helmet, rate-limit, Stripe, Resend e Pino.

Frontend: React 18, Vite, TypeScript, Tailwind CSS, shadcn/ui sobre Radix, TanStack Query, Recharts, Leaflet e Zustand.

Arquitetura: monorepo com workspaces (api, web e shared), tipos e contratos compartilhados entre front e back, tabelas prefixadas com palpanel_ para conviver com outros projetos no mesmo banco e schema configurável.

Testes: 136 testes de integração em Vitest e Supertest cobrindo autenticação, permissões, cobrança, marketplace, agendador, players, integrações e configuração.

O QUE ACOMPANHA

• Código-fonte completo do monorepo (API, painel web e pacote compartilhado)
• 11 migrations SQL versionadas e idempotentes, que rodam sozinhas na inicialização
• Suíte de 136 testes automatizados
• Arquivo render.yaml pronto para deploy em um clique
• Documentação técnica: ARCHITECTURE.md, PLAN.md, ROADMAP.md, NEXT_STEPS.md e a pasta docs com referência da API do Palworld, esquema do banco, setup de Cloudflare Tunnel para acesso remoto sem abrir porta no roteador e guia de calibração do mapa
• Assets do mapa do Palworld já processados e scripts de geração
• Seed do catálogo de Pals