Conceitos Principais

Antes de começar, conheça os conceitos centrais do Squadly.

Grupo

Um Grupo é o núcleo do Squadly. Representa seu time ou pelada regular. Dentro de um grupo você gerencia membros, partidas, pagamentos e avaliações. Um usuário pode fazer parte de múltiplos grupos ao mesmo tempo.

Funções (Roles)

Cada membro tem uma função dentro do grupo que define o que pode fazer:

• Presidente — Dono do grupo. Controle total.
• Técnico — Pode gerenciar partidas, times e finanças.
• Jogador — Confirma presença e participa dos sorteios.

Consulte Funções e Permissões para a tabela completa.

Partida

Uma Partida representa um evento esportivo agendado. Ela passa por um ciclo de vida: scheduled → confirmed → in_progress → completed. Uma partida pode ter múltiplos jogos (sets) com placar individual.

Sorteio

O Sorteio é o processo de dividir os jogadores confirmados em times equilibrados. O Squadly usa as avaliações cadastradas para garantir que os times sejam justos. As notas dos jogadores são privadas — apenas Presidente e Técnico as veem.

Jogo

Um Jogo é um set dentro de uma partida (ex: "Jogo 1: Time A 2×1 Time B"). Uma partida pode ter N jogos em sequência. Cada jogo tem cronômetro, limite de gols e registro de artilheiros.

Avulso (Guest)

Um Avulso é um jogador eventual que não tem conta no Squadly. Presidentes e Técnicos podem criá-los para incluir no sorteio e marcar gols durante partidas.

Mensalidade

O controle financeiro registra o custo da quadra por mês, divide entre os membros e permite marcar quem pagou. O admin compartilha os dados de pagamento (chave PIX, valor, vencimento) e cada membro paga diretamente pelo seu banco.

Criar uma Conta

Para usar o Squadly você precisa criar uma conta pessoal. O cadastro é gratuito e leva menos de dois minutos.

Passo a Passo

Requisitos da Senha

• Mínimo de 8 caracteres
• Armazenada com criptografia
• Nunca compartilhada com terceiros

Avatar

Por padrão, seu avatar é gerado automaticamente com as iniciais do seu nome e uma cor selecionada aleatoriamente. Não é necessário fazer upload de foto.

Fazer Login

Para acessar o Squadly, você precisa de um e-mail e senha cadastrados. Após o login, o app mantém sua sessão ativa automaticamente.

Como Fazer Login

Sessão

Uma vez logado, o app mantém você conectado automaticamente. Você só precisa fazer login novamente se sair manualmente pelo botão "Sair" no perfil.

Recuperar Senha

Esqueci minha senha

Meu Perfil

A tela de perfil centraliza suas informações pessoais e configurações de conta.

O que você encontra no Perfil

• Avatar — iniciais + cor (gerados automaticamente)
• Nome e e-mail
• Botão "Alterar Senha"
• Botão "Sair"

Acesso ao Perfil

Toque no avatar no canto superior direito da tela inicial para ir direto ao perfil.

Alterar Senha

Você pode alterar sua senha a qualquer momento a partir do perfil.

Como Alterar

1. Acesse Perfil → Alterar Senha
2. Insira sua senha atual
3. Digite a nova senha (mínimo 8 caracteres)
4. Confirme a nova senha no campo de repetição
5. Toque em "Salvar"

Notificações Push

O Squadly envia notificações push para te manter atualizado sobre partidas e comunicados do grupo.

Permissão de Notificações

Na primeira vez que o app tenta enviar uma notificação, o sistema operacional solicita sua permissão. Você pode aceitar ou recusar. Para reabilitar, acesse as Configurações do dispositivo → Squadly → Notificações.

Tipos de Notificação

Criar um Grupo

Qualquer usuário com conta verificada pode criar um grupo. Quem cria se torna automaticamente o Presidente.

Como Criar

Configurações Padrão

Ao criar um grupo, as seguintes configurações de jogo são aplicadas automaticamente e podem ser ajustadas depois:

Entrar em um Grupo

Para entrar em um grupo existente, você precisa de um link de convite gerado pelo Presidente ou Técnico.

Usando o Link de Convite

Sobre os Convites por Função

O Presidente ou Técnico pode gerar links específicos para cada função:

• Convite de Técnico — para co-organizadores
• Convite de Jogador — para jogadores regulares

Gerando um Convite (Presidente/Técnico)

1. Acesse o grupo → toque no ícone de engrenagem (Configurações)
2. Toque em "Convidar membro"
3. Selecione a função do convidado
4. Compartilhe o link gerado

Configurar Grupo

