Mudanças entre as edições de "Agendamento de eventos"

De GeoSales
Ir para navegação Ir para pesquisar
(Criou página com '== Histórico de Alterações == {| class="wikitable" ! Data ! Quem ! Comentários |- | 14/02/2019 || Ryvane Maria || Criação do documento |- |} == Necessidade == É n...')
 
 
(17 revisões intermediárias por 3 usuários não estão sendo mostradas)
Linha 11: Linha 11:
 
== Necessidade ==
 
== Necessidade ==
  
−
É necessário realizar o controle e a gestão das atividades e eventos a serem realizados pelo usuário.
+
É necessário realizar o controle e a gestão das atividades e eventos a serem realizados.
  
 
Para que isso seja possível, inicialmente, o usuário deve cadastrar essas atividades no GeoSales, inserindo informações que são necessárias para o agendamento dos diversos tipos de eventos.
 
Para que isso seja possível, inicialmente, o usuário deve cadastrar essas atividades no GeoSales, inserindo informações que são necessárias para o agendamento dos diversos tipos de eventos.
Linha 17: Linha 17:
 
== Solução ==
 
== Solução ==
  
−
Deverá ser criado um cadastro de eventos, de forma que o usuário consiga inserir algumas informações que possam vir a realizar definições a respeito do evento a ser inserido.
+
Será criado um cadastro de eventos, de forma que o usuário consiga inserir algumas informações que possam vir a realizar definições a respeito do evento a ser inserido.
  
 
== Implementação ==
 
== Implementação ==
Linha 25: Linha 25:
 
'''- Criar campos no cadastro de eventos:'''
 
'''- Criar campos no cadastro de eventos:'''
  
−
Neste cadastro, deverão ser incluídos os seguintes campos:
+
O cadastro de evento será dividido em algumas etapas.Inicialmente o usuário deve cadastrar um cabeçalho para o seu evento. Neste cabeçalho, deverão ser inseridas as seguintes informações:
  
−
#Ícone: Poderão ser associados a um evento um ícone que ilustre a atividade a ser realizada.
+
#Título: Tem como finalidade identificar o evento de forma rápida.
 +
#Cor da Tag: Poderá ser associada a um evento uma cor que ilustre a atividade a ser realizada.
 
#Data de início: Data de início do evento, caso seja um evento que ocorrerá em apenas um dia, este campo irá definir a sua data de realização.
 
#Data de início: Data de início do evento, caso seja um evento que ocorrerá em apenas um dia, este campo irá definir a sua data de realização.
−
#Hora de início: Hora de início do evento
+
#Hora de início: Hora de início do evento.
−
#Data de término: Data de término do evento, caso seja um evento que ocorrerá em apenas um dia, este campo não precisa ser preenchido.
+
#Data de término: Data de término do evento, caso seja um evento que ocorrerá em apenas um dia, este campo não precisa ser preenchido.
 
#Hora de término: Hora de término do evento
 
#Hora de término: Hora de término do evento
−
#Título: Tem como finalidade identificar e descrever o evento de forma rápida.
+
 
 +
[[Arquivo:Cabecalho cadastro evento.png|700px]]
 +
 
 +
Cadastradas as informações de cabeçalho é necessário definir os detalhes do evento. Nesta aba, são inseridas informações de localização e tipo do evento, como pode-se visualizar abaixo:
 +
 
 +
#Tipo do evento: Os tipos de eventos irão depender dos tipos cadastrados pelo usuário de acordo com o documento [[Cadastro de tipo de eventos]].
 
#Descrição: Permite ao usuário inserir uma descrição mais detalhada a respeito do evento. Com possibilidade de formatação de texto html, é possível editar e formatar a descrição do evento.
 
#Descrição: Permite ao usuário inserir uma descrição mais detalhada a respeito do evento. Com possibilidade de formatação de texto html, é possível editar e formatar a descrição do evento.
−
#Notificação: Envio de notificação ao e-mail do usuário criador do evento e de cada usuário participante convidado.
 
−
#Cliente: Define se o evento envolve algum cliente específico ou não.
 
 
#Endereço: Define o endereço do evento, caso um cliente tenha sido selecionado, deve-se carregar o endereço do cliente porém, o usuário tem opção de usar outro endereço.
 
