Como usar a plataforma

Bem-vindo ao sistema de Sorteio de Vagas de Garagem. Este guia explica passo a passo como configurar, importar dados e realizar o sorteio de forma transparente e segura.

1. Visão Geral

A plataforma é dividida em duas áreas principais:

Administração: Área restrita para o síndico ou administrador. Aqui você cadastra as vagas, as unidades, realiza o sorteio e exporta os resultados.
Área da Unidade: Área pública onde as unidades podem consultar o resultado do sorteio buscando pela própria identificação, além de verificar a autenticidade do sorteio através do código (hash) gerado.

2. Importação de Planilhas (Excel/CSV)

Precisa dos modelos de planilha?

Disponibilizamos arquivos Excel já configurados com as colunas corretas para facilitar a importação.

Baixar Modelos de Importação

Para facilitar o cadastro em massa, você pode importar planilhas diretamente no painel de Administração. O sistema aceita arquivos .xlsx, .xls e .csv.

Importando Vagas

Na aba Vagas, clique no botão verde Importar. Sua planilha deve conter as seguintes colunas (a ordem não importa):

Coluna	Descrição	Exemplos de Valores
Número / Numero	Identificação da vaga	V01, 12A, Térreo-05
Torre	Torre ou prédio da vaga	Torre A, Bloco 1, Única
Zona / Bloco	Localização específica	Subsolo 1, Térreo, G1
Tipo	Tipo de prioridade da vaga	PCD, Conv. PCD, Padrão
Cobertura	Se a vaga é coberta ou não	Coberta, Descoberta
Andar	Andar da vaga	Térreo, Superior, Inferior
Bloco Misto	Se a vaga pode ser pega por qualquer unidade, independente da zona	Sim, Não

Importando Unidades (Apartamentos)

Na aba Unidades, clique no botão verde Importar. Sua planilha deve conter as seguintes colunas:

Coluna	Descrição	Exemplos de Valores
Unidade	Identificação da unidade ou apartamento	Apto 101, 1505
Torre	Torre do apartamento	Torre A, Bloco 1
Zona / Bloco	Agrupamento do apartamento	Andar 1, Ala Sul
PCD	Se a unidade possui prioridade PCD	Sim, Não, True, False
Pode Coberta	Se a unidade pode receber vaga coberta (use "Não" se ela já teve vaga coberta no sorteio anterior)	Sim, Não

3. Como funciona o Sorteio

O algoritmo de sorteio foi desenvolvido para ser 100% justo, auditável e respeitar as prioridades legais:

Prioridade PCD (Tier 1):Unidades marcadas como PCD são sorteadas primeiro. Elas recebem exclusivamente as vagas marcadas como "PCD" ou "Conv. PCD".
Restrição de Vaga Coberta:Unidades marcadas com "Não" na opção "Pode Coberta" são processadas com prioridade para garantir que recebam apenas vagas descobertas.
Restrição de Zona e Bloco Misto: O sistema garante que uma unidade só receba uma vaga que pertença à sua mesma Zona/Bloco. Caso a vaga esteja marcada como Bloco Misto, ela poderá ser atribuída a qualquer unidade, independentemente da zona. O algoritmo prioriza entregar vagas específicas da zona antes de usar as vagas mistas.
Sorteio Padrão (Tier 2): Após alocar todas as unidades PCD, as unidades restantes são sorteadas para as vagas restantes (Padrão e as vagas PCD conversíveis que sobraram).
Semente Criptográfica (Seed):Antes de sortear, você deve inserir uma "Semente" (uma palavra ou frase secreta). Essa semente gera um código (Hash SHA-256) único. Se você usar a mesma semente com a mesma lista de pessoas, o resultado será sempre exatamente o mesmo. Isso garante que o sorteio não foi manipulado após a execução.

4. Exportação e Resultados

Após realizar o sorteio, acesse a aba Resultados. Lá você poderá:

Exportar PDF: Gera um documento oficial, formatado e pronto para impressão ou envio por WhatsApp/E-mail às unidades. O PDF inclui o Hash de auditoria.
Exportar JSON: Baixa os dados brutos do sorteio para fins de backup ou auditoria técnica.

Dica de Segurança: Na aba Configurações, você pode fazer o backup de todos os dados cadastrados (vagas e unidades) antes de realizar o sorteio, garantindo que nenhuma informação seja perdida.