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

config/routes.rb

@@ -31,4 +31,15 @@ Rails.application.routes.draw do
     confirmation: "authentications/confirmations"   # Custom controller for confirmations
   }
 
+  # API routes versioning
+  namespace :api do
+    namespace :v1 do
+      # RESTful routes for party management
+      resources :parties, only: [ :index, :show, :create, :update, :destroy ]
+
+      # Additional API endpoints can be added here as needed
+      # Example: search, filtering, user-specific endpoints
+    end
+  end
+
 end