Objec&ve

To design and implement a Flask web application that allows users to interact with a collection of games. Using the data from the provided 'games.csv' file (accessible in the repository), your task is to create an engaging web application that presents this collection to users in an interactive manner. The application should facilitate displaying and searching of the games.

IMPORTANT: For your code to be eligible for marks on the tasks specified in the funcAonal requirements, it must adhere to the following non-funcAonal requirements.

Non-Func&onal Requirements

1.   Project Structure and Conformance [1 mark]

.    Conformance to established project structure as discussed in the lectures.

.    Ensure vital documentation, like ‘requirements.txt’ and ‘README.md’, is present.

.    The application should run by typing ‘flask run’, from within the virtual environment in a terminal window.

.    The tests should run by typing ‘python –m pytest –v tests’, from within the virtual environment in a terminal window.

.    If the application doesn’t run properly, the remaining steps will NOT be marked.

2.   Use of Blueprints [1 mark]

.    Register blueprints to segregate the applicaDon's components. For example: home, games, genres, search etc.

.    Each blueprint should encapsulate a disDnct set of functionalities adhering to the principle of Single Responsibility.

3.   User Interface & Design [1 mark]

.    Implement CSS for a visually capDvaDng applicaDon.

.    UDlize Jinja templates to ensure a consistent appearance across pages while minimizing repetitive code.

4.   Flask Routes and HTTP Protocol [2 marks]

.    Clearly define routes/URLs for different functionaliDes (e.g., /games, /genres, or /search etc.)

.    Ensure that the application uses the appropriate HTTP methods, query parameters, response codes etc.

5.   Abstract Repository Interface [2 marks]

.    This interface should define the necessary methods for fetching, storing, and manipulating data about games.

.    For this assignment, you’ll be using a memory repository as the data storage mechanism.

Func&onal Requirements

Task 1: Create a Homepage [4 marks]

.    Construct a basic homepage for the web application. You could include a logo, a navigaDon menu, a brief introductory statement about your website, a search bar etc.

Task 2: Browsing the Game Library [4 marks]

.    Display a list of available games organized in a user-friendly manner (say in an alphabeDcal order, or based on release date etc.)

.    Implement pagination. Define a maximum number of games displayed per page and enable navigaDon between pages.

Task 3: Display Details of a Specific Game [5 marks]

.    Upon selecting a game, provide comprehensive informaDon about it. This might include its

Dtle, descripDon, publisher, image, release date, user raDngs/reviews, associated genres, and more.

Task 4: Implement a Genre-based Sidebar [5 marks]

.    Extract and display a list of unique game genres from the dataset in the sidebar.

.    Users should be able to select or click on a genre to filter and view games associated with that genre.

Task 5: Implement Game Search Functionality [5 marks]

.    Implement a search bar allowing users to search for games based on game Dtle, publisher, or other aeributes.

.    Integrate dropdowns or selection options for users to choose genres, publishers, or other filtering criteria.

Task 6: Write Unit Tests for the Earlier Specified tasks [5 marks]

.    Validate the core functionalities of the service layer (i.e. ensure that the business logic operates correctly).

Some example service layer tests -

# Test service layer returns an existing game object

# Test service layer retrieves correct number of game objects

# Test only X games are retrieved from the service layer for the pagination functionality # Test gekng games for a search key ‘genre’

# Test gekng games for a search key ‘ publisher’

# Test inserting non-existing search key throws exception