feat: API 라우터 분리 및 버전 폴백 시스템 구현

- api.php를 13개 도메인별 파일로 분리 (1,479줄 → 61줄)
- ApiVersionMiddleware 생성 (헤더/쿼리 기반 버전 선택)
- v2 요청 시 v2 없으면 v1으로 자동 폴백
- 지원 헤더: Accept-Version, X-API-Version, api_version 쿼리

분리된 도메인:
auth, admin, users, tenants, hr, finance, sales,
inventory, production, design, files, boards, common

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

bootstrap/app.php

@@ -3,6 +3,7 @@
 use App\Exceptions\Handler;
 use App\Http\Middleware\ApiKeyMiddleware;
 use App\Http\Middleware\ApiRateLimiter;
+use App\Http\Middleware\ApiVersionMiddleware;
 use App\Http\Middleware\CheckPermission;
 use App\Http\Middleware\CheckSwaggerAuth;
 use App\Http\Middleware\CorsMiddleware;
@@ -23,14 +24,16 @@
     ->withMiddleware(function (Middleware $middleware) {
         // 글로벌 미들웨어 (모든 요청에 적용, 순서 중요)
         $middleware->append(CorsMiddleware::class);
-        $middleware->append(ApiRateLimiter::class);    // 1. Rate Limiting 먼저 체크
-        $middleware->append(ApiKeyMiddleware::class);  // 2. API Key 검증
+        $middleware->append(ApiRateLimiter::class);     // 1. Rate Limiting 먼저 체크
+        $middleware->append(ApiKeyMiddleware::class);   // 2. API Key 검증
+        $middleware->append(ApiVersionMiddleware::class); // 3. API 버전 해석 및 폴백
 
         // API 미들웨어 그룹에 로깅 추가
         $middleware->appendToGroup('api', LogApiRequest::class);
 
         $middleware->alias([
-            'auth.apikey' => ApiKeyMiddleware::class, // 인증: apikey + basic auth (alias 유지)
+            'auth.apikey' => ApiKeyMiddleware::class,    // 인증: apikey + basic auth (alias 유지)
+            'api.version' => ApiVersionMiddleware::class, // API 버전 해석 및 폴백
             'swagger.auth' => CheckSwaggerAuth::class,
             'perm.map' => PermMapper::class, // 전처리: 라우트명 → perm 키 생성/주입
             'permission' => CheckPermission::class, // 검사: perm 키로 접근 허용/차단