User Stories

Users

Sign Up

• As an unregistered and unauthorized user, I want to be able to sign up for the website via a sign-up form.
  • When I'm on the /signup page:
    • I would like to be able to enter my email, username, preferred password, and confirmed password on a clearly laid out form.
    • I would like the website to log me in upon successful completion of the sign-up form.
      • So that I can seamlessly access the site's functionality
  • When I enter invalid data on the sign-up form:
    • I would like the website to inform me of the validations I failed to pass, and repopulate the form with my valid entries (except my password).
    • So that I can try again without needing to refill forms I entered valid data into.

Log in

• As a registered and unauthorized user, I want to be able to log in to the website via a log-in form.
  • When I'm on the /login page:
    • I would like to be able to enter my email and password on a clearly laid out form.
    • I would like the website to log me in upon successful completion of the log-in form.
      • So that I can seamlessly access the site's functionality
  • When I enter invalid data on the log-in form:
    • I would like the website to inform me of the validations I failed to pass, and repopulate the form with my valid entries (except my password).
      • So that I can try again without needing to refill forms I entered valid data into.

Demo User

• As an unregistered and unauthorized user, I would like an easy to find and clear button on both the /signup and /login pages to allow me to visit the site as a demo user without signing up or logging in.
  • When I'm on either the /signup or /login pages:
    • I can click on a Demo User button to log me in as a demo user.
      • So that I can test the site's features and functionality without needing to stop and enter credentials.

Log Out

• As a logged in user, I want to log out via an easy to find log out button on the navigation bar.
  • While on any page of the site:
    • I can log out of my account and be redirected to a login page.
      • So that I can easily log out to keep my information secure.

Dashboard + Portfolio

Viewing Portfolio

• As a logged in user, I want to be able to view my overall portfolio.
  • When I am on the / page:
    • I can see a summary of my portfolio holdings.
      • So that I can see all my positions.
  • When I hover over the portfolio displayed in line graph format:
    • I can view the performance of my portfolio at a specific time.

Stocks

Viewing Stocks

• As a logged in user, I want to be able to view stocks.
  • When I am on the /stocks/ticker_symbol page:
    • I can look at a specific stock.
      • So that I can view information about the stock and be able to buy, trade, or add the stock to a watchlist.

Buying + Trading Stocks

• As a logged in user, I want to be able to buy or trade stocks.
  • When I am on the /stocks/ticker_symbol page:
    • I can buy or trade stocks.
      • So that I can buy new or more stocks I like or trade stocks I no longer want in my portfolio.

Watchlist

Viewing Watchlist

• As a logged in user, I want to be able to have a list of stocks I am watching.
  • When I am on the / page:
    • I can add stocks to a watchlist.
      • So that I can view the performance of stocks that I want to watch.

Updating Watchlist

• As a logged in user, I want to be able to remove stocks from my watchlist.
  • When I am on the /stocks/ticker_symbol page:
    • I can remove a stock.
      • So that the watchlist no longer has the stock.

Stock Search

• As a logged in user, I want to be able to search for stocks by company name or ticker symbol.
  • When I am on any page:
    • I can search for a stock.
      • So that I can find a specific stock I want to view.

News Feed

• As a logged in user, I want to be able to see a news feed.
  • When I am on the / page:
    • I can view general news.
  • When I am on the /stocks/ticker_symbol page:
    • I can view company specific news.