# Ride Reviews Feature

## Overview
The ride reviews system allows users to rate and review rides, providing both numerical ratings and textual feedback. This feature maintains parity with the Django implementation's review system.

## Database Schema

### reviews Table
- id (primary key)
- ride_id (foreign key to rides)
- user_id (foreign key to users)
- rating (integer, 1-5)
- title (string, optional)
- content (text)
- created_at (timestamp)
- updated_at (timestamp)
- moderated_at (timestamp, nullable)
- moderated_by (foreign key to users, nullable)
- status (enum: pending, approved, rejected)

### helpful_votes Table
- id (primary key)
- review_id (foreign key to reviews)
- user_id (foreign key to users)
- created_at (timestamp)

## Components to Implement

### RideReviewComponent
- Display review form
- Handle review submission
- Validate input
- Show success/error messages

### RideReviewListComponent
- Display reviews for a ride
- Pagination support
- Sorting options
- Helpful vote functionality
- Filter options (rating, date)

### ReviewModerationComponent
- Review queue for moderators
- Approve/reject functionality
- Edit capabilities
- Status tracking

## Features Required

1. Review Creation
   - Rating input (1-5 stars)
   - Title field (optional)
   - Content field
   - Client & server validation
   - Anti-spam measures

2. Review Display
   - List/grid view of reviews
   - Sorting by date/rating
   - Pagination
   - Rating statistics
   - Helpful vote system

3. Moderation System
   - Review queue
   - Approval workflow
   - Edit capabilities
   - Status management
   - Moderation history

4. User Features
   - One review per ride per user
   - Edit own reviews
   - Delete own reviews
   - Vote on helpful reviews

5. Statistics
   - Average rating calculation
   - Rating distribution
   - Review count tracking
   - Helpful vote tallying

## Implementation Steps

1. Database Setup ✅
   - ✅ Created migrations for reviews table (2024_02_25_203100_create_reviews_table.php)
   - ✅ Created migrations for helpful_votes table (2024_02_25_203200_create_helpful_votes_table.php)
   - ✅ Added proper indexes and constraints
   - ✅ Set up foreign key relationships

2. Models & Relations ✅
   - ✅ Review model with relationships, scopes, and methods (app/Models/Review.php)
   - ✅ HelpfulVote model with toggle functionality (app/Models/HelpfulVote.php)
   - ✅ Added review relationships to Ride model (app/Models/Ride.php)
   - ✅ Created ReviewStatus enum (app/Enums/ReviewStatus.php)
   - ✅ Implemented methods for average rating and review counts

3. Components
   - Review form component
   - Review list component
   - Moderation component
   - Statistics display

4. Business Logic
   - Rating calculations
   - Permission checks
   - Validation rules
   - Anti-spam measures

5. Testing
   - Unit tests
   - Feature tests
   - Integration tests
   - User flow testing

## Security Considerations

1. Authorization
   - User authentication required
   - Rate limiting
   - Moderation permissions
   - Edit/delete permissions

2. Data Validation
   - Input sanitization
   - Rating range validation
   - Content length limits
   - Duplicate prevention

3. Anti-Abuse
   - Rate limiting
   - Spam detection
   - Vote manipulation prevention
   - Multiple account detection

## Implementation Details

### Model Implementation

The review system consists of two main models:

1. Review - Represents a user's review of a ride
   - Implemented in `app/Models/Review.php`
   - Uses ReviewStatus enum for status management
   - Includes scopes for filtering (pending, approved, rejected)
   - Provides methods for moderation and helpful vote management
   - Maintains counter cache for helpful votes

2. HelpfulVote - Represents a user marking a review as helpful
   - Implemented in `app/Models/HelpfulVote.php`
   - Simple model with relationships to Review and User
   - Includes static toggle method for easy vote management

3. Ride Model Enhancements
   - Added review relationships to Ride model
   - Implemented methods for average rating calculation
   - Added review count accessor
   - Created canBeReviewedBy method to check if a user can review a ride
   - Implemented addReview method for creating new reviews

These models follow Laravel's Eloquent ORM patterns while maintaining feature parity with the Django implementation.