Documentação do Sistema de Reserva de Salas da Intranet do ICMC-USP

Transcrição

1 UNIVERSIDADE DE SÃO PAULO Instituto de Ciências Matemáticas e de Computação Departamento de Ciências da Computação e Estatística Documentação do Sistema de Reserva de Salas da Intranet do ICMC-USP André Pimenta Freire Renata Pontin de M. Fortes apfreire@grad.icmc.usp.br renata@icmc.usp.br Dezembro/2003 1

2 Índice 1 - Introdução Requisitos do Sistema de Reserva de Salas... 4 A. Visão Geral... 4 B. Requisitos Funcionais... 4 B. Requisitos Não-Funcionais Dados sobre o Sistema de Reserva de Salas Quadros de Operações Diagrama de Casos de Uso Diagrama de Máquina de Estados Diagrama do Administrador Diagrama da área pública Diagrama do usuário autenticado Diagrama do Usuário com domínio sobre salas Modelagem de Dados Modelo Entidade-Relacionamento (MER) Modelo de Dados Relacional Referências Bibliográficas

3 1 - Introdução Este relatório, na forma de Documentação de software do Sistema de Reserva de Salas, apresenta informações técnicas sobre o referido sistema. O objetivo é o de registrar suas principais características e as soluções de implementação que foram adotadas. O Sistema de Reserva de Salas visa auxiliar as atividades cotidianas referentes a alocação do recurso Salas de uma unidade de ensino, em especial foram atendidas as requisições de procedimentos vigentes no Instituto de Ciências Matemáticas e de Computação da Universidade de São Paulo. Como o meio acadêmico envolve uma série de atividades relacionadas ao domínio de ensino e pesquisa, freqüentemente, os professores necessitam estabelecer datas de provas, comunicar aulas extras e reservar equipamentos, tais como projetores e computadores, assim como salas para apresentação de seminários, aplicação de provas extras ou mesmo realização de reuniões. Por outro lado, outras pessoas envolvidas no meio acadêmico, tais como estudantes e secretárias administrativas, necessitam estar cientes de agendas comuns. Por exemplo, as secretárias necessitam saber as agendas disponíveis de todos os professores que trabalham em um grupo de um departamento para programar uma reunião em um horário apropriado. Conseqüentemente, a importância e a utilidade de um espaço comum, na forma de uma agenda colaborativa foram notadas [Bannon & Bødker, 1997], principalmente para o suporte ao agendamento de compromissos acadêmicos e educacionais. No Risk Planning é um sistema de informações na Web, que funciona como uma agenda eletrônica, desenvolvida com o intuito de facilitar o planejamento das atividades realizadas no meio acadêmico. Ela permite agendar compromissos para grupos de trabalho e, alternativamente, também pode ser usada como agenda pessoal [Ribeiro, Fortes & Freire, 2003]. Inicialmente a agenda No Risk Planning foi desenvolvida em um projeto de graduação [Moura 2001] sob orientação da Profª. Renata Pontin de Mattos Fortes, para dar suporte a agendas compartilhadas por grupos, utilizando a linguagem PHP e o SGBD MySQL. A evolução do sistema, também sob a orientação da Profª. Fortes, foi implementada pelos alunos André Pimenta Freire e Tyciano Maia Ribeiro. O processo de engenharia, manutenção e evolução do sistema foi tema da Dissertação de mestrado do aluno Tyciano Maia Ribeiro [Ribeiro, 2003]. No início do ano de 2003, observou-se que os recursos funcionais da agenda No Risk Planning atenderiam às requisições de um Sistema de Reserva de Salas, pelo Conselho Técnico Administrativo (CTA-ICMC-USP). A partir de então, o sistema agenda No Risk Planning foi submetido a um processo de manutenção de maneira que foram realizadas adaptações e integração ao sistema Intranet do ICMC, cujo endereço eletrônico é Assim, foi desenvolvido o Sistema de Reserva de Salas, que apresenta as principais áreas para interação com os usuários: a) Área de Acesso público, onde alunos e o público geral podem visualizar os dados das reservas efetuadas no sistema e fazer buscas por esses dados, 3

4 b) Área para Usuários cadastrados no sistema, onde esses podem fazer buscas e efetuar reservas em salas e datas específicas, ou caso tenha permissão de domínio 1 sobre a sala, agendar reservas fixas que ocorrem toda semana, e c) Área do Administrador de Salas, responsável por gerenciar as salas e os usuários do sistema de reservas, atribuindo-lhes permissões para o uso do sistema. Para efetuar essa documentação foram utilizados modelos de documentos e artefatos preconizados pelo método Fusion-RE/I (Fusion Reverse Engineering/Interface) desenvolvido no ICMC-USP [Costa 1997], e outros documentos foram confeccionados utilizando Unified Modeling Language (UML). O Sistema de Reserva de Salas está integrado à Intranet do ICMC-USP, tendo, portanto, herdado algumas de suas funcionalidades. Essa documentação tem como principal foco o Sistema de Reserva de Salas, e alguns de seus elos com a Intranet, mas não oferece informações específicas quanto à Intranet. 2 Requisitos do Sistema de Reserva de Salas O documento de requisitos do Sistema de Reserva de Salas foi especificado de acordo com o modelo proposto por [Turine & Masiero, 1996]. Ele está organizado em três principais seções, a saber: Visão Geral, Requisitos Funcionais e Requisitos Não Funcionais. A. Visão Geral O Sistema de Reserva de Salas visa auxiliar as atividades cotidianas referentes à alocação do recurso Salas de uma unidade de ensino, em especial atender as requisições de procedimentos vigentes no Instituto de Ciências Matemáticas e de Computação da Universidade de São Paulo. B. Requisitos Funcionais Acesso a salas R1. O Sistema deve permitir que qualquer pessoa possa consultar as reservas feitas em uma sala através de uma área de acesso público. R2. O Sistema deve permitir que qualquer pessoa possa fazer buscas por reservas já efetuadas. R3. O Sistema deve exibir as agendas das salas na forma de quadros semanais, com possibilidade de navegação por estes. 1 O usuário possui permissão de domínio sobre determinada sala, quando possui privilégios de operações relacionadas com as reservas dessa sala. Por exemplo, os funcionários da Seção de Graduação têm permissão de domínio sobre as salas de aula, uma vez que são eles os usuários responsáveis por remarcar/desmarcar os agendamentos dessas salas quando necessário. 4

5 R4. O Sistema deve possibilitar a exibição de maiores informações sobre uma reserva a qualquer momento. R5. O Sistema deve exibir as reservas classificadas em tipos, a saber: Aula, Conferência, Palestra, Congregação, Conselho, Comissão, Seminário, Reunião, Monitoria, Outros. R6. O Sistema deve exibir cada tipo de reserva com uma cor diferente, a saber: Vermelho: Aula e Monitoria; Azul claro: Conferência e Palestra; Amarelo: Congregação, Conselho e Comissão; Verde: Seminário e Reunião; Cinza: Outros. R7. O Sistema deve oferecer uma Ajuda detalhada a todos os tipos de usuário. Usuários R8. O Sistema deve classificar os usuários em categorias, com permissões diferenciadas. R9. O Sistema deve conter uma permissão diferenciada para usuários que terão domínio sobre um grupo de salas, e serão uma espécie de gerentes destas. R10. O Sistema deve conter um usuário do tipo Administrador, que será responsável pela criação de usuários, de salas, pela definição de permissões. Reservas R11. O Sistema deve oferecer dois tipos de reservas: eventuais e fixas semanalmente. As reservas eventuais terão vigência somente na data e horário em que foram marcadas, e as fixas serão ligadas a um dia da semana e horário, e se repetirão semanalmente. R12. O Sistema deve permitir que os usuários com permissão de agendamento comum sobre as salas possam incluir, excluir e modificar reservas eventuais. R13. O Sistema deve pedir que os seguintes dados sejam informados para a marcação de reservas eventuais: dia, mês, ano, horário de início, horário de fim, tipo da reserva, descrição, descrição estendida. R14. O Sistema deve permitir que sejam marcadas em uma mesma iteração quantas reservas forem necessárias. R15. O Sistema deve permitir que os usuários com domínio sobre salas possam incluir, excluir e modificar reservas fixas semanalmente. R16. O Sistema deve pedir que os seguintes dados sejam informados para a marcação de reservas fixas: dia da semana, horário de início, horário de fim, tipo da reserva, descrição, descrição estendida e quem será o(s) utilizador(es) da sala, que poderão ser em um número máximo de três. R17. O Sistema deve permitir que os usuários com domínio sobre salas liberem salas com reservas fixas em determinados períodos como feriados, recessos e eventos. R18. O Sistema deve permitir que os usuários com domínio sobre salas cadastrem as liberações de sala, devendo pedir que sejam informados: data de início e data de fim e a descrição da liberação. 5

6 R19. O Sistema deve permitir que os usuários com domínio sobre salas listem as liberações de sala. R20. O Sistema deve permitir que os usuários com domínio sobre salas possam cancelar as liberações. R21. O Sistema deve permitir que os usuários com domínio e o Administrador possam limpar todas as reservas fixas de uma sala. R22. O Sistema deve permitir que os usuários com domínio e o Administrador possam limpar todas as reservas eventuais de uma sala. R23. O Sistema deve emitir um relatório contendo todas as reservas de um determinado tipo. R24. O Sistema não deve permitir que os usuários sem permissão de domínio façam reservas com datas superiores a uma semana a partir da data atual. (Esse período pode ser alterado de acordo com decisão posterior do CTA). R25. O Sistema deve permitir que sejam feitas buscas por salas com horários livres para reservas eventuais. R26. O Sistema deve permitir que sejam feitas buscas por salas com horários livres para reservas fixas. R27. O Sistema deve permitir que seja visualizada a agenda de pessoas de acordo com as reservas associadas a ela. R28. O Sistema deve registrar, no momento do agendamento de uma reserva, a data, hora e a pessoa que a efetuou. Gerenciamento R29. O Sistema deve permitir que o Administrador inclua, exclua e modifique categorias de permissões. R30. O Sistema deve pedir que no cadastramento de uma categoria de permissões sejam informados: o nome da categoria, e as permissões desta em forma de sim/não para cada permissão. R31. O Sistema deve permitir que o Administrador inclua, exclua e modifique permissões de usuários. R32. O Sistema deve pedir que no cadastramento de um usuário seja informado o número e a categoria deste. R33. O Sistema deve permitir que o Administrador inclua, exclua e modifique salas. R34. O Sistema deve pedir que no cadastramento de uma sala sejam informados: o código, a capacidade, o tipo e comentários opcionais sobre a sala. R35. O Sistema deve permitir a classificação das salas em: Salas de Aula, Salas de Reuniões, Salas de Eventos, Salas da Biblioteca e Salas da Pós-Graduação. 6

7 Gerais R36. O Sistema deve ser integrado à Intranet. R37. O Sistema deve ser implementado em plataforma Web. B. Requisitos Não-Funcionais R38. O Sistema deve ter alta interoperabilidade, uma vez que será integrado à Intranet. R39. O Sistema deve ter alta portabilidade, devendo ser visualizado por qualquer browser da Web. R40. O Sistema deve ter uma alta usabilidade, uma vez que será utilizado por todos os funcionários, com diferentes graus de conhecimentos em informática. R41. O Sistema deve ter uma alta manutenibilidade. 3 Dados sobre o Sistema de Reserva de Salas O Sistema de Reserva de Salas da Intranet do ICMC-USP é um aplicativo disponível na Internet, que roda sobre a World-Wide Web nos diversos browsers existentes. Ele foi baseado no sistema No Risk Planning [Ribeiro, Fortes & Freire, 2003]. Sua implementação está constituída de 85 arquivos de programa fonte escritos em PHP (Personal Home Page) num total de linhas de código, distribuídas conforme mostra a Tabela 1, que contém também uma breve descrição da funcionalidade de cada programa. Tabela 1- Arquivos de código fonte PHP que compõem a o Sistema de Reserva de Salas Nome do Arquivo (terminação.php) Linhas de código 01 ajuda_publico 23 Seção de ajuda da área de acesso público do sistema. 02 ajuda_usuario 23 Seção de ajuda da área de usuário comum. 03 Seção de ajuda da área de usuário com domínio sobre ajuda_dominio 23 salas. 04 ajuda_admin 23 Seção de ajuda do Administrador. 05 Baixo 26 Inclui a barra inferior da página. 06 Incluir a barra inferior da página da área de acesso baixo_sala_aberto 27 público. 07 Incluir a barra inferior da página da área do baixo_sala_adm 37 administrador. 08 Baixo 33 Gera a parte inferior da interface do usuário. 09 baixo_admin 35 Gera a parte inferior da interface do administrador. 10 Cima 65 Gera a parte superior da interface do usuário. 11 cima_sala_adm 83 Gera a parte superior da interface do administrador. 12 Gera a parte superior da interface da área de acesso cima_sala_publico 75 público. 13 Usado em todos os arquivos que necessitam fazer Conectar 15 conexão com o banco de dados. 7

8 14 geral_sala 82 Seção de modificação dos dados do usuário. 15 Gera o quadro com a agenda semanal de uma sala sala_agenda_semanal 182 específica. 16 sala_funcoes 353 Biblioteca de funções para impressão de compromissos. 17 Visualização da agenda semanal de uma sala específica sala_semanal_publico 101 na área pública, com opções de navegação. 18 salas.php 116 Página inicial da área de acesso público. 19 salas_adm_agendar.php 228 Página inicial do Administrador. 20 salas_adm_agendar1.php 112 Exibição da agenda de uma sala para o administrador. 21 salas_adm_altera_eventual.php 43 Agendamento de reserva eventual pelo administrador. 22 salas_adm_altera_eventual2.php 510 Efetivação de reserva eventual pelo administrador. 23 salas_adm_altera_modifica.php 63 Modificação de reserva fixa pelo Administrador. 24 Efetivação de modificação de reserva pelo salas_adm_altera_modifica2.php 395 Administrador. 25 salas_altera_novo.php 498 Agendamento de reserva fixa pelo Administrador. 26 salas_altera_retira 78 Cancelamento de reserva fixa pelo Administrador. 27 Efetivação de cancelamento de reserva fixa pelo salas_altera_retira2 78 Administrador. 28 Busca de sala livre para reserva eventual pelo salas_adm_buscar_eventual 147 Administrador. 29 Busca de sala livre para reserva fixa pelo salas_adm_buscar_fixo 97 Administrador. 30 Exibe as opções referentes ao Gerenciamento de salas_adm_categ 37 categorias do Administrador. 31 salas_adm_categ_cria 272 Criação de uma nova categoria pelo Administrador. 32 salas_adm_categ_modif 81 Escolha de uma categoria a ser modificada pelo Administrador. 33 salas_adm_categ_modif2 310 Modificação de uma categoria pelo Administrador. 34 Escolha de uma categoria a ser removida pelo salas_adm_categ_remove 81 Administrador. 35 salas_adm_categ_remove2 60 Remoção de uma categoria pelo Administrador. 36 Checa se o usuário atual tem permissão de salas_adm_checa 10 Administrador. 37 Mostra as funções gerais de gerenciamento do salas_adm_geral 32 Administrador. 38 salas_adm_geral_limpa_eventual 62 Limpa todos as reservas eventuais das salas escolhidas. 39 salas_adm_geral_limpa_fixo 62 Limpa todas as reservas fixas das salas escolhidas. 40 Escolha de uma reserva eventual para ser modificada salas_adm_modifica_eventual 62 pelo Administrador. 41 Modificação de uma reserva eventual pelo salas_adm_modifica_eventual2 459 Administrador. 42 Escolha de uma reserva eventual a ser removida pelo salas_adm_retira_eventual 62 Administrador. 43 salas_adm_retira_eventual2 69 Remoção de uma reserva eventual pelo Administrador. 44 Exibe opções de gerenciamento de salas pelo salas_adm_salas 37 Administrador. 45 salas_adm_sala_cria 132 Cadastramento de uma nova sala pelo Administrador 46 Escolha de uma sala a ser modificada pelo salas_adm_sala_modif 81 Administrador 47 salas_adm_sala_modif2 147 Modificação de uma sala pelo Administrador. 48 salas_adm_sala_remove 81 Escolha de uma sala a ser removida pelo Administrador. 49 salas_adm_sala_remove2 73 Remoção de uma sala pelo Administrador. 50 salas_adm_usu 37 Exibe as funções de gerenciamento de usuários pelo Administrador. 8

9 Administrador. 51 salas_adm_usu_cria 127 Criação de um novo usuário pelo Administrador. 52 salas_adm_usu_modif 105 Escolha de um usuário a ser modificado pelo Administrador. 53 salas_adm_usu_modif2 122 Modificação de um usuário pelo Administrador. 54 salas_adm_usu_remove 105 Escolha de um usuário a ser removido pelo Administrador. 55 salas_adm_usu_remove2 85 Remoção de um usuário pelo Administrador. 56 salas_agendar.php 396 Página inicial de um usuário autenticado. 57 salas_agendar1.php 155 Exibição da agenda de uma sala para um usuário autenticado. 58 salas_altera_eventual 46 Agendamento de uma reserva eventual para um usuário autenticado. 59 salas_altera_eventual2 616 Efetivação de uma reserva eventual por usuário autenticado. 60 salas_altera_modifica 81 Escolha de uma reserva fixa a ser modificada por um usuário com domínio sobre a sala. 61 salas_altera_modifica2 524 Modificação de uma reserva fixa por um usuário com domínio sobre a sala. 62 salas_altera_novo 498 Agendamento de uma reserva fixa por um usuário com domínio sobre a sala. 63 salas_altera_retira 78 Escolha de uma reserva fixa a ser removida por um usuário com domínio sobre a sala. 64 salas_altera_retira2 78 Remoção de uma reserva fixa por um usuário com domínio sobre a sala. 65 salas_buscar 127 Busca de reserva por palavra chave por um usuário autenticado. 66 Salas_buscar_eventual 200 Busca de sala livre para reserva eventual por um usuário autenticado. 67 salas_buscar_fixo 143 Busca de sala livre para reserva fixa por um usuário com domínio sobre salas. 68 salas_buscar_publico 114 Busca de reserva por palavra chave na área de acesso público. 69 salas_gerenc 62 Exibe opções de gerenciamento para usuários com domínio sobre salas. 70 salas_horario_semanal 79 Exibe a agenda semanal de uma sala com as opções de navegação, sem as opções de menu. 71 salas_info 168 Exibe informações detalhadas sobre uma reserva. 72 salas_libera_cancelar 69 Escolhe uma liberação de sala para ser cancelada por um usuário com domínio sobre salas. 73 salas_libera_cancelar2 78 Cancela uma liberação de sala para sobreposição de reservas fixas. 74 salas_libera_listar 54 Lista todas as liberações de sala 75 salas_liberar 497 Liberação de uma sala para sobreposição de reservas fixas por um usuário com domínio sobre salas. 76 salas_limpar_eventuais 97 Limpa todas as reservas eventuais de uma sala para um usuário com domínio sobre salas. 77 salas_limpar_fixos 108 Limpa todas as reservas fixas de uma sala par um usuário com domínio sobre salas. 78 salas_localizar2 111 Exibe a agenda de um usuário dadas as salas onde ele tem reserva. 79 salas_modifica_eventual 73 Escolha de uma reserva eventual para ser modificada. 80 salas_modifica_eventual2 495 Modificação de uma reserva eventual 81 salas_perm_checa 48 Verifica as permissões de um usuário 9

10 82 Exibe as opções para a geração de relação de reservas salas_relacao 57 fixas 83 salas_relacao1 138 Exibe a relação de reservas fixas. 84 salas_retira_eventual 72 Escolha de uma reserva eventual a ser removida. 85 salas_retira_eventual2 78 Remoção de uma reserva fixa. 4 Quadros de Operações Abaixo seguem os quadros detalhados de operações do Sistema de Reserva de Salas. Estes quadros contêm a operação especificada, o nome do arquivo que chama a operação, com quais arquivos este arquivo está relacionado, uma descrição da operação, informações sobre leitura, modificação e envio e o resultado final da operação. (1) Operação: Público/ Ajuda Nome do Arquivo: ajuda_publico.php Este programa chama os seguintes: cima_sala_publico.php baixo_sala_aberto.php Programas que cima_sala_publico.php Exibe uma tela de ajuda para a área de acesso público Resultado: É exibida a tela de ajuda para a área de acesso público, contendo instruções sobre como efetuar buscas por palavra chave e navegar pelas agendas das salas. (2) Operação: Usuário comum/ Ajuda Nome do Arquivo: ajuda_usuario.php Este programa chama os seguintes: cima.php baixo.php Programas que cima.php Exibe uma tela de ajuda para usuário autenticado Resultado: É exibida a tela de ajuda para usuário autenticado, contendo instruções sobre a navegação pelas agendas das salas, como efetuar reservas e como manipular o sistema.. (3) Operação: Usuário com domínio/ Ajuda Nome do Arquivo: ajuda_dominio.php Este programa chama os seguintes: cima.php baixo.php Programas que cima.php 10

11 Exibe uma tela de ajuda para usuário autenticado com domínio sobre salas Resultado: É exibida a tela de ajuda para usuário autenticado com domínio sobre salas, contendo instruções sobre a navegação pelas agendas das salas, como efetuar reservas e como manipular o sistema.. (4) Operação: Administrador/ Ajuda Nome do Arquivo: ajuda_admin.php Este programa chama os seguintes: cima_sala_adm.php baixo_sala_adm.php Programas que cima_sala_adm.php Exibe uma tela de Ajuda para o Administrador Resultado: É exibida a tela de ajuda para o Administrador, contendo informações gerais sobre o Gerenciamento do Sistema. (5) Operação: Entrar na área de acesso público Nome do Arquivo: salas.php Este programa cima_sala_publico.php chama os seguintes: conectar.php salas_buscar_publico.php sala_semanal_publico.php baixo_sala_publico.php Programas que salas_buscar_publico.php sala_semanal_publico.php Tela inicial da área de Acesso Público Palavra chave da busca ou Sala a ser visualizada Resultado: - Se for preenchida uma palavra chave e o botão Buscar for acionado, exibirá o resultado da busca por reservas para a palavra chave digitada, através da chamada ao arquivo salas_buscar_publico.php - Se o hyperlink com o código de uma sala for acionado, mostra a agenda da sala escolhida, através da chamada ao arquivo sala_semanal_publico.php (6) Operação: Público/ Exibir agenda de Sala Nome do Arquivo: sala_semanal_publico.php 11

12 Este programa chama os seguintes: Programas que cima_sala_publico.php salas.php conectar.php sala_agenda_semanal.php baixo.php salas.php Exibe a agenda de uma sala Existência de cookie com o código da sala cuja agenda será exibida., Resultado: - Se o usuário tiver aberto a agenda pela primeira vez ou tiver clicado no botão Semana atual. - Se for acionado o botão << exibe a agenda da sala na semana anterior - Se for acionado o botão >> exibe a agenda da sala na próxima semana (7) Operação: Público / Buscar reservas Nome do Arquivo: salas_buscar_publico.php Este programa chama os seguintes: conectar.php cima_sala_publico.php salas.php salas_info.php Programas que salas.php Exibe o resultado de uma busca por palavra chave na área de acesso público. Palavra chave Resultado: - Se houver alguma reserva com a palavra chave digitada, exibe a lista de reservas com o hyperlink para as salas e para as reservas. - Se for acionado o hyperlink para uma reserva, exibe informações detalhadas sobre ela, acionando o arquivo salas_info.php - Se for acionado o hyperlink para uma sala, exibe a agenda da sala, acionando o arquivo sala_semanal_publico.php (8) Operação: Administrador/ Entrar no sistema Nome do Arquivo: salas_adm_agendar.php Este programa salas_adm_checa.php chama os seguintes: conectar.php salas_adm_agendar1.php salas_adm_buscar_eventual.php salas_adm_buscar_fixo.php cima_sala_adm.php Programas que baixo_sala_adm.php Todos as funções do Administrador tem um hyperlink para retornar à tela inicial. 12

13 inicial. Exibe as funcionalidades básicas para o administrador, a saber: a relação de salas para navegação, busca por horários livres para reservas fixas, busca por horários livres para reservas eventuais. - Dia da semana, horário de início e horário de fim, para busca para reservas fixas - Dia, mês, ano, horário de início e horário de fim, para busca para reservas eventuais - Código da sala para exibição da agenda - Agente interno: {#msg Você não está logado como Administrador} Agente interno: {#msg Você não está logado na Intranet} Existência de cookie que informa que o usuário está logado como administrador Resultado: - Se for acionado o botão Buscar para reservas fixas, e os campos forem preenchidos corretamente, aciona o arquivo salas_adm_buscar_fixo - Se for acionado o botão Buscar para reservas fixas, e algum campo não for preenchido corretamente, exibe uma mensagem de erro. - Se for acionado o botão Buscar para reservas fixas, e os campos forem preenchidos corretamente, aciona o arquivo salas_adm_buscar_eventual - Se for acionado o botão Buscar para reservas fixas, e algum campo não for preenchido corretamente, exibe uma mensagem de erro. - Se for acionado o hyperlink de uma sala, aciona o arquivo salas_adm_agendar1.php para exibir a agenda da sala (9) Operação: Administrador/ Exibir agenda de sala Nome do Arquivo: salas_adm_agendar1.php Este programa cima_sala_adm.php chama os seguintes: salas_adm_agendar.php salas_adm_altera_novo.php salas_adm_altera_eventual.php salas_adm_altera_retira.php salas_adm_retira_eventual.php salas_adm_altera_modifica.php salas_adm_modifica_eventual.php Programas que salas_adm_agendar.php Resultado: Exibe a agenda de uma sala e exibe os hyperlinks para o agendamento, modificação e remoção de reservas para uma dada sala. Existência de cookie que informa que o usuário está logado como administrador - Se o usuário clicar em Agendar reserva fixa semanalmente abre a tela para agendamento de reservas fixas, carregando o arquivo salas_adm_altera_novo.php - Se o usuário clicar em Agendar reserva eventual abre a tela para agendamento de reservas eventuais, carregando o arquivo salas_adm_altera_eventual.php 13

14 salas_adm_altera_eventual.php - Se o usuário clicar em Remover reserva fixa semanalmente abre a tela para escolha de reserva para ser removida, carregando o arquivo salas_adm_altera_retira.php - Se o usuário clicar em Remover reserva eventual abre a tela para escolha de reserva para ser removida, carregando o arquivo salas_adm_retira_eventual.php - Se o usuário clicar em Modificar reserva fixa semanalmente abre a tela para escolha de reserva para ser modificada, carregando o arquivo salas_adm_altera_modifica.php - Se o usuário clicar em Modificar reserva eventual abre a tela para es colha de reserva para ser modificada, carregando o arquivo salas_adm_modifica_eventual.php - Se o usuário clicar em uma reserva específica, será exibida a tela com informações adicionais, carregando o arquivo salas_info.php (10) Operação: Administrador/ Agendar Reserva Eventual Nome do Arquivo: salas_adm_altera_eventual.php salas_adm_altera_eventual2.php Este programa salas_adm_checa.php chama os seguintes: cima_sala_adm.php conectar.php salas_adm_agendar.php Programas que baixo_sala_adm.php salas_adm_agendar1.php salas_adm_buscar_eventual.php Permite que o Administrador efetue reservas eventuais Número de reservas, Dia, Mês, Ano, horário de início, horário de fim, tipo, descrição, descrição estendida, para cada reserva. Tabela proj_eventual Agente interno: {#msg Você não escolheu o dia da reserva} Agente interno: {#msg Você não escolheu o ano da reserva} Agente interno: {#msg Você não escolheu o mês da reserva} Agente interno: {#msg Você não escolheu o horário de término da reserva} Agente interno: {#msg Você não escolheu o horário de início da reserva} Agente interno: {#msg Você não preencheu a descrição da reserva} Agente interno: {#msg O horário de início da reserva é maior do que o horário de término} Agente interno: {#msg Você não escolheu o tipo da reserva} Agente interno: {#msg Já existe uma reserva para essa sala no horário especificado} Agente interno: {#msg Reserva(s) efetuada(s)} Existência de cookie que informa que o usuário está logado como administrador Resultado: - Após o usuário escolher o número de reservas que serão efetuadas, é exibido um conjunto de campos para cada reserva. - Se todos os campos de todas as reservas forem preenchidos corretamente, o sistema irá gravar as reservas no banco de dados. - Se houver algum problema com alguma das reservas, o sistema irá pedir que o problema seja solucionado, e não efetuará nenhuma das reservas enquanto o problema não for resolvido. 14

15 pedir que o problema seja solucionado, e não efetuará nenhuma das reservas enquanto o problema não for resolvido. (11) Operação: Administrador / Modificar uma reserva fixa Nome do Arquivo: salas_adm_altera_modifica.php salas_adm_altera_modifica2.php Este programa salas_adm_checa.php chama os seguintes: cima_sala_adm.php conectar.php sala_agenda_semanal.php baixo_sala_adm.php Programas que salas_adm_agendar1.php Permite que o Administrador modifique uma reserva fixa já efetuada por qualquer usuário do sistema. Reserva a ser modificada, sala, Nova descrição, Nova descrição estendida, novo dia da semana, novo horário de início, novo horário de fim. Tabela proj_compromissos Agente interno: {#msg Você não escolheu o dia da semana} Agente interno: {#msg Você não escolheu o horário de início} Agente interno: {#msg Você não escolheu o horário de término} Agente interno: {#msg O horário de término deve ser maior que o horário de início} Agente interno: {#msg Você não escolheu o tipo do compromisso} Agente interno: {#msg Você não preencheu a descrição do compromisso} Agente interno: {#msg Já existe uma reserva para essa sala no horário especificado} Agente interno: {#msg Reserva alterada com sucesso} Existência de cookie que informa que o usuário está logado como administrador Resultado: - Após a escolha da reserva a ser modificada, são exibidas as informações atuais sobre a reserva. - Após alterar os dados, e clicar no botão Modificar, se todos os dados estiverem corretos, a reserva será modificada. - Se houver algum problema com os novos dados, será exibida uma mensagem de erro. (12) Operação: Administrador/ Agendar reserva fixa Nome do Arquivo: salas_adm_altera_novo.php Este programa salas_adm_checa.php chama os seguintes: conectar.php salas_adm_agendar1.php cima_sala_adm.php sala_agenda_semanal.php Programas que baixo_sala_adm.php salas_adm_agendar1.php salas_adm_buscar_fixo.php 15

16 Agenda uma nova reserva fixa para uma dada sala Sala, Dia da semana, horário de início, horário de término, descrição, descrição estendida Tabela proj_compromissos Agente interno: {#msg Você não escolheu o dia da semana} Agente interno: {#msg Você não escolheu o horário de término} Agente interno: {#msg Você não escolheu o horário de início} Agente interno: {#msg O horário de término deve ser maior que o horário de início} Agente interno: {#msg Você não preencheu a descrição} Agente interno: {#msg Você não escolheu o tipo da reserva} Agente interno: {#msg Já existe uma reserva para essa sala no horário especificado} Agente interno: {#msg Reserva efetuada com sucesso} Existência de cookie que informa que o usuário está logado como administrador Resultado: - Se todos os dados forem preenchidos corretamente, e não houver nenhuma reserva no horário especificado, a reserva é efetuada. - Se houver algum problema com os dados, o sistema exibe uma mensagem de erro. (13) Operação: Administrador / Remoção de reserva fixa Nome do Arquivo: salas_adm_altera_retira.php salas_adm_altera_retira2.php Este programa salas_adm_checa.php chama os seguintes: cima_sala_adm.php conectar.php sala_agenda_semanal.php baixo_sala_adm.php salas_adm_agendar1.php Programas que salas_adm_agendar1.php Permite que o administrador remova uma reserva fixa de qualquer sala efetuada por qualquer usuário do sistema. Sala e reserva a ser removida. Tabela proj_compromissos Agente interno: {#msg Você realmente quer remover a reserva?} Agente interno: {#msg Reserva removida com sucesso} Agente interno: {#msg Remoção cancelada} Existência de cookie que informa que o usuário está logado como administrador Resultado: - Após o usuário escolher a reserva e acionar o botão Remover o sistema irá exibir uma mensagem de confirmação. - Se o usuário escolher Sim, a remoção da reserva escolhida será efetuada. - Se o usuário escolher Não, a reserva permanecerá inalterada e não será removida. 16

17 (14) Operação: Administrador/ Buscar salas livres para reserva eventual Nome do Arquivo: salas_adm_buscar_eventual.php Este programa conectar.php chama os seguintes: cima_sala_adm.php salas_adm_altera_eventual2.php baixo_sala_adm.php Programas que salas_adm_agendar.php Lista todas as salas que estejam livre para reserva eventual num dado dia e horário. Dia, mês, ano, horário de início, horário de fim - - Existência de cookie que informa que o usuário está logado como administrador Resultado: - Retorna a listagem de todas as salas que estão livres para reserva eventual no dia e horário especificado. - Se o Administrador acionar o hyperlink com o código de alguma sala, será aberta a página para efetuar a reserva, chamando o arquivo salas_adm_altera_eventual2.php (15) Operação: Administrador/ Buscar salas livres para reserva fixa Nome do Arquivo: salas_adm_buscar_fixa.php Este programa conectar.php chama os seguintes: cima_sala_adm.php salas_adm_altera_novo.php baixo_sala_adm.php Programas que salas_adm_agendar.php Lista todas as salas que estejam livre para reserva fixa num dado dia da semana e horário. Dia da semana, horário de início, horário de fim - - Existência de cookie que informa que o usuário está logado como administrador Resultado: - Retorna a listagem de todas as salas que estão livres para reserva fixa no dia da semana e horário especificado. - Se o Administrador acionar o hyperlink com o código de alguma sala, será aberta a página para efetuar a reserva, chamando o arquivo salas_adm_altera_novo.php (16) Operação: Administrador / Criar nova categoria Nome do Arquivo: salas_adm_categ_cria.php Este programa salas_adm_checa.php chama os seguintes: conectar.php salas_adm_categ.php 17

18 Programas que cima_sala_adm.php baixo_sala_adm.php salas_adm_categ.php Permite ao Administrador que seja criada uma nova categoria de usuários. Nome da nova categoria e as permissões que serão atribuídas a ela. Tabela proj_permissões Agente interno: {#msg Você não preencheu o nome da categoria} Agente interno: {#msg Já existe uma categoria com esse nome} Agente interno: {#msg Categoria criada com sucesso} Existência de cookie que informa que o usuário está logado como administrador Resultado: - O Administrador preenche o nome da nova categoria e marca quais serão as permissões que serão atribuídas a ela. - Se não existir nenhum problema com o cadastro, o sistema cria a nova categoria. - Se houver algum problema, será exibida uma mensagem de erro. (17) Operação: Administrador / Modificar categoria Nome do Arquivo: salas_adm_categ_modif.php salas_adm_categ_modif2.php Este programa salas_adm_checa.php chama os seguintes: conectar.php cima_sala_adm.php salas_adm_categ.php baixo_sala_adm.php Programas que salas_adm_categ.php Permite que seja modificada uma categoria de usuários já existente. Nome da categoria, novo nome e novas permissões Tabela proj_permissões Agente interno: {#msg Você não preencheu o nome da categoria} Agente interno: {#msg Já existe uma categoria com esse nome} Agente interno: {#msg Categoria modificada com sucesso} Existência de cookie que informa que o usuário está logado como administrador Resultado: - Após ser escolhida a categoria que será modificada, serão exibidos os dados atuais desta. - O Administrador pode, então, modificar esses dados, e caso não haja problemas, os dados da categoria serão alterados na base de dados. - Se houver algum problema com o preenchimento dos novos dados da categoria, será exibida uma mensagem de erro. (18) Operação: Administrador / Remover categoria Nome do Arquivo: salas_adm_categ_remove.php salas_adm_categ_remove2.php Este programa salas_adm_checa.php chama os seguintes: 18

19 Programas que conectar.php cima_sala_adm.php baixo_sala_adm.php salas_adm_categ.php Permite que uma categoria existente seja removida. Nome da categoria. Tabela proj_permissões Agente interno: {#msg Tem certeza que deseja remover a categoria?} Agente interno: {#msg Remoção da categoria cancelada} Agente interno: {#msg Categoria removida} Existência de cookie que informa que o usuário está logado como administrador Resultado: - Após a escolha da categoria a ser removida, o sistema pede uma confirmação do Administrador para efetuar a remoção. - Se for escolhido Sim, a categoria será r emovida, e todos os usuários cadastrados nessa categoria serão removidos do sistema também. - Se for escolhido Não, a categoria não será removida. (19) Operação: Administrador/ Limpar reservas eventuais Nome do Arquivo: salas_adm_geral_limpa_eventual.php Este programa chama os seguintes: salas_adm_checa.php conectar.php salas_adm_geral.php cima_sala_adm.php baixo_sala_adm.php Programas que salas_adm_geral.php Limpa todas as reservas eventuais das salas escolhidas Códigos das salas Tabela proj_eventual Agente interno: {#msg Reservas eventuais limpas com sucesso} Existência de cookie que informa que o usuário está logado como administrador. Resultado: É exibida a relação de salas. O Administrador deverá então marcar todas as salas que terão todas as reservas eventuais removidas. (20) Operação: Administrador/ Limpar reservas fixas Nome do Arquivo: salas_adm_geral_limpa_fixo.php Este programa salas_adm_checa.php chama os seguintes: conectar.php salas_adm_geral.php cima_sala_adm.php baixo_sala_adm.php Programas que salas_adm_geral.php Limpa todas as reservas fixas das salas escolhidas 19

20 Códigos das salas Tabela proj_compromissos Agente interno: {#msg Reservas fixas limpas com sucesso} Existência de cookie que informa que o usuário está logado como administrador. Resultado: É exibida a relação de salas. O Administrador deverá então marcar todas as salas que terão todas as reservas fixas removidas. (21) Operação: Administrador / Modificar uma reserva eventual Nome do Arquivo: salas_adm_modifica_eventual.php salas_adm_modifica_eventual2.php Este programa salas_adm_checa.php chama os seguintes: cima_sala_adm.php conectar.php sala_agenda_semanal.php baixo_sala_adm.php Programas que salas_adm_agendar1.php Permite que o Administrador modifique uma reserva eventual já efetuada por qualquer usuário do sistema. Reserva a ser modificada, sala, Nova descrição, Nova descrição estendida, novo dia, mês e ano, novo horário de início, novo horário de fim, novo tipo. Tabela proj_eventuais Agente interno: {#msg Você não escolheu o dia} Agente interno: {#msg Você não escolheu o mês} Agente interno: {#msg Você não escolheu o ano} Agente interno: {#msg Você não escolheu o horário de início} Agente interno: {#msg Você não escolheu o horário de término} Agente interno: {#msg O horário de término deve ser maior que o horário de início} Agente interno: {#msg Você não escolheu o tipo do compromisso} Agente interno: {#msg Você não preencheu a descrição do compromisso} Agente interno: {#msg Já existe uma reserva para essa sala no horário especificado} Agente interno: {#msg Reserva alterada com sucesso} Existência de cookie que informa que o usuário está logado como administrador Resultado: - Após a escolha da reserva a ser modificada, são exibidas as informações atuais sobre a reserva. - Após alterar os dados, e clicar no botão Modificar, se todos os dados estiverem corretos, a reserva será modificada. - Se houver algum problema com os novos dados, será exibida uma mensagem de erro. (22) Operação: Administrador / Remover uma reserva eventual Nome do Arquivo: salas_adm_retira_eventual.php salas_adm_retira_eventual2.php 20