Files
sam-api/routes/api.php
김보곤 6958be1fd8 feat:E-Sign 전자계약 서명 솔루션 백엔드 구현
- 마이그레이션 4개 (esign_contracts, esign_signers, esign_sign_fields, esign_audit_logs)
- 모델 4개 (EsignContract, EsignSigner, EsignSignField, EsignAuditLog)
- 서비스 4개 (EsignContractService, EsignSignService, EsignPdfService, EsignAuditService)
- 컨트롤러 2개 (EsignContractController, EsignSignController)
- FormRequest 4개 (ContractStore, FieldConfigure, SignSubmit, SignReject)
- Mail 1개 (EsignRequestMail + 이메일 템플릿)
- API 라우트 (인증 계약 관리 + 토큰 기반 서명 프로세스)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-12 07:02:39 +09:00

67 lines
2.5 KiB
PHP

<?php
/**
* API 라우트 - 버전 기반 라우팅 시스템
*
* 지원하는 버전 선택 방식:
* 1. Accept-Version 헤더: Accept-Version: v2
* 2. X-API-Version 헤더: X-API-Version: v2
* 3. Query Parameter: ?api_version=v2
*
* Fallback 동작:
* - v2 요청 시 v2 라우트가 없으면 자동으로 v1으로 폴백
* - 응답 헤더에 X-API-Version 포함
*/
use App\Http\Controllers\Api\V1\FileStorageController;
use Illuminate\Support\Facades\Route;
/*
|--------------------------------------------------------------------------
| V1 API Routes (기본 버전)
|--------------------------------------------------------------------------
*/
Route::prefix('v1')->group(function () {
// 도메인별 라우트 파일 로드
require __DIR__.'/api/v1/auth.php';
require __DIR__.'/api/v1/admin.php';
require __DIR__.'/api/v1/users.php';
require __DIR__.'/api/v1/tenants.php';
require __DIR__.'/api/v1/hr.php';
require __DIR__.'/api/v1/finance.php';
require __DIR__.'/api/v1/sales.php';
require __DIR__.'/api/v1/inventory.php';
require __DIR__.'/api/v1/production.php';
require __DIR__.'/api/v1/design.php';
require __DIR__.'/api/v1/files.php';
require __DIR__.'/api/v1/boards.php';
require __DIR__.'/api/v1/documents.php';
require __DIR__.'/api/v1/common.php';
require __DIR__.'/api/v1/stats.php';
require __DIR__.'/api/v1/app.php';
require __DIR__.'/api/v1/audit.php';
require __DIR__.'/api/v1/esign.php';
// 공유 링크 다운로드 (인증 불필요 - auth.apikey 그룹 밖)
Route::get('/files/share/{token}', [FileStorageController::class, 'downloadShared'])->name('v1.files.share.download');
});
/*
|--------------------------------------------------------------------------
| V2 API Routes (확장 버전 - 필요시 추가)
|--------------------------------------------------------------------------
|
| V2 라우트를 추가할 때:
| 1. routes/api/v2/ 디렉토리에 도메인별 파일 생성
| 2. 아래 주석을 해제하고 필요한 파일만 require
| 3. V2에 없는 라우트는 자동으로 V1으로 폴백
|
*/
// Route::prefix('v2')->group(function () {
// // V2 전용 라우트만 정의 (V1에 없거나 변경된 API)
// require __DIR__ . '/api/v2/auth.php'; // 예: 새로운 인증 방식
// require __DIR__ . '/api/v2/users.php'; // 예: 확장된 사용자 API
//
// // V1과 동일한 라우트는 정의하지 않음 - 미들웨어가 자동 폴백 처리
// });