Files
sam-manage/app/Http/Controllers/ESign/EsignApiController.php
김보곤 92c78b353e feat:E-Sign 계약 생성 영업파트너 검색 모달 추가
- EsignApiController에 searchPartners() 검색 API 추가
- SalesPartner 모델 $fillable에 company_name, biz_no, address 추가
- User 모델에 salesPartner() HasOne 관계 추가
- create.blade.php에 PartnerSearchModal 컴포넌트 + 자동채우기 로직 추가
- web.php에 search-partners 라우트 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-14 10:48:31 +09:00

1414 lines
54 KiB
PHP

<?php
namespace App\Http\Controllers\ESign;
use App\Http\Controllers\Controller;
use App\Mail\EsignRequestMail;
use App\Models\ESign\EsignContract;
use App\Models\User;
use App\Services\ESign\DocxToPdfConverter;
use App\Models\ESign\EsignFieldTemplate;
use App\Models\ESign\EsignFieldTemplateItem;
use App\Models\ESign\EsignSigner;
use App\Models\ESign\EsignSignField;
use App\Models\ESign\EsignAuditLog;
use App\Models\Tenants\TenantSetting;
use App\Services\GoogleCloudStorageService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Mail;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
class EsignApiController extends Controller
{
/**
* 영업파트너 검색
*/
public function searchPartners(Request $request): JsonResponse
{
$q = trim($request->input('q', ''));
$query = User::where('is_active', true)
->whereIn('role', ['sales', 'manager'])
->with('salesPartner');
if ($q !== '') {
$query->where(function ($w) use ($q) {
$w->where('name', 'like', "%{$q}%")
->orWhere('email', 'like', "%{$q}%")
->orWhere('phone', 'like', "%{$q}%");
});
}
$users = $query->orderBy('name')->limit(20)->get();
$data = $users->map(function ($user) {
$sp = $user->salesPartner;
return [
'id' => $user->id,
'name' => $user->name,
'phone' => $user->phone,
'email' => $user->email,
'company_name' => $sp?->company_name,
'biz_no' => $sp?->biz_no,
'address' => $sp?->address,
];
});
return response()->json(['success' => true, 'data' => $data]);
}
/**
* 법인도장 조회
*/
public function getStamp(): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$setting = TenantSetting::where('tenant_id', $tenantId)
->where('setting_group', 'esign')
->where('setting_key', 'company_stamp')
->first();
if (!$setting || empty($setting->setting_value['gcs_object'])) {
return response()->json(['success' => true, 'data' => null]);
}
$gcs = app(GoogleCloudStorageService::class);
$signedUrl = $gcs->getSignedUrl($setting->setting_value['gcs_object'], 60);
if (!$signedUrl) {
return response()->json(['success' => true, 'data' => null]);
}
return response()->json([
'success' => true,
'data' => [
'image_url' => $signedUrl,
],
]);
}
/**
* 법인도장 업로드
*/
public function uploadStamp(Request $request): JsonResponse
{
$request->validate([
'stamp_image_data' => 'required|string',
]);
$tenantId = session('selected_tenant_id', 1);
$imageData = base64_decode($request->input('stamp_image_data'));
if (!$imageData) {
return response()->json(['success' => false, 'message' => '이미지 데이터가 올바르지 않습니다.'], 422);
}
$gcs = app(GoogleCloudStorageService::class);
if (!$gcs->isAvailable()) {
return response()->json(['success' => false, 'message' => 'GCS 설정이 되어 있지 않습니다.'], 500);
}
// 기존 GCS 파일 삭제
$existing = TenantSetting::where('tenant_id', $tenantId)
->where('setting_group', 'esign')
->where('setting_key', 'company_stamp')
->first();
if ($existing && !empty($existing->setting_value['gcs_object'])) {
$gcs->delete($existing->setting_value['gcs_object']);
}
// 임시 파일에 저장 후 GCS 업로드
$tmpFile = tempnam(sys_get_temp_dir(), 'stamp_');
file_put_contents($tmpFile, $imageData);
$gcsObject = "esign/{$tenantId}/stamps/company_stamp.png";
$gcsUri = $gcs->upload($tmpFile, $gcsObject);
unlink($tmpFile);
if (!$gcsUri) {
return response()->json(['success' => false, 'message' => 'GCS 업로드에 실패했습니다.'], 500);
}
TenantSetting::updateOrCreate(
[
'tenant_id' => $tenantId,
'setting_group' => 'esign',
'setting_key' => 'company_stamp',
],
[
'setting_value' => ['gcs_object' => $gcsObject],
'updated_by' => auth()->id(),
]
);
$signedUrl = $gcs->getSignedUrl($gcsObject, 60);
return response()->json([
'success' => true,
'message' => '법인도장이 등록되었습니다.',
'data' => [
'image_url' => $signedUrl,
],
]);
}
/**
* 법인도장 삭제
*/
public function deleteStamp(): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$setting = TenantSetting::where('tenant_id', $tenantId)
->where('setting_group', 'esign')
->where('setting_key', 'company_stamp')
->first();
if ($setting) {
$gcsObject = $setting->setting_value['gcs_object'] ?? null;
if ($gcsObject) {
$gcs = app(GoogleCloudStorageService::class);
$gcs->delete($gcsObject);
}
$setting->delete();
}
return response()->json([
'success' => true,
'message' => '법인도장이 삭제되었습니다.',
]);
}
/**
* 상태별 통계
*/
public function stats(): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$contracts = EsignContract::forTenant($tenantId)->get();
$stats = [
'total' => $contracts->count(),
'draft' => $contracts->where('status', 'draft')->count(),
'pending' => $contracts->where('status', 'pending')->count(),
'partially_signed' => $contracts->where('status', 'partially_signed')->count(),
'completed' => $contracts->where('status', 'completed')->count(),
'expired' => $contracts->where('status', 'expired')->count(),
'cancelled' => $contracts->where('status', 'cancelled')->count(),
'rejected' => $contracts->where('status', 'rejected')->count(),
];
return response()->json(['success' => true, 'data' => $stats]);
}
/**
* 계약 목록 (페이지네이션)
*/
public function index(Request $request): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$query = EsignContract::forTenant($tenantId)->with(['signers:id,contract_id,name,role,status']);
if ($status = $request->input('status')) {
$query->where('status', $status);
}
if ($search = $request->input('search')) {
$query->where(function ($q) use ($search) {
$q->where('title', 'like', "%{$search}%")
->orWhere('contract_code', 'like', "%{$search}%");
});
}
$perPage = $request->input('per_page', 20);
$data = $query->orderBy('created_at', 'desc')->paginate($perPage);
return response()->json(['success' => true, 'data' => $data]);
}
/**
* 계약 상세 조회
*/
public function show(int $id): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$contract = EsignContract::forTenant($tenantId)
->with(['signers', 'signFields', 'auditLogs' => fn($q) => $q->orderBy('created_at', 'desc')])
->findOrFail($id);
return response()->json(['success' => true, 'data' => $contract]);
}
/**
* 계약 생성
*/
public function store(Request $request): JsonResponse
{
$request->validate([
'title' => 'required|string|max:200',
'description' => 'nullable|string',
'sign_order_type' => 'required|in:counterpart_first,creator_first',
'expires_at' => 'nullable|date',
'expires_days' => 'nullable|integer|min:1|max:365',
'template_id' => 'nullable|integer',
'signers' => 'required|array|size:2',
'signers.*.name' => 'required|string|max:100',
'signers.*.email' => 'required|email|max:200',
'signers.*.phone' => 'nullable|string|max:20',
'signers.*.role' => 'required|in:creator,counterpart',
'metadata' => 'nullable|array',
'metadata.*' => 'nullable|string|max:500',
'file' => 'nullable|file|mimes:pdf,doc,docx|max:20480',
]);
$tenantId = session('selected_tenant_id', 1);
$userId = auth()->id();
// 계약 코드 생성
$contractCode = 'ES-' . date('Ymd') . '-' . strtoupper(Str::random(6));
// PDF 파일 처리
$filePath = null;
$fileName = null;
$fileHash = null;
$fileSize = null;
if ($request->hasFile('file')) {
// 사용자가 직접 업로드한 파일 우선 사용 (Word면 PDF 자동 변환)
$file = $request->file('file');
$converter = new DocxToPdfConverter();
$result = $converter->convertAndStore($file, "esign/{$tenantId}/contracts");
$filePath = $result['path'];
$fileName = $result['name'];
$fileHash = $result['hash'];
$fileSize = $result['size'];
} elseif ($request->input('template_id')) {
// 템플릿에 PDF가 있으면 복사
$template = EsignFieldTemplate::forTenant($tenantId)
->where('is_active', true)
->find($request->input('template_id'));
if ($template && $template->file_path && Storage::disk('local')->exists($template->file_path)) {
$ext = pathinfo($template->file_path, PATHINFO_EXTENSION) ?: 'pdf';
$newPath = "esign/{$tenantId}/contracts/" . Str::random(40) . ".{$ext}";
Storage::disk('local')->copy($template->file_path, $newPath);
$filePath = $newPath;
$fileName = $template->file_name;
$fileHash = $template->file_hash;
$fileSize = $template->file_size;
}
}
$contract = EsignContract::create([
'tenant_id' => $tenantId,
'contract_code' => $contractCode,
'title' => $request->input('title'),
'description' => $request->input('description'),
'sign_order_type' => $request->input('sign_order_type'),
'original_file_path' => $filePath,
'original_file_name' => $fileName,
'original_file_hash' => $fileHash,
'original_file_size' => $fileSize,
'status' => 'draft',
'metadata' => $request->input('metadata'),
'expires_at' => $request->input('expires_at')
? \Carbon\Carbon::parse($request->input('expires_at'))
: now()->addDays($request->input('expires_days', 30)),
'created_by' => $userId,
'updated_by' => $userId,
]);
// 서명자 생성
$signers = $request->input('signers');
foreach ($signers as $i => $signerData) {
EsignSigner::create([
'tenant_id' => $tenantId,
'contract_id' => $contract->id,
'role' => $signerData['role'],
'sign_order' => $signerData['role'] === 'creator'
? ($request->input('sign_order_type') === 'creator_first' ? 1 : 2)
: ($request->input('sign_order_type') === 'counterpart_first' ? 1 : 2),
'name' => $signerData['name'],
'email' => $signerData['email'],
'phone' => $signerData['phone'] ?? null,
'access_token' => Str::random(128),
'token_expires_at' => now()->addDays($request->input('expires_days', 30)),
'status' => 'waiting',
]);
}
// 법인도장 자동 적용: GCS에서 다운로드 → 로컬 저장 → signer에 설정
$stampSetting = TenantSetting::where('tenant_id', $tenantId)
->where('setting_group', 'esign')
->where('setting_key', 'company_stamp')
->first();
if ($stampSetting && !empty($stampSetting->setting_value['gcs_object'])) {
$creatorSigner = EsignSigner::withoutGlobalScopes()
->where('contract_id', $contract->id)
->where('role', 'creator')
->first();
if ($creatorSigner) {
$gcs = app(GoogleCloudStorageService::class);
$signedUrl = $gcs->getSignedUrl($stampSetting->setting_value['gcs_object'], 5);
if ($signedUrl) {
$imageData = @file_get_contents($signedUrl);
if ($imageData) {
$localPath = "esign/{$tenantId}/signatures/{$contract->id}_{$creatorSigner->id}_stamp.png";
Storage::disk('local')->put($localPath, $imageData);
$creatorSigner->update(['signature_image_path' => $localPath]);
}
}
}
}
// 템플릿 자동 적용 (template_id가 있으면 필드 자동 생성)
$autoApplied = false;
if ($request->input('template_id')) {
$template = EsignFieldTemplate::forTenant($tenantId)
->where('is_active', true)->with('items')
->find($request->input('template_id'));
if ($template && $template->items->isNotEmpty()) {
$contract->loadMissing('signers');
// 템플릿 signer_order를 역할(role)로 매핑: 1=creator(갑/회사), 2=counterpart(을/파트너)
$signerMap = [];
foreach ($contract->signers as $signer) {
$templateOrder = $signer->role === 'creator' ? 1 : 2;
$signerMap[$templateOrder] = $signer->id;
}
$variableValues = $this->buildVariableMap($contract, $template);
foreach ($template->items as $item) {
$signerId = $signerMap[$item->signer_order] ?? null;
if (!$signerId) continue;
$fieldValue = null;
if ($item->field_variable && isset($variableValues[$item->field_variable])) {
$fieldValue = $variableValues[$item->field_variable];
}
EsignSignField::create([
'tenant_id' => $tenantId,
'contract_id' => $contract->id,
'signer_id' => $signerId,
'page_number' => $item->page_number,
'position_x' => $item->position_x,
'position_y' => $item->position_y,
'width' => $item->width,
'height' => $item->height,
'field_type' => $item->field_type,
'field_label' => $item->field_label,
'field_variable' => $item->field_variable,
'font_size' => $item->font_size,
'text_align' => $item->text_align ?? 'L',
'field_value' => $fieldValue,
'is_required' => $item->is_required,
'sort_order' => $item->sort_order,
]);
}
$autoApplied = true;
}
}
// 감사 로그
EsignAuditLog::create([
'tenant_id' => $tenantId,
'contract_id' => $contract->id,
'action' => 'contract_created',
'ip_address' => $request->ip(),
'user_agent' => $request->userAgent(),
'metadata' => ['created_by' => $userId],
'created_at' => now(),
]);
return response()->json([
'success' => true,
'message' => '계약이 생성되었습니다.',
'data' => $contract->load('signers'),
'auto_applied' => $autoApplied,
]);
}
/**
* 계약 취소
*/
public function cancel(Request $request, int $id): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$contract = EsignContract::forTenant($tenantId)->findOrFail($id);
if (in_array($contract->status, ['completed', 'cancelled'])) {
return response()->json(['success' => false, 'message' => '취소할 수 없는 상태입니다.'], 422);
}
$contract->update([
'status' => 'cancelled',
'updated_by' => auth()->id(),
]);
EsignAuditLog::create([
'tenant_id' => $tenantId,
'contract_id' => $contract->id,
'action' => 'contract_cancelled',
'ip_address' => $request->ip(),
'user_agent' => $request->userAgent(),
'metadata' => ['cancelled_by' => auth()->id()],
'created_at' => now(),
]);
return response()->json(['success' => true, 'message' => '계약이 취소되었습니다.']);
}
/**
* 계약 삭제 - 휴지통으로 이동 (SoftDelete)
*/
public function destroy(Request $request): JsonResponse
{
$request->validate([
'ids' => 'required|array|min:1',
'ids.*' => 'required|integer',
]);
$tenantId = session('selected_tenant_id', 1);
$ids = $request->input('ids');
$contracts = EsignContract::forTenant($tenantId)->whereIn('id', $ids)->get();
if ($contracts->isEmpty()) {
return response()->json(['success' => false, 'message' => '삭제할 계약을 찾을 수 없습니다.'], 404);
}
// 진행 중인 계약(pending, partially_signed) 차단
$activeContracts = $contracts->filter(fn ($c) => in_array($c->status, ['pending', 'partially_signed']));
if ($activeContracts->isNotEmpty()) {
return response()->json([
'success' => false,
'message' => '서명 진행 중인 계약은 삭제할 수 없습니다. 먼저 취소해 주세요.',
], 422);
}
$deletedCount = 0;
foreach ($contracts as $contract) {
$contract->update(['deleted_by' => auth()->id()]);
$contract->delete(); // SoftDelete → deleted_at 설정
$deletedCount++;
}
return response()->json([
'success' => true,
'message' => "{$deletedCount}건의 계약이 휴지통으로 이동되었습니다.",
]);
}
/**
* 휴지통 목록
*/
public function trashed(Request $request): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$query = EsignContract::onlyTrashed()
->where('tenant_id', $tenantId)
->with(['signers:id,contract_id,name,role,status']);
if ($search = $request->input('search')) {
$query->where(function ($q) use ($search) {
$q->where('title', 'like', "%{$search}%")
->orWhere('contract_code', 'like', "%{$search}%");
});
}
$perPage = $request->input('per_page', 20);
$data = $query->orderBy('deleted_at', 'desc')->paginate($perPage);
return response()->json(['success' => true, 'data' => $data]);
}
/**
* 휴지통에서 복구
*/
public function restore(Request $request): JsonResponse
{
$request->validate([
'ids' => 'required|array|min:1',
'ids.*' => 'required|integer',
]);
$tenantId = session('selected_tenant_id', 1);
$contracts = EsignContract::onlyTrashed()
->where('tenant_id', $tenantId)
->whereIn('id', $request->input('ids'))
->get();
if ($contracts->isEmpty()) {
return response()->json(['success' => false, 'message' => '복구할 계약을 찾을 수 없습니다.'], 404);
}
$restoredCount = 0;
foreach ($contracts as $contract) {
$contract->update(['deleted_by' => null]);
$contract->restore();
$restoredCount++;
}
return response()->json([
'success' => true,
'message' => "{$restoredCount}건의 계약이 복구되었습니다.",
]);
}
/**
* 영구 삭제
*/
public function forceDestroy(Request $request): JsonResponse
{
$request->validate([
'ids' => 'required|array|min:1',
'ids.*' => 'required|integer',
]);
$tenantId = session('selected_tenant_id', 1);
$contracts = EsignContract::onlyTrashed()
->where('tenant_id', $tenantId)
->whereIn('id', $request->input('ids'))
->get();
if ($contracts->isEmpty()) {
return response()->json(['success' => false, 'message' => '삭제할 계약을 찾을 수 없습니다.'], 404);
}
$deletedCount = 0;
foreach ($contracts as $contract) {
// 관련 파일 삭제
if ($contract->original_file_path && Storage::disk('local')->exists($contract->original_file_path)) {
Storage::disk('local')->delete($contract->original_file_path);
}
if ($contract->signed_file_path && Storage::disk('local')->exists($contract->signed_file_path)) {
Storage::disk('local')->delete($contract->signed_file_path);
}
// 서명 이미지 파일 삭제
$signers = EsignSigner::withoutGlobalScopes()->where('contract_id', $contract->id)->get();
foreach ($signers as $signer) {
if ($signer->signature_image_path && Storage::disk('local')->exists($signer->signature_image_path)) {
Storage::disk('local')->delete($signer->signature_image_path);
}
}
// 관련 레코드 영구 삭제
EsignSignField::where('contract_id', $contract->id)->delete();
EsignAuditLog::where('contract_id', $contract->id)->delete();
EsignSigner::withoutGlobalScopes()->where('contract_id', $contract->id)->delete();
$contract->forceDelete();
$deletedCount++;
}
return response()->json([
'success' => true,
'message' => "{$deletedCount}건의 계약이 영구 삭제되었습니다.",
]);
}
/**
* 서명 위치 설정
*/
public function configureFields(Request $request, int $id): JsonResponse
{
$request->validate([
'fields' => 'required|array',
'fields.*.signer_id' => 'required|integer',
'fields.*.page_number' => 'required|integer|min:1',
'fields.*.position_x' => 'required|numeric',
'fields.*.position_y' => 'required|numeric',
'fields.*.width' => 'required|numeric',
'fields.*.height' => 'required|numeric',
'fields.*.field_type' => 'required|in:signature,stamp,text,date,checkbox',
'fields.*.field_label' => 'nullable|string|max:100',
'fields.*.field_variable' => 'nullable|string|max:50',
'fields.*.font_size' => 'nullable|integer|min:6|max:72',
'fields.*.text_align' => 'nullable|string|in:L,C,R',
'fields.*.is_required' => 'nullable|boolean',
]);
$tenantId = session('selected_tenant_id', 1);
$contract = EsignContract::forTenant($tenantId)->findOrFail($id);
// 기존 필드 삭제 후 새로 생성
EsignSignField::where('contract_id', $contract->id)->delete();
foreach ($request->input('fields') as $i => $field) {
EsignSignField::create([
'tenant_id' => $tenantId,
'contract_id' => $contract->id,
'signer_id' => $field['signer_id'],
'page_number' => $field['page_number'],
'position_x' => $field['position_x'],
'position_y' => $field['position_y'],
'width' => $field['width'],
'height' => $field['height'],
'field_type' => $field['field_type'],
'field_label' => $field['field_label'] ?? null,
'field_variable' => $field['field_variable'] ?? null,
'font_size' => $field['font_size'] ?? null,
'text_align' => $field['text_align'] ?? 'L',
'is_required' => $field['is_required'] ?? true,
'sort_order' => $i,
]);
}
return response()->json(['success' => true, 'message' => '서명 위치가 설정되었습니다.']);
}
/**
* 서명 요청 발송 (상태 변경 + 이메일은 추후)
*/
public function send(Request $request, int $id): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$contract = EsignContract::forTenant($tenantId)->with('signers')->findOrFail($id);
if ($contract->status !== 'draft') {
return response()->json(['success' => false, 'message' => '초안 상태에서만 발송할 수 있습니다.'], 422);
}
$contract->update([
'status' => 'pending',
'updated_by' => auth()->id(),
]);
// 서명 순서 유형에 따라 알림 발송
if ($contract->sign_order_type === 'parallel') {
// 동시 서명: 모든 서명자에게 발송
foreach ($contract->signers as $s) {
$s->update(['status' => 'notified']);
Mail::to($s->email)->send(new EsignRequestMail($contract, $s));
}
} else {
// 순차 서명: 첫 번째 서명자에게 발송
$firstSigner = $contract->signers()
->orderBy('sign_order')
->first();
if ($firstSigner) {
$firstSigner->update(['status' => 'notified']);
Mail::to($firstSigner->email)->send(new EsignRequestMail($contract, $firstSigner));
}
}
EsignAuditLog::create([
'tenant_id' => $tenantId,
'contract_id' => $contract->id,
'action' => 'sign_request_sent',
'ip_address' => $request->ip(),
'user_agent' => $request->userAgent(),
'metadata' => ['sent_by' => auth()->id()],
'created_at' => now(),
]);
return response()->json(['success' => true, 'message' => '서명 요청이 발송되었습니다.']);
}
/**
* 리마인더 발송
*/
public function remind(Request $request, int $id): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$contract = EsignContract::forTenant($tenantId)->with('signers')->findOrFail($id);
if (! in_array($contract->status, ['pending', 'partially_signed'])) {
return response()->json(['success' => false, 'message' => '리마인더를 발송할 수 없는 상태입니다.'], 422);
}
// 다음 서명 대상자 찾기
$nextSigner = $contract->signers()
->whereIn('status', ['waiting', 'notified'])
->orderBy('sign_order')
->first();
if ($nextSigner) {
$nextSigner->update(['status' => 'notified']);
Mail::to($nextSigner->email)->send(new EsignRequestMail($contract, $nextSigner, isReminder: true));
}
EsignAuditLog::create([
'tenant_id' => $tenantId,
'contract_id' => $contract->id,
'action' => 'reminded',
'ip_address' => $request->ip(),
'user_agent' => $request->userAgent(),
'metadata' => [
'reminded_by' => auth()->id(),
'target_signer_id' => $nextSigner?->id,
],
'created_at' => now(),
]);
return response()->json([
'success' => true,
'message' => $nextSigner
? "{$nextSigner->name}에게 리마인더가 발송되었습니다."
: '리마인더가 기록되었습니다.',
]);
}
/**
* PDF 다운로드
*/
public function download(int $id)
{
$tenantId = session('selected_tenant_id', 1);
$contract = EsignContract::forTenant($tenantId)->findOrFail($id);
$filePath = $contract->signed_file_path ?: $contract->original_file_path;
if (! $filePath || ! \Storage::disk('local')->exists($filePath)) {
abort(404, 'PDF 파일을 찾을 수 없습니다.');
}
$fileName = $contract->original_file_name ?: 'contract.pdf';
return \Storage::disk('local')->download($filePath, $fileName, [
'Content-Type' => 'application/pdf',
]);
}
/**
* PDF 업로드 (PDF 없이 생성된 계약에 나중에 업로드)
*/
public function uploadPdf(Request $request, int $id): JsonResponse
{
$request->validate([
'file' => 'required|file|mimes:pdf,doc,docx|max:20480',
]);
$tenantId = session('selected_tenant_id', 1);
$contract = EsignContract::forTenant($tenantId)->findOrFail($id);
if ($contract->original_file_path) {
return response()->json(['success' => false, 'message' => '이미 PDF 파일이 존재합니다.'], 422);
}
$file = $request->file('file');
$converter = new DocxToPdfConverter();
$result = $converter->convertAndStore($file, "esign/{$tenantId}/contracts");
$contract->update([
'original_file_path' => $result['path'],
'original_file_name' => $result['name'],
'original_file_hash' => $result['hash'],
'original_file_size' => $result['size'],
'updated_by' => auth()->id(),
]);
return response()->json([
'success' => true,
'message' => 'PDF 파일이 업로드되었습니다.',
'data' => ['path' => $result['path'], 'name' => $result['name']],
]);
}
/**
* 템플릿 PDF 다운로드
*/
public function downloadTemplatePdf(int $id)
{
$tenantId = session('selected_tenant_id', 1);
$template = EsignFieldTemplate::forTenant($tenantId)->findOrFail($id);
if (!$template->file_path || !Storage::disk('local')->exists($template->file_path)) {
abort(404, 'PDF 파일을 찾을 수 없습니다.');
}
$fileName = $template->file_name ?: 'template.pdf';
return Storage::disk('local')->download($template->file_path, $fileName, [
'Content-Type' => 'application/pdf',
]);
}
// ─── 필드 템플릿 관련 메서드 ───
/**
* 템플릿 목록 조회
*/
public function indexTemplates(Request $request): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$query = EsignFieldTemplate::forTenant($tenantId)
->where('is_active', true);
if ($category = $request->input('category')) {
$query->where('category', $category);
}
if ($search = $request->input('search')) {
$query->where('name', 'like', "%{$search}%");
}
if ($signerCount = $request->input('signer_count')) {
$query->where('signer_count', $signerCount);
}
$templates = $query->withCount('items')->with('creator:id,name')->latest()->get();
return response()->json(['success' => true, 'data' => $templates]);
}
/**
* 템플릿 저장 (현재 필드를 템플릿으로)
*/
public function storeTemplate(Request $request): JsonResponse
{
$request->validate([
'name' => 'required|string|max:100',
'description' => 'nullable|string',
'category' => 'nullable|string|max:50',
'include_pdf' => 'nullable|boolean',
'contract_id' => 'nullable|integer',
'signer_count' => 'nullable|integer|min:1|max:6',
'variables' => 'nullable|array',
'items' => 'nullable|array',
'items.*.signer_order' => 'required|integer|min:1',
'items.*.page_number' => 'required|integer|min:1',
'items.*.position_x' => 'required|numeric',
'items.*.position_y' => 'required|numeric',
'items.*.width' => 'required|numeric',
'items.*.height' => 'required|numeric',
'items.*.field_type' => 'required|in:signature,stamp,text,date,checkbox',
'items.*.field_label' => 'nullable|string|max:100',
'items.*.field_variable' => 'nullable|string|max:50',
'items.*.font_size' => 'nullable|integer|min:6|max:72',
'items.*.text_align' => 'nullable|string|in:L,C,R',
'items.*.is_required' => 'nullable|boolean',
]);
$tenantId = session('selected_tenant_id', 1);
// signer_count 결정: 직접 지정 > items에서 추출 > 기본값 2
$items = $request->input('items', []);
$signerCount = $request->input('signer_count')
?: (count($items) > 0 ? max(array_column($items, 'signer_order')) : 2);
// PDF 포함 여부 확인
$includePdf = $request->boolean('include_pdf');
$contractId = $request->input('contract_id');
$sourceContract = null;
if ($includePdf && $contractId) {
$sourceContract = EsignContract::forTenant($tenantId)->find($contractId);
if (!$sourceContract || !$sourceContract->original_file_path || !Storage::disk('local')->exists($sourceContract->original_file_path)) {
$sourceContract = null;
}
}
$template = DB::transaction(function () use ($tenantId, $request, $items, $signerCount, $sourceContract) {
$fileData = [];
if ($sourceContract) {
$timestamp = now()->format('YmdHis');
$ext = pathinfo($sourceContract->original_file_path, PATHINFO_EXTENSION) ?: 'pdf';
$newPath = "esign/{$tenantId}/templates/{$timestamp}.{$ext}";
Storage::disk('local')->copy($sourceContract->original_file_path, $newPath);
$fileData = [
'file_path' => $newPath,
'file_name' => $sourceContract->original_file_name,
'file_hash' => $sourceContract->original_file_hash,
'file_size' => $sourceContract->original_file_size,
];
}
$template = EsignFieldTemplate::create(array_merge([
'tenant_id' => $tenantId,
'name' => $request->input('name'),
'description' => $request->input('description'),
'category' => $request->input('category'),
'signer_count' => $signerCount,
'variables' => $request->input('variables', []),
'is_active' => true,
'created_by' => auth()->id(),
], $fileData));
foreach ($items as $i => $item) {
EsignFieldTemplateItem::create([
'template_id' => $template->id,
'signer_order' => $item['signer_order'],
'page_number' => $item['page_number'],
'position_x' => $item['position_x'],
'position_y' => $item['position_y'],
'width' => $item['width'],
'height' => $item['height'],
'field_type' => $item['field_type'],
'field_label' => $item['field_label'] ?? null,
'field_variable' => $item['field_variable'] ?? null,
'font_size' => $item['font_size'] ?? null,
'text_align' => $item['text_align'] ?? 'L',
'is_required' => $item['is_required'] ?? true,
'sort_order' => $i,
]);
}
return $template;
});
return response()->json([
'success' => true,
'message' => '필드 템플릿이 저장되었습니다.',
'data' => $template->load('items'),
]);
}
/**
* 템플릿 단건 조회
*/
public function showTemplate(int $id): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$template = EsignFieldTemplate::forTenant($tenantId)
->where('is_active', true)
->with(['items', 'creator:id,name'])
->findOrFail($id);
return response()->json(['success' => true, 'data' => $template]);
}
/**
* 템플릿 메타데이터 수정
*/
public function updateTemplate(Request $request, int $id): JsonResponse
{
$request->validate([
'name' => 'required|string|max:100',
'description' => 'nullable|string',
'category' => 'nullable|string|max:50',
'variables' => 'nullable|array',
'variables.*.key' => 'required|string|max:50',
'variables.*.label' => 'required|string|max:100',
'variables.*.type' => 'nullable|in:text,number,date',
'variables.*.default' => 'nullable|string|max:500',
]);
$tenantId = session('selected_tenant_id', 1);
$template = EsignFieldTemplate::forTenant($tenantId)->findOrFail($id);
$updateData = [
'name' => $request->input('name'),
'description' => $request->input('description'),
'category' => $request->input('category'),
];
if ($request->has('variables')) {
$updateData['variables'] = $request->input('variables');
}
$template->update($updateData);
return response()->json([
'success' => true,
'message' => '템플릿이 수정되었습니다.',
'data' => $template->fresh()->load(['creator:id,name', 'items'])->loadCount('items'),
]);
}
/**
* 템플릿 PDF 교체
*/
public function uploadTemplatePdf(Request $request, int $id): JsonResponse
{
$request->validate([
'file' => 'required|file|mimes:pdf,doc,docx|max:20480',
]);
$tenantId = session('selected_tenant_id', 1);
$template = EsignFieldTemplate::forTenant($tenantId)->findOrFail($id);
// 기존 파일 삭제
if ($template->file_path && Storage::disk('local')->exists($template->file_path)) {
Storage::disk('local')->delete($template->file_path);
}
$file = $request->file('file');
$converter = new DocxToPdfConverter();
$result = $converter->convertAndStore($file, "esign/{$tenantId}/templates");
$template->update([
'file_path' => $result['path'],
'file_name' => $result['name'],
'file_hash' => $result['hash'],
'file_size' => $result['size'],
]);
return response()->json([
'success' => true,
'message' => 'PDF가 교체되었습니다.',
'data' => $template->fresh()->load(['creator:id,name', 'items'])->loadCount('items'),
]);
}
/**
* 템플릿 PDF 제거
*/
public function removeTemplatePdf(int $id): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$template = EsignFieldTemplate::forTenant($tenantId)->findOrFail($id);
if ($template->file_path && Storage::disk('local')->exists($template->file_path)) {
Storage::disk('local')->delete($template->file_path);
}
$template->update([
'file_path' => null,
'file_name' => null,
'file_hash' => null,
'file_size' => null,
]);
return response()->json([
'success' => true,
'message' => 'PDF가 제거되었습니다.',
'data' => $template->fresh()->load(['creator:id,name', 'items'])->loadCount('items'),
]);
}
/**
* 템플릿 필드 아이템 삭제
*/
public function destroyTemplateItem(int $templateId, int $itemId): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$template = EsignFieldTemplate::forTenant($tenantId)->findOrFail($templateId);
$item = EsignFieldTemplateItem::where('template_id', $template->id)->findOrFail($itemId);
$item->delete();
// signer_count 재계산
$maxOrder = EsignFieldTemplateItem::where('template_id', $template->id)->max('signer_order');
$template->update(['signer_count' => $maxOrder ?: 0]);
return response()->json([
'success' => true,
'message' => '필드가 삭제되었습니다.',
'data' => $template->fresh()->load(['creator:id,name', 'items'])->loadCount('items'),
]);
}
/**
* 템플릿 필드 아이템 일괄 저장 (에디터에서 사용)
*/
public function updateTemplateItems(Request $request, int $templateId): JsonResponse
{
$request->validate([
'items' => 'present|array',
'items.*.signer_order' => 'required|integer|min:1',
'items.*.page_number' => 'required|integer|min:1',
'items.*.position_x' => 'required|numeric',
'items.*.position_y' => 'required|numeric',
'items.*.width' => 'required|numeric',
'items.*.height' => 'required|numeric',
'items.*.field_type' => 'required|in:signature,stamp,text,date,checkbox',
'items.*.field_label' => 'nullable|string|max:100',
'items.*.field_variable' => 'nullable|string|max:50',
'items.*.font_size' => 'nullable|integer|min:6|max:72',
'items.*.text_align' => 'nullable|string|in:L,C,R',
'items.*.is_required' => 'nullable|boolean',
]);
$tenantId = session('selected_tenant_id', 1);
$template = EsignFieldTemplate::forTenant($tenantId)->findOrFail($templateId);
$items = $request->input('items', []);
DB::transaction(function () use ($template, $items) {
// 기존 아이템 삭제
EsignFieldTemplateItem::where('template_id', $template->id)->delete();
// 새 아이템 생성
foreach ($items as $i => $itemData) {
EsignFieldTemplateItem::create([
'template_id' => $template->id,
'signer_order' => $itemData['signer_order'],
'page_number' => $itemData['page_number'],
'position_x' => round($itemData['position_x'], 2),
'position_y' => round($itemData['position_y'], 2),
'width' => round($itemData['width'], 2),
'height' => round($itemData['height'], 2),
'field_type' => $itemData['field_type'],
'field_label' => $itemData['field_label'] ?? '',
'field_variable' => $itemData['field_variable'] ?? null,
'font_size' => $itemData['font_size'] ?? null,
'text_align' => $itemData['text_align'] ?? 'L',
'is_required' => $itemData['is_required'] ?? true,
'sort_order' => $i,
]);
}
// signer_count 업데이트
$maxOrder = collect($items)->max('signer_order') ?: 0;
$template->update(['signer_count' => $maxOrder]);
});
return response()->json([
'success' => true,
'message' => '템플릿 필드가 저장되었습니다.',
'data' => $template->fresh()->load('items'),
]);
}
/**
* 템플릿 복제
*/
public function duplicateTemplate(int $id): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$template = EsignFieldTemplate::forTenant($tenantId)
->where('is_active', true)
->with('items')
->findOrFail($id);
$newTemplate = DB::transaction(function () use ($template, $tenantId) {
$fileData = [];
if ($template->file_path && Storage::disk('local')->exists($template->file_path)) {
$timestamp = now()->format('YmdHis');
$ext = pathinfo($template->file_path, PATHINFO_EXTENSION) ?: 'pdf';
$newPath = "esign/{$tenantId}/templates/{$timestamp}_copy.{$ext}";
Storage::disk('local')->copy($template->file_path, $newPath);
$fileData = [
'file_path' => $newPath,
'file_name' => $template->file_name,
'file_hash' => $template->file_hash,
'file_size' => $template->file_size,
];
}
$newTemplate = EsignFieldTemplate::create(array_merge([
'tenant_id' => $tenantId,
'name' => $template->name . ' (복사)',
'description' => $template->description,
'category' => $template->category,
'signer_count' => $template->signer_count,
'variables' => $template->variables,
'is_active' => true,
'created_by' => auth()->id(),
], $fileData));
foreach ($template->items as $item) {
EsignFieldTemplateItem::create([
'template_id' => $newTemplate->id,
'signer_order' => $item->signer_order,
'page_number' => $item->page_number,
'position_x' => $item->position_x,
'position_y' => $item->position_y,
'width' => $item->width,
'height' => $item->height,
'field_type' => $item->field_type,
'field_label' => $item->field_label,
'field_variable' => $item->field_variable,
'font_size' => $item->font_size,
'is_required' => $item->is_required,
'sort_order' => $item->sort_order,
]);
}
return $newTemplate;
});
return response()->json([
'success' => true,
'message' => '템플릿이 복제되었습니다.',
'data' => $newTemplate->load(['items', 'creator:id,name'])->loadCount('items'),
]);
}
/**
* 템플릿 삭제 (soft: is_active=false)
*/
public function destroyTemplate(int $id): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$template = EsignFieldTemplate::forTenant($tenantId)->findOrFail($id);
$template->update(['is_active' => false]);
return response()->json(['success' => true, 'message' => '템플릿이 삭제되었습니다.']);
}
/**
* 템플릿을 계약에 적용
*/
public function applyTemplate(Request $request, int $id): JsonResponse
{
$request->validate([
'template_id' => 'required|integer',
]);
$tenantId = session('selected_tenant_id', 1);
$contract = EsignContract::forTenant($tenantId)->with('signers')->findOrFail($id);
$template = EsignFieldTemplate::forTenant($tenantId)
->where('is_active', true)
->with('items')
->findOrFail($request->input('template_id'));
// 서명자 수 확인
$contractSignerCount = $contract->signers->count();
if ($template->signer_count > $contractSignerCount) {
return response()->json([
'success' => false,
'message' => "템플릿에 필요한 서명자 수({$template->signer_count}명)가 계약의 서명자 수({$contractSignerCount}명)보다 많습니다.",
], 422);
}
// signer_order → signer_id 매핑
$signerMap = [];
foreach ($contract->signers as $signer) {
$signerMap[$signer->sign_order] = $signer->id;
}
// 변수 해석용 맵 구성
$variableValues = $this->buildVariableMap($contract, $template);
DB::transaction(function () use ($contract, $template, $tenantId, $signerMap, $variableValues) {
// 기존 필드 삭제
EsignSignField::where('contract_id', $contract->id)->delete();
// 템플릿 아이템 → 필드 생성
foreach ($template->items as $item) {
$signerId = $signerMap[$item->signer_order] ?? null;
if (!$signerId) continue;
// 변수가 바인딩된 필드는 자동 채움
$fieldValue = null;
if ($item->field_variable && isset($variableValues[$item->field_variable])) {
$fieldValue = $variableValues[$item->field_variable];
}
EsignSignField::create([
'tenant_id' => $tenantId,
'contract_id' => $contract->id,
'signer_id' => $signerId,
'page_number' => $item->page_number,
'position_x' => $item->position_x,
'position_y' => $item->position_y,
'width' => $item->width,
'height' => $item->height,
'field_type' => $item->field_type,
'field_label' => $item->field_label,
'field_variable' => $item->field_variable,
'font_size' => $item->font_size,
'field_value' => $fieldValue,
'is_required' => $item->is_required,
'sort_order' => $item->sort_order,
]);
}
});
$fields = EsignSignField::where('contract_id', $contract->id)->orderBy('sort_order')->get();
return response()->json([
'success' => true,
'message' => '템플릿이 적용되었습니다.',
'data' => $fields,
]);
}
/**
* 다른 계약에서 필드 복사
*/
public function copyFieldsFromContract(Request $request, int $id, int $sourceId): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$targetContract = EsignContract::forTenant($tenantId)->with('signers')->findOrFail($id);
$sourceContract = EsignContract::forTenant($tenantId)->with(['signers', 'signFields'])->findOrFail($sourceId);
if ($sourceContract->signFields->isEmpty()) {
return response()->json([
'success' => false,
'message' => '소스 계약에 복사할 필드가 없습니다.',
], 422);
}
// 소스 계약 서명자의 sign_order → signer_id 매핑
$sourceSignerOrderMap = [];
foreach ($sourceContract->signers as $signer) {
$sourceSignerOrderMap[$signer->id] = $signer->sign_order;
}
// 대상 계약 sign_order → signer_id 매핑
$targetSignerMap = [];
foreach ($targetContract->signers as $signer) {
$targetSignerMap[$signer->sign_order] = $signer->id;
}
DB::transaction(function () use ($targetContract, $sourceContract, $tenantId, $sourceSignerOrderMap, $targetSignerMap) {
// 기존 필드 삭제
EsignSignField::where('contract_id', $targetContract->id)->delete();
foreach ($sourceContract->signFields as $field) {
// 소스 signer_id → sign_order → 대상 signer_id
$signOrder = $sourceSignerOrderMap[$field->signer_id] ?? null;
$targetSignerId = $signOrder ? ($targetSignerMap[$signOrder] ?? null) : null;
if (!$targetSignerId) continue;
EsignSignField::create([
'tenant_id' => $tenantId,
'contract_id' => $targetContract->id,
'signer_id' => $targetSignerId,
'page_number' => $field->page_number,
'position_x' => $field->position_x,
'position_y' => $field->position_y,
'width' => $field->width,
'height' => $field->height,
'field_type' => $field->field_type,
'field_label' => $field->field_label,
'field_variable' => $field->field_variable,
'font_size' => $field->font_size,
'is_required' => $field->is_required,
'sort_order' => $field->sort_order,
]);
}
});
$fields = EsignSignField::where('contract_id', $targetContract->id)->orderBy('sort_order')->get();
return response()->json([
'success' => true,
'message' => '필드가 복사되었습니다.',
'data' => $fields,
]);
}
/**
* 변수 해석 맵 구성 (시스템 변수 + 커스텀 변수)
*/
private function buildVariableMap(EsignContract $contract, EsignFieldTemplate $template): array
{
$map = [];
// 시스템 변수: 서명자 정보 (역할 기반: 1=creator/갑/회사, 2=counterpart/을/파트너)
$signers = $contract->signers->sortBy(fn($s) => $s->role === 'creator' ? 1 : 2);
$idx = 1;
foreach ($signers as $signer) {
$map["signer{$idx}_name"] = $signer->name;
$map["signer{$idx}_email"] = $signer->email;
$map["signer{$idx}_phone"] = $signer->phone ?? '';
$idx++;
}
// 시스템 변수: 계약 정보
$map['contract_title'] = $contract->title ?? '';
$map['current_date'] = now()->format('Y년 n월 j일');
$map['expires_at'] = $contract->expires_at ? $contract->expires_at->format('Y년 n월 j일') : '';
// 커스텀 변수: contract.metadata에서 조회
$metadata = $contract->metadata ?? [];
foreach ($metadata as $key => $value) {
$map[$key] = $value ?? '';
}
return $map;
}
}