Add comprehensive test scripts for various models and services

- Implement tests for RideLocation and CompanyHeadquarters models to verify functionality and data integrity.
- Create a manual trigger test script for trending content calculation endpoint, including authentication and unauthorized access tests.
- Develop a manufacturer sync test to ensure ride manufacturers are correctly associated with ride models.
- Add tests for ParkLocation model, including coordinate setting and distance calculations between parks.
- Implement a RoadTripService test suite covering geocoding, route calculation, park discovery, and error handling.
- Create a unified map service test script to validate map functionality, API endpoints, and performance metrics.

docs/nuxt/planning/requirements.md

@@ -0,0 +1,445 @@
+# 📋 ThrillWiki Nuxt Frontend - Detailed Requirements
+
+**Status:** ✅ COMPLETE  
+**Last Updated:** 2025-01-27 19:55 UTC  
+**Dependencies:** None  
+**Blocks:** All implementation phases  
+
+## 🎯 Project Overview
+
+### Primary Goal
+Create a modern, responsive Nuxt 3 frontend for ThrillWiki that seamlessly integrates with the existing Django REST API backend, providing users with an intuitive interface for discovering, submitting, and moderating theme park and ride content.
+
+### Success Criteria
+1. **Functionality Parity:** All Django backend features accessible through frontend
+2. **Performance:** Sub-3s initial load, sub-1s navigation between pages
+3. **User Experience:** Intuitive, mobile-first design with smooth interactions
+4. **Maintainability:** Clean, documented, testable codebase
+5. **Scalability:** Architecture supports future feature additions
+
+## 🏗️ Technical Requirements
+
+### Framework & Architecture
+- **Frontend Framework:** Nuxt 3 with Vue 3 Composition API
+- **Language:** TypeScript for type safety and better developer experience
+- **State Management:** Pinia for global state management
+- **Component Library:** TBD - Existing reusable component library (user choice)
+- **Styling:** Tailwind CSS (or library's preferred styling system)
+- **Build Tool:** Vite (included with Nuxt 3)
+
+### Authentication & Security
+- **Authentication Method:** JWT with refresh tokens
+- **Token Storage:** HTTP-only cookies for security
+- **Session Management:** Automatic token refresh
+- **Route Protection:** Middleware for protected routes
+- **CSRF Protection:** Integration with Django CSRF tokens
+- **Input Validation:** Client-side validation with server-side verification
+
+### API Integration
+- **Backend API:** Django REST API at `/api/v1/`
+- **HTTP Client:** Nuxt's built-in $fetch with custom composables
+- **Error Handling:** Comprehensive error handling and user feedback
+- **Caching:** Smart caching strategy for API responses
+- **Real-time Updates:** WebSocket integration for live updates (future)
+
+### Performance Requirements
+- **Initial Load:** < 3 seconds on 3G connection
+- **Navigation:** < 1 second between pages
+- **Bundle Size:** < 500KB initial JavaScript bundle
+- **Image Optimization:** Lazy loading and responsive images
+- **SEO:** Server-side rendering for public pages
+
+## 🎨 User Interface Requirements
+
+### Design System
+- **Design Philosophy:** Modern, clean, user-centric interface
+- **Responsive Design:** Mobile-first approach with breakpoints:
+  - Mobile: 320px - 767px
+  - Tablet: 768px - 1023px
+  - Desktop: 1024px+
+- **Accessibility:** WCAG 2.1 AA compliance
+- **Theme Support:** Light/dark mode with system preference detection
+- **Typography:** Clear hierarchy with readable fonts
+- **Color Palette:** Modern, accessible color scheme
+
+### Component Requirements
+- **Reusable Components:** Consistent design system components
+- **Form Components:** Validation, error handling, accessibility
+- **Navigation Components:** Header, sidebar, breadcrumbs, pagination
+- **Data Display:** Cards, tables, lists, galleries
+- **Interactive Components:** Modals, dropdowns, tooltips, tabs
+- **Feedback Components:** Alerts, notifications, loading states
+
+## 🚀 Functional Requirements
+
+### Core Features
+
+#### 1. Authentication System
+**Priority:** High  
+**Description:** Complete user authentication and account management
+
+**Features:**
+- User registration with email verification
+- Login/logout with "remember me" option
+- Password reset via email
+- Profile management (avatar, bio, preferences)
+- Account settings and privacy controls
+- Social authentication (future enhancement)
+
+**Acceptance Criteria:**
+- [ ] Users can register with email and password
+- [ ] Email verification required for new accounts
+- [ ] Secure login/logout with JWT tokens
+- [ ] Password reset functionality works
+- [ ] Profile information can be updated
+- [ ] Account deletion option available
+
+#### 2. Parks Management
+**Priority:** High  
+**Description:** Browse, search, and manage theme park information
+
+**Features:**
+- Parks listing with search and filtering
+- Detailed park pages with photos and information
+- Park submission form for new parks
+- Photo upload and gallery management
+- Reviews and ratings system
+- Location-based search with maps
+
+**Acceptance Criteria:**
+- [ ] Parks can be browsed with pagination
+- [ ] Search works by name, location, operator
+- [ ] Filtering by status, country, operator
+- [ ] Park detail pages show complete information
+- [ ] Users can submit new parks for approval
+- [ ] Photo upload works with moderation queue
+- [ ] Map integration shows park locations
+
+#### 3. Rides Management
+**Priority:** High  
+**Description:** Browse, search, and manage ride information
+
+**Features:**
+- Rides listing with advanced filtering
+- Detailed ride pages with specifications
+- Ride submission form with validation
+- Photo galleries and media management
+- Manufacturer and model information
+- Ride rankings and statistics
+
+**Acceptance Criteria:**
+- [ ] Rides can be browsed and filtered by category
+- [ ] Search works by name, park, manufacturer
+- [ ] Ride specifications displayed clearly
+- [ ] Users can submit new rides
+- [ ] Photo management with approval workflow
+- [ ] Rankings and statistics visible
+
+#### 4. Content Submission System
+**Priority:** High  
+**Description:** User-generated content with moderation workflow
+
+**Features:**
+- Submission forms for parks, rides, photos
+- Draft saving and auto-save functionality
+- Submission status tracking
+- User submission history
+- Collaborative editing (future)
+- Bulk submission tools (admin)
+
+**Acceptance Criteria:**
+- [ ] Users can submit parks and rides
+- [ ] Forms validate input and show errors
+- [ ] Drafts are saved automatically
+- [ ] Users can track submission status
+- [ ] Submission history is accessible
+- [ ] Admins can bulk approve/reject
+
+#### 5. Moderation Interface
+**Priority:** High  
+**Description:** Admin tools for content approval and management
+
+**Features:**
+- Moderation queue with filtering
+- Bulk approval/rejection actions
+- Moderation notes and feedback
+- User reputation system
+- Content flagging and reporting
+- Moderation analytics dashboard
+
+**Acceptance Criteria:**
+- [ ] Moderators can view pending submissions
+- [ ] Bulk actions work for multiple items
+- [ ] Moderation notes can be added
+- [ ] User reputation affects submission priority
+- [ ] Flagged content appears in queue
+- [ ] Analytics show moderation metrics
+
+#### 6. Search & Discovery
+**Priority:** Medium  
+**Description:** Advanced search and content discovery features
+
+**Features:**
+- Global search across parks and rides
+- Autocomplete suggestions
+- Advanced filtering options
+- Trending content section
+- Recently added content
+- Personalized recommendations (future)
+
+**Acceptance Criteria:**
+- [ ] Global search returns relevant results
+- [ ] Autocomplete works as user types
+- [ ] Filters can be combined effectively
+- [ ] Trending content updates regularly
+- [ ] New content is highlighted
+- [ ] Search performance is fast
+
+#### 7. User Profiles & Social Features
+**Priority:** Medium  
+**Description:** User profiles and social interaction features
+
+**Features:**
+- Public user profiles
+- Top lists and favorites
+- User statistics and achievements
+- Following/followers system (future)
+- Activity feeds (future)
+- User-generated content showcase
+
+**Acceptance Criteria:**
+- [ ] User profiles are publicly viewable
+- [ ] Users can create and share top lists
+- [ ] Statistics show user activity
+- [ ] Achievements unlock based on activity
+- [ ] User content is showcased on profile
+- [ ] Privacy settings control visibility
+
+### Advanced Features
+
+#### 8. Photo Management
+**Priority:** Medium  
+**Description:** Comprehensive photo upload and management system
+
+**Features:**
+- Drag-and-drop photo upload
+- Image cropping and editing tools
+- Photo galleries with lightbox
+- Bulk photo operations
+- Photo metadata and tagging
+- Image optimization and CDN
+
+**Acceptance Criteria:**
+- [ ] Photos can be uploaded via drag-and-drop
+- [ ] Basic editing tools available
+- [ ] Galleries display photos attractively
+- [ ] Bulk operations work efficiently
+- [ ] Photos are optimized automatically
+- [ ] CDN integration improves performance
+
+#### 9. Maps Integration
+**Priority:** Medium  
+**Description:** Interactive maps for park and ride locations
+
+**Features:**
+- Interactive park location maps
+- Clustering for dense areas
+- Custom markers and popups
+- Directions integration
+- Mobile-friendly map controls
+- Offline map support (future)
+
+**Acceptance Criteria:**
+- [ ] Maps show accurate park locations
+- [ ] Clustering works for nearby parks
+- [ ] Markers show park information
+- [ ] Directions can be requested
+- [ ] Maps work well on mobile
+- [ ] Performance is acceptable
+
+#### 10. Rankings & Statistics
+**Priority:** Low  
+**Description:** Display and interact with ride ranking system
+
+**Features:**
+- Ride rankings display
+- Ranking history and trends
+- User voting interface (future)
+- Statistical analysis
+- Comparison tools
+- Export functionality
+
+**Acceptance Criteria:**
+- [ ] Rankings display correctly
+- [ ] Historical data is accessible
+- [ ] Statistics are accurate
+- [ ] Comparisons are meaningful
+- [ ] Data can be exported
+- [ ] Performance is good with large datasets
+
+## 🔧 Technical Specifications
+
+### Component Library Options
+**Status:** ⏳ PENDING USER CHOICE
+
+#### Option 1: Nuxt UI (Recommended)
+**Pros:**
+- Built specifically for Nuxt 3
+- Tailwind CSS integration
+- TypeScript support
+- Modern design system
+- Active development
+
+**Cons:**
+- Newer library, smaller ecosystem
+- Limited complex components
+
+#### Option 2: Vuetify
+**Pros:**
+- Mature, comprehensive library
+- Material Design system
+- Extensive component set
+- Strong community support
+
+**Cons:**
+- Larger bundle size
+- Material Design may not fit brand
+- Vue 3 support still maturing
+
+#### Option 3: PrimeVue
+**Pros:**
+- Enterprise-focused
+- Comprehensive component set
+- Good TypeScript support
+- Professional themes
+
+**Cons:**
+- Commercial themes cost money
+- Larger learning curve
+- Less modern design
+
+### Development Environment
+- **Node.js:** Version 18+ required
+- **Package Manager:** npm (consistent with project)
+- **Development Server:** Nuxt dev server with HMR
+- **Proxy Configuration:** API calls proxied to Django backend
+- **Environment Variables:** Separate configs for dev/staging/production
+
+### Build & Deployment
+- **Build Tool:** Nuxt build with Vite
+- **Output:** Static generation for public pages, SSR for dynamic content
+- **Docker:** Multi-stage build for production
+- **CI/CD:** GitHub Actions for automated testing and deployment
+- **Monitoring:** Error tracking and performance monitoring
+
+## 📊 Non-Functional Requirements
+
+### Performance
+- **Page Load Time:** < 3 seconds initial load
+- **Navigation:** < 1 second between pages
+- **API Response Time:** < 500ms for most endpoints
+- **Bundle Size:** < 500KB initial JavaScript
+- **Image Loading:** Progressive loading with placeholders
+
+### Scalability
+- **Concurrent Users:** Support 1000+ concurrent users
+- **Data Volume:** Handle 10,000+ parks and 50,000+ rides
+- **API Calls:** Efficient caching to minimize backend load
+- **Database:** Optimized queries and indexing
+
+### Security
+- **Authentication:** Secure JWT implementation
+- **Data Validation:** Client and server-side validation
+- **XSS Protection:** Sanitized user input
+- **CSRF Protection:** Token-based protection
+- **HTTPS:** All production traffic encrypted
+
+### Accessibility
+- **WCAG Compliance:** Level AA compliance
+- **Keyboard Navigation:** Full keyboard accessibility
+- **Screen Readers:** Proper ARIA labels and roles
+- **Color Contrast:** Minimum 4.5:1 contrast ratio
+- **Focus Management:** Clear focus indicators
+
+### Browser Support
+- **Modern Browsers:** Chrome, Firefox, Safari, Edge (latest 2 versions)
+- **Mobile Browsers:** iOS Safari, Chrome Mobile
+- **Progressive Enhancement:** Basic functionality without JavaScript
+- **Polyfills:** Minimal polyfills for essential features
+
+## 🧪 Testing Requirements
+
+### Testing Strategy
+- **Unit Tests:** 80%+ code coverage for utilities and composables
+- **Component Tests:** All UI components tested
+- **Integration Tests:** API integration and user flows
+- **E2E Tests:** Critical user journeys automated
+- **Performance Tests:** Load testing and optimization
+
+### Testing Tools
+- **Unit Testing:** Vitest for fast unit tests
+- **Component Testing:** Vue Test Utils with Vitest
+- **E2E Testing:** Playwright for cross-browser testing
+- **Visual Testing:** Chromatic for visual regression
+- **Performance Testing:** Lighthouse CI for performance monitoring
+
+## 📚 Documentation Requirements
+
+### Code Documentation
+- **Component Documentation:** Props, events, slots documented
+- **API Documentation:** All composables and utilities documented
+- **Type Definitions:** Comprehensive TypeScript types
+- **Examples:** Usage examples for all components
+- **Storybook:** Interactive component documentation
+
+### User Documentation
+- **User Guide:** How to use the application
+- **Admin Guide:** Moderation and administration
+- **API Guide:** For developers integrating with the system
+- **Deployment Guide:** Self-hosting instructions
+- **Troubleshooting:** Common issues and solutions
+
+### Context7 Integration
+- **Auto-Documentation:** Automatic API and component docs
+- **Implementation Tracking:** Progress and decision documentation
+- **Knowledge Preservation:** Context for future development
+- **LLM Handoffs:** Structured information for continuation
+
+---
+
+## ✅ Acceptance Criteria Summary
+
+### Phase 1: Foundation (Week 1)
+- [ ] Nuxt 3 project set up with TypeScript
+- [ ] Component library integrated and configured
+- [ ] Authentication system implemented with JWT
+- [ ] Basic layout and navigation components
+- [ ] API integration with Django backend
+- [ ] Development environment fully configured
+
+### Phase 2: Core Features (Week 2)
+- [ ] Parks listing and detail pages functional
+- [ ] Rides listing and detail pages functional
+- [ ] Search functionality working across content
+- [ ] Photo upload and display system
+- [ ] User profile management
+- [ ] Basic submission forms
+
+### Phase 3: Advanced Features (Week 3)
+- [ ] Complete submission system with moderation
+- [ ] Admin moderation interface
+- [ ] Advanced search and filtering
+- [ ] Maps integration for locations
+- [ ] Rankings and statistics display
+- [ ] Performance optimization complete
+
+### Phase 4: Polish & Deployment (Week 4)
+- [ ] Comprehensive testing suite
+- [ ] Documentation complete
+- [ ] Production deployment configured
+- [ ] Performance monitoring set up
+- [ ] User acceptance testing passed
+
+---
+
+**Next Document:** `architecture-decisions.md` - Technical architecture details