> For the complete documentation index, see [llms.txt](https://docs.vrsoft.com.br/vrmaster/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vrsoft.com.br/vrmaster/manual-do-sistema/manual-do-sistema-vr-smart-store-instalacao-e-configuracao.md).

# Manual Do Sistema Vr Smart Store Instalacao E Configuracao

## **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](https://storage.googleapis.com/docker-compose-yml/docker-compose-smartapi.yml).

* 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](https://teste-gen-qrcode.vercel.app/dashboard).

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**](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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.vrsoft.com.br/vrmaster/manual-do-sistema/manual-do-sistema-vr-smart-store-instalacao-e-configuracao.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.