bhavik-goplani / rps-survey

🔬 The RPS Survey Platform facilitates research on decision-making dynamics in Rock-Paper-Scissors, exploring programmed probabilities and the generalized matching law to understand player behavior effectively.

Overview

The RPS Survey Platform is a web application designed to facilitate research into human decision-making processes, specifically within the context of the Rock/Paper/Scissors (RPS) game. This platform serves as a critical tool for the Applied Behavioral Science Lab at KU, enabling the exploration of the generalized matching law — a principle that describes how individuals allocate their responses in situations where they are presented with concurrent choices.

The research conducted through this platform involves adult human subjects participating in a simulated RPS game against a computerized opponent. The opponent's responses are based on programmed probabilities that vary across different blocks of trials, allowing researchers to observe and analyze patterns in human response allocation.

The platform addresses the needs of researchers in conducting surveys and collecting data from participants. It provides a user-friendly interface for researchers to create surveys, analyze results, and manage participants. Additionally, participants can access the platform to take surveys and contribute data. Below, you'll find information about the project, including its features, database schema, and usage flow.

Note: This project was built for the Applied Behavioral Science Lab at KU to conduct the generalized matching law research.

Features

• Survey Creation: Researchers can create and customize surveys according to their research needs.
• Participant Management: Researchers can manage participants, including creation and deletion.
• Role-Based Authentication: Implemented role-based authentication to provide different access levels for researchers and participants.
• Data Collection: Utilized local storage and periodic batch data saving to ensure smooth data collection.
• Data Analysis: Provides a view in Postgres to export as a CSV and perform data analysis.

Database Schema

Below is the schema of the PostgreSQL database used in the project:

Flow of the Research Platform

1. Requirements Gathering: Identified three main challenges - data integrity, participant user experience, and enabling participant access to the platform.
2. Database Modeling: Utilized data normalization techniques to ensure data integrity, scalability, and simplified querying process.
3. Role-Based Authentication: The platform implements role-based authentication with two roles: researcher and participant. This is managed in the auth schema of PostgreSQL, with two functions for creating and deleting participants. This gives role-based access to the API endpoints and database tables, ensuring that participants can access the platform to take part in surveys.
4. Researcher point of view: Created a user-friendly dashboard for researchers to create surveys and links for participants.
5. Participant point of view: Participants get an email with credentials to log in and participate in the survey. Data gets saved in local storage and is periodically sent in batches to the database even in the event of browser closure or interruptions.
6. Deployment: The project is built using Next.js & Supabase and hosted using Vercel at RPS Survey App

Technologies Used

• Next.js
• PostgreSQL
• Supabase
• React
• Typescript
• HTML/CSS

rps-survey's Issues

Loading animation for submit

fb5ade0 : Added loading icon

Thank you page did not load

13f824a Fix thank you page. Loads for 5 seconds and signs out the user

User should not be able to go back on the thank you page

56ef1de : Fixed using submission flag in local storage

Datapoints after submission not added to database

The reason can be that the save function is not triggered when you click submit and it directly deletes the user