v7.0.0-beta.1 release

app/Contracts/Repositories/UserConsentRepositoryInterface.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Contracts\Repositories;
+
+use App\Models\UserConsent;
+use Illuminate\Database\Eloquent\Collection;
+
+interface UserConsentRepositoryInterface
+{
+    /**
+     * 새로운 동의 이력을 기록합니다.
+     *
+     * @param  array  $data  동의 데이터 (user_id, consent_type, page_id, version, agreed_at, ip_address)
+     * @return UserConsent 생성된 동의 이력 모델
+     */
+    public function record(array $data): UserConsent;
+
+    /**
+     * 특정 사용자의 모든 동의 이력을 조회합니다 (최신순).
+     *
+     * @param  int  $userId  사용자 ID
+     * @return Collection 동의 이력 컬렉션
+     */
+    public function getByUser(int $userId): Collection;
+
+    /**
+     * 특정 사용자의 특정 유형 최신 동의 이력을 조회합니다.
+     *
+     * @param  int  $userId  사용자 ID
+     * @param  string  $consentType  동의 유형 (ConsentType 값)
+     * @return UserConsent|null 최신 동의 이력 또는 null
+     */
+    public function getLatestByType(int $userId, string $consentType): ?UserConsent;
+}