unisono/tests/unisono-test-plan.md

Unisono Application - Comprehensive Test Plan

Application Overview

The Unisono application facilitates harmonizing desires among participants through real-time collaboration. Users can create sessions, define a topic and optional details, specify the number of expected responses, and then share a link for others to join. The application uses a passphrase for authentication.

Test Scenarios

1. Authentication

1.1 Successful Login with Valid Passphrase

Steps:

1. Navigate to the application URL (e.g., https://unisono.aglink.duckdns.org).
2. On the login page, enter the valid AUTH_PASSPHRASE into the "Passphrase" textbox.
3. Click the "Enter" button.

Expected Results:

• The user is redirected to a new session creation page (e.g., /session/<session-id>).
• The "Harmonize Desires" heading is visible.
• The session creation form (Topic, Details, Number of Expected Responses, Start Session button) is displayed.

1.2 Unsuccessful Login with Invalid Passphrase

Steps:

1. Navigate to the application URL (e.g., https://unisono.aglink.duckdns.org).
2. On the login page, enter an invalid passphrase (e.g., "incorrect-passphrase") into the "Passphrase" textbox.
3. Click the "Enter" button.

Expected Results:

• An error message indicating invalid credentials is displayed.
• The user remains on the login page.

2. Session Creation

2.1 Create Session with Valid Data

Steps:

1. Ensure the user is logged in and on the session creation page.
2. Enter a valid topic (e.g., "Project Alpha Planning") into the "Topic" textbox.
3. Enter optional details (e.g., "Discuss Q4 goals and allocate resources") into the "Details (Optional)" textbox.
4. Enter a valid number of participants (e.g., "3") into the "Number of Expected Responses" spinbutton.
5. Click the "Start Session" button.

Expected Results:

• A new session is created.
• The user is redirected to the active session page.
• The session details (Topic, Details, Number of Expected Responses) are displayed correctly.
• A "Copy Link" button is visible.

2.2 Attempt to Create Session with Missing Topic

Steps:

1. Ensure the user is logged in and on the session creation page.
2. Leave the "Topic" textbox empty.
3. Enter optional details (e.g., "Discuss Q4 goals and allocate resources") into the "Details (Optional)" textbox.
4. Enter a valid number of participants (e.g., "3") into the "Number of Expected Responses" spinbutton.
5. Click the "Start Session" button.

Expected Results:

• An error message indicating that the "Topic" field is required is displayed.
• The session is not created, and the user remains on the session creation page.

2.3 Attempt to Create Session with Invalid Number of Participants (Less than 2)

Steps:

1. Ensure the user is logged in and on the session creation page.
2. Enter a valid topic (e.g., "Project Alpha Planning") into the "Topic" textbox.
3. Enter optional details (e.g., "Discuss Q4 goals and allocate resources") into the "Details (Optional)" textbox.
4. Enter "1" into the "Number of Expected Responses" spinbutton.
5. Click the "Start Session" button.

Expected Results:

• An error message indicating that the number of participants must be at least 2 is displayed.
• The session is not created, and the user remains on the session creation page.

2.4 Attempt to Create Session with Invalid Number of Participants (More than 12)

Steps:

1. Ensure the user is logged in and on the session creation page.
2. Enter a valid topic (e.g., "Project Alpha Planning") into the "Topic" textbox.
3. Enter optional details (e.g., "Discuss Q4 goals and allocate resources") into the "Details (Optional)" textbox.
4. Enter "13" into the "Number of Expected Responses" spinbutton.
5. Click the "Start Session" button.

Expected Results:

• An error message indicating that the number of participants cannot exceed 12 is displayed.
• The session is not created, and the user remains on the session creation page.

3. Copy Link Feature

3.1 Verify Copy Link Button Functionality

Steps:

1. Ensure a session has been successfully created and the user is on the active session page.
2. Click the "Copy Link" button.

Expected Results:

• A success message (e.g., "Link copied to clipboard!") is displayed.
• The session URL is copied to the clipboard.