jvitor - João Vitor Wolfart

20 de julho de 20221 de março de 2023

API CEP e IBGE

Após o primeiro projeto de consumo de API que foi o das informações de filmes, o professor Wildson do Jovem Programador módulo 3 nos lançou um desafio de construirmos um novo projeto, onde ficaríamos livres para escolher a API que quiséssemos e deveríamos apresentar esse projeto para a classe.

O desafio consistia em pelo menos uma API, porém eu inicialmente optei por fazer um projeto utilizando uma API do IBGE, a API que eu escolhi para meu projeto foi a API de nomes, mas no decorrer do projeto, também achei muito legal e útil a API de CEPs do viacep, portanto resolvi fazer o meu projeto utilizando essas duas APIs.

Na tela inicial haverá dois ícones para o usuário escolher qual API quer ver.

API de nomes do IBGE

Essa é uma API muito legal que encontrei no site do IBGE, ela traz diversas informações estatísticas sobre os nomes baseado nos censos do IBGE.

No momento essa API possui informações estatísticas até a década de 2010, sobre os nomes das pessoas.

Meu projeto nesta API constitui do seguinte:

Barra de pesquisa onde o usuário digita um nome, e o sistema retorna a quantidade de ocorrências daquele nome em cada década, desde 1930 até 2010
Um botão para ver o ranking dos 20 nomes mais utilizados, em geral (masculino e feminino)
Um botão para ver o ranking dos 20 nomes mais utilizados, apenas masculino
Um botão para ver o ranking dos 20 nomes mais utilizados, apenas feminino
Um botão para ver o ranking dos 20 nomes mais utilizados de uma década selecionada

Ainda neste APP, tem um link para uma página de curiosidades sobre esta API, que basicamente traz algumas perguntas e respostas mais comuns sobre a API, e também um botão de Home para voltar a tela inicial.

API de CEPs

Sempre tive curiosidade de trabalhar com essa API, pois sempre achei que ela pode ser muito útil na prática para fazer cadastros, essa é a API de CEPs do viacep.

O APP que desenvolvi basicamente consiste em:

Podemos ver que nessa opção de consultas existe um botão de mais detalhes, e ao clicar nesse botão, o sistema vai retornar os detalhes do registro selecionado, que será basicamente os dados que aparecem na primeira consulta, onde informamos o CEP.

Conclusão

Fiquei muito satisfeito com o resultado do meu projeto, pois atingiu o objetivo proposto pelo desafio, e exercitei a lógica para o consumo de APIs.

Gostei tanto do resultado desse projeto, que resolvi fazer o deploy em minha VPS.

Vou deixar abaixo o link para este projeto no Github e também o link para o deploy em minha VPS.

19 de julho de 20221 de março de 2023

Projeto Info Filmes

Uma das coisas que aprendi no módulo 3 do curso Jovem Programador Senac foi consumir dados de uma API através de requisições, baseado no que aprendemos, recebemos a missão de desenvolver um site de informações de filmes utilizando dados da API https://www.omdbapi.com/

Esta API possui um banco de dados com informações de vários filmes e séries, então tivemos que desenvolver um projeto com os seguintes requisitos:

Como eu desenvolvi meu projeto

Para fazer o Front End utilizei o Bootstrap, aproveitando suas facilidades e a responsividade.

Na página inicial coloquei um carrossel com algumas imagens de capas de filmes.

Ao clicar em “Fazer login” o usuário será redirecionado para a tela de login, onde ele pode se logar, ou se cadastrar caso não tenha cadastro.

Após logado, o usuário tem uma barra de pesquisa onde ele pode digitar um termo, e o sistema vai fazer a consulta na API de filmes e retornar os dados de filmes e séries que correspondem ao termo digitado.

Por exemplo: Ao digitar Star Wars, o sistema retornará uma lista com todos os títulos relacionados a Star Wars.

Na lista vai aparecer a capa do título (caso a API retorne a imagem de capa), ou “sem imagem” caso a API não disponha da imagem de capa.

Vai aparecer também o título, o tipo (série, filme, etc, dependendo do que está na API) e o ano.

Além dessas informações, coloquei um botão de mais informações, que ao clicar, o sistema irá buscar na API detalhes sobre o título solicitado.

Coloquei também uma estrela para identificar se o usuário classificou aquele título como um de seus favoritos (apesar de não ser um critério solicitado no desafio do projeto). Se a estrela aparecer amarela é porque esse filme já foi marcado como favorito por esse usuário, se aparecer azul é porque ainda não foi marcado como favorito.

Nesta tela de detalhes vão aparecer todas as informações do título que o sistema encontrar na API.

Algumas das informações disponíveis são:

Sinopse do título
Avaliação geral do título
Número de avaliações do título
Imagem (se disponível na API)
Atores
Fontes das avaliações
Data de lançamento
País de origem
Idioma
Classificação etária
Premiações
Roteiristas

OBS: Todas as informações serão em Inglês, pois é o idioma que a API retorna, dependendo do título podem vir mais, ou menos informações do que as citadas acima, pois o sistema trará todas as informações disponibilizadas pela API.

Se o usuário não tiver favoritado o título ainda, vai aparecer um botão logo abaixo da imagem de capa, permitindo que ele favorite o título, caso o título já esteja favoritado pelo usuário, vai aparecer um botão permitindo desfavoritar o título.

Ao clicar sobre o nome do usuário, vai ter a opção de verificar todos os seus favoritos, ou sair do sistema.

Conclusões finais do projeto

Este projeto serviu para conhecer como funciona o consumo de uma API, e foi muito importante, pois sabemos que na prática isso é muito utilizado.

