Projetos - João Vitor Wolfart

8 de agosto de 20238 de agosto de 2023

Sistema de orçamentos de reserva

Minha família tem uma pequena pousada na Praia da Pinheira, e em Julho de 2023, meu pai, que administra os negócios, me pediu pra desenvolver um sistema que facilitasse na confecção de orçamentos para facilitar o seu trabalho, pois, até o momento, ele utilizava planilhas do Excel para fazer e enviar orçamentos para os clientes.

Com base na sua necessidade, desenvolvi um sistema para gerenciar os orçamentos. O controle vai desde a confecção do orçamento, a geração do contrato dos orçamentos aprovados, o controle dos pagamentos e despesas extras de cada reserva, e também o controle dos checkins, checkouts, e cronogramas de limpezas das acomodações.

Alguns requisitos do sistema

Além da nossa pousada, meu pai também administra a locação de outros dois imóveis de parceiros, portanto, um dos requisitos seria separar as acomodações em cada empreendimento que ela pertence, ou seja, o empreendimento da nossa pousada (Residencial Sol de Verão), outro empreendimento de que ele tem junto como parceiro (Moradas Pé na Areia), e o outro empreendimento que ele administra as reservas, que pertence a um amigo (Casas/Aptos do Léo). E também, ter a opção, caso, futuramente ele tenha novos empreendimentos. Portanto, primeiramente, pensei em fazer uma tabela de empreendimentos, onde, inicialmente tem esses três empreendimentos cadastrados, mas, fica aberta a possibilidade de cadastrar novos empreendimentos.

Abaixo, a lista das tabelas que utilizei para construção do sistema.

Cadastro de usuários
Cadastro de empreendimentos (local onde se encontram as acomodações)
Cadastro de acomodações
Cadastro prévio de clientes
Cadastro de dados dos clientes
Cadastro de tipos de observações (orçamento, contrato, forma de pagamento, etc.)
Cadastro de observações (observações padrão que são mais utilizadas nos orçamentos ou contratos)
Cadastro de horários (horários utilizados para checkin e checkout)
Cadastro de períodos (alta temporada, baixa temporada, pacotes de feriados, etc.)

Cadastro das acomodações

Um cadastro básico das acomodações, informando a qual empreendimento elas pertencem, nome da acomodação, tipo de acomodação, número de quartos, valor base, limite ideal de ocupantes, limite adicional de ocupantes, se aceita pet, e uma descrição livre da acomodação.

Orçamentos de reserva

Esta é a principal entrada de dados do sistema, pois é através do orçamento, que futuramente, será gerado o contrato, caso o cliente aprove o orçamento.

O orçamento é feito em duas etapas, primeiramente, é informado o cliente, a acomodação, o número de ocupantes, uma observação opcional sobre os ocupantes, se será diária cheia, ou apenas pernoite, a data de entrada, o horário previsto para o checkin, a data de saída, o horário previsto para o checkout, e o período.

Na segunda etapa, é informado o valor da diária, o valor da taxa de limpeza, valor de descontos, valor de acréscimos, valor do pacote, e número de dias do pacote, então, é clicado em “Calcular” e o sistema faz o cálculo do orçamento.

Após isso, basta inserir as observações, e gerar o orçamento.

PDF do orçamento

Após gerar o orçamento, já é possível gerar um PDF para envio ao cliente.

Para gerar esse PDF, utilizei a biblioteca do Reportlab.

Após enviado o PDF para o cliente, basta aguardar a sua aprovação por parte do cliente (caso necessite alguma alteração, é possível também alterar o orçamento, mas será necessário informar o motivo da modificação. Neste caso, após a alteração, se houver, o orçamento ficará com uma flag indicando que ele foi modificado).

Contrato simplificado

Após aprovado o orçamento pelo cliente, já é possível gerar um contrato, que basicamente, será gerado automaticamente usando os dados do orçamento que foi aprovado.

Para geração do contrato, será apenas solicitado que se inclua algumas observações e informações adicionais.

PDF do contrato

Após gerar o contrato, já é possível gerar um PDF para envio ao cliente.

Após enviado o PDF para o cliente, o orçamento mudará seu status para “contrato gerado”, e já será possível o lançamento de pagamentos e despesas extras.

Lançamento de pagamentos e despesas extras

Após gerar o contrato, já é possível lançar pagamentos e despesas extras para esse orçamento (normalmente, por padrão, já é pedido um pagamento para confirmação da reserva, mas tudo isso é combinado, e está descrito no contrato). Assim que o cliente faz o primeiro depósito para confirmar a reserva, o mesmo deve ser informado nessa seção, pois após lançar o primeiro pagamento, o orçamento recebe uma flag informando que o orçamento foi confirmado.

Além de informar a confirmação da reserva, também é possível informar todos os pagamentos recebidos, pois várias vezes, o pagamento é recebido em diversas parcelas, dependendo da negociação que é feita.

Em certos casos, existe a possibilidade de haver cobranças extras por algum serviço ou pessoa adicional que eventualmente não estava previsto no contrato, neste caso, utilizamos a função de informar acréscimo, pois essa função irá gerar um acréscimo para o orçamento, dando a possibilidade de incluir novos valores não previstos no momento do fechamento do contrato, de acordo com a necessidade.

Relatório financeiro da reserva

Nesta opção, é possível visualizar um PDF com todas as informações financeiras da reserva, tais como o valor da reserva acertado no contrato, os valores já pagos, os valores de extras lançados, e o saldo que ainda resta pagar.

Controle de checkins e checkouts

Nessa opção, criei três tipos de relatórios, são eles:

Relatório de checkins

Lista todas as reservas com entrada prevista em um intervalo de datas.

Esse relatório é útil para saber as acomodações que precisam ser preparadas e revisadas antes da entrada do hóspede.

Relatório de checkouts

Lista todas as reservas com saída prevista em um intervalo de datas.

Esse relatório é útil para saber as acomodações que estão desocupando e precisam ser limpas.

Relatório de checkins/checkouts

Basicamente uma união dos dois relatórios acima, podendo ver as reservas com entrada e saída programadas para aquele intervalo de datas escolhido.

20 de julho de 20221 de março de 2023

Projeto de controle de despesas

Este foi o projeto final do Jovem Programador Senac módulo 3.

Este projeto foi feito em grupo, fiz com meus colegas Marcelo Henrique Gaspar Gonçalves e Kauan Trindade Gonçalves.

O projeto conta com os seguintes recursos:

Controle de acesso dos usuários
Cadastro de grupos de despesa
Cadastro de tipos de despesa
Cadastro de formas de pagamento
Lançamento de despesas
Relatórios
Dashboard na tela inicial
Opção de impressão nos relatórios e no Dashboard
Tutorial do sistema
Um pouco sobre os desenvolvedores do sistema

Por se tratar do projeto final do Jovem Programador, tivemos que apresenta-lo durante a reunião e cerimônia de encerramento do curso da unidade do Senac de Palhoça.

Nessa cerimônia estava presente os coordenadores do Senac de Palhoça, a turma de análise e desenvolvimento de sistemas da faculdade do Senac, com seus professores, e também os nossos professores do Jovem Programador, isso ocorreu no auditório do Senac de Palhoça.

Para ficar mais fácil de explicar e contextualizar esse projeto, vou deixar abaixo os slides que fiz para apresentar o projeto a banca do Senac na conclusão do curso.

Como dito nos slides acima, a ideia foi criar grupos de despesa, e dentro desses grupos, criar os tipos de despesa, porém percebemos que daria muito trabalho para o usuário cadastrar seus grupos e tipos de despesa, para só depois cadastrar as despesas, então resolvemos criar alguns grupos e tipos de despesa previamente cadastrados que estarão disponíveis para todos os usuários (grupos como Saúde e tipos como plano de saúde e exames são alguns exemplos de opções previamente cadastradas que estão disponíveis para todos os usuários).

Percebemos também que apenas estas opções padronizadas podem não atender plenamente a necessidade de cada usuário, então deixamos disponível a opção do usuário cadastrar seus próprios grupos e tipos de despesa personalizados, mas, um usuário não consegue ver os grupos e tipos criados por outro usuário, apenas os padrão e os seus personalizados, assim como ele não consegue ativar ou desativar os grupos padrão, apenas os seus personalizados.

Para o lançamento da despesa é bem simples, basta informar a data da despesa, o tipo (não é necessário informar o grupo, pois ele já está sendo referenciado no tipo), a forma de pagamento, o valor e opcionalmente uma descrição (essa descrição será importante em consultas, ou relatórios futuros, pois lembra o usuário do que foi exatamente aquele gasto, mas essa informação é opcional)

Apesar de um lançamento de despesa ser bastante simples, e com relativamente poucos dados, conseguimos com vários registros de apenas esses poucos dados agrupados, ver diversas opções de relatórios e gráficos, como por exemplo:

Despesas por dia (todo o período)
Despesas por dia (intervalo de datas)
Despesas por tipo (todo o período)
Despesas por tipo (intervalo de datas)
Despesas por grupo (todo o período)
Despesas por grupo (intervalo de datas)
Despesas por forma de pagamento (todo o período)
Despesas por forma de pagamento (intervalo de datas)

Dentro desses relatórios, em alguns casos, além dos dados do relatório, ainda será fornecido gráficos.

Além de todos esses relatórios, também, a medida que são incluídos novos registros o sistema automaticamente de forma interativa vai atualizando o Dashboard da página inicial.

Os dados do Dashboard da página inicial são os seguintes:

No Dashboard do mês corrente, mostra apenas as despesas do mês corrente agrupadas e totalizadas por grupo, aparece o total acumulado geral com o número de registros, o total acumulado por grupo com o número de registros, além de um gráfico, e a opção de clicar no ícone do olho para verificar cada um dos registros do grupo. Existe também a opção de ver o Dashboard de meses anteriores através de um select no início do Dashboard do mês atual.

Logo abaixo do Dashboard do mês corrente, é possível ver o Dashboard do ano corrente, nesta opção é possível ver o acumulado do ano corrente com o número de registros, e o acumulado mês a mês com o número de registros, além do gráfico do ano corrente. Neste também temos a opção do select para selecionar anos anteriores.

Por último temos o Dashboard de todo o período, onde é possível ver o acumulado de todo o período com o número de registros e o acumulado ano a ano com o número de registros, além do gráfico.

Para conseguir todos esses relatórios e gráficos foi necessário organizar e fazer várias consultas SQL no banco de dados, o que é uma das coisas que eu gosto muito de explorar.

Este projeto também fiz deploy em uma VPS, então também está disponível para quem quiser utilizar, basta se cadastrar e alimentar o sistema com os registros de despesas para poder ver os relatórios e os Dashboards funcionando. Caso alguém tenha interesse em ver ele já com dados, pode entrar em contato comigo e solicitar, que tenho um usuário de testes com vários registros, para que você faça testes sem a necessidade de digitar diversos registros para ver os resultados.

O sistema possui também um tutorial detalhado do seu uso, onde é possível acessar até mesmo sem estar cadastrado e logado.

O tempo que tivemos para desenvolver esse sistema de conclusão do curso foi relativamente curto, menos de três semanas, e o tema era livre.

Sei que um sistema de controle de despesas é um sistema bastante clichê para programadores iniciantes, por isso tentei explorar ao máximo todas as possibilidades de transformar um sistema relativamente simples como esse, em algo mais incrementado e com muitas opções de relatórios e gráficos para valorizar e tornar possível de ser apresentado como um trabalho de encerramento de curso.

Como eu havia feito o deploy deste projeto em minha VPS, consegui além dos Slides apresentar uma demonstração pratica do projeto diretamente no telão para todos os convidados e meu grupo foi bastante aplaudido e todos elogiaram muito nosso sistema.

Vou deixar os links para o deploy do sistema em minha VPS e também o link para o projeto no meu Github.

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.