Files
sam-api/app/Services/PopupService.php
hskwon 8f1292f7c4 feat: Phase 6.2 팝업관리 API 구현
- popups 테이블 마이그레이션 생성
- Popup 모델 (BelongsToTenant, SoftDeletes)
- PopupService CRUD 구현
- FormRequest 검증 (Store/Update)
- PopupController 6개 엔드포인트
- Swagger 문서 (PopupApi.php)
- PROJECT_DEVELOPMENT_POLICY.md 정책 준수
2025-12-19 16:14:04 +09:00

164 lines
4.5 KiB
PHP

<?php
namespace App\Services;
use App\Models\Popups\Popup;
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
use Illuminate\Support\Collection;
class PopupService extends Service
{
/**
* 팝업 목록 조회 (관리자용)
*/
public function index(array $params): LengthAwarePaginator
{
$tenantId = $this->tenantId();
$query = Popup::query()
->where('tenant_id', $tenantId)
->with(['creator:id,name', 'department:id,name']);
// 대상 유형 필터
if (! empty($params['target_type'])) {
$query->where('target_type', $params['target_type']);
}
// 상태 필터
if (! empty($params['status'])) {
$query->where('status', $params['status']);
}
// 검색어 필터
if (! empty($params['search'])) {
$search = $params['search'];
$query->where(function ($q) use ($search) {
$q->where('title', 'like', "%{$search}%")
->orWhere('content', '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 getActivePopups(?int $departmentId = null): Collection
{
$tenantId = $this->tenantId();
return Popup::query()
->where('tenant_id', $tenantId)
->active()
->forUser($departmentId)
->orderBy('created_at', 'desc')
->get();
}
/**
* 팝업 상세 조회
*/
public function show(int $id): Popup
{
$tenantId = $this->tenantId();
return Popup::query()
->where('tenant_id', $tenantId)
->with(['creator:id,name', 'department:id,name'])
->findOrFail($id);
}
/**
* 팝업 등록
*/
public function store(array $data): Popup
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
$popup = new Popup;
$popup->tenant_id = $tenantId;
$popup->target_type = $data['target_type'] ?? Popup::TARGET_ALL;
$popup->target_id = $data['target_id'] ?? null;
$popup->title = $data['title'];
$popup->content = $data['content'];
$popup->status = $data['status'] ?? Popup::STATUS_INACTIVE;
$popup->started_at = $data['started_at'] ?? null;
$popup->ended_at = $data['ended_at'] ?? null;
$popup->options = $data['options'] ?? null;
$popup->created_by = $userId;
$popup->save();
return $popup->load(['creator:id,name', 'department:id,name']);
}
/**
* 팝업 수정
*/
public function update(int $id, array $data): Popup
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
$popup = Popup::query()
->where('tenant_id', $tenantId)
->findOrFail($id);
if (isset($data['target_type'])) {
$popup->target_type = $data['target_type'];
}
if (array_key_exists('target_id', $data)) {
$popup->target_id = $data['target_id'];
}
if (isset($data['title'])) {
$popup->title = $data['title'];
}
if (isset($data['content'])) {
$popup->content = $data['content'];
}
if (isset($data['status'])) {
$popup->status = $data['status'];
}
if (array_key_exists('started_at', $data)) {
$popup->started_at = $data['started_at'];
}
if (array_key_exists('ended_at', $data)) {
$popup->ended_at = $data['ended_at'];
}
if (array_key_exists('options', $data)) {
$popup->options = $data['options'];
}
$popup->updated_by = $userId;
$popup->save();
return $popup->load(['creator:id,name', 'department:id,name']);
}
/**
* 팝업 삭제
*/
public function destroy(int $id): void
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
$popup = Popup::query()
->where('tenant_id', $tenantId)
->findOrFail($id);
$popup->deleted_by = $userId;
$popup->save();
$popup->delete();
}
}