Skip to content

willypelz/customer-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Build Status Total Downloads Latest Stable Version License

Customer

Customer API(Laravel)

Laravel was used to develop the application because it is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:

Laravel is accessible, powerful, and provides tools required for large, robust applications.

Project Setup

In order to setup the application locally on you system.

  1. clone the repository
  2. git clone https://github.com/willypelz/customer-app.git
  3. cd into the project directory
  4. cd customer-app/test-backend
  5. install the dependencies for the application
  6. composer install
  7. create a .env file from the .env.example
  8. cp .env.example .env
  9. Generate an application key
  10. php artisan key:generate
  11. create a database called test_app in your database
  12. update the env files with your mysql connection details that you have on your system
DB_CONNECTION=mysql  
DB_HOST=YOUR_HOST  
DB_PORT=MYSQL_PORT  
DB_DATABASE=test_app  
DB_USERNAME=MYSQL_USER_NAME  
DB_PASSWORD=MYSQL_PASSWORD
  1. Running migration data into the database
  2. php artisan migrate
  3. Running customer import command
  4. php artisan command:import:customers
  5. serving the project
  6. php artisan serve

Testing the Application

Application Testing is defined as a software testing type, conducted through scripts with the motive of finding errors in software. It deals with tests for the entire application. It helps to enhance the quality of your applications while reducing costs, maximizing ROI, and saving development time.

In order to run the feature test that was written php ./vendor/bin/phpunit

Important

Ensure you setup xdebug on your system. Xdebug Setup for local machine (xampp)

Testing the Application (user testing)

http://localhost:8000/api/v1/customers
http://localhost:8000/api/v1/customers?page={pageNumber}
http://localhost:8000/api/v1/customers/{id}"

Customer FrontEnd.

An application that consumes an API Client to manage customers

  1. State Management: Vuex
  2. Test-driven development(TDD): mocha(not fully completed)
  3. Request validation: Joi
  4. project dockerized (not fully completed);

Getting started

System customers

Installation

Clone the repository

git clone https://github.com/willypelz/customer-app.git

Switch to the repo folder

cd customer-app/www/test-frontend

Install dependencies

npm install

Running the Application

npm run serve

Connection

For testing Ensure the backend is running on port 8081 http://localhost:8081 if it is running on different port you might need to update the env.js details the port the backend is running on.


Screenshots of the project

this can be found in the static folder.


setup using docker

requirements

docker

docker-compose up --build

Developer(Softwaredef)

  1. Name: Asefon Michael Pelumi
  2. Nickname: Softwaredef
  3. Mail: pelumiasefon@gmail.com

Thanks. If you have any problem setting it up or complain you can kindly post them on issues or message me directly