Cockpit Panel User Guide (Super Admin)

Table of Contents

1. Getting Started
2. Dashboard Overview
3. Managing Employers
4. System-Wide Employee Management
5. Global Leave Types
6. Leave Request Oversight
7. Balance Adjustments
8. User Management
9. Roles and Permissions
10. Organizational Units
11. System Configuration
12. Monitoring and Auditing
13. Best Practices

Getting Started

Accessing the Cockpit Panel

1. Navigate to https://your-domain.com/cockpit
2. Enter your Super Admin Email and Password
3. Click Sign In

What is the Cockpit Panel?

The Cockpit Panel is the super admin control center for the entire leave management system. It provides:

• Multi-tenant oversight: Manage multiple employers/organizations
• System-wide configuration: Global settings and policies
• Cross-organization reporting: Aggregate analytics
• User and permission management: Control access across all tenants
• System monitoring: Health checks and audit logs

Key Differences from Employer Panel

| Feature | Cockpit Panel | Employer Panel | |---------|---------------|----------------| | Scope | All employers | Single employer | | Access | Super admins | Employer users | | Permissions | System-wide | Tenant-specific | | Data View | Cross-tenant | Isolated tenant | | Configuration | Global settings | Employer settings |

Dashboard Overview

Dashboard Widgets

System Statistics

• Total Employers: Number of organizations in the system
• Total Employees: Across all employers
• Active Users: Currently active system users
• Pending Requests: System-wide pending leave requests

Recent Activity

• New employer registrations
• System-wide leave request trends
• User activity logs
• System alerts and warnings

Quick Actions

• Add new employer
• Create system user
• View system logs
• Generate global reports

Managing Employers

Viewing Employers

Navigate to Employers from the sidebar to see all organizations in the system.

Employer List Features

• Search: Find employers by name, code, or contact
• Filter: By status, registration date, or size
• Sort: By any column
• Export: Export employer data

Adding a New Employer

1. Click New Employer button
2. Fill in employer information:

Basic Information

• Name (required): Organization name
• Email (required): Primary contact email
• Phone: Contact number
• Address: Full address of the organization

3. Click Create

Note: The Employer model has a simple structure with only essential fields. Additional configuration and settings are managed through related records (users, leave types, employees, etc.).

Employer Details View

Click on an employer to view:

Overview Tab

• Name, email, phone, and address
• Employee count
• Active users
• Creation date

Employees Tab

• All employees under this employer
• Quick access to employee records
• Bulk operations

Users Tab

• Employer panel users
• Access levels and roles
• Last login information

Leave Types Tab

• Leave types configured by this employer
• Accrual settings
• Usage statistics

Statistics Tab

• Leave request metrics
• Balance utilization
• Approval rates
• Trends and patterns

Editing Employer Information

1. Click on employer name
2. Click Edit button
3. Modify necessary fields
4. Click Save

Deactivating an Employer

To remove an employer from the system:

1. Navigate to the employer record
2. Click Delete button
3. Confirm deletion

Important Notes:

• Consider the impact on related data (employees, leave requests, etc.)
• Ensure proper data backup before deletion
• Deletion may be restricted if there are active employees or pending requests
• Alternatively, you can keep the record and simply remove all active users to prevent access

Employer Statistics

View detailed statistics for each employer:

• Total employees
• Active leave requests
• Leave utilization rates
• System usage metrics

System-Wide Employee Management

Viewing All Employees

Navigate to Employees to see employees across all employers.

Cross-Employer Employee View

The employee list shows:

• Employee name and ID
• Employer: Which organization they belong to
• Department and designation
• Status
• Join date
• Current leave balances

Filtering by Employer

Use the employer filter to:

• View employees of a specific employer
• Compare employee data across employers
• Generate cross-employer reports

Employee Details

Click on an employee to view:

• Personal and employment information
• Employer affiliation
• Leave balances and history
• Leave requests
• Balance adjustments
• System access logs

