v7.0.0-beta.1 release

app/Http/Controllers/Api/Base/PublicBaseController.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace App\Http\Controllers\Api\Base;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\Log;
+use Symfony\Component\HttpFoundation\BinaryFileResponse;
+
+/**
+ * 공개 API용 베이스 컨트롤러
+ *
+ * 인증이 필요하지 않은 공개 API 컨트롤러가 상속받아야 하는 기본 클래스입니다.
+ * 캐싱, 속도 제한, API 사용량 추적 등의 기능을 제공합니다.
+ */
+abstract class PublicBaseController extends BaseApiController
+{
+    public function __construct()
+    {
+        // 공개 API는 속도 제한 없음 (무제한 접근 허용)
+    }
+
+    /**
+     * 캐시된 응답을 반환하거나 새로 생성합니다.
+     *
+     * @param string $key 캐시 키
+     * @param callable $callback 데이터 생성 콜백
+     * @param int $ttl 캐시 유지 시간 (초)
+     * @return mixed
+     */
+    protected function cached(string $key, callable $callback, int $ttl = 3600)
+    {
+        return cache()->remember($key, $ttl, $callback);
+    }
+
+    /**
+     * API 사용량을 기록합니다.
+     *
+     * @param string $endpoint 엔드포인트
+     * @param array $data 관련 데이터
+     * @return void
+     */
+    protected function logApiUsage(string $endpoint, array $data = []): void
+    {
+        // TODO: API 사용량 통계 시스템 구현
+        Log::info("Public API Usage: {$endpoint}", [
+            'ip' => request()->ip(),
+            'user_agent' => request()->userAgent(),
+            'data' => $data,
+            'timestamp' => now()
+        ]);
+    }
+
+    /**
+     * 클라이언트 정보를 가져옵니다.
+     *
+     * @return array
+     */
+    protected function getClientInfo(): array
+    {
+        return [
+            'ip' => request()->ip(),
+            'user_agent' => request()->userAgent(),
+            'referer' => request()->header('referer'),
+            'timestamp' => now()
+        ];
+    }
+}
+