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/models/application_record.rb

@@ -1,3 +1,6 @@
+# Base class for all ActiveRecord models in the application
+# Provides common functionality and configuration for all models
 class ApplicationRecord < ActiveRecord::Base
+  # Mark this as the primary abstract class to establish inheritance hierarchy
   primary_abstract_class
 end