Bulk Operations

Perform actions on multiple employees:

• Export employee data
• Generate reports
• Update statuses
• Send notifications

Employee Search

Advanced search capabilities:

• Search across all employers
• Filter by multiple criteria
• Save search filters
• Export search results

Global Leave Types

System-Wide Leave Type Management

Navigate to Leave Types to manage leave types across all employers.

Viewing Leave Types

See all leave types configured by all employers:

• Leave type name and code
• Employer who created it
• Configuration details
• Usage statistics

Leave Type Templates

Create template leave types that employers can use:

1. Click New Leave Type
2. Mark as Template
3. Configure standard settings
4. Make available to all employers

Benefits:

• Consistency across employers
• Faster employer onboarding
• Standardized leave policies
• Easier system management

Leave Type Analytics

View system-wide analytics:

• Most common leave types
• Average accrual rates
• Utilization patterns
• Carry forward trends

Leave Request Oversight

System-Wide Leave Requests

Navigate to Leave Requests to see all requests across employers.

Leave Request Dashboard

View and filter requests:

• By Employer: See requests for specific organizations
• By Status: Pending, Approved, Rejected, Cancelled
• By Date Range: Specific time periods
• By Leave Type: Filter by leave category

Monitoring Leave Patterns

Identify trends and patterns:

• Peak leave periods
• Approval/rejection rates by employer
• Average processing time
• Common rejection reasons

Intervention Capabilities

As super admin, you can:

• View any leave request
• Monitor approval workflows
• Identify bottlenecks
• Generate compliance reports

Note: Direct approval/rejection is typically handled by employer panel users. Super admins monitor and intervene only when necessary.

Leave Request Reports

Generate comprehensive reports:

• System-wide leave statistics
• Employer comparison reports
• Trend analysis
• Compliance reports

Balance Adjustments

Managing Balance Adjustments

Navigate to Balance Adjustments to oversee all manual balance changes.

Viewing Adjustments

See all balance adjustments across the system:

• Employee name and employer
• Leave type adjusted
• Adjustment type (Credit/Debit)
• Days adjusted
• Reason
• Adjusted by whom
• Date of adjustment

Creating System-Level Adjustments

When necessary, create adjustments:

1. Click New Balance Adjustment
2. Select Employer first
3. Select Employee
4. Choose Leave Type
5. Select Adjustment Type:
   • Credit: Add days
   • Debit: Subtract days
6. Enter Days to adjust
7. Provide detailed Reason
8. Set Effective Date
9. Click Create

Adjustment Types

System Correction

• Fixing calculation errors
• Correcting data migration issues
• Resolving system bugs

Policy Change

• Implementing new leave policies
• Adjusting for policy updates
• Retroactive policy applications

Special Circumstances

• Compassionate leave grants
• Emergency situations
• Executive decisions

Audit Trail

All adjustments are logged:

• Who made the adjustment
• When it was made
• Original and new values
• Reason provided
• Approval chain (if applicable)

Adjustment Reports

Generate reports on:

• Total adjustments by employer
• Most common adjustment reasons
• Adjustment trends over time
• Audit compliance

User Management

System Users

Navigate to Users to manage all system users.

User Types

Super Admins (Cockpit Users)

• Full system access
• Manage all employers
• System configuration
• Global reporting

Employer Users

• Access to employer panel
• Tenant-specific permissions
• Managed by employer or super admin

Employees

• Access to employee portal
• Self-service leave management
• Limited to their own data

Adding System Users

1. Click New User
2. Fill in user details:
   • Name
   • Email (unique across system)
   • Password
   • User Type: Super Admin or Employer User
   • Employer: If employer user
   • Role: Assign appropriate role
3. Click Create

User Permissions

Control what users can access:

• Resource-level permissions
• Page access
• Feature availability
• Data visibility

User Activity Monitoring

Track user activity:

• Login history
• Actions performed
• Data accessed
• Changes made

