# Aplicação Web Gestão-RU

Aplicação Web RU é uma aplicação Web desenvolvido para apresentar, armazenar e controlar toda a gestão do RU, além disso, ela concentra funcionalidades relacionadas a isto e é permissionada em forma de papéis, onde cada papel permite um tipo de acesso ao sistema.  
  
Estes Documentos são referentes a aplicação WEB RU-Gestão, desenvolvidos pela Superintendência de Tecnologia da Informação (STI) da UFVJM.

# Apresentação

Aplicação Web RU é uma aplicação Web desenvolvido para apresentar, armazenar e controlar toda a gestão do RU, além disso, ela concentra funcionalidades relacionadas a isto e é permissionada em forma de papéis, onde cada papel permite um tipo de acesso ao sistema.

  
Além disso, esta aplicação possui funcionalidades como Login, escolha de papéis entre Estudante e Gestor Institucional, onde este papel lhe permite usufruir das funções de gestor do RU gerenciando refeições, possibilitando sua visualização, alteração, criação e deleção.

  
Cada uma dessas funcionalidades será detalhada nos próximos capítulos. O capítulo sobre a realização do login está disponível no link a seguir: [Clique aqui para acessar o tutorial.](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/realizar-login)

# Realizar Login

O login é o processo de identificação de um usuário em um sistema, geralmente por meio de um nome de usuário (No caso do da Aplicação WEB, sua forma de acesso é o login institucional) e uma senha. Ele é essencial para garantir que apenas pessoas autorizadas tenham acesso a determinadas informações ou funcionalidades.

Sua importância está no controle de acesso, impedindo que usuários não autorizados entrem no sistema e garantindo a segurança dos dados. Além disso, o login permite personalizar a experiência do usuário, exibindo suas informações e preferências de forma segura.

- Ao iniciar a aplicação Web R.U, você se depara com a tela inicial, precedendo a tela de Login, representada abaixo:

[![01-telaInicial.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/WppZ37AotCSCSGDq-01-telainicial.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/WppZ37AotCSCSGDq-01-telainicial.png)

Ao clicar na opção Entrar com UFVJM, você será redirecionado para a página de Login:

[![02-telaLogin.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/Br0m4XpaZfoOBY1c-02-telalogin.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/Br0m4XpaZfoOBY1c-02-telalogin.png)

Passos:

- 1) Preencher o campo de Login;
- 2) Preencher o campo de Senha;
- 3) Clique no Botão de Login.
- 4) Caso tenha esquecido a senha, clique no botão de esqueceu sua senha.
- 5) Caso seja o seu primeiro acesso, clique na opção de primeiro acesso que você será redirecionado para a tela de criação de conta.

Observações:

No campo de Login Institucional, você deve digitar o seu login da instituição.  
Exemplo: Se seu e-mail institucional é: <Nome.Sobrenome@ufvjm.edu.br>, seu login institucional será: **Nome.Sobrenome**  
No campo senha, você deve digitar sua senha utilizada para acessar o email institucional.

O tutorial da tela de escolha de papéis, é explorado no próximo capítulo. Seu acesso está disponível, através do link a seguir: [Clique aqui](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/tela-escolha-de-papeis) para acessar o tutorial.

# Tela Escolha de Papeis

Após realizado o processo de Login na aplicação, caso não tenha lido o tutorial de como realizar o login no sistema, favor, consultá-lo no link a seguir: [Clique aqui para acessar o tutorial](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/realizar-login).

Observação: A tela de escolha de papéis é uma tela que permite o acesso as determinadas partes do sistema de acordo com o papel atribuído.   
  
**Por exemplo:** Caso seu papel seja de estudante, seu nível de acesso é limitado, caso seja fiscal, seu nível de acesso será outro, caso seja gestor institucional, seu papel será outro completamente diferente.

Após o Login, você será redirecionado para esta tela de escolha de papéis, mostrada abaixo.

Observação 2: Neste sentido, foi atribuído a mim, as funções de Estudante e Gestor Institucional. Porém como mencionado anteriormente, caso você seja estudante, seu papel será apenas de estudante, se for gestor, será apenas gestor, e assim por diante.

