# Calendários
# Versão 1
# DESCRIÇÃO
O objetivo desta documentação é fornecer instruções detalhadas para que o usuário possa efetuar buscas de calendários com base em diversos critérios, como localidade, etapa, modelo de calendário, referência, data e usuário para carregar os eventos associados ao calendário pesquisado. Além disso podemos navegar entre os resultados da busca.
Nessa aplicação é possível visualizar as datas para cada evento, de acordo com o mês e número de dias semanais que foi selecionado na aplicação.
# FINALIDADE
Esta funcionalidade visa permitir a execução de ações essenciais para consulta e acompanhamento dos eventos associados aos calendários. O objetivo é possibilitar a busca de calendários com base em critérios específicos, como localidade, etapa, modelo de calendário, referência, data e usuário. Além disso, a funcionalidade inclui a opção de limpar os resultados de busca conforme necessário, facilitando a redefinição de consultas. Os usuários também poderão visualizar os eventos associados aos calendários encontrados e a navegação entre os resultados encontrados.
Abaixo podemos acompanhar o caminho de acesso e o fluxo de cada validação feita pelo sistema ou definição feita pelo usuário.
# PRINCIPAIS CAMINHOS
Login ou acesso ao sistema > Página Inicial > Workspace Planejamento > Calendários.
# FUNCIONALIDADES
Ao acessar o item "Calendários" no menu do workspace de planejamento, são carregados os calendários por localidade no quadro “Busca” e seus respectivos eventos no quadro “Eventos”.
# Busca
Nesta seção, o usuário deve buscar calendários e seus eventos para consulta.
# → Estado Inicial
Ao acessar a funcionalidade “Calendários”, a tela inicial apresenta o card de busca no estado padrão, sem interações do usuário. Para realizar uma busca e habilitar os botões Buscar e Limpar, insira os valores desejados, podendo ser um ou vários critérios aplicados nos campos de busca, conforme a necessidade do usuário para refinar a pesquisa.
Os campos disponíveis no card de busca são:
- Localidade: Selecione a localidade desejada para filtrar eventos relacionados.
- Etapa: Selecione a etapa na lista de valores exibida após o clique.
- Modelo de Calendário: Selecione o modelo de calendário para aplicar à busca.
- Referência: Insira o mês e o ano de referência para os eventos. O campo permite de 0 – 7 caracteres.
- Data de Geração: Preencha a data em que o calendário foi gerado.
- Usuário: Preencha o usuário. Filtra os eventos pelo usuário associado
# → Executar
Após preencher os campos necessários, clique no botão “Buscar” para realizar a pesquisa com os critérios fornecidos. O sistema carregará as informações correspondentes, e a lista de eventos será preenchida de acordo com os dados encontrados.
Caso seja necessário reiniciar a busca, o botão "Limpar" ao lado do botão “buscar” permite que todos os campos sejam redefinidos.
# → Limpar
Ao clicar no botão "Limpar", todos os valores inseridos nos campos de busca serão removidos e a tela será redefinida ao estado inicial, permitindo que o usuário inicie uma nova pesquisa.
# → Navegar entre Resultados
Se a busca retornar vários calendários e seus eventos associados, utilize o componente de navegação para visualizar cada um deles.
O componente de navegação está localizado na linha dos botões de ação "Buscar" e "Limpar", e permite navegar entre os resultados encontrados (por exemplo: < 1/20 >).
Clique nos botões de navegação para exibir o próximo calendário na lista ou retornar ao calendário anterior.
Ao alternar entre os resultados, todos os dados exibidos no card de busca e eventos serão atualizados automaticamente para exibir os dados correspondentes.
# → Resultado da Busca
Ao clicar em "Buscar", o sistema carregará as informações com base nos critérios aplicados. Caso existam eventos correspondentes, eles serão listados na tabela de eventos para visualização dos seguintes dados: tipos de evento, evento, data de previsão e se é um evento padrão.
Caso não haja resultados, a mensagem "Nenhum evento a ser exibido. Ainda não há eventos para serem exibidos" será apresentada. Nessa situação, o usuário poderá ajustar os critérios e realizar uma nova busca.
# Eventos
# → Eventos não encontrados
Após clicar em "Buscar", se nenhum evento corresponder aos critérios informados, o sistema exibirá a mensagem "Nenhum evento a ser exibido. Ainda não há eventos para serem exibidos". Nessa situação, o usuário poderá ajustar os critérios e realizar uma nova busca.
# → Eventos Encontrados
Após preencher os campos de busca e clicar no botão "Buscar", o sistema exibirá uma tabela com a lista de eventos que correspondem aos critérios informados. A tabela apresentará os seguintes dados:
- Tipos de Evento: Categoria ou tipo do evento listado.
- Evento: Nome do evento.
- Previsão: Data prevista para a ocorrência do evento.
- Evento Padrão: Indica se o evento é marcado como padrão (Sim ou Não).
# ESPECIFICIDADES
Descreva os itens abaixo referente as validações.
| FUNÇÃO | PARÂMETROS | STATUS/COMPORTAMENTO |
|---|---|---|
# PROCEDIMENTOS BÁSICOS – SÍMBOLOS E CONVENÇÕES
Adicionar Filtro: Localizado na tabela, o botão "Adicionar Filtro" permite inserir critérios específicos para refinar a busca na tabela de lista de eventos. Ao ser clicado, ele abre uma janela com opções de filtros disponíveis.

Navegação Tabela: Localizado no rodapé da tabela, o usuário pode selecionar o número de linhas a serem exibidas por página e navegar entre as páginas.

Botão Fechar: Ao clicar no botão 'Fechar', o usuário será redirecionado para a tela/caminho anterior.
# REQUISITOS DE USUÁRIOS
Principais ações que poderão ser executadas na tela de calendários do sistema SOMUS.
| USUÁRIO | RESPONSABILIDADES |
|---|---|
| Planejamento | Poderá realizar buscas por calendários |
| Poderá visualizar os eventos correspondentes ao calendário | |
| Poderá aplicar filtros específicos e refinar a lista de eventos exibida. | |
| Poderá navegar entre os eventos dos calendários | |
| Poderá limpar pesquisas efetuadas |
# TECLAS DE ATALHO
[Mapeamento das teclas de atalhos utilizados na funcionalidade]
| AÇÃO/FUNÇÃO | PORTUGÊS | INGLÊS | ESPANHOL |
|---|---|---|---|
# RELATÓRIO DE INCIDÊNCIAS
Seção destinada a resolução de problemas e erros que podem ocorrer e como pode ser solucionado.
| PROBLEMA | CAUSA | SOLUÇÃO |
|---|---|---|
# DOCUMENTOS RELACIONADOS
| TÍTULO | VERSÃO | LINK |
|---|---|---|
| Calendários | 1° | - |
| Eventos | 1° | - |
# CONTATOS
Fale com a gente e tire suas dúvidas!
Email: <Variáveis parametrizáveis a serem definidas>
Telefone: <Variáveis parametrizáveis a serem definidas>
Área Responsável: <Variáveis parametrizáveis a serem definidas>