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