Manual do Sistema VR Smart Store - Instalacao e Configuracao

De VRWiki

Introdução

O aplicativo VR Smart Store está disponível para Android e IOs.

A comunicação do aplicativo com o banco de dados é realizada pelo VRSmartAPI, que é o servidor que deverá ser configurado na base do cliente, e rodará em um container Docker.

Passo 1: Download do YAML do Docker Compose e configuração

O primeiro passo para configuração é o download do arquivo YAML para subir o container através do docker-compose. Você pode baixá-lo clicando aqui.

  • As informações abaixo precisam ser editadas no arquivo docker-compose-smartapi.yml baixado anteriormente, na sessão environments do arquivo (Substitua os dados, pelas informações da base do cliente, como IP e etc):
  POSTGRES_TYPE='postgres' 
  POSTGRES_HOST='192.168.1.127'
  POSTGRES_USER='postgres'
  POSTGRES_PASSWORD='postgres'
  POSTGRES_DATABASE='vr'
  POSTGRES_PORT='5432'
  QUEUE_LOGIN='vr'
  QUEUE_PASSWORD='vr!RbtMQ'
  QUEUE_DOCKER='192.168.1.127'
  QUEUE_PORT='5672'
  • POSTGRES_TYPE -> Qual tipo de banco utilizado, sempre sera Postgres
  • POSTGRES_HOST -> IP do banco de dados do cliente
  • POSTGRES_USER -> Usuario do banco de dados do cliente
  • POSTGRES_PASSWORD -> Senha do banco de dados do cliente
  • POSTGRES_DATABASE -> Nome da banco de dados do cliente
  • POSTGRES_PORT -> Porta do banco de dados do cliente
  • QUEUE_LOGIN -> Login do RabbitMQ, por padrão será sempre vr
  • QUEUE_PASSWORD -> Senha do RabbitMQ, por padrão será sempre vr!RbtMQ
  • QUEUE_DOCKER -> IP da maquina onde o VRRabbitMQ está rodando, geralmente a mesma do Service Manager
  • QUEUE_PORT -> Porta do RabbitMQ, por padrão será sempre 5672

Passo 2: Subir o Serviço

Após realizar o download do arquivo e configuração das informações do ambiente conforme o passo anterior, basta subir o serviço da API

O primeiro passo é realizar o login no docker com o comando docker login e informar as credenciais do usuário VR com a permissão para usar a imagem, pois a imagem da VRSmartAPI é de uso privado.

Após realizar o login, basta executar o comando abaixo para subir o serviço:

OBS: EXCUTE O COMANDO DENTRO DA PASTA ONDE O ARQUIVO docker-compose-smartapi.yml ESTÁ

  docker-compose -f docker-compose-smartapi.yml up -d

Explicação: O comando docker-compose serve para subir o container configurado no arquivo docker-compose-smartapi.yml. A flag -f serve para indicar qual arquivo deseja subir, e a opção up -d serve para indicar que queremos subir o container em modo detach, ou seja, rodando em background sem prender o terminal.


Após estes passos, o serviço estará rodando na porta 3000 do computador onde o container foi iniciado.

Passo 3: Gerar QR Code

Para gerar o QR Code, basta acessar este site.

No site, basta preencher o ID da loja em que foi configurado o VR PDV Smart, o nome fantasia que é só um nome que irá identificar a loja no aplicativo, e IP do servidor no seguinte formato https://192.168.0.27:3000 substituindo o IP pelo IP do servidor do cliente, preferencialmente um IP Externo com acesso a porta 3000 para que os aplicativos consigam fazer a comunicação com o servidor de fora da rede da loja.

Após isso, basta clicar no botão gerar QrCode e o mesmo será gerado.

Agora, sempre que baixar um aplicativo VR Smart Store e configurá-lo lendo este QR Code, ele será configurado com os dados do servidor deste cliente e poderá observar os dados de estoque da loja onde o VR PDV Smart foi configurado.