Add autocomplete functionality for parks: implement URLs, views, and templates for real-time suggestions

.clinerules

@@ -0,0 +1,43 @@
+# Project Startup Rules
+
+## Development Server
+IMPORTANT: Always follow these instructions exactly when starting the development server:
+
+```bash
+lsof -ti :8000 | xargs kill -9; find . -type d -name "__pycache__" -exec rm -r {} +; uv run manage.py tailwind runserver
+```
+
+Note: These steps must be executed in this exact order as a single command to ensure consistent behavior.
+
+## Package Management
+IMPORTANT: When a Python package is needed, only use UV to add it:
+```bash
+uv add <package>
+```
+Do not attempt to install packages using any other method.
+
+## Django Management Commands
+IMPORTANT: When running any Django manage.py commands (migrations, shell, etc.), always use UV:
+```bash
+uv run manage.py <command>
+```
+This applies to all management commands including but not limited to:
+- Making migrations: `uv run manage.py makemigrations`
+- Applying migrations: `uv run manage.py migrate`
+- Creating superuser: `uv run manage.py createsuperuser`
+- Starting shell: `uv run manage.py shell`
+
+NEVER use `python manage.py` or `uv run python manage.py`. Always use `uv run manage.py` directly.
+
+## Static Files Management
+IMPORTANT: All static files must be placed in the `static/` directory, not `staticfiles/`. The `staticfiles/` directory is reserved for Django's collectstatic command output and should not be used directly.
+
+This consolidation:
+1. Follows Django best practices of separating source static files from collected files
+2. Prevents confusion between development and production static file locations
+3. Makes it clear which static files are part of the source code (static/) versus compiled/collected (staticfiles/)
+
+When adding new static files:
+- Add them to `static/` directory
+- Use Django's `static` template tag to reference them
+- Run `uv run manage.py collectstatic` when deploying

accounts/migrations/0002_remove_toplistitem_insert_insert_and_more.py

