Skip to content

An Ruby on Rails application for managing and reviewing a stock porfolio

Notifications You must be signed in to change notification settings

jdbean/Stock-Trader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

a93bcdf · Nov 28, 2018

History

71 Commits
Nov 28, 2018
Nov 20, 2018
Nov 26, 2018
Nov 24, 2018
Nov 20, 2018
Nov 20, 2018
Nov 20, 2018
Nov 20, 2018
Nov 28, 2018
Nov 20, 2018
Nov 20, 2018
Nov 20, 2018
Nov 26, 2018
Nov 28, 2018
Nov 25, 2018
Nov 25, 2018
Nov 28, 2018
Nov 20, 2018
Nov 20, 2018
Nov 20, 2018
Nov 21, 2018

Repository files navigation

Overview

Stock Trader is a web-based application for users to build and review a stock portfolio.

Basic Features

  1. Users may create a new account with name , email , and password. The user’s cash account balance defaults to to $5000.00 USD. A user can only register once with any given email.
  2. A user can authenticate via email and password to access their account.
  3. A user may purchase shares of stock at its current price by specifying its ticker symbol and quantity of shares. A user can only buy whole number quantities of shares. A user can only buy shares if they have enough cash in their account for a given purchase. A user can only buy shares if the ticker symbol is valid. A purchase is denied if the quoted price is no more than 1% more than the quoted price.
  4. A user may view a list of all transactions made to date so that they can perform an audit. Audit logs may be filtered by stock symbol and/or date range. Audit list may be reviewed by purchase price, share ammount, date, or stock symbol. Audit logs may be diplayed in print friendly format. Audit logs may be exported in comma seperated value format.
  5. A user I want to view a list of all the stocks they own along with their current values so that they can review investment performance. Current values are based on the latest price and quantity owned for a given stock. Users can search or sort the list on multiple metrics. A user is provided with the total current value of their stock portfolio.
  6. As a user I am given a dynamic indication of stock performance in the form of font color of stock symbols and current prices in my portfolio which change dynamically to indicate performance: Red when the current price is less than the day’s open price, grey when the current price is equal to the day’s open price, and green when the current price is greater than the day’s open price.

Technologies

  • Ruby 2.4.5
  • Rails 5.2
  • PostgreSQL
  • Devise
  • Faraday/Typhoeus
  • Bootstrap
  • jQuery
  • Effective Datatables

Install instructions

  1. Clone this repo.
  2. Ensure that Ruby 2.4.5, PostgreSQL, and a recent version of bundler are installed.
  3. Start PostgreSQL.
  4. Execute bundle install and ensure any additional dependencies are installed. Libcurl is one notable dependency which can be installed on Debian Stretch / Ubuntu Bionic with sudo apt-get install libcurl4-openssl-dev.
  5. Initialize the database by executing rails db:create, rails db:migrate, rails db:seed.
  6. Start the application with rails s
  7. Visit the application at default address localhost:3000 and create a new account or login to the default account with credentials username: [email protected] and password: password.

Roadmap

  1. Rigorous automated testing suite
  2. Implement stock selling functionality
  3. Review and improve keyboard navigation
  4. Implement better handling and automated retrying of failed or unsucessful Faraday requests
  5. Implement a cache to retain portfolio total data for performance purposes

About

An Ruby on Rails application for managing and reviewing a stock porfolio

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published