feat: Complete Woles Framework v1.0 with enterprise-grade UI

- Add comprehensive error handling system with custom error pages - Implement professional enterprise-style design with Tailwind CSS - Create modular HMVC architecture with clean separation of concerns - Add security features: CSRF protection, XSS filtering, Argon2ID hashing - Include CLI tools for development workflow - Add error reporting dashboard with system monitoring - Implement responsive design with consistent slate color scheme - Replace all emoji icons with professional SVG icons - Add comprehensive test suite with PHPUnit - Include database migrations and seeders - Add proper exception handling with fallback pages - Implement template engine with custom syntax support - Add helper functions and facades for clean code - Include proper logging and debugging capabilities
2025-10-11 07:08:23 +07:00
commit 0b42271bfe
90 changed files with 8315 additions and 0 deletions
--- a/app/Core/helpers.php
+++ b/app/Core/helpers.php
@@ -0,0 +1,200 @@
+<?php
+
+/**
+ * NovaCore Framework Core Helper Functions
+ * Additional utility functions
+ */
+
+if (!function_exists('storage_path')) {
+    /**
+     * Get storage path
+     */
+    function storage_path(string $path = ''): string
+    {
+        $storagePath = __DIR__ . '/../../storage';
+        return $path ? $storagePath . '/' . ltrim($path, '/') : $storagePath;
+    }
+}
+
+if (!function_exists('database_path')) {
+    /**
+     * Get database path
+     */
+    function database_path(string $path = ''): string
+    {
+        $dbPath = __DIR__ . '/../../database';
+        return $path ? $dbPath . '/' . ltrim($path, '/') : $dbPath;
+    }
+}
+
+if (!function_exists('base_path')) {
+    /**
+     * Get base path
+     */
+    function base_path(string $path = ''): string
+    {
+        $basePath = __DIR__ . '/../..';
+        return $path ? $basePath . '/' . ltrim($path, '/') : $basePath;
+    }
+}
+
+if (!function_exists('app_path')) {
+    /**
+     * Get app path
+     */
+    function app_path(string $path = ''): string
+    {
+        $appPath = __DIR__ . '/..';
+        return $path ? $appPath . '/' . ltrim($path, '/') : $appPath;
+    }
+}
+
+if (!function_exists('public_path')) {
+    /**
+     * Get public path
+     */
+    function public_path(string $path = ''): string
+    {
+        $publicPath = __DIR__ . '/../../public';
+        return $path ? $publicPath . '/' . ltrim($path, '/') : $publicPath;
+    }
+}
+
+if (!function_exists('config_path')) {
+    /**
+     * Get config path
+     */
+    function config_path(string $path = ''): string
+    {
+        $configPath = __DIR__ . '/../Config';
+        return $path ? $configPath . '/' . ltrim($path, '/') : $configPath;
+    }
+}
+
+if (!function_exists('is_production')) {
+    /**
+     * Check if running in production
+     */
+    function is_production(): bool
+    {
+        return env('APP_ENV', 'production') === 'production';
+    }
+}
+
+if (!function_exists('is_development')) {
+    /**
+     * Check if running in development
+     */
+    function is_development(): bool
+    {
+        return env('APP_ENV', 'production') === 'development';
+    }
+}
+
+if (!function_exists('is_testing')) {
+    /**
+     * Check if running in testing
+     */
+    function is_testing(): bool
+    {
+        return env('APP_ENV', 'production') === 'testing';
+    }
+}
+
+if (!function_exists('abort')) {
+    /**
+     * Abort with error code
+     */
+    function abort(int $code, string $message = ''): void
+    {
+        http_response_code($code);
+
+        if ($message) {
+            echo "<h1>{$code} - Error</h1>";
+            echo "<p>{$message}</p>";
+        } else {
+            switch ($code) {
+                case 404:
+                    echo "<h1>404 - Not Found</h1>";
+                    echo "<p>The requested page could not be found.</p>";
+                    break;
+                case 500:
+                    echo "<h1>500 - Internal Server Error</h1>";
+                    echo "<p>Something went wrong on our end.</p>";
+                    break;
+                default:
+                    echo "<h1>{$code} - Error</h1>";
+                    break;
+            }
+        }
+
+        exit;
+    }
+}
+
+if (!function_exists('logger')) {
+    /**
+     * Log message
+     */
+    function logger(string $message, string $level = 'info'): void
+    {
+        $logFile = storage_path('logs/error.log');
+        $timestamp = date('Y-m-d H:i:s');
+        $logMessage = "[{$timestamp}] [{$level}] {$message}" . PHP_EOL;
+
+        file_put_contents($logFile, $logMessage, FILE_APPEND | LOCK_EX);
+    }
+}
+
+if (!function_exists('cache')) {
+    /**
+     * Simple cache helper
+     */
+    function cache(string $key, $value = null, int $ttl = 3600)
+    {
+        $cacheFile = storage_path("cache/{$key}.cache");
+
+        if ($value === null) {
+            // Get from cache
+            if (file_exists($cacheFile) && (time() - filemtime($cacheFile)) < $ttl) {
+                return unserialize(file_get_contents($cacheFile));
+            }
+            return null;
+        } else {
+            // Set cache
+            $cacheDir = dirname($cacheFile);
+            if (!is_dir($cacheDir)) {
+                mkdir($cacheDir, 0755, true);
+            }
+            file_put_contents($cacheFile, serialize($value));
+            return $value;
+        }
+    }
+}
+
+if (!function_exists('cache_forget')) {
+    /**
+     * Remove from cache
+     */
+    function cache_forget(string $key): bool
+    {
+        $cacheFile = storage_path("cache/{$key}.cache");
+        return file_exists($cacheFile) ? unlink($cacheFile) : false;
+    }
+}
+
+if (!function_exists('cache_flush')) {
+    /**
+     * Clear all cache
+     */
+    function cache_flush(): void
+    {
+        $cacheDir = storage_path('cache');
+        if (is_dir($cacheDir)) {
+            $files = glob($cacheDir . '/*.cache');
+            foreach ($files as $file) {
+                unlink($file);
+            }
+        }
+    }
+}