OneSport is a modular platform offering real-time sports news updates and streamlined event ticketing. Built with microservices architecture, it provides distinct services for user authentication, friend management, and personalized ticket handling. The platform allows users to customize news feeds, save favorite articles, and efficiently manage ticket purchases, with a robust system for filtering content by preferences and location, making it a comprehensive solution for sports enthusiasts and event-goers.
Andrea Panceri 1884749
Francesco Sudoso 1808353
Valerio Francione 2047712
Eugenio Facciolo 2065516
Francesco Sasanelli 2014433
OneSport is dedicated to offering up-to-date and pertinent information on a wide range of sports and athletic events. Our primary aim is to keep fans and enthusiasts well-informed and engaged. The project strives to serve as a one-stop destination for comprehensive sports news, event updates, and a convenient platform for purchasing tickets to various sporting events.
As a User:
- I want to be able to signup in order to have an account
- I want to be able to login
- I want to logout from the account by clicking on the Navbar
- I want to be able to have access to my profile settings
- I want to be able to delete my account by clicking on a button from the profile settings page
- I want to be able to modify my email and password in order to change my credentials
- I want to see all recent news
- I want to filter Italian news by selecting from the menu of available countries
- I want to add to my favourite news all the news I'm interested in, in order to read them later
- I want to delete from my favourite news all the news that I'm no longer interested
- I want to see available tickets for upcoming sporting events
- I want to filter Italian tickets by selecting from the menu of available countries
- I want to add to my collection all the tickets I'm interested in, in order to purchase them later
- I want to delete from my collection all the tickets that I'm no longer interested
- I want to be able to delete all the news and tickets in my favourite list
- I want to see all my friends
- I want to send a friend request to another user, in order to add him to my friend list
- I want to check if someone has sent me a friend request, in order to accept or delete it
- I want to delete a friend from my friend list
There are basically four entities in the system:
- User: handle the authentication, he can add, remove or modify users in the system.
- News: can look for recent news, save them if interested, and can also delete or update saved news.
- Tickets: is responsible for searching and managing ticket-related operations. It acts as the intermediary between users and event tickets. Users can utilize this feature to search for available tickets for various sporting events and make purchases. A ticket can be collected, also deleted and updated.
- Friends: it is responsible for all the actions realted to the friend section, like creating request but also accept or refuse it. It play a crucial role in the system.
- News service: microservice that handles the news of the site.
- Tickets service: microservice dedicated to handle the management of the tickets.
- Friends service: microservice for creat connections between users.
- Authentication service: microservice that handle authentication of the user, and all the management of his informations.
- Database: database to store data related to the system.
- News Interface: interface that allows the communication between the news client and the news service
- Tickets Interface: interface that allows the communication between the ticket client and the ticket service
- Friends Interface: interface that allows the communication between the friends client and the friends service
- Authentication Interface: interface that allows the communication between the client and the authentication service
user:
| id | name | role | password |
|---|
news:
| id | title | author | urlToImage | published_at | user_id | url |
|---|
tickets:
| id | name | info | promoter | urlToImage | localDate | user_id | url |
|---|
friends:
| id | user_id | friend_id | status |
|---|
- GET /users/
Returns all the users of the application.
-
GET /users/[user_id]
Returns the user with ID=[user_id].
Example: <authentication_service_url>/user/1 Gets the user with ID=1
-
GET /users/get_by_email/[email]
Return the user with the email=[email].
-
GET /users/checkToken
Check if the current user has a valid token, or it is expired.
-
POST /users/login
Handle the login for the current user, generating as response a token.
Format of json body: { "email": "massimo.mecella@uniroma1.it", "password" = "Laboratorio2023#", "remember" = true }
-
POST /users/signup
Create a new user using the inserted information, return a message that confirm the action.
Format of json body: { "email": "massimo.mecella@uniroma1.it", "name": "Massimo", "password": "Laboratorio2023#" }
-
POST /users/logout
Remove the token for the logged user, and execute the logout from current session, return a confirmation message.
Format of json body: { "user_id": 4 }
-
PUT /users/[user_id]/edit
Update the information of user with ID=[user_id], and return the json of the updated user.
Format of json body: { "email": "massimo.mecella@diag.it", "name": "Massimo", "password": "Laboratorio2023%" }
-
DELETE /users/[user_id]
Delete the user with ID=[user_id].
-
GET /news/
Returns all latest sports news, using an external API, can be applied filters:
- country: The country code where news is to be searched.
- q: A keyword that the news must contain.
- pageSize: The number of results per page.
- page: The desired number of pages for result delivery.
Example: <news_service_url>/news/?country=IT&pageSize=20&page=4&q=Roma Gets all the latest news related to Roma, from Italian sources.
-
GET /news/[user_id]
Returns all news saved by user with ID=[user_id].
Example: <news_service_url>/news/1 Gets all the saved news by user with ID=1
-
POST /news/create
Save a news for a user, adding also the linked information and return the json of the news created.
Format of json body: { "title":"Lukaku scappa, Zapata lo riprende: un punto a testa per Torino e Roma", "author":"Gazzetta dello sport", "urlToImage":"https://dimages2.gazzettaobjects.it/files/image_618_349/files/fp/uploads/2023/09/24/65109e6a86b68.r_d.1362-736-2270.jpeg", "published_at":"2023-09-25", "user_id":"4", "url":"https://www.gazzetta.it/Calcio/Serie-A/Torino/24-09-2023/torino-roma-1-1-lukaku-scappa-zapata-lo-riprende.shtml" }
-
DELETE /news/[news_id]
Deletes the news with ID=[news_id].
-
DELETE /news/[user_id]/all
Deletes all the news saved by user with ID=[user_id].
-
GET /tickets/
Returns all tickets for upcoming events, using an external API, can be applied filters:
- countryCode: The country code where tickets are to be searched.
- keyword: A word related to the desired event.
- size: the size of results.
- page: The desired number of pages for result delivery.
Example: <tickets_service_url>/tickets/?countryCode=US&size=100&page=4 Gets all the upcoming events in US, maximum 100 reuslts in 4 pages.
-
GET /tickets/[user_id]
Returns all tickets collected by user with ID=[user_id].
Example: <tickets_service_url>/tickets/1 Gets all the collected tickets by user with ID=1
-
POST /tickets/collect
Generate the collection of a ticket for a user, adding also the linked information and return the json of the ticket created.
Format of json body: { "name":"Portland Trail Blazers vs. Phoenix Suns", "info":"Bags and full-length umbrellas are not allowed in the arena. Exclusions apply for medical bags, children's bags and clutches 5X8" or smaller. Bag check is available.", "urlToImage":"https://s1.ticketm.net/dam/a/68b/e6113bdd-2bdf-46d8-bfa9-c32b09b9768b_RECOMENDATION_16_9.jpg", "promoter": "GG", "localDate":"2023-10-12", "user_id":"4", "url":"https://www.ticketmaster.com/portland-trail-blazers-vs-phoenix-suns-portland-oregon-10-12-2023/event/0F005F08E2256F5E" }
-
DELETE /tickets/[ticket_id]/cancel_friend
Deletes the ticket with ID=[ticket_id].
-
DELETE /tickets/[user_id]/all
Deletes all the tickets collected by user with ID=[user_id].
-
GET /friends/[user_id]
Returns all friend of the user associeted to [user_id].
Example: <friend_service_url>/friends/1 Gets all the friends of user with ID=1
-
GET /friends/requests/[friend_id]
Returns all requests recieved by the user associeted to [friend_id].
Example: <friend_service_url>/friends/requests/1 Gets all the requests recieved by user with ID=1
-
POST /friends/create_request
create a request of friendship by user [user_id] for another one [friend_id], and return the json of the friendhip created.
Format of json body: { "user_id": 2, "friend_id": 4 }
-
PUT /friends/[int:request_id]/accept_request
Update the request with ID=request_id, changing status to 'accepted'.
-
DELETE /friends/[friend_id]/cancel_friend
Deletes friendship with given id.
-
DELETE /friends/[request_id]/delete_request
Deletes request of friendship with given id.