#Endereço: Define o endereço do evento, caso um cliente tenha sido selecionado, deve-se carregar o endereço do cliente porém, o usuário tem opção de usar outro endereço.
 
#Bairro: Define o bairro do endereço o evento, caso um cliente tenha sido selecionado, deve-se carregar o bairro do cliente.
 
#Bairro: Define o bairro do endereço o evento, caso um cliente tenha sido selecionado, deve-se carregar o bairro do cliente.
 
#Cidade: Define a cidade do endereço o evento, caso um cliente tenha sido selecionado, deve-se carregar a cidade do cliente.
 
#Cidade: Define a cidade do endereço o evento, caso um cliente tenha sido selecionado, deve-se carregar a cidade do cliente.
 
#Estado: Define o estado do endereço o evento, caso um cliente tenha sido selecionado, deve-se carregar o estado do cliente.
 
#Estado: Define o estado do endereço o evento, caso um cliente tenha sido selecionado, deve-se carregar o estado do cliente.
−
#Repetição: Informa os dias que o evento vai ocorrer, caso seja em determinados dia da semana, todos os dias, uma vez ao mês
 
−
#Participantes: Será possível adicionar ao eventos usuários participantes que estejam de alguma forma envolvidos com o evento. Estes usuários participantes poderão ser relacionados através do seu nome de usuário, e devem ter vínculo com o usuário que está criando o evento.
 
  
−
'''- Formatar a estrutura de repetição do evento:'''
+
[[Arquivo:Detalhes cadastro evento.png|700px]]
  
−
Um evento pode ser configurado para ter repetição diária, semanal ou mensal. A frequência do evento será estruturada e formatada usando a tabela FREQUENCIA_EVENTO.
+
A aba seguinte tem como objetivo definir os participantes do evento, e o usuário pode cadastrar as seguintes informações:
  
−
A tabela FREQUENCIA_EVENTO será associada a um evento através do campo CD_EVENTO, que definirá o evento que contempla a repetição cadastrada. Atrelado ao código do evento, estão os campos ID_REPETICAO, que define o padrão de repetição do evento (dia da semana, dia do mês, e mês do ano), e ID_TIPO_REPETICAO, que define o tipo de repetição de evento (diária, semanal ou mensal).
+
#Cliente: Define se o evento envolve algum cliente específico ou não.
 +
#Participantes: Será possível adicionar ao eventos usuários participantes que estejam de alguma forma envolvidos com o evento. Estes usuários participantes poderão ser relacionados através do seu nome de usuário, e devem ter vínculo com o usuário que está criando o evento.
 +
#Notificação: Envio de notificação ao e-mail do usuário criador do evento e de cada usuário participante convidado.  
  
−
O campo ID_REPETICAO poderá ser preenchido com os seguintes valores:
+
[[Arquivo:Convidados cadastro evento.png|700px]]
  
−
{| class="wikitable"
+
Por fim, na última aba, é possível definir a periodicidade do evento, através do campo abaixo:
−
!Valor
 
−
!Descrição
 
−
|-
 
−
| 0 || Eventos sem repetição
 
−
|-
 
−
| 1 a 7 || Definindo o dia da semana (Dom. a Sáb., respectivamente) em eventos de caráter semanal
 
−
|-
 
−
| 1 a 31 || Definindo o dia do mês em eventos de caráter mensal
 
−
|-
 
−
|}
 
  
−
O campo ID_TIPO_REPETICAO poderá ser preenchido com os seguintes valores:
+
#Repetição: Informa os dias que o evento vai ocorrer, caso seja em determinados dia da semana, todos os dias, uma vez ao mês
−
 
 
−
{| class="wikitable"
 
−
!Valor
 
−
!Descrição
 
−
|-
 
−
| D || Eventos com frequência diária
 
−
|-
 
−
| S || Eventos com frequência semanal
 
−
|-
 
−
| M || Eventos com frequência mensal
 
−
|-
 
−
|}
 
