VKC Kartódromo — Venâncio Aires Kart Clube

Situação	Não-Sócio	🏆 Sócio
1 kart • 8h às 19h	R$ 120,00	Isento ✓
1 kart • inclui 19h–22h	R$ 170,00	R$ 50,00 ✓
2 karts • 8h às 19h	R$ 240,00	Isento ✓
Anuidade Sócio	—	R$ 695,00/ano

⚙️ Admin VKC

Acesso restrito ao administrador

E-mail

Senha

Esqueceu a senha?

Dashboard

Visão geral do VKC Kartódromo

Últimas Reservas

Usuários

Todos os cadastros no sistema

Usuários

Assinaturas

Sócios e histórico de pagamentos

➕ Adicionar Sócio Manualmente

Ativar plano sócio para um usuário cadastrado, com prazo personalizado.

E-mail do Usuário *

Valor Cobrado (R$)

Data de Início *

Data de Vencimento *

Forma de Pagamento

Assinaturas

Reservas

Todos os agendamentos

Agendamentos

Configurações do Site

Preços, pagamentos, aparência e funcionamento geral

💡 Horário da Taxa de Luz

Define a partir de qual hora a taxa de iluminação começa a ser cobrada e aparece como opção no agendamento.

Hora de início da taxa de luz

📅 Janela de Agendamento

Quantos dias à frente o usuário pode escolher a data da reserva.

Dias disponíveis para agendamento

💰 Preços do Sistema

Alterar os valores reflete em todo o site e nos cálculos de pagamento.

Taxa de Pista (R$/kart)

Taxa de Luz (R$/kart)

Anuidade Sócio (R$/ano)

💳 Configuração Mercado Pago

Credenciais disponíveis no painel do Mercado Pago em Seu negócio → Credenciais. Use credenciais de teste para sandbox.

Métodos de Pagamento Ativos

PIX Cartão de Crédito

Access Token *

Public Key * (usada no navegador para tokenizar o cartão)

🖼️ Ícone da Aba do Navegador (Favicon)

Aparece na aba do Chrome/Firefox e nos favoritos. Use PNG quadrado de 32×32 ou 64×64 px para melhor qualidade.

🌐

Arquivo (PNG, ICO ou SVG — máx. 512 KB)

Galeria

Gerenciar fotos da galeria e foto da pista na Home

🏁 Foto Principal da Pista (aparece na Home)

Esta foto aparece em destaque na seção da home, com overlay e estatísticas da pista.

Selecionar Foto da Pista *

➕ Adicionar Foto / Vídeo

Legenda / Título *

Categoria

Selecionar Imagem *

✓ A imagem será salva diretamente na pasta /fotos/ do servidor via API PHP.

Fotos na Galeria

Recordes

Atualizar tempos e recordistas

✏️ Editar Recorde Absoluto da Pista

Nome do Piloto

Tempo (ex: 44.201)

Categoria

Ano

➕ Adicionar Tempo por Categoria

Categoria

Grupo/Classe

Nome do Piloto

Tempo

Ano

Recordes Adicionados Manualmente

Patrocinadores

Gerenciar logos que aparecem na home em carrossel

➕ Adicionar Patrocinador

Nome do Patrocinador *

Site do Patrocinador (opcional)

Logo do Patrocinador (arquivo de imagem)

Apoiadores

Gerenciar logos que aparecem na home abaixo dos patrocinadores

➕ Adicionar Apoiador

Nome do Apoiador *

Site (opcional)

Logo (arquivo de imagem)

Campeonatos

Gerencie os campeonatos sediados no VKC

Novo Campeonato

Título *

Edição

Subtítulo / Local curto

Data de Início *

Data de Fim

Local completo

Descrição

Status

Banner (imagem)

⭐ Destaque na listagem

🏎️ Inscrições abertas

🔗 Inscrição pelo site (interna)

URL de Inscrição (externo)

📄 Documentos

Campeonatos Cadastrados

Log de E-mails

Histórico de todos os e-mails automáticos enviados

Guia do Sistema

Como o VKC Kartódromo funciona — referência para o administrador

Visão Geral

Sistema VKC Kartódromo