As configurações do grupo controlam todos os comportamentos automáticos — de sorteios a finanças. Acesse em Grupo → ícone de engrenagem.

Informações Gerais

• Nome do grupo — visível a todos os membros
• Descrição — texto livre sobre o grupo
• Cor — cor de destaque usada no card do grupo
• Esporte — futebol, futsal, etc.

Configurações Financeiras

• Dia de vencimento — dia do mês para cobrança da mensalidade
• Chave PIX — tipo (CPF, CNPJ, e-mail, telefone ou aleatória) e valor
• Nome do beneficiário — nome que aparece na tela de pagamento

Configurações de Jogo ao Vivo

• Limite de gols — número de gols para vencer um jogo (ex: primeiro a fazer 2)
• Tempo por jogo — duração em minutos

Categorias de Avaliação

O grupo usa 6 categorias fixas: Passe, Chute, Defesa, Velocidade, Físico e Visão.

Ações Avançadas

• Transferir presidência — passa o controle do grupo para outro membro
• Excluir grupo — remove permanentemente o grupo e todos os dados (somente Presidente)
• Sair do grupo — remove você do grupo (Presidente só pode sair se houver outro Presidente)

Gerenciar Membros

A tela de Membros exibe todos os integrantes do grupo organizados por função. Presidentes e Técnicos têm ações adicionais ao tocar em um membro.

Ações Disponíveis

* Técnicos não podem remover outros Técnicos ou o Presidente.

Estatísticas de Membros

Ao tocar em um membro, você vê:

• Número de partidas disputadas
• Confirmações, recusas e sem resposta
• Avaliação média (visível apenas para Presidente/Técnico)
• Breakdown das categorias de avaliação

Transferir Presidência

Para transferir o grupo a outro membro: Configurações → Transferir presidência → selecione o membro. O membro selecionado se torna Presidente e você passa a ter a função de Técnico.

Funções e Permissões

O Squadly usa um sistema hierárquico de 4 funções para controlar quem pode fazer o quê dentro de um grupo.

As 3 Funções

Matriz de Permissões Completa

* Técnicos não podem remover outros Técnicos ou o Presidente.   ** Presidente não pode sair se for o único Presidente do grupo.

Jogadores Avulsos

Um Avulso é um jogador eventual que não precisa ter conta no Squadly. É útil para completar o time quando faltam membros ou quando um visitante participa de uma pelada.

Criar um Avulso

1. Acesse Grupo → Membros → Avulsos
2. Toque em "+ Adicionar avulso"
3. Informe o nome do jogador
4. Opcionalmente, defina uma posição e uma nota geral (overall)
5. Salve — o avulso fica disponível para ser adicionado a sorteios

O que um Avulso pode fazer

• Participar do pré-sorteio
• Ser colocado em um time no sorteio
• Marcar gols no placar ao vivo

Limitações

• Não recebe notificações push
• Não confirma/recusa presença
• Não tem acesso ao app
• Não entra no controle financeiro automaticamente

Comunicados

Comunicados são mensagens que Presidentes e Técnicos podem postar para todos os membros do grupo. Use para avisos importantes, regras especiais ou informações gerais sobre o grupo.

Criar um Comunicado

1. Na tela do grupo, toque em "Comunicados"
2. Toque em "+ Novo comunicado"
3. Informe um título (máx. 200 caracteres) e o corpo da mensagem (máx. 2000 caracteres)
4. Toque em "Postar"

O que Aparece no Comunicado

• Título e corpo da mensagem
• Nome de quem postou (Presidente ou Técnico)
• Data e hora de publicação

Quem pode ver?

Todos os membros do grupo — Presidentes, Técnicos, Jogadores e Suplentes — podem ler os comunicados. Apenas Presidentes e Técnicos podem postar.

Criar Partida

Presidentes e Técnicos podem criar partidas. Ao criar, todos os membros ativos são automaticamente adicionados como convidados.

Como Criar uma Partida

Notificar Participantes

Após criar a partida, toque em "Notificar todos" para enviar um push para todos os convidados. Esta ação só pode ser feita uma vez por partida.

Confirmar Presença

Todos os membros convidados para uma partida precisam confirmar ou recusar presença. Isso permite ao organizador saber quantos jogadores estarão presentes.

Como Confirmar

Você pode confirmar de 3 formas:

1. Pela notificação push — toque na notificação e escolha Confirmar ou Recusar
2. Pelo app — abra a partida e toque no botão verde "Confirmar presença"
3. Via link direto — o organizador pode compartilhar um link para confirmação rápida

Status de Presença

Status de Partida

Cada partida passa por um ciclo de vida com 5 estados possíveis.

Como Funciona o Sorteio

