thrillwiki_django_no_react/source_docs/SITE_OVERVIEW.md

# ThrillWiki Site Overview

> The Ultimate Theme Park & Roller Coaster Database

ThrillWiki is a comprehensive, community-driven platform for theme park enthusiasts to discover, document, and celebrate the world's attractions.

---

## Mission Statement

To be the definitive source for accurate, community-verified information about theme parks, rides, and the companies that create them.

---

## Site Map

```
ThrillWiki
├── 🏠 Homepage
│   ├── Hero Search
│   ├── Discovery Tabs (11 categories)
│   └── Recent Changes Feed
│
├── 🎢 Parks
│   ├── /parks - All Parks Listing
│   ├── /parks/nearby - Location-Based Discovery
│   └── /parks/{slug} - Individual Park Pages
│       ├── Overview Tab
│       ├── Rides Tab
│       ├── Reviews Tab
│       ├── Photos Tab
│       └── History Tab
│
├── 🎠 Rides
│   ├── /rides - All Rides Listing
│   └── /parks/{park}/rides/{ride} - Individual Ride Pages
│       ├── Overview Tab
│       ├── Specifications Tab
│       ├── Reviews Tab
│       ├── Photos Tab
│       └── History Tab
│
├── 🏭 Companies
│   ├── /manufacturers - Ride Manufacturers
│   ├── /designers - Ride Designers
│   ├── /operators - Park Operators
│   └── /owners - Property Owners
│
├── 📋 Ride Models
│   └── /ride-models/{slug} - Standard Ride Designs
│
├── 🔍 Search
│   └── /search - Global Search with Filters
│
├── 👤 User Features
│   ├── /auth - Sign In / Sign Up
│   ├── /profile/{username} - Public Profiles
│   ├── /settings - Account Settings
│   ├── /my-credits - Ride Credits Dashboard
│   └── /my-lists - Personal Rankings
│
├── ✏️ Contribution
│   ├── /submit/* - Content Submission Forms
│   └── /my-submissions - Submission History
│
├── 🛡️ Moderation
│   ├── /moderation - Queue Dashboard
│   └── /moderation/{id} - Review Interface
│
├── ⚙️ Admin
│   ├── /admin - Dashboard
│   ├── /admin/users - User Management
│   ├── /admin/monitoring - System Health
│   └── /admin/errors - Error Tracking
│
└── 📄 Static Pages
    ├── /terms - Terms of Service
    ├── /privacy - Privacy Policy
    ├── /guidelines - Community Guidelines
    ├── /contact - Contact Form
    └── /blog - News & Updates
```

---

## Core Features

### 1. Discovery & Exploration

| Feature | Description |
|---------|-------------|
| **Global Search** | Find any park, ride, or company instantly |
| **Parks Nearby** | Location-based discovery with interactive map |
| **Advanced Filters** | Filter by type, status, location, specifications |
| **Discovery Tabs** | 11 curated categories on homepage |
| **Trending Content** | See what's popular in the community |

### 2. Content & Information

| Feature | Description |
|---------|-------------|
| **Detailed Park Pages** | Complete information, photos, reviews |
| **Comprehensive Ride Specs** | Technical details in user's preferred units |
| **Company Profiles** | Manufacturers, designers, operators |
| **Ride Models** | Standard designs with all installations |
| **Photo Galleries** | Community-uploaded imagery |
| **Historical Records** | Track changes over time |

### 3. Community Features

| Feature | Description |
|---------|-------------|
| **Reviews & Ratings** | Share experiences with star ratings |
| **Ride Credits** | Log rides you've experienced |
| **Personal Lists** | Create and share rankings |
| **Leaderboards** | Recognition for top contributors |
| **Badges** | Achievement system |

### 4. Contribution System

| Feature | Description |
|---------|-------------|
| **Submit New Content** | Add parks, rides, companies |
| **Edit Existing** | Suggest improvements |
| **Photo Uploads** | Share your images |
| **Moderation Queue** | Quality review process |
| **Version History** | Track all changes |

---

## User Roles

### Anonymous Visitors
- Browse all public content
- Use search and filters
- View photos and reviews
- See ride specifications

### Registered Users
- All anonymous features, plus:
- Write reviews and ratings
- Log ride credits
- Create personal lists
- Upload photos
- Submit new content
- Edit existing content

### Contributors
- All registered features, plus:
- Higher submission trust
- Skip moderation for minor edits
- Recognition on leaderboards

### Moderators
- All contributor features, plus:
- Access moderation queue
- Approve/reject submissions
- Review photos
- Manage content quality

### Administrators
- All moderator features, plus:
- User management
- System configuration
- Error monitoring
- Database maintenance

---

## Key User Journeys

### Discovery Journey
```
Homepage → Search/Browse → Park/Ride Page → Explore Related Content
```

### Engagement Journey
```
View Content → Sign Up → Write Review → Log Credit → Create List
```

### Contribution Journey
```
Find Missing Info → Submit Edit → Await Moderation → See Changes Live
```

### Recognition Journey
```
Contribute Content → Earn Points → Climb Leaderboard → Earn Badges
```

---

## Content Statistics (Typical)

| Content Type | Description |
|--------------|-------------|
| Parks | Theme parks, amusement parks, water parks worldwide |
| Rides | Roller coasters, flat rides, water rides, dark rides |
| Companies | Manufacturers, designers, operators, owners |
| Reviews | User experiences and ratings |
| Photos | Community-uploaded images |
| Ride Credits | Personal ride experiences logged |

---

## Platform Availability

| Platform | Status |
|----------|--------|
| Web (Desktop) | ✅ Full Experience |
| Web (Tablet) | ✅ Responsive Design |
| Web (Mobile) | ✅ Touch-Optimized |
| Native Apps | ❌ Not Available |

---

## Accessibility

- Full keyboard navigation
- Screen reader compatible
- High contrast support
- Respects reduced motion preferences
- Touch-friendly on mobile

---

## Internationalization

| Feature | Status |
|---------|--------|
| Language | English only |
| Units | Metric/Imperial toggle |
| Dates | Localized formatting |
| Currency | Not applicable |

---

## Next Steps

- [Design System](./DESIGN_SYSTEM.md) - Visual identity and styling
- [Pages Guide](./PAGES.md) - Detailed page documentation
- [Components](./COMPONENTS.md) - UI component library
- [User Flows](./USER_FLOWS.md) - Journey diagrams