---
# System prepended metadata

title: Melhorias no gestão de consumo

---

### Melhorias no gestão de consumo - usage-backend

##### Criacao de uma nova base de dados para o usage

[1][infraenviroment] - Criar novas env vars no projeto infra-meuvivoempresas-environments (infra-meuvivoempresas-environments) para contemplar uma nova base de dados para o usage.

Observação: criar as estruturas dentro de applications.backend.usage-backend

Exemplo:

    usabe-backend:
      mongodb:
        database: "usage"
        user: "usage"
        password: "wahqJ8YP8oVjDtqvZHOG"
[reference link] https://wikicorp.telefonica.com.br/pages/viewpage.action?pageId=419329814

Replicar a estrtura para Dev, pre, dark e production

Tempo: 2h

[2][cd][usage][backend] - Criar novas vars no projeto do cd conforme estrutura criada no projeto do infra. os valores default das variaveis deversão ser iguais ao dev no infra

Obs. Não esquecer de criar as variaveis de ambiente no arquivo usage-backend-replicaset.yaml

Tempo: 2h

[3][usage][backend] - Criar variaveis de ambiente nos profile aplication (dev, test e production)

Exemplo:

application-dev.properties: 
mongo.database.name=${MONGODB_USAGE_DATABASE:db-usage}
quarkus.mongodb.usage-database.connection-string=${MONGODB_USAGE_URL:definir}

application-test.properties: 
mongo.database.name=${MONGODB_USAGE_DATABASE:db-usage}
quarkus.mongodb.usage-database.connection-string=${MONGODB_USAGE_URL:definir}

application.properties: 
mongo.database.name=${MONGODB_USAGE_DATABASE}
quarkus.mongodb.usage-database.connection-string=${MONGODB_USAGE_URL}

Tempo: 1h

[4][usage][backend] - criar as estruturas no usage-backend para representar os objetos que consumirão as filas do rabbitMQ
    - Criar o repository
    - Realizar testes unitários
    - Realizar o testes de mutação

Tempo: 4h

[5][kt] - elaboração do documento técnico

Tempo: 2h

[6][teste] - realizar testes exploratórios
    - verificar se o banco será criado juntamente com a collection;
    - testar se após a inclusão de registros o mongo consegue realizar a exclusão automática após um periodo;
    
Tempo: 3h
    
[7][qa] - liberar para o ambiente de pre

Tempo: 1h



=======================================================================


### Criacao de Consumers e Producers no RabbitMQ - PARTE II

[0] A&D
- refinamento técnico, quebra de tarefas e discussões a respeito

[1][usage][backend] - Implementação de Producer da fila de Lines

        1. Criar classe Producer que herda da classe RabbitMQProducer e que implementa método publish através de um contrato de interface
        2. Criar variáveis no application.properties referente a configuração necessária no Producer
        3. Criar método publish recebendo objeto de Response contendo a linha e informações necessárias e o transformando em String utilizando jackson e publicando na devida exchange
        
Tempo: 3h
        
Obs: Realizar os testes unitários e verificar os mutantes

        Variáveis de ambiente a serem criadas no application.properties, application-dev.properties, application-test.properties:

#CONFIGS PARA LINES PRODUCER
rabbitmq.usage-lines-exchange-publish=br.com.vivo.usage.topic
rabbitmq.usage-lines-routing-key-publish=usage.lines.queue

[2][usage][backend] Implementação de Producer da fila de response do WSS:

        1. Criar classe Producer que herda da classe RabbitMQProducer e que implementa método publish através de um contrato de interface
        2. Criar variáveis no application.properties referente a configuração necessária no Producer
        3. Criar método publish recebendo objeto de Response do WSS e o transformando em String utilizando jackson e publicando na devida exchange
        
Obs: Realizar os testes unitários e verificar os mutantes

Tempo: 3h

#CONFIGS PARA WSS IMPORT LINES CONSUMPTION PRODUCER
rabbitmq.usage-import-lines-consumption-response-exchange=br.com.vivo.usage.group.start.import.lines.consumption.topic

