-
Antes de começar, certifique-se de ter o git instalado.
-
Acesse o link:
-
Clique em
Clone
-
Copie a
URL HTTPS
-
No terminal vá até o diretório onde desejar baixar o projeto e execute o comando:
git init
-
Em seguida o comando sem os parênteses:
git clone (url copiada)
-
Será solicitada uma senha de acesso, volte ao azure e clique em
Generate Credentialas
e use a senha gerada.
-
Antes de começar, certifique-se de ter o Node.js instalado.
-
Para instalar o projeto, no terminal, certifique-se de ter o yarn instalado, e então vá até o diretório do projeto e execute o comando para instalar as dependências do projeto:
yarn install
-
Para iniciar o projeto basta executar o comando:
yarn start
-
Acesse o projeto pelo navegador através do link:
-
Ainda não será possível acessar o sistema pois ainda faltam as Configurações da Api-Endpoint e do Banco de Dados na próxima etapa.
-
O banco de dados utilizado no projeto é o PostgreSQL. Caso ainda não o tenha instalado, você pode encontrar aqui o download de acordo com seu sistema operacional. A versão exigida para este projeto é a
psql ^9.6.16
ou superior. -
Após a instalação, será necessário realizar algumas configurações no terminal, se você estiver operando através do Windows, é recomendável utilizar o PowerShell, mas antes disso recomendamos reiniciar seu terminal para certificar-se de que as variáveis ambiente serão reconhecidas. Para certificar-se que a instalação ocorreu com sucesso execute o comando:
psql --version
-
Em seguida, execute o comando:
- No Windows:
psql -U postgres
- No Linux:
sudo -u postgres psql postgres
- no MacOS:
psql postgres
Ao executar o comando, seu terminal deve estar da seguinte forma:
psql (9.6.16) Type "help" for help. postgres=#
-
Note que agora você está no terminal
psql
conectado com o super usuáriopostgres
, mas que ainda não tem uma senha de acesso, para defini-la, use o comando:\password postgres
Ao executar o comando será solicitada uma senha
Enter new password:
, então basta digitá-la e pressionar enter, em seguida confirme a senhaEnter it again:
. Caso deseje sair do terminalpsql
basta usar o comando:\q
-
A instalação do banco de dados continua na próxima etapa utilizando o Sequelize.
-
Vá até o diretório ./api localizado da raiz do projeto e execute novamente o comando para instalar as dependências do projeto:
yarn install
-
As configurações do banco de dados estão no diretório ./src/config/database.js. Neste arquivo, observe os valores
proccess.env.DB_???
. Isso significa que são variáveis ambiente orquestradas peloDotenv
. Verifique se os parâmetros de configuração são compatíveis com o seu ambiente de desenvolvimento, na raiz do projeto, o arquivo.env.exemple
contém os valores das variáveis utilizadas na configuração do banco de dados, substitua os valores necessários, salve o arquivo e faça uma cópia do arquivo com o nome.env
. Se tudo estiver pronto, crie o banco de dados usando o comando:yarn sequelize db:create
-
Todas as tabelas do banco de dados já estão configuradas no diretório ./src/database/migrations, mas ainda não foram criadas no banco de dados que você acabou de instalar. Para criar as tabelas, use o comando:
yarn sequelize db:migrate
-
Agora, basta iniciar o projeto:
yarn dev:server
-
Você pode acessá-lo através do link
localhost:3333 A seguinte mensagem deve ser exibida no navegador:
Cannot GET /
-
Agora o projeto está totalmente configurado e pronto para o desenvolvimento. Lembre-se sempre de iniciar os dois servidores pelo terminal em seus respectivos diretórios. No diretório raiz:
yarn start
e em ./apiyarn dev:server
.
- Agora você já deve ser capaz de acessar o sistema em: