chore: update document approval workflow and bug fixes

2026-05-25 13:05:20 +08:00
parent d573c02893
commit 39a8e1d4cd
910 changed files with 49994 additions and 1010 deletions
--- a/app/Traits/HasStateMachine.php
+++ b/app/Traits/HasStateMachine.php
@@ -0,0 +1,84 @@
+<?php
+
+namespace App\Traits;
+
+use InvalidArgumentException;
+
+/**
+ * Custom state machine trait for Eloquent models.
+ * Replacement for spatie/laravel-model-states (incompatible with Laravel 13).
+ *
+ * Usage:
+ *   1. Define a PHP enum for your states
+ *   2. Use this trait on your model
+ *   3. Implement `getStateMachineConfig()` returning state field + allowed transitions
+ */
+trait HasStateMachine
+{
+    /**
+     * Get the state machine configuration.
+     * Override in your model.
+     *
+     * @return array{field: string, transitions: array<string, string[]>}
+     */
+    abstract protected static function stateMachineConfig(): array;
+
+    public function getStateField(): string
+    {
+        return static::stateMachineConfig()['field'];
+    }
+
+    public function getCurrentState(): string
+    {
+        $field = $this->getStateField();
+        return $this->{$field};
+    }
+
+    public function canTransitionTo(string $newState): bool
+    {
+        $config = static::stateMachineConfig();
+        $currentState = $this->getCurrentState();
+        $transitions = $config['transitions'] ?? [];
+
+        if (!isset($transitions[$currentState])) {
+            return false;
+        }
+
+        return in_array($newState, $transitions[$currentState], true);
+    }
+
+    public function transitionTo(string $newState): static
+    {
+        if (!$this->canTransitionTo($newState)) {
+            $currentState = $this->getCurrentState();
+            $field = $this->getStateField();
+            throw new InvalidArgumentException(
+                "Cannot transition '{$field}' from '{$currentState}' to '{$newState}'."
+            );
+        }
+
+        $field = $this->getStateField();
+        $oldState = $this->getCurrentState();
+
+        $this->{$field} = $newState;
+        $this->save();
+
+        // Fire an event for the transition
+        $modelName = class_basename(static::class);
+        event("{$modelName}StateChanged", [
+            'model' => $this,
+            'field' => $field,
+            'from' => $oldState,
+            'to' => $newState,
+        ]);
+
+        return $this;
+    }
+
+    public function getAllowedTransitions(): array
+    {
+        $config = static::stateMachineConfig();
+        $currentState = $this->getCurrentState();
+        return $config['transitions'][$currentState] ?? [];
+    }
+}