Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🏐 VoleizinDosCria 🏐

O sistema definitivo para gestão de grupos de vôlei amador — 100% gratuito e na nuvem.
Transforma o Google Sheets em um Dashboard inteligente com presença, times, finanças e WhatsApp integrados.

Preview do VoleizinDosCria

Demo: Interface real do Web App rodando via Google Apps Script. Siga o INSTRUCOES.md para configurar o seu próprio painel em minutos.


🌟 Visão Geral

VoleizinDosCria resolve o caos da organização de vôlei amador: listas de presença no WhatsApp, rateios manuais, times desequilibrados e cobrança esquecida. Com uma interface Glassmorphism Dark Mode, backend em Google Apps Script e suporte a qualquer dia da semana, ele centraliza tudo que um administrador de racha precisa — num app responsivo que funciona direto do celular.

Custo: R$ 0,00. Hospedado 100% no Google.


🚀 Funcionalidades

📊 Dashboard e Auditoria

  • Visão do elenco: Total de jogadores, divisão entre mensalistas, avulsos e ativos/inativos
  • Saúde financeira: Arrecadação acumulada com barras de progresso separando receita da quadra e caixa de equipamentos
  • Aniversariantes do Mês: Lista cronológica com destaque pulsante para quem faz aniversário hoje! 🎂
  • 🛡️ Auditoria e Logs: Histórico completo de tudo o que acontece no sistema (cadastros, presenças, pagamentos). Nunca mais perca o rastro de quem pagou ou de quem alterou um registro.
  • 🔍 Filtro de Histórico: Busca instantânea por dia, mês ou tipo de movimentação.

📅 Chamada Inteligente e Multi-Dia

  • Suporte a qualquer dia da semana — o app detecta o dia atual e seleciona o card correto
  • Jogadores Inativos: Opção de inativar jogadores para que não apareçam na lista de presença ou no rateio mensal, sem precisar excluí-los do banco de dados.
  • Status em tempo real: Vou / Falto com recálculo instantâneo de confirmados
  • Trava de Segurança: Avulsos (e mensalistas fora de seu dia) só podem confirmar presença após o pagamento da diária ser registrado
  • Múltiplas Categorias: Diferenciação automática entre mensalistas "oficiais", visitantes e avulsos
  • Botão de cobrança em massa via WhatsApp formatado para o grupo

🔀 Sorteio Inteligente de Times (Algoritmo Híbrido)

  • Jogadores nível 3, 4 e 5 distribuídos via Snake Draft para equilibrar a base técnica
  • Jogadores nível 1 e 2 distribuídos por rodízio adaptativo, garantindo que nunca fiquem concentrados no mesmo time
  • Compartilhamento dos times formatados diretamente no WhatsApp

💰 Inteligência Financeira Completa

  • Valor do avulso configurável por mês — flexibilidade total na cobrança
  • Rateio automático dos mensalistas por dia de treino com custos independentes
  • Fundo de Equipamentos: Receita de avulsos vai para um caixa separado para compra de materiais
  • Gestão Manual de Caixa: Entradas e Saídas manuais para gerenciar o fundo de equipamentos com logs descritivos
  • Congelamento de Histórico: Uma vez que um mês é marcado como "Pago Totalmente", os dados de rateio daquele mês são preservados contra mudanças futuras no cadastro.
  • Listagem dos devedores do mês com link de cobrança individual no WhatsApp
  • Botão de salvar configurações sem precisar fazer o fechamento completo

🔒 Privacidade e Segurança

  • Telefones e datas de nascimento são mascarados na lista pública por privacidade ((11) *****-1234)
  • Campo de telefone e data de nascimento com máscaras automáticas (ex: digite 24041990 e vire 24/04/1990)
  • Dados sensíveis só armazenados no Google Sheets da conta do administrador

📂 Estrutura do Projeto

├── codigo.gs          # Backend — API hospedada no Google Apps Script
├── index.html         # Frontend — Vue 3 + TailwindCSS (app Single-Page)
├── demo_voleizin.gif  # Preview animado para o README
├── README.md          # Documentação principal
└── INSTRUCOES.md      # Guia de instalação passo a passo com imagens

🛠️ Guia Rápido de Instalação

Para o guia completo e ilustrado, veja INSTRUCOES.md.

  1. Acesse sheets.new e crie uma planilha em branco
  2. Clique em Extensões > Apps Script
  3. Cole o conteúdo de codigo.gs no arquivo Código.gs e crie um arquivo HTML chamado index com o conteúdo de index.html
  4. Execute a função setupInicial() para criar as abas da planilha
  5. Clique em Implantar > Nova Implantação > App da Web com acesso para Qualquer pessoa
  6. Copie o link gerado — esse é o seu sistema! 🎉

🧪 Dados de Teste

Para testar o sistema sem inserir dados manualmente, execute a função gerarDadosDeTeste() no Apps Script. Ela cria automaticamente:

  • 12 jogadores fictícios (8 mensalistas + 4 avulsos, níveis 1 a 5)
  • Presenças para o dia atual com todos confirmados
  • Pagamentos dos avulsos já registrados
  • Configuração financeira do mês atual pronta

🎨 Interface e UX

  • Dark Mode com estética Glassmorphism e acentos em Emerald, Cyan, Purple, Amber e Rose
  • Totalmente responsivo — funciona perfeitamente em celular, tablet e desktop
  • PWA nativo — pode ser adicionado à tela inicial do celular como um app
  • Micro-animações e transições suaves para uma experiência premium

☕ Apoie o Desenvolvedor

O VoleizinDosCria é 100% gratuito e open source. Se ele te ajudou a organizar o racha, pague um café pro dev! ❤️

Buy Me A Coffee    Ko-fi


Desenvolvido com ❤️ e voleibol na veia.

About

Sistema de gestão para grupos de vôlei amador, desenvolvido com Google Apps Script e Vue.js, usando Google Sheets como banco de dados.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages