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

feat: 구독/결제 API 확장 (Plan, Subscription, Payment)

Browse Source 
- Plan/Subscription/Payment 모델에 상태 상수, 스코프, 헬퍼 메서드 추가
- PlanService, SubscriptionService, PaymentService 생성
- PlanController, SubscriptionController, PaymentController 생성
- FormRequest 9개 생성 (Plan 3개, Subscription 3개, Payment 3개)
- Swagger 문서 3개 생성 (PlanApi, SubscriptionApi, PaymentApi)
- API 라우트 22개 등록 (Plan 7개, Subscription 8개, Payment 7개)
- Pint 코드 스타일 정리
This commit is contained in:
권혁성
2025-12-18 16:20:29 +09:00
parent 7278c4742f
commit 45780ea351
35 changed files with 3025 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
app/Http/Controllers/Api/V1/BankAccountController.php
View File

@@ -2,10 +2,10 @@
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\BankAccount\StoreBankAccountRequest;
use App\Http\Requests\V1\BankAccount\UpdateBankAccountRequest;
use App\Helpers\ApiResponse;
use App\Services\BankAccountService;
use Illuminate\Http\Request;

2
app/Http/Controllers/Api/V1/CardController.php
View File

@@ -2,10 +2,10 @@
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Card\StoreCardRequest;
use App\Http\Requests\V1\Card\UpdateCardRequest;
use App\Helpers\ApiResponse;
use App\Services\CardService;
use Illuminate\Http\Request;

2
app/Http/Controllers/Api/V1/DepositController.php
View File

@@ -2,10 +2,10 @@
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Deposit\StoreDepositRequest;
use App\Http\Requests\V1\Deposit\UpdateDepositRequest;
use App\Helpers\ApiResponse;
use App\Services\DepositService;
use Illuminate\Http\Request;

88
app/Http/Controllers/Api/V1/PaymentController.php Normal file
View File

@@ -0,0 +1,88 @@
<?php
namespace App\Http\Controllers\Api\V1;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Payment\PaymentActionRequest;
use App\Http\Requests\V1\Payment\PaymentIndexRequest;
use App\Http\Requests\V1\Payment\PaymentStoreRequest;
use App\Http\Response\ApiResponse;
use App\Services\PaymentService;
use Illuminate\Http\JsonResponse;
class PaymentController extends Controller
{
public function __construct(
private readonly PaymentService $paymentService
) {}
/**
* 결제 목록
*/
public function index(PaymentIndexRequest $request): JsonResponse
{
$result = $this->paymentService->index($request->validated());
return ApiResponse::handle('message.fetched', $result);
}
/**
* 결제 요약 통계
*/
public function summary(PaymentIndexRequest $request): JsonResponse
{
$result = $this->paymentService->summary($request->validated());
return ApiResponse::handle('message.fetched', $result);
}
/**
* 결제 상세
*/
public function show(int $id): JsonResponse
{
$result = $this->paymentService->show($id);
return ApiResponse::handle('message.fetched', $result);
}
/**
* 결제 등록 (수동)
*/
public function store(PaymentStoreRequest $request): JsonResponse
{
$result = $this->paymentService->store($request->validated());
return ApiResponse::handle('message.created', $result, 201);
}
/**
* 결제 완료 처리
*/
public function complete(PaymentActionRequest $request, int $id): JsonResponse
{
$result = $this->paymentService->complete($id, $request->validated()['transaction_id'] ?? null);
return ApiResponse::handle('message.payment.completed', $result);
}
/**
* 결제 취소
*/
public function cancel(PaymentActionRequest $request, int $id): JsonResponse
{
$result = $this->paymentService->cancel($id, $request->validated()['reason'] ?? null);
return ApiResponse::handle('message.payment.cancelled', $result);
}
/**
* 환불 처리
*/
public function refund(PaymentActionRequest $request, int $id): JsonResponse
{
$result = $this->paymentService->refund($id, $request->validated()['reason'] ?? null);
return ApiResponse::handle('message.payment.refunded', $result);
}
}

2
app/Http/Controllers/Api/V1/PayrollController.php
View File

@@ -2,13 +2,13 @@
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Payroll\CalculatePayrollRequest;
use App\Http\Requests\V1\Payroll\PayPayrollRequest;
use App\Http\Requests\V1\Payroll\StorePayrollRequest;
use App\Http\Requests\V1\Payroll\UpdatePayrollRequest;
use App\Http\Requests\V1\Payroll\UpdatePayrollSettingRequest;
use App\Helpers\ApiResponse;
use App\Services\PayrollService;
use Illuminate\Http\Request;

88
app/Http/Controllers/Api/V1/PlanController.php Normal file
View File

