The 'Rails Engine/ Rails Drive' project is an exercise on exposing APIs. The exercise requires using TDD to drive the process and we were provided an spec harness test in 'Rails Drive'. The most challenging part was figuring out how to complete some of these processes without the proper know-how (no lessons provided). This made things very challenging but allowed me to expose areas that need strengthening.
You are working for a company developing an E-Commerce Application. Your team is working in a service-oriented architecture, meaning the front and back ends of this application are separate and communicate via APIs. Your job is to expose the data that powers the site through an API that the front end will consume.
Rails Driver is the front end of the application. It includes a test suite as well as a front end to test your application. Instructors will use this to determine the completion of your project.
It should be noted that in most professional applications, the front end would not be written in Rails. More likely, a pure front end application would use a Javascript framework such as React. However, in order to make this portion of the project more understandable to BEM3 students we have written it in Rails. The extensions for this project will build on this front end application.
The Technical Requirements for this project can be found here
Evaluation details can be found here
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
We'll be running this app in:
- Ruby 2.5.3
- Rails 5.2.4.3
Please run the following commands in your terminal:
git clone git@github.com:nicorithner/rails_engine.git
bundle install
rails db:{create,migrate}
rails import
It will take a moment. You'll see:
$rails import
Customer data imported!
Merchant data imported!
Invoice data imported!
Item data imported!
InvoiceItem data imported!
Transaction data imported!
Please follow this link to find the 'Rails Driver' repo and clone it.
Follow the instructions in its README file to install it.
To run the test suite inside of Rails Engine please run the following command:
bundle exec rspec
-
To get Rails Engine working with Rails Driver, open up a new terminal tab or window.
-
In your terminal tab or window with Rails Engine, type the command.
rails server.To shut down the server hold down the 'control' button on Mac and press the key 'c'.
-
Then, in your terminal tab or window with Rails Driver, type the command
bundle exec rspecto run its test suite.
With Rails Engine still running, open your API consumption tool of choice, such as Postman or just a regular Internet browser.
Then, begin your query to the API by using the following root URI on all queries:
http://localhost:3000/api/v1/
And append whatever request to the end that you desire. A non-exhaustive list of various endpoints that can be queried with a GET request are as follows:
- merchants
- items
- items/:id
- items/find?name=
- merchants/find_all?created_at=2012-03-27 14:53:59 UTC
- merchants/most_revenue?quantity=x where x is the number of merchants that should be returned
- merchants/most_items?quantity=x where x is the number of merchants that should be returned
Here I am listing some links to articles and documentation I used to work on this project
How to import csv data to the database:
- How to seed your Rails DB from CSV
- How to use ActiveRecord to reset the Primary Key sequences in PostgreSQL
- ActiveRecord Query Methods
