Começando
Este guia irá ajudá-lo a dar os primeiros passos com nosso sistema SaaS. Siga as instruções abaixo para começar a usar todas as funcionalidades disponíveis.
Acesse o Sistema
Acesse o Controle de Vaga Inteligente pelo link abaixo:
Faça Login
Na tela de login, digite os dados que foram fornecidos pelo email recebido do sistema indicando seu "Domínio", "Usuário" e "Senha", e em seguida clique no botão "Entrar".
Figura 1: Tela de login do Controle de Vaga Inteligente
Acesse o Dashboard
Se todas as informações inseridas estiverem corretas, você acessará o dashboard inicial do Sistema de Sorteio.
Figura 2: Dashboard do Controle de Vaga Inteligente
Informação Importante
No Dashboard, você pode verificar que haverá um menu na barra lateral esquerda que mostrará todas as opções que seu plano oferece. Seu plano é mostrado logo após o nome do Controle de Vaga Inteligente na tela central do dashboard.
Criando um Usuário
A primeira etapa para utilização do sistema é a criação de usuários. Cada plano tem um limite associado ao número máximo de usuários que podem ser criados.
Dica
A criação de novos usuários não é uma etapa obrigatória se houver apenas um único usuário que irá executar atividades no sistema.
Clicando na opção "Usuários" do menu na barra lateral à esquerda, você irá acessar a tela de cadastro de usuários:
Figura 3: Cadastro de Novos Usuários
Importante
Inicialmente serão listados 2 usuários: um usuário criado pelo sistema no momento da aceitação do contrato e um usuário "admin", que é um usuário de sistema usado pelo nosso suporte para verificação de erros ou execução de tarefas contratadas pelos nossos clientes como serviços extras. Este usuário "admin" não pode ser deletado ou alterado.
Dados obrigatórios para cadastro:
Figura 4: Dados Obrigatórios para Cadastro
- Usuário: padrão username sem espaços
- Email: um email válido (que será usado pelo sistema para comunicação)
- Senha: defina uma senha segura
- Tipo: escolha entre "Administrador de Domínio" ou "Usuário"
- Domínio: você só terá acesso ao seu próprio domínio
Importante
Apenas Administradores do Sistema podem ver todos os Domínios
Dica
"Administrador de Domínio" pode executar todas as funções do sistema; "Usuário" pode apenas consultar dados do sistema e verificar listagens.
Sistema de Posições
O Controle de Vaga Inteligente foi criado para atender a todas as necessidades de nossos clientes.
Nós elaboramos o conceito de Posições para que nossos clientes possam ter uma opção a mais na hora de executar o seu Sorteio Inteligente. Como ele funciona?
As Posições podem ser usadas para filtrar ou ordenar os sorteios de vagas
Posições podem dar prioridade a um determinado grupo, como "Pessoas da Melhor Idade", "Pessoas com Deficiência" (PcD), ou Patentes Militares
No momento do sorteio, o usuário pode escolher executar o sorteio por Posição, de forma a dar prioridade nas escolhas das vagas para o grupo específico
Exemplo de Funcionamento:
Se há uma Posição para um grupo de "Pessoas com Deficiência" (PcD), com número de ordem 1, uma Posição para um grupo de "Pessoas da Melhor Idade", com número de ordem 2, e uma Posição para o restante de moradores, com número de ordem 3:
O Controle de Vaga Inteligente executará o sorteio primeiramente para a Posição de ordem 1, depois para a Posição de ordem 2 e, no final, para a Posição que mantém todos os demais, garantindo que os grupos prioritários recebam vagas primeiro.
Limite
O número de Posições é limitado a 30 para todos os planos.
Cadastrando Apartamentos
Para o uso eficiente do Controle de Vaga Inteligente, é necessário que alguns dados importantes e mínimos sejam cadastrados no sistema. Estes dados são apenas para que o sistema possa ligar os moradores às suas vagas e garantir que somente moradores possam receber vagas.
Clicando na opção "Apartamentos" do menu na barra lateral à esquerda, você irá acessar a tela de cadastro de apartamentos:
Figura 5: Cadastro de Apartamentos
Dica
O cadastro de apartamentos pode ser feito de forma manual ou através da importação de CSV. Para baixar o arquivo de exemplo CSV clique aqui.
Dados obrigatórios para cadastro:
Figura 6: Dados Obrigatórios para Cadastro
- Apartamento: número e letras
- Andar: número e letras
- Bloco: número e letras
- Manutenção: Caso o apartamento esteja vazio ou apenas em manutenção e não tenha direito a vagas.
Importante
Apenas Administradores do Sistema podem ver todos os Domínios
Dica
Na listagem de apartamentos há dois ícones em "Ações": um para editar registro e o outro para deletá-lo .
Atenção
Se o seu caso de uso não exige que a vaga seja dada para pessoas que têm apartamento, como em indústrias, etc., importe apartamentos sequenciais no mesmo andar e bloco, e atribua aos moradores que serão os funcionários ou pessoas que participarão do sorteio apenas os números sequenciais. É importante salientar que pessoas/moradores diferentes não podem ter o mesmo apartamento/andar/bloco (o andar e bloco podem ser os mesmos, mas o apartamento precisa ser, no mínimo, um número sequencial).
Cadastrando Vagas
As vagas são a parte mais importante do sistema. Seus dados precisam ser cadastrados de forma correta para que os sorteios possam ocorrer sem erros. O sistema possibilita o cadastro de vagas horizontais e verticais em um mesmo prédio, mas também em prédios/blocos diferentes.
Clicando na opção "Vagas" do menu na barra lateral à esquerda, você irá acessar a tela de cadastro de vagas:
Figura 7: Cadastro de Vagas
Dica
O cadastro de vagas pode ser feito de forma manual ou através da importação de CSV. Para baixar o arquivo de exemplo CSV clique aqui.
Dados obrigatórios para cadastro:
Figura 8: Dados Obrigatórios para Cadastro
- Vaga: número e letras
- Andar: número e letras
- Bloco: número e letras
- Manutenção: Caso a vaga esteja em manutenção ou o usuário queira apenas bloqueá-la para que não possa ser utilizada no sorteio.
Importante
Apenas Administradores do Sistema podem ver todos os Domínios
Dica
Na listagem de vagas há dois ícones em "Ações": um para editar registro e o outro para deletá-lo .
Atenção
Se o seu caso de uso não exige que a vaga tenha andar e bloco, como em indústrias ou vagas horizontais em um mesmo prédio, importe as vagas no mesmo andar e bloco, por exemplo: "001;Térreo;A;nao". Isto quer dizer vaga 001, no andar térreo, no bloco A (fictício, pois pode ser usado para todas as vagas), e "nao" indica que esta vaga não está em manutenção. As vagas, desta forma, podem ser sequenciais ou ter o código alfanumérico que sua empresa/prédio as classifica.
Cadastrando Moradores
O cadastro de moradores pode ser um pouco mais complexo que o cadastro de Apartamentos e Vagas. O sistema foi desenvolvido de forma a atender alguns casos de uso específicos, como dar prioridade a "Pessoas com Deficiência" (PcD), mas também atender a condomínios militares, que podem exigir vagas por ordem de patentes.
Além disso, o sistema também possibilita respeitar a "senioridade" de "Pessoas com Deficiência" (PcD), de "Pessoas da Melhor Idade" ou mesmo de patentes militares. Como isso funciona na prática?
Quando um morador é cadastrado e há posições configuradas, existe a possibilidade de adicionar este morador a um grupo específico a que ele pertença, quando uma "Posição" é atribuída para este morador
Além disso, também é possível que seja atribuída a data na qual este morador adquiriu o seu status da posição, por exemplo: sua Licença de "Pessoa com Deficiência" (PcD), ou a data de aposentadoria da "Pessoa da Melhor Idade", ou a data que uma patente militar foi adquirida pelo morador.
No momento do sorteio, você irá verificar que além de poder dar prioridade de vagas a um grupo específico, você pode também levar em consideração a "senioridade" de cada grupo, fazendo com que pessoas há mais tempo na sua condição possam ter sua vaga garantida primeiro.
O sistema também permite que todo morador escolha ou não uma quantidade de vagas, em ordem de prioridade. Esta lista serve para indicar as possíveis vagas que o morador gostaria de adquirir. No momento do sorteio, esta listagem pode ser considerada ou não, baseada apenas no critério de Sorteio que o usuário do sistema queira atribuir ao sorteio.
Exemplo de Funcionamento:
Se há uma Posição para um grupo de "Pessoas com Deficiência" (PcD), a "Data de Aquisição" pode ser a data que a pessoa adquiriu sua licença. Se há uma Posição para um grupo de "Militares", a "Data de Aquisição" pode ser a data que a pessoa adquiriu sua patente.
Caso esta opção seja escolhida, o Controle de Vaga Inteligente executará o sorteio levando em consideração a senioridade de cada "Posição", e a ordem que foi atribuída para esta "Posição" no momento de seu cadastro.
Se o morador indicou uma listagem de possíveis vagas que ele gostaria de ter, no momento do sorteio, além da prioridade de "Posições" e "Senioridade", o sistema também pode levar em consideração a prioridade atribuída pelo morador na listagem de vagas indicadas por ele.
Limite
O número de Posições é limitado a 30 para todos os planos.
O número de Possíveis Vagas de cada morador é limitado a 10 para todos os planos, e deve ser indicada pela sua prioridade, como veremos a seguir.
Clicando na opção "Moradores" do menu na barra lateral à esquerda, você irá acessar a tela de cadastro de moradores:
Figura 9: Cadastro de Moradores
Dica
O cadastro de moradores pode ser feito de forma manual ou através da importação de um arquivo JSON.
O formato JSON foi escolhido pois a importação de moradores é mais complexa, podendo haver ou não uma lista de possíveis vagas escolhidas pelo morador, e o uso ou não de "Posições".
Lembre-se: A "Posição" dentro do Arquivo JSON deve ser idêntica a cadastrada no sistema, levando em consideração letras Maiúsculas e Minúsculas, assim como Acentuadas ou não.
Atenção
O sistema irá indicar um erro ao final da importação, mostrando se houve falhas, isto ocorre provavelmente pois o arquivo JSON pode conter erro de ortografia em algum de seus campos.
Dados obrigatórios para cadastro:
- Nome Completo: O nome completo do morador
- Email: Um email válido que pertença ao morador de forma que o usuário do sistema, e até mesmo o sistema, possa usar para contato com o morador
- Telefone: Um número de telefone válido que pertença ao morador de forma que o usuário do sistema, e até mesmo o sistema, possa usar para contato com o morador
- C.P.F: O C.P.F do morador (segundo a Lei 14.534 de 2023, o C.P.F se tornou o número único de identificação Federal para todos os Estados do Brasil)
- Posição: Este campo só será obrigatório caso "Posição" seja habilitado no seu sistema, e haverá uma listagem com as "Posições" previamente cadastradas. Neste momento o usuário pode atribuir o Morador ao grupo a que ele pertence
- Data Aquisição: Este campo só será obrigatório caso "Posição" seja habilitado no seu sistema. A data de aquisição do seu status deve ser cadastrada aqui. No caso em que "Posição" não seja habilitado no seu sistema, esta data será fixa em "01/01/1970" e o sistema não a levará em consideração
- Ativo: Este campo permite definir se o Morador está ativo no sistema ou não, por exemplo, caso o Morador tenha viajado por um longo período de tempo e não deva participar do Sorteio, ou caso ele porte algum status que não o deixe participar do Sorteio, então seu status será "Inativo" no momento do sorteio, caso o usuário do sistema decida usar este critério
- Vagas Priorizadas: Este campo permite definir a lista de prioridade de vagas escolhidas pelo Morador. A escolha aqui não indica que esta vaga "pertence" ao Morador, mas que apenas ele tem uma preferência por uma lista de vagas que poderá ou não ser levada em consideração no momento do sorteio, caso o usuário do sistema assim o decida
Mais abaixo, na mesma tela de cadastro de moradores, há a listagem de moradores:
Figura 10: Listagem de Moradores
Importante
Apenas Administradores do Sistema podem ver todos os Domínios
Dica
Na listagem de moradores há dois ícones em "Ações": um para editar registro e o outro para deletá-lo .
Atenção
No momento da criação do seu Domínio pelo sistema, logo após a assinatura do contrato e o pagamento do seu plano, é definido pela pessoa que está se cadastrando no sistema e assinando o contrato se o seu Domínio terá ou não "Posições" influenciando o seu sistema. É de extrema importância salientar que, caso seu Plano tenha direito à "Posições", após o Domínio ter sido criado pelo sistema, esta opção não pode ser mudada facilmente, apenas com o pagamento de uma taxa extra. Portanto, tenha cuidado e escolha a opção correta neste momento.
Executando Sorteios
O coração do sistema. Neste momento você está pronto para a execução do Sorteio Inteligente de forma transparente para a distribuição das vagas de seu parque de estacionamento(s).
Clicando na opção "Sorteio de Vagas" do menu na barra lateral à esquerda, você irá acessar a tela de Sorteio Inteligente:
Figura 11: Tela do Sorteio Inteligente
Atenção
O sistema utiliza um algoritmo único desenvolvido de forma que mesmo que um sorteio seja feito várias vezes, uma mesma vaga não será dada ao mesmo Morador mais de uma vez. Este algoritmo único mantém verdadeiramente uma atribuição de vagas aleatória a cada Morador, respeitando os filtros aplicados pelo usuário.
Opções de Sorteio:
Sorteio Geral
Se nenhuma opção/filtro é selecionado: Todos os moradores participam igualmente
Moradores Ativos
Apenas Moradores cadastrados como "Ativos" serão considerados para o sorteio
Preferência dos Moradores
Durante o Sorteio, o sistema leva em consideração a lista de vagas e a ordem indicada pelo Morador
Hierarquia de Posições
Durante o Sorteio, o sistema leva em consideração a ordem da lista de "Posições"
Antiguidade na Posição
Com esta opção o sistema leva em consideração a "senioridade" do Morador na sua "Posição"
Filtro de "Posição"
O usuário pode optar por executar o sorteio para somente uma determinada "Posição" ou Todas as "Posições" de uma vez
Informação Importante
Caso o usuário opte por executar um sorteio para somente uma "Posição", o sistema manterá o Sorteio ativo para as demais "Posições". O usuário pode escolher usar filtros para uma "Posição" que não serão usados para outras "Posições", como por exemplo: executar o sorteio para a primeira "Posição", respeitando "Hierarquia de Posições", "Preferência dos Moradores" e "Antiguidade na Posição", ou seja, o Sorteio será executado respeitando "Hierarquia de Posições" e "Antiguidade na Posição", e atribuindo possíveis vagas listadas pelo Morador, caso elas estejam disponíveis, e se não, atribuindo vagas aleatórias. Mas para uma segunda "Posição", aplicar apenas "Hierarquia de Posições" e "Antiguidade na Posição". Neste caso, o Sorteio irá atribuir vagas aleatórias para os Moradores respeitando os critérios de "Hierarquia de Posições" e "Antiguidade na Posição" somente.
Após o Sorteio:
Visualização de Resultados:
- • Lista de Escolhas de Vaga
- • Lista de Vagas Sorteadas
- • Relatórios detalhados
Transparência:
- • Registro completo do processo
- • Data e hora de execução
- • Parâmetros utilizados
Relatorio detalhados:
Figura 12: Relatório do Sorteio de Vagas
Figura 13: Relatório de Auditoria de Filtros Utilizados no Sorteio
Figura 14: Relatório de Auditoria de Escolha dos Moradores
Atenção
Os relatórios somente serão gerados se o seu plano de inscrição tenha eles incluidos.
Segurança de Dados
O Controle de Vaga Inteligente foi desenvolvido para aceitar clientes de forma multi-tenant, ou seja, cada cliente possui um Domínio que mantém seus dados protegidos e particionados dentro do banco de dados.
Além disso, senhas são guardadas no banco de dados de forma criptografada com chave SHA-2 de 512 bits, que não podem ser recuperadas, apenas alteradas caso o usuário do sistema deseje trocar sua senha.
Seguindo a Lei Geral de Proteção de Dados Pessoais (LGPD), de nº 13.709/2018, o sistema também armazena todos os dados pessoais de Moradores e do Condomínio, Indústria ou Cliente no banco de dados de forma criptografada, com um algoritmo Advanced Encryption Standard (AES) que também utiliza uma chave SHA-2 de 512 bits.
Os dados são descriptografados de forma segura em tempo real no momento da utilização do sistema. Isto indica que todas as informações são armazenadas criptografadas "in-rest" e somente descriptografadas no momento de cada consulta ou utilização do sistema, tornando o Controle de Vaga Inteligente extremamente seguro e responsável com a Lei Geral de Proteção de Dados Pessoais (LGPD).
O que torna o Controle de Vaga Inteligente único?
Segurança:
- • Dados criptografados "in-rest"
- • Sistema particionado para cada cliente
- • Auditoria gravada em logs de todas as atividades do sistema
- • Diferentes tipos de direitos de usuários para assegurar o acesso
Funcionalidades:
- • Sorteio verdadeiramente aleatório
- • Filtros que permitem respeitar direitos e deveres
- • Sistema de "Posições" que permite atender a qualquer público
- • Controle total de atividades pelo usuário do Domínio
Clicando na opção "Sobre" do menu na barra lateral à esquerda, você irá acessar a tela de Informações do Sistema:
Figura 15: Informações do Sistema e Reset de Dados
Atenção
O usuário "Administrador de Domínio" tem acesso para resetar os dados do seu domínio, ou seja, apagar todos os dados relacionados a "Apartamentos", "Vagas" e todos os dados ligados aos "Moradores". Esta ação é logada em logs de auditoria e sistema, e é IRREVERSÍVEL. Só execute esta ação se tiver certeza do que está fazendo.
Para tanto, digite o seu Domínio, seu usuário de login com direito de "Administrador de Domínio" e sua senha. Haverá algumas confirmações antes da ação ser executada para confirmar que o usuário quer realmente executar este procedimento. Lembre-se: ele é IRREVERSÍVEL.
Precisa de ajuda?
Se você não encontrou o que procura nesta documentação, entre em contato conosco:
Canais de Suporte
Problemas Comuns
Verifique se o domínio, usuário e senha estão corretos
Verifique as permissões e o tipo de usuário
Verifique a ortografia de todos os dados (apartamentos, moradores, vagas, posições)
Certifique-se de que todos os dados estão cadastrados (apartamentos, moradores, vagas)
Verifique se você está no domínio correto do condomínio