Foi minha primeira experiência com consumo de API.

Neste projeto utilizei basicamente os seguintes recursos:

Python
Django
Bootstrap
API do OMDB
Biblioteca requests
Banco de dados Sqlite (para desenvolvimento)
Banco de dados Postgresql (para o deploy)

OBS: O banco de dados foi utilizado apenas para os recursos necessários do Django e também para o sistema de favoritar os títulos para os usuários, mas as demais informações dos títulos vêm diretamente da API.

18 de julho de 20221 de março de 2023

Projeto E-commerce

Esse projeto foi um desafio proposto pelo curso Jovem Programador Senac módulo 3, que consiste em explorar um pouco do que aprendemos durante o curso englobando as principais stacks estudadas no curso.

Este trabalho era individual e o tema proposto pelo desafio era um E-commerce de uma loja de livros, para isso deveríamos usar o framework Django para desenvolver este projeto.

Basicamente este projeto deveria ter ao menos o seguinte:

Esses acima eram os requisitos mínimos do projeto.

Como pensei e desenvolvi esse projeto

Para fazer o Front End, eu utilizei o Bootstrap para aproveitar suas funcionalidades e também a responsividade.

Quanto ao conteúdo do site, fiz um cadastro básico de livros que é feito utilizando a interface administrativa do próprio Django. Criei também um cadastro de categorias para dividir os livros por categoria, pensando em facilitar as consultas.

Os principais campos de cadastro do livro são:

Título do livro
Categoria
Autor
Excerto
Sinopse
Valor
Quantidade em estoque
Avaliação média
Número de avaliações
Número de unidades vendidas
Imagem da capa
Destaque

Na barra de navegação coloquei o campo de pesquisa, onde é possível pesquisar por um termo e o sistema retorna se aquele termo está presente no título, autor, ou categoria.

Nesta barra de navegação também tem um pequeno menu com as categorias, onde, ao clicar em uma delas o sistema retornará todos os livros daquela categoria em uma lista.

Quando o usuário estiver autenticado, vai ter também um menu com algumas funções que o usuário pode fazer, sendo elas:

Além disso, nessa mesma barra de navegação terá também o ícone para o carrinho de compras, e a indicação de quantos itens estão no carrinho, e também a opção para fazer logout.

Na página inicial coloquei um carrossel que mostra os cinco livros com a melhor média de classificação, e logo abaixo uma galeria com as novidades, que são os oito últimos livros adicionados ao sistema.

Acessando o botão “mais títulos” no final da página inicial, vai abrir uma lista com todos os títulos cadastrados em ordem alfabética pelo título, com uma paginação apresentando 5 livros por página.

Esse exemplo de tela também é a que aparece para as categorias, ou então para as consultas feitas pela barra de pesquisa.

Nessa lista aparecem as informações do livro como:

Imagem da capa
Título
Autor
Categoria
Preço unitário
Média de avaliação
Número de avaliações

Selecionando algum item da lista, vai aparecer os dados detalhados desse item, como por exemplo, sua sinopse, sua média de avaliação, seu preço, se o produto está em estoque e também as opções de adicionar ao carrinho, deixar uma avaliação, ou ver todas as avaliações.

As avaliações podem ser anônimas caso a pessoa não queira se identificar, ou não esteja autenticada no sistema.

Se o produto não estiver em estoque não vai aparecer a opção de adicionar ao carrinho, ao invés disso vai aparecer a opção “Avise me quando estiver disponível”.

Se o usuário não estiver devidamente autenticado e clicar em “Adicionar ao carrinho”, será direcionado a tela de login para fazer autenticação, e logo após, poderá retornar e adicionar o item ao seu carrinho, caso ele já esteja autenticado, poderá diretamente adicionar o item ao seu carrinho.

Carrinho de compras

Ao entrar na tela do carrinho, o usuário verá todos os itens adicionados em seu carrinho, tendo a possibilidade de adicionar, ou remover unidades daquele item, e também as opções de finalizar pedido ou adicionar mais produtos.

Ainda nesta tela, tem a opção de calcular o frete (como é apenas um trabalho didático, considerei como regra de negócio que o frete de cada livro custa R$ 4,99 e se comprar acima de 10 unidades, o frete é grátis).

Caso o usuário tente finalizar o pedido sem calcular o frete o sistema não vai permitir, solicitando que calcule o frete para prosseguir.

Após calcular o frete já é possível finalizar o pedido, com isso, o usuário será direcionado para a tela de finalização do pedido.

Ao finalizar o pedido, caso o usuário não tenha nenhum endereço de entrega cadastrado, ele será redirecionado a tela de cadastro de endereço, e se já tiver algum endereço cadastrado, será direcionado para a tela de conclusão do pedido.

Caso ele queira adicionar um novo endereço de entrega, também haverá a opção nessa tela para cadastrar um novo endereço.

Após isso, o usuário deverá selecionar o endereço de entrega que prefere, e também a forma de pagamento, e então será possível prosseguir para a última parte que é a finalização do pedido.

Nesta parte basta o usuário conferir se está tudo de acordo, caso não esteja ele pode retornar e fazer as correções necessárias, e se estiver tudo de acordo, basta confirmar a compra.

Após isso, o sistema já vai dar baixa no estoque dos livros, e o usuário já poderá acessar no seu painel os dados de seus pedidos.

Conclusão final do projeto

Vale lembrar que como se trata de um projeto didático, foram abstraídas diversas funcionalidades que sei que um E-commerce de verdade deve ter.

O desafio era apenas a lógica básica de um E-commerce, com o carrinho de compras, os pedidos e o controle de estoque.