Site completo para o VKC — Venâncio Aires Kart Clube. Inclui agendamento online, plano sócio, galeria, recordes, campeonatos e este painel administrativo.

🌐

Frontend

Single Page Application em HTML/CSS/JS puro. Um único index.html com navegação por hash.

⚙️

Backend

PHP 8.3 + PDO. APIs REST em /vkc/api/. Autenticação JWT. PHPMailer via SMTP Hostinger.

🗄️

Banco de Dados

MySQL. 12+ tabelas: usuários, assinaturas, reservas, galeria, recordes, config e mais.

Estrutura de arquivos no servidor

public_html/index.html ← site principal
public_html/vkc/config.php ← configurações e credenciais
public_html/vkc/helpers.php ← funções compartilhadas
public_html/vkc/api/ ← endpoints PHP
public_html/vkc/vendor/ ← SDK Mercado Pago + PHPMailer
public_html/vkc/uploads/ ← fotos e logos

Funcionalidades

Fluxo de Agendamento

🏎️

Passo 1
Karts, horário e data

→

👤

Passo 2
Dados do piloto

→

💳

Passo 3
Pagamento

→

🏁

Passo 4
Confirmação

Karts, Horário e Data

Quantidade de karts (1–8), período (Até Xh ou Após Xh com taxa de luz) e data da visita no calendário. Botão "Continuar" só ativa quando os três estão selecionados.

Datas bloqueadas por anúncio aparecem em vermelho. Seg e Ter sempre bloqueados.

Dados do Piloto

Nome, e-mail, telefone, CPF (validado), cidade, filiação CBA e mecânico (nome + CPF obrigatórios, ou marcar "Não haverá mecânico"). Aceite de normas obrigatório.

Pagamento

Sócio com valor R$0 → confirmado na hora. Demais → PIX ou Cartão via Mercado Pago. A reserva já está salva com a data — o pagamento só precisa ser aprovado. Reabertura do modal não cria duplicata.

Confirmação

Tela de sucesso exibida após aprovação (ou imediatamente para sócios isentos). Botão para ver em Minha Conta.

Status das Reservas

Status	Significado
aguardando_pagamento	Reserva criada com data, aguardando aprovação MP
confirmado	Pagamento aprovado (webhook) ou sócio isento — agendamento ativo
cancelado	Cancelado pelo usuário ou pelo admin
aguardando_agendamento	Legado — reservas antigas sem data definida

Funcionalidades

Plano Sócio

Comportamento no agendamento

Badge "Sócio VKC — Descontos Aplicados" visível no passo 1
Taxa de pista zerada no resumo
Ao confirmar no passo 3 com R$0 → reserva confirmada imediatamente
E-mails enviados para piloto e admin na hora
Taxa de luz (após horário configurado) ainda é cobrada

Avisos automáticos de vencimento (cron job diário 09h)

30 dias antes do vencimento
7 dias antes do vencimento
No dia em que expira

Ativar manualmente em Admin → Assinaturas → Adicionar Sócio Manualmente para pagamentos presenciais.

Funcionalidades

E-mails Automáticos

Gatilho	Para
Novo cadastro	Usuário
Reserva confirmada — sócio isento (criação imediata)	Usuário Admin
Reserva confirmada — pagamento aprovado (webhook MP)	Usuário Admin
Assinatura ativada	Usuário Admin
Vencimento em 30 dias / 7 dias / expirou hoje	Usuário
Esqueci minha senha (usuário / admin)	Usuário / Admin

Todos os envios ficam registrados em Admin → Log de E-mails com status e eventuais erros.

Funcionalidades

Pagamentos — Mercado Pago

📱

PIX

QR Code com validade de 30 min. Sistema faz polling automático e confirma quando aprovado.

💳

Cartão de Crédito

Tokenização segura via SDK MP. Parcelas configuráveis por tipo de cobrança.

Configurar em Admin → Configurações do Site

Access Token e Public Key de produção
Webhook Secret para validar assinatura
PIX ativo / Cartão ativo (habilitar/desabilitar)
Parcelas máximas por tipo (reserva / anuidade)

URL do webhook: vkcrs.com/vkc/api/mercadopago.php?acao=webhook

