feat: Phase 5 API 개발 완료 (사용자 초대, 알림설정, 계정관리, 거래명세서)

5.1 사용자 초대 기능:
- UserInvitation 마이그레이션, 모델, 서비스, 컨트롤러, Swagger
- 초대 발송/수락/취소/재발송 API

5.2 알림설정 확장:
- NotificationSetting 마이그레이션, 모델, 서비스, 컨트롤러, Swagger
- 채널별/유형별 알림 설정 관리

5.3 계정정보 수정 API:
- 회원탈퇴, 사용중지, 약관동의 관리
- AccountService, AccountController, Swagger

5.4 매출 거래명세서 API:
- 거래명세서 조회/발행/이메일발송
- SaleService 확장, Swagger 문서화

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

@@ -0,0 +1,61 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Account\UpdateAgreementsRequest;
+use App\Http\Requests\Account\WithdrawRequest;
+use App\Services\AccountService;
+use Illuminate\Http\JsonResponse;
+
+class AccountController extends Controller
+{
+    public function __construct(
+        private readonly AccountService $service
+    ) {}
+
+    /**
+     * 회원 탈퇴 (SAM 완전 탈퇴)
+     */
+    public function withdraw(WithdrawRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->withdraw($request->validated()),
+            __('message.account.withdrawn')
+        );
+    }
+
+    /**
+     * 사용 중지 (특정 테넌트에서만 탈퇴)
+     */
+    public function suspend(): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->suspend(),
+            __('message.account.suspended')
+        );
+    }
+
+    /**
+     * 약관 동의 정보 조회
+     */
+    public function getAgreements(): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->getAgreements(),
+            __('message.fetched')
+        );
+    }
+
+    /**
+     * 약관 동의 정보 수정
+     */
+    public function updateAgreements(UpdateAgreementsRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->updateAgreements($request->validated()),
+            __('message.updated')
+        );
+    }
+}

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

@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\NotificationSetting\BulkUpdateSettingRequest;
+use App\Http\Requests\NotificationSetting\UpdateSettingRequest;
+use App\Services\NotificationSettingService;
+use Illuminate\Http\JsonResponse;
+
+class NotificationSettingController extends Controller
+{
+    public function __construct(
+        private readonly NotificationSettingService $service
+    ) {}
+
+    /**
+     * 알림 설정 조회
+     */
+    public function index(): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->getSettings(),
+            __('message.fetched')
+        );
+    }
+
+    /**
+     * 알림 설정 업데이트 (단일)
+     */
+    public function update(UpdateSettingRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->updateSetting($request->validated()),
+            __('message.updated')
+        );
+    }
+
+    /**
+     * 알림 설정 일괄 업데이트
+     */
+    public function bulkUpdate(BulkUpdateSettingRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->bulkUpdateSettings($request->validated()['settings']),
+            __('message.bulk_upsert')
+        );
+    }
+}

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

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers\Api\V1;
 
+use App\Helpers\ApiResponse;
 use App\Http\Controllers\Controller;
 use App\Http\Requests\Push\RegisterTokenRequest;
 use App\Http\Requests\Push\UpdateSettingsRequest;
 use App\Services\PushNotificationService;
-use App\Helpers\ApiResponse;
 use Illuminate\Http\Request;
 
 class PushNotificationController extends Controller

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

@@ -4,6 +4,7 @@
 
 use App\Helpers\ApiResponse;
 use App\Http\Controllers\Controller;
+use App\Http\Requests\V1\Sale\SendStatementRequest;
 use App\Http\Requests\V1\Sale\StoreSaleRequest;
 use App\Http\Requests\V1\Sale\UpdateSaleRequest;
 use App\Services\SaleService;
@@ -103,4 +104,34 @@ public function summary(Request $request)
 
         return ApiResponse::success($summary, __('message.fetched'));
     }
+
+    /**
+     * 거래명세서 조회
+     */
+    public function getStatement(int $id)
+    {
+        $statement = $this->service->getStatement($id);
+
+        return ApiResponse::success($statement, __('message.fetched'));
+    }
+
+    /**
+     * 거래명세서 발행
+     */
+    public function issueStatement(int $id)
+    {
+        $result = $this->service->issueStatement($id);
+
+        return ApiResponse::success($result, __('message.sale.statement_issued'));
+    }
+
+    /**
+     * 거래명세서 이메일 발송
+     */
+    public function sendStatement(int $id, SendStatementRequest $request)
+    {
+        $result = $this->service->sendStatement($id, $request->validated());
+
+        return ApiResponse::success($result, __('message.sale.statement_sent'));
+    }
 }

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

@@ -0,0 +1,73 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\UserInvitation\AcceptInvitationRequest;
+use App\Http\Requests\UserInvitation\InviteUserRequest;
+use App\Http\Requests\UserInvitation\ListInvitationRequest;
+use App\Services\UserInvitationService;
+use Illuminate\Http\JsonResponse;
+
+class UserInvitationController extends Controller
+{
+    public function __construct(
+        private readonly UserInvitationService $service
+    ) {}
+
+    /**
+     * 초대 목록 조회
+     */
+    public function index(ListInvitationRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->index($request->validated()),
+            __('message.fetched')
+        );
+    }
+
+    /**
+     * 사용자 초대 발송
+     */
+    public function invite(InviteUserRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->invite($request->validated()),
+            __('message.invitation.sent')
+        );
+    }
+
+    /**
+     * 초대 수락
+     */
+    public function accept(string $token, AcceptInvitationRequest $request): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->accept($token, $request->validated()),
+            __('message.invitation.accepted')
+        );
+    }
+
+    /**
+     * 초대 취소
+     */
+    public function cancel(int $id): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->cancel($id),
+            __('message.invitation.cancelled')
+        );
+    }
+
+    /**
+     * 초대 재발송
+     */
+    public function resend(int $id): JsonResponse
+    {
+        return ApiResponse::handle(
+            fn () => $this->service->resend($id),
+            __('message.invitation.resent')
+        );
+    }
+}