feat: add Party management API with RESTful endpoints and comprehensive documentation

- Introduce Party model with lifecycle states (draft, published, canceled, sold_out)
- Add RESTful API endpoints under /api/v1/parties for CRUD operations
- Create ApiController base with API key authentication
- Implement comprehensive code comments across models and controllers
- Add database migration for parties table with proper indexes
- Configure API routes with namespaced versioning

app/controllers/pages_controller.rb

@@ -1,9 +1,12 @@
+# Controller for static pages and user dashboard
+# Handles basic page rendering and user-specific content
 class PagesController < ApplicationController
-  # Display homepage
-  def home
-  end
+  # Require user authentication for dashboard access
+  # Redirects to login page if user is not signed in
+  before_action :authenticate_user!, only: [:dashboard]
 
-  # Display legal page
-  def legals
+  # User dashboard showing personalized content
+  # Accessible only to authenticated users
+  def dashboard
   end
 end