[![03-telaPapeis.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/S4dACLyjAdRn2zjz-03-telapapeis.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/S4dACLyjAdRn2zjz-03-telapapeis.png)

O tutorial da funcionalidade de **Estudante** é explorado no próximo capítulo. Seu acesso está disponível, através do link a seguir: [Clique aqui para acessar o tutorial.](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/funcionalidades-papel-estudante)

O tutorial da funcionalidade de **Gestor Institucional** é explorado no próximo capítulo. Seu acesso está disponível, através do link a seguir: [Clique aqui para acessar o tutorial.](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/funcionalidades-papel-gestor-institucional)

# Funcionalidades Papel Estudante

Já entendido sobre a tela de papéis da aplicação, vamos explorar as funcionalidades referente ao papel do Estudante. Caso não tenha lido o tutorial sobre a apresentação da tela escolha de papéis, favor, consultá-lo no link a seguir: [Clique aqui para acessar o tutorial](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/tela-escolha-de-papeis).

Após clicado no botão de "Acessar", você será redirecionado para a tela abaixo, contendo as funcionalidades referentes a função de estudante:

  
**Observação:** Esta é a tela do estudante, a princípio, ela não apresenta ou retorna nada, sua função é apenas de visualização e diferenciação do papel de gestor, porém, para exemplificar o pleno funcionamento do sistema, ela existe para mostrar as possibilidades de utilização de diferentes tipos de papéis.

[![04-telaPrincipalPapelEstudante.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/nvkMbFjQ4fcXlHcF-04-telaprincipalpapelestudante.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/nvkMbFjQ4fcXlHcF-04-telaprincipalpapelestudante.png)

Ao clicar no menu localizado no canto superior esquerdo, é apresentado a tela abaixo, mostrando um menu suspenso. Caso exista alguma funcionalidade para este papel, ela seria encontrada ali.

[![05-telaRotaMenuEstudante.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/tQLG2BYbzDCE7NuA-05-telarotamenuestudante.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/tQLG2BYbzDCE7NuA-05-telarotamenuestudante.png)

Clicando na opção de tela principal, você é redirecionado de volta a tela de escolha de papéis, porém agora com o papel de estudante, além disso, no menu suspenso da parte superior direita, existe a opção de meus papéis e logout. Ao clicar em Logout, você desloga do sistema e na opção de meus papéis, você é redirecionado para esta tela, novamente.

[![06-telaRotaMenuPapeisEstudante.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/VJ7Vz8fGSFoF4ATd-06-telarotamenupapeisestudante.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/VJ7Vz8fGSFoF4ATd-06-telarotamenupapeisestudante.png)

De acordo com a primeira versão da aplicação Web de Gestão do R.U, foi apresentado todas as funcionalidades do [Aplicação Web Gestão RU](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru), este tutorial será atualizado conforme a aplicação sofrer atualizações. Qualquer dúvida, favor entrar em contato pelo GLPI, ou plataforma de gestão de chamados: [https://glpi.ufvjm.edu.br/](https://glpi.ufvjm.edu.br/ "https://glpi.ufvjm.edu.br/").

# Funcionalidades Papel Gestor Institucional

Já entendido sobre a tela de papéis da aplicação, vamos explorar as funcionalidades referente ao papel do Gestor Institucional. Caso não tenha lido o tutorial sobre a apresentação da tela escolha de papéis, favor, consultá-lo no link a seguir: [Clique aqui para acessar o tutorial](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/tela-escolha-de-papeis).

 Após clicado no botão de "Acessar", você será redirecionado para a tela abaixo, com todas as funcionalidades referentes a função de Gestor Institucional:

**Observação:** No momento, o papel de Gestor Institucional possui apenas a função de gerir as refeições, que é explorada a seguir, os outros cards são para possíveis futuras funções. Apenas uma exemplificação de layout futuro.

[![07-telaPrincipalPapelGestor.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/PuHXEXS3GOBT0u60-07-telaprincipalpapelgestor.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/PuHXEXS3GOBT0u60-07-telaprincipalpapelgestor.png)

Ao clicar no menu localizado no canto superior esquerdo, é apresentado a tela abaixo, mostrando um menu suspenso. Como existe apenas a funcionalidade de gerenciar refeições, ela fica localizada abaixo da opção de retornar ao menu principal, ao clicar nela, é redirecionado a tela de escolha de papéis.

[![08-telaRotaMenuGestor.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/aLLn229ktj3fGozm-08-telarotamenugestor.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/aLLn229ktj3fGozm-08-telarotamenugestor.png)

O tutorial contendo as funções referentes a gestão das refeições **é explorado** no próximo capítulo. Seu acesso está disponível através do link a seguir: [Clique aqui para acessar o tutorial.](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/gerenciar-refeicoes)

# Gerenciar Refeição

# Gerenciar Refeições

Após entender sobre as funcionalidades referentes ao papel do gestor na aplicação, vamos explorar a funcionalidade de Gerenciar as Refeições Caso não tenha lido o tutorial sobre as funcionalidades referente ao papel de Gestor, favor, consultá-lo no link a seguir: [Clique aqui para acessar o tutorial](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/funcionalidades-papel-gestor-institucional).

Após clicado no **botão de Gerenciar Refeições**, você é redirecionado para a tela abaixo, contendo as informações referente as refeições:

[![09-telaGerenciarRefeiçõesPapelGestor.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/wCTziRVAjkMVS6zT-09-telagerenciarrefeicoespapelgestor.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/wCTziRVAjkMVS6zT-09-telagerenciarrefeicoespapelgestor.png)

Esta tela retorna uma lista contendo todas as refeições, listadas pela data de criação, data de início da oferta. Além disso, ela traz informações sobre a refeição, quantidades de tickets e as ações de visualizar, edição e deleção e acima, o botão criar uma refeição.

**\*REMOVER REFEIÇÃO\***

**Observação:** O botão e opção de remoção da refeição só ficará habilitada e disponível para remoção, caso a refeição criada não possua nenhum ticket atribuído a ela, caso exista ticket relacionado, sua função é inválida.

O tutorial de como Criar uma Refeição será explorado no próximo capítulo. Seu acesso está disponível através do link a seguir: [Clique aqui para acessar o tutorial.](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/criar-refeicao)

# Criar Refeição

Após entender sobre as funcionalidades referentes a gestão de refeições, iremos explorar a funcionalidade de Criar as Refeições Caso não tenha lido o tutorial sobre as funcionalidades referente a Gestão de Refeições, favor, consultá-lo no link a seguir: [Clique aqui para acessar o tutorial](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/gerenciar-refeicoes).

Após clicado no **botão de Adicionar Refeição**, você é redirecionado para a tela abaixo, com as informações referente a criação de refeição:

[![10-telaAdicionarRefeiçãoGestor.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/FNDtkJAc0OGEzu1d-10-telaadicionarrefeicaogestor.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/FNDtkJAc0OGEzu1d-10-telaadicionarrefeicaogestor.png)

Nesta tela é apresentado um **formulário** para **criação da refeição**, com as **seguintes funções**:

1. **Selecionar o benefício:** Nesta função, você deve escolher a categoria de benefícios existentes. <span style="color: rgb(224, 62, 45);">**OBS:**</span> No atual momento deste tutorial, existe apenas a categoria de benefícios (Restaurantes universitários Existentes) - Restaurante Universitário (RU) - Mucuri;
2. **Quantidade de refeições disponibilizadas ao dia:** Nesta função, você deve especificar a quantidade de refeições por cada dia em específico é disponibilizado aos beneficiários. <span style="color: rgb(224, 62, 45);">**Exemplo:**</span> 150 refeições; Ao longo de 1 dia, será ofertado 150 refeições;
3. **Período de horas para solicitação do benefício:** Nesta função, você deve informar a quantidade de horas prévias para a permissão de solicitação da refeição. <span style="color: rgb(224, 62, 45);">**Exemplo:**</span> 12h - É possível solicitação de refeição em até 12h antes do início da disponibilização da refeição. Isso implica que um café da manhã que está previsto para as 08h da manhã, pode ser solicitado a partir das 20h do dia anterior;
4. **Horário de início da disponibilização da refeição:** Nesta função, você deve especificar o horário de início da disponibilização da refeição. <span style="color: rgb(224, 62, 45);">**Exemplo:**</span> 08h da Manhã: O benefício Café da Manhã será ofertado ou disponível para resgate a partir das 08h da manhã <span style="color: rgb(224, 62, 45);">**OBS: O horário de início da disponibilização deve ser anterior ao horário de término da refeição.** </span><span style="color: rgb(149, 165, 166);">Se essas condições não forem atendidas, o sistema retorna um erro e a refeição não é criada;</span>
5. **Totais de dias disponibilizados à refeição:** Nesta função, você deve especificar a duração em dias que o benefício será ofertado. <span style="color: rgb(224, 62, 45);">**Exemplo:**</span> 50 dias - O benefício X será ofertado por 50 dias;
6. **Nome da refeição:** Nesta função, você deve informar o nome da refeição cadastrada. Exemplo: Café da Manhã 08h: A refeição é chamada de café da manhã 08h;
7. **Preço da refeição:** Nesta função, você deve informar o ṕreço de cada refeição. <span style="color: rgb(224, 62, 45);">**Exemplo:**</span> 7.50: Cada refeição terá um custo de R$7.50,00;
8. **Horário limite para a solicitação da refeição:** Nesta função, você deve informar o horário limite para a solicitação desta refeição. <span style="color: rgb(224, 62, 45);">**Exemplo:**</span> 07h: Ainda no exemplo de café da manhã, se ela será ofertada às 08h, o limite de horário para solicitação será às 07h da manhã. Neste sentido, os beneficiários (estudantes) só vão conseguir solicitar o ticket da refeição até as 07h da manhã. Após este horário, aquele ticket, mesmo que gerado, fica inutilizado caso ele não seja solicitado. <span style="color: rgb(224, 62, 45);">**OBS: O horário limite da solicitação deve ser anterior ao início da disponibilização da refeição.**</span> <span style="color: rgb(126, 140, 141);">Se essas condições não forem atendidas, o sistema retorna um erro e a refeição não é criada;</span>
9. **Horário de término da disponibilização da refeição:** Nesta função, você deve informar o horário limite para disponibilização da refeição. <span style="color: rgb(224, 62, 45);">**Exemplo:**</span> 10h: Ainda no exemplo de café da manhã, considerado que ele seja disponibilizado às 08h da manhã. Este horário de 10h, indica o fim da disponibilização dele. Então, ele será oferecido das 08h às 10h;
10. **Data de início da oferta:** Nesta função, você deve informar a data de início da oferta do benefício. <span style="color: rgb(224, 62, 45);">**Exemplo:**</span> 21/11/2025: No dia 21/11/2025 será o início da oferta de café da manhã por 50 dias, neste exemplo fictício;
11. **Tipo da refeição:** Nesta função, você deve informar o tipo da refeição a ser cadastrada. <span style="color: rgb(224, 62, 45);">**Exemplo:**</span> Café da Manhã, neste exemplo, o tipo da refeição cadastrada e que será disponibilizada, é de Café da manhã;
12. **Caso exista um limite extra de refeições:** Esta opção é para o caso de disponibilização de oferta de refeição previamente não esperada, ela altera o limite de refeições diárias para considerar este limite "extra";

**Observações:**

- O horário limite da solicitação deve ser anterior ao início da disponibilização da refeição.
- O horário de início da disponibilização deve ser anterior ao horário de término da refeição.

<span style="color: rgb(224, 62, 45);">**Se essas condições não forem atendidas**</span>, o sistema retorna um erro e a<span style="color: rgb(224, 62, 45);"> **r<span style="color: rgb(224, 62, 45);">efeição</span> não é criada**</span>. <span style="color: rgb(45, 194, 107);">**Caso todos os horários estejam corretos**</span>, o <span style="color: rgb(45, 194, 107);">**sistema cria a refeição**</span> e retorna à tela principal para gerenciar refeições com uma <span style="color: rgb(45, 194, 107);">**mensagem de sucesso**</span>.

O tutorial de como **editar uma Refeição** será explorada no próximo capítulo. Seu acesso está disponível através do link a seguir:

 [Clique aqui para acessar o tutorial.](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/editar-refeicao)

# Editar Refeição

Após entender sobre a funcionalidade referentes a criação de refeições, iremos explorar a funcionalidade de editar as Refeições Caso não tenha lido o tutorial sobre as funcionalidades referente a Criação de Refeições, favor, consultá-lo no link a seguir: [Clique aqui para acessar o tutorial](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/criar-refeicao).

Após **criado a refeição**, é redirecionado a tela principal, você deve **clicar no botão de editar**, este botão é a **segunda opção na aba de ações da refeição.**

Após este processo, você será redirecionado para a seguinte tela:

[![12-telaEditarRefeiçãoGestor.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/Ft3kUEcIvVOoWXDW-12-telaeditarrefeicaogestor.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/Ft3kUEcIvVOoWXDW-12-telaeditarrefeicaogestor.png)

Esta tela é semelhante à de criação, com as mesmas regras e funcionalidades.

**Observações:**

- O horário limite da solicitação <span style="color: rgb(224, 62, 45);">**deve ser anterior**</span> ao início da disponibilização da refeição.
- O horário de início da disponibilização <span style="color: rgb(224, 62, 45);">**deve ser anterior**</span> ao horário de término da refeição.

**Se essas condições não forem atendidas, o sistema retorna um erro e a refeição não é criada. Caso todos os horários estejam corretos, o sistema cria a refeição e exibe a seguinte mensagem de sucesso:**

[![13-telaEdiçãoRefeiçãoConcluidaSucesso.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/LIfG2ILRu8h5sIC7-13-telaedicaorefeicaoconcluidasucesso.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/LIfG2ILRu8h5sIC7-13-telaedicaorefeicaoconcluidasucesso.png)

O tutorial de como **Visualizar uma Refeição** é explorado no próximo capítulo. Seu acesso está disponível através do link a seguir: [Clique aqui para acessar o tutorial.](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/visualizar-refeicao)

# Visualizar Refeição

Após entender sobre a funcionalidade referentes a edição de refeições, vamos explorar a funcionalidade de visualizar as Refeições Caso não tenha lido o tutorial sobre a Edição de Refeições, favor, consultá-lo no link a seguir: [Clique aqui para acessar o tutorial](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru/page/editar-refeicao).

Após criado a refeição, é redirecionado a tela principal, você irá clicar no botão de visualizar, este botão é a primeira opção na aba de ações da refeição.

Após este processo, você será redirecionado para a seguinte tela:

[![11-telaDetalhesRefeiçãoGestor.png](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/scaled-1680-/7YTkSQUAzwZpReJl-11-teladetalhesrefeicaogestor.png)](https://documentacao.ufvjm.edu.br/uploads/images/gallery/2025-03/7YTkSQUAzwZpReJl-11-teladetalhesrefeicaogestor.png)

Nesta tela é apresentadas todas as informações sobre a refeição, inclusive sobre os beneficiários e seus dados, incluindo nome, código, código do ticket, situação do ticket, data e detalhes.

Entrando na **opção de detalhes**, aparece uma nova tela com as **seguintes informações**:

- Nome do Beneficíario;
- Seu Identificador;
- E-mail pessoal.

De acordo com a primeira versão da aplicação para Gestão do R.U, foi apresentado todas as funcionalidades do [da aplicação](https://documentacao.ufvjm.edu.br/books/aplicacao-web-gestao-ru), este tutorial será atualizado conforme a aplicação sofrer atualizações. Qualquer dúvida, favor entrar em contato pelo GLPI, ou plataforma de gestão de chamados: [https://glpi.ufvjm.edu.br/](https://glpi.ufvjm.edu.br/ "https://glpi.ufvjm.edu.br/").

# Política de privacidade

# Política de privacidade da Aplicação Web RU

Em Construção.