LaraCurrency

Development of an application to display currencies exchange rates

Instructions 🔗

Instructions for developing the application can be found in the icon above.

Installation ⚙️

✔️ Requirements

    return [
        {
            dependency: "PHP",
            url: "https://www.php.net",
            version: 7.4.21,
            img: "https://cdn.iconscout.com/icon/free/png-256/php-3629567-3032350.png"
        },
        {
            dependency: "Node",
            url: "https://nodejs.org",
            version: 16.4.1,
            img: "https://cdn.iconscout.com/icon/free/png-256/node-js-1-1174935.png"
        },
        {
            dependency: "MySQL",
            url: "https://www.mysql.com",
            version: 8.0.25,
            img: "https://cdn.iconscout.com/icon/free/png-256/mysql-3628940-3030165.png"
        },
        {
            dependency: "Vue",
            url: "https://vuejs.org",
            version: 2,
            img: "https://cdn.iconscout.com/icon/free/png-256/vue-282497.png"
        },
        {
            dependency: "Git",
            url: "https://git-scm.com",
            version:  2.32.0,
            img: "https://cdn.iconscout.com/icon/free/png-256/git-16-1175195.png"
        },
        {
            dependency: "Composer",
            url: "https://getcomposer.org",
            version: 2.1.3,
            img: "https://cdn.iconscout.com/icon/free/png-256/composer-285363.png"
        }
    ];

Backend 🛰

    composer create-project laravel/laravel backend

Storage

    CREATE DATABASE custom_webquarto_laravel_currency_application;

Next, add the following database configuration information

    DB_CONNECTION=mysql
    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=<database-name>
    DB_USERNAME=<database-username>
    DB_PASSWORD=<database-password>

JWT Guide Link🔐

Guide link to implement JSON Web Token (JWT) authentication

Controllers

    php artisan make:controller AwesomeAPIController

Seeders

    php artisan make:seeder UserSeeder

Tests

    php artisan make:test JWTAuthTest

Edit backend\phpunit.xml, setting DB_CONNECTION and DB_DATABASE values

Frontend

    vue init webpack-simple frontend

    npm	install	axios --save

    npm install vue-router --save

Launch 🚀

    git clone https://github.com/Weavous/LaraVueCurrency

    cd LaraVueCurrency

Set up Backend Application 🚀

    cd backend

    cp .env.example .env

You must specify the environment configuration in .env file

    composer i

    php artisan key:generate

    php artisan migrate:fresh --seed

    php artisan serve

Set up Frontend Application 🚀

    cd frontend

    npm i

    npm run dev

Example User

    return {
        email: "[email protected]",
        password: "secret"
    }

4 folder structures to organize your React & React Native project 💾

⚠️ Atenção - Possívels Erros

• A porta esperada para enviar as requisições é 8000, se outra for estabelecida, alterar o conteúdo de baseURL em frontend\src\services\http.js.

• Caso ocorra algum erro na instalação das dependências do Laravel através do Composer, deve-se habilitar as extensões presentes no arquivo de configuração php.ini.

• O local do arquivo de configuração php.ini pode ser visualizado digitando-se php --ini no terminal.

• Caso ocorra um erro relacionado ao certificado SSL ao efetuar as requisições para o serviço externo, retornando uma mensagem de erro semelhante à essa cURL error 60: SSL certificate problem: unable to get local issuer certificate, pode-se resolver através da resposta presente em https://stackoverflow.com/questions/24611640/curl-60-ssl-certificate-problem-unable-to-get-local-issuer-certificate

Dúvidas ❔

• Quaisquer dúvidas ou sugestões quanto ao projeto, entrar em contato com [email protected].