FarMar Finder

In this assignment we will be creating an application to look up farmers markets and their related vendors, products, and sales. We will use CSV files as our database.

Expectations

Project Structure

Build classes to query the CSV data including objects and methods listed below. Before going into the requirements and methods listed in tiers below, build a system to read the CSV files and turn each row of data into an instance of the appropriate Ruby class.

To manage our data classes we will use a file named /lib/far_mar.rb. It should look something like:

require 'csv'
require 'time'
require 'lib/market'
# ... require all needed classes

Each class you build will live in the /lib/far_mar/ directory, and belong to the FarMar module:

module FarMar
  class Market
    # Your code goes here
  end
end

The module provides a namespace for the application. A namespace ensures the classes we create will not 'collide' or 'overlap' with a class that could exist elsewhere in a codebase (like in a gem).

For example, Sale is a very generic class name that could very realistically exist in many codebases. Creating a module called FarMar allows us to specify which Sale we're talking about; FarMar::Sale is much more explicit and likely to be unique.

Project Data

FarMar::Market

Each individual market has many vendors associated with it. The FarMar::Market data, in order in the CSV, consists of:

ID - (Fixnum) a unique identifier for that market
Name - (String) the name of the market (not guaranteed unique)
Address - (String) street address of the market
City - (String) city in which the market is located
County - (String) county in which the market is located
State - (String) state in which the market is located
Zip - (String) zipcode in which the market is located

FarMar::Vendor

Each vendor belongs to a market, the market_id field refers to the FarMar::Market ID field. Each vendor has many products for sell. The FarMar::Vendor data, in order in the CSV, consists of:

ID - (Fixnum) uniquely identifies the vendor
Name - (String) the name of the vendor (not guaranteed unique)
No. of Employees - (Fixnum) How many employees the vendor has at the market
Market_id - (Fixnum) a reference to which market the vendor attends

FarMar::Product

Each product belongs to a vendor. The vendor_id field refers to the FarMar::Vendor ID field. The FarMar::Product data, in order in the CSV, consists of:

ID - (Fixnum) uniquely identifies the product
Name - (String) the name of the product (not guaranteed unique)
Vendor_id - (Fixnum) a reference to which vendor sells this product

FarMar::Sale

Each sale belongs to a vendor AND a product. The vendor_id and product_id fields refer to the FarMar::Vendor and FarMar::Product ID fields, respectively. The FarMar::Sale data, in order in the CSV, consists of:

ID - (Fixnum) uniquely identifies the product
Amount - (Fixnum) the amount of the transaction, in cents (i.e., 150 would be $1.50)
Purchase_time - (Datetime) when the sale was completed
Vendor_id - (Fixnum) a reference to which vendor completed the sale
Product_id - (Fixnum) a reference to which product was sold

Requirements

Baseline Setup

You'll be working as an individual on this project.
Clone the project master repo and create a new branch with your initials.
Push your branch so it will show in the list of branches on the project master.
Fork and clone your repository.
Switch to your branch by doing git checkout [YOUR BRANCH NAME]. Do not work on the master branch.
cd into the dir created: $ cd far_mar
Install needed tools via Terminal:

$ gem install rspec
$ gem install simplecov

Baseline Requirements

Create a class for each of the data types listed above. Each class should be inside the FarMar module.
- You should be able to create instances of these classes that know about their associated data file.
Create your far_mar.rb file which will bring together all classes created in the previous step.
Once you have completed your baseline, you must submit a pull-request and get it merged from one your instructors.

Primary Requirements

For each of the data classes build the following methods:

self.all - returns a collection of Market instances, representing all of the markets described in the CSV
self.find(id) - returns an instance of Market where the value of the id field in the CSV matches the passed parameter.

Additional FarMar::Market Methods

vendors - returns a collection of FarMar::Vendor instances that are associated with the market by the market_id field.

Additional FarMar::Vendor Methods

market - returns the FarMar::Market instance that is associated with this vendor using the FarMar::Vendor market_id field
products - returns a collection of FarMar::Product instances that are associated by the FarMar::Product vendor_id field.
sales - returns a collection of FarMar::Sale instances that are associated by the vendor_id field.
revenue - returns the the sum of all of the vendor's sales (in cents)
self.by_market(market_id) - returns all of the vendors with the given market_id

Additional FarMar::Product Methods

vendor - returns the FarMar::Vendor instance that is associated with this vendor using the FarMar::Product vendor_id field
sales - returns a collection of FarMar::Sale instances that are associated using the FarMar::Sale product_id field.
number_of_sales - returns the number of times this product has been sold.
self.by_vendor(vendor_id) - returns all of the products with the given vendor_id

Additional FarMar::Sale Methods

vendor - returns the FarMar::Vendor instance that is associated with this sale using the FarMar::Sale vendor_id field
product - returns the FarMar::Product instance that is associated with this sale using the FarMar::Sale product_id field
self.between(beginning_time, end_time) - returns a collection of FarMar::Sale objects where the purchase time is between the two times given as arguments

Optional Requirements: Part I

FarMar::Market Methods

products returns a collection of FarMar::Product instances that are associated to the market through the FarMar::Vendor class.
self.search(search_term) returns a collection of FarMar::Market instances where the market name or vendor name contain the search_term. For example FarMar::Market.search('school') would return 3 results, one being the market with id 75 (Fox School Farmers FarMar::Market).
prefered_vendor - returns the vendor with the highest revenue
prefered_vendor(date) - returns the vendor with the highest revenue for the given date
worst_vendor - returns the vendor with the lowest revenue
worst_vendor(date) - returns the vendor with the lowest revenue on the given date

FarMar::Vendor Methods

self.most_revenue(n) returns the top n vendor instances ranked by total revenue
self.most_items(n) returns the top n vendor instances ranked by total number of items sold
self.revenue(date) returns the total revenue for that date across all vendors
revenue(date) returns the total revenue for that specific purchase date and vendor instance

FarMar::Product Methods

self.most_revenue(n) returns the top n products instances ranked by total revenue

Optional Requirements: Part II

For All Classes

Write additional rspec tests for any methods in the data classes that don't already have test coverage.
self.find_by_x(match) - where X is an attribute, returns a single instance whose X attribute case-insensitive attribute matches the match parameter. For instance, FarMar::Vendor.find_by_name("windler inc") could find a FarMar::Vendor with the name attribute "windler inc" or "Windler Inc".
self.find_all_by_x(match) - works just like find_by_x but returns a collection containing all possible matches. For example FarMar::Market.find_by_state("WA") could return all of the FarMar::Market object with "WA" in their state field.
Create a new class that defines the shared/duplicated methods (i.e., find, all). Update your data classes to inherit from this new parent class in order to DRY up your code.

Testing Requirement

You must have 90% test coverage from simplecov. The HTML files that are generated from simplecov should not be included in your git repository and therefore in your pull request.

To run your test suite use:

$ rspec

loganmeetsworld/FarMar