feat: 대시보드 API 및 FCM 푸시 알림 API 구현
Dashboard API:
- DashboardController, DashboardService 추가
- /dashboard/summary, /charts, /approvals 엔드포인트
Push Notification API:
- FCM 토큰 관리 (등록/해제/목록)
- 알림 설정 관리 (유형별 on/off, 알림음 설정)
- 알림 유형: deposit, withdrawal, order, approval, attendance, notice, system
- 알림음: default, deposit, withdrawal, order, approval, urgent
- PushDeviceToken, PushNotificationSetting 모델
- Swagger 문서 추가
2025-12-18 11:16:24 +09:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
namespace App\Models;
|
|
|
|
|
|
|
|
|
|
use App\Traits\BelongsToTenant;
|
|
|
|
|
use Illuminate\Database\Eloquent\Model;
|
|
|
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
|
|
|
|
|
|
|
|
class PushNotificationSetting extends Model
|
|
|
|
|
{
|
|
|
|
|
use BelongsToTenant;
|
|
|
|
|
|
|
|
|
|
protected $fillable = [
|
|
|
|
|
'tenant_id',
|
|
|
|
|
'user_id',
|
|
|
|
|
'notification_type',
|
|
|
|
|
'is_enabled',
|
|
|
|
|
'sound',
|
|
|
|
|
'vibrate',
|
|
|
|
|
'show_preview',
|
|
|
|
|
];
|
|
|
|
|
|
|
|
|
|
protected $casts = [
|
|
|
|
|
'is_enabled' => 'boolean',
|
|
|
|
|
'vibrate' => 'boolean',
|
|
|
|
|
'show_preview' => 'boolean',
|
|
|
|
|
];
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 알림 유형 상수
|
|
|
|
|
*/
|
|
|
|
|
public const TYPE_DEPOSIT = 'deposit'; // 입금
|
|
|
|
|
|
|
|
|
|
public const TYPE_WITHDRAWAL = 'withdrawal'; // 출금
|
|
|
|
|
|
|
|
|
|
public const TYPE_ORDER = 'order'; // 수주
|
|
|
|
|
|
|
|
|
|
public const TYPE_APPROVAL = 'approval'; // 결재
|
|
|
|
|
|
|
|
|
|
public const TYPE_ATTENDANCE = 'attendance'; // 근태
|
|
|
|
|
|
|
|
|
|
public const TYPE_NOTICE = 'notice'; // 공지사항
|
|
|
|
|
|
|
|
|
|
public const TYPE_SYSTEM = 'system'; // 시스템
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 알림음 상수
|
|
|
|
|
*/
|
|
|
|
|
public const SOUND_DEFAULT = 'default';
|
|
|
|
|
|
|
|
|
|
public const SOUND_DEPOSIT = 'deposit.wav'; // 입금 알림음
|
|
|
|
|
|
|
|
|
|
public const SOUND_WITHDRAWAL = 'withdrawal.wav'; // 출금 알림음
|
|
|
|
|
|
|
|
|
|
public const SOUND_ORDER = 'order.wav'; // 수주 알림음
|
|
|
|
|
|
|
|
|
|
public const SOUND_APPROVAL = 'approval.wav'; // 결재 알림음
|
|
|
|
|
|
|
|
|
|
public const SOUND_URGENT = 'urgent.wav'; // 긴급 알림음
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 모든 알림 유형 반환
|
|
|
|
|
*/
|
|
|
|
|
public static function getAllTypes(): array
|
|
|
|
|
{
|
|
|
|
|
return [
|
|
|
|
|
self::TYPE_DEPOSIT,
|
|
|
|
|
self::TYPE_WITHDRAWAL,
|
|
|
|
|
self::TYPE_ORDER,
|
|
|
|
|
self::TYPE_APPROVAL,
|
|
|
|
|
self::TYPE_ATTENDANCE,
|
|
|
|
|
self::TYPE_NOTICE,
|
|
|
|
|
self::TYPE_SYSTEM,
|
|
|
|
|
];
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 모든 알림음 반환
|
|
|
|
|
*/
|
|
|
|
|
public static function getAllSounds(): array
|
|
|
|
|
{
|
|
|
|
|
return [
|
|
|
|
|
self::SOUND_DEFAULT,
|
|
|
|
|
self::SOUND_DEPOSIT,
|
|
|
|
|
self::SOUND_WITHDRAWAL,
|
|
|
|
|
self::SOUND_ORDER,
|
|
|
|
|
self::SOUND_APPROVAL,
|
|
|
|
|
self::SOUND_URGENT,
|
|
|
|
|
];
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 사용자 관계
|
|
|
|
|
*/
|
|
|
|
|
public function user(): BelongsTo
|
|
|
|
|
{
|
|
|
|
|
return $this->belongsTo(User::class);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 테넌트 관계
|
|
|
|
|
*/
|
|
|
|
|
public function tenant(): BelongsTo
|
|
|
|
|
{
|
|
|
|
|
return $this->belongsTo(Tenant::class);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Scope: 활성화된 알림만
|
|
|
|
|
*/
|
|
|
|
|
public function scopeEnabled($query)
|
|
|
|
|
{
|
|
|
|
|
return $query->where('is_enabled', true);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Scope: 특정 사용자의 설정
|
|
|
|
|
*/
|
|
|
|
|
public function scopeForUser($query, int $userId)
|
|
|
|
|
{
|
|
|
|
|
return $query->where('user_id', $userId);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Scope: 특정 알림 유형
|
|
|
|
|
*/
|
|
|
|
|
public function scopeOfType($query, string $type)
|
|
|
|
|
{
|
|
|
|
|
return $query->where('notification_type', $type);
|
|
|
|
|
}
|
2025-12-18 11:40:49 +09:00
|
|
|
}
|