[FIX] Idempotent core seeders + prevent missing template/document fatals (safe fallbacks).

Author: Seiger

core/config/cache.php

@@ -1,7 +1,5 @@
-<?php
-use Illuminate\Support\Str;
+<?php use Illuminate\Support\Str;
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Default Cache Store
@@ -14,7 +12,6 @@
     | Supported: "apc", "array", "database", "file", "memcached", "redis"
     |
     */
-
     'default' => env('CACHE_DRIVER', 'file'),
 
     /*
@@ -27,28 +24,22 @@
     | same cache driver to group types of items stored in your caches.
     |
     */
-
     'stores' => [
-
         'apc' => [
             'driver' => 'apc',
         ],
-
         'array' => [
             'driver' => 'array',
         ],
-
         'database' => [
             'driver' => 'database',
             'table' => 'cache',
             'connection' => null,
         ],
-
         'file' => [
             'driver' => 'file',
             'path' => EVO_STORAGE_PATH . 'cache/',
         ],
-
         'memcached' => [
             'driver' => 'memcached',
             'persistent_id' => env('MEMCACHED_PERSISTENT_ID'),
@@ -67,12 +58,10 @@
                 ],
             ],
         ],
-
         'redis' => [
             'driver' => 'redis',
             'connection' => 'default',
         ],
-
     ],
 
     /*
@@ -85,10 +74,8 @@
     | value to get prefixed to all our keys so we can avoid collisions.
     |
     */
-
     'prefix' => env(
         'CACHE_PREFIX',
-        Str::slug(env('APP_NAME', 'laravel'), '_').'_cache'
+        Str::slug(env('APP_NAME', 'evo'), '_').'_cache'
     ),
-
 ];

core/config/database.php

