e_wallet

A project made with laravel and react js to create a Electronic Wallet System

What does it implement ?

It' ann implementation of electroinc wallet for multi currency transfer

Stack

Laravel , ReactJs , Tailwind

PHP Version

Built and tested in php 7.4

How to run

• Just run it like a laravel project by hitting url, not with serve
• ReactJs was integrated using laravel mixin, so you will not be able to run the frontend using serve
• Import the e_wallet.sql file (If you do not want to run migration and want to start with existing dummy data)

How to create an admin ?

• You have to create the admin manually
• Make sure the role of the admin in users table is "admin", also make sure the email_verified_at is a proper timestamp and is not null
• You can use this route : /demo/create-admin/{email}/{password}/{signal} from web.php

How to create a user ? / How can a user sign up ?

• Api for user registration is implemented
• However in front end there is not option to sign up at this moment
• You should use the given postman collection to sign up a new user

How can we add a currency ?

• Add a new currency with valid currency code in the currency table
• Make sure the active column has value '1'
• Currency codes needs to be valid in order to get conversion rate correct
• php artisan db:seed --class=CurrencySeeder //this seeder can be used in a fresh migration

Currency converion public api's

These api's below can be used to get a real time conversion rate

• https://openexchangerates.org
• https://currencylayer.com
• http://fixer.io

We are using Open Exchange Rate, so make sure you put the appId for openexchangerate in the .env file

Does this need cronjob ?

• Yes , the exchage_rates table must have valid data, at least run this once so before registering users
• cronjob url [projectroot]/api/cronjob/update-exchange-rates , run this every hour to get the latest rates

.env file configuration

• Please make sure APP_URL has a valid value it should be something like [yourdomain/if_subfolder] with no trailing slash
• The api path is determined by APP_URL, if it is incorrect, your frontend will not be able to connect with your backend
• More .env settings will be found in this section: Does this allow subfolder ?

Does this allow subfolder ?

Yes, it does run on a subfolder in .env file if there is no subfolder , make sure the variables are like this

BASENAME="/"
MIX_ASSET_URL="/public"

if you have subfolder the variables should be like:

BASENAME="/[path/to/subfolder]"
MIX_ASSET_URL="/[path/to/subfolder]/public"

Postman collection link

https://www.getpostman.com/collections/2b510d4c291a25bf3831