Bulk User Operations

• Create multiple users
• Update user roles
• Deactivate users
• Export user lists

Roles and Permissions

System-Wide Role Management

Navigate to Roles to manage roles across the system.

Role Types

System Roles

• Super Admin
• System Manager
• System Viewer
• Support Staff

Employer Roles

• Employer Admin
• HR Manager
• Department Manager
• Viewer

Creating Custom Roles

1. Click New Role
2. Enter Role Name
3. Select Role Type: System or Employer
4. Configure permissions:

Resource Permissions

For each resource:

• View: See records
• View Any: See all records
• Create: Add new records
• Update: Edit records
• Delete: Remove records
• Restore: Restore deleted records
• Force Delete: Permanently delete

Special Permissions

• Access Cockpit Panel: Super admin access
• Manage Employers: Create/edit employers
• System Configuration: Change system settings
• View All Data: Cross-tenant data access

4. Click Create

Permission Inheritance

Roles can inherit from parent roles:

• Base permissions from parent
• Additional permissions added
• Restrictions applied

Role Assignment

Assign roles to users:

1. Edit user record
2. Select role from dropdown
3. Save changes

Permission Auditing

Track permission changes:

• Who changed permissions
• What was changed
• When it was changed
• Reason for change

Organizational Units

System-Wide Org Unit Management

Navigate to Org Units to manage organizational structures.

Viewing Org Units

See organizational units across all employers:

• Unit name and code
• Employer affiliation
• Parent unit
• Employee count
• Manager

Org Unit Hierarchy

View hierarchical structures:

• Tree view of all employers
• Drill down into specific employers
• Compare structures across employers

Creating Org Units

1. Click New Org Unit
2. Select Employer
3. Fill in details:
   • Name
   • Code
   • Parent Unit (if sub-unit)
   • Manager
   • Description
4. Click Create

Org Unit Analytics

Analyze organizational structures:

• Average depth of hierarchies
• Employee distribution
• Manager-to-employee ratios
• Span of control metrics

System Configuration

Global Settings

Configure system-wide settings:

General Settings

• System name and branding
• Default timezone
• Date and time formats
• Language settings

Email Configuration

• SMTP settings
• Email templates
• Notification preferences
• Email queue settings

Security Settings

• Password policies
• Session timeout
• Two-factor authentication
• IP restrictions

Leave Calculation Settings

• Default accrual methods
• Rounding rules
• Weekend handling
• Holiday calendar

Notification Settings

• Email notifications
• In-app notifications
• SMS notifications (if enabled)
• Notification frequency

Feature Flags

Enable/disable features system-wide:

• New feature rollouts
• Beta features
• Experimental functionality
• Feature access by plan

Integration Settings

Configure third-party integrations:

• HR systems
• Payroll systems
• Calendar integrations
• SSO providers

Backup and Maintenance

Schedule system maintenance:

• Automatic backups
• Database optimization
• Log rotation
• Cache clearing

Monitoring and Auditing

System Health Monitoring

Monitor system performance:

Performance Metrics

• Response times
• Database query performance
• Server resource usage
• API call rates

Error Tracking

• Application errors
• Failed jobs
• Email delivery failures
• Integration errors

Usage Statistics

• Active users
• Peak usage times
• Feature usage
• Storage consumption

Audit Logs

Comprehensive audit trail:

User Actions

• Login/logout events
• Data modifications
• Permission changes
• Configuration updates

System Events

• Scheduled job executions
• Automated processes
• System errors
• Security events

Viewing Audit Logs

1. Navigate to Audit Logs
2. Filter by:
   • User
   • Action type
   • Date range
   • Employer
   • Resource
3. Export logs for compliance

Compliance Reporting

Generate compliance reports:

• Data access logs
• Permission changes
• Security incidents
• Policy violations

Alerts and Notifications

Set up system alerts:

• Performance degradation
• Error thresholds
• Security events
• Unusual activity patterns