Foi um projeto bastante desafiador para um programador de nível inicial como eu, mas que serviu para colocar em prática e exercitar bastante a lógica de um E-commerce.

Neste projeto foi exercitado bastante a parte dos models e das views do Django, inclusive, como fiz deploy deste projeto em minha VPS, tive que utilizar o Cloudinary para hospedar as imagens das capas dos livros.

Vou postar abaixo um link para o deploy em minha VPS e também um link para o projeto no meu Github.

15 de julho de 20221 de março de 2023

Projeto estoque

Durante o módulo 3 do curso Jovem Programador Senac, aprendemos sobre desenvolvimento Web, e um dos desafios durante o curso foi o desenvolvimento de um sistema de controle de estoque, que tivesse os seguintes requisitos:

Sistema de controle de acesso com login e senha
Opção de cadastro de usuário
Opção de alteração de senha de acesso
Barra de pesquisa
Cadastro de produtos
Página de informações do produto
Opções para movimentação de estoque (entradas e saídas)
Controle de estoque do produto

Além desses requisitos, a regra que o professor exigiu nesse desafio, era que cada usuário fosse independente, ou seja, cada usuário iria cadastrar os seus produtos e fazer as suas movimentações, os registros de todos os usuários ficariam no mesmo banco de dados, porém, cada usuário só teria acesso aos seus registros.

Esses acima eram os requisitos que o desafio exigia, e também, foi sugerido de utilizarmos o máximo de conhecimentos que tínhamos até aquele momento do curso, como por exemplo, no cadastro de produtos tivesse a opção de colocar uma imagem para o produto.

Além disso, também era necessário que fosse possível fazer o CRUD, e que também tivesse um dashboard do produto, mostrando as suas posições de estoque, e algumas informações a respeito da movimentação do estoque.

Com isso, pensei em um sistema que de uma forma simples, simulasse um sistema de vendas, com entradas e saídas para poder controlar o estoque.

Além disso, criei categorias para classificar os produtos e unidades de medida para controlar as entradas e saídas do estoque.

Outra coisa que criei para ser um diferencial no dashboard do produto no meu sistema, foi o cálculo de preço médio de compra e preço médio de venda.

Mas para isso, tive que imaginar duas situações, a primeira é a situação de operação comercial que é a compra e a venda do produto, que são operações que devem ser levadas em conta para calcular um preço médio de compra e um preço médio de venda, assim como entrada e saída do estoque.

A segunda situação é a operação que é apenas contábil, que seria as devoluções para fornecedor, e também devoluções de clientes, que são operações que devem ser levadas em conta para a movimentação do estoque, porém não devem ser levadas em conta para calcular o preço médio de compra e venda.

Para resolver esse problema, criei um cadastro de tipos de movimentação, onde podem ser criados os tipos de movimentação necessários de acordo com a regra de negócio, como por exemplo, uma operação de venda a consumidor final, essa operação seria uma operação de saída e uma operação comercial. Já a compra de um item pra estoque seria uma operação de entrada e também uma operação comercial. Por outro lado, a devolução de um item que um cliente comprou e devolveu seria uma operação de entrada, mas que seria apenas contábil, da mesma forma que um produto que fosse devolvido para o fornecedor seria uma operação de saída, e somente contábil.

O cadastro de produtos, fiz bem simples, ele tem apenas os seguintes campos:

Nome do produto
Preço de venda
Descrição detalhada do produto (opcional)
Categoria (eletrônicos, bazar, alimento, etc.)
Unidade de medida (kg, caixa, un, pacote, etc.)
Imagem do produto (opcional)

Na barra de pesquisa na página inicial, é possível pesquisar por um termo e o sistema retornará se encontrar esse termo, no nome do produto ou na sua descrição.

Na tela inicial também vamos ter um atalho para o cadastro de produtos, e para os cadastros auxiliares (cadastro de categorias, cadastro de medidas e cadastro de tipos de movimentação)

Nesta mesma tela, também temos um botão para mais consultas, nessa opção é possível efetuar a consulta por categoria, e também verificar os itens com pouco estoque (inicialmente ele trará os itens cujo estoque estiver zerado, mas tem um campo onde pode ser informado abaixo de quantas unidades você quer que liste, exemplo: ver todos os itens com menos de 10 unidades em estoque).

Assim como a opção de consultar itens com pouco estoque, há também a opção de consultar itens com muito estoque, para isso é só entrar na opção consultar itens com muito estoque, e informar a quantidade acima de qual você considera que é muito estoque (por padrão ele começará mostrando os itens com mais de 10 unidades, mas você pode informar outra quantidade se preferir)

Na página inicial, vai aparecer todos os itens cadastrados (são 5 itens por página, sendo que aparece sempre os últimos cadastrados) clicando no nome do produto, ou no Id, vai abrir a página de informações do produto, por essa página é possível ver todos os detalhes do produto e também lançar movimentações de entrada e saída.

Clicando no ícone da lupa, vai abrir a tela de movimentação desse produto, nessa tela, vai aparecer os dados do produto, como por exemplo, a quantidade em estoque, preço da última compra, preço de venda, data da última compra e data da última venda. E também a sua movimentação com opção de eliminar o registro de movimentação.

Nessa tela também vai ter a opção de lançar entradas ou saídas do produto.

Na tela de relatório do produto, existe o botão de acesso ao dashboard do produto, nesse dashboard será possível ver com mais detalhes diversas informações relevantes sobre esse produto, como por exemplo:

Dados do produto
Quantidade em estoque
Preço de venda
Preço da última compra
Data da última venda
Data da última compra
Quantidade de produtos vendidos
Total de valor das vendas do produto (faturamento)
Preço médio de venda do produto
Quantidade de produtos devolvidos/estornados para o fornecedor
Total de valor contabil dos itens devolvidos/estornados para o fornecedor
Quantidade de produtos comprados
Total de valor das compras do produto
Preço médio de compra do produto
Quantidade de produtos devolvidos ou com vendas canceladas
Total de valor contabil dos itens devolvidos ou com vendas canceladas
Lucro total na venda pelo preço médio
Lucro médio por item na venda das Unidade(s) vendidas
Margem de lucro baseada no preço médio
Projeção de estimativa de faturamento com a venda do estoque
Estimativa de lucro na venda do estoque

Nesse sistema também, aproveitei para exercitar e fazer diversas validações, como por exemplo: caso não tenha estoque suficiente, não permitir a venda, caso o produto tenha em estoque, não permitir desativação, caso não tenha sido realizada nenhuma movimentação o sistema não permite acessar o dashboard financeiro do produto, ao fazer movimentações, se a movimentação for entrada aparece apenas as opções que são do tipo entrada, da mesma forma, ao fazer saída só aparecem as movimentações do tipo saída.

Movimentações do tipo entrada somente contábil vão dar entrada no estoque, mas não vão influenciar no preço médio, assim como saídas do tipo somente contábil vão dar saídas no estoque mas não vão influenciar no preço médio.

Finalmente, após o projeto ser concluído, fiz o deploy dele em minha VPS.

14 de julho de 202218 de julho de 2022

Site para anunciar os negócios locais da minha região

Depois de desenvolver o site da pousada da minha família, tive outra ideia para um projeto pessoal para praticar meus conhecimentos, decidi então, fazer um site anunciando os negócios locais da minha região, esse site inclusive, foi o primeiro desenvolvido com o domínio pinheirasc.com, que ganhei de aniversário do meu pai, e utilizo até hoje em meus projetos.

Basicamente, esse site consiste de vários posts anunciando os diversos imóveis da minha região, esses posts contêm uma descrição e fotos dos imóveis, além de mapa no Google Maps, localização no Google Street View e link para contato com proprietário do imóvel.

Este site foi apenas um exercício didático, com intenção de anunciar os negócios da minha região, não havendo nenhum custo para os proprietários dos imóveis, basicamente, se algum proprietário de algum imóvel quisesse seu anúncio no site, ele só precisava entrar em contato comigo pelo Whatsapp, me enviar as fotos e as informações que ele queria, e eu me encarregava de fazer o post sobre seu imóvel.

Para quem tiver interesse e quiser conhecer esse site, basta clicar no botão abaixo.

14 de julho de 202218 de julho de 2022

Site da pousada Residencial Sol de Verão

Com o sucesso do meu primeiro projeto pessoal (site de matemática), resolvi continuar desenvolvendo projetos pessoais.

Foi então que tive a ideia de desenvolver um site sobre a pousada da minha família, uma pousada familiar localizada na Praia da Pinheira onde moro, e de onde meus pais tiram nosso sustento.

Basicamente o site consiste de páginas estáticas falando sobre as opções que temos disponível para aluguel, com algumas fotos, e uma breve descrição sobre as acomodações, além de um mapa do Google Maps com a localização, tanto da pousada, quanto dos outros imóveis que meu pai aluga, e também um link pro Whatsapp dele para quem quiser fazer reserva.

Para quem tiver interesse, basta clicar no botão abaixo.

14 de julho de 202218 de julho de 2022

Site de matemática

Como dito anteriormente, eu fui apresentado a programação e a TI durante o começo da pandemia, com um curso de desenvolvimento Web da Udemy, após algumas aulas desse curso, e também, vendo que meus amigos da escola estavam com bastante dificuldade nos conteúdos de matemática (na época estávamos aprendendo sobe função quadrática), e também pelo fato de eu adorar matemática, eu tive a ideia de desenvolver um programa capaz de resolver fórmula de Bháskara.

O programa é bastante simples, você apenas tem que informar os coeficientes a, b e c, e o programa retorna o Delta, as raízes da equação (caso elas existam), o x e o y do vértice, e também desenha um gráfico dessa função, após vários testes, consegui fazer o programa funcionar perfeitamente.

Com o tempo fui aprendendo novos conteúdos nas aulas de matemátcia e física, então fui fazendo mais programas como esse para calcular outras fórmulas, e também incluí algumas páginas estáticas explicando brevemente sobre essas fórmulas, ou, algumas vezes contando algumas curiosidades.

Apesar desse site ter sido desenvolvido com WordPress, o grande diferencial dele é que vários desses posts têm funções de Javascript feitas por mim para realização dos cálculos, alguns desses posts são:

Caso você tenha se interessado e queira conferir, clique no botão abaixo, ou num dos links acima.

13 de julho de 202216 de julho de 2022

Projeto salão de beleza

Esse foi meu projeto final do Jovem Programador módulo 2.

O projeto foi feito em duplas, e eu desenvolvi ele junto com minha colega Eduarda Bittencourt. A Eduarda ficou responsável pela escolha das cores, e da parte visual do sistema, enquanto eu fiquei responsável pela lógica e desenvolvimento.

Esse projeto na verdade é uma evolução natural do projeto da padaria, pois me baseei bastante no projeto da padaria para desenvolver este projeto com inúmeras melhorias e também para que ele ficasse com um nível mais avançado do que o anterior (projeto da padaria).

Principais evoluções em relação ao projeto da padaria:

Avisos de pendências emitidas pelo sistema automaticamente
Melhoramento da seção de estatísticas
Inclusão de uma seção de agendamento, além de registro de venda pelo agendamento
Sistema de fidelização de clientes
Mais opções de consulta de registros

O projeto consiste basicamente em:

Um cadastro de usuários (somente permitido a usuários com permissão ROOT)
Permissão de acessos dependendo do nível do usuário
Cadastro simples de clientes
Cadastro de funcionários/profissionais
Cadastro de serviços
Cadastro de formas de pagamento
Registro de vendas (simula emissão de uma nota fiscal)
Estatísticas dos dados
Agenda de atendimentos
Emissão de notas automaticamente a partir do agendamento

É utilizado o banco de dados Sqlite3.

Regra de negócio deste projeto

O usuário deve ser cadastrado apenas pelo ROOT ou por algum usuário com permissões de ROOT, este por sua vez poderá, no momento do cadastro, ou a qualquer momento, setar as permissões dos demais usuários, incluindo dar a eles permissão de ROOT, as permissões possíveis são:

Somente cadastro (permite apenas inserir novos clientes, produtos e formas de pagamento, além de alterar os que já existem, porém não é capaz de desativar ou reativar registros, nem de fidelizar ou desfidelizar clientes, pois essas funções são exclusivas do usuário com permissão de ROOT)
Faturamento (permite, além do cadastro e manutenção de registros, o acesso a área de faturamento)
Estatísticas (permite, além do cadastro e manutenção de registros, o acesso a área de estatísticas)
Agenda (permite, além do cadastro e manutenção de registros, o acesso a área de agenda)
ROOT (permite acesso a todo o sistema)

OBS: Um usuário pode acumular várias permissões de acordo com o que for setado pelo ROOT.

Assim como no projeto da oficina e da padaria, existe um superusuário que através dele poderá ser setado ao primeiro usuário cadastrado a permissão de ROOT e após isso esse primeiro usuário já pode setar as permissões aos demais usuários.

Ao entrar no sistema o usuário deve receber uma mensagem de boas vindas informando suas permissões. De acordo com suas permissões será as opções que ele deve ter disponível na tela.

Caso seja apenas cadastro ele terá acesso apenas ao menu de cadastros de forma parcial, pois algumas funções não ficarão disponíveis, como por exemplo o cadastro de usuários, e também ele não poderá fazer desligamento ou reativação de registros, nem fidelização ou desfidelização de clientes, pois essas são prerrogativas apenas do ROOT.

Se a permissão for faturamento, ele vai poder, além das opções de cadastro, acessar a área de faturamento.

Se a permissão for estatísticas, ele vai poder, além das opções de cadastro, acessar a área de estatísticas.

Se a permissão for agenda, ele vai poder, além das opções de cadastro, acessar a área de agenda.

Caso o usuário tenha permissão de ROOT ele poderá setar as permissões para ele mesmo e os demais usuários, portanto se ele tiver a permissão de ROOT ele consegue fazer o que quiser no sistema.

Área de faturamento:

É a área responsável pelo registro das vendas, as opções são:

Emissão de nota fiscal avulsa (quando o cliente é atendido sem agendamento)
Emissão de nota fiscal pelo agendamento (quando o cliente fez um agendamento prévio e foi atendido e o setor de agenda libera para emissão automática da nota baseado nos dados do agendamento)
Manutenção e consulta de notas fiscais (permite consultar notas emitidas e também fazer cancelamento de nota, ou em caso de notas pendentes de emissão, concluir a emissão da nota)

Quanto aos registros de venda (notas fiscais):

Para emitir o registro de venda avulsa, o usuário seleciona o cliente, e em seguida ele é direcionado para a tela onde vai adicionar os serviços e os funcionários que efetuaram os serviços, após adicionar todos os itens ele tem duas opções, uma delas é terminar a nota e emitir ela (nesse caso o processo já fica concluído e a nota passa para o status de “Emitida”) e a outra opção é de fechar a tela de emissão de notas, e com isso a nota ficaria com status de “Pendente”, pois ela não foi emitida de fato, enquanto ela estiver pendente é considerado que a venda não se realizou ainda, e portanto o usuário pode entrar nela novamente, incluindo ou excluindo serviços, alterando dados da nota, após o usuário concluir ele deve emitir a nota, e com isso a nota passará pro status de “Emitida”, e passará a constar como registro para as estatísticas, e a partir disso não será mais possível fazer nenhuma alteração na nota, a não ser o seu cancelamento (se o usuário tiver essa permissão). Ao cancelar a nota fiscal o seu status passa para “Cancelada”, seu valor é zerado e ela automaticamente não é mais considerada nas estatísticas, porém seu registro permanece no sistema.

Para emitir o registro de venda por agendamento, o sistema aproveita os dados do agendamento para o registro da venda, bastando para isso que o setor de agendamento sinalize que o serviço já foi efetuado.

Detalhe importante: O ideal é que não hajam notas pendentes, pois o objetivo da nota é ser emitida, portanto, sempre que o usuário com permissões de faturamento entrar no sistema, ou fizer logout, o sistema verifica se existe alguma nota pendente e informa o usuário para que ele corrija.

Quanto a agenda:

Nesta área é possível fazer o agendamento de serviços, para isso deve informar a data prevista e então o sistema vai mostrar todos os serviços agendados a partir daquela data selecionada, é possível também ver a agenda dos profissionais, e também ver todos os agendamentos pendentes.

O que são agendamentos pendentes?

