initial: bootstrap from BukidBountyApp base

ai-docs/modules/auth.md

@@ -0,0 +1,24 @@
+# Auth Module
+
+## Purpose
+Handles user authentication, login, session management, and logout functionality. This module provides the foundation for all authenticated routes in the application.
+
+## Key Files
+- `resources/js/Pages/Auth/Login.vue` - Vue login component
+- `app/Http/Controllers/LoginController.php` - Authentication controller
+- `app/Models/User.php` - User model with authentication
+
+## Public APIs
+- `authenticate()` - Authenticate user via JWT
+- `extendcurrentSession()` - Extend current session lifetime
+- `setSessiontoKeepAlive()` - Keep session alive
+
+## Dependencies
+- `Hypervel\Support\Facades\Auth`
+- `App\Http\Controllers\Pages\Core\ApplicationController`
+
+## Important Behavior
+- Uses JWT-based authentication
+- Validates user credentials against database
+- Creates session upon successful login
+- Redirects to home page or returns JSON response based on request type