feat: 2.3 카드/계좌 관리 API 구현

- cards, bank_accounts 테이블 마이그레이션
- Card, BankAccount 모델 (카드번호 암호화)
- CardService, BankAccountService
- CardController, BankAccountController + FormRequest 4개
- API 엔드포인트 15개 (카드 7개, 계좌 8개)
- Swagger 문서 (CardApi.php, BankAccountApi.php)
This commit is contained in:
2025-12-17 21:02:20 +09:00
parent a1980adb20
commit e1b0c99d5d
15 changed files with 1916 additions and 0 deletions

View File

@@ -0,0 +1,53 @@
<?php
namespace App\Http\Requests\V1\BankAccount;
use Illuminate\Foundation\Http\FormRequest;
class StoreBankAccountRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'bank_code' => ['required', 'string', 'max:10'],
'bank_name' => ['required', 'string', 'max:50'],
'account_number' => ['required', 'string', 'max:30', 'regex:/^[\d-]+$/'],
'account_holder' => ['required', 'string', 'max:50'],
'account_name' => ['required', 'string', 'max:100'],
'status' => ['nullable', 'string', 'in:active,inactive'],
'assigned_user_id' => ['nullable', 'integer', 'exists:users,id'],
'is_primary' => ['nullable', 'boolean'],
];
}
public function messages(): array
{
return [
'bank_code.required' => __('validation.required', ['attribute' => __('validation.attributes.bank_code')]),
'bank_name.required' => __('validation.required', ['attribute' => __('validation.attributes.bank_name')]),
'account_number.required' => __('validation.required', ['attribute' => __('validation.attributes.account_number')]),
'account_number.regex' => __('validation.account_number_format'),
'account_holder.required' => __('validation.required', ['attribute' => __('validation.attributes.account_holder')]),
'account_name.required' => __('validation.required', ['attribute' => __('validation.attributes.account_name')]),
];
}
public function attributes(): array
{
return [
'bank_code' => __('validation.attributes.bank_code'),
'bank_name' => __('validation.attributes.bank_name'),
'account_number' => __('validation.attributes.account_number'),
'account_holder' => __('validation.attributes.account_holder'),
'account_name' => __('validation.attributes.account_name'),
'status' => __('validation.attributes.status'),
'assigned_user_id' => __('validation.attributes.assigned_user_id'),
'is_primary' => __('validation.attributes.is_primary'),
];
}
}

View File

@@ -0,0 +1,46 @@
<?php
namespace App\Http\Requests\V1\BankAccount;
use Illuminate\Foundation\Http\FormRequest;
class UpdateBankAccountRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'bank_code' => ['sometimes', 'string', 'max:10'],
'bank_name' => ['sometimes', 'string', 'max:50'],
'account_number' => ['sometimes', 'string', 'max:30', 'regex:/^[\d-]+$/'],
'account_holder' => ['sometimes', 'string', 'max:50'],
'account_name' => ['sometimes', 'string', 'max:100'],
'status' => ['sometimes', 'string', 'in:active,inactive'],
'assigned_user_id' => ['nullable', 'integer', 'exists:users,id'],
];
}
public function messages(): array
{
return [
'account_number.regex' => __('validation.account_number_format'),
];
}
public function attributes(): array
{
return [
'bank_code' => __('validation.attributes.bank_code'),
'bank_name' => __('validation.attributes.bank_name'),
'account_number' => __('validation.attributes.account_number'),
'account_holder' => __('validation.attributes.account_holder'),
'account_name' => __('validation.attributes.account_name'),
'status' => __('validation.attributes.status'),
'assigned_user_id' => __('validation.attributes.assigned_user_id'),
];
}
}

View File

@@ -0,0 +1,53 @@
<?php
namespace App\Http\Requests\V1\Card;
use Illuminate\Foundation\Http\FormRequest;
class StoreCardRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'card_company' => ['required', 'string', 'max:50'],
'card_number' => ['required', 'string', 'regex:/^\d{13,19}$/'],
'expiry_date' => ['required', 'string', 'regex:/^(0[1-9]|1[0-2])\/\d{2}$/'],
'card_password' => ['nullable', 'string', 'size:2', 'regex:/^\d{2}$/'],
'card_name' => ['required', 'string', 'max:100'],
'status' => ['nullable', 'string', 'in:active,inactive'],
'assigned_user_id' => ['nullable', 'integer', 'exists:users,id'],
];
}
public function messages(): array
{
return [
'card_company.required' => __('validation.required', ['attribute' => __('validation.attributes.card_company')]),
'card_number.required' => __('validation.required', ['attribute' => __('validation.attributes.card_number')]),
'card_number.regex' => __('validation.card_number_format'),
'expiry_date.required' => __('validation.required', ['attribute' => __('validation.attributes.expiry_date')]),
'expiry_date.regex' => __('validation.expiry_date_format'),
'card_password.size' => __('validation.card_password_format'),
'card_password.regex' => __('validation.card_password_format'),
'card_name.required' => __('validation.required', ['attribute' => __('validation.attributes.card_name')]),
];
}
public function attributes(): array
{
return [
'card_company' => __('validation.attributes.card_company'),
'card_number' => __('validation.attributes.card_number'),
'expiry_date' => __('validation.attributes.expiry_date'),
'card_password' => __('validation.attributes.card_password'),
'card_name' => __('validation.attributes.card_name'),
'status' => __('validation.attributes.status'),
'assigned_user_id' => __('validation.attributes.assigned_user_id'),
];
}
}

View File

@@ -0,0 +1,49 @@
<?php
namespace App\Http\Requests\V1\Card;
use Illuminate\Foundation\Http\FormRequest;
class UpdateCardRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'card_company' => ['sometimes', 'string', 'max:50'],
'card_number' => ['sometimes', 'string', 'regex:/^\d{13,19}$/'],
'expiry_date' => ['sometimes', 'string', 'regex:/^(0[1-9]|1[0-2])\/\d{2}$/'],
'card_password' => ['nullable', 'string', 'size:2', 'regex:/^\d{2}$/'],
'card_name' => ['sometimes', 'string', 'max:100'],
'status' => ['sometimes', 'string', 'in:active,inactive'],
'assigned_user_id' => ['nullable', 'integer', 'exists:users,id'],
];
}
public function messages(): array
{
return [
'card_number.regex' => __('validation.card_number_format'),
'expiry_date.regex' => __('validation.expiry_date_format'),
'card_password.size' => __('validation.card_password_format'),
'card_password.regex' => __('validation.card_password_format'),
];
}
public function attributes(): array
{
return [
'card_company' => __('validation.attributes.card_company'),
'card_number' => __('validation.attributes.card_number'),
'expiry_date' => __('validation.attributes.expiry_date'),
'card_password' => __('validation.attributes.card_password'),
'card_name' => __('validation.attributes.card_name'),
'status' => __('validation.attributes.status'),
'assigned_user_id' => __('validation.attributes.assigned_user_id'),
];
}
}