Ao entrar no sistema, o sistema checa automaticamente todos os agendamentos anteriores a data atual do sistema que estejam com status de “Agendado”, e altera seu status para “Pendente”, pois por algum motivo a pessoa responsável por cuidar da agenda não alterou o status daquele agendamento até a data prevista para sua execução, pois quando o serviço é efetuado deve ser alterado o status da agenda de “Agendado” para “Serviço efetuado”, ou caso o serviço não tenha sido efetuado por algum motivo, setar o status que justifique o agendamento.

Os status de agendamento possível são:

Agendado (quando é feito o agendamento)
Serviço efetuado (quando o serviço foi efetuado)
Cancelado pelo cliente (quando o cliente cancela o agendamento, essa opção também pode colocar o cliente na lista negra, fazendo com que ele possa perder seu status de fidelizado)
Cliente não compareceu (quando o cliente não comparece, e também não entra em contato para cancelar, essa opção também pode colocar o cliente na lista negra, fazendo com que ele possa perder seu status de fidelizado)
Eliminar agendamento (quando o agendamento foi feito de forma errada, e precisa ser eliminado sem causar prejuízo ao cliente que fez o agendamento)
Nota fiscal emitida (quando o serviço já foi efetuado e a nota já foi emitida pelo faturamento, utilizando como base os dados do agendamento)
Pendente (quando o agendamento, até sua data não obteve troca de status, ele é setado automaticamente pelo sistema para "Pendente")

Detalhe importante: Sempre que o usuário com status de agenda acessa o sistema, ou faz logout ele recebe o aviso se tem algo pendente, semelhante a como acontece com o usuário de faturamento, caso o usuário tenha as duas permissões, ele recebe ambos os avisos, do faturamento e da agenda.

Quanto as estatísticas:

As opções de estatísticas são:

Estatísticas de vendas realizadas (leva em consideração apenas o que já foi emitido de notas fiscais)
Estatísticas de projeções futuras baseadas na agenda (leva em consideração a previsão de faturamento baseado nos agendamentos, ou seja, aquilo que ainda não foi realizado, mas está agendado)
Estatísticas de vendas por gênero (semelhante as estatísticas por vendas realizadas, porém levando em consideração apenas o gênero do cliente)
Estatísticas de projeções futuras por gênero (semelhante as estatísticas de projeções futuras, porém levando em consideração apenas o gênero do cliente)

Todas as opções de estatísticas têm opções de consulta por todo o período, ou por intervalo de datas.

Opções das estatísticas de vendas realizadas:

OBS: Essas opções podem ser selecionadas para todo o período, que vai levar em conta todos os registros do banco de dados, ou apenas por um intervalo de datas que levará em conta apenas os registros que estão naquele intervalo de datas.

Opções das estatísticas de projeções futuras:

Nesta opção é necessário selecionar o intervalo de datas que deseja ver a previsão baseada na agenda, a data inicial precisa ser igual ou superior a data do sistema, e também selecionar a data final da estatística. Com isso o sistema vai mostrar os seguintes dados:

Também vai mostrar na última aba uma “lista negra” de clientes que cancelaram ou não apareceram em agendamentos, e esta informação pode ser útil para definir se o cliente pode perder o status de fidelizado, perdendo assim os descontos.

Estatísticas por gênero:

No caso das vendas realizadas vai mostrar o total por gênero, baseado nas vendas realizadas, e tem a opção de escolher intervalo de datas. No caso das projeções futuras, a mesma coisa, porém baseado nos agendamentos futuros.

Fidelização de clientes:

O ROOT tem a prerrogativa de fidelizar ou desfidelizar os clientes, de acordo com as regras de negócio estabelecida e também os dados estatísticos que o sistema fornece. Quando o cliente é fidelizado ele possui a possibilidade de receber um desconto especial, que deve ser definido na hora do registro da venda pelo faturamento, esse desconto pode ser de 0 até 20% dependendo da regra de negócio. Caso o cliente não seja fidelizado, no momento da emissão da nota não haverá a opção do desconto, mas caso ele seja fidelizado, no momento da emissão da nota vai aparecer um slider permitindo setar o percentual de desconto para o serviço a ser faturado.

Assim como no projeto da padaria, existem várias opções de consultas de vendas, que podem ser acessadas no menu faturamento, na opção manutenção de notas, são elas:

Todas as notas (mostra as últimas 50 notas)
- Todas as notas emitidas (mostra as últimas 50 notas emitidas)
- Todas as notas pendentes (mostra as últimas 50 notas pendentes)
- Todas as notas canceladas (mostra as últimas 50 notas canceladas)
Notas por data da venda (selecionar a data desejada)
- Todas as notas por data de venda
- Notas emitidas por data de venda
- Notas pendentes por data de venda
- Notas canceladas por data de venda
Notas por cliente (selecionar o cliente desejado)
- Todas as notas por cliente
- Notas emitidas por cliente
- Notas pendentes por cliente
- Notas canceladas por cliente
Notas por intervalo de notas (informar o intervalo de notas que deseja)
- Todas as notas por intervalo de notas
- Notas emitidas por intervalo de notas
- Notas pendentes por intervalo de notas
- Notas canceladas por intervalo de notas
Notas por intervalo de datas (informar o intervalo de datas desejado)
- Todas as notas por intervalo de datas
- Notas emitidas por intervalo de datas
- Notas pendentes por intervalo de datas
- Notas canceladas por intervalo de datas

Em resumo, podemos ver que esse sistema é relativamente complexo, e é uma grande evolução em relação ao sistema da oficina e da padaria, pois já possui uma complexidade considerável e grandes evoluções. Neste projeto consegui explorar bastante a linguagem SQL para fazer as consultas e as estatísticas do banco de dados, mas o que achei um pouco mais complexo de desenvolver é a lógica das vendas levando em consideração a fidelização do cliente.

