Game Exchange

Overview
Product Spec
Wireframes
Schema

Overview

Description

Go out into your community and trade games with Game Exchange. If you finished a game or have no more use for it, find a new game that interests you and switch with a local. Game Exchange allows you to easily find people near you that are willing to trade.

App Evaluation

Category: Shopping
Mobile: Game Exchange will allow you to use your location to arrange and reach the trade spot for the games. You may also use your phone's camera to take a picture of the game you wish to exchange easily.
Story: Allows users to satisfy their game cravings using games they no longer enjoy.
Market: Anyone that enjoys gaming could enjoy this app. Ability to search for games by categories allows users to find new games they may enjoy.
Habit: Users can search and post games at any point in the day. Searching by category encourages people to use this app to find new games to play.
Scope: While this app will be very technically challenging, it has room to grow. It will start by including the ability to post games and view recently posted trade requests. Then, it will progress to include the searching.

Product Spec

1. User Stories (Required and Optional)

Required Must-have Stories

User can log in and log out of their account
User can sign up to create a new account using Parse authentication
User can view games that are up for exchange in the home page
User can create and post a new game trading request
User can agree to a posted exchange

Optional Nice-to-have Stories

User Profiles
- User can view game requests they have made
- User can edit or delete existing requests
User can see game requests they can fulfill on the home page
User can search for game
User can filter home page by category and/or gaming platform
User can leave a review on another user
User can use location to search for trade spots
User can chat with other users to make offers or talk about trade spots

2. Screen Archetypes

Login
- User can login
Register
- User can register a new account
Stream
- User can view games that are up for exchange
Detail
- User can agree to a posted exchange
Creation
- User can create a game request

3. Navigation

Tab Navigation (Tab to Screen)

Stream
Creation

Flow Navigation (Screen to Screen)

Login
- Register
- Stream
Register
- Stream
Stream
- Detail
Detail
- None
Creation
- Stream

Wireframes

Schema

Models

Request

Property	Type	Description
objectId	String	unique id for the user request (default field)
author	Pointer to User	author of request
location	String	location request will be based off
image	File	image of user's game
itemSelling	String	game user wants to exchange
itemRequest	Array	games user is willing to accept
requestStatus	String	indicates if request is active, in progress, or sold
createdAt	DateTime	date when request is created (default field)
updatedAt	DateTime	date when request is last updated (default field)

User

Property	Type	Description
objectId	String	unique id for the user request (default field)
username	String	the username for the user
password	String	the password for the user
createdAt	DateTime	date when request is created (default field)
updatedAt	DateTime	date when request is last updated (default field)

Networking

(Create/POST) Create a new user object

 PFUser *newUser = [PFUser user];
  
  // set user properties
  newUser.username = self.usernameField.text;
  newUser.password = self.passwordField.text;
  
  // call sign up function on the object
  [newUser signUpInBackgroundWithBlock:^(BOOL succeeded, NSError * error) {
      if (error != nil) {
          NSLog(@"Error: %@", error.localizedDescription);
      } else {
          NSLog(@"User registered successfully");
          
          // TODO: segue to home view
      }
  }];

Home Feed Screen

(Read/GET) Query all requests

PFQuery *query = [PFQuery queryWithClassName:@"Request"];
[query orderByDescending:@"createdAt"];
[query includeKey:@"author"];

// fetch data asynchronously
[query findObjectsInBackgroundWithBlock:^(NSArray *requests, NSError *error) {
  if (requests != nil) {
      // TODO: do something with requests
  } else {
      NSLog(@"%@", error.localizedDescription);
  }
}];

Details Screen

(Update/PUT) Update request status

PFQuery *query = [PFQuery queryWithClassName:@"Request"];
// TODO: obtain request's object id
// Retrieve the object by id
[query getObjectInBackgroundWithId:requestID
                           block:^(PFObject *request, NSError *error) {
  request[@"requestStatus"] = @"in progress";
  [request saveInBackground];
}];

Create Post Screen

(Create/POST) Create a new request object

// TODO: get correct property values
PFObject *request = [[PFObject alloc] initWithClassName:@"Request"];
request[@"author"] = [PFUser currentUser];
request[@"location"] = location;
request[@"image"] = imageFile;
request[@"itemSelling"] = itemSelling;
request[@"itemRequest"] = itemRequest;
request[@"requestStatus"] = @"active";
[request saveInBackground];

elisaj1317/GameExchange