Update panels, docs, and screenshots

README.md

@@ -175,3 +175,8 @@ php artisan test --compact
 ## License
 
 MIT
+
+## Documentation Notes
+
+- Documentation screenshots are generated for all admin and user pages.
+- cPanel Migration tabs (Domains, Databases, Mailboxes, Forwarders, SSL) only render after a backup is analyzed. Provide a sample cPanel backup to capture those tab screenshots.

VERSION

@@ -1 +1 @@
-VERSION=0.9-rc53
+VERSION=0.9-rc54

app/BackupSchedule.php

@@ -0,0 +1,235 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Carbon\Carbon;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class BackupSchedule extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'user_id',
+        'destination_id',
+        'name',
+        'is_active',
+        'is_server_backup',
+        'frequency',
+        'time',
+        'day_of_week',
+        'day_of_month',
+        'include_files',
+        'include_databases',
+        'include_mailboxes',
+        'include_dns',
+        'domains',
+        'databases',
+        'mailboxes',
+        'users',
+        'retention_count',
+        'last_run_at',
+        'next_run_at',
+        'last_status',
+        'last_error',
+        'metadata',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'is_active' => 'boolean',
+            'is_server_backup' => 'boolean',
+            'include_files' => 'boolean',
+            'include_databases' => 'boolean',
+            'include_mailboxes' => 'boolean',
+            'include_dns' => 'boolean',
+            'domains' => 'array',
+            'databases' => 'array',
+            'mailboxes' => 'array',
+            'users' => 'array',
+            'metadata' => 'array',
+            'retention_count' => 'integer',
+            'day_of_week' => 'integer',
+            'day_of_month' => 'integer',
+            'last_run_at' => 'datetime',
+            'next_run_at' => 'datetime',
+        ];
+    }
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    public function destination(): BelongsTo
+    {
+        return $this->belongsTo(BackupDestination::class, 'destination_id');
+    }
+
+    public function backups(): HasMany
+    {
+        return $this->hasMany(Backup::class, 'schedule_id');
+    }
+
+    /**
+     * Check if the schedule should run now.
+     */
+    public function shouldRun(): bool
+    {
+        if (! $this->is_active) {
+            return false;
+        }
+
+        if (! $this->next_run_at) {
+            return true;
+        }
+
+        return $this->next_run_at->isPast();
+    }
+
+    /**
+     * Calculate and set the next run time.
+     */
+    public function calculateNextRun(): Carbon
+    {
+        $timezone = $this->getSystemTimezone();
+        $now = Carbon::now($timezone);
+        $time = explode(':', $this->time);
+        $hour = (int) ($time[0] ?? 2);
+        $minute = (int) ($time[1] ?? 0);
+
+        $next = $now->copy()->setTime($hour, $minute, 0);
+
+        // If time already passed today, start from tomorrow
+        if ($next->isPast()) {
+            $next->addDay();
+        }
+
+        switch ($this->frequency) {
+            case 'hourly':
+                $next = $now->copy()->addHour()->startOfHour();
+                break;
+
+            case 'daily':
+                // Already set to next occurrence
+                break;
+
+            case 'weekly':
+                $targetDay = $this->day_of_week ?? 0; // Default to Sunday
+                while ($next->dayOfWeek !== $targetDay) {
+                    $next->addDay();
+                }
+                break;
+
+            case 'monthly':
+                $targetDay = $this->day_of_month ?? 1;
+                $next->day = min($targetDay, $next->daysInMonth);
+                if ($next->isPast()) {
+                    $next->addMonth();
+                    $next->day = min($targetDay, $next->daysInMonth);
+                }
+                break;
+        }
+
+        $nextUtc = $next->copy()->setTimezone('UTC');
+        $this->attributes['next_run_at'] = $nextUtc->format($this->getDateFormat());
+
+        return $nextUtc;
+    }
+
+    /**
+     * Get frequency label for UI.
+     */
+    public function getFrequencyLabelAttribute(): string
+    {
+        $base = match ($this->frequency) {
+            'hourly' => 'Every hour',
+            'daily' => 'Daily at '.$this->time,
+            'weekly' => 'Weekly on '.$this->getDayName().' at '.$this->time,
+            'monthly' => 'Monthly on day '.($this->day_of_month ?? 1).' at '.$this->time,
+            default => ucfirst($this->frequency),
+        };
+
+        return $base;
+    }
+
+    /**
+     * Get day name for weekly schedules.
+     */
+    protected function getDayName(): string
+    {
+        $days = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+
+        return $days[$this->day_of_week ?? 0];
+    }
+
+    protected function getSystemTimezone(): string
+    {
+        static $timezone = null;
+        if ($timezone === null) {
+            $timezone = trim((string) @file_get_contents('/etc/timezone'));
+            if ($timezone === '') {
+                $timezone = trim((string) @shell_exec('timedatectl show -p Timezone --value 2>/dev/null'));
+            }
+            if ($timezone === '') {
+                $timezone = 'UTC';
+            }
+        }
+
+        return $timezone;
+    }
+
+    /**
+     * Scope for active schedules.
+     */
+    public function scopeActive($query)
+    {
+        return $query->where('is_active', true);
+    }
+
+    /**
+     * Scope for due schedules.
+     */
+    public function scopeDue($query)
+    {
+        return $query->active()
+            ->where(function ($q) {
+                $q->whereNull('next_run_at')
+                    ->orWhere('next_run_at', '<=', now());
+            });
+    }
+
+    /**
+     * Scope for user schedules.
+     */
+    public function scopeForUser($query, int $userId)
+    {
+        return $query->where('user_id', $userId);
+    }
+
+    /**
+     * Scope for server backup schedules.
+     */
+    public function scopeServerBackups($query)
+    {
+        return $query->where('is_server_backup', true);
+    }
+
+    /**
+     * Get last status color for UI.
+     */
+    public function getLastStatusColorAttribute(): string
+    {
+        return match ($this->last_status) {
+            'success' => 'success',
+            'failed' => 'danger',
+            default => 'gray',
+        };
+    }
+}