@@ -0,0 +1,88 @@
<?php
namespace App\Http\Controllers\Api\V1;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Plan\PlanIndexRequest;
use App\Http\Requests\V1\Plan\PlanStoreRequest;
use App\Http\Requests\V1\Plan\PlanUpdateRequest;
use App\Http\Response\ApiResponse;
use App\Services\PlanService;
use Illuminate\Http\JsonResponse;
class PlanController extends Controller
{
public function __construct(
private readonly PlanService $planService
) {}
/**
* 요금제 목록 (관리자용)
*/
public function index(PlanIndexRequest $request): JsonResponse
{
$result = $this->planService->index($request->validated());
return ApiResponse::handle('message.fetched', $result);
}
/**
* 활성 요금제 목록 (공개용)
*/
public function active(): JsonResponse
{
$result = $this->planService->active();
return ApiResponse::handle('message.fetched', $result);
}
/**
* 요금제 등록
*/
public function store(PlanStoreRequest $request): JsonResponse
{
$result = $this->planService->store($request->validated());
return ApiResponse::handle('message.created', $result, 201);
}
/**
* 요금제 상세
*/
public function show(int $id): JsonResponse
{
$result = $this->planService->show($id);
return ApiResponse::handle('message.fetched', $result);
}
/**
* 요금제 수정
*/
public function update(PlanUpdateRequest $request, int $id): JsonResponse
{
$result = $this->planService->update($id, $request->validated());
return ApiResponse::handle('message.updated', $result);
}
/**
* 요금제 삭제
*/
public function destroy(int $id): JsonResponse
{
$this->planService->destroy($id);
return ApiResponse::handle('message.deleted');
}
/**
* 요금제 활성/비활성 토글
*/
public function toggle(int $id): JsonResponse
{
$result = $this->planService->toggle($id);
return ApiResponse::handle('message.updated', $result);
}
}

2
app/Http/Controllers/Api/V1/PurchaseController.php
View File

@@ -2,10 +2,10 @@
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Purchase\StorePurchaseRequest;
use App\Http\Requests\V1\Purchase\UpdatePurchaseRequest;
use App\Helpers\ApiResponse;
use App\Services\PurchaseService;
use Illuminate\Http\Request;

2
app/Http/Controllers/Api/V1/ReportController.php
View File

@@ -4,10 +4,10 @@
use App\Exports\DailyReportExport;
use App\Exports\ExpenseEstimateExport;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Report\DailyReportRequest;
use App\Http\Requests\V1\Report\ExpenseEstimateRequest;
use App\Helpers\ApiResponse;
use App\Services\ReportService;
use Maatwebsite\Excel\Facades\Excel;

2
app/Http/Controllers/Api/V1/SaleController.php
View File

@@ -2,10 +2,10 @@
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Sale\StoreSaleRequest;
use App\Http\Requests\V1\Sale\UpdateSaleRequest;
use App\Helpers\ApiResponse;
use App\Services\SaleService;
use Illuminate\Http\Request;

2
app/Http/Controllers/Api/V1/SiteController.php
View File

@@ -2,10 +2,10 @@
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Site\StoreSiteRequest;
use App\Http\Requests\V1\Site\UpdateSiteRequest;
use App\Helpers\ApiResponse;
use App\Services\SiteService;
use Illuminate\Http\Request;

98
app/Http/Controllers/Api/V1/SubscriptionController.php Normal file
View File

@@ -0,0 +1,98 @@
<?php
namespace App\Http\Controllers\Api\V1;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Subscription\SubscriptionCancelRequest;
use App\Http\Requests\V1\Subscription\SubscriptionIndexRequest;
use App\Http\Requests\V1\Subscription\SubscriptionStoreRequest;
use App\Http\Response\ApiResponse;
use App\Services\SubscriptionService;
use Illuminate\Http\JsonResponse;
class SubscriptionController extends Controller
{
public function __construct(
private readonly SubscriptionService $subscriptionService
) {}
/**
* 구독 목록
*/
public function index(SubscriptionIndexRequest $request): JsonResponse
{
$result = $this->subscriptionService->index($request->validated());
return ApiResponse::handle('message.fetched', $result);
}
/**
* 현재 활성 구독
*/
public function current(): JsonResponse
{
$result = $this->subscriptionService->current();
return ApiResponse::handle('message.fetched', $result);
}
/**
* 구독 등록
*/
public function store(SubscriptionStoreRequest $request): JsonResponse
{
$result = $this->subscriptionService->store($request->validated());
return ApiResponse::handle('message.created', $result, 201);
}
/**
* 구독 상세
*/
public function show(int $id): JsonResponse
{
$result = $this->subscriptionService->show($id);
return ApiResponse::handle('message.fetched', $result);
}
/**
* 구독 취소
*/
public function cancel(SubscriptionCancelRequest $request, int $id): JsonResponse
{
$result = $this->subscriptionService->cancel($id, $request->validated()['reason'] ?? null);
return ApiResponse::handle('message.subscription.cancelled', $result);
}
/**
* 구독 갱신
*/
public function renew(SubscriptionStoreRequest $request, int $id): JsonResponse
{
$result = $this->subscriptionService->renew($id, $request->validated());
return ApiResponse::handle('message.subscription.renewed', $result);
}
/**
* 구독 일시정지
*/
public function suspend(int $id): JsonResponse
{
$result = $this->subscriptionService->suspend($id);
return ApiResponse::handle('message.subscription.suspended', $result);
}
/**
* 구독 재개
*/
public function resume(int $id): JsonResponse
{
$result = $this->subscriptionService->resume($id);
return ApiResponse::handle('message.subscription.resumed', $result);
}
}

2
app/Http/Controllers/Api/V1/WithdrawalController.php
View File

@@ -2,10 +2,10 @@
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Withdrawal\StoreWithdrawalRequest;
use App\Http\Requests\V1\Withdrawal\UpdateWithdrawalRequest;
use App\Helpers\ApiResponse;
use App\Services\WithdrawalService;
use Illuminate\Http\Request;

2
app/Http/Controllers/Api/V1/WorkSettingController.php
View File

@@ -2,10 +2,10 @@
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\WorkSetting\UpdateAttendanceSettingRequest;
use App\Http\Requests\V1\WorkSetting\UpdateWorkSettingRequest;
use App\Helpers\ApiResponse;
use App\Services\WorkSettingService;
class WorkSettingController extends Controller