feat: Add blog, media, and support apps, implement ride credits and image API, and remove toplist feature.

BACKEND_STRUCTURE.md

@@ -4,45 +4,92 @@
 
 ### 1. `apps.core`
 - **Responsibility**: Base classes, shared utilities, history tracking.
-- **Existing**: `SluggedModel`, `TrackedModel`, `pghistory`.
+- **Existing**: `SluggedModel`, `TrackedModel`.
+- **Versioning Strategy (Section 15)**:
+  - All core entities (`Park`, `Ride`, `Company`) must utilize `django-pghistory` or `apps.core` tracking to support:
+    - **Edit History**: Chronological list of changes with `reason`, `user`, and `diff`.
+    - **Timeline**: Major events (renames, relocations).
+    - **Rollback**: Ability to restore previous versions via the Moderation Queue.
 
 ### 2. `apps.accounts`
-- **Responsibility**: User authentication and profiles.
-- **Existing**: `User`, `UserProfile`, `UserDeletionRequest`, `UserNotification`.
-- **Missing**: `RideCredit` (although `UserProfile` has aggregate stats, individual credits are needed).
+- **Responsibility**: User authentication, profiles, and settings.
+- **Existing**: `User`, `UserProfile` (bio, location, home park).
+- **Required Additions (Section 9)**:
+  - **UserDeletionRequest**: Support 7-day grace period for account deletion.
+  - **Privacy Settings**: Fields for `is_profile_public`, `show_location`, `show_email` on `UserProfile`.
+  - **Data Export**: Serializers/Utilities to dump all user data (Reviews, Credits, Lists) to JSON.
 
 ### 3. `apps.parks`
 - **Responsibility**: Park management.
-- **Existing**: `Park`, `ParkArea`.
+- **Models**: `Park`, `ParkArea`.
+- **Relationships**:
+  - `operator`: FK to `apps.companies.Company` (Type: Operator).
+  - `property_owner`: FK to `apps.companies.Company` (Type: Owner).
 
 ### 4. `apps.rides`
-- **Responsibility**: Ride data (rides, coasters, credits), Companies.
-- **Existing**: `RideModel`, `RideModelVariant`, `RideModelPhoto`, `Ride` (with FSM `status`).
-- **Proposed Additions**:
-    - `RideCredit` (M2M: User <-> Ride). **Attributes**: `count`, `first_ridden_at`, `notes`, `rating`. **Constraint**: Unique(user, ride).
+- **Responsibility**: Ride data, Coasters, and Credits.
+- **Models**:
+  - `Ride`: Core entity (Status FSM: Operating, SBNO, Closed, etc.).
+  - `RideModel`: Defines the "Type" of ride (e.g., B&M Hyper V2).
+  - `Manufacturer`: FK to `apps.companies.Company`.
+  - `Designer`: FK to `apps.companies.Company`.
+- **Ride Credits (Section 10)**:
+  - **Model**: `RideCredit` (Through-Model: `User` <-> `Ride`).
+  - **Fields**:
+    - `count` (Integer): Total times ridden.
+    - `rating` (Float): Personal rating (distinct from public Review).
+    - `first_ridden_at` (Date): First time experiencing the ride.
+    - `notes` (Text): Private personal notes.
+  - **Constraints**: `Unique(user, ride)` - A user has one credit entry per ride.
 
-### 5. `apps.moderation`
-- **Responsibility**: Content pipeline.
-- **Existing**: Check `apps/moderation` (likely `Submission`).
-- **Constraint**: Status State Machine (Pending -> Claimed -> Approved).
+### 5. `apps.companies`
+- **Responsibility**: Management of Industry Entities (Section 4).
+- **Models**:
+  - `Company`: Single model with `type` choices or Polymorphic.
+  - **Types**: `Manufacturer`, `Designer`, `Operator`, `PropertyOwner`.
+  - **Features**: Detailed pages, hover cards, listing by type.
 
-### 6. `apps.media`
-- **Responsibility**: Photos and Videos.
-- **Existing**: `Photo` (GenericFK).
+### 6. `apps.moderation` (The Sacred Submission Pipeline)
+- **Responsibility**: Centralized Content Submission System (Section 14, 16).
+- **Concept**: **Live Data** (Approve) vs **Submission Data** (Pending).
+- **Models**:
+  - `Submission`:
+    - `submitter`: FK to User.
+    - `content_type`: Target Model (Park, Ride, etc.).
+    - `object_id`: Target ID (Null for Creation).
+    - `data`: **JSONField** storing the proposed state.
+    - `status`: State Machine (`Pending` -> `Claimed` -> `Approved` | `Rejected` | `ChangesRequested`).
+    - `moderator`: FK to User (Claimaint).
+    - `moderator_note`: Reason for rejection/feedback.
+  - `Report`: User flags on content.
+- **Workflow**:
+  1. User submits form -> `Submission` created (Status: Pending).
+  2. Moderator Claims -> Status: Claimed.
+  3. Approves -> Applies `data` to `Live Model` -> Saves Version -> Status: Approved.
 
-### 7. `apps.reviews`
-- **Responsibility**: User reviews.
-- **Proposed**: `Review` model (User, Entity GenericFK, rating 1-5, text, helpful votes).
+### 7. `apps.media`
+- **Responsibility**: Media Management (Section 13).
+- **Models**:
+  - `Photo`: GenericFK. Fields: `image`, `caption`, `user`, `status` (Moderation).
+  - **Banner/Card**: Entities should link to a "Primary Photo" or store a cached image field.
 
-### 8. `apps.lists`
-- **Responsibility**: User Rankings/Lists.
-- **Existing**: `TopList`, `TopListItem` (in `apps.accounts` currently? Or should move to `apps.lists`?). `accounts/models.py` has `TopList`.
-- **Proposal**: Move `TopList` to `apps.lists` for better separation if it grows, or keep in `accounts` if tightly coupled. Spec suggests "11. USER LISTS" is a major feature.
+### 8. `apps.reviews`
+- **Responsibility**: Public Reviews & Ratings (Section 12).
+- **Models**:
+  - `Review`: GenericFK (Park, Ride).
+  - **Fields**: `rating` (1-5, 0.5 steps), `title`, `body`, `helpful_votes`.
+  - **Logic**: Aggregates (Avg Rating, Count) calculation for Entity caches.
 
-### 9. `apps.blog`
-- **Responsibility**: Blog posts.
-- **Proposed**: `Post`, `Tag`.
+### 9. `apps.lists`
+- **Responsibility**: User Lists & Rankings (Section 11).
+- **Models**:
+  - `UserList`: Title, Description, Type (Park/Ride/Coaster/Mixed), Privacy (Public/Private).
+  - `UserListItem`: FK to List, GenericFK to Item, Order, Notes.
 
-### 10. `apps.support`
-- **Responsibility**: Contact form.
-- **Proposed**: `Ticket`.
+### 10. `apps.blog`
+- **Responsibility**: News & Updates.
+- **Models**: `Post`, `Tag`.
+
+### 11. `apps.support`
+- **Responsibility**: Human interaction.
+- **Models**: `Ticket` (Contact Form).