Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Nik0lax/gtr-gestao-ticket-refeicao

Repository files navigation

image

GTR - Gestão de Ticket Refeição | Desenvolvido em Flask

Python Flask HTML5 CSS Javascript MySQL


Sobre o GTR

GTR é uma aplicação web construída com Flask, visando facilitar o registro quantitativo de pessoas que almoçam no ambiente corporativo e fornecendo uma visão administrativa sobre esses dados. Além de fornecer insights valiosos em relatórios para tomada de decisões.

Pensado para melhorar o processo de faturamento, automatizar os processos e garantir a autenticidade dos dados no momento de tratar a contabilidade com terceirizados.


Índice


Tela de Login

image

Autenticação via banco de dados com armazenamento de sessão no back-end. Ao realizar o login, o sistema identifica o perfil do usuário e redireciona automaticamente para a rota correspondente.


Perfis de Acesso

O GTR conta com quatro perfis distintos, cada um com sua rota e conjunto de permissões:

Perfil Rota Descrição
admin /admin Acesso total ao sistema
usuario /usuario Acesso a relatórios e dashboard
totem_desktop /emissao_senha Interface de totem para desktop
totem_tablet /emissao_senha_tablet Interface de totem adaptada para tablet

Dashboard

image

O dashboard está disponível tanto para o perfil Admin quanto para o perfil Usuário e exibe os seguintes indicadores em tempo real:

  • Total de senhas emitidas hoje
  • Total de senhas emitidas no mês atual
  • Total de colaboradores cadastrados
  • Total de departamentos
  • Última emissão registrada
  • Gráfico de barras com emissões dos últimos 7 dias
  • Gráfico de pizza com o Top 5 departamentos com mais emissões no mês

Módulo de Colaboradores

Gerenciamento completo (CRUD) da base de colaboradores.

Cadastro: Registra nome, CPF, cargo, departamento e tipo (limite diário de emissões). A validação de CPF é feita tanto no formato quanto na unicidade, impedindo duplicidades.

Listagem: Exibe todos os colaboradores com paginação (20 por página) e busca por nome ou CPF.

Edição e Exclusão: Permite atualizar ou remover registros de colaboradores diretamente pela listagem.


Módulo de Usuários do Sistema

Permite ao administrador gerenciar os usuários que acessam o sistema.

  • Cadastro com nome, usuário, senha e perfil de acesso
  • Listagem de todos os usuários com status ativo/inativo
  • Exclusão de usuários (com proteção para não excluir o próprio usuário logado)

Módulo de Departamentos

Gerenciamento completo (CRUD) dos departamentos da organização.

  • Cadastro e listagem com busca
  • Exibe o total de colaboradores vinculados a cada departamento
  • Ao renomear um departamento, o sistema atualiza automaticamente os vínculos nos colaboradores
  • Impede exclusão de departamentos com colaboradores associados

Cardápio

image

Módulo para cadastro e gestão do cardápio diário, com suporte a foto.

Cadastro: Permite registrar itens de cardápio com data, tipo de refeição (Café da Manhã, Almoço, Lanche, Jantar), descrição e foto (JPG/PNG/WEBP, até 5 MB).

Visualização pública: Rota /cardapio exibe o cardápio do dia agrupado por tipo de refeição, acessível para consulta no totem.

Gerenciamento: Listagem com filtro por período, ativação/desativação e exclusão de itens.

image

Emissão de Senhas

image

Rota operacional usada nos totens para que colaboradores e visitantes retirem a senha de refeição. Disponível em duas versões de layout: desktop e tablet.

Modo de Emissão

O administrador pode alternar entre dois modos pelo painel de configurações:

Modo Padrão: O colaborador informa apenas o CPF. O sistema valida, verifica o limite diário e emite a senha numerada. image

Modo com Cardápio: Além do CPF, o usuário seleciona a refeição desejada no cardápio do dia antes de emitir a senha. O item escolhido fica registrado na emissão. image

Emissão para Colaborador

  • Validação de CPF (formato e existência no banco)
  • Verificação do limite diário configurado no cadastro
  • Registro do nome, cargo, departamento e número sequencial da senha
  • Suporte ao modo com cardápio

Emissão para Visitante

  • Informação de nome, CPF e localização
  • Validação de CPF
  • Limite diário: 1 senha (padrão) ou 3 senhas para o tipo "Acompanhante"
  • Suporte ao modo com cardápio

Relatórios

Todos os relatórios podem ser exportados em PDF ou Excel (.xlsx), conforme o tipo.

Relatório Analítico de Emissões

Visão estatística completa de um período selecionado:

  • Total de colaboradores cadastrados na base
  • Totais por período do dia: Café, Almoço e Janta — separados por colaborador e visitante
  • Totais por tipo de pessoa (colaborador / visitante)
  • Top 5 departamentos por volume de emissões (gráfico de barras)
  • Percentual de atingimento em relação à base cadastrada (gráfico de pizza)
  • Listagem por departamento
  • Exportação em PDF

Relatório de Emissões Diárias

Listagem detalhada de todas as emissões em um período, contendo: número da senha, CPF, nome, cargo, departamento, data e hora. Exportação em PDF ou Excel.

Relatório por Departamento

Emissões filtradas por departamento (ou todos), com totalizadores por período do dia (Café / Almoço / Janta). Exportação em PDF ou Excel.

Relatório de Visitantes por Localização

Emissões de visitantes filtradas por localização/localização cadastrada, com totalizadores por período. Exportação em PDF ou Excel.

Relatório de Cardápio

Relatório específico para emissões realizadas no modo com cardápio. Permite filtrar por período, departamento, tipo de refeição e tipo de pessoa (colaborador / visitante). Apresenta:

  • Resumo de emissões por tipo de refeição (colaborador / visitante / total)
  • Detalhamento por item de cardápio com subtotais por refeição
  • Listagem completa de registros
  • Exportação em PDF ou Excel (com duas abas: detalhamento geral e total por cardápio)

Configurações

Painel de configurações acessível apenas pelo perfil Admin.

Tipo de Emissão de Senha

Alterna o modo de operação dos totens entre Padrão (só CPF) e Com Cardápio (CPF + seleção do cardápio do dia). image

Localizações

Gerenciamento das localizações utilizadas no cadastro de visitantes. Permite cadastrar, editar, buscar e excluir localizações.


Tecnologias Utilizadas

  • Python & Flask — back-end e roteamento da aplicação
  • HTML5, CSS3 & Javascript — front-end e interfaces dos totens
  • MySQL — banco de dados relacional
  • pdfkit / wkhtmltopdf — geração de relatórios em PDF
  • matplotlib — geração de gráficos nos relatórios analíticos
  • pandas & xlsxwriter — geração de relatórios em Excel
  • Logging customizado — rastreamento de ações dos usuários via log_config.py

About

Sistema de Gestão de Ticket Refeição | Desenvolvido em Flask

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors