feat(operations): fresh platform-operations implementation

Full rewrite of the installer (incl. the finish step), self-update pipeline, settings store, cron webhook, dashboard/bootstrap surface, environment manager, wizard login, config endpoint and shared helpers. Byte-compatible public interfaces and observable behavior, including documented legacy quirks; verified by the pilot behavioral suite and the full test suite.
2026-09-03 13:51:08 +00:00 · 2026-08-20 18:30:12 +02:00
parent a1828fac52
commit 7db2a8d094
31 changed files with 2869 additions and 0 deletions
@@ -0,0 +1,78 @@
+<?php
+
+namespace App\Platform\Operations\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Collection;
+
+/**
+ * One row of the instance-wide configuration table.
+ *
+ * The interesting surface is static: the installer, the updater, seeders,
+ * migrations and the platform services all treat this class as "the global
+ * settings store" rather than as an entity they hydrate and pass around.
+ */
+class Setting extends Model
+{
+    use HasFactory;
+
+    protected $table = 'settings';
+
+    protected $fillable = ['option', 'value'];
+
+    /**
+     * Store one option. An option that already has a row is overwritten.
+     */
+    public static function setSetting(string $key, mixed $setting): void
+    {
+        static::writeOption($key, $setting);
+    }
+
+    /**
+     * Store a batch of options, each one following the single-key write rule.
+     *
+     * @param  array<string, mixed>  $settings
+     */
+    public static function setSettings(array $settings): void
+    {
+        foreach ($settings as $key => $value) {
+            static::writeOption($key, $value);
+        }
+    }
+
+    /**
+     * Read one option. Keys that were never stored read as null.
+     */
+    public static function getSetting(string $key): mixed
+    {
+        return static::query()
+            ->where('option', $key)
+            ->value('value');
+    }
+
+    /**
+     * Read several options at once, as an option => value map.
+     *
+     * Keys without a row are left out of the map entirely: callers get a
+     * shorter map, never a null placeholder.
+     *
+     * @param  array<int, string>  $settings
+     * @return Collection<string, mixed>
+     */
+    public static function getSettings(array $settings): Collection
+    {
+        return static::query()
+            ->whereIn('option', $settings)
+            ->pluck('value', 'option');
+    }
+
+    /**
+     * The shared write rule behind both public writers: update in place when
+     * the option is already known, insert it otherwise.
+     */
+    private static function writeOption(string $key, mixed $value): void
+    {
+        static::query()->updateOrCreate(['option' => $key], ['value' => $value]);
+    }
+}