sam-docs/guides/메뉴뱃지기능.md

사이드바 메뉴 뱃지 기능

메뉴 옆에 알림 건수를 표시하는 뱃지 기능 가이드

---

개요

사이드바 메뉴에 대기 건수, 알림 등을 빨간색 뱃지로 표시하는 기능입니다.

예시:

영업파트너 승인 (3)   ← 빨간 원형 뱃지로 "3" 표시

---

구현 위치

파일	역할
app/Providers/ViewServiceProvider.php	뱃지 데이터 조회 및 전역 공유
resources/views/components/sidebar/menu-item.blade.php	뱃지 렌더링

---

작동 원리

1. ViewServiceProvider에서 뱃지 데이터 생성

View::composer('partials.sidebar', function ($view) {
    $menuBadges = [
        'byRoute' => [],  // 라우트명 기준
        'byUrl' => [],    // URL 기준
    ];

    // 예: 영업파트너 승인 대기 건수
    if ($approvalStats['pending'] > 0) {
        $menuBadges['byRoute']['sales.managers.approvals'] = $approvalStats['pending'];
        $menuBadges['byUrl']['/sales/managers/approvals'] = $approvalStats['pending'];
    }

    // View::share로 전역 공유 (중요!)
    View::share('menuBadges', $menuBadges);
});

2. menu-item.blade.php에서 뱃지 표시

// 라우트명 또는 URL로 뱃지 건수 조회
$badgeCount = 0;
if (isset($menuBadges)) {
    if ($routeName && isset($menuBadges['byRoute'][$routeName])) {
        $badgeCount = $menuBadges['byRoute'][$routeName];
    }
    elseif ($menu->url && isset($menuBadges['byUrl'][$menu->url])) {
        $badgeCount = $menuBadges['byUrl'][$menu->url];
    }
}

@if($badgeCount > 0)
    <span class="sidebar-text inline-flex items-center justify-center
                 min-w-[1.25rem] h-5 px-1.5 text-xs font-bold
                 text-white bg-red-500 rounded-full">
        {{ $badgeCount > 99 ? '99+' : $badgeCount }}
    </span>
@endif

---

새로운 뱃지 추가 방법

Step 1: ViewServiceProvider 수정

app/Providers/ViewServiceProvider.php에서 뱃지 데이터 추가:

// 예: 새로운 승인 대기 건수 추가
$pendingCount = SomeService::getPendingCount();
if ($pendingCount > 0) {
    // 라우트명으로 등록 (메뉴에 route_name 설정된 경우)
    $menuBadges['byRoute']['some.route.name'] = $pendingCount;

    // URL로 등록 (메뉴가 URL로만 설정된 경우)
    $menuBadges['byUrl']['/some/menu/url'] = $pendingCount;
}

Step 2: 메뉴 URL 또는 라우트명 확인

메뉴 DB에서 해당 메뉴의 url 또는 options->route_name을 확인합니다.

SELECT name, url, options FROM menus WHERE name LIKE '%메뉴명%';

---

주의사항

View::share 필수

중요: View::composer로 전달한 변수는 Blade 컴포넌트 내부에서 접근 불가합니다.

// ❌ 잘못된 방법 - 컴포넌트에서 접근 불가
$view->with('menuBadges', $menuBadges);

// ✅ 올바른 방법 - 전역 공유
View::share('menuBadges', $menuBadges);

성능 고려

• 뱃지 데이터 조회는 매 요청마다 실행됩니다
• 무거운 쿼리는 캐싱 고려 필요
• 현재는 간단한 COUNT 쿼리만 사용

---

현재 적용된 뱃지

메뉴	URL	조건
영업파트너 승인	/sales/managers/approvals	승인 대기 건수 > 0

---

스타일 커스터마이징

색상 변경

<!-- 빨간색 (기본) -->
<span class="bg-red-500 text-white">

<!-- 파란색 -->
<span class="bg-blue-500 text-white">

<!-- 노란색 -->
<span class="bg-yellow-500 text-gray-900">

크기 변경

<!-- 작은 뱃지 -->
<span class="min-w-[1rem] h-4 text-[10px]">

<!-- 큰 뱃지 -->
<span class="min-w-[1.5rem] h-6 text-sm">

---

관련 파일

• app/Providers/ViewServiceProvider.php - 뱃지 데이터 공급
• app/Services/Sales/SalesManagerService.php - 승인 통계 조회 (getApprovalStats())
• resources/views/components/sidebar/menu-item.blade.php - 뱃지 렌더링
• resources/views/partials/sidebar.blade.php - 사이드바 레이아웃

---

작성일: 2026-01-31