unisono/specs/002-result-preparation-refactoring/quickstart.md

Quickstart: Result Preparation Refactoring

Date: 2025-10-11 Feature: Result Preparation Refactoring

This document provides instructions on how to run and test the refactored result preparation feature.

Running the Application

1. Start the backend:

   cd backend
   npm install
   npm start
   

2. Start the frontend:

   cd frontend
   npm install
   npm start
   

3. Open a web browser and navigate to http://localhost:3000.

Testing the Feature

1. Create a session: Click on the "Create Session" button. This will generate a unique session URL.
2. Share the session URL: Share the URL with another person (or open it in a new incognito window to simulate another user).
3. Set up the session: As the session creator, set the topic and the number of expected responses.
4. Submit desires: Each participant should fill out the desire form and submit it.
5. View the results: Once all participants have submitted their desires, the system will automatically analyze them and display the categorized results.

Example Test Case

• Participant 1:
  • Wants: "Pizza"
  • Accepts: "Pasta"
  • Doesn't Want: "Salad"
• Participant 2:
  • Wants: "Pizza"
  • Accepts: "Pasta"
  • Doesn't Want: "Tacos"

Expected Result

• Go-to: ["Pizza"]
• Also good: ["Pasta"]
• No-goes: ["Salad", "Tacos"]