v7.0.0 release

app/Exceptions/ConcurrentModificationException.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Exceptions;
+
+use RuntimeException;
+
+/**
+ * 낙관적 잠금 충돌 예외 — 동일 행에 대해 두 클라이언트가 동시에 저장을 시도해
+ * `lock_version` 이 기대값과 일치하지 않을 때 발생합니다. 컨트롤러는 이 예외를
+ * 잡아 409 Conflict 응답으로 변환하고, 프론트엔드는 "다른 사용자가 먼저
+ * 저장했습니다" 안내 모달을 표시합니다.
+ */
+class ConcurrentModificationException extends RuntimeException
+{
+    public function __construct(
+        public readonly int $currentVersion,
+        public readonly int $expectedVersion,
+        public readonly string $resource,
+    ) {
+        parent::__construct(__('exceptions.concurrent_modification', [
+            'resource' => $resource,
+            'current' => $currentVersion,
+            'expected' => $expectedVersion,
+        ]));
+    }
+}