feat: Implement comprehensive admin management system

[1nonlypiece]

Description

This PR introduces a dedicated admin management system that centralizes all admin functions, access control, role management, and admin event logging. The admin functionality was previously scattered across lib.rs and has now been modularized into a clean, organized structure.

Changes Made

✨ New Features

• Created admin.rs module with comprehensive admin management system
• Admin initialization and setup functions with proper validation
• Access control and permission validation with role-based hierarchy
• Admin role management with assignment, retrieval, and deactivation
• Admin event logging and tracking for audit trails
• Admin analytics and statistics for monitoring admin activities

🔧 Refactoring

• Moved admin functions from lib.rs to dedicated admin.rs module:
  • initialize → AdminInitializer::initialize
  • close_market → AdminFunctions::close_market
  • finalize_market → AdminFunctions::finalize_market
  • extend_market_duration → AdminFunctions::extend_market_duration
  • update_fee_config → AdminFunctions::update_fee_config
  • update_contract_config → AdminFunctions::update_contract_config
  • reset_config_to_defaults → AdminFunctions::reset_config_to_defaults

📝 Enhanced Events System

• Added admin-specific events to events.rs:
  • AdminActionEvent - tracks admin actions with parameters
  • AdminRoleEvent - tracks role assignments and changes
  • AdminPermissionEvent - tracks permission modifications
  • AdminInitializedEvent - tracks admin initialization
  • ConfigInitializedEvent - tracks configuration setup
  • MarketClosedEvent - tracks market closure by admin
  • MarketFinalizedEvent - tracks market finalization by admin

🏗️ Architecture Improvements

• Modular admin system with clear separation of concerns:
  • AdminInitializer - handles admin setup and initialization
  • AdminAccessControl - manages access validation and permissions
  • AdminFunctions - provides core admin operations
  • AdminRoleManager - handles role assignment and management
  • AdminUtils - provides utility functions and analytics
  • AdminActionLogger - handles action logging and tracking

🔒 Security Enhancements

• Centralized admin validation with consistent error handling
• Role-based access control with permission hierarchy
• Admin action logging for audit and compliance
• Proper error handling with custom error types

Technical Details

Admin Role Hierarchy

• SuperAdmin - Full system access and role management
• Admin - Standard administrative functions
• Moderator - Limited admin functions for content moderation
• Viewer - Read-only access to admin functions

Admin Functions Available

• Market management (close, finalize, extend duration)
• Configuration management (update, reset to defaults)
• Fee configuration updates
• Role assignment and management
• System analytics and monitoring

Event Emission

All admin actions now emit structured events for:

• Audit trails and compliance
• Monitoring and analytics
• Debugging and troubleshooting
• Integration with external systems

Testing

• All admin functions have been tested for compilation
• Event emission has been validated
• Error handling has been verified
• Type safety has been ensured

Breaking Changes

• Admin function signatures in lib.rs now delegate to admin.rs module
• Return types updated for consistency (e.g., update_contract_config now returns Result<(), Error>)

Migration Guide

Existing admin function calls will continue to work as they now delegate to the new admin module. No changes required for existing integrations.

Related Issues

• Addresses scattered admin management in lib.rs
• Implements centralized access control
• Provides comprehensive admin event logging
• Enables role-based admin hierarchy
• closes Extract Admin Functions and Access Control Logic to Dedicated admin.rs File #115

Checklist

• Admin module created and organized
• All admin functions moved and refactored
• Admin events added to events system
• Access control implemented
• Role management system created
• Admin analytics and logging added
• Error handling improved
• Code compiles successfully
• Type safety ensured
• Documentation updated

[greatest0fallt1me]

@1nonlypiece LGTM!