Admin Dashboard

Admin Dashboard Overview

The Admin Dashboard is the control center for shop owners and super administrators. This powerful interface provides comprehensive oversight of all shops, companies, and system-wide operations within Budgeting Pro. As a super admin, you have access to high-level analytics, system management tools, and the ability to manage multiple shop installations.

Who Uses the Admin Dashboard

  • Shop Owners: Shopify store owners who installed Budgeting Pro
  • Super Administrators: System-level administrators with full access
  • Platform Managers: Those responsible for overseeing multiple shop installations

Key Administrative Capabilities

  • Multi-shop Management: Oversee multiple Shopify shop installations
  • System-wide Analytics: View aggregated data across all shops
  • Brand Customization: Upload and manage shop logos and branding
  • User Oversight: Monitor user activity across all companies
  • System Health: Monitor application performance and usage

Admin Widgets

The Admin Dashboard features specialized widgets designed for high-level oversight and management:

Shop Overview Widget

  • Purpose: Provides a comprehensive view of shop-level statistics
  • Data Displayed:
    • Total active shops using Budgeting Pro
    • Overall system health metrics
    • Platform usage statistics
    • Revenue and subscription information
  • Use Cases:
    • Monitor platform adoption
    • Identify usage trends
    • Track system performance
  • Updates: Real-time data refresh for current statistics

Draft Orders Per Month Chart Widget

  • Purpose: System-wide analysis of order activity across all shops
  • Data Displayed:
    • Aggregated monthly order volumes
    • Cross-shop comparative analysis
    • Seasonal trend identification
    • Platform growth metrics
  • Features:
    • Interactive charts with drill-down capabilities
    • Historical data analysis
    • Trend forecasting
    • Export functionality for reporting
  • Benefits:
    • Understand platform usage patterns
    • Identify busy periods for resource planning
    • Monitor overall system growth
    • Support business development decisions

Administrative Features

Logo Upload and Branding Management

The Admin Dashboard includes a dedicated Logo Upload page with the following capabilities:

Brand Customization

  • Upload custom logos for individual shops
  • Support for multiple image formats (PNG, JPG, SVG)
  • Automatic image optimization and resizing
  • Preview functionality before applying changes
  • Rollback to default branding if needed

Logo Management Features

  • File Validation: Ensures uploaded files meet size and format requirements
  • Storage Management: Efficient file storage with automatic cleanup
  • Path Management: Secure file path handling and access control
  • Fallback System: Automatic fallback to default logo if custom logo fails

Multi-Shop Administration

Shop Monitoring

  • View all connected Shopify shops
  • Monitor shop status and health
  • Track subscription and billing status
  • Manage shop-specific settings

Resource Management

  • Allocate system resources across shops
  • Monitor usage patterns and limits
  • Implement usage policies and restrictions
  • Scale resources based on demand

Shop Management

Individual Shop Oversight

Shop Configuration

  • Access shop-specific settings and configurations
  • Manage shop-level permissions and access controls
  • Configure shop branding and customization
  • Monitor shop performance metrics

Company Management within Shops

  • View all companies within each shop
  • Monitor company activity and usage
  • Manage company-specific settings
  • Support company onboarding and setup

User Administration

System-wide User Management

  • Oversee all user accounts across shops and companies
  • Monitor user types (Admin vs Company users)
  • Handle user authentication and access control
  • Manage user impersonation for support purposes

User Type Management

  • Admin Users: Super administrators and shop owners with system access
  • Company Users: Business users who manage orders and budgets within companies
  • User type validation and access control enforcement
  • Cross-panel access management and restrictions

Advanced User Features

  • User Impersonation: Super admins can impersonate company users for support
  • Role-based Access Control: Manage user roles (CompanyAdmin, BudgetAdmin, Orderer, etc.)
  • Multi-company Access: Users can be assigned to multiple companies
  • Location-based Permissions: Granular access control per location within companies

Data Management

System-wide Reporting

  • Generate comprehensive reports across all shops
  • Export data for analysis and business intelligence
  • Monitor key performance indicators
  • Track platform growth and adoption metrics

Data Integrity

  • Ensure data consistency across shops
  • Monitor synchronization with Shopify stores
  • Manage data backups and recovery
  • Maintain audit trails for compliance

System Administration

Security and Access Control

Authentication Management

  • Oversee system-wide authentication policies
  • Manage admin access levels and permissions
  • Monitor security events and login activities
  • Implement security best practices

System Security

  • Monitor for security threats and vulnerabilities
  • Manage API access and rate limiting
  • Implement and monitor security policies
  • Coordinate security updates and patches

Performance Monitoring

System Health

  • Monitor application performance metrics
  • Track system resource usage
  • Identify and resolve performance bottlenecks
  • Plan for capacity and scaling needs

Integration Management

  • Monitor Shopify API integration health
  • Manage third-party service connections
  • Handle integration errors and failures
  • Coordinate system updates and maintenance

Support and Maintenance

User Support

  • Access support tools and user assistance features
  • Monitor support ticket trends and resolution
  • Coordinate with technical support teams
  • Manage escalated issues and problems

System Maintenance

  • Schedule and coordinate system updates
  • Manage database maintenance and optimization
  • Coordinate backup and disaster recovery procedures
  • Plan and execute system improvements

Admin Dashboard Navigation

Header Elements

  • Admin Branding: Displays the current shop's logo or default branding
  • Navigation Menu: Access to all administrative functions
  • System Status: Quick view of overall system health
  • Admin Profile: Account settings and administrative preferences

