Troubleshooting Guide

Common issues, error codes, and solutions for the admin panel

Common Issues

Problem: Cannot access admin panel, login fails

Solution 1: Clear browser cache and cookies

Solution 2: Verify credentials with IT administrator

Solution 3: Check if account is locked/disabled

Solution 4: Reset password using admin tools

Problem: Admin panel loads slowly or times out

Solution 1: Check network connectivity

Solution 2: Clear application cache (php artisan cache:clear)

Solution 3: Optimize database queries

Solution 4: Restart web server services

Problem: Devices showing as offline or not responding

Solution 1: Check device network connectivity

Solution 2: Restart device and wait 2 minutes

Solution 3: Verify API endpoints are accessible

Solution 4: Check firewall settings

Code	Description	Solution
AUTH_001	Invalid credentials	Check username/password
DB_002	Database connection failed	Contact IT support immediately
DEV_003	Device offline	Check device power & network
PRT_004	Printer not responding	Check printer connection & paper

For critical issues that prevent normal operations:

Emergency Hotline: +244 xxx xxx xxx

Email: emergency@sfbplus.ao

Available: 24/7 for system outages