Skip to content

SuperAdmin Portal

The SuperAdmin Portal is the central nervous system of Black Shark. It is designed for system administrators who need global oversight and control over the entire ERP ecosystem.

Core Administrator Responsibilities

Global Configuration

Foundational data that powers the entire system is managed here. Changing these values has immediate effects across all panels. - Banks & Branches: Used in HR for guard payroll setup. - Ranks & Grades: Defines the hierarchy and salary bands for the workforce. - Client Categories: Used in CRM for segmenting the sales pipeline.

User & Access Control

Black Shark uses a multi-layered security model: 1. Panels: Access to specific modules (e.g., can this user even see the "Operations" URL?). 2. Roles: Pre-defined sets of permissions (e.g., HR Manager, Ops Supervisor). 3. Granular Permissions: Specific abilities (e.g., can approve requisitions).

Security Best Practice

Always use the Principle of Least Privilege. Only grant users access to the specific panels and permissions required for their daily work.

Audit & Compliance

System-Wide Activity Logs

Every creation, update, and deletion of a record is tracked. - Who: The user who performed the action. - When: Precise timestamp. - What: The exact fields that were changed, including old and new values. - Where: The IP address and browser of the user.

Troubleshooting with Logs

If a user reports an issue with a specific guard or job card: 1. Go to SuperAdmin > Activity Logs. 2. Filter by the Subject Type (e.g., App\Models\Guard). 3. Search for the specific ID. 4. Review the timeline of changes to identify when the data might have been corrupted or misconfigured.

System Health Tools

  • Queue Monitoring: View the status of background jobs (like sending SMS notifications or generating bulk rosters).
  • Cache Management: Tools to clear system caches if UI changes aren't reflecting for users.
  • Backups: Status of automated daily database and file storage backups.

Database Operations

Direct database edits or bulk deletions in the SuperAdmin panel are permanent. Always verify filters before applying bulk actions.