Cube Summation

Development exercise inspired by https://www.hackerrank.com/challenges/cube-summation using Laravel 5.2

The list of changes between the base Laravel installation and the final product can ve viewed by clicking here

##Usage

This project is currently deployed in a Heroku instance.

To use the text input processing implementation, click here and submit a valid input for the problem described in the Hackerrank challenge. If the input is incorrectly formatted or the instructions are invalid, you'll see an error message.

To use the database implementation, click here. You can use the UI to create a new Matrix, update cell values and query the matrix. Invalid instructions will show an error message.

List of files and explanation of changes

###Business Logic Layer

####app/Classes/DataMatrix.php

This business logic class handles the creation of a new DataMatrix structure (for the text input processing implementation), along with cell value updates and queries. This structure is used for the regular input processing that can be viewed clicking here

####app/Classes/InstructionHandler.php

This business logic class handles the decoding and processing of the instruction input (for the text input processing implementation), along with cell value updates and queries. This structure is used for the regular input processing that can be viewed clicking here

####app/Exceptions/InstructionParseException.php

This exception is used when the instructions from the text input cannot be parsed correctly.

####app/Exceptions/InvalidInstructionException.php

This exception is used when one of the instructions from the input is parsed correctly, but the instruction intself is invalid (out of range, for example)

####app/Http/routes.php

This file defines the URL routing and methods for the application.

###Web Layer (Controller in MVC)

####app/Http/Controllers/CubeSummationController.php

This controller handles the display and instruction processing for the text input processing implementation.

####app/Http/Controllers/CubeSummationDBController.php

This controller handles the display and instruction processing for the database implementation. In it's current implementation, only one instance of a matrix can exist (Meaning, each time a new matrix is created, the old one gets deleted). This is in order to overcome a 10k row limit Heroku has for free environments.

###Persistence Layer (Model in MVC)

####app/Models/Cell.php

Model for the 'cells' table (storing position and value of each cell)

####app/Models/Matrix.php

Model for the 'matrices' table (storing the size of the matrix). This model is related to the Cell entity via a one-to-many association (meaning each cell belongs to one matrix, and a matrix can have N³ cells)