−
 
 
−
Por exemplo, um evento foi cadastrado, onde seu código é 1234, e o usuário deseja que esse evento se repita semanalmente, as terças e quintas. Neste caso, a tabela FREQUENCIA_EVENTO deverá ser preenchida da seguinte forma:
 
−
 
 
−
{| class="wikitable"
 
−
! colspan="5"  | FREQUENCIA_EVENTO
 
−
|-
 
−
! CD_EVENTO
 
−
! ID_REPETICAO
 
−
! ID_TIPO_REPETICAO 
 
−
|-
 
−
| 1234 || 3 || S
 
−
|-
 
−
| 1234 || 5 || S
 
−
|-
 
−
|}
 
−
 
 
−
Outro exemplo, um evento foi cadastrado, onde seu código é 2603, e o usuário deseja que esse evento se repita mensalmente, a cada dia 15 e dia 30 do mês. Neste caso, a tabela FREQUENCIA_EVENTO deverá ser preenchida da seguinte forma:
 
−
 
 
−
{| class="wikitable"
 
−
! colspan="5"  | FREQUENCIA_EVENTO
 
−
|-
 
−
! CD_EVENTO
 
−
! ID_REPETICAO
 
−
! ID_TIPO_REPETICAO 
 
−
|-
 
−
| 2603 || 15 || M
 
−
|-
 
−
| 2603 || 30 || M
 
−
|-
 
−
|}
 
−
 
 
−
'''- Formatar a estrutura de local do evento:'''
 
−
 
 
−
Os dados cadastrados acerca do local do evento deverão ser concatenados e salvos no campo DS_ENDERECO da tabela EVENTO.
 
−
 
 
−
Para concatenar o endereço, deverá ser utilizado o seguinte padrão:
 
−
 
 
−
"Endereço, Número - Bairro, Cidade - SIGLA DO ESTADO"
 
−
 
 
−
Por exemplo: Rua Senador João Delfino, 1234 - Meireles, Fortaleza - CE
 
  
−
'''- Formatar a estrutura de notificações do evento:'''
+
[[Arquivo:Opcoes cadastro evento.png|500px]]
  
−
Todos os participantes de um evento, inclusive o seu criador, deverão ser alertados acerca do evento através de um e-mail, que será enviado para o e-mail cadastrado daquele usuário, no campo EMAIL da tabela USUARIO, utilizando para acesso a base bd_ssm_login.
+
'''- Estrutura de repetição do evento:'''
  
−
'''- Formatar a estrutura de participantes do evento:'''
+
Um evento pode ser configurado para ter repetição diária, semanal ou mensal. Caso o usuário deseje criar um evento com repetição mensal é necessário definir os dias do mês que o evento deve se repetir. Caso o usuário selecione a opção semanal, é necessário definir os dias da semana em que o evento irá se repetir. No tipo de repetição diário, o evento ocorre, como o próprio nome diz, diariamente. Por fim, para o tipo de repetição única, o evento não se repete
  
−
A estrutura de participantes do evento será controlada utilizando a tabela PARTICIPANTE_EVENTO. Nesta tabela deverá ser associado o código do evento, salvo no campo CD_EVENTO ao código do usuário que foi convidado, salvo no campo CD_USUARIO_CONVIDADO.
+
A frequência do evento será estruturada e formatada usando a tabela FREQUENCIA_EVENTO.
  
−
Por exemplo, para o evento com código 1234, foram convidados como participantes os usuários com códigos 234 e 456. Neste caso, a tabela PARTICIPANTE_EVENTO deve ser preenchida da seguinte forma:
+
'''- Estrutura de localização do evento:'''
  
−
{| class="wikitable"
+
Para preencher um evento o usuário pode pesquisar através do campo 'Localização'. Por exemplo, ao pesquisar por 'Shopping Via sul', o endereço é preenchido automaticamente.
−
! colspan="5"  | PARTICIPANTE_EVENTO
 
−
|-
 
−
! CD_EVENTO
 
−
! CD_USUARIO_CONVIDADO
 
−
|-
 
−
| 1234 || 234
 
−
|-
 
−
| 1234 || 456
 
−
|-
 
−
|}
 
  
−
'''- Formatar a estrutura de ícones do evento:'''
+
Os dados cadastrados acerca do local do evento deverão ser salvos na tabela EVENTO.
  
−
=== Configurações ===
+
'''- Estrutura de notificações do evento:'''
  
−
#Este cadastro deve ser criado no módulo de Eventos.
+
Todos os participantes de um evento, inclusive o seu criador, poderão ser alertados acerca do evento através de um e-mail, que será enviado para o e-mail cadastrado daquele usuário, no campo EMAIL da tabela USUARIO. Para que isso ocorra, ao cadastrar o evento o usuário deve selecionar a opção 'notificação'.
  
−
=== Estrutura de banco ===
+
'''- Estrutura de participantes do evento:'''
  
−
{| class="wikitable"
+
É possível incluir os participantes do evento, selecionando, além de um cliente específico, um ou mais usuários do sistema.
−
! colspan="5"  | EVENTO
 
−
|-
 
−
! style="width:200px" |Coluna
 
−
! Tipo
 
−
! style="width:200px" |Obrigatório
 
−
! style="width:300px" |Chave Primária
 
−
! style="width:300px" |Explicação
 
−
|-
 
−
| CD_EVENTO || INT || SIM || NÃO || Código do evento
 
−
|-
 
−
| CD_TIPO_EVENTO || INT || SIM || NÃO || Código do tipo do evento
 
−
|-
 
−
| CD_USUARIO || INT || SIM || NÃO || Código do usuário criador do evento
 
−
|-
 
−
| DT_INICIO || DATETIME || SIM || NÃO || Data de início do evento
 
−
|-
 
−
| DT_FIM || DATETIME || NÃO || NÃO || Data de término do evento
 
−
|-
 
−
| HR_INICIO || VARCHAR(15) || NÃO || NÃO || Horário de início do evento
 
−
|-
 
−
| HR_FIM || VARCHAR(15) || NÃO || NÃO || Horário de término do evento
 
−
|-
 
−
| DS_TITULO || VARCHAR(50) || SIM || NÃO || Título do evento
 
−
|-
 
−
| DS_DESCRICAO || VARCHAR(1500) || NÃO || NÃO || Texto de descrição do evento
 
−
|-
 
−
| ID_NOTIFICACAO || CHAR(1) || NÃO || NÃO || Define se o evento vai enviar notificação
 
−
|-
 
−
| CD_CLIENTE || INT || NÃO || NÃO || Define se evento possui um cliente associado
 
−
|-
 
−
| DS_ENDERECO || VARCHAR(100) || NÃO || NÃO || Endereço do evento
 
−
|-
 
−
|}
 
  
 +
'''- Estrutura de participantes do evento:'''
  
−
{| class="wikitable"
+
Todos os eventos cadastrados pelo usuário podem ser visualizados na sua agenda de eventos, conforme imagem abaixo.  
−
! colspan="5"  | FREQUENCIA_EVENTO
 
−
|-
 
−
! style="width:200px" |Coluna
 
−
! Tipo
 
−
! style="width:200px" |Obrigatório
 
−
! style="width:300px" |Chave Primária
 
−
! style="width:300px" |Explicação
 
−
|-
 
−
| CD_EVENTO || INT || SIM || NÃO || Código do evento
 
−
|-
 
−
| ID_REPETICAO || INT || NÃO || NÃO || Define o padrão de repetição do evento
 
−
|-
 
−
| ID_TIPO_REPETICAO || VARCHAR(1) || NÃO || NÃO || Tipo da repetição do evento(semanal, diario, etc...)
 
−
|-
 
−
|}
 
−
 
 
−
 
 
−
{| class="wikitable"
 
−
! colspan="5"  | PARTICIPANTE_EVENTO
 
−
|-
 
−
! style="width:200px" |Coluna
 
−
! Tipo
 
−
! style="width:200px" |Obrigatório
 
−
! style="width:300px" |Chave Primária
 
−
! style="width:300px" |Explicação
 
−
|-
 
−
| CD_EVENTO || INT || SIM || NÃO || Código do evento
 
−
|-
 
−
| CD_USUARIO_CONVIDADO || INT || NÃO || NÃO || Código do usuário que foi convidado para o evento
 
−
|-
 
−
|}
 
  
−
{| class="wikitable"
+
[[Arquivo:Agenda evento.png|900px]]
−
! colspan="5"  | ENDERECO_EVENTO
 
−
|-
 
−
! style="width:200px" |Coluna
 
−
! Tipo
 
−
! style="width:200px" |Obrigatório
 
−
! style="width:300px" |Chave Primária
 
−
! style="width:300px" |Explicação
 
−
|-
 
−
| CD_EVENTO || INT || SIM || NÃO || Código do evento
 
−
|-
 
−
|}
 
−
CD_UF
 
−
CD_CIDADE
 
−
CD_BAIRRO
 
−
NR_CEP
 
−
DS_ENDERECO
 
−
NR_ENDERECO
 
  
 
== Regras de Negócios ==
 
== Regras de Negócios ==
  
−
'''[RN1] - '''
+
'''[RN1] - ''' Não deve ser possível criar dois eventos com o mesmo título (descrição), associado a um mesmo perfil de usuário. Porém, é possível criar dois eventos com mesmo título, associados a perfis de usuários diferentes (com regras diferentes por exemplo).
−
 
 
−
== Resultados Esperados ==
 
−
 
 
−
=== Protótipos ===
 
−
 
 
−
=== Fluxos Padrão ===
 
  
 +
'''[RN2] - ''' Uma vez criado, o tipo de evento não poderá ser excluído, porém, será possível desabilitá-lo a partir do campo 'ativo'.
  
 
== Aprovação ==
 
== Aprovação ==
Linha 258: Linha 105:
 
! style="width:200px" |Assinatura
 
! style="width:200px" |Assinatura
 
|-  
 
|-  
−
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000 ||  
+
| Desenvolvimento - GeoSales || Anderson Gomes || 28/03/2019 ||  
 
|-  
 
|-  
−
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000 ||
+
| Integração - GeoSales || || ||
 
|-
 
|-
−
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000 ||
+
| Configurações - GeoSales || || ||
 
|-
 
|-
 
|}
 
|}
Linha 274: Linha 121:
 
! style="width:200px" |Assinatura
 
! style="width:200px" |Assinatura
 
|-
 
|-
−
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
+
| Gerente TI - Cliente || || ||
 
|-  
 
|-  
−
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
+
| Gerente de Projeto - Cliente || || ||
 
|-  
 
|-  
−
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
+
| Gerente Comercial - Cliente || || ||
 
|-  
 
|-  
 
|}
 
|}

Edição atual tal como às 20h37min de 6 de maio de 2019

Histórico de Alterações

Data Quem Comentários
14/02/2019 Ryvane Maria Criação do documento

Necessidade

É necessário realizar o controle e a gestão das atividades e eventos a serem realizados.

Para que isso seja possível, inicialmente, o usuário deve cadastrar essas atividades no GeoSales, inserindo informações que são necessárias para o agendamento dos diversos tipos de eventos.

Solução

Será criado um cadastro de eventos, de forma que o usuário consiga inserir algumas informações que possam vir a realizar definições a respeito do evento a ser inserido.

Implementação

Desenvolvimento

- Criar campos no cadastro de eventos:

O cadastro de evento será dividido em algumas etapas.Inicialmente o usuário deve cadastrar um cabeçalho para o seu evento. Neste cabeçalho, deverão ser inseridas as seguintes informações:

  1. Título: Tem como finalidade identificar o evento de forma rápida.
  2. Cor da Tag: Poderá ser associada a um evento uma cor que ilustre a atividade a ser realizada.
  3. Data de início: Data de início do evento, caso seja um evento que ocorrerá em apenas um dia, este campo irá definir a sua data de realização.
  4. Hora de início: Hora de início do evento.
  5. Data de término: Data de término do evento, caso seja um evento que ocorrerá em apenas um dia, este campo não precisa ser preenchido.
  6. Hora de término: Hora de término do evento

Cabecalho cadastro evento.png