Best Practices

System Administration

Regular Maintenance

✅ Daily Tasks:

• Monitor system health
• Review error logs
• Check backup status
• Respond to support tickets

✅ Weekly Tasks:

• Review user activity
• Analyze performance metrics
• Update documentation
• Plan system updates

✅ Monthly Tasks:

• Generate compliance reports
• Review security logs
• Audit user permissions
• Optimize database
• Review employer statistics

✅ Quarterly Tasks:

• System security audit
• Performance review
• Feature usage analysis
• Capacity planning
• Disaster recovery testing

Security Best Practices

1. Access Control

   • Principle of least privilege
   • Regular permission audits
   • Strong password policies
   • Multi-factor authentication

2. Data Protection

   • Regular backups
   • Encrypted data storage
   • Secure data transmission
   • Data retention policies

3. Monitoring

   • Real-time alerts
   • Log analysis
   • Anomaly detection
   • Incident response plan

Performance Optimization

1. Database

   • Regular optimization
   • Index management
   • Query optimization
   • Archive old data

2. Caching

   • Implement caching strategies
   • Cache invalidation
   • CDN usage
   • Static asset optimization

3. Scaling

   • Monitor resource usage
   • Plan for growth
   • Load balancing
   • Horizontal scaling

Employer Management

Onboarding New Employers

1. Pre-Onboarding

   • Gather requirements
   • Plan configuration
   • Prepare documentation
   • Set expectations

2. Setup

   • Create employer account
   • Configure leave types
   • Set up organizational structure
   • Create initial users

3. Data Migration

   • Import employee data
   • Import historical leave data
   • Verify data accuracy
   • Test calculations

4. Training

   • Admin training
   • User training
   • Documentation handover
   • Support setup

5. Go-Live

   • Final verification
   • Cutover plan
   • Monitor closely
   • Provide support

Ongoing Support

• Regular check-ins
• Performance reviews
• Feature updates
• Policy consultations
• Technical support

Data Management

Data Quality

• Regular data audits
• Validation rules
• Duplicate detection
• Data cleansing

Data Retention

• Define retention policies
• Archive old data
• Comply with regulations
• Secure deletion

Data Privacy

• GDPR compliance
• Data access controls
• Privacy policies
• User consent management

Troubleshooting

Common System Issues

Issue: System Performance Degradation

Symptoms:

• Slow page loads
• Timeout errors
• High server load

Solutions:

1. Check server resources
2. Review database performance
3. Clear cache
4. Optimize slow queries
5. Scale resources if needed

Issue: Email Delivery Failures

Symptoms:

• Notifications not received
• Email queue building up
• SMTP errors

Solutions:

1. Verify SMTP settings
2. Check email queue
3. Review email logs
4. Test email configuration
5. Check spam filters

Issue: Data Inconsistencies

Symptoms:

• Incorrect leave balances
• Missing records
• Duplicate entries

Solutions:

1. Run data integrity checks
2. Review audit logs
3. Identify root cause
4. Make corrections
5. Implement preventive measures

Issue: User Access Problems

Symptoms:

• Cannot log in
• Permission errors
• Missing features

Solutions:

1. Verify user status
2. Check role permissions
3. Review tenant assignment
4. Clear user cache
5. Reset password if needed

Emergency Procedures

System Outage

1. Assess the situation
2. Notify stakeholders
3. Implement recovery plan
4. Restore from backup if needed
5. Post-mortem analysis

Data Breach

1. Contain the breach
2. Assess impact
3. Notify affected parties
4. Implement fixes
5. Review security measures

Critical Bug

1. Identify and isolate
2. Assess severity
3. Implement hotfix
4. Test thoroughly
5. Deploy and monitor

Advanced Features

API Management

If API access is enabled:

API Keys

• Generate API keys
• Set rate limits
• Monitor API usage
• Revoke access

Webhooks

