Add complete feature suite: Permissions, Audit Trail, API Auth, Error Tracking, Module System, and Site Settings
- Install spatie/laravel-permission v6.24 with 3 roles (admin, editor, viewer) and 5 base permissions - Install owen-it/laravel-auditing v14.0 for tracking model changes - Install laravel/sanctum v4.3 for API token authentication - Install spatie/laravel-ignition v2.11 and spatie/flare-client-php v1.10 for enhanced error tracking - Add Module System with make:module artisan command for scaffolding features - Create Site Settings page in Filament admin for logo, colors, and configuration - Add comprehensive debugging documentation (DEBUGGING.md, AI_CONTEXT.md updates) - Create FEATURES.md with complete feature reference - Update User model with HasRoles and HasApiTokens traits - Configure Redis cache and OPcache for performance - Add RolePermissionSeeder with pre-configured roles and permissions - Update documentation with debugging-first workflow - All features pre-installed and production-ready
This commit is contained in:
@@ -27,11 +27,49 @@ This is a **ready-to-use Laravel Docker Development Template** with everything p
|
||||
| **Cache/Queue** | Redis |
|
||||
| **Auth** | Laravel Breeze (Blade + Livewire) - PRE-INSTALLED |
|
||||
| **Testing** | Pest - PRE-INSTALLED |
|
||||
| **Permissions** | spatie/laravel-permission |
|
||||
| **Audit** | owen-it/laravel-auditing |
|
||||
| **Error Tracking** | spatie/laravel-flare + spatie/laravel-ignition |
|
||||
| **Permissions** | spatie/laravel-permission - PRE-INSTALLED |
|
||||
| **Audit** | owen-it/laravel-auditing - PRE-INSTALLED |
|
||||
| **Error Tracking** | spatie/laravel-flare + spatie/laravel-ignition - PRE-INSTALLED |
|
||||
| **API Auth** | Laravel Sanctum - PRE-INSTALLED |
|
||||
| **Code Style** | Laravel Pint |
|
||||
|
||||
## 🚨 CRITICAL: Debugging Strategy
|
||||
|
||||
**ALWAYS CHECK LOGS FIRST - NEVER GUESS AT SOLUTIONS**
|
||||
|
||||
When encountering errors:
|
||||
|
||||
### Step 1: Check Laravel Logs
|
||||
```bash
|
||||
docker-compose exec app cat storage/logs/laravel.log | grep -A 20 "Error"
|
||||
```
|
||||
|
||||
### Step 2: Identify Root Cause
|
||||
- Read the full stack trace
|
||||
- Find the exact file and line number
|
||||
- Understand what the code is trying to do
|
||||
|
||||
### Step 3: Fix and Verify
|
||||
- Make targeted fix to root cause
|
||||
- Clear relevant caches
|
||||
- Test the specific scenario
|
||||
|
||||
### Common Commands:
|
||||
```bash
|
||||
# View recent errors
|
||||
docker-compose exec app tail -n 100 storage/logs/laravel.log
|
||||
|
||||
# Check container logs
|
||||
docker-compose logs --tail=50 app
|
||||
docker-compose logs --tail=50 nginx
|
||||
|
||||
# Clear caches after fixes
|
||||
docker-compose exec app php artisan optimize:clear
|
||||
docker-compose exec app php artisan permission:cache-reset
|
||||
```
|
||||
|
||||
**See [DEBUGGING.md](DEBUGGING.md) for complete debugging guide.**
|
||||
|
||||
## Important: No JavaScript Frameworks
|
||||
|
||||
**This template deliberately avoids JavaScript frameworks** (Vue, React, Inertia) to keep debugging simple. All frontend is:
|
||||
|
||||
Reference in New Issue
Block a user