[3][usage][backend][dependência 1 e 2] - Implementação de Consumer da fila de request do WSS:

        1. Criar classe Consumer que herda da classe RabbitMQConsumer e implementa uma interface que herda da interface Consumer e que escutará as mensagens publicadas na fila de request do WSS
        2. Adicionar variável no application.properties com a exchange e a queue criada pelo WSS seguindo com o prefixo rabbitmq e utilizando o padrão kebab case
        3. Incluir atributos na classe UsageConsumerProperties que representem as variáveis adicionadas no application.properties, utilizando a mesma nomenclatura após o prefixo rabbitmq, no entanto utilizando o padrão camel case.
        4. Os novos atributos da classe UsageConsumerProperties devem ser utilizadas para abrir a conexão com a fila de request do WSS na classe consumer criada, através do método start.
        5. Criar Command que deve receber o payload da mensagem da fila, fazer uma requisição ao NGIN para obter todas as linhas de um grupo
        6. A lista de linhas deve ser iterada, sendo enriquecida com informações necessárias e sendo publicada em uma fila de linhas através de um Producer que será criado paralelamente (tarefa 1)
        7. Após isso o Command deverá retornar informações necessárias ao Polling
        8. De posse das informações do Polling, o Consumer deve publicar essas informações através de um Producer que será criado paralelamente (tarefa 2)
        9. Injeção do Consumer na classe AppLifecycleBean e inclusão nos métodos onStart e onStop
        
Obs: Realizar os testes unitários e verificar os mutantes
        
#CONFIGS PARA WSS IMPORT LINES CONSUMPTION CONSUMER
rabbitmq.usage-import-lines-consumption-request-exchange=br.com.vivo.usage.group.start.import.lines.consumption.direct
rabbitmq.usage-import-lines-consumption-request-queue=br.com.vivo.usage.group.start.import.lines.consumption.queue.request
        
Tempo: 5h

[4][usage][backend] Implementação de Consumer da fila de Lines:

        1. Criar classe Consumer que herda da classe RabbitMQConsumer e implementa uma interface que herda da interface Consumer e que escutará as mensagens publicadas na fila de Lines
        2. Criar Command para buscar o consumo da linha recebida através da mensagem, além de outras informações como se há algum Evento, status desse Evento, IdMessage desse evento
        3. Salvar objeto na collection usage_group_import_status do MongoDB
        4. Caso haja algum erro, o objeto deve ser salvo sem o consumo e com o atributo error como true
        5. Injeção do Consumer na classe AppLifecycleBean e inclusão nos métodos onStart e onStop
        
Obs: Realizar os testes unitários e verificar os mutantes
        
#CONFIGS PARA LINES CONSUMER
rabbitmq.usage-lines-exchange=br.com.vivo.usage.topic
rabbitmq.usage-lines-queue=br.com.vivo.usage.lines.queue
rabbitmq.usage-lines-routing-key=usage.lines.queue

Tempo: 3h
        
[5][usage][backend] Implementação do endpoint de Polling:

        1. Criar nova assinatura de endpoint no UsageWebResource, para receber os parâmetros e devolver a resposta da requisição
        2. Deve receber os seguintes parâmetros Integer networkNumbersSize, String correlationId, String groupId, String accountId
        3. Implementar query no repository que traga registros baseado no correlationId, groupId e accountId 
        4. Criar Command para realizar a lógica do polling, que consiste em verificar se a quantidade de registros da query realizada na collection é a mesma que o número total de linhas
        5. Caso seja a mesma quantidade, a lista deve ser retornada e um atributo hasCompleted deve ser retornado como true
        6. Caso contrário, a lista deve ser retornada vazia e o hasCompleted deve ser retornado como false
        7. Caso haja algum erro um atributo hasError deve ser retornado como true
        
Obs: Realizar os testes unitários e verificar os mutantes

Tempo: 4h
        
[6][testes][exploratorios] - Realizar testes exploratórios
    - Realizar testes exploratórios utilizando filas do rabbitMQ
    - coletar evidencias que o mongo está persitindo as informações
    - validar se o mongo está removendo os registros
    - validar se o total de documentos está de acordo com o total de linhas do grupo
    - armazenar evidencias em documento e anexar a tarefa do jira
    
Tempo: 
[7][testes][backend][componentes] - elaborar testes de componente dos producers e consumers

Tempo: 8h

[8][testes][backend][componentes] - elaborar testes de componente do endpoint de polling

Tempo: 5h

[9][kt] - Elaborar o kt da história

Tempo: 2h


[10][qa] - liberar para qa

Tempo: 0,5h

