Add autocomplete functionality for parks: implement BaseAutocomplete class and integrate with forms

memory-bank/features/parks/search.md

@@ -0,0 +1,105 @@
+# 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