WebAppProj

This repository contains the codebase for my university final year project which served as a key component of my dissertation. The primary focus of this project was to design and implement a web application with a strong emphasis on accessibility.

For my dissertation, I explored the critical role of accessibility in web applications, aiming to create an inclusive user experience for individuals with diverse abilities. The project aligns with the principles of universal design, ensuring that the application is usable by people of all abilities and disabilities.

Project Setup

Prerequisites

• Node.js (Download and install)
• Visual Studio (Download and install)

Steps

1. Clone/download the project from GitHub.
2. Open the solution file in Visual Studio (File > Open).
3. Navigate to the WebAppProj folder in Command Prompt or PowerShell.
4. Run the command npm install to install project dependencies. (Note: Ensure Node.js is installed correctly and try running as administrator if any issues occur.)

Configuration

• Update the valid issuer and valid audience in appsettings.json to match the localhost port number on your machine.

Database Setup

Prerequisites

• SQL Server
• SQL Server Management Studio

Steps

1. Restore the database from the .bak file located in the Database > Backup folder.
   • Follow these instructions for assistance.
2. Obtain the connection string and replace the existing string in appsettings.json in Visual Studio.
   • Ensure the general format of the new connection string matches the old one.

Launching/Running the Project

1. Build the solution in Visual Studio (Build > Build Solution).
2. Run the project (Debug > Start without debugging).
   • Debugging is optional but might take longer to launch.

User Credentials

Trainers

• Username: [email protected]
• Password: joepassword

Trainees

• Username: [email protected]
• Password: jimpassword

You can also register a new user, but existing users have associated groups, quizzes, and results.

User Features

Trainers can:

• Create a group.
• Add and remove trainees to and from that group.
• Create quizzes for trainees in that group.
• View a list of quizzes they have created and view them individually.
• View trainee results by quiz.
• Export results to CSV file.

Trainees can:

• Complete quizzes available to them and view their results.
• View a list of uncompleted quizzes available to them that they can complete.
• View a list of completed quizzes and their score for each quiz.

Both Users can:

• Adjust accessibility settings, such as the high contrast theme.

Explanation of Code and Project Structure

ClientApp

• The frontend application.

Controllers

• Backend controllers.

Tables

• Database tables.

Stored Procedures

• Database stored procedures.

User Defined Data

• Additional user-defined data.

License

This project is licensed under the MIT License. See the LICENSE file for details.