feat: Add continent and park type fields to Park and ParkLocation models; update API filters and documentation

This commit is contained in:
pacnpal
2025-08-30 22:02:30 -04:00
parent 9bed782784
commit 49f874f7b4
7 changed files with 218 additions and 43 deletions

View File

@@ -212,13 +212,15 @@ The moderation system provides comprehensive content moderation, user management
### Parks Listing
- **GET** `/api/v1/parks/`
- **Query Parameters** (22 filtering parameters supported by Django backend):
- **Query Parameters** (24 filtering parameters fully supported by Django backend):
- `page` (int): Page number for pagination
- `page_size` (int): Number of results per page
- `search` (string): Search in park names and descriptions
- `continent` (string): Filter by continent
- `country` (string): Filter by country
- `state` (string): Filter by state/province
- `city` (string): Filter by city
- `park_type` (string): Filter by park type (THEME_PARK, AMUSEMENT_PARK, WATER_PARK, etc.)
- `status` (string): Filter by operational status
- `operator_id` (int): Filter by operator company ID
- `operator_slug` (string): Filter by operator company slug
@@ -236,12 +238,6 @@ The moderation system provides comprehensive content moderation, user management
- `max_roller_coaster_count` (int): Maximum roller coaster count
- `ordering` (string): Order by fields (name, opening_date, ride_count, average_rating, coaster_count, etc.)
**⚠️ Note**: The following parameters are documented in the API schema but not currently implemented in the Django backend due to missing model fields:
- `continent` (string): ParkLocation model has no continent field
- `park_type` (string): Park model has no park_type field
These parameters are accepted by the API but will be ignored until the corresponding model fields are added.
### Filter Options
- **GET** `/api/v1/parks/filter-options/`
- **Returns**: Comprehensive filter options including continents, countries, states, park types, and ordering options