app/Models/BackupSchedule.php

@@ -185,51 +185,3 @@ class BackupSchedule extends Model
         return $timezone;
     }
 
-    /**
-     * Scope for active schedules.
-     */
-    public function scopeActive($query)
-    {
-        return $query->where('is_active', true);
-    }
-
-    /**
-     * Scope for due schedules.
-     */
-    public function scopeDue($query)
-    {
-        return $query->active()
-            ->where(function ($q) {
-                $q->whereNull('next_run_at')
-                    ->orWhere('next_run_at', '<=', now());
-            });
-    }
-
-    /**
-     * Scope for user schedules.
-     */
-    public function scopeForUser($query, int $userId)
-    {
-        return $query->where('user_id', $userId);
-    }
-
-    /**
-     * Scope for server backup schedules.
-     */
-    public function scopeServerBackups($query)
-    {
-        return $query->where('is_server_backup', true);
-    }
-
-    /**
-     * Get last status color for UI.
-     */
-    public function getLastStatusColorAttribute(): string
-    {
-        return match ($this->last_status) {
-            'success' => 'success',
-            'failed' => 'danger',
-            default => 'gray',
-        };
-    }
-}

doccs/site/.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+.astro/
+.DS_Store

doccs/site/.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

doccs/site/.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

doccs/site/README.md

@@ -0,0 +1,49 @@
+# Starlight Starter Kit: Basics
+
+[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
+
+```
+npm create astro@latest -- --template starlight
+```
+
+> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+
+## 🚀 Project Structure
+
+Inside of your Astro + Starlight project, you'll see the following folders and files:
+
+```
+.
+├── public/
+├── src/
+│   ├── assets/
+│   ├── content/
+│   │   └── docs/
+│   └── content.config.ts
+├── astro.config.mjs
+├── package.json
+└── tsconfig.json
+```
+
+Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.
+
+Images can be added to `src/assets/` and embedded in Markdown with a relative link.
+
+Static assets, like favicons, can be placed in the `public/` directory.
+
+## 🧞 Commands
+
+All commands are run from the root of the project, from a terminal:
+
+| Command                   | Action                                           |
+| :------------------------ | :----------------------------------------------- |
+| `npm install`             | Installs dependencies                            |
+| `npm run dev`             | Starts local dev server at `localhost:4321`      |
+| `npm run build`           | Build your production site to `./dist/`          |
+| `npm run preview`         | Preview your build locally, before deploying     |
+| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
+| `npm run astro -- --help` | Get help using the Astro CLI                     |
+
+## 👀 Want to learn more?
+
+Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).

doccs/site/astro.config.mjs

@@ -0,0 +1,34 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+// https://astro.build/config
+export default defineConfig({
+	server: {
+		allowedHosts: ['jabali.lan'],
+	},
+	integrations: [
+		starlight({
+			title: 'Jabali Panel Documentation',
+			description: 'Feature documentation and screenshots for the Jabali hosting panel.',
+			sidebar: [
+				{
+					label: 'Getting Started',
+					items: [{ label: 'Overview', slug: 'overview' }],
+				},
+				{
+					label: 'Admin Panel',
+					autogenerate: { directory: 'admin' },
+				},
+				{
+					label: 'User Panel',
+					autogenerate: { directory: 'user' },
+				},
+				{
+					label: 'Platform',
+					autogenerate: { directory: 'platform' },
+				},
+			],
+		}),
+	],
+});

doccs/site/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "doccs-site",
+  "type": "module",
+  "version": "0.0.1",
+  "scripts": {
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/starlight": "^0.37.6",
+    "astro": "^5.6.1",
+    "sharp": "^0.34.2"
+  }
+}

doccs/site/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128"><path fill-rule="evenodd" d="M81 36 64 0 47 36l-1 2-9-10a6 6 0 0 0-9 9l10 10h-2L0 64l36 17h2L28 91a6 6 0 1 0 9 9l9-10 1 2 17 36 17-36v-2l9 10a6 6 0 1 0 9-9l-9-9 2-1 36-17-36-17-2-1 9-9a6 6 0 1 0-9-9l-9 10v-2Zm-17 2-2 5c-4 8-11 15-19 19l-5 2 5 2c8 4 15 11 19 19l2 5 2-5c4-8 11-15 19-19l5-2-5-2c-8-4-15-11-19-19l-2-5Z" clip-rule="evenodd"/><path d="M118 19a6 6 0 0 0-9-9l-3 3a6 6 0 1 0 9 9l3-3Zm-96 4c-2 2-6 2-9 0l-3-3a6 6 0 1 1 9-9l3 3c3 2 3 6 0 9Zm0 82c-2-2-6-2-9 0l-3 3a6 6 0 1 0 9 9l3-3c3-2 3-6 0-9Zm96 4a6 6 0 0 1-9 9l-3-3a6 6 0 1 1 9-9l3 3Z"/><style>path{fill:#000}@media (prefers-color-scheme:dark){path{fill:#fff}}</style></svg>