• Configure webhooks
• Event subscriptions
• Payload formats
• Retry policies

Custom Integrations

Set up integrations with:

• HRIS systems
• Payroll software
• Calendar applications
• Communication tools

Automation

Configure automated processes:

• Scheduled reports
• Automatic notifications
• Data synchronization
• Cleanup tasks

Multi-Language Support

If enabled:

• Add new languages
• Manage translations
• Set default language
• User language preferences

Reporting and Analytics

System-Wide Reports

Generate comprehensive reports:

Employer Reports

• Employer comparison
• Growth metrics
• Feature adoption
• Support tickets

Employee Reports

• Total employees by employer
• Employee distribution
• Turnover rates
• Demographics

Leave Reports

• System-wide leave statistics
• Leave type usage
• Approval rates
• Trend analysis

Financial Reports

• Subscription revenue
• Usage-based billing
• Cost per employer
• ROI analysis

Custom Reports

Create custom reports:

1. Navigate to Reports
2. Click Create Custom Report
3. Select data sources
4. Choose metrics
5. Configure filters
6. Set visualization
7. Save and schedule

Data Export

Export data in various formats:

• Excel (XLSX)
• CSV
• PDF
• JSON
• XML

Frequently Asked Questions

Q: How do I add a new employer to the system?

A: Navigate to Employers > New Employer, fill in the required information, and click Create. Then set up their leave types, organizational structure, and initial users.

Q: Can I access data from all employers?

A: Yes, as a super admin, you have cross-tenant access. However, use this responsibly and only when necessary for system administration or support.

Q: How do I handle an employer who wants to leave the system?

A: Deactivate their account, export their data for handover, and follow your data retention policy. Ensure all contractual obligations are met.

Q: What should I do if I notice suspicious activity?

A: Immediately review audit logs, check for unauthorized access, secure the affected accounts, and follow your security incident response plan.

Q: How often should I backup the system?

A: Daily automated backups are recommended, with weekly full backups. Test restore procedures regularly.

Q: Can I customize the system for specific employers?

A: Yes, through feature flags, custom configurations, and tenant-specific settings. However, maintain consistency where possible.

Q: How do I troubleshoot balance calculation issues?

A: Review the employee's balance history, check leave type configuration, verify accrual settings, and examine any manual adjustments. Use the audit logs to trace all changes.

Q: What's the best way to handle system updates?

A: Schedule during low-usage periods, notify all users in advance, backup the system, test in staging first, and have a rollback plan ready.

Quick Reference

Daily Checklist

• [ ] Check system health dashboard
• [ ] Review error logs
• [ ] Monitor active users
• [ ] Check backup status
• [ ] Respond to urgent tickets

Weekly Checklist

• [ ] Review user activity
• [ ] Analyze performance metrics
• [ ] Check security logs
• [ ] Update documentation
• [ ] Plan upcoming changes

Monthly Checklist

• [ ] Generate compliance reports
• [ ] Review all employer accounts
• [ ] Audit user permissions
• [ ] Optimize database
• [ ] Review system capacity

Quarterly Checklist

• [ ] Security audit
• [ ] Performance review
• [ ] Feature usage analysis
• [ ] Disaster recovery test
• [ ] Strategic planning

Emergency Contacts

System Issues

• Technical Lead: [Contact Info]
• Database Admin: [Contact Info]
• Security Team: [Contact Info]

Business Issues

• Product Manager: [Contact Info]
• Customer Success: [Contact Info]
• Legal/Compliance: [Contact Info]

Additional Resources

Documentation

• System Architecture Guide
• API Documentation
• Security Best Practices
• Disaster Recovery Plan

Training Materials

• Admin Training Videos
• Configuration Guides
• Troubleshooting Guides
• Best Practices Library

Support

• Support Portal
• Knowledge Base
• Community Forum
• Ticket System

Last Updated: December 2024 Version: 1.0.0 For Super Administrators Only - Confidential