SamProject/sam-api
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat:E-Sign 전자계약 서명 솔루션 백엔드 구현

Browse Source 
- 마이그레이션 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>
This commit is contained in:
김보곤
2026-02-12 07:02:39 +09:00
parent 818f764aa5
commit 6958be1fd8
22 changed files with 1673 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
routes/api.php
View File

@@ -40,6 +40,7 @@
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');

36
routes/api/v1/esign.php Normal file
View File

@@ -0,0 +1,36 @@
<?php
/**
* 전자계약(E-Sign) API 라우트 (v1)
*
* - 계약 관리 (인증 필요)
* - 서명 프로세스 (토큰 기반, 비인증)
*/
use App\Http\Controllers\Api\V1\ESign\EsignContractController;
use App\Http\Controllers\Api\V1\ESign\EsignSignController;
use Illuminate\Support\Facades\Route;
// E-Sign Contract API (인증 필요 - auth.apikey 그룹 내)
Route::prefix('esign/contracts')->group(function () {
Route::get('', [EsignContractController::class, 'index'])->name('v1.esign.contracts.index');
Route::post('', [EsignContractController::class, 'store'])->name('v1.esign.contracts.store');
Route::get('/stats', [EsignContractController::class, 'stats'])->name('v1.esign.contracts.stats');
Route::get('/{id}', [EsignContractController::class, 'show'])->whereNumber('id')->name('v1.esign.contracts.show');
Route::post('/{id}/cancel', [EsignContractController::class, 'cancel'])->whereNumber('id')->name('v1.esign.contracts.cancel');
Route::post('/{id}/fields', [EsignContractController::class, 'configureFields'])->whereNumber('id')->name('v1.esign.contracts.fields');
Route::post('/{id}/send', [EsignContractController::class, 'send'])->whereNumber('id')->name('v1.esign.contracts.send');
Route::post('/{id}/remind', [EsignContractController::class, 'remind'])->whereNumber('id')->name('v1.esign.contracts.remind');
Route::get('/{id}/download', [EsignContractController::class, 'download'])->whereNumber('id')->name('v1.esign.contracts.download');
Route::get('/{id}/verify', [EsignContractController::class, 'verify'])->whereNumber('id')->name('v1.esign.contracts.verify');
});
// E-Sign Sign API (토큰 기반, 비인증 - auth.apikey 그룹 내에서 토큰으로 접근)
Route::prefix('esign/sign/{token}')->group(function () {
Route::get('', [EsignSignController::class, 'getContract'])->name('v1.esign.sign.contract');
Route::post('/otp/send', [EsignSignController::class, 'sendOtp'])->name('v1.esign.sign.otp.send');
Route::post('/otp/verify', [EsignSignController::class, 'verifyOtp'])->name('v1.esign.sign.otp.verify');
Route::get('/document', [EsignSignController::class, 'getDocument'])->name('v1.esign.sign.document');
Route::post('/submit', [EsignSignController::class, 'submit'])->name('v1.esign.sign.submit');
Route::post('/reject', [EsignSignController::class, 'reject'])->name('v1.esign.sign.reject');
});