Test Builder Application

This application is designed for employees to pass tests. The director creates tests and adds users. Employees pass these tests using a local application installed on their computers.

Installation

To install the Test Builder application, follow these steps:

Clone the repository:

git clone https://github.com/IlyaM1/TestBuilder.git

Create a virtual environment and activate it:

python -m venv venv
venv\Scripts\activate

Install the required packages:

pip install -r requirements.txt

Create a config.json file with the following content:

{
  "name": "YOUR_NAME_FOR_ADMIN",
  "password": "YOUR_PASSWORD_FOR_ADMIN",
  "path": "YOUR_PATH_FOR_FOLDER_WITH_PROJECT"
}

Replace YOUR_NAME_FOR_ADMIN, YOUR_PASSWORD_FOR_ADMIN, and YOUR_PATH_FOR_FOLDER_WITH_PROJECT with appropriate values. The path value should point to a folder where the project will be stored (e.g., C:\Some_folder\TestBuilder).

Run the main script:

venv\Scripts\python.exe main.py

Contributors:

Front-end: https://github.com/IlyaM1

Back-end: https://github.com/akrisfx

Design: https://github.com/MrMondego

Application Architecture

The Test Builder application consists of three main components:

Front-end (View):

Responsible for rendering the user interface and handling user interactions. The front-end is built using PyQt5.

Back-end (Model):

Contains the business logic and data access layer. The back-end interacts with the database and performs various operations like user authentication, test creation, and test submission.

Database:

Stores user information, tests, and test results. The application uses SQLite as its database.

Application Workflow

The director creates a config.json file with their credentials and the project path.
The director runs the main.py script to start the application.
The director can create tests and add users to the system.
Employees receive their credentials and install the application on their computers.
Employees log in using their credentials and take the assigned tests.
Test results are stored in the database and can be accessed by the director.

Directory Structure

config.json: Configuration file with the director's credentials and project path.
main.py: The main script that starts the application.
View: Contains PyQt5 UI files and related classes.
Model: Contains the back-end logic, data access layer, and related classes.
db: Contains SQLite database files and related modules.
test: Contains test data and related scripts.

Contributing

We welcome contributions to the Test Builder application. To contribute, follow these steps:

Fork the repository.

Create a new branch for your feature or bug fix. Make changes and commit them. Push your changes to your forked repository. Open a pull request against the original repository.

License

The Test Builder application is released under the MIT License. See the LICENSE file for more information.