feat: Phase 5 API 개발 완료 (사용자 초대, 알림설정, 계정관리, 거래명세서)
5.1 사용자 초대 기능: - UserInvitation 마이그레이션, 모델, 서비스, 컨트롤러, Swagger - 초대 발송/수락/취소/재발송 API 5.2 알림설정 확장: - NotificationSetting 마이그레이션, 모델, 서비스, 컨트롤러, Swagger - 채널별/유형별 알림 설정 관리 5.3 계정정보 수정 API: - 회원탈퇴, 사용중지, 약관동의 관리 - AccountService, AccountController, Swagger 5.4 매출 거래명세서 API: - 거래명세서 조회/발행/이메일발송 - SaleService 확장, Swagger 문서화
This commit is contained in:
61
app/Http/Controllers/Api/V1/AccountController.php
Normal file
61
app/Http/Controllers/Api/V1/AccountController.php
Normal file
@@ -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')
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -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')
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -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
|
||||
|
||||
@@ -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'));
|
||||
}
|
||||
}
|
||||
|
||||
73
app/Http/Controllers/Api/V1/UserInvitationController.php
Normal file
73
app/Http/Controllers/Api/V1/UserInvitationController.php
Normal file
@@ -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')
|
||||
);
|
||||
}
|
||||
}
|
||||
36
app/Http/Requests/Account/UpdateAgreementsRequest.php
Normal file
36
app/Http/Requests/Account/UpdateAgreementsRequest.php
Normal file
@@ -0,0 +1,36 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\Account;
|
||||
|
||||
use App\Services\AccountService;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class UpdateAgreementsRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'agreements' => ['required', 'array', 'min:1'],
|
||||
'agreements.*.type' => ['required', 'string', Rule::in(array_keys(AccountService::getAgreementTypes()))],
|
||||
'agreements.*.agreed' => ['required', 'boolean'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'agreements.required' => __('validation.required', ['attribute' => '약관 동의 정보']),
|
||||
'agreements.array' => __('validation.array', ['attribute' => '약관 동의 정보']),
|
||||
'agreements.*.type.required' => __('validation.required', ['attribute' => '약관 유형']),
|
||||
'agreements.*.type.in' => __('validation.in', ['attribute' => '약관 유형']),
|
||||
'agreements.*.agreed.required' => __('validation.required', ['attribute' => '동의 여부']),
|
||||
'agreements.*.agreed.boolean' => __('validation.boolean', ['attribute' => '동의 여부']),
|
||||
];
|
||||
}
|
||||
}
|
||||
32
app/Http/Requests/Account/WithdrawRequest.php
Normal file
32
app/Http/Requests/Account/WithdrawRequest.php
Normal file
@@ -0,0 +1,32 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\Account;
|
||||
|
||||
use App\Services\AccountService;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class WithdrawRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'password' => ['required', 'string'],
|
||||
'reason' => ['nullable', 'string', Rule::in(array_keys(AccountService::getWithdrawalReasons()))],
|
||||
'detail' => ['nullable', 'string', 'max:500'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'password.required' => __('validation.required', ['attribute' => '비밀번호']),
|
||||
'reason.in' => __('validation.in', ['attribute' => '탈퇴 사유']),
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\NotificationSetting;
|
||||
|
||||
use App\Models\NotificationSetting;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class BulkUpdateSettingRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'settings' => ['required', 'array', 'min:1'],
|
||||
'settings.*.notification_type' => ['required', 'string', Rule::in(NotificationSetting::getAllTypes())],
|
||||
'settings.*.push_enabled' => ['nullable', 'boolean'],
|
||||
'settings.*.email_enabled' => ['nullable', 'boolean'],
|
||||
'settings.*.sms_enabled' => ['nullable', 'boolean'],
|
||||
'settings.*.in_app_enabled' => ['nullable', 'boolean'],
|
||||
'settings.*.kakao_enabled' => ['nullable', 'boolean'],
|
||||
'settings.*.settings' => ['nullable', 'array'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'settings.required' => __('validation.required', ['attribute' => '설정']),
|
||||
'settings.array' => __('validation.array', ['attribute' => '설정']),
|
||||
'settings.*.notification_type.required' => __('validation.required', ['attribute' => '알림 유형']),
|
||||
'settings.*.notification_type.in' => __('validation.in', ['attribute' => '알림 유형']),
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,36 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\NotificationSetting;
|
||||
|
||||
use App\Models\NotificationSetting;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class UpdateSettingRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'notification_type' => ['required', 'string', Rule::in(NotificationSetting::getAllTypes())],
|
||||
'push_enabled' => ['nullable', 'boolean'],
|
||||
'email_enabled' => ['nullable', 'boolean'],
|
||||
'sms_enabled' => ['nullable', 'boolean'],
|
||||
'in_app_enabled' => ['nullable', 'boolean'],
|
||||
'kakao_enabled' => ['nullable', 'boolean'],
|
||||
'settings' => ['nullable', 'array'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'notification_type.required' => __('validation.required', ['attribute' => '알림 유형']),
|
||||
'notification_type.in' => __('validation.in', ['attribute' => '알림 유형']),
|
||||
];
|
||||
}
|
||||
}
|
||||
32
app/Http/Requests/UserInvitation/AcceptInvitationRequest.php
Normal file
32
app/Http/Requests/UserInvitation/AcceptInvitationRequest.php
Normal file
@@ -0,0 +1,32 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\UserInvitation;
|
||||
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class AcceptInvitationRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'name' => ['required', 'string', 'max:100'],
|
||||
'password' => ['required', 'string', 'min:8', 'confirmed'],
|
||||
'phone' => ['nullable', 'string', 'max:20'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'name.required' => __('validation.required', ['attribute' => '이름']),
|
||||
'password.required' => __('validation.required', ['attribute' => '비밀번호']),
|
||||
'password.min' => __('validation.min.string', ['attribute' => '비밀번호', 'min' => 8]),
|
||||
'password.confirmed' => __('validation.confirmed', ['attribute' => '비밀번호']),
|
||||
];
|
||||
}
|
||||
}
|
||||
32
app/Http/Requests/UserInvitation/InviteUserRequest.php
Normal file
32
app/Http/Requests/UserInvitation/InviteUserRequest.php
Normal file
@@ -0,0 +1,32 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\UserInvitation;
|
||||
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class InviteUserRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'email' => ['required', 'email', 'max:255'],
|
||||
'role_id' => ['nullable', 'integer', 'exists:roles,id'],
|
||||
'message' => ['nullable', 'string', 'max:1000'],
|
||||
'expires_days' => ['nullable', 'integer', 'min:1', 'max:30'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'email.required' => __('validation.required', ['attribute' => '이메일']),
|
||||
'email.email' => __('validation.email', ['attribute' => '이메일']),
|
||||
'role_id.exists' => __('validation.exists', ['attribute' => '역할']),
|
||||
];
|
||||
}
|
||||
}
|
||||
25
app/Http/Requests/UserInvitation/ListInvitationRequest.php
Normal file
25
app/Http/Requests/UserInvitation/ListInvitationRequest.php
Normal file
@@ -0,0 +1,25 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\UserInvitation;
|
||||
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class ListInvitationRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'status' => ['nullable', 'string', 'in:pending,accepted,expired,cancelled'],
|
||||
'search' => ['nullable', 'string', 'max:255'],
|
||||
'sort_by' => ['nullable', 'string', 'in:created_at,expires_at,email'],
|
||||
'sort_dir' => ['nullable', 'string', 'in:asc,desc'],
|
||||
'per_page' => ['nullable', 'integer', 'min:1', 'max:100'],
|
||||
'page' => ['nullable', 'integer', 'min:1'],
|
||||
];
|
||||
}
|
||||
}
|
||||
16
app/Http/Requests/V1/Sale/SendStatementRequest.php
Normal file
16
app/Http/Requests/V1/Sale/SendStatementRequest.php
Normal file
@@ -0,0 +1,16 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\V1\Sale;
|
||||
|
||||
use App\Http\Requests\BaseRequest;
|
||||
|
||||
class SendStatementRequest extends BaseRequest
|
||||
{
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'email' => ['nullable', 'string', 'email', 'max:255'],
|
||||
'message' => ['nullable', 'string', 'max:1000'],
|
||||
];
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user