Cadastradas as informações de cabeçalho é necessário definir os detalhes do evento. Nesta aba, são inseridas informações de localização e tipo do evento, como pode-se visualizar abaixo:

  1. Tipo do evento: Os tipos de eventos irão depender dos tipos cadastrados pelo usuário de acordo com o documento Cadastro de tipo de eventos.
  2. Descrição: Permite ao usuário inserir uma descrição mais detalhada a respeito do evento. Com possibilidade de formatação de texto html, é possível editar e formatar a descrição do evento.
  3. Endereço: Define o endereço do evento, caso um cliente tenha sido selecionado, deve-se carregar o endereço do cliente porém, o usuário tem opção de usar outro endereço.
  4. Bairro: Define o bairro do endereço o evento, caso um cliente tenha sido selecionado, deve-se carregar o bairro do cliente.
  5. Cidade: Define a cidade do endereço o evento, caso um cliente tenha sido selecionado, deve-se carregar a cidade do cliente.
  6. Estado: Define o estado do endereço o evento, caso um cliente tenha sido selecionado, deve-se carregar o estado do cliente.

Detalhes cadastro evento.png

A aba seguinte tem como objetivo definir os participantes do evento, e o usuário pode cadastrar as seguintes informações:

  1. Cliente: Define se o evento envolve algum cliente específico ou não.
  2. Participantes: Será possível adicionar ao eventos usuários participantes que estejam de alguma forma envolvidos com o evento. Estes usuários participantes poderão ser relacionados através do seu nome de usuário, e devem ter vínculo com o usuário que está criando o evento.
  3. Notificação: Envio de notificação ao e-mail do usuário criador do evento e de cada usuário participante convidado.

Convidados cadastro evento.png

Por fim, na última aba, é possível definir a periodicidade do evento, através do campo abaixo:

  1. Repetição: Informa os dias que o evento vai ocorrer, caso seja em determinados dia da semana, todos os dias, uma vez ao mês

Opcoes cadastro evento.png

- Estrutura de repetição do evento:

Um evento pode ser configurado para ter repetição diária, semanal ou mensal. Caso o usuário deseje criar um evento com repetição mensal é necessário definir os dias do mês que o evento deve se repetir. Caso o usuário selecione a opção semanal, é necessário definir os dias da semana em que o evento irá se repetir. No tipo de repetição diário, o evento ocorre, como o próprio nome diz, diariamente. Por fim, para o tipo de repetição única, o evento não se repete

A frequência do evento será estruturada e formatada usando a tabela FREQUENCIA_EVENTO.

- Estrutura de localização do evento:

Para preencher um evento o usuário pode pesquisar através do campo 'Localização'. Por exemplo, ao pesquisar por 'Shopping Via sul', o endereço é preenchido automaticamente.

Os dados cadastrados acerca do local do evento deverão ser salvos na tabela EVENTO.

- Estrutura de notificações do evento:

Todos os participantes de um evento, inclusive o seu criador, poderão ser alertados acerca do evento através de um e-mail, que será enviado para o e-mail cadastrado daquele usuário, no campo EMAIL da tabela USUARIO. Para que isso ocorra, ao cadastrar o evento o usuário deve selecionar a opção 'notificação'.

- Estrutura de participantes do evento:

É possível incluir os participantes do evento, selecionando, além de um cliente específico, um ou mais usuários do sistema.

- Estrutura de participantes do evento:

Todos os eventos cadastrados pelo usuário podem ser visualizados na sua agenda de eventos, conforme imagem abaixo.

Agenda evento.png

Regras de Negócios

[RN1] - Não deve ser possível criar dois eventos com o mesmo título (descrição), associado a um mesmo perfil de usuário. Porém, é possível criar dois eventos com mesmo título, associados a perfis de usuários diferentes (com regras diferentes por exemplo).

[RN2] - Uma vez criado, o tipo de evento não poderá ser excluído, porém, será possível desabilitá-lo a partir do campo 'ativo'.

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

GeoSales

Setor Aprovado Por Data Assinatura
Desenvolvimento - GeoSales Anderson Gomes 28/03/2019
Integração - GeoSales
Configurações - GeoSales

Empresa solicitante

Setor Aprovado Por Data Assinatura
Gerente TI - Cliente
Gerente de Projeto - Cliente
Gerente Comercial - Cliente
Disponível em “http://wiki.geosales.com.br:8000/index.php?title=Agendamento_de_eventos&oldid=11849”