Guilherme Anderson-PJI2-2020-1

Responsaveis

• Anderson Gaspar, e-mail: andersongasparm@gmail.com
• Guilherme Lopes Roque, email: guilherme.lroque@gmail.com

Levantamento de Requisitos

Funcionais:

• RF.01 O sistema deve possuir uma estação Raspberry que servirá como gerenciador de sensores.
• RF.02 O sistema deve permitir a instalação e remoção física de sensores da estação;
• RF.03 O sistema deve possuir uma API Rest para servir de interface do usuário com o sistema;
• RF.04 O sistema deve possuir um servidor de fila de mensagens para as notificações.
• RF.05 O sistema deve permitir a configuração valores limites de leitura dos sensores para gatilho das notificações da estação.
• RF.06 O sistema deve permitir a configuração do tempo do ciclo de leitura dos sensores;
• RF.06 O sistema suportar inicialmente os seguintes sensores:

1. DHT11

Não funcionais:

• RNF.01 - O usuário deve estar conectado à Internet para receber as notificações geradas pelo sistema
• RNF.02 - O software desenvolvido para a estação Raspberry deve ser modular, prevendo futuras melhorias incrementais, como a compatibilidade com outros sensores;

Casos de uso

Definições

• Administrador: Ator primário representado por uma pessoa física no ambiente local do sistema de estação meteorológica.
• Usuário: Ator primário representado por uma pessoa física em ambiente externo do sistema de estação meteorológica.
• Sensor: Ator secundário que apenas executa rotinas solicitadas inicialmente pelos atores primários.
• Sistema: Representado pela estação meteorológica, este atende as requisições dos usuários primários (atua como sistema na linguagem UML) e exclusivamente no caso de uso Notificação atua como ator primário, sendo o iniciador da interação entre os sujeitos.
• Broker: Ator secundário que apenas realiza interface do Usuário com o Sistema.

Caso de uso: Registrar sensor

Ator primário: Administrador.

Ator secundário: Sensor.

Sistema: Estação Meteorológica

Fluxo principal:

• O Administrador faz a instalação física do sensor na placa da Raspberry Pi.
• O Administrador envia uma requisição HTTP contendo os dados do sensor a ser registrado para a Estação Metereológica;
• O sistema configura e ativa o sensor e responde ao Administrador uma mensagem HTTP de sucesso;

Caso de uso: Remover sensor

Ator primário: Administrador

Ator secundário: Sensor.

Sistema: Estação Meteorológica

Fluxo principal:

• O Administrador envia uma requisição HTTP contendo o identificador do sensor a ser removido.
• O sistema remove o sensor de seus registros e rotinas e responde o Administrador uma mensagem HTTP de sucesso.
• O Administrador faz desconexão física do sensor na placa da Raspberry Pi

Caso de uso: Alterar registro

Ator primário: Usuário

Atores secundários: Broker e Sensor.

Sistema: Estação Meteorológica

Fluxo principal:

• O usuário envia uma requisição HTTP contendo os dados do sensor a ser atualizado para o Broker;
• O Broker executa suas rotinas internas de enfileiramento e roteamento e repassa a requisição para o sistema.
• O sistema configura o sensor e responde o usuário uma mensagem HTTP de sucesso através do Broker;

Caso de uso: Requisitar dados

Ator primário: Usuário

Atores secundários: Broker e Sensor.

Sistema: Estação Meteorológica

Fluxo principal:

• O usuário envia uma requisição HTTP contendo os dados do sensor a ser lido para o Broker;
• O Broker executa suas rotinas internas de enfileiramento e roteamento e repassa a requisição para o sistema.
• O sistema lê o sensor e responde o usuário uma mensagem HTTP de sucesso através do Broker;

Caso de uso: Notificação

Ator primário: Estação Meteorológica

Atores secundários: Broker, Sensor e Usuário.

Fluxo principal:

• O sistema identifica um valor fora dos limites configurados para o sensor através de sua rotina interna de leitura.
• O sistema envia para o Broker a notificação que deve ser repassada para todos os usuários (broadcast)
  
• O Broker executa suas rotinas internas de enfileiramento e roteamento e repassa a notificação para todos os usuários.

Diagrama de casos de uso

Diagrama de classes

Modelagem de interações

Notificação

Sequência:

• O usuário se inscreve no Broker para receber notificações através do comando 'amqp-listen' representado pelo método 'listen()' no diagrama acima.
• A aplicação que implementa o comando 'amqp-listen' cria uma instancia da classe AMQPListen que realiza alguns procedimentos com o Broker, estes representados pela macro 'subscribe', e fica à espera de notificações.
• A estação meteorológica implementada pela classe 'Station' realiza uma leitura do sensor que está fora dos limites máximo e mínimo configurados e então publica a notificação no Broker, através do método 'basic_publish()' da classe BlockingConnection.
• O Broker disponibiliza (macro 'queue') a publicação da estação meteorológica para todos usuários que se inscreveram.
• A classe AMQPListen consome (macro 'consume') a publicação disponibilizada pelo Broker e notifica o Usuário através da impressão da mensagem no termina de execução da aplicação.

Leitura|Configuração externa

Leitura|Configuração Local