Também esse sistema foi super importante para exercitar a lógica de permissão, do que os usuários podem ou não podem fazer, dependendo de suas permissões, e também a lógica dos registros de vendas e dos dados para formação das estatísticas.

Um grande desafio foi fazer a emissão de nota automaticamente através do agendamento, e também o controle dos agendamentos pendentes que é feito unico e exclusivamente pelo sistema, tanto no login quanto no logout do usuário, levando em consideração suas permissões.

Esse projeto foi um grande desafio, mas consegui a nota máxima ao apresentar ele como projeto integrador no final do curso no Senac.

Quem quiser ver como ficou basta baixar esse projeto, e instalar as dependências (basicamente pyqt5) e o Python na versão 3.x

Para poder cadastrar um usuário e setar suas permissões deve utilizar inicialmente o superusuário ROOT e a senha manager.

Para executar o sistema utilize o arquivo menu.py, que vai abrir a tela de login, onde você poderá logar com o superusuário ROOT, cadastrar um usuário, setar suas permissões e em seguida logar novamente com o usuário que você cadastrou e testar para ver como ficou esse meu projeto final do Jovem Programador Senac módulo 2.

11 de julho de 202216 de julho de 2022

Projeto padaria

Esse foi meu segundo projeto do Jovem Programador módulo 2.

Esse projeto na verdade é uma evolução natural do projeto da oficina, pois me baseei bastante no projeto da oficina para desenvolver este projeto com inúmeras melhorias e também para que ele ficasse com um nível mais avançado do que o primeiro (projeto da oficina).

Principais evoluções em relação ao projeto da oficina:

Na parte da interação com o banco de dados, nesta versão da padaria já foi evoluído para evitar risco de SQL injection
No sistema da padaria foi incluído uma seção apenas para estatísticas dos dados
Como a maioria dos registros do banco de dados se relaciona de alguma forma, incluí o campo de status, onde sinaliza se o registro está ativo ou inativo, dessa forma mantendo os registros e integridade do banco de dados

O projeto consiste basicamente em:

Um cadastro de usuários (somente permitido a usuários com permissão ROOT)
Permissão de acessos dependendo do nível do usuário
Cadastro simples de clientes
Cadastro de funcionários
Cadastro de produtos
Registro de vendas (simula emissão de uma nota fiscal)
Estatísticas dos dados

É utilizado o banco de dados Sqlite3.

Regra de negócio do projeto

Somente consulta (quando não tem nenhuma permissão setada)
Criar (permite cadastrar novos produtos, clientes e emitir notas)
Editar (permite alterar produtos, clientes e notas pendentes)
Excluir (permite desativar produtos e clientes e cancelar notas)
ROOT (permite setar permissões para os usuários, e também cadastrar, editar ou desligar funcionários)

Assim como no projeto da oficina, existe um superusuário que através dele poderá ser setado ao primeiro usuário cadastrado a permissão de ROOT e após isso esse primeiro usuário já pode setar as permissões aos demais usuários.

Ao entrar no sistema o usuário deve receber uma mensagem de boas vindas informando suas permissões. De acordo com suas permissões será as opções que ele deve ter disponível na tela.

Caso seja apenas consulta ele terá acesso a parte das estatísticas e a todo restante do sistema apenas como consulta, não podendo fazer alterações, iclusões ou qualquer outra ação que não seja consulta.

Se a permissão for criar, vai poder cadastrar produtos e clientes, e também emitir notas, além de poder ter acesso as estatísticas, porém não poderá alterar dados existentes, pois para isso é necessário a permissão de editar, com exceção de notas que ainda estejam com status pendente.

Se a permissão for editar, ele poderá apenas editar os registros e se for criar e editar vai poder criar e editar, mas não poderá desligar registros, pois para isso é necessário a permissão de excluir.

Se a permissão for excluir, então ele poderá também desligar registros, e se for criar, editar e excluir ele poderá fazer o CRUD completo, apenas não poderá setar permissões aos usuários, ou cadastrar funcionários, pois para isso é necessário a permissão de ROOT.

Caso o usuário tenha permissão de ROOT ele poderá setar as permissões para ele mesmo e os demais usuários, portanto se ele tiver a permissão de ROOT ele consegue fazer o que quiser no sistema.

Quanto aos registros de venda (notas fiscais)

Para emitir o registro de venda, o usuário seleciona o funcionário que efetuou a venda e o cliente que fez a compra, e em seguida ele é direcionado para a tela onde vai adicionar os itens vendidos. Após adicionar todos os itens ele tem a opção de fechar a tela de emissão de notas, e com isso a nota ficaria com status de pendente, pois ela não foi emitida de fato.

Enquanto ela estiver pendente é considerado que a venda não se realizou ainda, e portanto o usuário pode entrar nela novamente, incluindo ou excluindo produtos, alterando dados da nota, após o usuário concluir ele deve emitir a nota, e com isso a nota passará pro status de emitida, e passará a constar como registro para as estatísticas, e a partir disso não será mais possível fazer nenhuma alteração na nota, a não ser o seu cancelamento (se o usuário tiver essa permissão).

Ao cancelar a nota fiscal o seu status passa para cancelada, seu valor é zerado e ela automaticamente não é mais considerada nas estatísticas.

Quanto as estatísticas

Esse, na minha opinião é o principal diferencial do sistema em relação ao sistema da oficina. Ao entrar na seção das estatísticas o usuário deverá informar o período o qual ele deseja consultar, ao informar o intervalo de datas ele terá as seguintes opções de consulta:

