feat: [approval] 전자결재 모듈 API 구현

- 마이그레이션 4개 (approval_forms, approval_lines, approvals, approval_steps)
- 모델 4개 (ApprovalForm, ApprovalLine, Approval, ApprovalStep)
- ApprovalService 비즈니스 로직 (양식/결재선 CRUD, 기안함/결재함/참조함, 결재 액션)
- 컨트롤러 3개 (ApprovalFormController, ApprovalLineController, ApprovalController)
- FormRequest 13개 (양식/결재선/문서 검증)
- Swagger 문서 3개 (26개 엔드포인트)
- i18n 메시지/에러 키 추가
- 라우트 26개 등록

app/Http/Controllers/Api/V1/ApprovalController.php

@@ -0,0 +1,186 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Approval\InboxIndexRequest;
+use App\Http\Requests\Approval\IndexRequest;
+use App\Http\Requests\Approval\ReferenceIndexRequest;
+use App\Http\Requests\Approval\RejectRequest;
+use App\Http\Requests\Approval\StoreRequest;
+use App\Http\Requests\Approval\SubmitRequest;
+use App\Http\Requests\Approval\UpdateRequest;
+use App\Services\ApprovalService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ApprovalController extends Controller
+{
+    public function __construct(private ApprovalService $service) {}
+
+    /**
+     * 기안함 - 내가 기안한 문서 목록
+     * GET /v1/approvals/drafts
+     */
+    public function drafts(IndexRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->drafts($request->validated());
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 기안함 현황 카드
+     * GET /v1/approvals/drafts/summary
+     */
+    public function draftsSummary(): JsonResponse
+    {
+        return ApiResponse::handle(function () {
+            return $this->service->draftsSummary();
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 결재함 - 내가 결재해야 할 문서 목록
+     * GET /v1/approvals/inbox
+     */
+    public function inbox(InboxIndexRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->inbox($request->validated());
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 결재함 현황 카드
+     * GET /v1/approvals/inbox/summary
+     */
+    public function inboxSummary(): JsonResponse
+    {
+        return ApiResponse::handle(function () {
+            return $this->service->inboxSummary();
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 참조함 - 내가 참조된 문서 목록
+     * GET /v1/approvals/reference
+     */
+    public function reference(ReferenceIndexRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->reference($request->validated());
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 결재 문서 상세
+     * GET /v1/approvals/{id}
+     */
+    public function show(int $id): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->show($id);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 결재 문서 생성 (임시저장 또는 상신)
+     * POST /v1/approvals
+     */
+    public function store(StoreRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->store($request->validated());
+        }, __('message.approval.created'));
+    }
+
+    /**
+     * 결재 문서 수정 (임시저장 상태만)
+     * PATCH /v1/approvals/{id}
+     */
+    public function update(int $id, UpdateRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            return $this->service->update($id, $request->validated());
+        }, __('message.updated'));
+    }
+
+    /**
+     * 결재 문서 삭제 (임시저장 상태만)
+     * DELETE /v1/approvals/{id}
+     */
+    public function destroy(int $id): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->destroy($id);
+        }, __('message.deleted'));
+    }
+
+    /**
+     * 결재 상신
+     * POST /v1/approvals/{id}/submit
+     */
+    public function submit(int $id, SubmitRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            return $this->service->submit($id, $request->validated());
+        }, __('message.approval.submitted'));
+    }
+
+    /**
+     * 결재 승인
+     * POST /v1/approvals/{id}/approve
+     */
+    public function approve(int $id, Request $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            return $this->service->approve($id, $request->input('comment'));
+        }, __('message.approval.approved'));
+    }
+
+    /**
+     * 결재 반려
+     * POST /v1/approvals/{id}/reject
+     */
+    public function reject(int $id, RejectRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            return $this->service->reject($id, $request->input('comment'));
+        }, __('message.approval.rejected'));
+    }
+
+    /**
+     * 결재 회수 (기안자만)
+     * POST /v1/approvals/{id}/cancel
+     */
+    public function cancel(int $id): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->cancel($id);
+        }, __('message.approval.cancelled'));
+    }
+
+    /**
+     * 참조 열람 처리
+     * POST /v1/approvals/{id}/read
+     */
+    public function markRead(int $id): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->markRead($id);
+        }, __('message.approval.marked_read'));
+    }
+
+    /**
+     * 참조 미열람 처리
+     * POST /v1/approvals/{id}/unread
+     */
+    public function markUnread(int $id): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->markUnread($id);
+        }, __('message.approval.marked_unread'));
+    }
+}

app/Http/Controllers/Api/V1/ApprovalFormController.php

@@ -0,0 +1,82 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Approval\FormIndexRequest;
+use App\Http\Requests\Approval\FormStoreRequest;
+use App\Http\Requests\Approval\FormUpdateRequest;
+use App\Services\ApprovalService;
+use Illuminate\Http\JsonResponse;
+
+class ApprovalFormController extends Controller
+{
+    public function __construct(private ApprovalService $service) {}
+
+    /**
+     * 결재 양식 목록
+     * GET /v1/approval-forms
+     */
+    public function index(FormIndexRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->formIndex($request->validated());
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 활성 결재 양식 목록 (셀렉트박스용)
+     * GET /v1/approval-forms/active
+     */
+    public function active(): JsonResponse
+    {
+        return ApiResponse::handle(function () {
+            return $this->service->formActive();
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 결재 양식 상세
+     * GET /v1/approval-forms/{id}
+     */
+    public function show(int $id): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->formShow($id);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 결재 양식 생성
+     * POST /v1/approval-forms
+     */
+    public function store(FormStoreRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->formStore($request->validated());
+        }, __('message.approval.form_created'));
+    }
+
+    /**
+     * 결재 양식 수정
+     * PATCH /v1/approval-forms/{id}
+     */
+    public function update(int $id, FormUpdateRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            return $this->service->formUpdate($id, $request->validated());
+        }, __('message.updated'));
+    }
+
+    /**
+     * 결재 양식 삭제
+     * DELETE /v1/approval-forms/{id}
+     */
+    public function destroy(int $id): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->formDestroy($id);
+        }, __('message.deleted'));
+    }
+}

app/Http/Controllers/Api/V1/ApprovalLineController.php

@@ -0,0 +1,71 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Approval\LineIndexRequest;
+use App\Http\Requests\Approval\LineStoreRequest;
+use App\Http\Requests\Approval\LineUpdateRequest;
+use App\Services\ApprovalService;
+use Illuminate\Http\JsonResponse;
+
+class ApprovalLineController extends Controller
+{
+    public function __construct(private ApprovalService $service) {}
+
+    /**
+     * 결재선 목록
+     * GET /v1/approval-lines
+     */
+    public function index(LineIndexRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->lineIndex($request->validated());
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 결재선 상세
+     * GET /v1/approval-lines/{id}
+     */
+    public function show(int $id): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->lineShow($id);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 결재선 생성
+     * POST /v1/approval-lines
+     */
+    public function store(LineStoreRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->lineStore($request->validated());
+        }, __('message.approval.line_created'));
+    }
+
+    /**
+     * 결재선 수정
+     * PATCH /v1/approval-lines/{id}
+     */
+    public function update(int $id, LineUpdateRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            return $this->service->lineUpdate($id, $request->validated());
+        }, __('message.updated'));
+    }
+
+    /**
+     * 결재선 삭제
+     * DELETE /v1/approval-lines/{id}
+     */
+    public function destroy(int $id): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->lineDestroy($id);
+        }, __('message.deleted'));
+    }
+}