lovrohodak/hoopitapp-server

Backend server for hoopitApp project

hoopitApp

Description

Hoop.It.App is a web and mobile app that allows you to organize basketball games in your city and build teams with your friends. It is build using react, express and node.js with bcrypt for authentication. This project represents my first full react project and extends the knowledge from my 2nd project by making use of complex models, routes and multiple user types. I also took this opportunity to learn Socket.io for the chat function and the Google Maps API and Google Maps Places API. For extra practice I used both hooks as well as classes for state management and several forms of promise collection. I also utilized the Cloudinary storage service for image uploading, Zeplin.io for wireframe construction and style implamentation as well as Lottie for the loading GIF creation.

User Stories

• See Court Map As an anon I can see example games in my city that have been added by users
• Signup As an anon I can sign up to the platform and create my account
• Login As a user I can login to my account
• Logout As a user I can log out of my account
• Create a Game As a user I can create a new basketball game
• Create a New Team As a user-game-admin I can create a new team with the players in my game
• Edit Game As a user I can edit my games' members, location, date, and the winner of the game
• Edit Profile As a user I can edit my profile
• Chat As a user I chat with members of my team

Backlog

About Page:

• Add a page with information about the site

Calender:

• Add a calender function to schedule games and save them to the game model

Forum:

• Communicate with other players to organize games via a forum

Tournaments:

• Enable users to build their own tournaments

News:

• Add latest basketball news

Watch Party:

• Organize watch parties for NBA games

Referees:

• Enable users to act as referees in games

Rules:

• Enable users to add or remove rules from games

Client

Routes

• / - Homepage
• /auth/signup - Signup form
• /auth/login - Login form
• /user/:id - User Homepage
• /user/:id - User Homepage
• /user/:id/teams - Create or join a team
• /user/:id/games - Create or join a game
• /user/:id/profile - Edit profile
• 404

Pages

• Home Page/City Map (public)
• Signup Page (anon only)
• Login Page (anon only)
• User Home Page (user only)
• User Teams Page (user only)
• User Team Detail page (user only)
• User Games Page (user only)
• User Game Detail Page (user only)

Components

• Create Game Component
  • Input: location: string, type: string, date: string,
• Join Game Component
  • Input: name: string
• Create Team Component
  • Input: name: string, players: array, homeTown: string
• Join Team Component -Input: name: string

IO

Services

• Auth Service

  • auth.login(user)
  • auth.signup(user)
  • auth.logout()
  • auth.user()
  • auth.getUser()

• Games Service

  • games.list()
  • games.create(data)
  • games.detail(id)

• Teams Service

  • teams.list()
  • teams.create(data)
  • teams.detail(id)

Server

Models

User Model

username - String // required
email - String // reqquired & unique
password - String // required
imageUrl - String
location - String
gamesCreated - Number
gamesPlayed - Number
teams - [ObjectId<Team>]
lat - Number
lng - Number

Games Model

createdBy - [ObjectId<User>]
date - String
location - String
players - [ObjectId<User>]
lat - Number
lng - Number
city - String
maxPlayers - Number
savedAsTeam - String
imageurl - String

Teams Model

owner - [ObjectId<User>]
teamName - String
players - [ObjectId<Users>]
homeTown - String
gamesPlayed - Number

Message Model content - String name - String team - String roomId - String imageUrl - String

owner - [ObjectId<User>]
teamName - String
players - [ObjectId<Users>]
homeTown - String
gamesPlayed - Number

API Endpoints/Backend Routes

• GET /
• GET /auth/signup
• POST /auth/signup
  • body:
    • username
    • email
    • password
    • location
    • imageUrl
• GET /auth/login
• POST /auth/login
  • body:
    • username
    • password
• POST /auth/logout
  • body: (empty)
• GET /:userId
• GET /user/join-game
• POST /user/join-game
  • body:
    • name
• GET /user/create-game
• POST /user/create-game
  • body:
    • date
    • location
  • reference:
    • createdBy [ObjectId]
• GET /game/:id
• GET /user/team-detail
• POST /user/create-team
  • body:
    • date
    • homeTown
  • reference:
    • owner [ObjectId]
    • players [ObjectId]
• GET /user/teams
• GET /user/profile
• POST /user/profile
  • body:
    • username
    • email
    • password
    • imageUrl
    • location
  • reference:
    • gamesCreated
    • gamesPlayed
• GET /forum
• GET /user/forum

Links

Trello

[https://trello.com/b/fudcI5E0/basketball-app]

Wire Frames

[https://miro.com/welcomeonboard/MW4a3RWED9e9OKUeqWq9bE6VG0qn6snInn1niT7fGu7rqM3hJWhAnZAavrZltQof]

Git

[https://github.com/colorpulse6/hoopitapp-server] [https://github.com/colorpulse6/hoopitapp]

Deployment

[https://hoopitapp.herokuapp.com/]

Slides

[https://docs.google.com/presentation/d/1ITWaidwNwHyAy3hsINt5oreKjPL4oQH-_L3dVBlzcZs/edit?usp=sharing]