@@ -0,0 +1,93 @@
+# Generated by Django 5.1.4 on 2025-02-21 17:55
+
+import django.utils.timezone
+import pgtrigger.compiler
+import pgtrigger.migrations
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("accounts", "0001_initial"),
+    ]
+
+    operations = [
+        pgtrigger.migrations.RemoveTrigger(
+            model_name="toplistitem",
+            name="insert_insert",
+        ),
+        pgtrigger.migrations.RemoveTrigger(
+            model_name="toplistitem",
+            name="update_update",
+        ),
+        migrations.AddField(
+            model_name="toplistitem",
+            name="created_at",
+            field=models.DateTimeField(
+                auto_now_add=True, default=django.utils.timezone.now
+            ),
+            preserve_default=False,
+        ),
+        migrations.AddField(
+            model_name="toplistitem",
+            name="updated_at",
+            field=models.DateTimeField(auto_now=True),
+        ),
+        migrations.AddField(
+            model_name="toplistitemevent",
+            name="created_at",
+            field=models.DateTimeField(
+                auto_now_add=True, default=django.utils.timezone.now
+            ),
+            preserve_default=False,
+        ),
+        migrations.AddField(
+            model_name="toplistitemevent",
+            name="updated_at",
+            field=models.DateTimeField(auto_now=True),
+        ),
+        migrations.AlterField(
+            model_name="toplist",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="toplistitem",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+        pgtrigger.migrations.AddTrigger(
+            model_name="toplistitem",
+            trigger=pgtrigger.compiler.Trigger(
+                name="insert_insert",
+                sql=pgtrigger.compiler.UpsertTriggerSql(
+                    func='INSERT INTO "accounts_toplistitemevent" ("content_type_id", "created_at", "id", "notes", "object_id", "pgh_context_id", "pgh_created_at", "pgh_label", "pgh_obj_id", "rank", "top_list_id", "updated_at") VALUES (NEW."content_type_id", NEW."created_at", NEW."id", NEW."notes", NEW."object_id", _pgh_attach_context(), NOW(), \'insert\', NEW."id", NEW."rank", NEW."top_list_id", NEW."updated_at"); RETURN NULL;',
+                    hash="[AWS-SECRET-REMOVED]",
+                    operation="INSERT",
+                    pgid="pgtrigger_insert_insert_56dfc",
+                    table="accounts_toplistitem",
+                    when="AFTER",
+                ),
+            ),
+        ),
+        pgtrigger.migrations.AddTrigger(
+            model_name="toplistitem",
+            trigger=pgtrigger.compiler.Trigger(
+                name="update_update",
+                sql=pgtrigger.compiler.UpsertTriggerSql(
+                    condition="WHEN (OLD.* IS DISTINCT FROM NEW.*)",
+                    func='INSERT INTO "accounts_toplistitemevent" ("content_type_id", "created_at", "id", "notes", "object_id", "pgh_context_id", "pgh_created_at", "pgh_label", "pgh_obj_id", "rank", "top_list_id", "updated_at") VALUES (NEW."content_type_id", NEW."created_at", NEW."id", NEW."notes", NEW."object_id", _pgh_attach_context(), NOW(), \'update\', NEW."id", NEW."rank", NEW."top_list_id", NEW."updated_at"); RETURN NULL;',
+                    hash="[AWS-SECRET-REMOVED]",
+                    operation="UPDATE",
+                    pgid="pgtrigger_update_update_2b6e3",
+                    table="accounts_toplistitem",
+                    when="AFTER",
+                ),
+            ),
+        ),
+    ]

autocomplete/__init__.py

@@ -0,0 +1,49 @@
+default_app_config = 'autocomplete.apps.AutocompleteConfig'
+
+from django.db import models
+from django.core.exceptions import ImproperlyConfigured
+from django.forms.widgets import Widget
+from django.template.loader import render_to_string
+
+
+class ModelAutocomplete:
+    """Base class for model-based autocomplete."""
+    model = None  # Model class to use for autocomplete
+    search_attrs = []  # List of model attributes to search
+    minimum_search_length = 2  # Minimum length of search string
+    max_results = 10  # Maximum number of results to return
+
+    def __init__(self):
+        if not self.model:
+            raise ImproperlyConfigured("ModelAutocomplete requires a model class")
+        if not self.search_attrs:
+            raise ImproperlyConfigured("ModelAutocomplete requires search_attrs")
+
+    def get_search_results(self, search):
+        """Return search results for a given search string."""
+        raise NotImplementedError("Subclasses must implement get_search_results()")
+
+    def format_result(self, obj):
+        """Format a single result object."""
+        raise NotImplementedError("Subclasses must implement format_result()")
+
+
+class AutocompleteWidget(Widget):
+    """Widget for autocomplete fields."""
+    template_name = 'autocomplete/widget.html'
+
+    def __init__(self, ac_class, attrs=None):
+        super().__init__(attrs)
+        if not issubclass(ac_class, ModelAutocomplete):
+            raise ImproperlyConfigured("ac_class must be a subclass of ModelAutocomplete")
+        self.ac_class = ac_class
+
+    def get_context(self, name, value, attrs):
+        context = super().get_context(name, value, attrs)
+        # Add ac_name for URL resolution
+        context['ac_name'] = self.ac_class.__name__.lower()
+        return context
+
+    def render(self, name, value, attrs=None, renderer=None):
+        context = self.get_context(name, value, attrs)
+        return render_to_string(self.template_name, context)

autocomplete/apps.py

@@ -0,0 +1,25 @@
+from django.apps import AppConfig
+
+
+class AutocompleteConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'autocomplete'
+    
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self._registry = {}
+    
+    def ready(self):
+        """Register all autocomplete classes."""
+        from parks.forms import ParkAutocomplete
+        
+        # Register autocomplete classes
+        self.register_autocomplete('park', ParkAutocomplete)
+    
+    def register_autocomplete(self, name, ac_class):
+        """Register an autocomplete class."""
+        self._registry[name] = ac_class
+    
+    def get_autocomplete_class(self, name):
+        """Get an autocomplete class by name."""
+        return self._registry.get(name)

autocomplete/templates/autocomplete/suggestions.html

@@ -0,0 +1,20 @@
+{% if results %}
+<ul class="py-1 overflow-auto max-h-60" role="listbox">
+    {% for result in results %}
+    <li class="px-4 py-2 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer"
+        role="option"
+        @click="selectedId = '{{ result.key }}'; query = '{{ result.label }}'; $refs.filterForm.requestSubmit()">
+        <div class="flex flex-col">
+            <span class="font-medium">{{ result.label }}</span>
+            {% if result.extra %}
+            <span class="text-sm text-gray-500 dark:text-gray-400">{{ result.extra }}</span>
+            {% endif %}
+        </div>
+    </li>
+    {% endfor %}
+</ul>
+{% else %}
+<div class="px-4 py-2 text-gray-500 dark:text-gray-400">
+    No results found
+</div>
+{% endif %}

autocomplete/templates/autocomplete/widget.html

@@ -0,0 +1,38 @@
+{% load static %}
+
+<div class="relative" x-data="{ query: '', selectedId: null }">
+    <input type="text"
+           name="{{ widget.name }}_search"
+           placeholder="{{ widget.attrs.placeholder|default:'Search...' }}"
+           class="{{ widget.attrs.class }}"
+           x-model="query"
+           @keydown.escape="query = ''"
+           hx-get="{% url 'autocomplete:items' ac_name %}"
+           hx-trigger="input changed delay:300ms"
+           hx-target="#{{ widget.name }}-suggestions"
+           hx-indicator="#{{ widget.name }}-indicator">
+
+    <input type="hidden"
+           name="{{ widget.name }}"
+           x-model="selectedId">
+
+    <!-- Loading indicator -->
+    <div id="{{ widget.name }}-indicator"
+         class="htmx-indicator absolute right-3 top-1/2 -translate-y-1/2"
+         role="status"
+         aria-label="Loading search results">
+        <svg class="w-5 h-5 text-gray-400 animate-spin" viewBox="0 0 24 24">
+            <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4" fill="none"/>
+            <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"/>
+        </svg>
+        <span class="sr-only">Searching...</span>
+    </div>
+
+    <!-- Suggestions dropdown -->
+    <div id="{{ widget.name }}-suggestions"
+         class="absolute z-50 mt-1 w-full bg-white dark:bg-gray-800 rounded-md shadow-lg"
+         role="listbox"
+         style="display: none;"
+         x-show="query.length > 0">
+    </div>
+</div>

autocomplete/urls.py

@@ -0,0 +1,9 @@
+from django.urls import path
+from . import views
+
+app_name = 'autocomplete'
+
+urlpatterns = [
+    path('<str:ac_name>/items/', views.items, name='items'),
+    path('<str:ac_name>/toggle/', views.toggle, name='toggle'),
+]

autocomplete/views.py

@@ -0,0 +1,52 @@
+from django.http import JsonResponse, HttpResponse
+from django.shortcuts import get_object_or_404, render
+from django.apps import apps
+from django.core.exceptions import ImproperlyConfigured
+
+def items(request, ac_name):
+    """Return autocomplete items for a given autocomplete class."""
+    try:
+        # Get the autocomplete class from the registry
+        ac_class = apps.get_app_config('autocomplete').get_autocomplete_class(ac_name)
+        if not ac_class:
+            raise ImproperlyConfigured(f"No autocomplete class found for {ac_name}")
+        
+        # Create instance and get results
+        ac = ac_class()
+        search = request.GET.get('search', '')
+        
+        # Check minimum search length
+        if len(search) < ac.minimum_search_length:
+            return HttpResponse('')
+        
+        # Get and format results
+        results = ac.get_search_results(search)[:ac.max_results]
+        formatted_results = [ac.format_result(obj) for obj in results]
+        
+        # Render suggestions template
+        return render(request, 'autocomplete/suggestions.html', {
+            'results': formatted_results
+        })
+    except Exception as e:
+        return HttpResponse(str(e), status=400)
+
+def toggle(request, ac_name):
+    """Toggle selection state for an autocomplete item."""
+    try:
+        # Get the autocomplete class from the registry
+        ac_class = apps.get_app_config('autocomplete').get_autocomplete_class(ac_name)
+        if not ac_class:
+            raise ImproperlyConfigured(f"No autocomplete class found for {ac_name}")
+        
+        # Create instance and handle toggle
+        ac = ac_class()
+        item_id = request.POST.get('id')
+        if not item_id:
+            raise ValueError("No item ID provided")
+        
+        # Get the object and format it
+        obj = get_object_or_404(ac.model, pk=item_id)
+        result = ac.format_result(obj)
+        return JsonResponse(result)
+    except Exception as e:
+        return JsonResponse({'error': str(e)}, status=400)

companies/migrations/0002_alter_company_id_alter_manufacturer_id.py

@@ -0,0 +1,27 @@
+# Generated by Django 5.1.4 on 2025-02-21 17:55
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("companies", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="company",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="manufacturer",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+    ]

core/forms.py

@@ -0,0 +1,39 @@
+"""Core forms and form components."""
+from django.conf import settings
+from django.core.exceptions import PermissionDenied
+from django.utils.translation import gettext_lazy as _
+
+from autocomplete import Autocomplete
+
+
+class BaseAutocomplete(Autocomplete):
+    """Base autocomplete class for consistent autocomplete behavior across the project.
+    
+    This class extends django-htmx-autocomplete's base Autocomplete class to provide:
+    - Project-wide defaults for autocomplete behavior
+    - Translation strings
+    - Authentication enforcement
+    - Sensible search configuration
+    """
+    # Search configuration
+    minimum_search_length = 2  # More responsive than default 3
+    max_results = 10  # Reasonable limit for performance
+
+    # UI text configuration using gettext for i18n
+    no_result_text = _("No matches found")
+    narrow_search_text = _("Showing %(page_size)s of %(total)s matches. Please refine your search.")
+    type_at_least_n_characters = _("Type at least %(n)s characters...")
+
+    # Project-wide component settings
+    placeholder = _("Search...")
+
+    @staticmethod
+    def auth_check(request):
+        """Enforce authentication by default.
+        
+        This can be overridden in subclasses if public access is needed.
+        Configure AUTOCOMPLETE_BLOCK_UNAUTHENTICATED in settings to disable.
+        """
+        block_unauth = getattr(settings, 'AUTOCOMPLETE_BLOCK_UNAUTHENTICATED', True)
+        if block_unauth and not request.user.is_authenticated:
+            raise PermissionDenied(_("Authentication required"))

designers/migrations/0002_alter_designer_id.py

@@ -0,0 +1,20 @@
+# Generated by Django 5.1.4 on 2025-02-21 17:55
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("designers", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="designer",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+    ]

email_service/migrations/0002_alter_emailconfiguration_id.py

@@ -0,0 +1,20 @@
+# Generated by Django 5.1.4 on 2025-02-21 17:55
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("email_service", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="emailconfiguration",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+    ]

history_tracking/migrations/0002_rename_history_tra_content_1234ab_idx_history_tra_content_63013c_idx_and_more.py

@@ -0,0 +1,28 @@
+# Generated by Django 5.1.4 on 2025-02-21 17:55
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("history_tracking", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.RenameIndex(
+            model_name="historicalslug",
+            new_name="history_tra_content_63013c_idx",
+            old_name="history_tra_content_1234ab_idx",
+        ),
+        migrations.RenameIndex(
+            model_name="historicalslug",
+            new_name="history_tra_slug_f843aa_idx",
+            old_name="history_tra_slug_1234ab_idx",
+        ),
+        migrations.AlterField(
+            model_name="historicalslug",
+            name="created_at",
+            field=models.DateTimeField(auto_now_add=True),
+        ),
+    ]

location/migrations/0002_alter_location_id.py

@@ -0,0 +1,20 @@
+# Generated by Django 5.1.4 on 2025-02-21 17:55
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("location", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="location",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+    ]

media/migrations/0002_alter_photo_id.py

@@ -0,0 +1,20 @@
+# Generated by Django 5.1.4 on 2025-02-21 17:55
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("media", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="photo",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+    ]

memory-bank/activeContext.md

@@ -1,28 +1,74 @@
-# Active Context - Park View Modularization
+# Active Development Context
 
-**Objective:** Refactor parks view to use reusable card component and implement grid/list view toggle
+## Recently Completed
 
-**Current Implementation Analysis:**
-- Park cards rendered via `park_list_item.html` partial
-- Existing layout uses flex-based list structure
-- Search functionality uses HTMX for dynamic updates
+### Park Search Implementation (2024-02-22)
 
-**Planned Changes:**
-1. **Create `park_card.html` Partial**
-   - Extract card markup from `park_list_item.html`
-   - Add responsive grid/list view classes
-   - Include view mode toggle state
+1. Autocomplete Base:
+   - Created BaseAutocomplete in core/forms.py
+   - Configured project-wide auth requirement
+   - Added test coverage for base functionality
 
-2. **View Toggle Implementation**
-   - Add grid/list toggle UI with HTMX
-   - Store view preference in cookie/localStorage
-   - Update CSS for grid (grid-cols) vs list (flex) layouts
+2. Park Search:
+   - Implemented ParkAutocomplete class
+   - Created ParkSearchForm with autocomplete widget
+   - Updated views and templates for integration
+   - Added comprehensive test suite
 
-3. **Backend Updates**
-   - Add view_mode parameter to park list view
-   - Modify context processor to handle layout preference
+3. Documentation:
+   - Updated memory-bank/features/parks/search.md
+   - Added test documentation
+   - Created user interface guidelines
 
-**Next Steps:**
-- Implement card partial with responsive classes
-- Create view toggle component
-- Update HTMX handlers to preserve view mode
+## Active Tasks
+
+1. Testing:
+   - [ ] Run the test suite with `uv run pytest parks/tests/`
+   - [ ] Monitor test coverage with pytest-cov
+   - [ ] Verify HTMX interactions work as expected
+
+2. Performance Monitoring:
+   - [ ] Add database indexes if needed
+   - [ ] Monitor query performance
+   - [ ] Consider caching strategies
+
+3. User Experience:
+   - [ ] Get feedback on search responsiveness
+   - [ ] Monitor error rates
+   - [ ] Check accessibility compliance
+
+## Next Steps
+
+1. Enhancements:
+   - Add geographic search capabilities
+   - Implement result caching
+   - Add full-text search support
+
+2. Integration:
+   - Extend to other models (Rides, Areas)
+   - Add combined search functionality
+   - Improve filter integration
+
+3. Testing:
+   - Add Playwright e2e tests
+   - Implement performance benchmarks
+   - Add accessibility tests
+
+## Technical Debt
+
+None currently identified for the search implementation.
+
+## Dependencies
+
+- django-htmx-autocomplete
+- pytest-django
+- pytest-cov
+
+## Notes
+
+The implementation follows these principles:
+- Authentication-first approach
+- Performance optimization
+- Accessibility compliance
+- Test coverage
+- Clean documentation

memory-bank/decisions/laravel_migration_analysis.md

@@ -0,0 +1,254 @@
+# Laravel Migration Analysis
+
+## Executive Summary
+
+After thorough analysis of the ThrillWiki Django codebase, this document presents a comprehensive evaluation of migrating to Laravel. The analysis considers technical compatibility, implementation impact, and business implications.
+
+### Quick Overview
+
+**Current Stack:**
+- Framework: Django (MVT Architecture)
+- Frontend: HTMX + AlpineJS + Tailwind CSS
+- Database: PostgreSQL with Django ORM
+- Authentication: Django Built-in Auth
+
+**Recommendation:** ⛔️ DO NOT PROCEED with Laravel migration
+
+The analysis reveals that the costs, risks, and disruption of migration outweigh potential benefits, particularly given the project's mature Django codebase and specialized features.
+
+## Technical Analysis
+
+### Core Functionality Compatibility
+
+#### Data Model Migration Complexity: HIGH
+- Complex Django models with inheritance (TrackedModel)
+- Custom user model with role-based permissions
+- Extensive use of Django-specific model features
+- Migration challenges:
+  * Different ORM paradigms
+  * Custom model behaviors
+  * Signal system reimplementation
+  * Complex queries and annotations
+
+#### Authentication System: HIGH
+- Currently leverages Django's auth framework extensively
+- Custom adapters for social authentication
+- Role-based permission system
+- Migration challenges:
+  * Laravel's auth system differs fundamentally
+  * Custom middleware rewrites needed
+  * Session handling differences
+  * Social auth integration rework
+
+#### Template Engine: MEDIUM
+- Heavy use of Django template inheritance
+- HTMX integration for dynamic updates
+- Migration challenges:
+  * Blade syntax differences
+  * Different template inheritance patterns
+  * HTMX integration patterns
+  * Custom template tags rewrite
+
+#### ORM and Database Layer: VERY HIGH
+- Extensive use of Django ORM features
+- Complex model relationships
+- Custom model managers
+- Migration challenges:
+  * Different query builder syntax
+  * Relationship definition differences
+  * Transaction handling variations
+  * Custom field type conversions
+
+### Architecture Impact
+
+#### Routing and Middleware: HIGH
+- Complex URL patterns with nested resources
+- Custom middleware for analytics and tracking
+- Migration challenges:
+  * Different routing paradigms
+  * Middleware architecture differences
+  * Request/Response cycle variations
+
+#### File Structure Changes: MEDIUM
+- Current Django apps need restructuring
+- Different convention requirements
+- Migration challenges:
+  * Resource organization
+  * Namespace handling
+  * Service provider implementation
+
+#### API and Service Layer: HIGH
+- Custom API implementation
+- Complex service layer integration
+- Migration challenges:
+  * Different API architecture
+  * Service container differences
+  * Dependency injection patterns
+
+## Implementation Impact
+
+### Development Timeline
+Estimated timeline: 4-6 months minimum
+- Phase 1 (Data Layer): 6-8 weeks
+- Phase 2 (Business Logic): 8-10 weeks
+- Phase 3 (Frontend Integration): 4-6 weeks
+- Phase 4 (Testing & Deployment): 4-6 weeks
+
+### Resource Requirements
+- 2-3 Senior Laravel Developers
+- 1 DevOps Engineer
+- 1 QA Engineer
+- Project Manager
+
+### Testing Strategy Updates
+- Complete test suite rewrite needed
+- New testing frameworks required
+- Integration test complexity
+- Performance testing rework
+
+### Deployment Modifications
+- CI/CD pipeline updates
+- Environment configuration changes
+- Server requirement updates
+- Monitoring system adjustments
+
+## Business Impact
+
+### Cost Analysis
+1. Direct Costs:
+   - Development Resources: ~$150,000-200,000
+   - Training: ~$20,000
+   - Infrastructure Updates: ~$10,000
+   - Total: ~$180,000-230,000
+
+2. Indirect Costs:
+   - Productivity loss during transition
+   - Potential downtime
+   - Bug risk increase
+   - Learning curve impact
+
+### Risk Assessment
+
+#### Technical Risks (HIGH)
+- Data integrity during migration
+- Performance regressions
+- Unknown edge cases
+- Integration failures
+
+#### Business Risks (HIGH)
+- Service disruption
+- Feature parity gaps
+- User experience inconsistency
+- Timeline uncertainty
+
+#### Mitigation Strategies
+- Phased migration approach
+- Comprehensive testing
+- Rollback procedures
+- User communication plan
+
+## Detailed Technical Challenges
+
+### Critical Areas
+
+1. History Tracking System
+   - Custom implementation in Django
+   - Complex diff tracking
+   - Temporal data management
+
+2. Authentication System
+   - Role-based access control
+   - Social authentication integration
+   - Custom user profiles
+
+3. Geographic Features
+   - Location services
+   - Coordinate normalization
+   - Geographic queries
+
+4. Media Management
+   - Custom storage backends
+   - Image processing
+   - Upload handling
+
+## Conclusion
+
+### Key Findings
+1. High Technical Debt: Migration would require substantial rewrite
+2. Complex Domain Logic: Specialized features need careful translation
+3. Resource Intensive: Significant time and budget required
+4. High Risk: Critical business functions affected
+
+### Recommendation
+**Do Not Proceed with Migration**
+
+Rationale:
+1. Current Django implementation is stable and mature
+2. Migration costs outweigh potential benefits
+3. High risk to business continuity
+4. Significant resource requirement
+
+### Alternative Recommendations
+
+1. **Modernize Current Stack**
+   - Update Django version
+   - Enhance current architecture
+   - Improve performance in place
+
+2. **Gradual Enhancement**
+   - Add Laravel microservices if needed
+   - Keep core Django system
+   - Hybrid approach for new features
+
+3. **Focus on Business Value**
+   - Invest in feature development
+   - Improve user experience
+   - Enhance current system
+
+## Success Metrics (If Migration Proceeded)
+
+1. Technical Metrics
+   - Performance parity or improvement
+   - Code quality metrics
+   - Test coverage
+   - Deployment success rate
+
+2. Business Metrics
+   - User satisfaction
+   - System availability
+   - Feature parity
+   - Development velocity
+
+## Timeline and Resource Allocation
+
+### Phase 1: Planning and Setup (4-6 weeks)
+- Architecture design
+- Environment setup
+- Team training
+
+### Phase 2: Core Migration (12-16 weeks)
+- Database migration
+- Authentication system
+- Core business logic
+
+### Phase 3: Frontend Integration (8-10 weeks)
+- Template conversion
+- HTMX integration
+- UI testing
+
+### Phase 4: Testing and Deployment (6-8 weeks)
+- System testing
+- Performance optimization
+- Production deployment
+
+### Total Timeline: 30-40 weeks
+
+## Final Verdict
+
+Given the extensive analysis, the recommendation is to **maintain and enhance the current Django implementation** rather than pursuing a Laravel migration. The current system is stable, well-architected, and effectively serves business needs. The high costs, risks, and potential disruption of migration outweigh any potential benefits that Laravel might offer.
+
+Focus should instead be directed toward:
+1. Optimizing current Django implementation
+2. Enhancing feature set and user experience
+3. Updating dependencies and security
+4. Improving development workflows

memory-bank/decisions/park-search-improvements.md

@@ -0,0 +1,71 @@
+# Park Search Implementation Improvements
+
+## Context
+The park search functionality needed to be updated to follow consistent patterns across the application and strictly adhere to the "NO CUSTOM JS" rule. Previously, search functionality was inconsistent and did not fully utilize built-in framework features.
+
+## Decision
+Implemented a unified search pattern that:
+1. Uses only built-in HTMX and Alpine.js features
+2. Matches location search pattern
+3. Removes any custom JavaScript files
+4. Maintains consistency across the application
+
+### Benefits
+1. **Simplified Architecture:**
+   - No custom JavaScript files needed
+   - Direct template-based implementation
+   - Reduced maintenance burden
+   - Smaller codebase
+
+2. **Framework Alignment:**
+   - Uses HTMX for AJAX requests
+   - Uses Alpine.js for state management
+   - All functionality in templates
+   - Follows project patterns
+
+3. **Better Maintainability:**
+   - Single source of truth in templates
+   - Reduced complexity
+   - Easier to understand
+   - Consistent with other features
+
+## Implementation Details
+
+### Template Features
+1. HTMX Integration:
+   - Debounced search requests (300ms)
+   - Loading indicators
+   - JSON response handling
+
+2. Alpine.js Usage:
+   - State management in template
+   - Event handling
+   - UI updates
+   - Keyboard interactions
+
+### Backend Changes
+1. JSON API:
+   - Consistent response format
+   - Type validation
+   - Limited results (8 items)
+   - Performance optimization
+
+2. View Updates:
+   - Search filtering
+   - Result formatting
+   - Error handling
+   - State preservation
+
+## Benefits
+1. Better adherence to project standards
+2. Simplified codebase
+3. Reduced technical debt
+4. Easier maintenance
+5. Consistent user experience
+
+## Testing
+1. API response format
+2. Empty search handling
+3. Field validation
+4. UI interactions
+5. State management

memory-bank/decisions/search-form-fix.md

@@ -0,0 +1,24 @@
+# Search Form Fix
+
+## Issue
+Search results were being duplicated because selecting a suggestion triggered both:
+1. The suggestions form submission (to /suggest_parks/)
+2. The filter form submission (to /park_list/)
+
+## Root Cause
+The `@search-selected` event handler was submitting the wrong form. It was submitting the suggestions form which has `hx-target="#search-results"` instead of the filter form which has `hx-target="#park-results"`.
+
+## Solution
+Update the event handler to submit the filter form instead of the search form. This ensures only one request is made to update the results.
+
+## Implementation
+1. Modified the `@search-selected` handler to:
+   - Set the search query in filter form
+   - Submit filter form to update results
+   - Hide suggestions dropdown
+2. Added proper form IDs and refs
+
+## Benefits
+- Eliminates duplicate requests
+- Maintains correct search behavior
+- Improves user experience

memory-bank/decisions/search_duplication_fix.md

@@ -0,0 +1,61 @@
+# Search Duplication Fix
+
+## Issue
+The park search was showing duplicate results because:
+1. There were two separate forms with the same ID ("filter-form")
+2. Both forms were targeting the same element ("#park-results")
+3. The search form and filter form were operating independently
+
+## Solution
+1. Created a custom autocomplete package to handle search functionality:
+   - ModelAutocomplete base class for model-based autocomplete
+   - AutocompleteWidget for rendering the search input
+   - Templates for widget and suggestions
+   - Views for handling search and selection
+
+2. Updated ParkAutocomplete to use ModelAutocomplete:
+```python
+class ParkAutocomplete(ModelAutocomplete):
+    model = Park
+    search_attrs = ['name']
+    minimum_search_length = 2
+    max_results = 8
+```
+
+3. Combined search and filter functionality into a single form:
+```html
+<form id="filter-form"
+      x-ref="filterForm"
+      hx-get="{% url 'parks:park_list' %}"
+      hx-target="#park-results"
+      hx-push-url="true"
+      hx-trigger="submit"
+      class="mt-4">
+    <div class="mb-6">
+        {{ search_form }}  <!-- AutocompleteWidget -->
+    </div>
+    {% include "search/components/filter_form.html" with filter=filter %}
+</form>
+```
+
+4. Added proper URL routing for autocomplete:
+```python
+path("ac/", include((autocomplete_patterns, "autocomplete"), namespace="autocomplete"))
+```
+
+## Benefits
+1. No more duplicate search requests
+2. Cleaner template structure
+3. Better user experience with a single search interface
+4. Proper integration with django-htmx-autocomplete
+5. Simplified view logic
+6. Reusable autocomplete functionality for other models
+
+## Technical Details
+- Using django-htmx-autocomplete's AutocompleteWidget for search
+- Single form submission handles both search and filtering
+- HTMX handles the dynamic updates
+- View mode selection preserved during search/filter operations
+- Minimum search length of 2 characters
+- Maximum of 8 search results
+- Search results include park status and location

memory-bank/documentation/APIs.md

@@ -0,0 +1,410 @@
+# API Documentation
+
+## API Overview
+
+### Base Configuration
+```python
+REST_FRAMEWORK = {
+    'DEFAULT_AUTHENTICATION_CLASSES': [
+        'rest_framework_jwt.authentication.JSONWebTokenAuthentication',
+        'rest_framework.authentication.SessionAuthentication',
+    ],
+    'DEFAULT_PERMISSION_CLASSES': [
+        'rest_framework.permissions.IsAuthenticated',
+    ],
+    'DEFAULT_PAGINATION_CLASS': 
+        'rest_framework.pagination.PageNumberPagination',
+    'PAGE_SIZE': 20,
+    'DEFAULT_VERSIONING_CLASS': 
+        'rest_framework.versioning.AcceptHeaderVersioning',
+    'DEFAULT_VERSION': 'v1'
+}
+```
+
+## Authentication
+
+### JWT Authentication
+```http
+POST /api/token/
+Content-Type: application/json
+
+{
+    "username": "user@example.com",
+    "[PASSWORD-REMOVED]"
+}
+
+Response:
+{
+    "access": "eyJ0eXAiOiJKV1QiLCJhbGc...",
+    "refresh": "eyJ0eXAiOiJKV1QiLCJhbGc..."
+}
+```
+
+### Token Refresh
+```http
+POST /api/token/refresh/
+Content-Type: application/json
+
+{
+    "refresh": "eyJ0eXAiOiJKV1QiLCJhbGc..."
+}
+
+Response:
+{
+    "access": "eyJ0eXAiOiJKV1QiLCJhbGc..."
+}
+```
+
+## Endpoints
+
+### Parks API
+
+#### List Parks
+```http
+GET /api/v1/parks/
+Authorization: Bearer <token>
+
+Response:
+{
+    "count": 100,
+    "next": "http://api.thrillwiki.com/parks/?page=2",
+    "previous": null,
+    "results": [
+        {
+            "id": 1,
+            "name": "Adventure Park",
+            "slug": "adventure-park",
+            "status": "OPERATING",
+            "description": "...",
+            "location": {
+                "city": "Orlando",
+                "state": "FL",
+                "country": "USA"
+            },
+            "ride_count": 25,
+            "average_rating": 4.5
+        }
+    ]
+}
+```
+
+#### Get Park Detail
+```http
+GET /api/v1/parks/{slug}/
+Authorization: Bearer <token>
+
+Response:
+{
+    "id": 1,
+    "name": "Adventure Park",
+    "slug": "adventure-park",
+    "status": "OPERATING",
+    "description": "...",
+    "location": {
+        "address": "123 Theme Park Way",
+        "city": "Orlando",
+        "state": "FL",
+        "country": "USA",
+        "postal_code": "32819",
+        "coordinates": {
+            "latitude": 28.538336,
+            "longitude": -81.379234
+        }
+    },
+    "owner": {
+        "id": 1,
+        "name": "Theme Park Corp",
+        "verified": true
+    },
+    "stats": {
+        "ride_count": 25,
+        "coaster_count": 5,
+        "average_rating": 4.5
+    },
+    "rides": [
+        {
+            "id": 1,
+            "name": "Thrill Coaster",
+            "type": "ROLLER_COASTER",
+            "status": "OPERATING"
+        }
+    ]
+}
+```
+
+### Rides API
+
+#### List Rides
+```http
+GET /api/v1/parks/{park_slug}/rides/
+Authorization: Bearer <token>
+
+Response:
+{
+    "count": 25,
+    "next": null,
+    "previous": null,
+    "results": [
+        {
+            "id": 1,
+            "name": "Thrill Coaster",
+            "slug": "thrill-coaster",
+            "type": "ROLLER_COASTER",
+            "status": "OPERATING",
+            "height_requirement": 48,
+            "thrill_rating": 5,
+            "manufacturer": {
+                "id": 1,
+                "name": "Coaster Corp"
+            }
+        }
+    ]
+}
+```
+
+#### Get Ride Detail
+```http
+GET /api/v1/rides/{ride_slug}/
+Authorization: Bearer <token>
+
+Response:
+{
+    "id": 1,
+    "name": "Thrill Coaster",
+    "slug": "thrill-coaster",
+    "type": "ROLLER_COASTER",
+    "status": "OPERATING",
+    "description": "...",
+    "specifications": {
+        "height_requirement": 48,
+        "thrill_rating": 5,
+        "capacity_per_hour": 1200,
+        "track_length": 3000
+    },
+    "manufacturer": {
+        "id": 1,
+        "name": "Coaster Corp"
+    },
+    "designer": {
+        "id": 1,
+        "name": "John Designer"
+    },
+    "opening_date": "2020-06-15",
+    "stats": {
+        "average_rating": 4.8,
+        "review_count": 150
+    }
+}
+```
+
+### Reviews API
+
+#### Create Review
+```http
+POST /api/v1/reviews/
+Authorization: Bearer <token>
+Content-Type: application/json
+
+{
+    "content_type": "ride",
+    "object_id": 1,
+    "rating": 5,
+    "content": "Amazing experience!",
+    "media": [
+        {
+            "type": "image",
+            "file": "base64encoded..."
+        }
+    ]
+}
+
+Response:
+{
+    "id": 1,
+    "author": {
+        "id": 1,
+        "username": "reviewer"
+    },
+    "rating": 5,
+    "content": "Amazing experience!",
+    "status": "PENDING",
+    "created_at": "2024-02-18T14:30:00Z"
+}
+```
+
+#### List Reviews
+```http
+GET /api/v1/rides/{ride_id}/reviews/
+Authorization: Bearer <token>
+
+Response:
+{
+    "count": 150,
+    "next": "http://api.thrillwiki.com/rides/1/reviews/?page=2",
+    "previous": null,
+    "results": [
+        {
+            "id": 1,
+            "author": {
+                "id": 1,
+                "username": "reviewer"
+            },
+            "rating": 5,
+            "content": "Amazing experience!",
+            "created_at": "2024-02-18T14:30:00Z",
+            "media": [
+                {
+                    "type": "image",
+                    "url": "https://media.thrillwiki.com/reviews/1/image.jpg"
+                }
+            ]
+        }
+    ]
+}
+```
+
+## Integrations
+
+### Email Service Integration
+```http
+POST /api/v1/email/send/
+Authorization: Bearer <token>
+Content-Type: application/json
+
+{
+    "template": "review_notification",
+    "recipient": "user@example.com",
+    "context": {
+        "review_id": 1,
+        "content": "Amazing experience!"
+    }
+}
+
+Response:
+{
+    "status": "sent",
+    "message_id": "123abc",
+    "sent_at": "2024-02-18T14:30:00Z"
+}
+```
+
+### Media Processing
+```http
+POST /api/v1/media/process/
+Authorization: Bearer <token>
+Content-Type: multipart/form-data
+
+file: [binary data]
+
+Response:
+{
+    "id": 1,
+    "original_url": "https://media.thrillwiki.com/original/image.jpg",
+    "processed_url": "https://media.thrillwiki.com/processed/image.jpg",
+    "thumbnail_url": "https://media.thrillwiki.com/thumbnails/image.jpg",
+    "metadata": {
+        "width": 1920,
+        "height": 1080,
+        "format": "jpeg",
+        "size": 1024576
+    }
+}
+```
+
+## API Versioning
+
+### Version Header
+```http
+Accept: application/json; version=1.0
+```
+
+### Version Routes
+```python
+# urls.py
+urlpatterns = [
+    path('v1/', include('api.v1.urls')),
+    path('v2/', include('api.v2.urls')),
+]
+```
+
+## Error Handling
+
+### Error Response Format
+```json
+{
+    "error": {
+        "code": "validation_error",
+        "message": "Invalid input data",
+        "details": [
+            {
+                "field": "rating",
+                "message": "Rating must be between 1 and 5"
+            }
+        ]
+    }
+}
+```
+
+### Common Error Codes
+- `authentication_error`: Invalid or missing authentication
+- `permission_denied`: Insufficient permissions
+- `validation_error`: Invalid input data
+- `not_found`: Resource not found
+- `rate_limit_exceeded`: Too many requests
+
+## Rate Limiting
+
+### Rate Limit Configuration
+```python
+REST_FRAMEWORK = {
+    'DEFAULT_THROTTLE_CLASSES': [
+        'rest_framework.throttling.AnonRateThrottle',
+        'rest_framework.throttling.UserRateThrottle'
+    ],
+    'DEFAULT_THROTTLE_RATES': {
+        'anon': '100/day',
+        'user': '1000/day',
+        'burst': '20/minute'
+    }
+}
+```
+
+### Rate Limit Headers
+```http
+X-RateLimit-Limit: 1000
+X-RateLimit-Remaining: 999
+X-RateLimit-Reset: 1613664000
+```
+
+## API Documentation
+
+### Swagger/OpenAPI
+```yaml
+openapi: 3.0.0
+info:
+  title: ThrillWiki API
+  version: 1.0.0
+paths:
+  /parks:
+    get:
+      summary: List parks
+      parameters:
+        - name: page
+          in: query
+          schema:
+            type: integer
+      responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ParkList'
+```
+
+### API Documentation URLs
+```python
+urlpatterns = [
+    path('docs/', include_docs_urls(title='ThrillWiki API')),
+    path('schema/', schema_view),
+]

memory-bank/documentation/Architecture.md

@@ -0,0 +1,168 @@
+# System Architecture Documentation
+
+## Overview
+ThrillWiki is a Django-based web platform built with a modular architecture focusing on theme park information management, user reviews, and content moderation.
+
+## Technology Stack
+
+### Backend
+- **Framework**: Django 5.1.6
+- **API**: Django REST Framework 3.15.2
+- **WebSocket Support**: Channels 4.2.0 with Redis
+- **Authentication**: django-allauth, OAuth Toolkit
+- **Database**: PostgreSQL with django-pghistory
+
+### Frontend
+- **Templating**: Django Templates
+- **CSS Framework**: Tailwind CSS
+- **Enhancement**: HTMX, JavaScript
+- **Asset Management**: django-webpack-loader
+
+### Infrastructure
+- **Static Files**: WhiteNoise 6.9.0
+- **Media Storage**: Local filesystem with custom storage backends
+- **Caching**: Redis (shared with WebSocket layer)
+
+## System Components
+
+### Core Applications
+
+1. **Parks Module**
+   - Park information management
+   - Geographic data handling
+   - Operating hours tracking
+   - Integration with location services
+
+2. **Rides Module**
+   - Ride specifications
+   - Manufacturer/Designer attribution
+   - Historical data tracking
+   - Technical details management
+
+3. **Reviews System**
+   - User-generated content
+   - Media attachments
+   - Rating framework
+   - Integration with moderation
+
+4. **Moderation System**
+   - Content review workflow
+   - Quality control mechanisms
+   - User management
+   - Verification processes
+
+5. **Companies Module**
+   - Company profiles
+   - Verification system
+   - Official update management
+   - Park operator features
+
+### Service Layer
+
+1. **Authentication Service**
+   ```python
+   # Key authentication flows
+   User Authentication → JWT Token → Protected Resources
+   Social Auth → Profile Creation → Platform Access
+   ```
+
+2. **Media Service**
+   ```python
+   # Media handling workflow
+   Upload → Processing → Storage → Delivery
+   ```
+
+3. **Analytics Service**
+   ```python
+   # Analytics pipeline
+   User Action → Event Tracking → Processing → Insights
+   ```
+
+## Data Flow Architecture
+
+```
+┌─────────────┐     ┌──────────────┐     ┌─────────────┐
+│   Client    │ ──→ │   Django     │ ──→ │  Database   │
+│   Browser   │ ←── │   Server     │ ←── │  (Postgres) │
+└─────────────┘     └──────────────┘     └─────────────┘
+                          ↑ ↓
+                    ┌──────────────┐
+                    │   Services   │
+                    │  (Redis/S3)  │
+                    └──────────────┘
+```
+
+## Security Architecture
+
+1. **Authentication Flow**
+   - JWT-based authentication
+   - Social authentication integration
+   - Session management
+   - Permission-based access control
+
+2. **Data Protection**
+   - Input validation
+   - XSS prevention
+   - CSRF protection
+   - SQL injection prevention
+
+## Deployment Model
+
+### Production Environment
+```
+├── Application Server (Daphne/ASGI)
+├── Database (PostgreSQL)
+├── Cache/Message Broker (Redis)
+├── Static Files (WhiteNoise)
+└── Media Storage (Filesystem/S3)
+```
+
+### Development Environment
+```
+├── Local Django Server
+├── Local PostgreSQL
+├── Local Redis
+└── Local File Storage
+```
+
+## Monitoring and Scaling
+
+1. **Performance Monitoring**
+   - Page load metrics
+   - Database query analysis
+   - Cache hit rates
+   - API response times
+
+2. **Scaling Strategy**
+   - Horizontal scaling of web servers
+   - Database read replicas
+   - Cache layer expansion
+   - Media CDN integration
+
+## Integration Points
+
+1. **External Services**
+   - Email service (ForwardEmail.net)
+   - Social authentication providers
+   - Geographic data services
+   - Media processing services
+
+2. **Internal Services**
+   - WebSocket notifications
+   - Background tasks
+   - Media processing
+   - Analytics processing
+
+## System Requirements
+
+### Minimum Requirements
+- Python 3.11+
+- PostgreSQL 13+
+- Redis 6+
+- Node.js 18+ (for frontend builds)
+
+### Development Tools
+- black (code formatting)
+- flake8 (linting)
+- pytest (testing)
+- tailwind CLI (CSS processing)

memory-bank/documentation/Code.md

@@ -0,0 +1,287 @@
+# Code Documentation
+
+## Project Structure
+
+```
+thrillwiki/
+├── accounts/          # User management
+├── analytics/         # Usage tracking
+├── companies/         # Company profiles
+├── core/             # Core functionality
+├── designers/        # Designer profiles
+├── email_service/    # Email handling
+├── history/          # Historical views
+├── history_tracking/ # Change tracking
+├── location/         # Geographic features
+├── media/           # Media management
+├── moderation/      # Content moderation
+├── parks/           # Park management
+├── reviews/         # Review system
+└── rides/           # Ride management
+```
+
+## Code Patterns
+
+### 1. Model Patterns
+
+#### History Tracking
+```python
+@pghistory.track()
+class TrackedModel(models.Model):
+    """Base class for models with history tracking"""
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+```
+
+#### Slug Management
+```python
+class SluggedModel:
+    """Pattern for models with slug-based URLs"""
+    @classmethod
+    def get_by_slug(cls, slug: str) -> Tuple[Model, bool]:
+        # Check current slugs
+        try:
+            return cls.objects.get(slug=slug), False
+        except cls.DoesNotExist:
+            # Check historical slugs
+            historical = HistoricalSlug.objects.filter(
+                content_type=ContentType.objects.get_for_model(cls),
+                slug=slug
+            ).first()
+            if historical:
+                return cls.objects.get(pk=historical.object_id), True
+```
+
+#### Generic Relations
+```python
+# Example from parks/models.py
+class Park(TrackedModel):
+    location = GenericRelation(Location)
+    photos = GenericRelation(Photo)
+```
+
+### 2. View Patterns
+
+#### Class-Based Views
+```python
+class ModeratedCreateView(LoginRequiredMixin, CreateView):
+    """Base view for content requiring moderation"""
+    def form_valid(self, form):
+        obj = form.save(commit=False)
+        obj.status = 'PENDING'
+        obj.created_by = self.request.user
+        return super().form_valid(form)
+```
+
+#### Permission Mixins
+```python
+class ModeratorRequiredMixin:
+    """Ensures user has moderation permissions"""
+    def dispatch(self, request, *args, **kwargs):
+        if not request.user.has_perm('moderation.can_moderate'):
+            raise PermissionDenied
+        return super().dispatch(request, *args, **kwargs)
+```
+
+### 3. Service Patterns
+
+#### Email Service
+```python
+class EmailService:
+    """Handles email templating and sending"""
+    def send_moderation_notification(self, content):
+        template = 'moderation/email/notification.html'
+        context = {'content': content}
+        self.send_templated_email(template, context)
+```
+
+#### Media Processing
+```python
+class MediaProcessor:
+    """Handles image optimization and processing"""
+    def process_image(self, image):
+        # Optimize size
+        # Extract EXIF
+        # Generate thumbnails
+        return processed_image
+```
+
+## Dependencies
+
+### Core Dependencies
+```toml
+# From pyproject.toml
+[tool.poetry.dependencies]
+django = "5.1.6"
+djangorestframework = "3.15.2"
+django-allauth = "65.4.1"
+psycopg2-binary = "2.9.10"
+django-pghistory = "3.5.2"
+```
+
+### Frontend Dependencies
+```json
+{
+    "tailwindcss": "^3.0.0",
+    "htmx": "^1.22.0",
+    "webpack": "^5.0.0"
+}
+```
+
+## Build Configuration
+
+### Django Settings
+```python
+INSTALLED_APPS = [
+    # Django apps
+    'django.contrib.admin',
+    'django.contrib.auth',
+    
+    # Third-party apps
+    'allauth',
+    'rest_framework',
+    'corsheaders',
+    
+    # Local apps
+    'parks.apps.ParksConfig',
+    'rides.apps.RidesConfig',
+]
+
+MIDDLEWARE = [
+    'django.middleware.security.SecurityMiddleware',
+    'whitenoise.middleware.WhiteNoiseMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+]
+```
+
+### Database Configuration
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.postgresql',
+        'NAME': env('DB_NAME'),
+        'USER': env('DB_USER'),
+        'PASSWORD': env('DB_PASSWORD'),
+        'HOST': env('DB_HOST'),
+        'PORT': env('DB_PORT'),
+    }
+}
+```
+
+## Testing Framework
+
+### Test Structure
+```
+tests/
+├── unit/              # Unit tests
+├── integration/       # Integration tests
+└── e2e/              # End-to-end tests
+```
+
+### Test Patterns
+```python
+class ParkTestCase(TestCase):
+    def setUp(self):
+        self.park = Park.objects.create(
+            name="Test Park",
+            status="OPERATING"
+        )
+    
+    def test_park_creation(self):
+        self.assertEqual(self.park.slug, "test-park")
+```
+
+## Package Management
+
+### Python Dependencies
+```bash
+# Development dependencies
+pip install -r requirements-dev.txt
+
+# Production dependencies
+pip install -r requirements.txt
+```
+
+### Frontend Build
+```bash
+# Install frontend dependencies
+npm install
+
+# Build static assets
+npm run build
+```
+
+## Code Quality Tools
+
+### Python Tools
+- black (code formatting)
+- flake8 (linting)
+- mypy (type checking)
+- pytest (testing)
+
+### Configuration Files
+```toml
+# pyproject.toml
+[tool.black]
+line-length = 88
+target-version = ['py311']
+
+[tool.mypy]
+plugins = ["mypy_django_plugin.main"]
+```
+
+## Development Workflow
+
+### Local Development
+1. Set up virtual environment
+2. Install dependencies
+3. Run migrations
+4. Start development server
+
+```bash
+python -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+python manage.py migrate
+python manage.py runserver
+```
+
+### Code Review Process
+1. Run linting tools
+2. Run test suite
+3. Check type hints
+4. Review documentation
+
+## Deployment Process
+
+### Pre-deployment Checks
+1. Run test suite
+2. Check migrations
+3. Validate static files
+4. Verify environment variables
+
+### Deployment Steps
+1. Update dependencies
+2. Apply migrations
+3. Collect static files
+4. Restart application server
+
+## Error Handling
+
+### Exception Pattern
+```python
+class CustomException(Exception):
+    """Base exception for application"""
+    def __init__(self, message, code=None):
+        self.message = message
+        self.code = code
+```
+
+### Middleware Pattern
+```python
+class ErrorHandlingMiddleware:
+    """Centralized error handling"""
+    def process_exception(self, request, exception):
+        # Log exception
+        # Handle gracefully
+        # Return appropriate response

memory-bank/documentation/Data.md

@@ -0,0 +1,327 @@
+# Data Documentation
+
+## Database Schema
+
+### Core Models
+
+#### Parks
+```sql
+CREATE TABLE parks_park (
+    id SERIAL PRIMARY KEY,
+    name VARCHAR(255) NOT NULL,
+    slug VARCHAR(255) UNIQUE NOT NULL,
+    description TEXT,
+    status VARCHAR(20) DEFAULT 'OPERATING',
+    opening_date DATE,
+    closing_date DATE,
+    operating_season VARCHAR(255),
+    size_acres DECIMAL(10,2),
+    website VARCHAR(200),
+    average_rating DECIMAL(3,2),
+    ride_count INTEGER,
+    coaster_count INTEGER,
+    owner_id INTEGER REFERENCES companies_company(id),
+    created_at TIMESTAMP,
+    updated_at TIMESTAMP
+);
+```
+
+#### Rides
+```sql
+CREATE TABLE rides_ride (
+    id SERIAL PRIMARY KEY,
+    name VARCHAR(255) NOT NULL,
+    slug VARCHAR(255) NOT NULL,
+    description TEXT,
+    status VARCHAR(20),
+    park_id INTEGER REFERENCES parks_park(id),
+    area_id INTEGER REFERENCES parks_parkarea(id),
+    manufacturer_id INTEGER REFERENCES companies_company(id),
+    designer_id INTEGER REFERENCES designers_designer(id),
+    opening_date DATE,
+    closing_date DATE,
+    height_requirement INTEGER,
+    ride_type VARCHAR(50),
+    thrill_rating INTEGER,
+    created_at TIMESTAMP,
+    updated_at TIMESTAMP,
+    UNIQUE(park_id, slug)
+);
+```
+
+#### Reviews
+```sql
+CREATE TABLE reviews_review (
+    id SERIAL PRIMARY KEY,
+    content TEXT NOT NULL,
+    rating DECIMAL(3,2),
+    status VARCHAR(20),
+    author_id INTEGER REFERENCES auth_user(id),
+    content_type_id INTEGER REFERENCES django_content_type(id),
+    object_id INTEGER,
+    created_at TIMESTAMP,
+    updated_at TIMESTAMP
+);
+```
+
+### Entity Relationships
+
+```mermaid
+erDiagram
+    Park ||--o{ ParkArea : "contains"
+    Park ||--o{ Ride : "has"
+    Park ||--o{ Photo : "has"
+    Park ||--o{ Review : "receives"
+    ParkArea ||--o{ Ride : "contains"
+    Ride ||--o{ Photo : "has"
+    Ride ||--o{ Review : "receives"
+    Company ||--o{ Park : "owns"
+    Company ||--o{ Ride : "manufactures"
+    Designer ||--o{ Ride : "designs"
+    User ||--o{ Review : "writes"
+```
+
+## Data Models
+
+### Content Models
+
+#### Park Model
+- Core information about theme parks
+- Location data through GenericRelation
+- Media attachments
+- Historical tracking
+- Owner relationship
+
+#### Ride Model
+- Technical specifications
+- Park and area relationships
+- Manufacturer and designer links
+- Operation status tracking
+- Safety requirements
+
+#### Review Model
+- Generic foreign key for flexibility
+- Rating system
+- Media attachments
+- Moderation status
+- Author tracking
+
+### Supporting Models
+
+#### Location Model
+```python
+class Location(models.Model):
+    content_type = models.ForeignKey(ContentType)
+    object_id = models.PositiveIntegerField()
+    content_object = GenericForeignKey()
+    
+    address = models.CharField(max_length=255)
+    city = models.CharField(max_length=100)
+    state = models.CharField(max_length=100)
+    country = models.CharField(max_length=100)
+    postal_code = models.CharField(max_length=20)
+    latitude = models.DecimalField(max_digits=9, decimal_places=6)
+    longitude = models.DecimalField(max_digits=9, decimal_places=6)
+```
+
+#### Media Model
+```python
+class Photo(models.Model):
+    content_type = models.ForeignKey(ContentType)
+    object_id = models.PositiveIntegerField()
+    content_object = GenericForeignKey()
+    
+    file = models.ImageField(upload_to='photos/')
+    caption = models.CharField(max_length=255)
+    taken_at = models.DateTimeField(null=True)
+    uploaded_at = models.DateTimeField(auto_now_add=True)
+```
+
+## Storage Strategies
+
+### Database Storage
+
+#### PostgreSQL Configuration
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.postgresql',
+        'NAME': 'thrillwiki',
+        'CONN_MAX_AGE': 60,
+        'OPTIONS': {
+            'client_encoding': 'UTF8',
+        },
+    }
+}
+```
+
+#### Indexing Strategy
+```sql
+-- Performance indexes
+CREATE INDEX idx_park_slug ON parks_park(slug);
+CREATE INDEX idx_ride_slug ON rides_ride(slug);
+CREATE INDEX idx_review_content_type ON reviews_review(content_type_id, object_id);
+```
+
+### File Storage
+
+#### Media Storage
+```python
+# Media storage configuration
+MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
+MEDIA_URL = '/media/'
+
+# File upload handlers
+FILE_UPLOAD_HANDLERS = [
+    'django.core.files.uploadhandler.MemoryFileUploadHandler',
+    'django.core.files.uploadhandler.TemporaryFileUploadHandler',
+]
+```
+
+#### Directory Structure
+```
+media/
+├── photos/
+│   ├── parks/
+│   ├── rides/
+│   └── reviews/
+├── avatars/
+└── documents/
+```
+
+### Caching Strategy
+
+#### Cache Configuration
+```python
+CACHES = {
+    'default': {
+        'BACKEND': 'django.core.cache.backends.redis.RedisCache',
+        'LOCATION': 'redis://127.0.0.1:6379/1',
+        'OPTIONS': {
+            'CLIENT_CLASS': 'django_redis.client.DefaultClient',
+        }
+    }
+}
+```
+
+#### Cache Keys
+```python
+# Cache key patterns
+CACHE_KEYS = {
+    'park_detail': 'park:{slug}',
+    'ride_list': 'park:{park_slug}:rides',
+    'review_count': 'content:{type}:{id}:reviews',
+}
+```
+
+## Data Migration
+
+### Migration Strategy
+1. Schema migrations via Django
+2. Data migrations for model changes
+3. Content migrations for large updates
+
+### Example Migration
+```python
+# migrations/0002_add_park_status.py
+from django.db import migrations, models
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ('parks', '0001_initial'),
+    ]
+    
+    operations = [
+        migrations.AddField(
+            model_name='park',
+            name='status',
+            field=models.CharField(
+                max_length=20,
+                choices=[
+                    ('OPERATING', 'Operating'),
+                    ('CLOSED', 'Closed'),
+                ],
+                default='OPERATING'
+            ),
+        ),
+    ]
+```
+
+## Data Protection
+
+### Backup Strategy
+1. Daily database backups
+2. Media files backup
+3. Retention policy management
+
+### Backup Configuration
+```python
+# backup settings
+BACKUP_ROOT = os.path.join(BASE_DIR, 'backups')
+BACKUP_RETENTION_DAYS = 30
+BACKUP_COMPRESSION = True
+```
+
+## Data Validation
+
+### Model Validation
+```python
+class Park(models.Model):
+    def clean(self):
+        if self.closing_date and self.opening_date:
+            if self.closing_date < self.opening_date:
+                raise ValidationError({
+                    'closing_date': 'Closing date cannot be before opening date'
+                })
+```
+
+### Form Validation
+```python
+class RideForm(forms.ModelForm):
+    def clean_height_requirement(self):
+        height = self.cleaned_data['height_requirement']
+        if height and height < 0:
+            raise forms.ValidationError('Height requirement cannot be negative')
+        return height
+```
+
+## Data Access Patterns
+
+### QuerySet Optimization
+```python
+# Optimized query pattern
+Park.objects.select_related('owner')\
+    .prefetch_related('rides', 'areas')\
+    .filter(status='OPERATING')
+```
+
+### Caching Pattern
+```python
+def get_park_detail(slug):
+    cache_key = f'park:{slug}'
+    park = cache.get(cache_key)
+    if not park:
+        park = Park.objects.get(slug=slug)
+        cache.set(cache_key, park, timeout=3600)
+    return park
+```
+
+## Monitoring and Metrics
+
+### Database Metrics
+- Query performance
+- Cache hit rates
+- Storage usage
+- Connection pool status
+
+### Collection Configuration
+```python
+LOGGING = {
+    'handlers': {
+        'db_log': {
+            'level': 'DEBUG',
+            'class': 'logging.handlers.RotatingFileHandler',
+            'filename': 'logs/db.log',
+        },
+    },
+}

memory-bank/documentation/Features.md

@@ -0,0 +1,253 @@
+# Feature Documentation
+
+## Core Features
+
+### 1. Park Management
+
+#### Park Discovery
+- Geographic search and filtering
+- Park categorization and taxonomy
+- Operating hours and seasonal information
+- Location-based recommendations
+
+#### Park Profiles
+- Detailed park information
+- Historical data and timeline
+- Media galleries
+- Operating schedule management
+- Accessibility information
+
+#### Area Management
+```python
+# Key relationships
+Park
+ └── Areas
+      └── Rides
+```
+
+### 2. Ride System
+
+#### Ride Catalog
+- Technical specifications
+- Thrill ratings and categories
+- Operational status tracking
+- Maintenance history
+- Designer and manufacturer attribution
+
+#### Ride Features
+- Height requirements
+- Accessibility options
+- Queue management information
+- Rider experience details
+- Historical modifications
+
+### 3. Review System
+
+#### User Reviews
+- Rating framework
+- Experience descriptions
+- Visit date tracking
+- Media attachments
+- Helpful vote system
+
+#### Review Workflow
+```
+Submission → Moderation → Publication → Feedback
+```
+
+#### Review Features
+- Rich text formatting
+- Multi-media support
+- Rating categories
+- Experience verification
+- Response management
+
+### 4. User Management
+
+#### User Profiles
+- Activity history
+- Contribution tracking
+- Reputation system
+- Privacy controls
+
+#### Authentication
+- Email registration
+- Social authentication
+- Password management
+- Session control
+
+#### Permissions
+- Role-based access
+- Content moderation rights
+- Company verification
+- Expert designation
+
+### 5. Company Management
+
+#### Company Profiles
+- Official park operator accounts
+- Manufacturer profiles
+- Designer portfolios
+- Verification system
+
+#### Official Updates
+- Park announcements
+- Operational updates
+- New attraction information
+- Special event coverage
+
+### 6. Media Management
+
+#### Image Handling
+- Multi-format support
+- EXIF data processing
+- Automatic optimization
+- Gallery organization
+
+#### Storage System
+```python
+# Media organization
+content/
+  ├── parks/
+  ├── rides/
+  ├── reviews/
+  └── profiles/
+```
+
+### 7. Location Services
+
+#### Geographic Features
+- Park proximity search
+- Regional categorization
+- Map integration
+- Distance calculations
+
+#### Location Data
+- Coordinate system
+- Address validation
+- Region management
+- Geographic clustering
+
+### 8. Analytics System
+
+#### Tracking Features
+- Page view analytics
+- User engagement metrics
+- Content popularity
+- Search patterns
+
+#### Trend Analysis
+- Popular content
+- User behavior
+- Seasonal patterns
+- Content quality metrics
+
+## Business Requirements
+
+### 1. Content Quality
+- Mandatory review fields
+- Media quality standards
+- Information verification
+- Source attribution
+
+### 2. User Trust
+- Review authenticity checks
+- Company verification process
+- Expert contribution validation
+- Content moderation workflow
+
+### 3. Data Completeness
+- Required park information
+- Ride specification standards
+- Historical record requirements
+- Media documentation needs
+
+## Usage Flows
+
+### 1. Park Discovery Flow
+```
+Search/Browse → Park Selection → Detail View → Related Content
+```
+
+### 2. Review Creation Flow
+```
+Experience → Media Upload → Review Draft → Submission → Moderation
+```
+
+### 3. Company Verification Flow
+```
+Registration → Documentation → Verification → Profile Access
+```
+
+### 4. Content Moderation Flow
+```
+Submission Queue → Review → Action → Notification
+```
+
+## Development Roadmap
+
+### Current Phase
+1. Core Platform
+   - Park/Ride management
+   - Review system
+   - Basic media handling
+   - User authentication
+
+2. Quality Features
+   - Content moderation
+   - Company verification
+   - Expert system
+   - Media optimization
+
+### Next Phase
+1. Community Features
+   - Enhanced profiles
+   - Achievement system
+   - Social interactions
+   - Content collections
+
+2. Advanced Media
+   - Video support
+   - Virtual tours
+   - 360° views
+   - AR capabilities
+
+3. Analytics Enhancement
+   - Advanced metrics
+   - Personalization
+   - Trend prediction
+   - Quality scoring
+
+## Integration Requirements
+
+### External Systems
+- Email service integration
+- Social authentication providers
+- Geographic data services
+- Media processing services
+
+### Internal Systems
+- WebSocket notifications
+- Background task processing
+- Media optimization pipeline
+- Analytics processing system
+
+## Compliance Requirements
+
+### Data Protection
+- User privacy controls
+- Data retention policies
+- Export capabilities
+- Deletion workflows
+
+### Accessibility
+- WCAG compliance
+- Screen reader support
+- Keyboard navigation
+- Color contrast requirements
+
+### Content Policies
+- Review guidelines
+- Media usage rights
+- Attribution requirements
+- Moderation standards

memory-bank/documentation/Issues.md

@@ -0,0 +1,306 @@
+# Issues and Technical Debt Documentation
+
+## Known Bugs
+
+### 1. Data Integrity Issues
+
+#### Historical Slug Resolution
+```python
+# Current Implementation
+class Park(models.Model):
+    @classmethod
+    def get_by_slug(cls, slug: str):
+        # Issue: Race condition possible between slug check and retrieval
+        # TODO: Implement proper locking or transaction handling
+        try:
+            return cls.objects.get(slug=slug)
+        except cls.DoesNotExist:
+            return cls.objects.get(historical_slugs__slug=slug)
+```
+
+#### Media File Management
+```python
+# Current Issue
+class MediaHandler:
+    def process_upload(self, file):
+        # Bug: Temporary files not always cleaned up
+        # TODO: Implement proper cleanup in finally block
+        try:
+            process_file(file)
+        except Exception:
+            log_error()
+```
+
+### 2. Performance Issues
+
+#### N+1 Query Patterns
+```python
+# Inefficient Queries in Views
+class ParkDetailView(DetailView):
+    def get_context_data(self):
+        context = super().get_context_data()
+        # Issue: N+1 queries for each ride's reviews
+        context['rides'] = [
+            {
+                'ride': ride,
+                'reviews': ride.reviews.all()  # Causes N+1 query
+            } 
+            for ride in self.object.rides.all()
+        ]
+```
+
+#### Cache Invalidation
+```python
+# Inconsistent Cache Updates
+class ReviewManager:
+    def update_stats(self, obj):
+        # Bug: Race condition in cache updates
+        # TODO: Implement atomic cache updates
+        stats = calculate_stats(obj)
+        cache.set(f'{obj}_stats', stats)
+```
+
+## Technical Debt
+
+### 1. Code Organization
+
+#### Monolithic Views
+```python
+# views.py
+class ParkView(View):
+    def post(self, request, *args, **kwargs):
+        # TODO: Break down into smaller, focused views
+        # Currently handles too many responsibilities:
+        # - Park creation
+        # - Media processing
+        # - Notification sending
+        # - Stats updating
+```
+
+#### Duplicate Business Logic
+```python
+# Multiple implementations of similar functionality
+class ParkValidator:
+    def validate_status(self):
+        # TODO: Consolidate with RideValidator.validate_status
+        if self.status not in VALID_STATUSES:
+            raise ValidationError()
+
+class RideValidator:
+    def validate_status(self):
+        if self.status not in VALID_STATUSES:
+            raise ValidationError()
+```
+
+### 2. Infrastructure
+
+#### Configuration Management
+```python
+# settings.py
+# TODO: Move to environment variables
+DATABASE_PASSWORD = 'hardcoded_password'
+API_KEY = 'hardcoded_key'
+
+# TODO: Implement proper configuration management
+FEATURE_FLAGS = {
+    'new_review_system': True,
+    'beta_features': False
+}
+```
+
+#### Deployment Process
+```bash
+# Manual deployment steps
+# TODO: Automate deployment process
+ssh server
+git pull
+pip install -r requirements.txt
+python manage.py migrate
+supervisorctl restart app
+```
+
+### 3. Testing
+
+#### Test Coverage Gaps
+```python
+# Missing test cases for error conditions
+class ParkTests(TestCase):
+    def test_create_park(self):
+        # Only tests happy path
+        park = Park.objects.create(name='Test Park')
+        self.assertEqual(park.name, 'Test Park')
+        
+    # TODO: Add tests for:
+    # - Invalid input handling
+    # - Concurrent modifications
+    # - Edge cases
+```
+
+#### Integration Test Debt
+```python
+# Brittle integration tests
+class APITests(TestCase):
+    # TODO: Replace with proper test doubles
+    def setUp(self):
+        # Direct database dependencies
+        self.park = Park.objects.create()
+        # External service calls
+        self.geocoder = RealGeocoder()
+```
+
+## Enhancement Opportunities
+
+### 1. Feature Enhancements
+
+#### Advanced Search
+```python
+# Current basic search implementation
+class ParkSearch:
+    def search(self, query):
+        # TODO: Implement advanced search features:
+        # - Full-text search
+        # - Faceted search
+        # - Geographic search
+        return Park.objects.filter(name__icontains=query)
+```
+
+#### Review System
+```python
+# Basic review functionality
+class Review(models.Model):
+    # TODO: Enhance with:
+    # - Rich text support
+    # - Media attachments
+    # - Review responses
+    # - Helpful votes
+    rating = models.IntegerField()
+    comment = models.TextField()
+```
+
+### 2. Technical Improvements
+
+#### API Versioning
+```python
+# Current API structure
+# TODO: Implement proper API versioning
+urlpatterns = [
+    path('api/parks/', ParkViewSet.as_view()),
+    # Need to support:
+    # - Multiple versions
+    # - Deprecation handling
+    # - Documentation
+]
+```
+
+#### Caching Strategy
+```python
+# Basic caching
+# TODO: Implement:
+# - Multi-layer caching
+# - Cache warming
+# - Intelligent invalidation
+@cache_page(60 * 15)
+def park_detail(request, slug):
+    return render(request, 'park_detail.html')
+```
+
+### 3. Performance Optimizations
+
+#### Database Optimization
+```python
+# Current database usage
+# TODO: Implement:
+# - Connection pooling
+# - Read replicas
+# - Query optimization
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.postgresql',
+        'NAME': 'thrillwiki',
+    }
+}
+```
+
+#### Asset Delivery
+```python
+# Static file handling
+# TODO: Implement:
+# - CDN integration
+# - Image optimization pipeline
+# - Responsive images
+STATIC_URL = '/static/'
+MEDIA_URL = '/media/'
+```
+
+## Prioritized Improvements
+
+### High Priority
+1. Security Fixes
+   - Fix authentication vulnerabilities
+   - Implement proper input validation
+   - Secure file uploads
+
+2. Critical Performance Issues
+   - Resolve N+1 queries
+   - Implement connection pooling
+   - Optimize cache usage
+
+3. Data Integrity
+   - Fix race conditions
+   - Implement proper transactions
+   - Add data validation
+
+### Medium Priority
+1. Technical Debt
+   - Refactor monolithic views
+   - Consolidate duplicate code
+   - Improve test coverage
+
+2. Developer Experience
+   - Automate deployment
+   - Improve documentation
+   - Add development tools
+
+3. Feature Enhancements
+   - Implement advanced search
+   - Enhance review system
+   - Add API versioning
+
+### Low Priority
+1. Nice-to-have Features
+   - Rich text support
+   - Enhanced media handling
+   - Social features
+
+2. Infrastructure Improvements
+   - CDN integration
+   - Monitoring enhancements
+   - Analytics improvements
+
+## Implementation Plan
+
+### Phase 1: Critical Fixes
+```python
+# Timeline: Q1 2024
+# Focus:
+# - Security vulnerabilities
+# - Performance bottlenecks
+# - Data integrity issues
+```
+
+### Phase 2: Technical Debt
+```python
+# Timeline: Q2 2024
+# Focus:
+# - Code refactoring
+# - Test coverage
+# - Documentation
+```
+
+### Phase 3: Enhancements
+```python
+# Timeline: Q3-Q4 2024
+# Focus:
+# - Feature improvements
+# - Infrastructure upgrades
+# - User experience

memory-bank/documentation/Performance.md

@@ -0,0 +1,388 @@
+# Performance Documentation
+
+## Performance Architecture
+
+### Caching Strategy
+
+#### Cache Layers
+```python
+CACHES = {
+    'default': {
+        'BACKEND': 'django.core.cache.backends.redis.RedisCache',
+        'LOCATION': 'redis://127.0.0.1:6379/1',
+        'OPTIONS': {
+            'CLIENT_CLASS': 'django_redis.client.DefaultClient',
+            'PARSER_CLASS': 'redis.connection.HiredisParser',
+            'CONNECTION_POOL_CLASS': 'redis.BlockingConnectionPool',
+            'CONNECTION_POOL_CLASS_KWARGS': {
+                'max_connections': 50,
+                'timeout': 20,
+            }
+        }
+    }
+}
+```
+
+#### Cache Patterns
+```python
+# View caching
+@method_decorator(cache_page(60 * 15))
+def park_list(request):
+    parks = Park.objects.all()
+    return render(request, 'parks/list.html', {'parks': parks})
+
+# Template fragment caching
+{% load cache %}
+{% cache 300 park_detail park.id %}
+    ... expensive template logic ...
+{% endcache %}
+
+# Low-level cache API
+def get_park_stats(park_id):
+    cache_key = f'park_stats:{park_id}'
+    stats = cache.get(cache_key)
+    if stats is None:
+        stats = calculate_park_stats(park_id)
+        cache.set(cache_key, stats, timeout=3600)
+    return stats
+```
+
+### Database Optimization
+
+#### Query Optimization
+```python
+# Efficient querying patterns
+class ParkQuerySet(models.QuerySet):
+    def with_stats(self):
+        return self.annotate(
+            ride_count=Count('rides'),
+            avg_rating=Avg('reviews__rating')
+        ).select_related('owner')\
+         .prefetch_related('rides', 'areas')
+
+# Indexes
+class Park(models.Model):
+    class Meta:
+        indexes = [
+            models.Index(fields=['slug']),
+            models.Index(fields=['status', 'created_at']),
+            models.Index(fields=['location_id', 'status'])
+        ]
+```
+
+#### Database Configuration
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.postgresql',
+        'NAME': 'thrillwiki',
+        'CONN_MAX_AGE': 60,
+        'OPTIONS': {
+            'statement_timeout': 3000,
+            'idle_in_transaction_timeout': 3000,
+        },
+        'ATOMIC_REQUESTS': False,
+        'CONN_HEALTH_CHECKS': True,
+    }
+}
+```
+
+### Asset Optimization
+
+#### Static File Handling
+```python
+# WhiteNoise configuration
+STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'
+
+WHITENOISE_OPTIONS = {
+    'allow_all_origins': False,
+    'max_age': 31536000,  # 1 year
+    'compression_enabled': True,
+}
+```
+
+#### Media Optimization
+```python
+from PIL import Image
+
+def optimize_image(image_path):
+    with Image.open(image_path) as img:
+        # Convert to WebP
+        webp_path = f"{os.path.splitext(image_path)[0]}.webp"
+        img.save(webp_path, 'WebP', quality=85, method=6)
+        
+        # Create thumbnails
+        sizes = [(800, 600), (400, 300)]
+        for size in sizes:
+            thumb = img.copy()
+            thumb.thumbnail(size)
+            thumb_path = f"{os.path.splitext(image_path)[0]}_{size[0]}x{size[1]}.webp"
+            thumb.save(thumb_path, 'WebP', quality=85, method=6)
+```
+
+## Performance Monitoring
+
+### Application Monitoring
+
+#### APM Configuration
+```python
+MIDDLEWARE = [
+    'django_prometheus.middleware.PrometheusBeforeMiddleware',
+    # ... other middleware ...
+    'django_prometheus.middleware.PrometheusAfterMiddleware',
+]
+
+PROMETHEUS_METRICS = {
+    'scrape_interval': 15,
+    'namespace': 'thrillwiki',
+    'metrics_path': '/metrics',
+}
+```
+
+#### Custom Metrics
+```python
+from prometheus_client import Counter, Histogram
+
+# Request metrics
+http_requests_total = Counter(
+    'http_requests_total',
+    'Total HTTP requests',
+    ['method', 'endpoint', 'status']
+)
+
+# Response time metrics
+response_time = Histogram(
+    'response_time_seconds',
+    'Response time in seconds',
+    ['endpoint']
+)
+```
+
+### Performance Logging
+
+#### Logging Configuration
+```python
+LOGGING = {
+    'handlers': {
+        'performance': {
+            'level': 'INFO',
+            'class': 'logging.handlers.TimedRotatingFileHandler',
+            'filename': 'logs/performance.log',
+            'when': 'midnight',
+            'interval': 1,
+            'backupCount': 30,
+        }
+    },
+    'loggers': {
+        'performance': {
+            'handlers': ['performance'],
+            'level': 'INFO',
+            'propagate': False,
+        }
+    }
+}
+```
+
+#### Performance Logging Middleware
+```python
+class PerformanceMiddleware:
+    def __init__(self, get_response):
+        self.get_response = get_response
+        self.logger = logging.getLogger('performance')
+    
+    def __call__(self, request):
+        start_time = time.time()
+        response = self.get_response(request)
+        duration = time.time() - start_time
+        
+        self.logger.info({
+            'path': request.path,
+            'method': request.method,
+            'duration': duration,
+            'status': response.status_code
+        })
+        
+        return response
+```
+
+## Scaling Strategy
+
+### Application Scaling
+
+#### Asynchronous Tasks
+```python
+# Celery configuration
+CELERY_BROKER_URL = 'redis://localhost:6379/2'
+CELERY_RESULT_BACKEND = 'redis://localhost:6379/3'
+
+CELERY_TASK_ROUTES = {
+    'media.tasks.process_image': {'queue': 'media'},
+    'analytics.tasks.update_stats': {'queue': 'analytics'},
+}
+
+# Task definition
+@shared_task(rate_limit='100/m')
+def process_image(image_id):
+    image = Image.objects.get(id=image_id)
+    optimize_image(image.file.path)
+    create_thumbnails(image)
+```
+
+#### Load Balancing
+```nginx
+# Nginx configuration
+upstream thrillwiki {
+    least_conn;  # Least connections algorithm
+    server backend1.thrillwiki.com:8000;
+    server backend2.thrillwiki.com:8000;
+    server backend3.thrillwiki.com:8000;
+    
+    keepalive 32;
+}
+
+server {
+    listen 80;
+    server_name thrillwiki.com;
+    
+    location / {
+        proxy_pass http://thrillwiki;
+        proxy_http_version 1.1;
+        proxy_set_header Connection "";
+    }
+}
+```
+
+### Database Scaling
+
+#### Read Replicas
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.postgresql',
+        'NAME': 'thrillwiki',
+        # Primary DB configuration
+    },
+    'replica1': {
+        'ENGINE': 'django.db.backends.postgresql',
+        'NAME': 'thrillwiki',
+        # Read replica configuration
+    }
+}
+
+DATABASE_ROUTERS = ['core.db.PrimaryReplicaRouter']
+```
+
+#### Connection Pooling
+```python
+# Django DB configuration with PgBouncer
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.postgresql',
+        'OPTIONS': {
+            'application_name': 'thrillwiki',
+            'max_prepared_transactions': 0,
+        },
+        'POOL_OPTIONS': {
+            'POOL_SIZE': 20,
+            'MAX_OVERFLOW': 10,
+            'RECYCLE': 300,
+        }
+    }
+}
+```
+
+### Caching Strategy
+
+#### Multi-layer Caching
+```python
+# Cache configuration with fallback
+CACHES = {
+    'default': {
+        'BACKEND': 'django_redis.cache.RedisCache',
+        'LOCATION': 'redis://primary:6379/1',
+        'OPTIONS': {
+            'CLIENT_CLASS': 'django_redis.client.DefaultClient',
+            'MASTER_CACHE': True,
+        }
+    },
+    'replica': {
+        'BACKEND': 'django_redis.cache.RedisCache',
+        'LOCATION': 'redis://replica:6379/1',
+        'OPTIONS': {
+            'CLIENT_CLASS': 'django_redis.client.DefaultClient',
+        }
+    }
+}
+```
+
+#### Cache Invalidation
+```python
+class CacheInvalidationMixin:
+    def save(self, *args, **kwargs):
+        # Invalidate related caches
+        cache_keys = self.get_cache_keys()
+        cache.delete_many(cache_keys)
+        super().save(*args, **kwargs)
+    
+    def get_cache_keys(self):
+        # Return list of related cache keys
+        return [
+            f'park:{self.pk}',
+            f'park_stats:{self.pk}',
+            'park_list'
+        ]
+```
+
+## Performance Bottlenecks
+
+### Known Issues
+
+1. N+1 Query Patterns
+```python
+# Bad pattern
+for park in Park.objects.all():
+    print(park.rides.count())  # Causes N+1 queries
+
+# Solution
+parks = Park.objects.annotate(
+    ride_count=Count('rides')
+).all()
+```
+
+2. Memory Leaks
+```python
+# Memory leak in long-running tasks
+class LongRunningTask:
+    def __init__(self):
+        self.cache = {}
+    
+    def process(self, items):
+        # Clear cache periodically
+        if len(self.cache) > 1000:
+            self.cache.clear()
+```
+
+### Performance Tips
+
+1. Query Optimization
+```python
+# Use exists() for checking existence
+if Park.objects.filter(slug=slug).exists():
+    # Do something
+
+# Use values() for simple data
+parks = Park.objects.values('id', 'name')
+```
+
+2. Bulk Operations
+```python
+# Use bulk create
+Park.objects.bulk_create([
+    Park(name='Park 1'),
+    Park(name='Park 2')
+])
+
+# Use bulk update
+Park.objects.filter(status='CLOSED').update(
+    status='OPERATING'
+)

memory-bank/documentation/Security.md

@@ -0,0 +1,339 @@
+# Security Documentation
+
+## Authentication System
+
+### Authentication Stack
+```python
+# Settings configuration
+AUTHENTICATION_BACKENDS = [
+    'django.contrib.auth.backends.ModelBackend',
+    'allauth.account.auth_backends.AuthenticationBackend',
+]
+
+INSTALLED_APPS = [
+    'django.contrib.auth',
+    'django.contrib.sessions',
+    'allauth',
+    'allauth.account',
+    'allauth.socialaccount',
+    'oauth2_provider',
+]
+```
+
+### Authentication Flow
+```mermaid
+sequenceDiagram
+    User->>+Server: Login Request
+    Server->>+Auth Service: Validate Credentials
+    Auth Service->>+Database: Check User
+    Database-->>-Auth Service: User Data
+    Auth Service-->>-Server: Auth Token
+    Server-->>-User: Session Cookie
+```
+
+## Authorization Framework
+
+### Permission System
+
+#### Model Permissions
+```python
+class Park(models.Model):
+    class Meta:
+        permissions = [
+            ("can_publish_park", "Can publish park"),
+            ("can_moderate_park", "Can moderate park"),
+            ("can_verify_park", "Can verify park information"),
+        ]
+```
+
+#### View Permissions
+```python
+class ModeratedCreateView(LoginRequiredMixin, PermissionRequiredMixin):
+    permission_required = 'parks.can_publish_park'
+    raise_exception = True
+```
+
+### Role-Based Access Control
+
+#### User Groups
+1. Administrators
+   - Full system access
+   - Configuration management
+   - User management
+
+2. Moderators
+   - Content moderation
+   - User management
+   - Report handling
+
+3. Company Representatives
+   - Company profile management
+   - Official updates
+   - Response management
+
+4. Regular Users
+   - Content creation
+   - Review submission
+   - Media uploads
+
+#### Permission Matrix
+```python
+ROLE_PERMISSIONS = {
+    'administrator': [
+        'can_manage_users',
+        'can_configure_system',
+        'can_moderate_content',
+    ],
+    'moderator': [
+        'can_moderate_content',
+        'can_manage_reports',
+        'can_verify_information',
+    ],
+    'company_rep': [
+        'can_manage_company',
+        'can_post_updates',
+        'can_respond_reviews',
+    ],
+    'user': [
+        'can_create_content',
+        'can_submit_reviews',
+        'can_upload_media',
+    ],
+}
+```
+
+## Security Controls
+
+### Request Security
+
+#### CSRF Protection
+```python
+MIDDLEWARE = [
+    'django.middleware.csrf.CsrfViewMiddleware',
+]
+
+# Template configuration
+{% csrf_token %}
+
+# AJAX request handling
+headers: {
+    'X-CSRFToken': getCookie('csrftoken')
+}
+```
+
+#### XSS Prevention
+```python
+# Template autoescape
+{% autoescape on %}
+    {{ user_content }}
+{% endautoescape %}
+
+# Content Security Policy
+CSP_DEFAULT_SRC = ("'self'",)
+CSP_SCRIPT_SRC = ("'self'",)
+CSP_STYLE_SRC = ("'self'", "'unsafe-inline'")
+CSP_IMG_SRC = ("'self'", "data:", "https:")
+```
+
+### Data Protection
+
+#### Password Security
+```python
+# Password validation
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
+        'OPTIONS': {
+            'min_length': 12,
+        }
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
+    },
+]
+```
+
+#### Data Encryption
+```python
+# Database encryption
+ENCRYPTED_FIELDS = {
+    'fields': {
+        'users.User.ssn': 'django_cryptography.fields.encrypt',
+        'payment.Card.number': 'django_cryptography.fields.encrypt',
+    },
+}
+
+# File encryption
+ENCRYPTED_FILE_STORAGE = 'django_cryptography.storage.EncryptedFileSystemStorage'
+```
+
+### Session Security
+
+#### Session Configuration
+```python
+# Session settings
+SESSION_COOKIE_SECURE = True
+SESSION_COOKIE_HTTPONLY = True
+SESSION_COOKIE_SAMESITE = 'Lax'
+SESSION_ENGINE = 'django.contrib.sessions.backends.cached_db'
+SESSION_EXPIRE_AT_BROWSER_CLOSE = True
+```
+
+#### Session Management
+```python
+# Session cleanup
+CELERYBEAT_SCHEDULE = {
+    'cleanup-expired-sessions': {
+        'task': 'core.tasks.cleanup_expired_sessions',
+        'schedule': crontab(hour=4, minute=0)
+    },
+}
+```
+
+## API Security
+
+### Authentication
+```python
+REST_FRAMEWORK = {
+    'DEFAULT_AUTHENTICATION_CLASSES': [
+        'rest_framework_jwt.authentication.JSONWebTokenAuthentication',
+        'rest_framework.authentication.SessionAuthentication',
+    ],
+    'DEFAULT_PERMISSION_CLASSES': [
+        'rest_framework.permissions.IsAuthenticated',
+    ],
+}
+```
+
+### Rate Limiting
+```python
+# Rate limiting configuration
+REST_FRAMEWORK = {
+    'DEFAULT_THROTTLE_CLASSES': [
+        'rest_framework.throttling.AnonRateThrottle',
+        'rest_framework.throttling.UserRateThrottle'
+    ],
+    'DEFAULT_THROTTLE_RATES': {
+        'anon': '100/day',
+        'user': '1000/day'
+    }
+}
+```
+
+## Security Headers
+
+### HTTP Security Headers
+```python
+MIDDLEWARE = [
+    'django.middleware.security.SecurityMiddleware',
+]
+
+SECURE_HSTS_SECONDS = 31536000
+SECURE_HSTS_INCLUDE_SUBDOMAINS = True
+SECURE_HSTS_PRELOAD = True
+SECURE_SSL_REDIRECT = True
+SECURE_REFERRER_POLICY = 'same-origin'
+SECURE_BROWSER_XSS_FILTER = True
+```
+
+## File Upload Security
+
+### Upload Configuration
+```python
+# File upload settings
+FILE_UPLOAD_MAX_MEMORY_SIZE = 2621440  # 2.5 MB
+FILE_UPLOAD_PERMISSIONS = 0o644
+ALLOWED_EXTENSIONS = ['jpg', 'jpeg', 'png', 'gif']
+
+def validate_file_extension(value):
+    ext = os.path.splitext(value.name)[1]
+    if not ext.lower() in ALLOWED_EXTENSIONS:
+        raise ValidationError('Unsupported file extension.')
+```
+
+### Media Security
+```python
+# Serve media files securely
+@login_required
+def serve_protected_file(request, path):
+    if not request.user.has_perm('can_access_file'):
+        raise PermissionDenied
+    response = serve(request, path, document_root=settings.MEDIA_ROOT)
+    response['Content-Disposition'] = 'attachment'
+    return response
+```
+
+## Security Monitoring
+
+### Audit Logging
+```python
+# Audit log configuration
+AUDIT_LOG_HANDLERS = {
+    'security': {
+        'level': 'INFO',
+        'class': 'logging.handlers.RotatingFileHandler',
+        'filename': 'logs/security.log',
+        'maxBytes': 1024*1024*5,  # 5 MB
+        'backupCount': 5,
+    },
+}
+
+# Audit log usage
+def log_security_event(event_type, user, details):
+    logger.info(f'Security event: {event_type}', extra={
+        'user_id': user.id,
+        'ip_address': get_client_ip(request),
+        'details': details
+    })
+```
+
+### Security Alerts
+```python
+# Alert configuration
+SECURITY_ALERTS = {
+    'login_attempts': {
+        'threshold': 5,
+        'window': 300,  # 5 minutes
+        'action': 'account_lock'
+    },
+    'api_errors': {
+        'threshold': 100,
+        'window': 3600,  # 1 hour
+        'action': 'notify_admin'
+    }
+}
+```
+
+## Incident Response
+
+### Security Incident Workflow
+1. Detection
+2. Analysis
+3. Containment
+4. Eradication
+5. Recovery
+6. Lessons Learned
+
+### Response Actions
+```python
+class SecurityIncident:
+    def contain_threat(self):
+        # Lock affected accounts
+        # Block suspicious IPs
+        # Disable compromised tokens
+        
+    def investigate(self):
+        # Collect logs
+        # Analyze patterns
+        # Document findings
+        
+    def recover(self):
+        # Restore systems
+        # Reset credentials
+        # Update security controls

memory-bank/documentation/Testing.md

@@ -0,0 +1,350 @@
+# Testing Documentation
+
+## Testing Architecture
+
+### Test Organization
+```
+tests/
+├── unit/
+│   ├── test_models.py
+│   ├── test_views.py
+│   └── test_forms.py
+├── integration/
+│   ├── test_workflows.py
+│   └── test_apis.py
+└── e2e/
+    └── test_user_journeys.py
+```
+
+### Test Configuration
+```python
+# pytest configuration
+pytest_plugins = [
+    "tests.fixtures.parks",
+    "tests.fixtures.users",
+    "tests.fixtures.media"
+]
+
+# Test settings
+TEST_RUNNER = 'django.test.runner.DiscoverRunner'
+TEST_MODE = True
+```
+
+## Test Types
+
+### Unit Tests
+
+#### Model Tests
+```python
+class ParkModelTest(TestCase):
+    def setUp(self):
+        self.park = Park.objects.create(
+            name="Test Park",
+            status="OPERATING"
+        )
+    
+    def test_slug_generation(self):
+        self.assertEqual(self.park.slug, "test-park")
+    
+    def test_status_validation(self):
+        with self.assertRaises(ValidationError):
+            Park.objects.create(
+                name="Invalid Park",
+                status="INVALID"
+            )
+```
+
+#### View Tests
+```python
+class ParkViewTest(TestCase):
+    def setUp(self):
+        self.client = Client()
+        self.user = User.objects.create_user(
+            username="testuser",
+            [PASSWORD-REMOVED]"
+        )
+    
+    def test_park_list_view(self):
+        response = self.client.get(reverse('parks:list'))
+        self.assertEqual(response.status_code, 200)
+        self.assertTemplateUsed(response, 'parks/park_list.html')
+```
+
+#### Form Tests
+```python
+class RideFormTest(TestCase):
+    def test_valid_form(self):
+        form = RideForm({
+            'name': 'Test Ride',
+            'status': 'OPERATING',
+            'height_requirement': 48
+        })
+        self.assertTrue(form.is_valid())
+```
+
+### Integration Tests
+
+#### Workflow Tests
+```python
+class ReviewWorkflowTest(TestCase):
+    def test_review_moderation_flow(self):
+        # Create review
+        review = self.create_review()
+        
+        # Submit for moderation
+        response = self.client.post(
+            reverse('reviews:submit_moderation', 
+                   kwargs={'pk': review.pk})
+        )
+        self.assertEqual(review.refresh_from_db().status, 'PENDING')
+        
+        # Approve review
+        moderator = self.create_moderator()
+        self.client.force_login(moderator)
+        response = self.client.post(
+            reverse('reviews:approve', 
+                   kwargs={'pk': review.pk})
+        )
+        self.assertEqual(review.refresh_from_db().status, 'APPROVED')
+```
+
+#### API Tests
+```python
+class ParkAPITest(APITestCase):
+    def test_park_list_api(self):
+        url = reverse('api:park-list')
+        response = self.client.get(url)
+        self.assertEqual(response.status_code, 200)
+    
+    def test_park_create_api(self):
+        url = reverse('api:park-create')
+        data = {
+            'name': 'New Park',
+            'status': 'OPERATING'
+        }
+        response = self.client.post(url, data, format='json')
+        self.assertEqual(response.status_code, 201)
+```
+
+### End-to-End Tests
+
+#### User Journey Tests
+```python
+class UserJourneyTest(LiveServerTestCase):
+    def test_park_review_journey(self):
+        # User logs in
+        self.login_user()
+        
+        # Navigate to park
+        self.browser.get(f'{self.live_server_url}/parks/test-park/')
+        
+        # Create review
+        self.browser.find_element_by_id('write-review').click()
+        self.browser.find_element_by_id('review-text').send_keys('Great park!')
+        self.browser.find_element_by_id('submit').click()
+        
+        # Verify review appears
+        review_element = self.browser.find_element_by_class_name('review-item')
+        self.assertIn('Great park!', review_element.text)
+```
+
+## CI/CD Pipeline
+
+### GitHub Actions Configuration
+```yaml
+name: ThrillWiki CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    services:
+      postgres:
+        image: postgres:13
+        env:
+          POSTGRES_PASSWORD: postgres
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 5432:5432
+          
+    steps:
+    - uses: actions/checkout@v2
+    
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.11'
+        
+    - name: Install Dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+        
+    - name: Run Tests
+      env:
+        DATABASE_URL: postgres://postgres:postgres@localhost:5432/thrillwiki_test
+      run: |
+        pytest --cov=./ --cov-report=xml
+        
+    - name: Upload Coverage
+      uses: codecov/codecov-action@v1
+```
+
+## Quality Metrics
+
+### Code Coverage
+```python
+# Coverage configuration
+[coverage:run]
+source = .
+omit = 
+    */migrations/*
+    */tests/*
+    manage.py
+
+[coverage:report]
+exclude_lines =
+    pragma: no cover
+    def __str__
+    raise NotImplementedError
+```
+
+### Code Quality Tools
+```python
+# flake8 configuration
+[flake8]
+max-line-length = 88
+extend-ignore = E203
+exclude = .git,__pycache__,build,dist
+
+# black configuration
+[tool.black]
+line-length = 88
+target-version = ['py311']
+include = '\.pyi?$'
+```
+
+## Test Data Management
+
+### Fixtures
+```python
+# fixtures/parks.json
+[
+    {
+        "model": "parks.park",
+        "pk": 1,
+        "fields": {
+            "name": "Test Park",
+            "slug": "test-park",
+            "status": "OPERATING"
+        }
+    }
+]
+```
+
+### Factory Classes
+```python
+from factory.django import DjangoModelFactory
+
+class ParkFactory(DjangoModelFactory):
+    class Meta:
+        model = Park
+    
+    name = factory.Sequence(lambda n: f'Test Park {n}')
+    status = 'OPERATING'
+```
+
+## Performance Testing
+
+### Load Testing
+```python
+from locust import HttpUser, task, between
+
+class ParkUser(HttpUser):
+    wait_time = between(1, 3)
+    
+    @task
+    def view_park_list(self):
+        self.client.get("/parks/")
+    
+    @task
+    def view_park_detail(self):
+        self.client.get("/parks/test-park/")
+```
+
+### Benchmark Tests
+```python
+class ParkBenchmarkTest(TestCase):
+    def test_park_list_performance(self):
+        start_time = time.time()
+        Park.objects.all().select_related('owner')
+        end_time = time.time()
+        
+        self.assertLess(end_time - start_time, 0.1)
+```
+
+## Test Automation
+
+### Test Runner Configuration
+```python
+# Custom test runner
+class CustomTestRunner(DiscoverRunner):
+    def setup_databases(self, **kwargs):
+        # Custom database setup
+        return super().setup_databases(**kwargs)
+    
+    def teardown_databases(self, old_config, **kwargs):
+        # Custom cleanup
+        return super().teardown_databases(old_config, **kwargs)
+```
+
+### Automated Test Execution
+```bash
+# Test execution script
+#!/bin/bash
+
+# Run unit tests
+pytest tests/unit/
+
+# Run integration tests
+pytest tests/integration/
+
+# Run e2e tests
+pytest tests/e2e/
+
+# Generate coverage report
+coverage run -m pytest
+coverage report
+coverage html
+```
+
+## Monitoring and Reporting
+
+### Test Reports
+```python
+# pytest-html configuration
+pytest_html_report_title = "ThrillWiki Test Report"
+
+def pytest_html_report_data(report):
+    report.description = "Test Results for ThrillWiki"
+```
+
+### Coverage Reports
+```python
+# Coverage reporting configuration
+COVERAGE_REPORT_OPTIONS = {
+    'report_type': 'html',
+    'directory': 'coverage_html',
+    'title': 'ThrillWiki Coverage Report',
+    'show_contexts': True
+}

memory-bank/features/autocomplete/base.md

@@ -0,0 +1,63 @@
+# Base Autocomplete Implementation
+
+The project uses `django-htmx-autocomplete` with a custom base implementation to ensure consistent behavior across all autocomplete widgets.
+
+## BaseAutocomplete Class
+
+Located in `core/forms.py`, the `BaseAutocomplete` class provides project-wide defaults and standardization:
+
+```python
+from core.forms import BaseAutocomplete
+
+class MyModelAutocomplete(BaseAutocomplete):
+    model = MyModel
+    search_attrs = ['name', 'description']
+```
+
+### Features
+
+- **Authentication Enforcement**: Requires user authentication by default
+  - Controlled via `AUTOCOMPLETE_BLOCK_UNAUTHENTICATED` setting
+  - Override `auth_check()` for custom auth logic
+
+- **Search Configuration**
+  - `minimum_search_length = 2` - More responsive than default 3
+  - `max_results = 10` - Optimized for performance
+
+- **Internationalization**
+  - All text strings use Django's translation system
+  - Customizable messages through class attributes
+
+### Usage Guidelines
+
+1. Always extend `BaseAutocomplete` instead of using `autocomplete.Autocomplete` directly
+2. Configure search_attrs based on your model's indexed fields
+3. Use the AutocompleteWidget with proper options:
+
+```python
+class MyForm(forms.ModelForm):
+    class Meta:
+        model = MyModel
+        fields = ['related_field']
+        widgets = {
+            'related_field': AutocompleteWidget(
+                ac_class=MyModelAutocomplete,
+                options={
+                    "multiselect": True,  # For M2M fields
+                    "placeholder": "Custom placeholder..."  # Optional
+                }
+            )
+        }
+```
+
+### Performance Considerations
+
+- Keep `search_attrs` minimal and indexed
+- Use `select_related`/`prefetch_related` in custom querysets
+- Consider caching for frequently used results
+
+### Security Notes
+
+- Authentication required by default
+- Implements proper CSRF protection via HTMX
+- Rate limiting should be implemented at the web server level

memory-bank/features/parks/search.md

@@ -0,0 +1,130 @@
+# Park Search Implementation
+
+## Search Flow
+
+1. **Quick Search (Suggestions)**
+   - Endpoint: `suggest_parks/`
+   - Shows up to 8 suggestions
+   - Uses HTMX for real-time updates
+   - 300ms debounce for typing
+
+2. **Full Search**
+   - Endpoint: `parks:park_list`
+   - Shows all matching results
+   - Supports view modes (grid/list)
+   - Integrates with filter system
+
+## Implementation Details
+
+### Frontend Components
+- Search input using built-in HTMX and Alpine.js
+  ```html
+  <div x-data="{ query: '', selectedId: null }"
+       @search-selected.window="...">
+    <form hx-get="..." hx-trigger="input changed delay:300ms">
+      <!-- Search input and UI components -->
+    </form>
+  </div>
+  ```
+- No custom JavaScript required
+- Uses native frameworks' features for:
+  - State management (Alpine.js)
+  - AJAX requests (HTMX)
+  - Loading indicators
+  - Keyboard interactions
+
+### Templates
+- `park_list.html`: Main search interface
+- `park_suggestions.html`: Partial for search suggestions
+- `park_list_item.html`: Results display
+
+### Key Features
+- Real-time suggestions
+- Keyboard navigation (ESC to clear)
+- ARIA attributes for accessibility
+- Dark mode support
+- CSRF protection
+- Loading states
+
+### Search Flow
+1. User types in search box
+2. After 300ms debounce, HTMX sends request
+3. Server returns suggestion list
+4. User selects item
+5. Form submits to main list view with filter
+6. Results update while maintaining view mode
+
+## Recent Updates (2024-02-22)
+1. Fixed search page loading issue:
+   - Removed legacy redirect in suggest_parks
+   - Updated search form to use HTMX properly
+   - Added Alpine.js for state management
+   - Improved suggestions UI
+   - Maintained view mode during search
+
+2. Security:
+   - CSRF protection on all forms
+   - Input sanitization
+   - Proper parameter handling
+
+3. Performance:
+   - 300ms debounce on typing
+   - Limit suggestions to 8 items
+   - Efficient query optimization
+
+4. Accessibility:
+    - ARIA labels and roles
+    - Keyboard navigation
+    - Proper focus management
+    - Screen reader support
+
+## API Response Format
+
+### Suggestions Endpoint (`/parks/suggest_parks/`)
+```json
+{
+  "results": [
+    {
+      "id": "string",
+      "name": "string",
+      "status": "string",
+      "location": "string",
+      "url": "string"
+    }
+  ]
+}
+```
+
+### Field Details
+- `id`: Database ID (string format)
+- `name`: Park name
+- `status`: Formatted status display (e.g., "Operating")
+- `location`: Formatted location string
+- `url`: Full detail page URL
+
+## Test Coverage
+
+### API Tests
+- JSON format validation
+- Empty search handling
+- Field type checking
+- Result limit verification
+- Response structure
+
+### UI Integration Tests
+- View mode persistence
+- Loading state verification
+- Error handling
+- Keyboard interaction
+
+### Data Format Tests
+- Location string formatting
+- Status display formatting
+- URL generation
+- Field type validation
+
+### Performance Tests
+- Debounce functionality
+- Result limiting (8 items)
+- Query optimization
+- Response timing

memory-bank/features/search_improvements.md

@@ -0,0 +1,119 @@
+# Search Functionality Improvement Plan
+
+## Technical Implementation Details
+
+### 1. Database Optimization
+```python
+# parks/models.py
+from django.contrib.postgres.indexes import GinIndex
+
+class Park(models.Model):
+    class Meta:
+        indexes = [
+            GinIndex(fields=['name', 'description'], 
+                   name='search_gin_idx',
+                   opclasses=['gin_trgm_ops', 'gin_trgm_ops']),
+            Index(fields=['location__address_text'], name='location_addr_idx')
+        ]
+
+# search/services.py
+from django.db.models import F, Func
+from analytics.models import SearchMetric
+
+class SearchEngine:
+    @classmethod
+    def execute_search(cls, request, filterset_class):
+        with timeit() as timer:
+            filterset = filterset_class(request.GET, queryset=cls.base_queryset())
+            qs = filterset.qs
+            results = qs.annotate(
+                search_rank=Func(F('name'), F('description'),
+                               function='ts_rank')
+            ).order_by('-search_rank')
+            
+        SearchMetric.record(
+            query_params=dict(request.GET),
+            result_count=qs.count(),
+            duration=timer.elapsed
+        )
+        return results
+```
+
+### 2. Architectural Changes
+```python
+# search/filters.py (simplified explicit filter)
+class ParkFilter(SearchableFilterMixin, django_filters.FilterSet):
+    search_fields = ['name', 'description', 'location__address_text']
+    
+    class Meta:
+        model = Park
+        fields = {
+            'ride_count': ['gte', 'lte'],
+            'coaster_count': ['gte', 'lte'],
+            'average_rating': ['gte', 'lte']
+        }
+
+# search/views.py (updated)
+class AdaptiveSearchView(TemplateView):
+    def get_queryset(self):
+        return SearchEngine.base_queryset()
+    
+    def get_filterset(self):
+        return ParkFilter(self.request.GET, queryset=self.get_queryset())
+```
+
+### 3. Frontend Enhancements
+```javascript
+// static/js/search.js
+const searchInput = document.getElementById('search-input');
+let timeoutId;
+
+searchInput.addEventListener('input', () => {
+  clearTimeout(timeoutId);
+  timeoutId = setTimeout(() => {
+    fetchResults(searchInput.value);
+  }, 300);
+});
+
+async function fetchResults(query) {
+  try {
+    const response = await fetch(`/search/?search=${encodeURIComponent(query)}`);
+    if (!response.ok) throw new Error(response.statusText);
+    const html = await response.text();
+    updateResults(html);
+  } catch (error) {
+    showError(`Search failed: ${error.message}`);
+  }
+}
+```
+
+## Implementation Roadmap
+
+1. Database Migrations
+```bash
+uv run manage.py makemigrations parks --name add_search_indexes
+uv run manage.py migrate
+```
+
+2. Service Layer Integration
+- Create search/services.py with query instrumentation
+- Update all views to use SearchEngine class
+
+3. Frontend Updates
+- Add debouncing to search inputs
+- Implement error handling UI components
+- Add loading spinner component
+
+4. Monitoring Setup
+```python
+# analytics/models.py
+class SearchMetric(models.Model):
+    query_params = models.JSONField()
+    result_count = models.IntegerField()
+    duration = models.FloatField()
+    created_at = models.DateTimeField(auto_now_add=True)
+```
+
+5. Performance Testing
+- Use django-debug-toolbar for query analysis
+- Generate load tests with locust.io

memory-bank/systemPatterns.md

@@ -21,6 +21,23 @@
    - Implement component-based structure
    - Follow progressive enhancement
 
+### Static Files Organization
+1. Directory Structure
+   - `static/` - Source static files (CSS, JS, images, etc.)
+   - `staticfiles/` - Collected files (generated by collectstatic)
+
+2. File Management Rules
+   - Place all source static files in `static/` directory
+   - Never directly modify `staticfiles/` directory
+   - Use Django's `static` template tag for references
+   - Run collectstatic before deployment
+
+3. Benefits of Separation
+   - Clear distinction between source and compiled files
+   - Prevents confusion in development vs production
+   - Follows Django best practices
+   - Simplifies deployment process
+
 ## Design Patterns
 
 ### Data Access
@@ -161,6 +178,22 @@ class ViewTests(TestCase):
 
 ## Development Workflows
 
+### Package Management
+IMPORTANT: When adding Python packages to the project, only use UV:
+```bash
+uv add <package>
+```
+Do not attempt to install packages using any other method (pip, poetry, etc.).
+
+### Development Server Management
+Server Startup Process
+IMPORTANT: Always execute the following command exactly as shown to start the development server:
+```bash
+lsof -ti :8000 | xargs kill -9; find . -type d -name "__pycache__" -exec rm -r {} +; uv run manage.py tailwind runserver
+```
+
+Note: These steps must be executed in this exact order as a single command to ensure consistent behavior.
+
 ### Feature Development
 1. Planning
    - Technical specification

moderation/migrations/0002_remove_editsubmission_insert_insert_and_more.py

@@ -0,0 +1,123 @@
+# Generated by Django 5.1.4 on 2025-02-21 17:55
+
+import pgtrigger.compiler
+import pgtrigger.migrations
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("moderation", "0001_initial"),
+    ]
+
+    operations = [
+        pgtrigger.migrations.RemoveTrigger(
+            model_name="editsubmission",
+            name="insert_insert",
+        ),
+        pgtrigger.migrations.RemoveTrigger(
+            model_name="editsubmission",
+            name="update_update",
+        ),
+        pgtrigger.migrations.RemoveTrigger(
+            model_name="photosubmission",
+            name="insert_insert",
+        ),
+        pgtrigger.migrations.RemoveTrigger(
+            model_name="photosubmission",
+            name="update_update",
+        ),
+        migrations.AddField(
+            model_name="editsubmission",
+            name="updated_at",
+            field=models.DateTimeField(auto_now=True),
+        ),
+        migrations.AddField(
+            model_name="editsubmissionevent",
+            name="updated_at",
+            field=models.DateTimeField(auto_now=True),
+        ),
+        migrations.AddField(
+            model_name="photosubmission",
+            name="updated_at",
+            field=models.DateTimeField(auto_now=True),
+        ),
+        migrations.AddField(
+            model_name="photosubmissionevent",
+            name="updated_at",
+            field=models.DateTimeField(auto_now=True),
+        ),
+        migrations.AlterField(
+            model_name="editsubmission",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="photosubmission",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+        pgtrigger.migrations.AddTrigger(
+            model_name="editsubmission",
+            trigger=pgtrigger.compiler.Trigger(
+                name="insert_insert",
+                sql=pgtrigger.compiler.UpsertTriggerSql(
+                    func='INSERT INTO "moderation_editsubmissionevent" ("changes", "content_type_id", "created_at", "handled_at", "handled_by_id", "id", "moderator_changes", "notes", "object_id", "pgh_context_id", "pgh_created_at", "pgh_label", "pgh_obj_id", "reason", "source", "status", "submission_type", "updated_at", "user_id") VALUES (NEW."changes", NEW."content_type_id", NEW."created_at", NEW."handled_at", NEW."handled_by_id", NEW."id", NEW."moderator_changes", NEW."notes", NEW."object_id", _pgh_attach_context(), NOW(), \'insert\', NEW."id", NEW."reason", NEW."source", NEW."status", NEW."submission_type", NEW."updated_at", NEW."user_id"); RETURN NULL;',
+                    hash="[AWS-SECRET-REMOVED]",
+                    operation="INSERT",
+                    pgid="pgtrigger_insert_insert_2c796",
+                    table="moderation_editsubmission",
+                    when="AFTER",
+                ),
+            ),
+        ),
+        pgtrigger.migrations.AddTrigger(
+            model_name="editsubmission",
+            trigger=pgtrigger.compiler.Trigger(
+                name="update_update",
+                sql=pgtrigger.compiler.UpsertTriggerSql(
+                    condition="WHEN (OLD.* IS DISTINCT FROM NEW.*)",
+                    func='INSERT INTO "moderation_editsubmissionevent" ("changes", "content_type_id", "created_at", "handled_at", "handled_by_id", "id", "moderator_changes", "notes", "object_id", "pgh_context_id", "pgh_created_at", "pgh_label", "pgh_obj_id", "reason", "source", "status", "submission_type", "updated_at", "user_id") VALUES (NEW."changes", NEW."content_type_id", NEW."created_at", NEW."handled_at", NEW."handled_by_id", NEW."id", NEW."moderator_changes", NEW."notes", NEW."object_id", _pgh_attach_context(), NOW(), \'update\', NEW."id", NEW."reason", NEW."source", NEW."status", NEW."submission_type", NEW."updated_at", NEW."user_id"); RETURN NULL;',
+                    hash="[AWS-SECRET-REMOVED]",
+                    operation="UPDATE",
+                    pgid="pgtrigger_update_update_ab38f",
+                    table="moderation_editsubmission",
+                    when="AFTER",
+                ),
+            ),
+        ),
+        pgtrigger.migrations.AddTrigger(
+            model_name="photosubmission",
+            trigger=pgtrigger.compiler.Trigger(
+                name="insert_insert",
+                sql=pgtrigger.compiler.UpsertTriggerSql(
+                    func='INSERT INTO "moderation_photosubmissionevent" ("caption", "content_type_id", "created_at", "date_taken", "handled_at", "handled_by_id", "id", "notes", "object_id", "pgh_context_id", "pgh_created_at", "pgh_label", "pgh_obj_id", "photo", "status", "updated_at", "user_id") VALUES (NEW."caption", NEW."content_type_id", NEW."created_at", NEW."date_taken", NEW."handled_at", NEW."handled_by_id", NEW."id", NEW."notes", NEW."object_id", _pgh_attach_context(), NOW(), \'insert\', NEW."id", NEW."photo", NEW."status", NEW."updated_at", NEW."user_id"); RETURN NULL;',
+                    hash="[AWS-SECRET-REMOVED]",
+                    operation="INSERT",
+                    pgid="pgtrigger_insert_insert_62865",
+                    table="moderation_photosubmission",
+                    when="AFTER",
+                ),
+            ),
+        ),
+        pgtrigger.migrations.AddTrigger(
+            model_name="photosubmission",
+            trigger=pgtrigger.compiler.Trigger(
+                name="update_update",
+                sql=pgtrigger.compiler.UpsertTriggerSql(
+                    condition="WHEN (OLD.* IS DISTINCT FROM NEW.*)",
+                    func='INSERT INTO "moderation_photosubmissionevent" ("caption", "content_type_id", "created_at", "date_taken", "handled_at", "handled_by_id", "id", "notes", "object_id", "pgh_context_id", "pgh_created_at", "pgh_label", "pgh_obj_id", "photo", "status", "updated_at", "user_id") VALUES (NEW."caption", NEW."content_type_id", NEW."created_at", NEW."date_taken", NEW."handled_at", NEW."handled_by_id", NEW."id", NEW."notes", NEW."object_id", _pgh_attach_context(), NOW(), \'update\', NEW."id", NEW."photo", NEW."status", NEW."updated_at", NEW."user_id"); RETURN NULL;',
+                    hash="[AWS-SECRET-REMOVED]",
+                    operation="UPDATE",
+                    pgid="pgtrigger_update_update_9c311",
+                    table="moderation_photosubmission",
+                    when="AFTER",
+                ),
+            ),
+        ),
+    ]

parks/autocomplete.py

@@ -0,0 +1,15 @@
+from autocomplete import ModelAutocomplete
+from .models import Park
+
+
+class ParkAutocomplete(ModelAutocomplete):
+    """Autocomplete class for Park model."""
+    model = Park
+    search_attrs = ['name', 'city', 'state', 'country']  # Fields to search
+    minimum_search_length = 2  # Start searching after 2 characters
+    max_results = 8  # Limit to 8 suggestions
+    
+    # Customize display text
+    no_result_text = "No parks found matching your search."
+    narrow_search_text = "Showing %(page_size)s of %(total)s parks. Try narrowing your search."
+    type_at_least_n_characters = "Type at least %(n)s characters to search parks"

parks/filters.py

@@ -12,7 +12,7 @@ from django_filters import (
     BooleanFilter
 )
 from .models import Park
-from .views import get_base_park_queryset
+from .querysets import get_base_park_queryset
 from companies.models import Company
 
 def validate_positive_integer(value):
@@ -31,44 +31,66 @@ class ParkFilter(LocationFilterMixin, RatingFilterMixin, DateRangeFilterMixin, F
         model = Park
         fields = []
 
-    # Search field
-    search = CharFilter(method='filter_search')
+    # Search field with better description
+    search = CharFilter(
+        method='filter_search',
+        label=_("Search Parks"),
+        help_text=_("Search by park name, description, or location")
+    )
 
-    # Status filter
+    # Status filter with clearer label
     status = ChoiceFilter(
         field_name='status',
         choices=Park._meta.get_field('status').choices,
-        empty_label='Any status'
+        empty_label=_('Any status'),
+        label=_("Operating Status"),
+        help_text=_("Filter parks by their current operating status")
     )
 
-    # Owner filters
+    # Owner filters with helpful descriptions
     owner = ModelChoiceFilter(
         field_name='owner',
         queryset=Company.objects.all(),
-        empty_label='Any company'
+        empty_label=_('Any company'),
+        label=_("Operating Company"),
+        help_text=_("Filter parks by their operating company")
+    )
+    has_owner = BooleanFilter(
+        method='filter_has_owner',
+        label=_("Company Status"),
+        help_text=_("Show parks with or without an operating company")
     )
-    has_owner = BooleanFilter(method='filter_has_owner')
 
-    # Numeric filters
+    # Ride and attraction filters
     min_rides = NumberFilter(
         field_name='current_ride_count',
         lookup_expr='gte',
-        validators=[validate_positive_integer]
+        validators=[validate_positive_integer],
+        label=_("Minimum Rides"),
+        help_text=_("Show parks with at least this many rides")
     )
     min_coasters = NumberFilter(
         field_name='current_coaster_count',
         lookup_expr='gte',
-        validators=[validate_positive_integer]
+        validators=[validate_positive_integer],
+        label=_("Minimum Roller Coasters"),
+        help_text=_("Show parks with at least this many roller coasters")
     )
+
+    # Size filter
     min_size = NumberFilter(
         field_name='size_acres',
         lookup_expr='gte',
-        validators=[validate_positive_integer]
+        validators=[validate_positive_integer],
+        label=_("Minimum Size (acres)"),
+        help_text=_("Show parks of at least this size in acres")
     )
 
-    # Date filter
+    # Opening date filter with better label
     opening_date = DateFromToRangeFilter(
-        field_name='opening_date'
+        field_name='opening_date',
+        label=_("Opening Date Range"),
+        help_text=_("Filter parks by their opening date")
     )
 
     def filter_search(self, queryset, name, value):
@@ -94,8 +116,9 @@ class ParkFilter(LocationFilterMixin, RatingFilterMixin, DateRangeFilterMixin, F
     def filter_has_owner(self, queryset, name, value):
         """Filter parks based on whether they have an owner"""
         return queryset.filter(owner__isnull=not value)
-@property
-def qs(self):
+    
+    @property
+    def qs(self):
         """Override qs property to ensure we always use base queryset with annotations"""
         if not hasattr(self, '_qs'):
             # Start with the base queryset that includes annotations

parks/forms.py

@@ -1,7 +1,55 @@
 from django import forms
 from decimal import Decimal, InvalidOperation, ROUND_DOWN
+from autocomplete import ModelAutocomplete, AutocompleteWidget
+
 from .models import Park
 from location.models import Location
+from .querysets import get_base_park_queryset
+
+
+class ParkAutocomplete(ModelAutocomplete):
+    """Autocomplete for searching parks.
+    
+    Features:
+    - Name-based search with partial matching
+    - Prefetches related owner data
+    - Applies standard park queryset filtering
+    - Includes park status and location in results
+    """
+    model = Park
+    search_attrs = ['name']  # We'll match on park names
+    minimum_search_length = 2  # Start searching after 2 characters
+    max_results = 8  # Limit to 8 suggestions
+    
+    def get_search_results(self, search):
+        """Return search results with related data."""
+        return (get_base_park_queryset()
+                .filter(name__icontains=search)
+                .select_related('owner')
+                .order_by('name'))
+    
+    def format_result(self, park):
+        """Format each park result with status and location."""
+        location = park.formatted_location
+        location_text = f" • {location}" if location else ""
+        return {
+            'key': str(park.pk),
+            'label': park.name,
+            'extra': f"{park.get_status_display()}{location_text}"
+        }
+
+
+class ParkSearchForm(forms.Form):
+    """Form for searching parks with autocomplete."""
+    park = forms.ModelChoiceField(
+        queryset=Park.objects.all(),
+        required=False,
+        widget=AutocompleteWidget(
+            ac_class=ParkAutocomplete,
+            attrs={'class': 'w-full border-gray-300 rounded-lg form-input dark:border-gray-600 dark:bg-gray-700 dark:text-white',
+                   'placeholder': 'Search parks...'}
+        )
+    )
 
 
 class ParkForm(forms.ModelForm):

parks/migrations/0003_alter_park_id_alter_parkarea_id_and_more.py

@@ -0,0 +1,39 @@
+# Generated by Django 5.1.4 on 2025-02-21 17:55
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("parks", "0002_fix_pghistory_fields"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="park",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="parkarea",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="parkareaevent",
+            name="park",
+            field=models.ForeignKey(
+                db_constraint=False,
+                on_delete=django.db.models.deletion.DO_NOTHING,
+                related_name="+",
+                related_query_name="+",
+                to="parks.park",
+            ),
+        ),
+    ]

parks/querysets.py

@@ -0,0 +1,22 @@
+from django.db.models import QuerySet, Count, Q
+from .models import Park
+
+def get_base_park_queryset() -> QuerySet[Park]:
+    """Get base queryset with all needed annotations and prefetches"""
+    from django.contrib.contenttypes.models import ContentType
+
+    park_type = ContentType.objects.get_for_model(Park)
+    return (
+        Park.objects.select_related('owner')
+        .prefetch_related(
+            'photos',
+            'rides',
+            'location',
+            'location__content_type'
+        )
+        .annotate(
+            current_ride_count=Count('rides', distinct=True),
+            current_coaster_count=Count('rides', filter=Q(rides__category="RC"), distinct=True)
+        )
+        .order_by('name')
+    )

parks/templates/parks/park_list.html

@@ -9,7 +9,8 @@
     <div class="flex items-center space-x-4">
         <h1 class="text-2xl font-bold text-gray-900">Parks</h1>
         
-        <div class="flex items-center space-x-2 bg-gray-100 rounded-lg p-1" role="group" aria-label="View mode selection">
+        <fieldset class="flex items-center space-x-2 bg-gray-100 rounded-lg p-1">
+            <legend class="sr-only">View mode selection</legend>
             <button hx-get="{% url 'parks:park_list' %}?view_mode=grid{% if request.GET.search %}&search={{ request.GET.search }}{% endif %}" 
                     hx-target="#park-results" 
                     hx-push-url="true"
@@ -46,42 +47,23 @@
 {% block filter_section %}
 <div class="mb-6">
     <div class="max-w-3xl mx-auto relative mb-8">
-        <label for="search" class="sr-only">Search parks</label>
-        <input type="search"
-               name="search"
-               id="search"
-               class="block w-full rounded-md border-gray-300 bg-white py-3 pl-4 pr-10 shadow-sm focus:border-blue-500 focus:outline-none focus:ring-1 focus:ring-blue-500 sm:text-sm"
-               placeholder="Search parks by name or location..."
-               hx-get="{% url 'parks:search_parks' %}"
-               hx-trigger="input delay:300ms, search"
-               hx-target="#park-results"
-               hx-push-url="true"
-               hx-indicator="#search-indicator"
-               value="{{ request.GET.search|default:'' }}"
-               aria-label="Search parks">
-        <div class="absolute inset-y-0 right-0 flex items-center pr-3">
-            <div id="search-indicator" class="htmx-indicator">
-                <svg class="h-5 w-5 text-gray-400 animate-spin" viewBox="0 0 24 24" aria-hidden="true">
-                    <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4" fill="none"/>
-                    <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"/>
-                </svg>
-            </div>
-        </div>
-    </div>
-
         <div class="bg-white shadow sm:rounded-lg">
             <div class="px-4 py-5 sm:p-6">
-            <h3 class="text-lg font-medium leading-6 text-gray-900">Filters</h3>
                 <form id="filter-form"
+                      x-ref="filterForm"
                       hx-get="{% url 'parks:park_list' %}"
                       hx-target="#park-results"
                       hx-push-url="true"
-                  hx-trigger="change"
+                      hx-trigger="submit"
                       class="mt-4">
+                    <div class="mb-6">
+                        {{ search_form }}
+                    </div>
                     {% include "search/components/filter_form.html" with filter=filter %}
                 </form>
             </div>
         </div>
+    </div>
 </div>
 {% endblock %}
 
@@ -92,7 +74,3 @@
     {% include "parks/partials/park_list_item.html" with parks=parks view_mode=view_mode|default:'grid' %}
 </div>
 {% endblock %}
-
-{% block extra_js %}
-<script src="{% static 'parks/js/search.js' %}"></script>
-{% endblock %}

parks/templates/parks/partials/park_list_item.html

@@ -11,80 +11,33 @@
     </div>
 </div>
 {% else %}
-<div class="{% if view_mode == 'grid' %}grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6 p-4{% else %}flex flex-col gap-4 p-4{% endif %}"
-     data-testid="park-list"
-     data-view-mode="{{ view_mode|default:'grid' }}">
+<div class="grid grid-cols-1 gap-6 md:grid-cols-2 lg:grid-cols-3">
     {% for park in object_list|default:parks %}
-        <article class="park-card group relative bg-white border rounded-lg transition-all duration-200 ease-in-out hover:shadow-lg {% if view_mode == 'list' %}flex gap-4 p-4{% endif %}"
-                 data-testid="park-card"
-                 data-park-id="{{ park.id }}"
-                 data-view-mode="{{ view_mode|default:'grid' }}">
-            
-            <a href="{% url 'parks:park_detail' park.slug %}" 
-               class="absolute inset-0 z-0" 
-               aria-label="View details for {{ park.name }}"></a>
-            
-            <div class="relative z-10 {% if view_mode == 'grid' %}aspect-video{% endif %}">
-                {% if park.photos.exists %}
-                    <img src="{{ park.photos.first.image.url }}" 
-                         alt="Photo of {{ park.name }}"
-                         class="{% if view_mode == 'grid' %}w-full h-full object-cover rounded-t-lg{% else %}w-24 h-24 object-cover rounded-lg flex-shrink-0{% endif %}"
-                         loading="lazy">
-                {% else %}
-                    <div class="{% if view_mode == 'grid' %}w-full h-full bg-gray-100 rounded-t-lg flex items-center justify-center{% else %}w-24 h-24 bg-gray-100 rounded-lg flex-shrink-0 flex items-center justify-center{% endif %}"
-                         role="img"
-                         aria-label="Park initial letter">
-                        <span class="text-2xl font-medium text-gray-400">{{ park.name|first|upper }}</span>
-                    </div>
-                {% endif %}
-            </div>
-
-            <div class="{% if view_mode == 'grid' %}p-4{% else %}flex-1 min-w-0{% endif %}">
-                <h3 class="text-lg font-semibold text-gray-900 truncate group-hover:text-blue-600">
+        <div class="overflow-hidden transition-transform transform bg-white rounded-lg shadow-lg dark:bg-gray-800 hover:-translate-y-1">
+            <div class="p-4">
+                <h2 class="mb-2 text-xl font-bold">
+                    <a href="{% url 'parks:park_detail' park.slug %}" class="text-gray-900 hover:text-blue-600 dark:text-white dark:hover:text-blue-400">
                         {{ park.name }}
-                </h3>
+                    </a>
+                </h2>
                 
-                <div class="mt-1 text-sm text-gray-500 truncate">
-                    {% with location=park.location.first %}
-                        {% if location %}
-                            {{ location.city }}{% if location.state %}, {{ location.state }}{% endif %}{% if location.country %}, {{ location.country }}{% endif %}
-                        {% else %}
-                            Location unknown
-                        {% endif %}
-                    {% endwith %}
-                </div>
-                
-                <div class="mt-2 flex flex-wrap gap-2">
-                    <span class="inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium {{ park.get_status_color }} status-badge"
-                          data-testid="park-status">
+                <div class="flex flex-wrap gap-2">
+                    <span class="status-badge status-{{ park.status|lower }}">
                         {{ park.get_status_display }}
                     </span>
+                </div>
                 
-                    {% if park.opening_date %}
-                        <span class="inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium bg-gray-100 text-gray-800"
-                              data-testid="park-opening-date">
-                            Opened {{ park.opening_date|date:"Y" }}
-                        </span>
-                    {% endif %}
-                    
-                    {% if park.current_ride_count %}
-                        <span class="inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium bg-blue-100 text-blue-800"
-                              data-testid="park-ride-count">
-                            {{ park.current_ride_count }} ride{{ park.current_ride_count|pluralize }}
-                        </span>
-                    {% endif %}
-                    
-                    {% if park.current_coaster_count %}
-                        <span class="inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium bg-purple-100 text-purple-800"
-                              data-testid="park-coaster-count">
-                            {{ park.current_coaster_count }} coaster{{ park.current_coaster_count|pluralize }}
-                        </span>
+                {% if park.owner %}
+                    <div class="mt-4 text-sm text-blue-600 hover:text-blue-700 dark:text-blue-400 dark:hover:text-blue-300">
+                        <a href="{% url 'companies:company_detail' park.owner.slug %}">
+                            {{ park.owner.name }}
+                        </a>
+                    </div>
                 {% endif %}
             </div>
         </div>
-        </article>
     {% empty %}
-        <div class="{% if view_mode == 'grid' %}col-span-full{% endif %} p-4 text-sm text-gray-500 text-center" data-testid="no-parks-found">
+        <div class="col-span-full p-4 text-sm text-gray-500 text-center" data-testid="no-parks-found">
             {% if search_query %}
                 No parks found matching "{{ search_query }}". Try adjusting your search terms.
             {% else %}

parks/templates/parks/partials/park_suggestions.html

@@ -0,0 +1,30 @@
+{% load static %}
+
+{% if parks %}
+<div class="py-2">
+    {% for park in parks %}
+    <button class="w-full text-left px-4 py-2 hover:bg-gray-100 focus:bg-gray-100 focus:outline-none dark:hover:bg-gray-700 dark:focus:bg-gray-700"
+            role="option"
+            @click="$dispatch('search-selected', '{{ park.name }}')"
+            value="{{ park.id }}">
+        <div class="flex justify-between items-center">
+            <div>
+                <div class="font-medium">{{ park.name }}</div>
+                <div class="text-sm text-gray-500 dark:text-gray-400">
+                    {% if park.formatted_location %}
+                    {{ park.formatted_location }}
+                    {% endif %}
+                </div>
+            </div>
+            <div class="text-sm text-gray-500 dark:text-gray-400">
+                {{ park.get_status_display }}
+            </div>
+        </div>
+    </button>
+    {% endfor %}
+</div>
+{% else %}
+<div class="px-4 py-2 text-sm text-gray-500 dark:text-gray-400">
+    No parks found matching "{{ query }}"
+</div>
+{% endif %}

parks/templates/parks/partials/search_suggestions.html

@@ -0,0 +1,21 @@
+{% if results %}
+<div class="py-1">
+    {% for result in results %}
+    <button class="w-full text-left px-4 py-2 hover:bg-gray-100 dark:hover:bg-gray-700"
+            @click="$dispatch('search-selected', '{{ result.name }}')"
+            value="{{ result.id }}"
+            role="option">
+        <div class="flex flex-col">
+            <span class="font-medium text-gray-900 dark:text-white">{{ result.name }}</span>
+            <span class="text-sm text-gray-500 dark:text-gray-400">
+                {{ result.status }}{% if result.location %} • {{ result.location }}{% endif %}
+            </span>
+        </div>
+    </button>
+    {% endfor %}
+</div>
+{% else %}
+<div class="px-4 py-2 text-sm text-gray-500 dark:text-gray-400">
+    {% if query %}No parks found matching "{{ query }}"{% else %}Start typing to search parks{% endif %}
+</div>
+{% endif %}

parks/tests/README.md

@@ -0,0 +1,127 @@
+# Park Search Tests
+
+## Overview
+
+Test suite for the park search functionality including:
+- Autocomplete widget integration
+- Search form validation
+- Filter integration
+- HTMX interaction
+- View mode persistence
+
+## Running Tests
+
+```bash
+# Run all park tests
+uv run pytest parks/tests/
+
+# Run specific search tests
+uv run pytest parks/tests/test_search.py
+
+# Run with coverage
+uv run pytest --cov=parks parks/tests/
+```
+
+## Test Coverage
+
+### Search API Tests
+- `test_search_json_format`: Validates API response structure
+- `test_empty_search_json`: Tests empty search handling
+- `test_search_format_validation`: Verifies all required fields and types
+- `test_suggestion_limit`: Confirms 8-item result limit
+
+### Search Functionality Tests
+- `test_autocomplete_results`: Validates real-time suggestion filtering
+- `test_search_with_filters`: Tests filter integration with search
+- `test_partial_match_search`: Verifies partial text matching works
+
+### UI Integration Tests
+- `test_view_mode_persistence`: Ensures view mode is maintained
+- `test_empty_search`: Tests default state behavior
+- `test_htmx_request_handling`: Validates HTMX interactions
+
+### Data Format Tests
+- Field types validation
+- Location formatting
+- Status display formatting
+- URL generation
+- Response structure
+
+### Frontend Integration
+- HTMX partial updates
+- Alpine.js state management
+- Loading indicators
+- View mode persistence
+- Keyboard navigation
+
+### Test Commands
+```bash
+# Run all park tests
+uv run pytest parks/tests/
+
+# Run search tests specifically
+uv run pytest parks/tests/test_search.py
+
+# Run with coverage
+uv run pytest --cov=parks parks/tests/
+```
+
+### Coverage Areas
+1. Search Functionality:
+   - Suggestion generation
+   - Result filtering
+   - Partial matching
+   - Empty state handling
+
+2. UI Integration:
+   - HTMX requests
+   - View mode switching
+   - Loading states
+   - Error handling
+
+3. Performance:
+   - Result limiting
+   - Debouncing
+   - Query optimization
+
+4. Accessibility:
+   - ARIA attributes
+   - Keyboard controls
+   - Screen reader support
+
+## Configuration
+
+Tests use pytest-django and require:
+- PostgreSQL database
+- HTMX middleware
+- Autocomplete app configuration
+
+## Fixtures
+
+The test suite uses standard Django test fixtures. No additional fixtures required.
+
+## Common Issues
+
+1. Database Errors
+   - Ensure PostGIS extensions are installed
+   - Verify database permissions
+
+2. HTMX Tests
+   - Use `HTTP_HX_REQUEST` header for HTMX requests
+   - Check response content for HTMX attributes
+
+## Adding New Tests
+
+When adding tests, ensure:
+1. Database isolation using `@pytest.mark.django_db`
+2. Proper test naming following `test_*` convention
+3. Clear test descriptions in docstrings
+4. Coverage for both success and failure cases
+5. HTMX interaction testing where applicable
+
+## Future Improvements
+
+- Add performance benchmarks
+- Include accessibility tests
+- Add Playwright e2e tests
+- Implement geographic search tests

parks/tests/test_search.py

@@ -0,0 +1,183 @@
+import pytest
+from django.urls import reverse
+from django.test import Client
+
+from parks.models import Park
+from parks.forms import ParkAutocomplete, ParkSearchForm
+
+
+@pytest.mark.django_db
+class TestParkSearch:
+    def test_autocomplete_results(self, client: Client):
+        """Test that autocomplete returns correct results"""
+        # Create test parks
+        park1 = Park.objects.create(name="Test Park")
+        park2 = Park.objects.create(name="Another Park")
+        park3 = Park.objects.create(name="Test Garden")
+
+        # Get autocomplete results
+        url = reverse('parks:suggest_parks')
+        response = client.get(url, {'search': 'Test'})
+
+        # Check response
+        assert response.status_code == 200
+        content = response.content.decode()
+        assert park1.name in content
+        assert park3.name in content
+        assert park2.name not in content
+
+    def test_search_form_valid(self):
+        """Test ParkSearchForm validation"""
+        form = ParkSearchForm(data={})
+        assert form.is_valid()
+
+    def test_autocomplete_class(self):
+        """Test ParkAutocomplete configuration"""
+        ac = ParkAutocomplete()
+        assert ac.model == Park
+        assert 'name' in ac.search_attrs
+
+    def test_search_with_filters(self, client: Client):
+        """Test search works with filters"""
+        park = Park.objects.create(name="Test Park", status="OPERATING")
+
+        # Search with status filter
+        url = reverse('parks:park_list')
+        response = client.get(url, {
+            'park': str(park.pk),
+            'status': 'OPERATING'
+        })
+
+        assert response.status_code == 200
+        assert park.name in response.content.decode()
+
+    def test_empty_search(self, client: Client):
+        """Test empty search returns all parks"""
+        Park.objects.create(name="Test Park")
+        Park.objects.create(name="Another Park")
+
+        url = reverse('parks:park_list')
+        response = client.get(url)
+
+        assert response.status_code == 200
+        content = response.content.decode()
+        assert "Test Park" in content
+        assert "Another Park" in content
+
+    def test_partial_match_search(self, client: Client):
+        """Test partial matching in search"""
+        Park.objects.create(name="Adventure World")
+        Park.objects.create(name="Water Adventure")
+
+        url = reverse('parks:suggest_parks')
+        response = client.get(url, {'search': 'Adv'})
+
+        assert response.status_code == 200
+        content = response.content.decode()
+        assert "Adventure World" in content
+        assert "Water Adventure" in content
+
+    def test_htmx_request_handling(self, client: Client):
+        """Test HTMX-specific request handling"""
+        Park.objects.create(name="Test Park")
+
+        url = reverse('parks:suggest_parks')
+        response = client.get(
+            url,
+            {'search': 'Test'},
+            HTTP_HX_REQUEST='true'
+        )
+
+        assert response.status_code == 200
+        assert "Test Park" in response.content.decode()
+
+    def test_view_mode_persistence(self, client: Client):
+        """Test view mode is maintained during search"""
+        Park.objects.create(name="Test Park")
+
+        url = reverse('parks:park_list')
+        response = client.get(url, {
+            'park': 'Test',
+            'view_mode': 'list'
+        })
+
+        assert response.status_code == 200
+        assert 'data-view-mode="list"' in response.content.decode()
+
+    def test_suggestion_limit(self, client: Client):
+        """Test that suggestions are limited to 8 items"""
+        # Create 10 parks
+        for i in range(10):
+            Park.objects.create(name=f"Test Park {i}")
+
+        url = reverse('parks:suggest_parks')
+        response = client.get(url, {'search': 'Test'})
+
+        content = response.content.decode()
+        result_count = content.count('Test Park')
+        assert result_count == 8  # Verify limit is enforced
+
+    def test_search_json_format(self, client: Client):
+        """Test that search returns properly formatted JSON"""
+        park = Park.objects.create(
+            name="Test Park",
+            status="OPERATING",
+            city="Test City",
+            state="Test State"
+        )
+        
+        url = reverse('parks:suggest_parks')
+        response = client.get(url, {'search': 'Test'})
+        
+        assert response.status_code == 200
+        data = response.json()
+        assert 'results' in data
+        assert len(data['results']) == 1
+        
+        result = data['results'][0]
+        assert result['id'] == str(park.pk)
+        assert result['name'] == "Test Park"
+        assert result['status'] == "Operating"
+        assert result['location'] == park.formatted_location
+        assert result['url'] == reverse('parks:park_detail', kwargs={'slug': park.slug})
+
+    def test_empty_search_json(self, client: Client):
+        """Test empty search returns empty results array"""
+        url = reverse('parks:suggest_parks')
+        response = client.get(url, {'search': ''})
+        
+        assert response.status_code == 200
+        data = response.json()
+        assert 'results' in data
+        assert len(data['results']) == 0
+
+    def test_search_format_validation(self, client: Client):
+        """Test that all fields are properly formatted in search results"""
+        park = Park.objects.create(
+            name="Test Park",
+            status="OPERATING",
+            city="Test City",
+            state="Test State",
+            country="Test Country"
+        )
+        
+        expected_fields = {'id', 'name', 'status', 'location', 'url'}
+        
+        url = reverse('parks:suggest_parks')
+        response = client.get(url, {'search': 'Test'})
+        data = response.json()
+        result = data['results'][0]
+        
+        # Check all expected fields are present
+        assert set(result.keys()) == expected_fields
+        
+        # Check field types
+        assert isinstance(result['id'], str)
+        assert isinstance(result['name'], str)
+        assert isinstance(result['status'], str)
+        assert isinstance(result['location'], str)
+        assert isinstance(result['url'], str)
+        
+        # Check formatted location includes city and state
+        assert 'Test City' in result['location']
+        assert 'Test State' in result['location']

parks/urls.py

@@ -1,12 +1,12 @@
 from django.urls import path, include
-from . import views
+from . import views, views_search
 from rides.views import ParkSingleCategoryListView
 
 app_name = "parks"
 
 urlpatterns = [
-    # Park views
-    path("", views.ParkListView.as_view(), name="park_list"),
+    # Park views with autocomplete search
+    path("", views_search.ParkSearchView.as_view(), name="park_list"),
     path("create/", views.ParkCreateView.as_view(), name="park_create"),
     
     # Add park button endpoint (moved before park detail pattern)

parks/views.py

@@ -1,55 +1,120 @@
+from .querysets import get_base_park_queryset
+from search.mixins import HTMXFilterableMixin
+from reviews.models import Review
+from location.models import Location
+from media.models import Photo
+from moderation.models import EditSubmission
+from moderation.mixins import EditSubmissionMixin, PhotoSubmissionMixin, HistoryMixin
+from core.views import SlugRedirectMixin
+from .filters import ParkFilter
+from .forms import ParkForm
+from .models import Park, ParkArea
+from django.http import HttpResponseRedirect, HttpResponse, HttpRequest, JsonResponse
+from django.core.exceptions import ObjectDoesNotExist
+from django.contrib import messages
+from django.contrib.contenttypes.models import ContentType
+from django.contrib.auth.mixins import LoginRequiredMixin
+from django.db.models import Q, Count, QuerySet
+from django.urls import reverse
+from django.shortcuts import get_object_or_404, render
+from decimal import InvalidOperation
+from django.views.generic import DetailView, ListView, CreateView, UpdateView
+import requests
 from decimal import Decimal, ROUND_DOWN
 from typing import Any, Optional, cast, Literal
-from django.views.generic import DetailView, ListView, CreateView, UpdateView
-from django.shortcuts import get_object_or_404, render
-from django.urls import reverse
-from django.db.models import Q, Count, QuerySet
-from django.contrib.auth.mixins import LoginRequiredMixin
-from django.contrib.contenttypes.models import ContentType
-from django.contrib import messages
-from django.core.exceptions import ObjectDoesNotExist
-from django.http import HttpResponseRedirect, HttpResponse, HttpRequest, JsonResponse
-from .models import Park, ParkArea
-from .forms import ParkForm
-from .filters import ParkFilter
-from core.views import SlugRedirectMixin
-from moderation.mixins import EditSubmissionMixin, PhotoSubmissionMixin, HistoryMixin
-from moderation.models import EditSubmission
-from media.models import Photo
-from location.models import Location
-from reviews.models import Review
-from search.mixins import HTMXFilterableMixin
+
+# Constants
+PARK_DETAIL_URL = "parks:park_detail"
+PARK_LIST_ITEM_TEMPLATE = "parks/partials/park_list_item.html"
+REQUIRED_FIELDS_ERROR = "Please correct the errors below. Required fields are marked with an asterisk (*)."
+ALLOWED_ROLES = ["MODERATOR", "ADMIN", "SUPERUSER"]
+
 
 ViewMode = Literal["grid", "list"]
 
 
+def normalize_osm_result(result: dict) -> dict:
+    """Normalize OpenStreetMap result to a consistent format with enhanced address details"""
+    from .location_utils import get_english_name, normalize_coordinate
+
+    # Get address details
+    address = result.get('address', {})
+
+    # Normalize coordinates
+    lat = normalize_coordinate(float(result.get('lat')), 9, 6)
+    lon = normalize_coordinate(float(result.get('lon')), 10, 6)
+
+    # Get English names where possible
+    name = ''
+    if 'namedetails' in result:
+        name = get_english_name(result['namedetails'])
+
+    # Build street address from available components
+    street_parts = []
+    if address.get('house_number'):
+        street_parts.append(address['house_number'])
+    if address.get('road') or address.get('street'):
+        street_parts.append(address.get('road') or address.get('street'))
+    elif address.get('pedestrian'):
+        street_parts.append(address['pedestrian'])
+    elif address.get('footway'):
+        street_parts.append(address['footway'])
+
+    # Handle additional address components
+    suburb = address.get('suburb', '')
+    district = address.get('district', '')
+    neighborhood = address.get('neighbourhood', '')
+
+    # Build city from available components
+    city = (address.get('city') or
+            address.get('town') or
+            address.get('village') or
+            address.get('municipality') or
+            '')
+
+    # Get detailed state/region information
+    state = (address.get('state') or
+             address.get('province') or
+             address.get('region') or
+             '')
+
+    # Get postal code with fallbacks
+    postal_code = (address.get('postcode') or
+                   address.get('postal_code') or
+                   '')
+
+    return {
+        'display_name': name or result.get('display_name', ''),
+        'lat': lat,
+        'lon': lon,
+        'street': ' '.join(street_parts).strip(),
+        'suburb': suburb,
+        'district': district,
+        'neighborhood': neighborhood,
+        'city': city,
+        'state': state,
+        'country': address.get('country', ''),
+        'postal_code': postal_code,
+    }
+
+
 def get_view_mode(request: HttpRequest) -> ViewMode:
     """Get the current view mode from request, defaulting to grid"""
     view_mode = request.GET.get('view_mode', 'grid')
     return cast(ViewMode, 'list' if view_mode == 'list' else 'grid')
 
 
-def get_base_park_queryset() -> QuerySet[Park]:
-    """Get base queryset with all needed annotations and prefetches"""
-    return (
-        Park.objects.select_related('owner')
-        .prefetch_related('location', 'photos', 'rides')
-        .annotate(
-            current_ride_count=Count('rides', distinct=True),
-            current_coaster_count=Count('rides', filter=Q(rides__category="RC"), distinct=True)
-        )
-        .order_by('name')
-    )
-
 def add_park_button(request: HttpRequest) -> HttpResponse:
     """Return the add park button partial template"""
     return render(request, "parks/partials/add_park_button.html")
 
+
 def park_actions(request: HttpRequest, slug: str) -> HttpResponse:
     """Return the park actions partial template"""
     park = get_object_or_404(Park, slug=slug)
     return render(request, "parks/partials/park_actions.html", {"park": park})
 
+
 def get_park_areas(request: HttpRequest) -> HttpResponse:
     """Return park areas as options for a select element"""
     park_id = request.GET.get('park')
@@ -68,6 +133,7 @@ def get_park_areas(request: HttpRequest) -> HttpResponse:
     except Park.DoesNotExist:
         return HttpResponse('<option value="">Invalid park selected</option>')
 
+
 def location_search(request: HttpRequest) -> JsonResponse:
     """Search for locations using OpenStreetMap Nominatim API"""
     query = request.GET.get("q", "")
@@ -90,7 +156,8 @@ def location_search(request: HttpRequest) -> JsonResponse:
 
     if response.status_code == 200:
         results = response.json()
-        normalized_results = [normalize_osm_result(result) for result in results]
+        normalized_results = [normalize_osm_result(
+            result) for result in results]
         valid_results = [
             r for r in normalized_results
             if r["lat"] is not None and r["lon"] is not None
@@ -99,6 +166,7 @@ def location_search(request: HttpRequest) -> JsonResponse:
 
     return JsonResponse({"results": []})
 
+
 def reverse_geocode(request: HttpRequest) -> JsonResponse:
     """Reverse geocode coordinates using OpenStreetMap Nominatim API"""
     try:
@@ -212,6 +280,8 @@ def search_parks(request: HttpRequest) -> HttpResponse:
         if not search_query:
             return HttpResponse('')
 
+        # Get current view mode from request
+        current_view_mode = request.GET.get('view_mode', 'grid')
         park_filter = ParkFilter({
             'search': search_query
         }, queryset=get_base_park_queryset())
@@ -222,10 +292,10 @@ def search_parks(request: HttpRequest) -> HttpResponse:
 
         response = render(
             request,
-            "parks/partials/park_list_item.html",
+            PARK_LIST_ITEM_TEMPLATE,
             {
                 "parks": parks,
-                "view_mode": get_view_mode(request),
+                "view_mode": current_view_mode,
                 "search_query": search_query,
                 "is_search": True
             }
@@ -236,7 +306,7 @@ def search_parks(request: HttpRequest) -> HttpResponse:
     except Exception as e:
         response = render(
             request,
-            "parks/partials/park_list_item.html",
+            PARK_LIST_ITEM_TEMPLATE,
             {
                 "parks": [],
                 "error": f"Error performing search: {str(e)}",
@@ -246,6 +316,7 @@ def search_parks(request: HttpRequest) -> HttpResponse:
         response['HX-Trigger'] = 'searchError'
         return response
 
+
 class ParkCreateView(LoginRequiredMixin, CreateView):
     model = Park
     form_class = ParkForm
@@ -259,7 +330,8 @@ class ParkCreateView(LoginRequiredMixin, CreateView):
             data["opening_date"] = data["opening_date"].isoformat()
         if data.get("closing_date"):
             data["closing_date"] = data["closing_date"].isoformat()
-        decimal_fields = ["latitude", "longitude", "size_acres", "average_rating"]
+        decimal_fields = ["latitude", "longitude",
+                          "size_acres", "average_rating"]
         for field in decimal_fields:
             if data.get(field):
                 data[field] = str(data[field])
@@ -292,324 +364,7 @@ class ParkCreateView(LoginRequiredMixin, CreateView):
 
         if hasattr(self.request.user, "role") and getattr(
             self.request.user, "role", None
-        ) in ["MODERATOR", "ADMIN", "SUPERUSER"]:
-            try:
-                self.object = form.save()
-                submission.object_id = self.object.id
-                submission.status = "APPROVED"
-                submission.handled_by = self.request.user
-                submission.save()
-
-                if form.cleaned_data.get("latitude") and form.cleaned_data.get(
-                    "longitude"
-                ):
-                    Location.objects.create(
-                        content_type=ContentType.objects.get_for_model(Park),
-                        object_id=self.object.id,
-                        name=self.object.name,
-                        location_type="park",
-                        latitude=form.cleaned_data["latitude"],
-                        longitude=form.cleaned_data["longitude"],
-                        street_address=form.cleaned_data.get("street_address", ""),
-                        city=form.cleaned_data.get("city", ""),
-                        state=form.cleaned_data.get("state", ""),
-                        country=form.cleaned_data.get("country", ""),
-                        postal_code=form.cleaned_data.get("postal_code", ""),
-                    )
-
-                photos = self.request.FILES.getlist("photos")
-                uploaded_count = 0
-                for photo_file in photos:
-                    try:
-                        Photo.objects.create(
-                            image=photo_file,
-                            uploaded_by=self.request.user,
-                            content_type=ContentType.objects.get_for_model(Park),
-                            object_id=self.object.id,
-                        )
-                        uploaded_count += 1
-                    except Exception as e:
-                        messages.error(
-                            self.request,
-                            f"Error uploading photo {photo_file.name}: {str(e)}",
-                        )
-
-                messages.success(
-                    self.request,
-                    f"Successfully created {self.object.name}. "
-                    f"Added {uploaded_count} photo(s).",
-                )
-                return HttpResponseRedirect(self.get_success_url())
-            except Exception as e:
-                messages.error(
-                    self.request,
-                    f"Error creating park: {str(e)}. Please check your input and try again.",
-                )
-                return self.form_invalid(form)
-
-        messages.success(
-            self.request,
-            "Your park submission has been sent for review. "
-            "You will be notified when it is approved.",
-        )
-        return HttpResponseRedirect(reverse("parks:park_list"))
-
-    def form_invalid(self, form: ParkForm) -> HttpResponse:
-        messages.error(
-            self.request,
-            "Please correct the errors below. Required fields are marked with an asterisk (*).",
-        )
-        for field, errors in form.errors.items():
-            for error in errors:
-                messages.error(self.request, f"{field}: {error}")
-        return super().form_invalid(form)
-
-    def get_success_url(self) -> str:
-        return reverse("parks:park_detail", kwargs={"slug": self.object.slug})
-
-
-class ParkUpdateView(LoginRequiredMixin, UpdateView):
-    model = Park
-    form_class = ParkForm
-    template_name = "parks/park_form.html"
-
-    def get_context_data(self, **kwargs: Any) -> dict[str, Any]:
-        context = super().get_context_data(**kwargs)
-        context["is_edit"] = True
-        return context
-
-    def prepare_changes_data(self, cleaned_data: dict[str, Any]) -> dict[str, Any]:
-        data = cleaned_data.copy()
-        if data.get("owner"):
-            data["owner"] = data["owner"].id
-        if data.get("opening_date"):
-            data["opening_date"] = data["opening_date"].isoformat()
-        if data.get("closing_date"):
-            data["closing_date"] = data["closing_date"].isoformat()
-        decimal_fields = ["latitude", "longitude", "size_acres", "average_rating"]
-        for field in decimal_fields:
-            if data.get(field):
-                data[field] = str(data[field])
-        return data
-
-    def normalize_coordinates(self, form: ParkForm) -> None:
-        if form.cleaned_data.get("latitude"):
-            lat = Decimal(str(form.cleaned_data["latitude"]))
-            form.cleaned_data["latitude"] = lat.quantize(
-                Decimal("0.000001"), rounding=ROUND_DOWN
-            )
-        if form.cleaned_data.get("longitude"):
-            lon = Decimal(str(form.cleaned_data["longitude"]))
-            form.cleaned_data["longitude"] = lon.quantize(
-                Decimal("0.000001"), rounding=ROUND_DOWN
-            )
-
-    def form_valid(self, form: ParkForm) -> HttpResponse:
-        self.normalize_coordinates(form)
-        changes = self.prepare_changes_data(form.cleaned_data)
-
-        submission = EditSubmission.objects.create(
-            user=self.request.user,
-            content_type=ContentType.objects.get_for_model(Park),
-            object_id=self.object.id,
-            submission_type="EDIT",
-            changes=changes,
-            reason=self.request.POST.get("reason", ""),
-            source=self.request.POST.get("source", ""),
-        )
-
-        if hasattr(self.request.user, "role") and getattr(
-            self.request.user, "role", None
-        ) in ["MODERATOR", "ADMIN", "SUPERUSER"]:
-            try:
-                self.object = form.save()
-                submission.status = "APPROVED"
-                submission.handled_by = self.request.user
-                submission.save()
-
-                location_data = {
-                    "name": self.object.name,
-                    "location_type": "park",
-                    "latitude": form.cleaned_data.get("latitude"),
-                    "longitude": form.cleaned_data.get("longitude"),
-                    "street_address": form.cleaned_data.get("street_address", ""),
-                    "city": form.cleaned_data.get("city", ""),
-                    "state": form.cleaned_data.get("state", ""),
-                    "country": form.cleaned_data.get("country", ""),
-                    "postal_code": form.cleaned_data.get("postal_code", ""),
-                }
-
-                if self.object.location.exists():
-                    location = self.object.location.first()
-                    for key, value in location_data.items():
-                        setattr(location, key, value)
-                    location.save()
-                else:
-                    Location.objects.create(
-                        content_type=ContentType.objects.get_for_model(Park),
-                        object_id=self.object.id,
-                        **location_data,
-                    )
-
-                photos = self.request.FILES.getlist("photos")
-                uploaded_count = 0
-                for photo_file in photos:
-                    try:
-                        Photo.objects.create(
-                            image=photo_file,
-                            uploaded_by=self.request.user,
-                            content_type=ContentType.objects.get_for_model(Park),
-                            object_id=self.object.id,
-                        )
-                        uploaded_count += 1
-                    except Exception as e:
-                        messages.error(
-                            self.request,
-                            f"Error uploading photo {photo_file.name}: {str(e)}",
-                        )
-
-                messages.success(
-                    self.request,
-                    f"Successfully updated {self.object.name}. "
-                    f"Added {uploaded_count} new photo(s).",
-                )
-                return HttpResponseRedirect(self.get_success_url())
-            except Exception as e:
-                messages.error(
-                    self.request,
-                    f"Error updating park: {str(e)}. Please check your input and try again.",
-                )
-                return self.form_invalid(form)
-
-        messages.success(
-            self.request,
-            f"Your changes to {self.object.name} have been sent for review. "
-            "You will be notified when they are approved.",
-        )
-        return HttpResponseRedirect(
-            reverse("parks:park_detail", kwargs={"slug": self.object.slug})
-        )
-
-    def form_invalid(self, form: ParkForm) -> HttpResponse:
-        messages.error(
-            self.request,
-            "Please correct the errors below. Required fields are marked with an asterisk (*).",
-        )
-        for field, errors in form.errors.items():
-            for error in errors:
-                messages.error(self.request, f"{field}: {error}")
-        return super().form_invalid(form)
-
-    def get_success_url(self) -> str:
-        return reverse("parks:park_detail", kwargs={"slug": self.object.slug})
-
-
-class ParkDetailView(
-    SlugRedirectMixin,
-    EditSubmissionMixin,
-    PhotoSubmissionMixin,
-    HistoryMixin,
-    DetailView
-):
-    model = Park
-    template_name = "parks/park_detail.html"
-    context_object_name = "park"
-
-    def get_object(self, queryset: Optional[QuerySet[Park]] = None) -> Park:
-        if queryset is None:
-            queryset = self.get_queryset()
-        slug = self.kwargs.get(self.slug_url_kwarg)
-        if slug is None:
-            raise ObjectDoesNotExist("No slug provided")
-        park, _ = Park.get_by_slug(slug)
-        return park
-
-    def get_queryset(self) -> QuerySet[Park]:
-        return cast(
-            QuerySet[Park],
-            super()
-            .get_queryset()
-            .prefetch_related(
-                "rides",
-                "rides__manufacturer",
-                "photos",
-                "areas",
-                "location"
-            ),
-        )
-
-    def get_context_data(self, **kwargs: Any) -> dict[str, Any]:
-        context = super().get_context_data(**kwargs)
-        park = cast(Park, self.object)
-        context["areas"] = park.areas.all()
-        context["rides"] = park.rides.all().order_by("-status", "name")
-
-        if self.request.user.is_authenticated:
-            context["has_reviewed"] = Review.objects.filter(
-                user=self.request.user,
-                content_type=ContentType.objects.get_for_model(Park),
-                object_id=park.id,
-            ).exists()
-        else:
-            context["has_reviewed"] = False
-
-        return context
-
-    def get_redirect_url_pattern(self) -> str:
-        return "parks:park_detail"
-
-
-class ParkAreaDetailView(
-    SlugRedirectMixin,
-    EditSubmissionMixin,
-    PhotoSubmissionMixin,
-    HistoryMixin,
-    DetailView
-):
-    model = ParkArea
-    template_name = "parks/area_detail.html"
-    context_object_name = "area"
-    slug_url_kwarg = "area_slug"
-
-    def get_object(self, queryset: Optional[QuerySet[ParkArea]] = None) -> ParkArea:
-        if queryset is None:
-            queryset = self.get_queryset()
-        park_slug = self.kwargs.get("park_slug")
-        area_slug = self.kwargs.get("area_slug")
-        if park_slug is None or area_slug is None:
-            raise ObjectDoesNotExist("Missing slug")
-        area, _ = ParkArea.get_by_slug(area_slug)
-        if area.park.slug != park_slug:
-            raise ObjectDoesNotExist("Park slug doesn't match")
-        return area
-
-    def get_context_data(self, **kwargs: Any) -> dict[str, Any]:
-        context = super().get_context_data(**kwargs)
-        return context
-
-    def get_redirect_url_pattern(self) -> str:
-        return "parks:park_detail"
-
-    def get_redirect_url_kwargs(self) -> dict[str, str]:
-        area = cast(ParkArea, self.object)
-        return {"park_slug": area.park.slug, "area_slug": area.slug}
-
-    def form_valid(self, form: ParkForm) -> HttpResponse:
-        self.normalize_coordinates(form)
-        changes = self.prepare_changes_data(form.cleaned_data)
-
-        submission = EditSubmission.objects.create(
-            user=self.request.user,
-            content_type=ContentType.objects.get_for_model(Park),
-            submission_type="CREATE",
-            changes=changes,
-            reason=self.request.POST.get("reason", ""),
-            source=self.request.POST.get("source", ""),
-        )
-
-        if hasattr(self.request.user, "role") and getattr(
-            self.request.user, "role", None
-        ) in ["MODERATOR", "ADMIN", "SUPERUSER"]:
+        ) in ALLOWED_ROLES:
             try:
                 self.object = form.save()
                 submission.object_id = self.object.id
@@ -669,14 +424,7 @@ class ParkAreaDetailView(
         messages.success(
             self.request,
             "Your park submission has been sent for review. "
-            "You will be notified when it is approved.",
-        )
-        return HttpResponseRedirect(reverse("parks:park_list"))
-
-    def form_invalid(self, form: ParkForm) -> HttpResponse:
-        messages.error(
-            self.request,
-            "Please correct the errors below. Required fields are marked with an asterisk (*).",
+            "You will be notified when it is approved."
         )
         for field, errors in form.errors.items():
             for error in errors:
@@ -684,7 +432,7 @@ class ParkAreaDetailView(
         return super().form_invalid(form)
 
     def get_success_url(self) -> str:
-        return reverse("parks:park_detail", kwargs={"slug": self.object.slug})
+        return reverse(PARK_DETAIL_URL, kwargs={"slug": self.object.slug})
 
 
 class ParkUpdateView(LoginRequiredMixin, UpdateView):
@@ -740,7 +488,7 @@ class ParkUpdateView(LoginRequiredMixin, UpdateView):
 
         if hasattr(self.request.user, "role") and getattr(
             self.request.user, "role", None
-        ) in ["MODERATOR", "ADMIN", "SUPERUSER"]:
+        ) in ALLOWED_ROLES:
             try:
                 self.object = form.save()
                 submission.status = "APPROVED"
@@ -808,13 +556,13 @@ class ParkUpdateView(LoginRequiredMixin, UpdateView):
             "You will be notified when they are approved.",
         )
         return HttpResponseRedirect(
-            reverse("parks:park_detail", kwargs={"slug": self.object.slug})
+            reverse(PARK_DETAIL_URL, kwargs={"slug": self.object.slug})
         )
 
     def form_invalid(self, form: ParkForm) -> HttpResponse:
         messages.error(
             self.request,
-            "Please correct the errors below. Required fields are marked with an asterisk (*).",
+            REQUIRED_FIELDS_ERROR
         )
         for field, errors in form.errors.items():
             for error in errors:
@@ -822,7 +570,62 @@ class ParkUpdateView(LoginRequiredMixin, UpdateView):
         return super().form_invalid(form)
 
     def get_success_url(self) -> str:
-        return reverse("parks:park_detail", kwargs={"slug": self.object.slug})
+        return reverse(PARK_DETAIL_URL, kwargs={"slug": self.object.slug})
+
+
+class ParkDetailView(
+    SlugRedirectMixin,
+    EditSubmissionMixin,
+    PhotoSubmissionMixin,
+    HistoryMixin,
+    DetailView
+):
+    model = Park
+    template_name = "parks/park_detail.html"
+    context_object_name = "park"
+
+    def get_object(self, queryset: Optional[QuerySet[Park]] = None) -> Park:
+        if queryset is None:
+            queryset = self.get_queryset()
+        slug = self.kwargs.get(self.slug_url_kwarg)
+        if slug is None:
+            raise ObjectDoesNotExist("No slug provided")
+        park, _ = Park.get_by_slug(slug)
+        return park
+
+    def get_queryset(self) -> QuerySet[Park]:
+        return cast(
+            QuerySet[Park],
+            super()
+            .get_queryset()
+            .prefetch_related(
+                "rides",
+                "rides__manufacturer",
+                "photos",
+                "areas",
+                "location"
+            ),
+        )
+
+    def get_context_data(self, **kwargs: Any) -> dict[str, Any]:
+        context = super().get_context_data(**kwargs)
+        park = cast(Park, self.object)
+        context["areas"] = park.areas.all()
+        context["rides"] = park.rides.all().order_by("-status", "name")
+
+        if self.request.user.is_authenticated:
+            context["has_reviewed"] = Review.objects.filter(
+                user=self.request.user,
+                content_type=ContentType.objects.get_for_model(Park),
+                object_id=park.id,
+            ).exists()
+        else:
+            context["has_reviewed"] = False
+
+        return context
+
+    def get_redirect_url_pattern(self) -> str:
+        return PARK_DETAIL_URL
 
 
 class ParkAreaDetailView(
@@ -830,7 +633,7 @@ class ParkAreaDetailView(
     EditSubmissionMixin,
     PhotoSubmissionMixin,
     HistoryMixin,
-    DetailView,
+    DetailView
 ):
     model = ParkArea
     template_name = "parks/area_detail.html"
@@ -854,7 +657,7 @@ class ParkAreaDetailView(
         return context
 
     def get_redirect_url_pattern(self) -> str:
-        return "parks:park_detail"
+        return PARK_DETAIL_URL
 
     def get_redirect_url_kwargs(self) -> dict[str, str]:
         area = cast(ParkArea, self.object)

parks/views_search.py

@@ -0,0 +1,31 @@
+from django.http import HttpRequest, HttpResponse
+from django.views.generic import TemplateView
+from django.urls import reverse
+
+from .filters import ParkFilter
+from .forms import ParkSearchForm
+from .querysets import get_base_park_queryset
+
+class ParkSearchView(TemplateView):
+    """View for handling park search with autocomplete."""
+    template_name = "parks/park_list.html"
+
+    def get_context_data(self, **kwargs):
+        context = super().get_context_data(**kwargs)
+        
+        # Initialize search form
+        context['search_form'] = ParkSearchForm(self.request.GET)
+        
+        # Initialize filter with current querystring
+        queryset = get_base_park_queryset()
+        filter_instance = ParkFilter(self.request.GET, queryset=queryset)
+        context['filter'] = filter_instance
+        
+        # Get filtered queryset
+        queryset = filter_instance.qs
+            
+        # Handle view mode
+        context['view_mode'] = self.request.GET.get('view_mode', 'grid')
+        context['parks'] = queryset
+        
+        return context

pyproject.toml

@@ -57,4 +57,5 @@ dependencies = [
     "playwright>=1.41.0",
     "pytest-playwright>=0.4.3",
     "django-pghistory>=3.5.2",
+    "django-htmx-autocomplete>=1.0.5",
 ]

reviews/migrations/0002_alter_review_id.py

@@ -0,0 +1,20 @@
+# Generated by Django 5.1.4 on 2025-02-21 17:55
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("reviews", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="review",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+    ]

rides/migrations/0006_alter_rideevent_options_alter_ridemodelevent_options_and_more.py

@@ -0,0 +1,76 @@
+# Generated by Django 5.1.4 on 2025-02-21 17:55
+
+import pgtrigger.migrations
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("parks", "0003_alter_park_id_alter_parkarea_id_and_more"),
+        ("rides", "0005_fix_event_context_fields"),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name="rideevent",
+            options={"managed": False},
+        ),
+        migrations.AlterModelOptions(
+            name="ridemodelevent",
+            options={"managed": False},
+        ),
+        pgtrigger.migrations.RemoveTrigger(
+            model_name="ride",
+            name="insert_insert",
+        ),
+        pgtrigger.migrations.RemoveTrigger(
+            model_name="ride",
+            name="update_update",
+        ),
+        pgtrigger.migrations.RemoveTrigger(
+            model_name="ridemodel",
+            name="insert_insert",
+        ),
+        pgtrigger.migrations.RemoveTrigger(
+            model_name="ridemodel",
+            name="update_update",
+        ),
+        migrations.AlterField(
+            model_name="ride",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="ride",
+            name="status",
+            field=models.CharField(
+                choices=[
+                    ("", "Select status"),
+                    ("OPERATING", "Operating"),
+                    ("CLOSED_TEMP", "Temporarily Closed"),
+                    ("SBNO", "Standing But Not Operating"),
+                    ("CLOSING", "Closing"),
+                    ("CLOSED_PERM", "Permanently Closed"),
+                    ("UNDER_CONSTRUCTION", "Under Construction"),
+                    ("DEMOLISHED", "Demolished"),
+                    ("RELOCATED", "Relocated"),
+                ],
+                default="OPERATING",
+                max_length=20,
+            ),
+        ),
+        migrations.AlterField(
+            model_name="ridemodel",
+            name="id",
+            field=models.BigAutoField(
+                auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
+            ),
+        ),
+        migrations.AlterUniqueTogether(
+            name="ride",
+            unique_together={("park", "slug")},
+        ),
+    ]

search/templates/search/components/filter_form.html

@@ -1,16 +1,21 @@
 {% load static %}
+{% load filter_utils %}
 
-<div class="filter-container bg-white rounded-lg shadow p-4" x-data="{ open: false }">
+<div class="filter-container" x-data="{ open: false }">
     {# Mobile Filter Toggle #}
-    <div class="lg:hidden">
-        <button @click="open = !open" type="button" class="w-full flex items-center justify-between p-2 text-gray-400 hover:text-gray-500">
-            <span class="font-medium text-gray-900">Filters</span>
-            <span class="ml-6 flex items-center">
-                <svg class="w-5 h-5" x-show="!open" fill="currentColor" viewBox="0 0 20 20">
-                    <path d="M10 6L16 12H4L10 6Z"/>
+    <div class="lg:hidden bg-white rounded-lg shadow p-4 mb-4">
+        <button @click="open = !open" type="button" class="w-full flex items-center justify-between p-2">
+            <span class="font-medium text-gray-900">
+                <span class="mr-2">
+                    <svg class="w-5 h-5 inline-block" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 6V4m0 2a2 2 0 100 4m0-4a2 2 0 110 4m-6 8a2 2 0 100-4m0 4a2 2 0 110-4m0 4v2m0-6V4m6 6v10m6-2a2 2 0 100-4m0 4a2 2 0 110-4m0 4v2m0-6V4"></path>
                     </svg>
-                <svg class="w-5 h-5" x-show="open" fill="currentColor" viewBox="0 0 20 20">
-                    <path d="M10 14L4 8H16L10 14Z"/>
+                </span>
+                Filter Options
+            </span>
+            <span class="text-gray-500">
+                <svg class="w-5 h-5 transition-transform duration-200" :class="{'rotate-180': open}" fill="currentColor" viewBox="0 0 20 20">
+                    <path d="M5.293 7.293a1 1 0 011.414 0L10 10.586l3.293-3.293a1 1 0 111.414 1.414l-4 4a1 1 0 01-1.414 0l-4-4a1 1 0 010-1.414z"></path>
                 </svg>
             </span>
         </button>
@@ -18,20 +23,23 @@
 
     {# Filter Form #}
     <form hx-get="{{ request.path }}" 
-          hx-trigger="change delay:500ms, submit"
+          hx-trigger="change delay:500ms"
           hx-target="#results-container"
           hx-push-url="true"
-          class="mt-4 lg:mt-0"
+          class="space-y-6"
           x-show="open || $screen('lg')"
           x-transition>
         
         {# Active Filters Summary #}
         {% if applied_filters %}
-        <div class="bg-blue-50 p-4 rounded-lg mb-4">
+        <div class="bg-blue-50 rounded-lg p-4 shadow-sm border border-blue-100">
             <div class="flex justify-between items-center">
+                <div>
                     <h3 class="text-sm font-medium text-blue-800">Active Filters</h3>
+                    <p class="text-xs text-blue-600 mt-1">{{ applied_filters|length }} filter{{ applied_filters|length|pluralize }} applied</p>
+                </div>
                 <a href="{{ request.path }}" 
-                   class="text-sm text-blue-600 hover:text-blue-500"
+                   class="text-sm font-medium text-blue-600 hover:text-blue-500 hover:underline"
                    hx-get="{{ request.path }}"
                    hx-target="#results-container"
                    hx-push-url="true">
@@ -42,21 +50,35 @@
         {% endif %}
 
         {# Filter Groups #}
-        <div class="space-y-4">
+        <div class="bg-white rounded-lg shadow divide-y divide-gray-200">
             {% for fieldset in filter.form|groupby_filters %}
-            <div class="border-b border-gray-200 pb-4">
-                <h3 class="text-sm font-medium text-gray-900 mb-3">{{ fieldset.name }}</h3>
-                <div class="space-y-3">
+            <div class="p-6" x-data="{ expanded: true }">
+                {# Group Header #}
+                <button type="button" 
+                        @click="expanded = !expanded"
+                        class="w-full flex justify-between items-center text-left">
+                    <h3 class="text-lg font-medium text-gray-900">{{ fieldset.name }}</h3>
+                    <svg class="w-5 h-5 text-gray-500 transform transition-transform duration-200"
+                         :class="{'rotate-180': !expanded}"
+                         fill="currentColor" 
+                         viewBox="0 0 20 20">
+                        <path d="M5.293 7.293a1 1 0 011.414 0L10 10.586l3.293-3.293a1 1 0 111.414 1.414l-4 4a1 1 0 01-1.414 0l-4-4a1 1 0 010-1.414z"/>
+                    </svg>
+                </button>
+
+                {# Group Content #}
+                <div class="mt-4 space-y-4" x-show="expanded" x-collapse>
                     {% for field in fieldset.fields %}
-                    <div>
-                        <label for="{{ field.id_for_label }}" class="text-sm text-gray-600">
+                    <div class="filter-field">
+                        <label for="{{ field.id_for_label }}" 
+                               class="block text-sm font-medium text-gray-700 mb-1">
                             {{ field.label }}
                         </label>
                         <div class="mt-1">
-                            {{ field }}
+                            {{ field|add_field_classes }}
                         </div>
                         {% if field.help_text %}
-                        <p class="mt-1 text-xs text-gray-500">{{ field.help_text }}</p>
+                        <p class="mt-1 text-sm text-gray-500">{{ field.help_text }}</p>
                         {% endif %}
                     </div>
                     {% endfor %}
@@ -65,17 +87,25 @@
             {% endfor %}
         </div>
 
-        {# Submit Button - Only visible on mobile #}
-        <div class="mt-4 lg:hidden">
+        {# Mobile Apply Button #}
+        <div class="lg:hidden">
             <button type="submit" 
-                    class="w-full bg-blue-600 text-white px-4 py-2 rounded-md hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    class="w-full bg-blue-600 text-white px-4 py-2 rounded-md hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2 transition duration-150 ease-in-out">
                 Apply Filters
             </button>
         </div>
     </form>
 </div>
 
-{% block extra_scripts %}
-{# Add Alpine.js for mobile menu toggle if not already included #}
+{# Required Scripts #}
 <script defer src="https://unpkg.com/alpinejs@3.x.x/dist/cdn.min.js"></script>
-{% endblock %}
+<script>
+    document.addEventListener('alpine:init', () => {
+        Alpine.data('filterForm', () => ({
+            expanded: true,
+            toggle() {
+                this.expanded = !this.expanded
+            }
+        }))
+    })
+</script>

search/templatetags/filter_utils.py

@@ -32,17 +32,18 @@ def groupby_filters(form: Form) -> List[Dict[str, Any]]:
     """
     groups = []
     
-    # Define groups and their patterns
+    # Define groups and their patterns with specific ordering
     group_patterns = {
-        'Search': lambda f: f.name in ['search', 'q'],
+        'Quick Search': lambda f: f.name in ['search', 'q'],
+        'Park Details': lambda f: f.name in ['status', 'has_owner', 'owner'],
+        'Attractions': lambda f: any(x in f.name for x in ['rides', 'coasters']),
+        'Park Size': lambda f: 'size' in f.name,
         'Location': lambda f: f.name.startswith('location') or 'address' in f.name,
-        'Dates': lambda f: any(x in f.name for x in ['date', 'created', 'updated']),
-        'Rating': lambda f: 'rating' in f.name,
-        'Status': lambda f: f.name in ['status', 'state', 'condition'],
-        'Features': lambda f: f.name.startswith('has_') or f.name.endswith('_count'),
+        'Ratings': lambda f: 'rating' in f.name,
+        'Opening Info': lambda f: 'opening' in f.name or 'date' in f.name,
     }
     
-    # Initialize group containers
+    # Initialize group containers with ordering preserved
     grouped_fields: Dict[str, List] = {name: [] for name in group_patterns.keys()}
     ungrouped = []
     
@@ -57,7 +58,7 @@ def groupby_filters(form: Form) -> List[Dict[str, Any]]:
         if not grouped:
             ungrouped.append(field)
     
-    # Build final groups list, only including non-empty groups
+    # Build final groups list, maintaining order and only including non-empty groups
     for name, fields in grouped_fields.items():
         if fields:
             groups.append({
@@ -68,7 +69,7 @@ def groupby_filters(form: Form) -> List[Dict[str, Any]]:
     # Add ungrouped fields at the end if any exist
     if ungrouped:
         groups.append({
-            'name': 'Other',
+            'name': 'Other Filters',
             'fields': ungrouped
         })
     
@@ -86,15 +87,26 @@ def add_field_classes(field: Any) -> Any:
     """
     Add appropriate Tailwind classes based on field type
     """
+    base_classes = "transition duration-150 ease-in-out "
+    
     classes = {
-        'default': 'mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-blue-300 focus:ring focus:ring-blue-200 focus:ring-opacity-50',
-        'checkbox': 'rounded border-gray-300 text-blue-600 shadow-sm focus:border-blue-300 focus:ring focus:ring-offset-0 focus:ring-blue-200 focus:ring-opacity-50',
-        'radio': 'border-gray-300 text-blue-600 shadow-sm focus:border-blue-300 focus:ring focus:ring-offset-0 focus:ring-blue-200 focus:ring-opacity-50',
-        'select': 'mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-blue-300 focus:ring focus:ring-blue-200 focus:ring-opacity-50',
-        'multiselect': 'mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-blue-300 focus:ring focus:ring-blue-200 focus:ring-opacity-50',
+        'default': base_classes + 'mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-blue-500 focus:ring focus:ring-blue-200 focus:ring-opacity-50',
+        'checkbox': base_classes + 'h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500',
+        'radio': base_classes + 'h-4 w-4 border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500',
+        'select': base_classes + 'mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-blue-500 focus:ring focus:ring-blue-200 focus:ring-opacity-50',
+        'multiselect': base_classes + 'mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-blue-500 focus:ring focus:ring-blue-200 focus:ring-opacity-50',
+        'range': base_classes + 'mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-blue-500 focus:ring focus:ring-blue-200 focus:ring-opacity-50',
+        'dateinput': base_classes + 'mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-blue-500 focus:ring focus:ring-blue-200 focus:ring-opacity-50',
     }
     
     field_type = get_field_type(field)
     css_class = classes.get(field_type, classes['default'])
     
-    return field.as_widget(attrs={'class': css_class})
+    current_attrs = field.field.widget.attrs
+    current_attrs['class'] = css_class
+    
+    # Add specific attributes for certain field types
+    if field_type == 'dateinput':
+        current_attrs['type'] = 'date'
+    
+    return field.as_widget(attrs=current_attrs)

static/css/alerts.css

@@ -1,44 +1,37 @@
-/* Alert Styles */
 .alert {
-    @apply fixed z-50 px-4 py-3 transition-all duration-500 transform rounded-lg shadow-lg right-4 top-4;
-    animation: slideIn 0.5s ease-out forwards;
+    padding: 1rem;
+    margin-bottom: 1rem;
+    border-radius: 0.375rem;
+    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+    opacity: 1;
+    transition: opacity 0.3s ease-in-out;
+    cursor: pointer;
 }
 
 .alert-success {
-    @apply text-white bg-green-500;
+    background-color: #E8F5E9;
+    border: 1px solid #A5D6A7;
+    color: #2E7D32;
 }
 
 .alert-error {
-    @apply text-white bg-red-500;
-}
-
-.alert-info {
-    @apply text-white bg-blue-500;
+    background-color: #FFEBEE;
+    border: 1px solid #FFCDD2;
+    color: #C62828;
 }
 
 .alert-warning {
-    @apply text-white bg-yellow-500;
+    background-color: #FFF3E0;
+    border: 1px solid #FFCC80;
+    color: #EF6C00;
 }
 
-/* Animation keyframes */
-@keyframes slideIn {
-    0% {
-        transform: translateX(100%);
-        opacity: 0;
-    }
-    100% {
-        transform: translateX(0);
-        opacity: 1;
-    }
+.alert-info {
+    background-color: #E3F2FD;
+    border: 1px solid #90CAF9;
+    color: #1565C0;
 }
 
-@keyframes slideOut {
-    0% {
-        transform: translateX(0);
-        opacity: 1;
-    }
-    100% {
-        transform: translateX(100%);
+.alert.fade-out {
     opacity: 0;
-    }
 }

static/js/alerts.js

@@ -1,18 +1,21 @@
-document.addEventListener('DOMContentLoaded', function() {
-    // Get all alert elements
+document.addEventListener('DOMContentLoaded', () => {
     const alerts = document.querySelectorAll('.alert');
 
-    // For each alert
     alerts.forEach(alert => {
-        // After 5 seconds
+        // Auto-hide alerts after 5 seconds
         setTimeout(() => {
-            // Add slideOut animation
-            alert.style.animation = 'slideOut 0.5s ease-out forwards';
-            
-            // Remove the alert after animation completes
+            alert.classList.add('fade-out');
             setTimeout(() => {
                 alert.remove();
-            }, 500);
+            }, 300); // Match CSS transition duration
         }, 5000);
+
+        // Add click-to-dismiss functionality
+        alert.addEventListener('click', () => {
+            alert.classList.add('fade-out');
+            setTimeout(() => {
+                alert.remove();
+            }, 300);
+        });
     });
 });

static/js/location-autocomplete.js

@@ -1,81 +1,50 @@
-function locationAutocomplete(field, filterParks = false) {
-    return {
-        query: '',
-        suggestions: [],
-        fetchSuggestions() {
-            let url;
-            const params = new URLSearchParams({
-                q: this.query,
-                filter_parks: filterParks
+document.addEventListener('DOMContentLoaded', () => {
+    const countryInput = document.querySelector('[name="country"]');
+    const regionInput = document.querySelector('[name="region"]');
+    const cityInput = document.querySelector('[name="city"]');
+
+    if (!countryInput || !regionInput || !cityInput) return;
+
+    // Update regions when country changes
+    countryInput.addEventListener('change', () => {
+        const country = countryInput.value;
+        if (country) {
+            updateRegions(country);
+            // Clear city when country changes
+            cityInput.innerHTML = '<option value="">Select a city</option>';
+        }
     });
 
-            switch (field) {
-                case 'country':
-                    url = '/parks/ajax/countries/';
-                    break;
-                case 'region':
-                    url = '/parks/ajax/regions/';
-                    // Add country parameter if we're fetching regions
-                    const countryInput = document.getElementById(filterParks ? 'country' : 'id_country_name');
-                    if (countryInput && countryInput.value) {
-                        params.append('country', countryInput.value);
-                    }
-                    break;
-                case 'city':
-                    url = '/parks/ajax/cities/';
-                    // Add country and region parameters if we're fetching cities
-                    const regionInput = document.getElementById(filterParks ? 'region' : 'id_region_name');
-                    const cityCountryInput = document.getElementById(filterParks ? 'country' : 'id_country_name');
-                    if (regionInput && regionInput.value && cityCountryInput && cityCountryInput.value) {
-                        params.append('country', cityCountryInput.value);
-                        params.append('region', regionInput.value);
-                    }
-                    break;
+    // Update cities when region changes
+    regionInput.addEventListener('change', () => {
+        const country = countryInput.value;
+        const region = regionInput.value;
+        if (country && region) {
+            updateCities(country, region);
         }
+    });
 
-            if (url) {
-                fetch(`${url}?${params}`)
+    function updateRegions(country) {
+        fetch(`/location/regions/?country=${encodeURIComponent(country)}`)
             .then(response => response.json())
             .then(data => {
-                        this.suggestions = data;
+                regionInput.innerHTML = '<option value="">Select a region</option>';
+                data.regions.forEach(region => {
+                    const option = new Option(region, region);
+                    regionInput.add(option);
+                });
             });
     }
-        },
-        selectSuggestion(suggestion) {
-            this.query = suggestion.name;
-            this.suggestions = [];
 
-            // If this is a form field (not filter), update hidden fields
-            if (!filterParks) {
-                const hiddenField = document.getElementById(`id_${field}`);
-                if (hiddenField) {
-                    hiddenField.value = suggestion.id;
+    function updateCities(country, region) {
+        fetch(`/location/cities/?country=${encodeURIComponent(country)}&region=${encodeURIComponent(region)}`)
+            .then(response => response.json())
+            .then(data => {
+                cityInput.innerHTML = '<option value="">Select a city</option>';
+                data.cities.forEach(city => {
+                    const option = new Option(city, city);
+                    cityInput.add(option);
+                });
+            });
     }
-
-                // Clear dependent fields when parent field changes
-                if (field === 'country') {
-                    const regionInput = document.getElementById('id_region_name');
-                    const cityInput = document.getElementById('id_city_name');
-                    const regionHidden = document.getElementById('id_region');
-                    const cityHidden = document.getElementById('id_city');
-                    
-                    if (regionInput) regionInput.value = '';
-                    if (cityInput) cityInput.value = '';
-                    if (regionHidden) regionHidden.value = '';
-                    if (cityHidden) cityHidden.value = '';
-                } else if (field === 'region') {
-                    const cityInput = document.getElementById('id_city_name');
-                    const cityHidden = document.getElementById('id_city');
-                    
-                    if (cityInput) cityInput.value = '';
-                    if (cityHidden) cityHidden.value = '';
-                }
-            }
-
-            // Trigger form submission for filters
-            if (filterParks) {
-                htmx.trigger('#park-filters', 'change');
-            }
-        }
-    };
-}
+});

static/js/main.js

@@ -1,141 +1,40 @@
-// Theme handling
+// Theme Toggle
 document.addEventListener('DOMContentLoaded', () => {
     const themeToggle = document.getElementById('theme-toggle');
-    const html = document.documentElement;
+    const themeIcon = themeToggle.nextElementSibling.querySelector('i');
 
-    // Initialize toggle state based on current theme
-    if (themeToggle) {
-        themeToggle.checked = html.classList.contains('dark');
+    // Set initial icon
+    updateThemeIcon();
 
-        // Handle toggle changes
-        themeToggle.addEventListener('change', function() {
-            const isDark = this.checked;
-            html.classList.toggle('dark', isDark);
-            localStorage.setItem('theme', isDark ? 'dark' : 'light');
+    themeToggle.addEventListener('change', () => {
+        if (document.documentElement.classList.contains('dark')) {
+            document.documentElement.classList.remove('dark');
+            localStorage.setItem('theme', 'light');
+        } else {
+            document.documentElement.classList.add('dark');
+            localStorage.setItem('theme', 'dark');
+        }
+        updateThemeIcon();
     });
 
-        // Listen for system theme changes
-        const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
-        mediaQuery.addEventListener('change', (e) => {
-            if (!localStorage.getItem('theme')) {
-                const isDark = e.matches;
-                html.classList.toggle('dark', isDark);
-                themeToggle.checked = isDark;
+    function updateThemeIcon() {
+        const isDark = document.documentElement.classList.contains('dark');
+        themeIcon.classList.remove('fa-sun', 'fa-moon');
+        themeIcon.classList.add(isDark ? 'fa-sun' : 'fa-moon');
     }
-        });
-    }
-});
 
-// Handle search form submission
-document.addEventListener('submit', (e) => {
-    if (e.target.matches('form[action*="search"]')) {
-        const searchInput = e.target.querySelector('input[name="q"]');
-        if (!searchInput.value.trim()) {
-            e.preventDefault();
-        }
-    }
-});
-
-// Mobile menu toggle with transitions
-document.addEventListener('DOMContentLoaded', () => {
+    // Mobile Menu Toggle
     const mobileMenuBtn = document.getElementById('mobileMenuBtn');
     const mobileMenu = document.getElementById('mobileMenu');
+    const menuIcon = mobileMenuBtn.querySelector('i');
 
-    if (mobileMenuBtn && mobileMenu) {
+    mobileMenu.style.display = 'none';
     let isMenuOpen = false;
 
-        const toggleMenu = () => {
+    mobileMenuBtn.addEventListener('click', () => {
         isMenuOpen = !isMenuOpen;
-            mobileMenu.classList.toggle('show', isMenuOpen);
-            mobileMenuBtn.setAttribute('aria-expanded', isMenuOpen.toString());
-            
-            // Update icon
-            const icon = mobileMenuBtn.querySelector('i');
-            icon.classList.remove(isMenuOpen ? 'fa-bars' : 'fa-times');
-            icon.classList.add(isMenuOpen ? 'fa-times' : 'fa-bars');
-        };
-
-        mobileMenuBtn.addEventListener('click', toggleMenu);
-
-        // Close menu when clicking outside
-        document.addEventListener('click', (e) => {
-            if (isMenuOpen && !mobileMenu.contains(e.target) && !mobileMenuBtn.contains(e.target)) {
-                toggleMenu();
-            }
-        });
-
-        // Close menu when pressing escape
-        document.addEventListener('keydown', (e) => {
-            if (isMenuOpen && e.key === 'Escape') {
-                toggleMenu();
-            }
-        });
-
-        // Handle viewport changes
-        const mediaQuery = window.matchMedia('(min-width: 1024px)');
-        mediaQuery.addEventListener('change', (e) => {
-            if (e.matches && isMenuOpen) {
-                toggleMenu();
-            }
-        });
-    }
-});
-
-// User dropdown toggle
-const userMenuBtn = document.getElementById('userMenuBtn');
-const userDropdown = document.getElementById('userDropdown');
-
-if (userMenuBtn && userDropdown) {
-    userMenuBtn.addEventListener('click', (e) => {
-        e.stopPropagation();
-        userDropdown.classList.toggle('active');
-    });
-
-    // Close dropdown when clicking outside
-    document.addEventListener('click', (e) => {
-        if (!userMenuBtn.contains(e.target) && !userDropdown.contains(e.target)) {
-            userDropdown.classList.remove('active');
-        }
-    });
-
-    // Close dropdown when pressing escape
-    document.addEventListener('keydown', (e) => {
-        if (e.key === 'Escape') {
-            userDropdown.classList.remove('active');
-        }
-    });
-}
-
-// Handle flash messages
-document.addEventListener('DOMContentLoaded', () => {
-    const alerts = document.querySelectorAll('.alert');
-    alerts.forEach(alert => {
-        setTimeout(() => {
-            alert.style.opacity = '0';
-            setTimeout(() => alert.remove(), 300);
-        }, 5000);
-    });
-});
-
-// Initialize tooltips
-document.addEventListener('DOMContentLoaded', () => {
-    const tooltips = document.querySelectorAll('[data-tooltip]');
-    tooltips.forEach(tooltip => {
-        tooltip.addEventListener('mouseenter', (e) => {
-            const text = e.target.getAttribute('data-tooltip');
-            const tooltipEl = document.createElement('div');
-            tooltipEl.className = 'absolute z-50 px-2 py-1 text-sm text-white bg-gray-900 rounded tooltip';
-            tooltipEl.textContent = text;
-            document.body.appendChild(tooltipEl);
-            
-            const rect = e.target.getBoundingClientRect();
-            tooltipEl.style.top = rect.bottom + 5 + 'px';
-            tooltipEl.style.left = rect.left + (rect.width - tooltipEl.offsetWidth) / 2 + 'px';
-        });
-        
-        tooltip.addEventListener('mouseleave', () => {
-            const tooltips = document.querySelectorAll('.tooltip');
-            tooltips.forEach(t => t.remove());
-        });
+        mobileMenu.style.display = isMenuOpen ? 'block' : 'none';
+        menuIcon.classList.remove('fa-bars', 'fa-times');
+        menuIcon.classList.add(isMenuOpen ? 'fa-times' : 'fa-bars');
     });
 });

static/js/park-map.js

@@ -1,29 +0,0 @@
-// Only declare parkMap if it doesn't exist
-window.parkMap = window.parkMap || null;
-
-function initParkMap(latitude, longitude, name) {
-    const mapContainer = document.getElementById('park-map');
-    
-    // Only initialize if container exists and map hasn't been initialized
-    if (mapContainer && !window.parkMap) {
-        const width = mapContainer.offsetWidth;
-        mapContainer.style.height = width + 'px';
-
-        window.parkMap = L.map('park-map').setView([latitude, longitude], 13);
-        
-        L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png', {
-            attribution: '© OpenStreetMap contributors'
-        }).addTo(window.parkMap);
-
-        L.marker([latitude, longitude])
-         .addTo(window.parkMap)
-         .bindPopup(name);
-
-        // Update map size when window is resized
-        window.addEventListener('resize', function() {
-            const width = mapContainer.offsetWidth;
-            mapContainer.style.height = width + 'px';
-            window.parkMap.invalidateSize();
-        });
-    }
-}

static/js/photo-gallery.js

@@ -1,91 +0,0 @@
-document.addEventListener('alpine:init', () => {
-    Alpine.data('photoDisplay', ({ photos, contentType, objectId, csrfToken, uploadUrl }) => ({
-        photos,
-        fullscreenPhoto: null,
-        uploading: false,
-        uploadProgress: 0,
-        error: null,
-        showSuccess: false,
-
-        showFullscreen(photo) {
-            this.fullscreenPhoto = photo;
-        },
-
-        async handleFileSelect(event) {
-            const files = Array.from(event.target.files);
-            if (!files.length) {
-                return;
-            }
-
-            this.uploading = true;
-            this.uploadProgress = 0;
-            this.error = null;
-            this.showSuccess = false;
-
-            const totalFiles = files.length;
-            let completedFiles = 0;
-
-            for (const file of files) {
-                const formData = new FormData();
-                formData.append('image', file);
-                formData.append('app_label', contentType.split('.')[0]);
-                formData.append('model', contentType.split('.')[1]);
-                formData.append('object_id', objectId);
-
-                try {
-                    const response = await fetch(uploadUrl, {
-                        method: 'POST',
-                        headers: {
-                            'X-CSRFToken': csrfToken,
-                        },
-                        body: formData
-                    });
-
-                    if (!response.ok) {
-                        const data = await response.json();
-                        throw new Error(data.error || 'Upload failed');
-                    }
-
-                    const photo = await response.json();
-                    this.photos.push(photo);
-                    completedFiles++;
-                    this.uploadProgress = (completedFiles / totalFiles) * 100;
-                } catch (err) {
-                    this.error = err.message || 'Failed to upload photo. Please try again.';
-                    console.error('Upload error:', err);
-                    break;
-                }
-            }
-
-            this.uploading = false;
-            event.target.value = ''; // Reset file input
-
-            if (!this.error) {
-                this.showSuccess = true;
-                setTimeout(() => {
-                    this.showSuccess = false;
-                }, 3000);
-            }
-        },
-
-        async sharePhoto(photo) {
-            if (navigator.share) {
-                try {
-                    await navigator.share({
-                        title: photo.caption || 'Shared photo',
-                        url: photo.url
-                    });
-                } catch (err) {
-                    if (err.name !== 'AbortError') {
-                        console.error('Error sharing:', err);
-                    }
-                }
-            } else {
-                // Fallback: copy URL to clipboard
-                navigator.clipboard.writeText(photo.url)
-                    .then(() => alert('Photo URL copied to clipboard!'))
-                    .catch(err => console.error('Error copying to clipboard:', err));
-            }
-        }
-    }));
-});

staticfiles/css/alerts.css

@@ -1,44 +1,37 @@
-/* Alert Styles */
 .alert {
-    @apply fixed z-50 px-4 py-3 transition-all duration-500 transform rounded-lg shadow-lg right-4 top-4;
-    animation: slideIn 0.5s ease-out forwards;
+    padding: 1rem;
+    margin-bottom: 1rem;
+    border-radius: 0.375rem;
+    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+    opacity: 1;
+    transition: opacity 0.3s ease-in-out;
+    cursor: pointer;
 }
 
 .alert-success {
-    @apply text-white bg-green-500;
+    background-color: #E8F5E9;
+    border: 1px solid #A5D6A7;
+    color: #2E7D32;
 }
 
 .alert-error {
-    @apply text-white bg-red-500;
-}
-
-.alert-info {
-    @apply text-white bg-blue-500;
+    background-color: #FFEBEE;
+    border: 1px solid #FFCDD2;
+    color: #C62828;
 }
 
 .alert-warning {
-    @apply text-white bg-yellow-500;
+    background-color: #FFF3E0;
+    border: 1px solid #FFCC80;
+    color: #EF6C00;
 }
 
-/* Animation keyframes */
-@keyframes slideIn {
-    0% {
-        transform: translateX(100%);
-        opacity: 0;
-    }
-    100% {
-        transform: translateX(0);
-        opacity: 1;
-    }
+.alert-info {
+    background-color: #E3F2FD;
+    border: 1px solid #90CAF9;
+    color: #1565C0;
 }
 
-@keyframes slideOut {
-    0% {
-        transform: translateX(0);
-        opacity: 1;
-    }
-    100% {
-        transform: translateX(100%);
+.alert.fade-out {
     opacity: 0;
-    }
 }

staticfiles/css/tailwind.css

@@ -2181,6 +2181,18 @@ select {
   justify-content: center;
 }
 
+.sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border-width: 0;
+}
+
 .visible {
   visibility: visible;
 }
@@ -2457,6 +2469,10 @@ select {
   display: none;
 }
 
+.h-10 {
+  height: 2.5rem;
+}
+
 .h-16 {
   height: 4rem;
 }
@@ -2485,6 +2501,10 @@ select {
   height: 1.25rem;
 }
 
+.h-6 {
+  height: 1.5rem;
+}
+
 .h-8 {
   height: 2rem;
 }
@@ -2533,6 +2553,10 @@ select {
   width: 1.25rem;
 }
 
+.w-6 {
+  width: 1.5rem;
+}
+
 .w-64 {
   width: 16rem;
 }
@@ -2646,6 +2670,16 @@ select {
   transform: translate(var(--tw-translate-x), var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y));
 }
 
+@keyframes pulse {
+  50% {
+    opacity: .5;
+  }
+}
+
+.animate-pulse {
+  animation: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
+}
+
 @keyframes spin {
   to {
     transform: rotate(360deg);
@@ -3000,10 +3034,6 @@ select {
   background-color: rgb(17 24 39 / var(--tw-bg-opacity));
 }
 
-.bg-gray-900\/80 {
-  background-color: rgb(17 24 39 / 0.8);
-}
-
 .bg-green-100 {
   --tw-bg-opacity: 1;
   background-color: rgb(220 252 231 / var(--tw-bg-opacity));
@@ -3244,6 +3274,10 @@ select {
   padding-bottom: 1rem;
 }
 
+.pt-2 {
+  padding-top: 0.5rem;
+}
+
 .text-left {
   text-align: left;
 }
@@ -3335,6 +3369,11 @@ select {
   color: rgb(37 99 235 / var(--tw-text-opacity));
 }
 
+.text-blue-700 {
+  --tw-text-opacity: 1;
+  color: rgb(29 78 216 / var(--tw-text-opacity));
+}
+
 .text-blue-800 {
   --tw-text-opacity: 1;
   color: rgb(30 64 175 / var(--tw-text-opacity));
@@ -3405,6 +3444,11 @@ select {
   color: rgb(79 70 229 / var(--tw-text-opacity));
 }
 
+.text-red-100 {
+  --tw-text-opacity: 1;
+  color: rgb(254 226 226 / var(--tw-text-opacity));
+}
+
 .text-red-400 {
   --tw-text-opacity: 1;
   color: rgb(248 113 113 / var(--tw-text-opacity));
@@ -3507,6 +3551,11 @@ select {
   box-shadow: var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000), var(--tw-shadow);
 }
 
+.outline-none {
+  outline: 2px solid transparent;
+  outline-offset: 2px;
+}
+
 .ring-2 {
   --tw-ring-offset-shadow: var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);
   --tw-ring-shadow: var(--tw-ring-inset) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color);
@@ -3522,6 +3571,19 @@ select {
   --tw-ring-color: rgb(79 70 229 / 0.2);
 }
 
+.ring-offset-2 {
+  --tw-ring-offset-width: 2px;
+}
+
+.ring-offset-white {
+  --tw-ring-offset-color: #fff;
+}
+
+.blur {
+  --tw-blur: blur(8px);
+  filter: var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);
+}
+
 .filter {
   filter: var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);
 }
@@ -3796,6 +3858,11 @@ select {
   border-color: rgb(59 130 246 / var(--tw-border-opacity));
 }
 
+.focus\:bg-gray-100:focus {
+  --tw-bg-opacity: 1;
+  background-color: rgb(243 244 246 / var(--tw-bg-opacity));
+}
+
 .focus\:underline:focus {
   text-decoration-line: underline;
 }
@@ -3824,6 +3891,10 @@ select {
   --tw-ring-offset-width: 2px;
 }
 
+.active\:transform:active {
+  transform: translate(var(--tw-translate-x), var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y));
+}
+
 .disabled\:opacity-50:disabled {
   opacity: 0.5;
 }
@@ -3930,6 +4001,10 @@ select {
   background-color: rgb(185 28 28 / var(--tw-bg-opacity));
 }
 
+.dark\:bg-red-900\/40:is(.dark *) {
+  background-color: rgb(127 29 29 / 0.4);
+}
+
 .dark\:bg-yellow-200:is(.dark *) {
   --tw-bg-opacity: 1;
   background-color: rgb(254 240 138 / var(--tw-bg-opacity));
@@ -3968,6 +4043,11 @@ select {
   --tw-gradient-to: #3b0764 var(--tw-gradient-to-position);
 }
 
+.dark\:text-blue-100:is(.dark *) {
+  --tw-text-opacity: 1;
+  color: rgb(219 234 254 / var(--tw-text-opacity));
+}
+
 .dark\:text-blue-200:is(.dark *) {
   --tw-text-opacity: 1;
   color: rgb(191 219 254 / var(--tw-text-opacity));
@@ -4190,6 +4270,11 @@ select {
   color: rgb(255 255 255 / var(--tw-text-opacity));
 }
 
+.dark\:focus\:bg-gray-700:focus:is(.dark *) {
+  --tw-bg-opacity: 1;
+  background-color: rgb(55 65 81 / var(--tw-bg-opacity));
+}
+
 @media (min-width: 640px) {
   .sm\:col-span-3 {
     grid-column: span 3 / span 3;
@@ -4297,10 +4382,26 @@ select {
     grid-column: span 2 / span 2;
   }
 
+  .md\:col-span-3 {
+    grid-column: span 3 / span 3;
+  }
+
   .md\:mb-8 {
     margin-bottom: 2rem;
   }
 
+  .md\:block {
+    display: block;
+  }
+
+  .md\:grid {
+    display: grid;
+  }
+
+  .md\:hidden {
+    display: none;
+  }
+
   .md\:h-\[140px\] {
     height: 140px;
   }

staticfiles/js/alerts.js

@@ -1,18 +1,21 @@
-document.addEventListener('DOMContentLoaded', function() {
-    // Get all alert elements
+document.addEventListener('DOMContentLoaded', () => {
     const alerts = document.querySelectorAll('.alert');
 
-    // For each alert
     alerts.forEach(alert => {
-        // After 5 seconds
+        // Auto-hide alerts after 5 seconds
         setTimeout(() => {
-            // Add slideOut animation
-            alert.style.animation = 'slideOut 0.5s ease-out forwards';
-            
-            // Remove the alert after animation completes
+            alert.classList.add('fade-out');
             setTimeout(() => {
                 alert.remove();
-            }, 500);
+            }, 300); // Match CSS transition duration
         }, 5000);
+
+        // Add click-to-dismiss functionality
+        alert.addEventListener('click', () => {
+            alert.classList.add('fade-out');
+            setTimeout(() => {
+                alert.remove();
+            }, 300);
+        });
     });
 });

staticfiles/js/inline-edit.js

@@ -1,262 +0,0 @@
-document.addEventListener('DOMContentLoaded', function() {
-    // Handle edit button clicks
-    document.querySelectorAll('[data-edit-button]').forEach(button => {
-        button.addEventListener('click', function() {
-            const contentId = this.dataset.contentId;
-            const contentType = this.dataset.contentType;
-            const editableFields = document.querySelectorAll(`[data-editable][data-content-id="${contentId}"]`);
-            
-            // Toggle edit mode
-            editableFields.forEach(field => {
-                const currentValue = field.textContent.trim();
-                const fieldName = field.dataset.fieldName;
-                const fieldType = field.dataset.fieldType || 'text';
-                
-                // Create input field
-                let input;
-                if (fieldType === 'textarea') {
-                    input = document.createElement('textarea');
-                    input.value = currentValue;
-                    input.rows = 4;
-                } else if (fieldType === 'select') {
-                    input = document.createElement('select');
-                    // Get options from data attribute
-                    const options = JSON.parse(field.dataset.options || '[]');
-                    options.forEach(option => {
-                        const optionEl = document.createElement('option');
-                        optionEl.value = option.value;
-                        optionEl.textContent = option.label;
-                        optionEl.selected = option.value === currentValue;
-                        input.appendChild(optionEl);
-                    });
-                } else if (fieldType === 'date') {
-                    input = document.createElement('input');
-                    input.type = 'date';
-                    input.value = currentValue;
-                } else if (fieldType === 'number') {
-                    input = document.createElement('input');
-                    input.type = 'number';
-                    input.value = currentValue;
-                    if (field.dataset.min) input.min = field.dataset.min;
-                    if (field.dataset.max) input.max = field.dataset.max;
-                    if (field.dataset.step) input.step = field.dataset.step;
-                } else {
-                    input = document.createElement('input');
-                    input.type = fieldType;
-                    input.value = currentValue;
-                }
-                
-                input.className = 'w-full border-gray-300 rounded-lg form-input dark:border-gray-600 dark:bg-gray-700 dark:text-white';
-                input.dataset.originalValue = currentValue;
-                input.dataset.fieldName = fieldName;
-                
-                // Replace content with input
-                field.textContent = '';
-                field.appendChild(input);
-            });
-            
-            // Show save/cancel buttons
-            const actionButtons = document.createElement('div');
-            actionButtons.className = 'flex gap-2 mt-2';
-            actionButtons.innerHTML = `
-                <button class="px-4 py-2 text-white bg-blue-600 rounded-lg hover:bg-blue-700 dark:bg-blue-500 dark:hover:bg-blue-600" data-save-button>
-                    <i class="mr-2 fas fa-save"></i>Save Changes
-                </button>
-                <button class="px-4 py-2 text-gray-700 bg-gray-200 rounded-lg hover:bg-gray-300 dark:bg-gray-600 dark:text-gray-200 dark:hover:bg-gray-500" data-cancel-button>
-                    <i class="mr-2 fas fa-times"></i>Cancel
-                </button>
-                ${this.dataset.requireReason ? `
-                    <div class="flex-grow">
-                        <input type="text" class="w-full border-gray-300 rounded-lg form-input dark:border-gray-600 dark:bg-gray-700 dark:text-white" 
-                               placeholder="Reason for changes (required)" 
-                               data-reason-input>
-                        <input type="text" class="w-full mt-1 border-gray-300 rounded-lg form-input dark:border-gray-600 dark:bg-gray-700 dark:text-white" 
-                               placeholder="Source (optional)" 
-                               data-source-input>
-                    </div>
-                ` : ''}
-            `;
-            
-            const container = editableFields[0].closest('.editable-container');
-            container.appendChild(actionButtons);
-            
-            // Hide edit button while editing
-            this.style.display = 'none';
-        });
-    });
-    
-    // Handle form submissions
-    document.querySelectorAll('form[data-submit-type]').forEach(form => {
-        form.addEventListener('submit', function(e) {
-            e.preventDefault();
-            
-            const submitType = this.dataset.submitType;
-            const formData = new FormData(this);
-            const data = {};
-            
-            formData.forEach((value, key) => {
-                data[key] = value;
-            });
-            
-            // Get CSRF token from meta tag
-            const csrfToken = document.querySelector('meta[name="csrf-token"]').getAttribute('content');
-            
-            // Submit form
-            fetch(this.action, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    'X-CSRFToken': csrfToken
-                },
-                body: JSON.stringify({
-                    submission_type: submitType,
-                    ...data
-                })
-            })
-            .then(response => response.json())
-            .then(data => {
-                if (data.status === 'success') {
-                    showNotification(data.message, 'success');
-                    if (data.redirect_url) {
-                        window.location.href = data.redirect_url;
-                    }
-                } else {
-                    showNotification(data.message, 'error');
-                }
-            })
-            .catch(error => {
-                showNotification('An error occurred while submitting the form.', 'error');
-                console.error('Error:', error);
-            });
-        });
-    });
-    
-    // Handle save button clicks using event delegation
-    document.addEventListener('click', function(e) {
-        if (e.target.matches('[data-save-button]')) {
-            const container = e.target.closest('.editable-container');
-            const contentId = container.querySelector('[data-editable]').dataset.contentId;
-            const contentType = container.querySelector('[data-edit-button]').dataset.contentType;
-            const editableFields = container.querySelectorAll('[data-editable]');
-            
-            // Collect changes
-            const changes = {};
-            editableFields.forEach(field => {
-                const input = field.querySelector('input, textarea, select');
-                if (input && input.value !== input.dataset.originalValue) {
-                    changes[input.dataset.fieldName] = input.value;
-                }
-            });
-            
-            // If no changes, just cancel
-            if (Object.keys(changes).length === 0) {
-                cancelEdit(container);
-                return;
-            }
-            
-            // Get reason and source if required
-            const reasonInput = container.querySelector('[data-reason-input]');
-            const sourceInput = container.querySelector('[data-source-input]');
-            const reason = reasonInput ? reasonInput.value : '';
-            const source = sourceInput ? sourceInput.value : '';
-            
-            // Validate reason if required
-            if (reasonInput && !reason) {
-                alert('Please provide a reason for your changes.');
-                return;
-            }
-            
-            // Get CSRF token from meta tag
-            const csrfToken = document.querySelector('meta[name="csrf-token"]').getAttribute('content');
-            
-            // Submit changes
-            fetch(window.location.pathname, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    'X-CSRFToken': csrfToken
-                },
-                body: JSON.stringify({
-                    content_type: contentType,
-                    content_id: contentId,
-                    changes,
-                    reason,
-                    source
-                })
-            })
-            .then(response => response.json())
-            .then(data => {
-                if (data.status === 'success') {
-                    if (data.auto_approved) {
-                        // Update the display immediately
-                        Object.entries(changes).forEach(([field, value]) => {
-                            const element = container.querySelector(`[data-editable][data-field-name="${field}"]`);
-                            if (element) {
-                                element.textContent = value;
-                            }
-                        });
-                    }
-                    showNotification(data.message, 'success');
-                    if (data.redirect_url) {
-                        window.location.href = data.redirect_url;
-                    }
-                } else {
-                    showNotification(data.message, 'error');
-                }
-                cancelEdit(container);
-            })
-            .catch(error => {
-                showNotification('An error occurred while saving changes.', 'error');
-                console.error('Error:', error);
-                cancelEdit(container);
-            });
-        }
-    });
-    
-    // Handle cancel button clicks using event delegation
-    document.addEventListener('click', function(e) {
-        if (e.target.matches('[data-cancel-button]')) {
-            const container = e.target.closest('.editable-container');
-            cancelEdit(container);
-        }
-    });
-});
-
-function cancelEdit(container) {
-    // Restore original content
-    container.querySelectorAll('[data-editable]').forEach(field => {
-        const input = field.querySelector('input, textarea, select');
-        if (input) {
-            field.textContent = input.dataset.originalValue;
-        }
-    });
-    
-    // Remove action buttons
-    const actionButtons = container.querySelector('.flex.gap-2');
-    if (actionButtons) {
-        actionButtons.remove();
-    }
-    
-    // Show edit button
-    const editButton = container.querySelector('[data-edit-button]');
-    if (editButton) {
-        editButton.style.display = '';
-    }
-}
-
-function showNotification(message, type = 'info') {
-    const notification = document.createElement('div');
-    notification.className = `fixed bottom-4 right-4 p-4 rounded-lg shadow-lg text-white ${
-        type === 'success' ? 'bg-green-600 dark:bg-green-500' :
-        type === 'error' ? 'bg-red-600 dark:bg-red-500' :
-        'bg-blue-600 dark:bg-blue-500'
-    }`;
-    notification.textContent = message;
-    
-    document.body.appendChild(notification);
-    
-    // Remove after 5 seconds
-    setTimeout(() => {
-        notification.remove();
-    }, 5000);
-}

staticfiles/js/location-autocomplete.js

@@ -1,81 +0,0 @@
-function locationAutocomplete(field, filterParks = false) {
-    return {
-        query: '',
-        suggestions: [],
-        fetchSuggestions() {
-            let url;
-            const params = new URLSearchParams({
-                q: this.query,
-                filter_parks: filterParks
-            });
-
-            switch (field) {
-                case 'country':
-                    url = '/parks/ajax/countries/';
-                    break;
-                case 'region':
-                    url = '/parks/ajax/regions/';
-                    // Add country parameter if we're fetching regions
-                    const countryInput = document.getElementById(filterParks ? 'country' : 'id_country_name');
-                    if (countryInput && countryInput.value) {
-                        params.append('country', countryInput.value);
-                    }
-                    break;
-                case 'city':
-                    url = '/parks/ajax/cities/';
-                    // Add country and region parameters if we're fetching cities
-                    const regionInput = document.getElementById(filterParks ? 'region' : 'id_region_name');
-                    const cityCountryInput = document.getElementById(filterParks ? 'country' : 'id_country_name');
-                    if (regionInput && regionInput.value && cityCountryInput && cityCountryInput.value) {
-                        params.append('country', cityCountryInput.value);
-                        params.append('region', regionInput.value);
-                    }
-                    break;
-            }
-
-            if (url) {
-                fetch(`${url}?${params}`)
-                    .then(response => response.json())
-                    .then(data => {
-                        this.suggestions = data;
-                    });
-            }
-        },
-        selectSuggestion(suggestion) {
-            this.query = suggestion.name;
-            this.suggestions = [];
-
-            // If this is a form field (not filter), update hidden fields
-            if (!filterParks) {
-                const hiddenField = document.getElementById(`id_${field}`);
-                if (hiddenField) {
-                    hiddenField.value = suggestion.id;
-                }
-
-                // Clear dependent fields when parent field changes
-                if (field === 'country') {
-                    const regionInput = document.getElementById('id_region_name');
-                    const cityInput = document.getElementById('id_city_name');
-                    const regionHidden = document.getElementById('id_region');
-                    const cityHidden = document.getElementById('id_city');
-                    
-                    if (regionInput) regionInput.value = '';
-                    if (cityInput) cityInput.value = '';
-                    if (regionHidden) regionHidden.value = '';
-                    if (cityHidden) cityHidden.value = '';
-                } else if (field === 'region') {
-                    const cityInput = document.getElementById('id_city_name');
-                    const cityHidden = document.getElementById('id_city');
-                    
-                    if (cityInput) cityInput.value = '';
-                    if (cityHidden) cityHidden.value = '';
-                }
-            }
-
-            // Trigger form submission for filters
-            if (filterParks) {
-                htmx.trigger('#park-filters', 'change');
-            }
-        }
-    };
-}

staticfiles/js/main.js

@@ -1,79 +1,40 @@
-// Initialize dark mode from localStorage
+// Theme Toggle
 document.addEventListener('DOMContentLoaded', () => {
-    // Check if dark mode was previously enabled
-    const darkMode = localStorage.getItem('darkMode') === 'true';
-    if (darkMode) {
+    const themeToggle = document.getElementById('theme-toggle');
+    const themeIcon = themeToggle.nextElementSibling.querySelector('i');
+
+    // Set initial icon
+    updateThemeIcon();
+
+    themeToggle.addEventListener('change', () => {
+        if (document.documentElement.classList.contains('dark')) {
+            document.documentElement.classList.remove('dark');
+            localStorage.setItem('theme', 'light');
+        } else {
             document.documentElement.classList.add('dark');
+            localStorage.setItem('theme', 'dark');
         }
-});
-
-// Handle search form submission
-document.addEventListener('submit', (e) => {
-    if (e.target.matches('form[action*="search"]')) {
-        const searchInput = e.target.querySelector('input[name="q"]');
-        if (!searchInput.value.trim()) {
-            e.preventDefault();
-        }
-    }
-});
-
-// Close mobile menu when clicking outside
-document.addEventListener('click', (e) => {
-    const mobileMenu = document.querySelector('[x-show="mobileMenuOpen"]');
-    const menuButton = document.querySelector('[x-on\\:click="mobileMenuOpen = !mobileMenuOpen"]');
-    
-    if (mobileMenu && menuButton && !mobileMenu.contains(e.target) && !menuButton.contains(e.target)) {
-        const alpineData = mobileMenu._x_dataStack && mobileMenu._x_dataStack[0];
-        if (alpineData && alpineData.mobileMenuOpen) {
-            alpineData.mobileMenuOpen = false;
-        }
-    }
-});
-
-// Handle flash messages
-document.addEventListener('DOMContentLoaded', () => {
-    const alerts = document.querySelectorAll('.alert');
-    alerts.forEach(alert => {
-        setTimeout(() => {
-            alert.style.opacity = '0';
-            setTimeout(() => alert.remove(), 300);
-        }, 5000);
-    });
-});
-
-// Initialize tooltips
-document.addEventListener('DOMContentLoaded', () => {
-    const tooltips = document.querySelectorAll('[data-tooltip]');
-    tooltips.forEach(tooltip => {
-        tooltip.addEventListener('mouseenter', (e) => {
-            const text = e.target.getAttribute('data-tooltip');
-            const tooltipEl = document.createElement('div');
-            tooltipEl.className = 'tooltip bg-gray-900 text-white px-2 py-1 rounded text-sm absolute z-50';
-            tooltipEl.textContent = text;
-            document.body.appendChild(tooltipEl);
-            
-            const rect = e.target.getBoundingClientRect();
-            tooltipEl.style.top = rect.bottom + 5 + 'px';
-            tooltipEl.style.left = rect.left + (rect.width - tooltipEl.offsetWidth) / 2 + 'px';
+        updateThemeIcon();
     });
 
-        tooltip.addEventListener('mouseleave', () => {
-            const tooltips = document.querySelectorAll('.tooltip');
-            tooltips.forEach(t => t.remove());
-        });
-    });
-});
+    function updateThemeIcon() {
+        const isDark = document.documentElement.classList.contains('dark');
+        themeIcon.classList.remove('fa-sun', 'fa-moon');
+        themeIcon.classList.add(isDark ? 'fa-sun' : 'fa-moon');
+    }
 
-// Handle dropdown menus
-document.addEventListener('click', (e) => {
-    const dropdowns = document.querySelectorAll('[x-show]');
-    dropdowns.forEach(dropdown => {
-        if (!dropdown.contains(e.target) && 
-            !e.target.matches('[x-on\\:click*="open = !open"]')) {
-            const alpineData = dropdown._x_dataStack && dropdown._x_dataStack[0];
-            if (alpineData && alpineData.open) {
-                alpineData.open = false;
-            }
-        }
+    // Mobile Menu Toggle
+    const mobileMenuBtn = document.getElementById('mobileMenuBtn');
+    const mobileMenu = document.getElementById('mobileMenu');
+    const menuIcon = mobileMenuBtn.querySelector('i');
+
+    mobileMenu.style.display = 'none';
+    let isMenuOpen = false;
+
+    mobileMenuBtn.addEventListener('click', () => {
+        isMenuOpen = !isMenuOpen;
+        mobileMenu.style.display = isMenuOpen ? 'block' : 'none';
+        menuIcon.classList.remove('fa-bars', 'fa-times');
+        menuIcon.classList.add(isMenuOpen ? 'fa-times' : 'fa-bars');
     });
 });

staticfiles/js/park-map.js

@@ -1,28 +0,0 @@
-let parkMap = null;
-
-function initParkMap(latitude, longitude, name) {
-    const mapContainer = document.getElementById('park-map');
-    
-    // Only initialize if container exists and map hasn't been initialized
-    if (mapContainer && !parkMap) {
-        const width = mapContainer.offsetWidth;
-        mapContainer.style.height = width + 'px';
-
-        parkMap = L.map('park-map').setView([latitude, longitude], 13);
-        
-        L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png', {
-            attribution: '© OpenStreetMap contributors'
-        }).addTo(parkMap);
-
-        L.marker([latitude, longitude])
-         .addTo(parkMap)
-         .bindPopup(name);
-
-        // Update map size when window is resized
-        window.addEventListener('resize', function() {
-            const width = mapContainer.offsetWidth;
-            mapContainer.style.height = width + 'px';
-            parkMap.invalidateSize();
-        });
-    }
-}

staticfiles/js/photo-gallery.js

@@ -1,91 +0,0 @@
-document.addEventListener('alpine:init', () => {
-    Alpine.data('photoDisplay', ({ photos, contentType, objectId, csrfToken, uploadUrl }) => ({
-        photos,
-        fullscreenPhoto: null,
-        uploading: false,
-        uploadProgress: 0,
-        error: null,
-        showSuccess: false,
-
-        showFullscreen(photo) {
-            this.fullscreenPhoto = photo;
-        },
-
-        async handleFileSelect(event) {
-            const files = Array.from(event.target.files);
-            if (!files.length) {
-                return;
-            }
-
-            this.uploading = true;
-            this.uploadProgress = 0;
-            this.error = null;
-            this.showSuccess = false;
-
-            const totalFiles = files.length;
-            let completedFiles = 0;
-
-            for (const file of files) {
-                const formData = new FormData();
-                formData.append('image', file);
-                formData.append('app_label', contentType.split('.')[0]);
-                formData.append('model', contentType.split('.')[1]);
-                formData.append('object_id', objectId);
-
-                try {
-                    const response = await fetch(uploadUrl, {
-                        method: 'POST',
-                        headers: {
-                            'X-CSRFToken': csrfToken,
-                        },
-                        body: formData
-                    });
-
-                    if (!response.ok) {
-                        const data = await response.json();
-                        throw new Error(data.error || 'Upload failed');
-                    }
-
-                    const photo = await response.json();
-                    this.photos.push(photo);
-                    completedFiles++;
-                    this.uploadProgress = (completedFiles / totalFiles) * 100;
-                } catch (err) {
-                    this.error = err.message || 'Failed to upload photo. Please try again.';
-                    console.error('Upload error:', err);
-                    break;
-                }
-            }
-
-            this.uploading = false;
-            event.target.value = ''; // Reset file input
-
-            if (!this.error) {
-                this.showSuccess = true;
-                setTimeout(() => {
-                    this.showSuccess = false;
-                }, 3000);
-            }
-        },
-
-        async sharePhoto(photo) {
-            if (navigator.share) {
-                try {
-                    await navigator.share({
-                        title: photo.caption || 'Shared photo',
-                        url: photo.url
-                    });
-                } catch (err) {
-                    if (err.name !== 'AbortError') {
-                        console.error('Error sharing:', err);
-                    }
-                }
-            } else {
-                // Fallback: copy URL to clipboard
-                navigator.clipboard.writeText(photo.url)
-                    .then(() => alert('Photo URL copied to clipboard!'))
-                    .catch(err => console.error('Error copying to clipboard:', err));
-            }
-        }
-    }));
-});

staticfiles/parks/css/search.css

@@ -0,0 +1,134 @@
+/* Loading states */
+.htmx-request .htmx-indicator {
+    opacity: 1;
+}
+.htmx-request.htmx-indicator {
+    opacity: 1;
+}
+.htmx-indicator {
+    opacity: 0;
+    transition: opacity 200ms ease-in-out;
+}
+
+/* Results container transitions */
+#park-results {
+    transition: opacity 200ms ease-in-out;
+}
+.htmx-request #park-results {
+    opacity: 0.7;
+}
+.htmx-settling #park-results {
+    opacity: 1;
+}
+
+/* Grid/List transitions */
+.park-card {
+    transition: all 200ms cubic-bezier(0.4, 0, 0.2, 1);
+    position: relative;
+    background-color: white;
+    border-radius: 0.5rem;
+    border: 1px solid #e5e7eb;
+}
+
+/* Grid view styles */
+.park-card[data-view-mode="grid"] {
+    display: flex;
+    flex-direction: column;
+}
+.park-card[data-view-mode="grid"]:hover {
+    transform: translateY(-2px);
+    box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+}
+
+/* List view styles */
+.park-card[data-view-mode="list"] {
+    display: flex;
+    gap: 1rem;
+    padding: 1rem;
+}
+.park-card[data-view-mode="list"]:hover {
+    background-color: #f9fafb;
+}
+
+/* Image containers */
+.park-card .image-container {
+    position: relative;
+    overflow: hidden;
+}
+.park-card[data-view-mode="grid"] .image-container {
+    aspect-ratio: 16 / 9;
+    width: 100%;
+}
+.park-card[data-view-mode="list"] .image-container {
+    width: 6rem;
+    height: 6rem;
+    flex-shrink: 0;
+}
+
+/* Content */
+.park-card .content {
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    min-width: 0; /* Enables text truncation in flex child */
+}
+
+/* Status badges */
+.park-card .status-badge {
+    transition: all 150ms ease-in-out;
+}
+.park-card:hover .status-badge {
+    transform: scale(1.05);
+}
+
+/* Images */
+.park-card img {
+    transition: transform 200ms ease-in-out;
+    object-fit: cover;
+    width: 100%;
+    height: 100%;
+}
+.park-card:hover img {
+    transform: scale(1.05);
+}
+
+/* Placeholders for missing images */
+.park-card .placeholder {
+    background: linear-gradient(110deg, #ececec 8%, #f5f5f5 18%, #ececec 33%);
+    background-size: 200% 100%;
+    animation: shimmer 1.5s linear infinite;
+}
+
+@keyframes shimmer {
+    to {
+        background-position: 200% center;
+    }
+}
+
+/* Dark mode */
+@media (prefers-color-scheme: dark) {
+    .park-card {
+        background-color: #1f2937;
+        border-color: #374151;
+    }
+    
+    .park-card[data-view-mode="list"]:hover {
+        background-color: #374151;
+    }
+    
+    .park-card .text-gray-900 {
+        color: #f3f4f6;
+    }
+    
+    .park-card .text-gray-500 {
+        color: #9ca3af;
+    }
+    
+    .park-card .placeholder {
+        background: linear-gradient(110deg, #2d3748 8%, #374151 18%, #2d3748 33%);
+    }
+    
+    .park-card[data-view-mode="list"]:hover {
+        background-color: #374151;
+    }
+}

staticfiles/parks/js/search.js

@@ -0,0 +1,69 @@
+// Handle view mode persistence across HTMX requests
+document.addEventListener('htmx:configRequest', function(evt) {
+    // Preserve view mode
+    const parkResults = document.getElementById('park-results');
+    if (parkResults) {
+        const viewMode = parkResults.getAttribute('data-view-mode');
+        if (viewMode) {
+            evt.detail.parameters['view_mode'] = viewMode;
+        }
+    }
+
+    // Preserve search terms
+    const searchInput = document.getElementById('search');
+    if (searchInput && searchInput.value) {
+        evt.detail.parameters['search'] = searchInput.value;
+    }
+});
+
+// Handle loading states
+document.addEventListener('htmx:beforeRequest', function(evt) {
+    const target = evt.detail.target;
+    if (target) {
+        target.classList.add('htmx-requesting');
+    }
+});
+
+document.addEventListener('htmx:afterRequest', function(evt) {
+    const target = evt.detail.target;
+    if (target) {
+        target.classList.remove('htmx-requesting');
+    }
+});
+
+// Handle history navigation
+document.addEventListener('htmx:historyRestore', function(evt) {
+    const parkResults = document.getElementById('park-results');
+    if (parkResults && evt.detail.path) {
+        const url = new URL(evt.detail.path, window.location.origin);
+        const viewMode = url.searchParams.get('view_mode');
+        if (viewMode) {
+            parkResults.setAttribute('data-view-mode', viewMode);
+        }
+    }
+});
+
+// Initialize lazy loading for images
+function initializeLazyLoading(container) {
+    if (!('IntersectionObserver' in window)) return;
+
+    const imageObserver = new IntersectionObserver((entries) => {
+        entries.forEach(entry => {
+            if (entry.isIntersecting) {
+                const img = entry.target;
+                img.src = img.dataset.src;
+                img.removeAttribute('data-src');
+                imageObserver.unobserve(img);
+            }
+        });
+    });
+
+    container.querySelectorAll('img[data-src]').forEach(img => {
+        imageObserver.observe(img);
+    });
+}
+
+// Initialize lazy loading after HTMX content swaps
+document.addEventListener('htmx:afterSwap', function(evt) {
+    initializeLazyLoading(evt.detail.target);
+});

templates/base/base.html

@@ -31,7 +31,7 @@
     <script src="https://unpkg.com/htmx.org@1.9.6"></script>
 
     <!-- Alpine.js -->
-    <script defer src="{% static 'js/alpine.min.js' %}"></script>
+    <script defer src="https://unpkg.com/alpinejs@3.x.x/dist/cdn.min.js"></script>
 
     <!-- Location Autocomplete -->
     <script src="{% static 'js/location-autocomplete.js' %}"></script>

templates/parks/partials/location_widget.html

@@ -223,7 +223,13 @@ document.addEventListener('DOMContentLoaded', function() {
                              data-result-index="${index}">
                             <div class="font-medium text-gray-900 dark:text-white">${result.display_name || result.name || ''}</div>
                             <div class="text-sm text-gray-500 dark:text-gray-400">
-                                ${(result.address && result.address.city) ? result.address.city + ', ' : ''}${(result.address && result.address.country) || ''}
+                                ${[
+                                    result.street,
+                                    result.city || (result.address && (result.address.city || result.address.town || result.address.village)),
+                                    result.state || (result.address && (result.address.state || result.address.region)),
+                                    result.country || (result.address && result.address.country),
+                                    result.postal_code || (result.address && result.address.postcode)
+                                ].filter(Boolean).join(', ')}
                             </div>
                         </div>
                     `).join('');
@@ -313,12 +319,12 @@ document.addEventListener('DOMContentLoaded', function() {
             const address = {
                 name: result.display_name || result.name || '',
                 address: {
-                    house_number: result.address ? result.address.house_number : '',
-                    road: result.address ? (result.address.road || result.address.street) : '',
-                    city: result.address ? (result.address.city || result.address.town || result.address.village) : '',
-                    state: result.address ? (result.address.state || result.address.region) : '',
-                    country: result.address ? result.address.country : '',
-                    postcode: result.address ? result.address.postcode : ''
+                    house_number: result.house_number || (result.address && result.address.house_number) || '',
+                    road: result.street || (result.address && (result.address.road || result.address.street)) || '',
+                    city: result.city || (result.address && (result.address.city || result.address.town || result.address.village)) || '',
+                    state: result.state || (result.address && (result.address.state || result.address.region)) || '',
+                    country: result.country || (result.address && result.address.country) || '',
+                    postcode: result.postal_code || (result.address && result.address.postcode) || ''
                 }
             };
             

thrillwiki/settings.py

@@ -42,6 +42,7 @@ INSTALLED_APPS = [
     "django_htmx",
     "whitenoise",
     "django_tailwind_cli",
+    "autocomplete",  # Django HTMX Autocomplete
     "core",
     "accounts",
     "companies",
@@ -208,10 +209,14 @@ SOCIALACCOUNT_STORE_TOKENS = True
 EMAIL_BACKEND = "email_service.backends.ForwardEmailBackend"
 FORWARD_EMAIL_BASE_URL = "https://api.forwardemail.net"
 SERVER_EMAIL = "django_webmaster@thrillwiki.com"
-
 # Custom User Model
 AUTH_USER_MODEL = "accounts.User"
 
+# Autocomplete configuration
+# Enable project-wide authentication requirement for autocomplete
+AUTOCOMPLETE_BLOCK_UNAUTHENTICATED = False
+
+# Tailwind configuration
 # Tailwind configuration
 TAILWIND_CLI_CONFIG_FILE = os.path.join(BASE_DIR, "tailwind.config.js")
 TAILWIND_CLI_SRC_CSS = os.path.join(BASE_DIR, "static/css/src/input.css")

thrillwiki/urls.py

@@ -7,6 +7,7 @@ from accounts import views as accounts_views
 from django.views.generic import TemplateView
 from .views import HomeView, SearchView
 from . import views
+from autocomplete.urls import urlpatterns as autocomplete_patterns
 import os
 
 urlpatterns = [
@@ -58,6 +59,8 @@ urlpatterns = [
         views***REMOVED***ironment_and_settings_view,
         name="environment_and_settings",
     ),
+    # Autocomplete URLs
+    path("ac/", include((autocomplete_patterns, "autocomplete"), namespace="autocomplete")),
 ]
 
 # Serve static files in development

uv.lock

@@ -1,4 +1,5 @@
 version = 1
+revision = 1
 requires-python = ">=3.13"
 
 [[package]]
@@ -313,6 +314,18 @@ wheels = [
     { url = "https://files.pythonhosted.[AWS-SECRET-REMOVED][AWS-SECRET-REMOVED]django_htmx-1.21.0-py3-none-any.whl", hash = "sha256:[AWS-SECRET-REMOVED]e7ccd2963495e69afbdb6abe", size = 6901 },
 ]
 
+[[package]]
+name = "django-htmx-autocomplete"
+version = "1.0.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "django" },
+]
+sdist = { url = "https://files.pythonhosted.[AWS-SECRET-REMOVED][AWS-SECRET-REMOVED]django_htmx_autocomplete-1.0.5.tar.gz", hash = "sha256:[AWS-SECRET-REMOVED]17bcac3ff0b70766e354ad80", size = 41127 }
+wheels = [
+    { url = "https://files.pythonhosted.[AWS-SECRET-REMOVED][AWS-SECRET-REMOVED]django_htmx_autocomplete-1.0.5-py3-none-any.whl", hash = "sha256:[AWS-SECRET-REMOVED]3572e8742fe5dfa848298735", size = 52127 },
+]
+
 [[package]]
 name = "django-oauth-toolkit"
 version = "3.0.1"
@@ -912,6 +925,7 @@ dependencies = [
     { name = "django-cors-headers" },
     { name = "django-filter" },
     { name = "django-htmx" },
+    { name = "django-htmx-autocomplete" },
     { name = "django-oauth-toolkit" },
     { name = "django-pghistory" },
     { name = "django-simple-history" },
@@ -946,6 +960,7 @@ requires-dist = [
     { name = "django-cors-headers", specifier = ">=4.3.1" },
     { name = "django-filter", specifier = ">=23.5" },
     { name = "django-htmx", specifier = ">=1.17.2" },
+    { name = "django-htmx-autocomplete", specifier = ">=1.0.5" },
     { name = "django-oauth-toolkit", specifier = ">=3.0.1" },
     { name = "django-pghistory", specifier = ">=3.5.2" },
     { name = "django-simple-history", specifier = ">=3.5.0" },