Opções de consulta de registros

Outro diferencial em relação ao projeto da oficina, é a quantidade de opções de consultas de vendas.

Opções de consultas de vendas:

Todas as notas
Todas as notas emitidas
Todas as notas pendentes
Todas as notas canceladas
Notas por data da venda
- Todas as notas por data de venda
- Notas emitidas por data de venda
- Notas pendentes por data de venda
- Notas canceladas por data de venda
Notas por cliente
- Todas as notas por cliente
- Notas emitidas por cliente
- Notas pendentes por cliente
- Notas canceladas por cliente
Notas por funcionário
- Todas as notas por funcionário
- Notas emitidas por funcionário
- Notas pendentes por funcionário
- Notas canceladas por funcionário

Resumo geral do projeto

Em resumo, podemos ver que esse sistema já foi uma evolução em relação ao sistema da oficina, pois já possui uma complexidade considerável e grandes evoluções. Neste projeto consegui explorar bastante a linguagem SQL para fazer as consultas e as estatísticas do banco de dados, mas o que achei um pouco mais complexo de desenvolver é a lógica das vendas.

Quem quiser ver como ficou basta baixar esse projeto, e instalar as dependências (basicamente pyqt5) e o Python na versão 3.x

Para poder cadastrar um usuário e setar suas permissões deve utilizar inicialmente o superusuário ROOT e a senha manager.

Para executar o sistema utilize o arquivo padaria.py, que vai abrir a tela de login, onde você poderá logar com o superusuário ROOT, cadastrar um usuário, setar suas permissões e em seguida logar novamente com o usuário que você cadastrou e testar para ver como ficou esse meu segundo projeto do Jovem Programador Senac módulo 2.

9 de julho de 202216 de julho de 2022

Projeto oficina

Este foi o primeiro projeto com interface gráfica que desenvolvi com os conhecimentos adquiridos no programa Jovem Programador Senac módulo 2.

O projeto consiste basicamente em:

É utilizado o banco de dados Sqlite3.

Regra de negócio deste projeto

O usuário pode se cadastrar livremente, porém com o simples cadastro do usuário ele apenas terá permissão para consultas, para ter mais permissões elas deverão ser concedidas a ele pelo ROOT.

As permissões possíveis são:

Somente consulta
Criar (permite cadastrar novos veículos e clientes)
Editar (permite alterar veículos e clientes existentes)
Excluir (permite excluir veículos e clientes)
ROOT (permite setar permissões para os usuários)

Existe um superusuário que através dele poderá ser setado ao primeiro usuário cadastrado a permissão de ROOT e após isso esse primeiro usuário já pode setar as permissões aos demais usuários conforme a necessidade e nível de cada usuário.

No cadastro de clientes existe uma verificação para saber se o CPF é válido, para efeito de testes também foi colocado um botão de gerar CPF que gera CPFs aleatórios válidos para facilitar os testes e os cadastros de clientes, lembrando que esse sistema é apenas um exercício didático e não tem nenhuma funcionalidade prática, apenas serve como uma forma de praticar o CRUD.

Ao entrar no sistema o usuário deve receber uma mensagem de boas vindas informando suas permissões. De acordo com suas permissões será as opções que ele deve ter disponível na tela.

Caso seja apenas consulta ele verá as opções de buscar clientes e manutenção de clientes, sendo que não conseguirá fazer nenhuma alteração, apenas verificar os dados.

Se a permissão for criar, vai aparecer também a opção de cadastrar clientes e cadastrar veículos, e ele conseguirá fazer cadastros, porém não poderá alterar dados existentes, pois para isso é necessário a permissão de editar.

Se a permissão for editar, ele poderá apenas editar os registros e se for criar e editar vai poder criar e editar, mas não poderá excluir registros, pois para isso é necessário a permissão de excluir.

Se a permissão for excluir, então ele poderá também excluir registros, e se for criar, editar e excluir ele poderá fazer o CRUD completo, apenas não poderá setar permissões aos usuários, pois para isso é necessário a permissão de ROOT.

Caso o usuário tenha permissão de ROOT ele poderá setar as permissões para ele mesmo e os demais usuários, portanto se ele tiver a permissão de ROOT ele consegue fazer o que quiser no sistema.

Quanto a lógica na exclusão dos registros

Caso tente excluir algum cliente que possui veículos cadastrados, o sistema deve informar uma mensagem de erro avisando que esse cliente não pode ser excluído pois possui veículos cadastrados para ele e que é necessário primeiro excluir o registro desses veículos para depois poder excluir o cliente, caso o cliente não tenha nenhum registro de veículo cadastrado ele pode ser excluído sem problemas.

Resumo do projeto oficina

Em resumo, esse simples exemplo de exercício serviu para praticar a construção de um programa com interface gráfica utilizando o PyQt5 e o Qt design e também um exercício para praticar o uso do banco de dados relacional Sqlite3, pois era necessário haver uma relação entre os clientes e seus veículos.

Também esse sistema foi importante para exercitar a lógica de permissão, do que os usuários podem ou não podem fazer, dependendo de suas permissões.

Quem quiser ver como ficou basta baixar esse projeto, e instalar as dependências (basicamente pyqt5) e o Python na versão 3.x

Para poder setar as permissões deve utilizar inicialmente o superusuário ROOT e a senha manager.

Para executar o sistema utilize o arquivo main.py, que vai abrir a tela de login, onde você poderá se cadastrar e logo em seguida logar novamente com o superusuário ROOT para lhe dar as permissões que você quiser.