feat: Phase 3.8 바로빌 세금계산서 연동 API 구현

- 마이그레이션: barobill_settings, tax_invoices 테이블 생성 - 모델: BarobillSetting (인증서 암호화), TaxInvoice (상태/유형 상수) - 서비스: BarobillService (API 연동), TaxInvoiceService (CRUD, 발행/취소) - 컨트롤러: BarobillSettingController, TaxInvoiceController - FormRequest: 6개 요청 검증 클래스 - Swagger: API 문서 완성 (BarobillSettingApi, TaxInvoiceApi)
2025-12-18 15:31:59 +09:00
parent 9b3dd2f4b8
commit 8ad4d7c0ce
17 changed files with 2425 additions and 0 deletions
--- a/app/Http/Controllers/Api/V1/TaxInvoiceController.php
+++ b/app/Http/Controllers/Api/V1/TaxInvoiceController.php
@@ -0,0 +1,137 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\TaxInvoice\CancelTaxInvoiceRequest;
+use App\Http\Requests\TaxInvoice\CreateTaxInvoiceRequest;
+use App\Http\Requests\TaxInvoice\TaxInvoiceListRequest;
+use App\Http\Requests\TaxInvoice\TaxInvoiceSummaryRequest;
+use App\Http\Requests\TaxInvoice\UpdateTaxInvoiceRequest;
+use App\Services\TaxInvoiceService;
+
+class TaxInvoiceController extends Controller
+{
+    public function __construct(
+        private TaxInvoiceService $taxInvoiceService
+    ) {}
+
+    /**
+     * 세금계산서 목록 조회
+     */
+    public function index(TaxInvoiceListRequest $request)
+    {
+        $taxInvoices = $this->taxInvoiceService->list($request->validated());
+
+        return ApiResponse::handle(
+            data: $taxInvoices,
+            message: __('message.fetched')
+        );
+    }
+
+    /**
+     * 세금계산서 상세 조회
+     */
+    public function show(int $id)
+    {
+        $taxInvoice = $this->taxInvoiceService->show($id);
+
+        return ApiResponse::handle(
+            data: $taxInvoice,
+            message: __('message.fetched')
+        );
+    }
+
+    /**
+     * 세금계산서 생성
+     */
+    public function store(CreateTaxInvoiceRequest $request)
+    {
+        $taxInvoice = $this->taxInvoiceService->create($request->validated());
+
+        return ApiResponse::handle(
+            data: $taxInvoice,
+            message: __('message.created'),
+            status: 201
+        );
+    }
+
+    /**
+     * 세금계산서 수정
+     */
+    public function update(UpdateTaxInvoiceRequest $request, int $id)
+    {
+        $taxInvoice = $this->taxInvoiceService->update($id, $request->validated());
+
+        return ApiResponse::handle(
+            data: $taxInvoice,
+            message: __('message.updated')
+        );
+    }
+
+    /**
+     * 세금계산서 삭제
+     */
+    public function destroy(int $id)
+    {
+        $this->taxInvoiceService->delete($id);
+
+        return ApiResponse::handle(
+            data: null,
+            message: __('message.deleted')
+        );
+    }
+
+    /**
+     * 세금계산서 발행
+     */
+    public function issue(int $id)
+    {
+        $taxInvoice = $this->taxInvoiceService->issue($id);
+
+        return ApiResponse::handle(
+            data: $taxInvoice,
+            message: __('message.tax_invoice.issued')
+        );
+    }
+
+    /**
+     * 세금계산서 취소
+     */
+    public function cancel(CancelTaxInvoiceRequest $request, int $id)
+    {
+        $taxInvoice = $this->taxInvoiceService->cancel($id, $request->validated()['reason']);
+
+        return ApiResponse::handle(
+            data: $taxInvoice,
+            message: __('message.tax_invoice.cancelled')
+        );
+    }
+
+    /**
+     * 국세청 전송 상태 조회
+     */
+    public function checkStatus(int $id)
+    {
+        $taxInvoice = $this->taxInvoiceService->checkStatus($id);
+
+        return ApiResponse::handle(
+            data: $taxInvoice,
+            message: __('message.fetched')
+        );
+    }
+
+    /**
+     * 세금계산서 요약 통계
+     */
+    public function summary(TaxInvoiceSummaryRequest $request)
+    {
+        $summary = $this->taxInvoiceService->summary($request->validated());
+
+        return ApiResponse::handle(
+            data: $summary,
+            message: __('message.fetched')
+        );
+    }
+}