@@ -1,6 +1,4 @@
-<?php
-
-return [
+<?php return [
     'default' => 'default',
     'redis' => [
         'client' => env('REDIS_CLIENT', 'phpredis'),

core/config/filesystems.php

@@ -1,5 +1,4 @@
-<?php
-return [
+<?php return [
     /*
     |--------------------------------------------------------------------------
     | Default Filesystem Disk
@@ -11,6 +10,7 @@
     |
     */
     'default' => 'public',
+
     /*
     |--------------------------------------------------------------------------
     | Filesystem Disks

core/config/logging.php

@@ -13,7 +13,6 @@
     | one of the channels defined in the "channels" configuration array.
     |
     */
-
     'default' => env('LOG_CHANNEL', 'daily'),
 
     /*
@@ -30,19 +29,16 @@
     |                    "custom", "stack"
     |
     */
-
     'channels' => [
         'stack' => [
             'driver' => 'stack',
             'channels' => ['single'],
         ],
-
         'single' => [
             'driver' => 'single',
             'path' => EVO_STORAGE_PATH . 'logs/evo.log',
             'level' => 'debug',
         ],
-
         'daily' => [
             'driver' => 'daily',
             'name' => env('APP_NAME', 'evo'),
@@ -51,28 +47,24 @@
             'days' => env('LOG_DAILY_DAYS', 14),
             'replace_placeholders' => true,
         ],
-
         'slack' => [
             'driver' => 'slack',
             'url' => env('LOG_SLACK_WEBHOOK_URL'),
             'username' => 'EVO Log',
             'emoji' => ':boom:',
             'level' => 'critical',
         ],
-
         'stderr' => [
             'driver' => 'monolog',
             'handler' => StreamHandler::class,
             'with' => [
                 'stream' => 'php://stderr',
             ],
         ],
-
         'syslog' => [
             'driver' => 'syslog',
             'level' => 'debug',
         ],
-
         'errorlog' => [
             'driver' => 'errorlog',
             'level' => 'debug',

core/config/session.php

@@ -3,7 +3,6 @@
 use Illuminate\Support\Str;
 
 return [
-
     /*
     |--------------------------------------------------------------------------
     | Default Session Driver
@@ -17,7 +16,6 @@
     |            "memcached", "redis", "dynamodb", "array"
     |
     */
-
     'driver' => env('SESSION_DRIVER', 'file'),
 
     /*
@@ -30,9 +28,7 @@
     | to immediately expire on the browser closing, set that option.
     |
     */
-
     'lifetime' => env('SESSION_LIFETIME', 120),
-
     'expire_on_close' => false,
 
     /*
@@ -45,7 +41,6 @@
     | automatically by Laravel and you can use the Session like normal.
     |
     */
-
     'encrypt' => false,
 
     /*
@@ -58,7 +53,6 @@
     | location may be specified. This is only needed for file sessions.
     |
     */
-
     'files' => storage_path('sessions'),
 
     /*
@@ -71,7 +65,6 @@
     | correspond to a connection in your database configuration options.
     |
     */
-
     'connection' => env('SESSION_CONNECTION', null),
 
     /*
@@ -84,7 +77,6 @@
     | provided for you; however, you are free to change this as needed.
     |
     */
-
     'table' => 'sessions',
 
     /*
@@ -97,7 +89,6 @@
     | must match with one of the application's configured cache "stores".
     |
     */
-
     'store' => env('SESSION_STORE', null),
 
     /*
@@ -110,7 +101,6 @@
     | happen on a given request. By default, the odds are 2 out of 100.
     |
     */
-
     'lottery' => [2, 100],
 
     /*
@@ -123,7 +113,6 @@
     | new session cookie is created by the framework for every driver.
     |
     */
-
     'cookie' => env(
         'SESSION_COOKIE',
         'evo_session'
@@ -139,7 +128,6 @@
     | your application but you are free to change this when necessary.
     |
     */
-
     'path' => '/',
 
     /*
@@ -152,7 +140,6 @@
     | available to in your application. A sensible default has been set.
     |
     */
-
     'domain' => env('SESSION_DOMAIN', null),
 
     /*
@@ -165,7 +152,6 @@
     | the cookie from being sent to you if it can not be done securely.
     |
     */
-
     'secure' => env('SESSION_SECURE_COOKIE', false),
 
     /*
@@ -178,7 +164,6 @@
     | the HTTP protocol. You are free to modify this option if needed.
     |
     */
-
     'http_only' => true,
 
     /*
@@ -193,7 +178,5 @@
     | Supported: "lax", "strict"
     |
     */
-
     'same_site' => null,
-
 ];

core/database/seeders/AdminUserTableSeeder.php

@@ -4,8 +4,21 @@
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Schema;
 
+/**
+ * Seeds the initial administrator user (if missing).
+ *
+ * Safety:
+ * - Does not delete or overwrite existing users.
+ * - Creates the user only if a user with the configured username does not exist.
+ * - Creates `user_attributes` only if missing for the user.
+ */
 class AdminUserTableSeeder extends Seeder
 {
+    /**
+     * Execute the database seeder.
+     *
+     * Creates the admin user (and its attributes) only if the user does not already exist.
+     */
     public function run(): void
     {
         if (!Schema::hasTable('users') || !Schema::hasTable('user_attributes')) {

core/database/seeders/SiteContentTableSeeder.php

@@ -3,17 +3,31 @@
 use Illuminate\Database\Seeder;
 use Illuminate\Support\Facades\DB;
 use EvolutionCMS\Models\SiteContent;
+use Illuminate\Support\Facades\Schema;
 
+/**
+ * Seeds an initial "install success" document for a fresh installation.
+ *
+ * Safety: this seeder is idempotent and will not overwrite existing site content.
+ * If the `site_content` table already contains any rows, it does nothing.
+ */
 class SiteContentTableSeeder extends Seeder
 {
     /**
-     * Run the database seeds.
+     * Execute the database seeder.
      *
-     * @return void
+     * Inserts the default "install success" document only when the `site_content` table is empty.
      */
     public function run(): void
     {
-        DB::table('site_content')->delete();
+        if (!Schema::hasTable('site_content')) {
+            return;
+        }
+
+        if (DB::table('site_content')->count() > 0) {
+            return;
+        }
+
         $resource = SiteContent::create(
             [
                 'type'            => 'document',

core/database/seeders/SiteTemplatesTableSeeder.php

@@ -2,17 +2,31 @@
 
 use Illuminate\Database\Seeder;
 use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
 
+/**
+ * Seeds the minimal default site template for a fresh installation.
+ *
+ * Safety: this seeder is idempotent and will not overwrite existing templates.
+ * If the `site_templates` table already contains any rows, it does nothing.
+ */
 class SiteTemplatesTableSeeder extends Seeder
 {
     /**
-     * Run the database seeds.
+     * Execute the database seeder.
      *
-     * @return void
+     * Inserts the default "Minimal Template" only when the `site_templates` table is empty.
      */
     public function run(): void
     {
-        DB::table('site_templates')->delete();
+        if (!Schema::hasTable('site_templates')) {
+            return;
+        }
+
+        if (DB::table('site_templates')->count() > 0) {
+            return;
+        }
+
         DB::table('site_templates')->insert([
             [
                 'templatename'  => 'Minimal Template',

core/database/seeders/SystemEventnamesTableSeeder.php

@@ -2,17 +2,31 @@
 
 use Illuminate\Database\Seeder;
 use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
 
+/**
+ * Seeds the `system_eventnames` table for a fresh installation.
+ *
+ * Safety: this seeder is idempotent and will not duplicate/overwrite existing rows.
+ * If the `system_eventnames` table already contains any rows, it does nothing.
+ */
 class SystemEventnamesTableSeeder extends Seeder
 {
     /**
-     * Run the database seeds.
+     * Execute the database seeder.
      *
-     * @return void
+     * Inserts the default system event names only when the `system_eventnames` table is empty.
      */
     public function run(): void
     {
-        DB::table('system_eventnames')->delete();
+        if (!Schema::hasTable('system_eventnames')) {
+            return;
+        }
+
+        if (DB::table('system_eventnames')->count() > 0) {
+            return;
+        }
+
         DB::table('system_eventnames')->insert([
             [
                 'name'      => 'OnDocPublished',