Administração

Janela de Agendamento

Define até quantos dias à frente o piloto pode escolher a data. Configurado em Admin → Configurações do Site.

Valor	Comportamento
1 dia	Só o próximo dia disponível (Seg/Ter bloqueados — pode cair na Quarta)
5 dias	Cobre fins de semana mesmo quando hoje for Quarta ou Quinta
30 dias	Máximo — piloto agenda com até 1 mês de antecedência

Regras sempre aplicadas

Mínimo 24h de antecedência (nunca agenda para hoje)
Segunda e Terça sempre bloqueados
Datas com anúncio de bloqueio aparecem em vermelho
Validação no frontend (calendário) e no servidor (PHP)

Administração

Configurações Técnicas

Constantes em public_html/vkc/config.php:

Constante	Descrição
`APP_URL`	URL base do site (ex: https://vkcrs.com)
`JWT_SECRET`	Chave para tokens de autenticação — manter em segredo
`EMAIL_FROM / EMAIL_ADMIN`	Remetente e destinatário admin dos e-mails automáticos
`SMTP_HOST / PORT / USER / PASS`	Servidor SMTP Hostinger, porta 465 SSL
`UPLOAD_DIR / UPLOAD_URL`	Caminho local e URL pública dos uploads

Sessões

Usuário comum: 2 horas com aviso 2 min antes
Admin: 1 hora com aviso 2 min antes
Token JWT em memória apenas (não salvo no localStorage)

Administração

Checklist de Produção

Antes de ir ao ar

Configurar Access Token + Public Key de produção do MP em Admin → Config
Configurar Webhook Secret do MP em Admin → Config
Cadastrar URL do webhook no painel do Mercado Pago
Testar um pagamento real (PIX e Cartão)
Confirmar cron job ativo (hPanel → Cron Jobs → diário 09h)
Confirmar DNS: SPF, DKIM e DMARC configurados
Verificar SSL ativo no domínio (hPanel → SSL)
Deletar arquivos de teste do servidor
Trocar senha do admin por senha forte

Configurações iniciais recomendadas

Definir taxa de pista, taxa de luz e anuidade em Admin → Config
Definir horário da taxa de luz (18h ou 19h)
Definir janela de agendamento (recomendado: 5 dias)
Adicionar foto da pista em Admin → Galeria (imagem da home)
Adicionar ao menos um patrocinador ou apoiador

Tutorial

Como Usar o Painel Admin

Guia passo a passo de cada seção do painel. Clique no menu lateral esquerdo para navegar entre as abas.

Tutorial — Acesso

🔐 Acessar o Admin

Abrir o painel

Acesse vkcrs.com/#admin no navegador. Aparecerá a tela de login do administrador, separada do login de usuários.

Fazer login

Digite o e-mail e senha de administrador. A sessão dura 1 hora. Um aviso aparece 2 minutos antes de expirar — clique em "Renovar" para continuar sem precisar logar novamente.

Esqueceu a senha?

Clique em "Esqueci minha senha" na tela de login do admin. Um e-mail com link de redefinição será enviado para o endereço cadastrado.

Tutorial — Dashboard

📊 Dashboard

Primeira tela ao entrar no admin. Mostra um resumo do sistema em tempo real:

O que aparece no Dashboard

Total de usuários cadastrados — todos que criaram conta no site
Sócios ativos — assinaturas com status ativo e dentro do prazo
Reservas confirmadas — agendamentos com status "confirmado"
Últimas reservas — tabela com os agendamentos mais recentes (piloto, data, status, valor)

O dashboard atualiza os dados toda vez que você entra nessa aba.

Tutorial — Usuários

👥 Usuários

Lista todos os usuários cadastrados no site. Para cada usuário é possível:

Ação	Como fazer
Ver dados	A tabela mostra nome, e-mail, CPF, telefone, data de cadastro e se é sócio ativo
Editar usuário	Clique no ícone de edição (✏️) — abre modal com campos de nome, e-mail, CPF e telefone
Alterar senha	No modal de edição, preencha o campo "Nova Senha" e salve
Remover conta	Clique no ícone de exclusão (🗑️) — confirme a remoção. Ação irreversível

Usuários com assinatura ativa aparecem com o badge 🏆 na coluna de sócio.

Tutorial — Assinaturas

🏆 Assinaturas

Gerencia o plano sócio de todos os usuários. Exibe histórico completo de todas as assinaturas, ativas ou expiradas.

Adicionar Sócio Manualmente (pagamento presencial)

Preencha o e-mail do usuário já cadastrado no site
Informe o valor cobrado (pode ser diferente da anuidade padrão)
Defina data de início e data de vencimento (padrão: +12 meses)
Selecione a forma de pagamento: Manual / Cartão / Transferência / Cortesia
Clique em Ativar Assinatura — o status "sócio" é aplicado imediatamente

Status da assinatura	Significado
ativo	Sócio com benefícios ativos — isento da taxa de pista
pendente	Assinatura criada mas pagamento ainda não confirmado
expirado	Prazo vencido — benefícios suspensos automaticamente

Para editar datas de uma assinatura, clique no ícone ✏️ na tabela de assinaturas.

Tutorial — Reservas

📅 Reservas

Tabela completa de todos os agendamentos. Mostra piloto, data, período, karts, valor e status.

Ação	Como fazer
Ver todos	Lista ordenada por data de criação. Reservas canceladas ficam acinzentadas
Editar status	Clique em ✏️ → selecione novo status no dropdown (aguardando pagamento / confirmado / cancelado)
Ver detalhes	O modal de edição mostra CPF, e-mail, mecânico, CBA e todos os dados da reserva
Exportar CSV	Botão "Exportar CSV" no canto superior — baixa todos os agendamentos em formato Excel

Situações comuns

Reserva em aguardando_pagamento há muito tempo → usuário não pagou. Cancele manualmente
Webhook do MP demorou → mude manualmente para confirmado após verificar no painel do MP
Piloto pediu cancelamento → mude para cancelado

Tutorial — Galeria

🖼️ Galeria

Gerencia as fotos exibidas na página Galeria do site e a foto principal da home.

🏁

Foto Principal da Pista (Home)

A imagem que aparece em destaque na Home, com overlay vermelho e estatísticas. Selecione um arquivo JPG/PNG e clique em "Definir como Foto da Pista". Recomendado: 1920×1080 px.

📸

Adicionar Foto

Preencha a legenda, selecione a categoria (Pista / Treinos / Eventos / Pódio) e escolha o arquivo. Clique em "Adicionar". Formatos aceitos: JPG, PNG, WebP. Tamanho máximo: 5 MB.

🎬

Adicionar Vídeo

Na categoria selecione "🎬 Vídeo". O campo de arquivo é substituído por um campo de URL. Cole o link do YouTube ou Vimeo e clique em "Adicionar".

🗑️

Remover item

Na lista de itens da galeria, clique no botão "Remover" ao lado de cada item. A foto é excluída do servidor permanentemente.

A galeria é dividida em abas por categoria no site. Imagens aparecem na ordem de upload.

Tutorial — Recordes

🏁 Recordes

Gerencia os recordes exibidos na página Recordes do site.

Recorde Absoluto

Um único recorde marcado como absoluto — o melhor tempo da pista
Aparece em destaque no topo da página de recordes
Clique em ✏️ para editar piloto, tempo, categoria e ano

Adicionar Recorde por Categoria

Preencha: categoria (ex: Sênior, Júnior), grupo (ex: Grupo A), descrição, piloto, tempo (formato 1:23.456) e ano
Clique em "Adicionar Recorde"
Os recordes são exibidos agrupados por categoria e grupo no site

Para editar um recorde existente, clique em ✏️ na tabela de recordes.

Tutorial — Patrocinadores e Apoiadores

🤝 Patrocinadores & Apoiadores

Duas seções separadas com funcionamento idêntico. Patrocinadores aparecem com logos maiores, apoiadores em logos menores na Home.

➕

Adicionar

Preencha o nome, faça upload do logo (PNG transparente recomendado) e informe o link do site do patrocinador. Clique em "Adicionar".

↕️

Ordenar

A ordem de exibição segue o campo "ordem" configurado no modal de edição. Menor número aparece primeiro.

✏️

Editar ou Desativar

Clique em ✏️ para editar nome, logo, link ou ordem. Desmarque "Ativo" para ocultar do site sem excluir.

🗑️

Remover

Clique em 🗑️ na tabela. O logo é removido do servidor permanentemente.

Tutorial — Anúncios

📢 Anúncios

Cria avisos que aparecem no site e pode bloquear datas no calendário de agendamento.

✍️

Criar Anúncio

Preencha o título, a mensagem e onde exibir: Barra no topo (visível em todas as páginas), Página de Agendamento ou Ambos.

🚫

Bloquear Agendamentos (opcional)

Preencha Data Início e Data Fim do bloqueio. Os dias nesse período ficam marcados em vermelho no calendário e não podem ser selecionados pelos usuários. Útil para: feriados fechados, eventos internos, manutenção.

📋

Gerenciar anúncios ativos

A lista mostra todos os anúncios publicados. Clique em "Remover" para desativar. O bloqueio de datas some imediatamente do calendário.

Casos de uso comuns

Pista fechada para manutenção → bloquear o período + aviso no topo
Evento exclusivo (clube fechado) → bloquear datas + aviso na página de agendamento
Aviso geral (horário especial no feriado) → apenas título/mensagem, sem bloqueio

Tutorial — Campeonatos

🏆 Campeonatos

Gerencia campeonatos exibidos na página Campeonatos. Cada campeonato tem inscrições online opcionais com pagamento via Mercado Pago.

➕

Criar Campeonato

Preencha: título, descrição, categoria, status (Em Breve / Inscrições Abertas / Em Andamento / Encerrado), data de início, banner (imagem) e opcionalmente link de regulamento e de resultados.

💳

Inscrições com Pagamento

Se o campeonato tem taxa de inscrição, defina o valor e ative as inscrições. Usuários logados podem se inscrever e pagar diretamente pelo site. O admin vê todas as inscrições na aba de Campeonatos.

✏️

Editar / Atualizar status

Clique em ✏️ para atualizar o status conforme o campeonato avança. Altere para Em Andamento quando começar e Encerrado ao final — isso é refletido imediatamente no site.

Tutorial — Log de E-mails

📬 Log de E-mails

Histórico de todos os e-mails automáticos disparados pelo sistema (confirmações, avisos, redefinições de senha, etc.).

O que aparece no log

Destinatário — e-mail do usuário ou do admin
Assunto — título do e-mail enviado
Status — enviado ou erro
Data e hora — quando o envio foi tentado
Mensagem de erro (quando houver) — útil para diagnosticar problemas SMTP

Se e-mails estiverem falhando, verifique as credenciais SMTP em config.php e os registros SPF/DKIM do domínio.

Clique em "Limpar Log" para apagar o histórico. Isso não afeta o funcionamento dos e-mails.

Tutorial — Configurações

⚙️ Configurações do Site

Centraliza todos os ajustes operacionais. Nenhuma alteração aqui exige mexer em código.

💡 Horário da Taxa de Luz

Escolha 18h ou 19h — define quando começa a cobrança de iluminação
Reflete imediatamente nos botões de horário do agendamento e nos cálculos de valor
Clique em "Salvar" após selecionar

📅 Janela de Agendamento

Número de dias à frente que o piloto pode escolher para agendar (mínimo 1, máximo 30)
Exemplo: 5 dias → usuário pode agendar de amanhã até daqui 5 dias
Segunda e Terça são sempre excluídos automaticamente, independente do valor
Clique em "Salvar" após digitar o valor

💰 Preços do Sistema

Taxa de Pista (R$/kart) — valor base por kart, isento para sócios
Taxa de Luz (R$/kart) — valor adicional por kart quando agendado após o horário configurado
Anuidade Sócio (R$/ano) — valor do plano anual exibido em "Seja Sócio"
Após salvar, os novos valores aparecem em todo o site automaticamente

💳 Mercado Pago

PIX ativo / Cartão ativo — marque quais métodos aparecem para o usuário. Se só um estiver ativo, o modal de pagamento abre diretamente nesse método
Parcelas — quando cartão ativo, defina o máximo de parcelas para: Agendamento, Sócio e Campeonato
Access Token — chave secreta da conta MP (campo senha, não visível). Encontre em: Mercado Pago → Seu negócio → Credenciais
Public Key — chave pública usada no navegador para tokenizar o cartão. Encontre no mesmo lugar
Clique em "Salvar Configuração" — as chaves são armazenadas no banco com segurança

🖼️ Favicon (Ícone da Aba)

Ícone que aparece na aba do navegador e nos favoritos
Selecione um arquivo PNG, ICO ou SVG (máx. 512 KB). Ideal: 64×64 px quadrado
Clique em "Definir Favicon" — aparece imediatamente na aba do site
Um preview do ícone atual é exibido antes de trocar

Anúncios do Site

Avisos e bloqueios de agenda para os visitantes

📢 Criar Anúncio / Aviso

Título do Aviso

Mensagem

Exibir em

🚫 Bloquear Agendamentos (opcional)

Se preenchido, os dias neste período serão marcados como indisponíveis no calendário.

Data Início do Bloqueio

Data Fim do Bloqueio

VENÂNCIO AIRESKART CLUBE

NOSSOSAPOIADORES

NOSSOSPATROCINADORES

CONHEÇA OVKC

987 METROSDE VELOCIDADE

Pista Outdoor Profissional

1 Diária = Até 2 Pilotos

Recordes Oficiais

PISTA OUTDOORPROFISSIONAL

Iluminação Noturna

Agendamento Obrigatório

Pagamento Seguro

EQUIPAMENTOSOBRIGATÓRIOS

Capacete

Macacão

Luvas

Calçado Fechado

Protetor de Pescoço

Balaclava

NORMAS DE USO

⚠️ Veículos e Área de Box

🍺 Bebidas e Conduta

⚖️ Responsabilidade

TABELA DE PREÇOS

COMOCHEGAR

Endereço

RESERVARPISTA

Login necessário

🌞 Somente até 19h

🌙 Também após 19h

Dados do Agendamento

Mecânico

📋 Condições Gerais de Uso da Pista

Reserva Confirmada!

SEJA UMSÓCIO VKC

POR QUE SERSÓCIO VKC?

Isenção da Taxa de Pista

Acesso Ilimitado

12 Meses

PLANO ANUAL

Sócio Anual VKC

Confirmar Associação

MOMENTOS NAPISTA

RECORDESDA PISTA

CHOKA SIRTULIKZ — Motor RNK • 2023

Área do Piloto

Editar Perfil

🔑 Alterar Senha

⚙️ Admin VKC

Dashboard

Últimas Reservas

Usuários

Usuários

Assinaturas

➕ Adicionar Sócio Manualmente

Assinaturas

Reservas

Agendamentos

Configurações do Site

💡 Horário da Taxa de Luz

📅 Janela de Agendamento

💰 Preços do Sistema

💳 Configuração Mercado Pago

🖼️ Ícone da Aba do Navegador (Favicon)

Galeria

🏁 Foto Principal da Pista (aparece na Home)

➕ Adicionar Foto / Vídeo

Fotos na Galeria

Recordes

✏️ Editar Recorde Absoluto da Pista

➕ Adicionar Tempo por Categoria

Recordes Adicionados Manualmente

Patrocinadores

➕ Adicionar Patrocinador

Apoiadores

➕ Adicionar Apoiador

Campeonatos

Novo Campeonato

Campeonatos Cadastrados

Adicionar / Editar Campo

VENÂNCIO AIRES
KART CLUBE

NOSSOS
APOIADORES

NOSSOS
PATROCINADORES

CONHEÇA O
VKC

987 METROS
DE VELOCIDADE

PISTA OUTDOOR
PROFISSIONAL

EQUIPAMENTOS
OBRIGATÓRIOS

COMO
CHEGAR

RESERVAR
PISTA

SEJA UM
SÓCIO VKC

POR QUE SER
SÓCIO VKC?

MOMENTOS NA
PISTA

RECORDES
DA PISTA

CHOKA SIRTULI
KZ — Motor RNK • 2023

CAMPEONATOS
VKC