Rails Engine

Rails Engine is a Rails application that works within a service-oriented architecture to expose data through an API that the front-end team can consume.
Additional Functionality:

📖 Table of Contents

Table of Contents

Installation instructions found in ➤ Getting Started

Contains several controllers responsible for rendering JSON responses and status codes.

Note: Only Items, Merchants, Invoices, Invoice Items, and Customers were utilized for this project.

1. Create a new directory on your computer where you'd like the program to live.

$ mkdir /your_folder/rails-engine

2. Navigate into the recently created directory.

$ cd /your_folder/rails-engine

3. Copy the repository by clicking on the code button on Github repo page (using SSH).

4. Clone the recently copied repository information into your currenty directory.

$ git clone git@github.com:JohnSantosuosso/rails-engine.git

5. Open the repository in your preferred IDE. If you are using VSCode, use the code command shown below:

$ code .

6. Download Tests for Postman.

Click on each link below to load a test collection in your browser, then hit Cmd-S to save it to your system.
Postman Testing Suite 1
Postman Testing Suite 2

7. Import Postman tests.

In Postman, in the top left corner, click on the Import button, and use the file selector to locate the two files on your operating system.
Next, you’ll confirm the import. The test suite should display as a Postman Collection v2.1 and import as a Collection. Click the Import button to continue.
Within your collections in Postman, you should see two collections– Rails Engine Lite, Part 1, and Rails Engine Lite, Part 2.

8. In your IDE, install dependencies found in Gemfile using your terminal.

$ bundle install

9. Run migrations and dump schema

$ rake db:{drop,create,migrate,seed}

$ rails db:schema:dump

View the tests for API endpoints inside spec/requests.

Test all functionality by running:.

$ bundle exec rspec spec

API endpoints can be tested both individually and collectively.

Find the appropriate endpoint within the Postman collection you imported.
For example, Get All Merchants. When you select Get All Merchants from the list, you should see a Postman tab open, pre-populated with everything you need to connect to the endpoint in your code and see if it works correctly.
Click the Send button in the top right corner.
In the lower portion of the Postman interface, you should see Body, Cookies, Headers and a spot that says something like Test Results (7/7). This would indicate that 7 tests passed out of 7. If you see, for example, 3/7 then 3 tests passed and 4 did not.

Project inspired and guided by Turing School of Software and Design's Rails Engine Lite.