/djangoframeworknapratica

Repositório destinado à apostila do curso "Django framework na prática" disponível na Udemy através do link: https://bit.ly/3uwIpmC.

Home

Todo material aqui apresentado serve de guia para o desenvolvimento do curso Django framework na prática e pode ser utilizado como material complementar às aulas disponíveis na plataforma Udemy. Apesar disto, todo o material referente ao livro "Django framework na prática" é de uso aberto e pode ser utilizado no aprendizado livre sem a necessidade de qualquer pagamento, contribuição ou até mesmo compra do curso na plataforma mencionada.

O objetivo do curso é explorar as principais funcionalidades do framework Django por meio da construção de uma dashboard para registro e administração de visitantes de um determinado condomínio. Vamos desenvolver um projeto real e aprender ao longo de seu desenvolvimento o que são as ferramentas que o framework nos dá e como utilizá-las. Seguindo o roteiro aqui apresentado, você vai poder iniciar a sua carreira como desenvolvedor web utilizando a linguagem Python e desenvolver aplicações seguras e escaláveis em tempo recorde.

Inicie no mundo do desenvolvimento fullstack utilizando a linguagem Python!

Conhecendo o processo

O projeto controle-visitantes tem o objetivo informatizar o processo de registro e administração de visitantes do condomínio Montanhas Azuis.

Hoje o condomínio conta com um processo manual e por meio de cadernos que são utilizados para registrar as informações referentes aos visitantes e informatizar esse processo é importante para ganhar tempo no processo, melhorar a experiência de trabalho dos porteiros e ainda armazenar as informações de forma segura e confiável.

O projeto consiste em uma ou mais páginas web em que seja possível registrar visitantes e visualizar suas informações. Além disso, precisamos disponibilizar algumas funcionalidades que seguem os fluxos executados pelo porteiro assim que um visitante chega à portaria e quando o mesmo deixa as dependências do condomínio.

Na imagem abaixo é possível visualizar o fluxo executado pelos porteiros e suas etapas:

Imagem com etapas do processo de registro de visitantes, onde temos quatro etapas: chegada na portaria, aguardando autorização, realizando visita e visita finalizada

Principais funcionalidades

Registro de visitantes

O formulário de registro de visitantes deve abstrair a etapa 01 do processo, onde o visitante informa nome completo, CPF, data de nascimento, o número da casa que deseja visitar e ainda a placa do veículo, se estiver utilizando durante a visita. Além desta informações, o formulário salva o horário de chegada do visitante automaticamente.

Tela de registro de visitante com formulário para inserção das informações

Listagem de visitantes

A listagem de visitantes exibe, por meio de uma tabela, os visitantes recentes classificados por horário de chegada, do mais recente para o mais antigo.

Tela com lista de visitantes recentes

Widgets para resumo de informações

O widgets da página inicial da dashboard têm a função de exibir um resumo dos números referentes aos visitantes em cada status e ainda o número total de visitantes registrados no mês.

Captura de tela de widgets para resumo de informações de visitantes

Visualização de informações de visitante

A partir da tabela que lista os visitantes recentes, é possível acessar a página que exibe as informações detalhadas de cada visitante. No exemplo abaixo um visitante com a visita já finalizada:

Tela de informações de visitante

Autorização de entrada

A tela de informações de vistante é importante pois a partir dela é possível utilizar as funcionalidades de autorização de entrada e finalização de visita.

Quando um visitante está aguardando autorização, o botão para autorizar a entrada fica disponível na tela de informações deste visitante e, para autorizar a entrada, basta clicar no botão para abrir o formulário que deve ser preenchido com o nome do morador que autorizou a entrada do visitante e confirmar a ação.

No exemplo a seguir o visitante está aguardando autorização:

Tela de informações de visitante com botão para autorizar a entrada

Assim como quando o porteiro anotava o nome do morador responsável por autorizar a entrada e o horário de contato com esse morador, a funcionalidade recebe o nome do morador através de um formulário e salva o horário de contato e autorização de forma automática ao concluir a ação.

Tela de informações de visitante ao fundo com alerta exibindo formulário de cadastro de morador responsável

Finalização de visita

Assim como conseguimos utilizar a funcionalidade para autorizar a entrada do visitante, podemos finalizar sua visita. A funcionalidade funciona de forma parecida, com a diferença que é necessário apenas confirmar a ação, sem necessidade de informações adicionais.

Ao clicar no botão para finalizar uma visita, um alerta é exibido solicitando que o porteiro confirme a ação.

Tela de informações de visitante com botão para finalizar visita

Ao confirmar a ação clicando no botão "finalizar visita", o porteiro encerra o processo referente a este visitante e o horário em que a ação ocorreu é registrada.

Tela de informações de visitante ao fundo com alerta exibindo a confirmação de que o usuário realmente deseja encerrar a visita

Os botões "autorizar entrada" e "finalizar visita" são exibidos somente quando é possível executar a ação para o visitante em questão. Caso contrário, como quando o visitante já deixou as dependências do condomínio, nenhum botão é exibido.

Tecnologias utilizadas

O projeto controle-visitantes utiliza as seguintes tecnologias e recursos de código aberto:

Requisitos desejáveis

Para um bom aproveitamento de todo material e atividades aqui propostas, é desejável que você tenha os seguintes conhecimentos:

  • Conhecimentos básicos da linguagem Python
    • Funções
    • Noções de Programação Orientada a Objetos
      • Classes
      • Instância de classe
      • Atributos
      • Métodos
  • Conhecimentos básicos em HTML, CSS e JS
  • Sistema operacional baseado em Unix
  • Conhecimentos básicos em terminal