perf: roles permissions cache

[mubbi]

Introduces comprehensive caching for user roles and permissions to optimize authorization performance and reduce database queries.

Changes

Commit: 4d75d97 - perf: roles permissions cache

Files Modified

🆕 New Files

• app/Traits/HasCachedRolesAndPermissions.php - Core caching trait with role/permission methods
• app/Constants/CacheKeys.php - Centralized cache key management
• app/Console/Commands/ClearRolePermissionCache.php - Cache management console command

🔧 Modified Files

• app/Models/User.php - Added caching trait integration
• app/Models/Role.php - Enhanced with caching support
• app/Services/UserService.php - Updated to use cached methods
• app/Http/Resources/V1/Auth/UserResource.php - Optimized data retrieval
• database/migrations/2025_07_04_205615_create_role_user_table.php
• database/migrations/2025_07_04_205616_create_permission_role_table.php

🧪 Test Files Added

• tests/Feature/Console/ClearRolePermissionCacheTest.php - Console command tests
• tests/Feature/Models/UserCachingTest.php - User caching functionality tests
• tests/Feature/Services/UserServiceTest.php - Service layer integration tests

Key Features

• Cached Role/Permission Checks: hasCachedPermission(), hasCachedRole(), etc.
• Bulk Permission Checks: hasAnyCachedPermission(), hasAllCachedPermissions()
• Cache Management: Console command with --user-id and --all options
• Version-based Invalidation: Efficient bulk cache clearing
• 1-hour TTL: Configurable cache duration

Stats

• +1,162 lines added
• 12 files changed
• 632+ lines of comprehensive tests
• Zero breaking changes

Usage

# Clear all user caches
php artisan cache:clear-roles-permissions --all

Clear specific user cache

php artisan cache:clear-roles-permissions --user-id=1

Testing

php artisan test tests/Feature/Models/UserCachingTest.php
php artisan test tests/Feature/Console/ClearRolePermissionCacheTest.php
php artisan test tests/Feature/Services/UserServiceTest.php