BarangaySystem/ai-docs/files/UserModifyAdminPageController.md

UserModifyAdminPageController.php

Purpose

Provides admin-level user modification and management capabilities including enabling/disabling users, password resets, role changes, and session management.

Key Components

• UserModifyAdminPageController class
• PageResponses_UserModify trait

Exported Interfaces

• Response_UserDetails() - Get user details by hash key
• Response_DisableUser() / EnableUser() - Toggle user active status
• Response_DeleteUser() - Delete user record
• Response_ResetUserPassword() - Reset user password
• Response_LogoutUser() - Force logout user session

Inputs

• $hashkey - User hash key identifier
• $details - Array of user details to update
• $newPassword - New password string
• $active - Boolean for active status
• $request - Hypervel HTTP request object

Outputs

• JSON responses with success/error data
• User detail arrays or error messages

Side Effects

• Updates user records in database
• Invalidates Redis sessions on force logout
• Modifies user password hashes

Dependencies

• App\Enums\UserActions
• App\Http\Controllers\Helpers\Permissions\UserPermissions
• App\Models\User
• Hypervel\Support\Facades\Auth, Hash, Redis, Cache

Notes

• Uses trait pattern for response handlers
• Permission checks via UserPermissions::isActionPermitted()
• Supports hierarchical user relationships (parent/children)