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/user.rb

@@ -1,6 +1,21 @@
+# User model for authentication and user management
+# Handles user accounts, authentication, and authorization using Devise
 class User < ApplicationRecord
   # Include default devise modules. Others available are:
   # :confirmable, :lockable, :timeoutable, :trackable and :omniauthable
+  #
+  # Include default devise modules for authentication
+  # :database_authenticatable - encrypts and stores password in database
+  # :registerable - allows users to sign up and edit their accounts
+  # :recoverable - handles password reset functionality
+  # :rememberable - manages token-based user remembering
+  # :validatable - provides email and password validation
+  # Other available modules are:
+  # :confirmable - requires email confirmation
+  # :lockable - locks account after failed login attempts
+  # :timeoutable - expires sessions after inactivity
+  # :trackable - tracks sign-in count, timestamps, and IP
+  # :omniauthable - allows authentication via OAuth providers
   devise :database_authenticatable, :registerable,
          :recoverable, :rememberable, :validatable
 end