System Design | Notion

Requirements (MVP)

Functional Requirements:

Users can sign up / log in securely
Users can upload match data
- AI Generated Match Data - “Can you make CSV data that is league of legends based which is small enough to be manageable for a 3-day project?”
App generates analytics dashboards (charts & stats)
- ranking performance
- head-to-head stats against teams
- areas to improve
Only authenticated users can access dashboards

Non-functional Requirements

Secure: auth, HTTPS, file validation, vulnerability mitigation
Scalable: cloud-hosted, able to handle multiple teams
Reliable: data persistance (DB) + backups
Extensible: users can add new data

API’s - RESTful

Authentication API’s

Endpoint	Method	Request Body	Response	Notes
`/signup`	POST	{username, email, password, team_name{	{success: true/false, message}	Hash password (bcrypt) before storing in DB
`/login`	POST	{username, password}	{token: JWT, success: true/false}	Returns JWT for session/auth
`/logout`	POST	Authorization: Bearer <token>	{success: true}	Invalidate token if using server-side sessions

CSV Upload API

Endpoint	Method	Request Body	Response	Notes
`/upload-match`	POST	Multipart form: `file=match_stats.csv`	`{success: true/false, rows_inserted: N, errors: []}`

Analytics APIs