Seu primeiro fluxo de suporte.

1. Experimente o painel

Crie um ticket, abra sua conversa, atribua um responsável, registre uma resposta e altere o status para Resolvido. A versão web salva os dados apenas neste navegador. Exportar backup permite guardar uma cópia. Não há sincronização entre pessoas ou dispositivos nesta versão.

2. Execute o backend local

Baixe o repositório Vicckz/KVZ.REST e, na pasta mvp-backend, com Node.js 24 instalado:

npm install
Copy-Item .env.example .env
npm start

Acesse http://127.0.0.1:3210. Essa versão salva seus dados na pasta data do computador. O backend aceita conexões somente deste computador.

3. Conecte seu bot ao Discord

Crie uma aplicação e um bot no Discord Developer Portal ↗. Coloque o token em DISCORD_BOT_TOKEN, dentro do arquivo .env, e reinicie o backend. Não compartilhe o token. Não é necessário habilitar intents privilegiados.

No painel local, abra Configuração e clique em Convidar bot. Ele precisa das permissões Gerenciar canais, Ver canais, Enviar mensagens, Incorporar links e Ler histórico de mensagens.

4. Configure e publique

Ative o Modo desenvolvedor nas configurações avançadas do Discord. Copie os IDs do servidor, de uma categoria existente, de um cargo da equipe e de um canal de texto. Salve os quatro IDs na Configuração. O cargo de suporte deve ser um cargo específico, diferente de @everyone.

Clique em Publicar painel no Discord. Isso envia uma mensagem com o botão Abrir ticket e registra o comando /ticket no servidor. O bot cria canais privados para o solicitante e a equipe, limita a um ticket ativo por membro e preserva o histórico quando o ticket é encerrado.

5. Atenda e guarde o histórico

Tickets criados no Discord aparecem no painel local. Respostas enviadas pelo painel são publicadas no canal. As mensagens que membros escrevem diretamente no Discord permanecem no Discord; não são copiadas para o painel neste MVP. Um ticket criado no painel não cria um canal no Discord.

O painel web e o painel local têm bases independentes. O backup do navegador pode ser importado pela versão web. Para restaurar um backup no backend, pare o serviço, faça uma cópia de segurança de data/state.json, substitua-o por seu backup do backend e reinicie. Não restaure IDs de canais de outro servidor.

Escopo desta versão

Este MVP é destinado ao administrador local e à validação com uma comunidade. Não inclui login multiusuário, pagamentos, IA ou onboarding automático. Para servir vários clientes pela internet, o backend precisa de autenticação, separação de dados e hospedagem adequada.