Roman numerals converter

The purpose of this application was to create a simple project based on Laravel framework (PHP). This project is using all the basic and well known features of Laravel framework as well as MVC principles including:

• Developed using Homestead in Vagrant
• Blade template engine
• The Laravel Collective component library
• Eloquent ORM
• Laravel Validator. Used both as built-in in Controllers and as standalone in custom Class
• All custom code contains comments
• Usage of Controllers
• Usage of Routes
• Usage of Interfaces
• Includes PHPUnit tests. Placed in tests/ConverterTest.php and run by typing vendor/bin/phpunit
• Project structure was made using Laravel installer

Frontend

The theme is built using gulp, elixir ans scss. It's designed with simplicity in mind. Blade templates are split into multiple files.

Use Case

• When submitted the form should display both the integer and roman numeral values
• Support numbers between 0 and 3999, only numeric characters
• Display history of converted numbers along with creation time

Installation

• Recommended development environment is Homestead
• .env file is required. You can copy .env.example (the one used by me)
• npm install for required dependencies
• php artisan migrate to create the database

Important custom files

• app/Http/routes.php
• app/Http/Controllers
• app/Http/Libraries
• app/History.php
• config/app.php (Include Laravel Collective library Classes)
• resources/assets (Sass, JS)
• resources/views (Blade templates)
• tests/ConverterTest.php