O sorteio do Squadly usa as avaliações cadastradas dos jogadores para criar times equilibrados, eliminando o problema de "time muito forte vs time muito fraco".

Visão Geral do Processo

Privacidade das Notas

As notas dos jogadores são completamente privadas. Os membros veem os times formados mas não têm acesso às avaliações individuais. Apenas Presidente e Técnico enxergam as notas.

Algoritmos de Sorteio

O Squadly oferece dois algoritmos com características e casos de uso diferentes.

1. Equilibrado

O modo padrão e recomendado. Garante times equilibrados com base na avaliação de cada jogador.

Resultado: Times com força similar, jogo justo.

2. Aleatório Ponderado

Modo com mais variação — útil quando o grupo tem muitos jogadores e quer dar mais chance a quem faltou recentemente.

Resultado: Times aleatórios mas dando prioridade a quem não jogou últimas peladas. Ideal para rotação justa.

Qual escolher?

Pré-Sorteio

Antes de executar o sorteio, o admin revisa e ajusta a lista de jogadores que entrarão nos times.

Tela de Pré-Sorteio

Acesse via Partida → "Sortear times". A tela exibe:

• Todos os jogadores com status confirmado
• Notas de cada jogador (visíveis apenas para admin)
• Opção de adicionar membros não confirmados manualmente
• Opção de adicionar avulsos cadastrados no grupo
• Seletor de algoritmo: Equilibrado ou Aleatório Ponderado

Adicionar Jogadores Manualmente

Se um jogador não confirmou mas aparecerá na pelada, o admin pode incluí-lo tocando em "+ Adicionar jogador" e selecionando da lista de membros do grupo.

Finalizar Times

Revisar e Trocar Jogadores

Após o algoritmo rodar, você vê dois times com a média de notas de cada um. Você pode:

• Resorteiar — toque em "Resorteiar" para rodar o algoritmo novamente (não salva)
• Trocar jogadores — toque em um jogador e selecione para onde movê-lo
• Comparar médias — a nota média de cada time é exibida em destaque

Finalizar

Quando estiver satisfeito com os times, toque em "Marcar como definitivo". Isso:

1. Salva os times no servidor
2. Torna os times visíveis para todos os membros
3. Remove as notas individuais da visualização dos membros comuns
4. Habilita o botão "Começar jogo" para o placar ao vivo

Jogo ao Vivo — Visão Geral

O módulo de Jogo ao Vivo permite registrar o placar de cada jogo em tempo real, com cronômetro, limite de gols e histórico de artilheiros.

Estrutura: Partida vs Jogo

• Uma Partida é o evento do dia (ex: Pelada de terça)
• Um Jogo é um set dentro da partida (ex: Jogo 1, Jogo 2, Jogo 3...)
• Cada jogo tem placar, artilheiros e cronômetro independentes

Pré-requisitos

• A partida precisa ter um sorteio finalizado
• Somente Presidente e Técnico controlam o placar

Configurações do Jogo

Antes de criar o primeiro jogo, defina (ou herde das configurações do grupo):

• Limite de gols — número de gols para vencer (ex: "primeiro a fazer 2")
• Tempo máximo — se o tempo esgotar sem atingir o limite, o jogo encerra automaticamente

Marcar Gols

Como Marcar um Gol

1. Na tela de jogo ao vivo, selecione o time que marcou (Time A ou Time B)
2. Toque no nome do jogador que fez o gol
3. O placar é atualizado instantaneamente e o nome do artilheiro aparece na sequência de gols

Gol de Avulso

Avulsos aparecem na lista de jogadores do time normalmente. Basta tocar no nome para registrar o gol.

Remover um Gol

Se um gol foi marcado por engano: toque no gol na lista de sequência de gols e confirme a remoção. O placar é corrigido automaticamente.

Fim Automático por Limite de Gols

Quando um time atinge o limite de gols configurado (ex: 2), o jogo encerra automaticamente. Um card de resultado aparece com o placar final e lista de artilheiros.

Cronômetro

Controles

Tempo Decorrido Real

O cronômetro usa timestamps do servidor, não do dispositivo. Mesmo que o celular trave ou o app seja fechado, o tempo é recalculado corretamente ao reabrir:

tempo_real = (agora - started_at) - total_pausado_segundos

Encerramento por Tempo

Quando o tempo máximo é atingido, o jogo é encerrado automaticamente. Se o cronômetro estiver pausado, o jogo não encerra até ser retomado ou encerrado manualmente.

Sistema de Avaliação

As avaliações são o combustível do algoritmo de sorteio. Quanto mais precisas, mais equilibrados ficam os times.

Categorias de Avaliação

Cada jogador é avaliado em 6 dimensões (configuráveis por grupo):

Nota Geral (Overall)

A nota geral é calculada automaticamente com base nas 6 categorias de avaliação. É usada no sorteio para equilibrar os times.

Múltiplos Avaliadores

Quando mais de um Técnico ou Presidente avalia o mesmo jogador, as notas são combinadas para gerar uma avaliação mais justa e equilibrada.

Avaliar um Jogador

Como Avaliar

Reavaliação

Você pode reavaliar um jogador a qualquer momento. A nova avaliação substitui a sua avaliação anterior (não cria um histórico cumulativo por avaliador).

Privacidade das Notas

A privacidade das notas é um princípio fundamental do Squadly. As avaliações são totalmente privadas para os jogadores avaliados.

Quem vê as notas?

Por que esse design?

Expor notas individuais entre amigos e colegas pode gerar conflitos e constrangimentos. O Squadly usa as notas como ferramenta interna de organização, não como ranking público.

Mensalidades

O módulo financeiro organiza a cobrança mensal da quadra, dividindo o custo entre os membros ativos e registrando quem pagou.

Como Funciona

Visão dos Membros

Cada membro vê na aba Financeiro:

• Status do pagamento de cada mês (Pago / Pendente)
• Valor a pagar e data de vencimento
• Chave PIX e nome do beneficiário para efetuar o pagamento
• Histórico dos últimos 12 meses

Dados de Pagamento

O administrador cadastra seus dados de recebimento no grupo. Os membros visualizam essas informações na tela de financeiro para efetuar o pagamento por conta própria.

Tipos de Chave PIX

Como Configurar

1. Acesse Configurações do grupo → Financeiro
2. Selecione o tipo da chave PIX
3. Insira o valor da chave
4. Informe o nome do beneficiário (aparece para os membros)
5. Salve

Experiência do Membro

Na tela de Financeiro, o membro vê:

• Nome do beneficiário cadastrado pelo admin
• Chave PIX com botão "Copiar" — para colar diretamente no app do banco
• Valor exato da sua parte
• Data de vencimento

Central de Notificações

A Central de Notificações agrupa todos os avisos e alertas do app em uma única tela, acessível pelo ícone de sino no topo direito da tela inicial.

Tipos de Notificação

Gerenciar Notificações

• Marcar como lida: toque na notificação para abrir e ela é marcada automaticamente
• Marcar todas como lidas: botão no topo da tela de notificações
• Badge de não lidas: número exibido no ícone de sino na tela inicial

Deep Links

Cada notificação tem um link direto para o conteúdo relevante. Exemplos:

• Notificação de partida → abre a tela da partida
• Notificação de comunicado → abre a lista de comunicados do grupo

Comunicados

Comunicados são mensagens oficiais do grupo publicadas pelo Presidente ou Técnico. Aparecem no dashboard do grupo e podem gerar notificações push.

Publicar um Comunicado

1. Acesse o grupo → aba Comunicados
2. Toque em "+ Novo comunicado"
3. Digite o título e o texto
4. Escolha se deseja notificar todos os membros por push
5. Toque em "Publicar"

Exemplos de Uso

• "Pelada de amanhã cancelada — quadra indisponível"
• "Mensalidade de março — valor: R$ 40. PIX até dia 5."
• "Novo horário: agora às 20h toda terça!"
• "Bem-vindos ao Squadly! Confiram as regras do grupo."

Excluir um Comunicado

Presidentes e Técnicos podem excluir comunicados. Toque e segure o comunicado e selecione "Excluir".

Glossário

Definições dos termos usados ao longo desta documentação.

Changelog

v1.2 — Abril 2026

• Jogo ao Vivo: cronômetro com pause/resume por timestamps de servidor
• Placar dedicado pós-jogo com artilheiros e opção de adicionar gol após encerramento
• Tela de resultado de partida ao finalizar todos os jogos
• Safe area Android corrigida em telas de confirmação
• Botões de gol compactos sem emoji na tela ao vivo

v1.1 — Março 2026

• Módulo de Jogo ao Vivo: criar jogos, marcar gols, remover gols, encerrar
• Deletar partida
• Remover gol
• Jogadores Avulsos podem marcar gols no placar ao vivo
• Limite de gols e limite de tempo por jogo

v1.0 — Janeiro 2026

• Lançamento inicial
• Autenticação completa (registro, verificação de e-mail, recuperação de senha)
• Grupos com 4 funções hierárquicas
• Partidas com confirmação de presença
• Sorteio equilibrado e aleatório ponderado
• Avaliações em 6 categorias
• Controle financeiro com PIX
• Notificações push (FCM)
• Comunicados do grupo