# Park Search Implementation

## Architecture

The park search functionality uses a combination of:
- BaseAutocomplete for search suggestions
- django-htmx for async updates
- Django filters for advanced filtering

### Components

1. **Forms**
   - `ParkAutocomplete`: Handles search suggestions
   - `ParkSearchForm`: Integrates autocomplete with search form

2. **Views**
   - `ParkSearchView`: Class-based view handling search and filters
   - `suggest_parks`: Legacy endpoint maintained for backward compatibility

3. **Templates**
   - Simplified search UI using autocomplete widget
   - Integrated loading indicators
   - Filter form for additional search criteria

## Implementation Details

### Search Form
```python
class ParkSearchForm(forms.Form):
    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...'
            }
        )
    )
```

### Autocomplete
```python
class ParkAutocomplete(BaseAutocomplete):
    model = Park
    search_attrs = ['name']
    
    def get_search_results(self, search):
        return (get_base_park_queryset()
                .filter(name__icontains=search)
                .select_related('owner')
                .order_by('name'))
```

### View Integration
```python
class ParkSearchView(TemplateView):
    template_name = "parks/park_list.html"
    
    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        context['search_form'] = ParkSearchForm(self.request.GET)
        # ... filter handling ...
        return context
```

## Features

1. **Security**
   - Tiered access control:
     * Public basic search
     * Authenticated users get autocomplete
     * Protected endpoints via settings
   - CSRF protection
   - Input validation

2. **Real-time Search**
   - Debounced input handling
   - Instant results display
   - Loading indicators

3. **Accessibility**
   - ARIA labels and roles
   - Keyboard navigation support
   - Screen reader compatibility

4. **Integration**
   - Works with existing filter system
   - Maintains view mode selection
   - Preserves URL state

## Performance Considerations

- Prefetch related owner data
- Uses base queryset optimizations
- Debounced search requests
- Proper index usage on name field

## Future Improvements

- Consider adding full-text search
- Implement result caching
- Add geographic search capabilities
- Enhance filter integration