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:
230
app/Services/UserInvitationService.php
Normal file
230
app/Services/UserInvitationService.php
Normal file
@@ -0,0 +1,230 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services;
|
||||
|
||||
use App\Models\Members\User;
|
||||
use App\Models\Members\UserTenant;
|
||||
use App\Models\UserInvitation;
|
||||
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Mail;
|
||||
use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;
|
||||
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
|
||||
|
||||
class UserInvitationService extends Service
|
||||
{
|
||||
/**
|
||||
* 초대 목록 조회
|
||||
*/
|
||||
public function index(array $params): LengthAwarePaginator
|
||||
{
|
||||
$tenantId = $this->tenantId();
|
||||
|
||||
$query = UserInvitation::query()
|
||||
->where('tenant_id', $tenantId)
|
||||
->with(['role:id,name', 'inviter:id,name']);
|
||||
|
||||
// 상태 필터
|
||||
if (! empty($params['status'])) {
|
||||
$query->where('status', $params['status']);
|
||||
}
|
||||
|
||||
// 이메일 검색
|
||||
if (! empty($params['search'])) {
|
||||
$search = $params['search'];
|
||||
$query->where(function ($q) use ($search) {
|
||||
$q->where('email', 'like', "%{$search}%");
|
||||
});
|
||||
}
|
||||
|
||||
// 정렬
|
||||
$sortBy = $params['sort_by'] ?? 'created_at';
|
||||
$sortDir = $params['sort_dir'] ?? 'desc';
|
||||
$query->orderBy($sortBy, $sortDir);
|
||||
|
||||
// 페이지네이션
|
||||
$perPage = $params['per_page'] ?? 20;
|
||||
|
||||
return $query->paginate($perPage);
|
||||
}
|
||||
|
||||
/**
|
||||
* 사용자 초대 발송
|
||||
*/
|
||||
public function invite(array $data): UserInvitation
|
||||
{
|
||||
$tenantId = $this->tenantId();
|
||||
$userId = $this->apiUserId();
|
||||
|
||||
return DB::transaction(function () use ($data, $tenantId, $userId) {
|
||||
$email = $data['email'];
|
||||
|
||||
// 이미 테넌트에 가입된 사용자인지 확인
|
||||
$existingUser = User::where('email', $email)->first();
|
||||
if ($existingUser) {
|
||||
$existingMembership = UserTenant::where('tenant_id', $tenantId)
|
||||
->where('user_id', $existingUser->id)
|
||||
->whereNull('deleted_at')
|
||||
->exists();
|
||||
|
||||
if ($existingMembership) {
|
||||
throw new BadRequestHttpException(__('error.invitation.already_member'));
|
||||
}
|
||||
}
|
||||
|
||||
// 이미 대기 중인 초대가 있는지 확인
|
||||
$pendingInvitation = UserInvitation::where('tenant_id', $tenantId)
|
||||
->where('email', $email)
|
||||
->pending()
|
||||
->first();
|
||||
|
||||
if ($pendingInvitation) {
|
||||
throw new BadRequestHttpException(__('error.invitation.already_pending'));
|
||||
}
|
||||
|
||||
// 초대 생성
|
||||
$invitation = new UserInvitation;
|
||||
$invitation->tenant_id = $tenantId;
|
||||
$invitation->email = $email;
|
||||
$invitation->role_id = $data['role_id'] ?? null;
|
||||
$invitation->message = $data['message'] ?? null;
|
||||
$invitation->token = UserInvitation::generateToken();
|
||||
$invitation->status = UserInvitation::STATUS_PENDING;
|
||||
$invitation->invited_by = $userId;
|
||||
$invitation->expires_at = UserInvitation::calculateExpiresAt($data['expires_days'] ?? UserInvitation::DEFAULT_EXPIRES_DAYS);
|
||||
$invitation->save();
|
||||
|
||||
// 초대 이메일 발송 (비동기 처리 권장)
|
||||
$this->sendInvitationEmail($invitation);
|
||||
|
||||
return $invitation->load(['role:id,name', 'inviter:id,name']);
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 초대 수락
|
||||
*/
|
||||
public function accept(string $token, array $userData): User
|
||||
{
|
||||
return DB::transaction(function () use ($token, $userData) {
|
||||
// 토큰으로 초대 조회 (테넌트 스코프 제외)
|
||||
$invitation = UserInvitation::withoutGlobalScopes()
|
||||
->where('token', $token)
|
||||
->first();
|
||||
|
||||
if (! $invitation) {
|
||||
throw new NotFoundHttpException(__('error.invitation.not_found'));
|
||||
}
|
||||
|
||||
if (! $invitation->canAccept()) {
|
||||
if ($invitation->isExpired()) {
|
||||
$invitation->markAsExpired();
|
||||
throw new BadRequestHttpException(__('error.invitation.expired'));
|
||||
}
|
||||
throw new BadRequestHttpException(__('error.invitation.invalid_status'));
|
||||
}
|
||||
|
||||
// 기존 사용자 확인 또는 신규 생성
|
||||
$user = User::where('email', $invitation->email)->first();
|
||||
|
||||
if (! $user) {
|
||||
// 신규 사용자 생성
|
||||
$user = new User;
|
||||
$user->email = $invitation->email;
|
||||
$user->name = $userData['name'];
|
||||
$user->password = $userData['password'];
|
||||
$user->phone = $userData['phone'] ?? null;
|
||||
$user->save();
|
||||
}
|
||||
|
||||
// 테넌트 멤버십 생성
|
||||
$userTenant = new UserTenant;
|
||||
$userTenant->user_id = $user->id;
|
||||
$userTenant->tenant_id = $invitation->tenant_id;
|
||||
$userTenant->is_active = true;
|
||||
$userTenant->is_default = ! $user->userTenants()->exists(); // 첫 테넌트면 기본으로
|
||||
$userTenant->joined_at = now();
|
||||
$userTenant->save();
|
||||
|
||||
// 역할 부여 (있는 경우)
|
||||
if ($invitation->role_id) {
|
||||
$user->assignRole($invitation->role->name);
|
||||
}
|
||||
|
||||
// 초대 수락 처리
|
||||
$invitation->markAsAccepted();
|
||||
|
||||
return $user;
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 초대 취소
|
||||
*/
|
||||
public function cancel(int $id): bool
|
||||
{
|
||||
$tenantId = $this->tenantId();
|
||||
|
||||
$invitation = UserInvitation::where('tenant_id', $tenantId)
|
||||
->findOrFail($id);
|
||||
|
||||
if (! $invitation->canCancel()) {
|
||||
throw new BadRequestHttpException(__('error.invitation.cannot_cancel'));
|
||||
}
|
||||
|
||||
$invitation->markAsCancelled();
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* 초대 재발송
|
||||
*/
|
||||
public function resend(int $id): UserInvitation
|
||||
{
|
||||
$tenantId = $this->tenantId();
|
||||
|
||||
$invitation = UserInvitation::where('tenant_id', $tenantId)
|
||||
->findOrFail($id);
|
||||
|
||||
if ($invitation->status !== UserInvitation::STATUS_PENDING) {
|
||||
throw new BadRequestHttpException(__('error.invitation.cannot_resend'));
|
||||
}
|
||||
|
||||
// 만료 기간 연장 및 토큰 재생성
|
||||
$invitation->token = UserInvitation::generateToken();
|
||||
$invitation->expires_at = UserInvitation::calculateExpiresAt();
|
||||
$invitation->save();
|
||||
|
||||
// 이메일 재발송
|
||||
$this->sendInvitationEmail($invitation);
|
||||
|
||||
return $invitation->load(['role:id,name', 'inviter:id,name']);
|
||||
}
|
||||
|
||||
/**
|
||||
* 만료된 초대 일괄 처리 (스케줄러용)
|
||||
*/
|
||||
public function expirePendingInvitations(): int
|
||||
{
|
||||
return UserInvitation::withoutGlobalScopes()
|
||||
->expiredPending()
|
||||
->update(['status' => UserInvitation::STATUS_EXPIRED]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 초대 이메일 발송
|
||||
*/
|
||||
protected function sendInvitationEmail(UserInvitation $invitation): void
|
||||
{
|
||||
// TODO: 실제 메일 발송 로직 구현
|
||||
// Mail::to($invitation->email)->queue(new UserInvitationMail($invitation));
|
||||
|
||||
// 현재는 로그로 대체
|
||||
\Log::info('User invitation email sent', [
|
||||
'email' => $invitation->email,
|
||||
'token' => $invitation->token,
|
||||
'tenant_id' => $invitation->tenant_id,
|
||||
]);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user