Skip to content

Latest commit

 

History

History
230 lines (149 loc) · 9.54 KB

README.md

File metadata and controls

230 lines (149 loc) · 9.54 KB
Raw

M3 - README.md Example


# iMentor: Find a mentor in the Ironhack community

Description

iMentor You started your journey as a developer at Ironhack. Do you need some advice? We give you the option to get in touch with some senior Ironhackers so you can find the best mentor to guide you through your new journey. With iMentor you will find the best mentor within the Ironhack community.

User Stories

  • 404: As an anon/user I can see a 404 page if I try to reach a page that does not exist so that I know it's my fault
  • Signup: As an anon I can sign up in the platform so that I can start playing into competition
  • Login: As a user I can login to the platform so that I can play competitions
  • Logout: As a user I can logout from the platform so no one else can use it
  • Add Tournaments As a user I can add a tournament
  • Edit Tournaments As a user I can edit a tournament
  • Add Player Names As a user I can add players to a tournament
  • Edit Player profiles As a user I can edit a player profile to fit into the tournament view
  • View Tournament Table As a user I want to see the tournament table
  • Edit Games As a user I can edit the games, so I can add scores
  • View Ranks As a user I can see the ranks

Backlog

User profile:

  • see my profile
  • change tournament mode to FFA
  • Add weather widget
  • lottie interactions
  • users can bet
  • add geolocation to events when creating

Client / Frontend

React Router Routes (React App)

Path Component Permissions Behavior
/ SplashPage public <Route> Home page
/signup SignupPage anon only <AnonRoute> Signup form, link to login, navigate to homepage after signup
/login LoginPage anon only <AnonRoute> Login form, link to signup, navigate to homepage after login
/mentors TournamentListPage user only <PrivateRoute> Shows a list of mentors and gives the option to filter based on skills
/questions TournamentListPage public <Route> List of questions and gives the option to filter based on the question topic
/questions/add TournamentDetailPage user only <PrivateRoute> Adds a question to the feed/list
/questions/:id n/a public <Route> See the details of the specific question
/questions/:id/delete PlayersListPage owner only <PrivateRoute> Delete the question(only the owner can do it)
/questions/:id/comment/add PlayersListPage user only <PrivateRoute> Add a comment to a specific question
/questions/comment/:id/delete PlayersDetailPage user only <PrivateRoute> Delete the comment
/profile/:id PlayersListPage user only <PrivateRoute> The details of the mentor/mentee
/profile/:id/edit TableView user only <PrivateRoute> Edit the details of the mentor/mentee
/messages RanksPage owner only <PrivateRoute> See the list of messages
/messages GameDetailPage owner only <PrivateRoute> See specific chat

Components

  • LoginPage

  • SplashPage

  • TournamentListPage

  • Tournament Cell

  • TournamentDetailPage

  • TableViewPage

  • PlayersListPage

  • PlayerDetailPage

  • RanksPage

  • TournamentDetailPageOutput

  • Navbar

Services

  • Auth Service

    • auth.login(user)
    • auth.signup(user)
    • auth.logout()
    • auth.me()
    • auth.getUser() // synchronous

  • Tournament Service

    • tournament.list()
    • tournament.detail(id)
    • tournament.add(id)
    • tournament.delete(id)

  • Player Service

    • player.detail(id)
    • player.add(id)
    • player.delete(id)

  • Game Service

    • Game.put(id)

Server / Backend

Models

User model

{
  username: {type: String, required: true, unique: true},
  email: {type: String, required: true, unique: true},
  password: {type: String, required: true},
  favorites: [Tournament]
}

Tournament model

 {
   name: {type: String, required: true},
   img: {type: String},
   players: [{type: Schema.Types.ObjectId,ref:'Participant'}],
   games: [{type: Schema.Types.ObjectId,ref:'Game'}]
 }

Player model

{
  name: {type: String, required: true},
  img: {type: String},
  score: []
}

Game model

{
  player1: [{type: Schema.Types.ObjectId,ref:'Participant'}],
  player2: [{type: Schema.Types.ObjectId,ref:'Player'}],
  player2: [{type: Schema.Types.ObjectId,ref:'Player'}],
  winner: {type: String},
  img: {type: String}
}

API Endpoints (backend routes)

HTTP Method URL Request Body Success status Error Status Description
GET /auth/profile Saved session 200 404 Check if user is logged in and return profile page
POST /auth/signup {name, email, password} 201 404 Checks if fields not empty (422) and user not exists (409), then create user with encrypted password, and store user in session
POST /auth/login {username, password} 200 401 Checks if fields not empty (422), if user exists (404), and if password matches (404), then stores user in session
POST /auth/logout (empty) 204 400 Logs out the user
GET /api/tournaments 400 Show all tournaments
GET /api/tournaments/:id {id} Show specific tournament
POST /api/tournaments {} 201 400 Create and save a new tournament
PUT /api/tournaments/:id {name,img,players} 200 400 edit tournament
DELETE /api/tournaments/:id {id} 201 400 delete tournament
GET /api/players 400 show players
GET /api/players/:id {id} show specific player
POST /api/players {name,img,tournamentId} 200 404 add player
PUT /api/players/:id {name,img} 201 400 edit player
DELETE /api/players/:id {id} 200 400 delete player
GET /api/games {} 201 400 show games
GET /api/games/:id {id,tournamentId} show specific game
POST /api/games {player1,player2,winner,img} add game
PUT /api/games/:id {winner,score} edit game

Links

Trello/Kanban

Link to your trello board or picture of your physical board

Git

The url to your repository and to your deployed project

Client repository Link

Server repository Link

Deployed App Link

Slides

The url to your presentation slides

Slides Link