README

Utility helpers package for Laravel applications.

A comprehensive collection of utility helpers and tools for Laravel applications, providing essential functionality for development and deployment.

🎯 Key Features

✅ Seamless Integration: Easy to integrate with existing Laravel projects
✅ System Validation: Built-in system validation and configuration checks
✅ Domain Whitelisting: Supports domain whitelisting with wildcard patterns (e.g., *.example.com)
✅ Deployment Tools: Helpful utilities for deployment and environment management
✅ Cache Management: Efficient cache handling and optimization
✅ System Monitoring: Built-in status checking and diagnostics
✅ Configuration Management: Centralized configuration management

🚀 Quick Installation

# Install package
composer require insurance-core/helpers

# Publish configuration
php artisan vendor:publish --provider="InsuranceCore\Utils\UtilsServiceProvider" --tag=config

# Check system status  
php artisan utils:info

📝 Configuration

Required (for production/staging after grace period)

Add these to your .env file for full validation:

# REQUIRED: Get these from your license server
UTILS_KEY=your_system_key                    # System key from license server
UTILS_PRODUCT_ID=your_product_id            # Product identifier
UTILS_CLIENT_ID=your_client_id              # Client identifier
UTILS_API_TOKEN=your_secure_api_token       # API token for server communication

Optional (has defaults)

# OPTIONAL: Server URL (has default)
UTILS_SERVER=https://your-server.com/api     # Default: https://license.acecoderz.com/

# OPTIONAL: Cryptographic secret (falls back to APP_KEY)
UTILS_SECRET=your_cryptographic_secret_key   # For key generation/validation checksums

Getting Your System Key

1. Run the info command to get your system identifiers:

   php artisan utils:info

   This will show:

   • Hardware fingerprint
   • Installation ID
   • System identifiers

2. Generate system key from your license server using:

   • Hardware fingerprint
   • Domain
   • Product ID
   • Client ID

3. Add to .env file and restart your application

Fresh Installation

• Local/Dev: No configuration needed (always allowed)
• Production/Staging: 7-day grace period (app works without config)
• After grace period: Configuration required for full validation

🔧 Management Commands

System Information

• utils:info - Show system information and hardware fingerprint
• utils:diagnose - Diagnose system configuration issues
• utils:test - Test system functionality

Key Management

• utils:generate-key - Generate a system key for the application

Deployment

• utils:deployment - Help troubleshoot and fix system issues during deployment
  • --check - Check current deployment status
  • --fix - Attempt to fix deployment issues
  • --regenerate - Force regenerate hardware fingerprint
  • --test - Test system after fixes

Utilities

• utils:clear-cache - Clear system cache
• utils:optimize - Optimize system performance
• utils:audit - Comprehensive system assessment

📋 Usage Examples

Check System Status

php artisan utils:info

Diagnose Issues

php artisan utils:diagnose --fix

Generate System Key

# First, get your hardware fingerprint
php artisan utils:info

# Then generate key
php artisan utils:generate-key \
  --product-id=YOUR_PRODUCT_ID \
  --domain=example.com \
  --ip=192.168.1.1 \
  --client-id=YOUR_CLIENT_ID \
  --hardware-fingerprint=YOUR_FINGERPRINT \
  --installation-id=YOUR_INSTALLATION_ID

Deployment Helper

# Check deployment status
php artisan utils:deployment --check

# Fix deployment issues
php artisan utils:deployment --fix

# Regenerate hardware fingerprint
php artisan utils:deployment --regenerate

🔐 Security

This package includes built-in security features:

• Hardware fingerprinting for installation tracking
• Secure key generation and validation
• Configuration encryption support
• System integrity monitoring

📦 Requirements

• PHP 8.1 or higher
• Laravel 9.0 or higher
• Composer

🤝 Support

For support, email support@insurancecore.com or visit https://github.com/Sudhir-Pratap/insurance-core

📄 License

This package is open-sourced software licensed under the MIT license.

🔄 Version History

See CHANGELOG.md for version history and updates.

Note: This package is designed to work seamlessly with your Laravel application. All configuration is optional and the package will work with sensible defaults.