Main Navigation Areas

Dashboard Home

  • Overview widgets and system summary
  • Quick access to common administrative tasks
  • System alerts and notifications
  • Recent activity summary

Shop Management

  • Individual shop administration
  • Cross-shop analytics and reporting
  • Resource allocation and management
  • Shop onboarding and setup

System Tools

  • Logo upload and branding management
  • System configuration and settings
  • Performance monitoring and analytics
  • Security and access management

Mobile and Responsive Design

The Admin Dashboard is fully responsive and accessible on various devices:

  • Desktop Optimization: Full feature access with comprehensive layouts
  • Tablet Support: Touch-friendly interface with optimized navigation
  • Mobile Access: Essential administrative functions on mobile devices
  • Cross-browser Compatibility: Works across all major web browsers

Best Practices for Admin Dashboard Use

Daily Administrative Tasks

  1. Monitor System Health: Check widgets for system status and alerts
  2. Review Shop Activity: Monitor individual shop performance and issues
  3. Check Security Events: Review authentication logs and security alerts
  4. Address Support Issues: Respond to escalated support requests

Regular Maintenance

  • Performance Monitoring: Weekly review of system performance metrics
  • Data Backup Verification: Ensure backup systems are functioning properly
  • Security Updates: Apply security patches and updates as needed
  • Capacity Planning: Monitor usage trends and plan for growth

Strategic Management

  • Platform Analytics: Monthly analysis of platform growth and adoption
  • Resource Optimization: Quarterly review of resource allocation and usage
  • Feature Planning: Regular assessment of feature requests and improvements
  • Business Development: Use analytics to support business growth initiatives

Super Admin User Management

User Types and Access Control

The admin dashboard manages two distinct user types with different access levels and capabilities:

Admin Users (UserType::Admin)

  • Shop owners and super administrators
  • Full access to Admin Panel (/admin)
  • Cannot access Company Panel (/app)
  • System-wide oversight and management capabilities
  • User impersonation rights for support purposes

Company Users (UserType::Company)

  • Business users within companies
  • Full access to Company Panel (/app) with tenant context
  • Cannot access Admin Panel (/admin)
  • Restricted to their assigned companies and locations
  • Subject to role-based permissions within companies

User Role Management

Company users operate with specific roles that determine their capabilities:

Role Hierarchy

  • CompanyAdmin: Full company management rights, can manage all users and settings
  • BudgetAdmin: Budget management and oversight capabilities
  • OrdererAdmin: Advanced order management and approval rights
  • Orderer: Standard order creation and management
  • Requester: Basic order requesting capabilities

User Impersonation System

Super admins have powerful impersonation capabilities for user support:

How Impersonation Works

  1. Navigate to Companies → Select Company → Users tab
  2. Click the impersonation action on any company user
  3. Automatically redirected to Company Panel (/app) as that user
  4. Full access to user's interface and permissions
  5. "Back to Admin" option to return to admin panel

Impersonation Benefits

  • User Support: Experience exactly what users see
  • Issue Diagnosis: Replicate and resolve user problems
  • Training: Demonstrate features from user perspective
  • Quality Assurance: Test user workflows and permissions

Multi-Company User Management

Users can be assigned to multiple companies with different roles:

Company Assignments

  • Users can belong to multiple companies simultaneously
  • Different role assignments per company (e.g., Admin in one, Orderer in another)
  • Tenant switching allows users to work across companies
  • Permissions enforced per company context

Location-based Permissions Within each company, users can be assigned to specific locations:

  • Location Access: Users see only assigned locations
  • Shopify Integration: Location assignments sync with Shopify B2B roles
  • Role Assignments: Each location can have different role assignments
  • Permission Inheritance: Location permissions inherit from company role

User Lifecycle Management

User Creation Process

  1. Admin Creation: Super admins create admin users directly in admin panel
  2. Company Invitation: Company admins invite users through company panel
  3. Automatic Assignment: Users automatically assigned appropriate type and access
  4. Email Verification: All users must verify email addresses

User Status Management

  • Active Users: Full system access according to permissions
  • Inactive Users: Suspended access while retaining data
  • Soft Deletion: Users can be soft deleted with data retention
  • Reactivation: Inactive users can be reactivated by admins

Security and Access Control

Authentication Enforcement

  • Panel Access Control: Strict enforcement of panel access by user type
  • Tenant Validation: Company users validated against tenant assignments
  • Role Verification: Continuous role and permission validation
  • Session Management: Secure session handling across panels

Permission Validation

  • Resource Access: Users can only access permitted resources
  • Action Authorization: All user actions subject to policy validation
  • Data Isolation: Users see only data they're authorized to access
  • Audit Trails: Complete logging of user actions and access

Monitoring and Analytics

User Activity Tracking

  • Login Monitoring: Track user login patterns and frequencies
  • Action Logging: Log all significant user actions and changes
  • Permission Changes: Track role and permission modifications
  • Cross-Company Activity: Monitor users working across multiple companies

User Management Reports

  • User Distribution: Users per company and location
  • Role Analysis: Role distribution and usage patterns
  • Access Patterns: User engagement and system usage
  • Security Events: Authentication failures and suspicious activity

The Admin Dashboard provides the tools and insights needed to effectively manage and grow the Budgeting Pro platform while ensuring optimal performance and user satisfaction across all connected shops.