Ver2.0 Laravel Nova: 관리자 패널 빠르게 구축하기 🚀

Laravel Nova: 관리자 패널 빠르게 구축하기 🚀
안녕? 오늘은 PHP 프레임워크인 Laravel의 강력한 관리자 패널 도구, Laravel Nova에 대해 함께 알아볼 거야. 🤓 웹 애플리케이션을 개발하다 보면 관리자 패널은 필수적인데, 이걸 처음부터 만들려면 시간이 엄청 많이 걸리지. 하지만 Nova를 사용하면 정말 빠르게 멋진 관리자 패널을 구축할 수 있어!
이 글을 통해 Nova의 기본 개념부터 실제 구현 방법, 커스터마이징 팁까지 모두 알려줄게. 마치 재능넷에서 전문가의 노하우를 배우듯 쉽고 재미있게 설명할 테니 끝까지 함께해보자! 💪
📚 목차
- Laravel Nova 소개
- Nova 설치 및 설정하기
- 리소스(Resources) 생성 및 관리
- 필드(Fields) 타입과 활용법
- 액션(Actions)으로 일괄 처리하기
- 렌즈(Lenses)로 데이터 시각화하기
- 필터(Filters)로 데이터 정제하기
- 메트릭(Metrics)으로 통계 구현하기
- 카드(Cards)로 대시보드 꾸미기
- 커스텀 필드와 도구 개발하기
- Nova 활용 실전 사례
- 마무리 및 추가 자료
1. Laravel Nova 소개 🌟
Laravel Nova는 Taylor Otwell(라라벨 창시자)이 개발한 프리미엄 관리자 패널 패키지야. 2018년에 처음 출시되었고, 지금은 많은 라라벨 개발자들이 사용하고 있어. Nova는 라라벨의 철학을 그대로 이어받아 우아하고 직관적인 인터페이스를 제공하면서도 강력한 기능을 갖추고 있지.
1.1 Nova의 주요 특징 ✨
Nova가 다른 관리자 패널과 차별화되는 점은 뭘까?
- 모델 기반 설계: 라라벨의 Eloquent 모델을 기반으로 자동으로 CRUD 인터페이스를 생성해줘.
- 아름다운 UI: 모던하고 반응형인 인터페이스를 기본으로 제공해.
- 강력한 검색 기능: 전역 검색과 필터링 기능이 내장되어 있어.
- 사용자 권한 관리: 세밀한 권한 제어 시스템을 갖추고 있어.
- 확장 가능성: 커스텀 필드, 카드, 액션 등을 통해 확장할 수 있어.
1.2 Nova vs 다른 관리자 패널 도구 🥊
시중에는 Voyager, Backpack for Laravel 같은 다른 관리자 패널 도구들도 있어. 그럼 Nova는 이들과 어떻게 다를까?
Nova는 유료 패키지($199/프로젝트)라는 단점이 있지만, 그만큼 완성도와 지원이 뛰어나. 특히 라라벨의 공식 제품이라는 점에서 프레임워크와의 호환성이 최고 수준이야. 또한 Vue.js 기반으로 구축되어 있어서 프론트엔드 커스터마이징도 매우 유연해.
만약 개인 프로젝트나 작은 스타트업에서 비용이 부담된다면, 오픈소스 대안을 고려해볼 수도 있어. 하지만 재능넷처럼 안정적인 서비스를 운영하려면 Nova 같은 프리미엄 도구의 투자 가치는 충분하다고 생각해. 🤔
2. Nova 설치 및 설정하기 🛠️
자, 이제 Nova를 설치하고 설정하는 방법을 알아보자! 설치 과정은 생각보다 간단해.
2.1 사전 요구사항 📋
Nova를 설치하기 전에 다음 요구사항을 확인해봐:
- PHP 7.3 이상 (PHP 8.x 권장)
- Laravel 8.x 이상
- Composer
- Nova 라이선스 (Laravel 공식 사이트에서 구매 가능)
2.2 Composer 설정하기 🎼
먼저 Nova를 설치하기 위해 Composer 설정을 해야 해. auth.json 파일을 생성하거나 수정해서 Nova 저장소에 접근할 수 있는 인증 정보를 추가해야 해:
{
"http-basic": {
"nova.laravel.com": {
"username": "이메일@example.com",
"password": "라이선스키"
}
}
}
2.3 Nova 패키지 설치하기 📦
이제 Composer를 통해 Nova를 설치할 수 있어:
composer require laravel/nova
설치가 완료되면 Nova의 자산과 설정 파일을 게시해야 해:
php artisan nova:install
php artisan migrate
2.4 기본 설정 조정하기 ⚙️
config/nova.php 파일을 열어 기본 설정을 확인하고 필요에 따라 수정할 수 있어:
// config/nova.php
return [
'name' => '내 프로젝트 관리자',
'url' => env('APP_URL', '/').'/nova',
'middleware' => ['web', 'nova'],
// 기타 설정...
];
주요 설정 옵션들:
- name: 관리자 패널의 이름
- url: Nova에 접근할 URL 경로
- middleware: Nova 요청에 적용할 미들웨어
- auth: 인증 관련 설정
- storage_disk: 파일 업로드에 사용할 디스크
2.5 사용자 인증 설정 🔐
기본적으로 Nova는 App\Models\User 모델을 사용하여 인증을 처리해. 관리자만 Nova에 접근할 수 있도록 app/Providers/NovaServiceProvider.php 파일에서 gate 메서드를 수정할 수 있어:
protected function gate()
{
Gate::define('viewNova', function ($user) {
return in_array($user->email, [
'admin@example.com',
'another-admin@example.com',
]);
});
}
또는 사용자 역할에 따라 접근을 제한할 수도 있어:
protected function gate()
{
Gate::define('viewNova', function ($user) {
return $user->hasRole('admin') || $user->hasRole('super-admin');
});
}
이제 기본 설치와 설정이 완료되었어! 브라우저에서 your-app-url.com/nova로 접속하면 Nova 로그인 화면을 볼 수 있을 거야. 🎉
3. 리소스(Resources) 생성 및 관리 📊
Nova의 핵심은 리소스(Resource)야. 리소스는 데이터베이스 모델을 관리자 패널에서 어떻게 표현할지 정의하는 클래스야. 각 Eloquent 모델마다 해당하는 Nova 리소스를 만들어 관리할 수 있어.
3.1 리소스 생성하기 🆕
아티즌 명령어를 사용해 리소스를 쉽게 생성할 수 있어:
php artisan nova:resource Post
이 명령어는 app/Nova/Post.php 파일을 생성해. 기본 구조는 다음과 같아:
namespace App\Nova;
use Laravel\Nova\Fields\ID;
use Laravel\Nova\Fields\Text;
use Laravel\Nova\Fields\Textarea;
use Laravel\Nova\Http\Requests\NovaRequest;
class Post extends Resource
{
/**
* 리소스와 연결된 모델
*/
public static $model = \App\Models\Post::class;
/**
* 리소스에 표시될 기본 컬럼들
*/
public function fields(NovaRequest $request)
{
return [
ID::make()->sortable(),
Text::make('Title')
->sortable()
->rules('required', 'max:255'),
Textarea::make('Content')
->rules('required'),
];
}
}
3.2 리소스 구성 요소 이해하기 🧩
Nova 리소스 클래스에는 몇 가지 중요한 메서드와 속성이 있어:
- $model: 리소스가 관리할 Eloquent 모델을 지정해.
- $title: 리소스의 개별 항목을 표시할 때 사용할 속성을 정의해.
- $search: 검색 가능한 필드를 지정해.
- fields(): 리소스의 필드를 정의해.
- cards(): 리소스 대시보드에 표시할 카드를 정의해.
- filters(): 리소스에 적용할 필터를 정의해.
- lenses(): 리소스에 사용할 렌즈를 정의해.
- actions(): 리소스에서 수행할 수 있는 액션을 정의해.
3.3 리소스 표시 이름 및 그룹 설정 🏷️
리소스의 표시 이름과 그룹을 사용자 정의할 수 있어:
/**
* 리소스의 표시 이름을 가져옵니다.
*/
public static function label()
{
return '게시글';
}
/**
* 리소스의 복수형 표시 이름을 가져옵니다.
*/
public static function pluralLabel()
{
return '게시글 목록';
}
/**
* 리소스가 속한 그룹을 가져옵니다.
*/
public static function group()
{
return '콘텐츠 관리';
}
이렇게 설정하면 Nova 사이드바에서 리소스가 '콘텐츠 관리' 그룹 아래 '게시글 목록'이라는 이름으로 표시돼. 🗂️
3.4 리소스 정렬 및 검색 설정 🔍
리소스의 기본 정렬과 검색 가능한 필드를 설정할 수 있어:
/**
* 기본 정렬 필드
*/
public static $defaultSort = 'created_at';
/**
* 기본 정렬 방향
*/
public static $defaultSortDirection = 'desc';
/**
* 검색 가능한 필드
*/
public static $search = [
'id', 'title', 'content'
];
3.5 리소스 권한 제어 🔒
특정 사용자가 리소스에 대해 어떤 작업을 수행할 수 있는지 제어할 수 있어:
/**
* 현재 사용자가 리소스를 볼 수 있는지 결정합니다.
*/
public static function authorizedToViewAny(Request $request)
{
return $request->user()->hasPermission('view-posts');
}
/**
* 현재 사용자가 리소스를 생성할 수 있는지 결정합니다.
*/
public static function authorizedToCreate(Request $request)
{
return $request->user()->hasPermission('create-posts');
}
이 외에도 authorizedToUpdate, authorizedToDelete, authorizedToRestore, authorizedToForceDelete 메서드를 오버라이드하여 다양한 작업에 대한 권한을 제어할 수 있어.
리소스는 Nova의 기본 구성 요소이므로 잘 이해하고 설정하는 것이 중요해. 이제 우리는 모델을 관리자 패널에서 어떻게 표현할지 정의할 수 있게 되었어! 🎯
4. 필드(Fields) 타입과 활용법 🎨
Nova에서 필드는 데이터베이스 컬럼을 관리자 패널에서 어떻게 표시하고 편집할지 정의해. Nova는 다양한 필드 타입을 제공하고 있어서 거의 모든 종류의 데이터를 효과적으로 관리할 수 있어! 😎
4.1 기본 필드 타입 🧰
Nova에서 제공하는 주요 필드 타입을 살펴보자:
- ID: 기본 식별자 필드
- Text: 짧은 텍스트를 위한 필드
- Textarea: 여러 줄의 텍스트를 위한 필드
- Number: 숫자 값을 위한 필드
- Boolean: 참/거짓 값을 위한 필드
- Date: 날짜를 위한 필드
- DateTime: 날짜와 시간을 위한 필드
- Select: 드롭다운 선택 필드
- Password: 비밀번호 입력 필드
- File: 파일 업로드 필드
- Image: 이미지 업로드 및 미리보기 필드
- Color: 색상 선택 필드
4.2 필드 사용 예시 📝
다양한 필드 타입을 사용하는 예시를 살펴보자:
public function fields(NovaRequest $request)
{
return [
ID::make()->sortable(),
Text::make('제목', 'title')
->sortable()
->rules('required', 'max:255'),
Textarea::make('내용', 'content')
->rules('required')
->hideFromIndex(),
Number::make('조회수', 'views')
->sortable()
->min(0),
Boolean::make('공개 여부', 'is_published')
->trueValue('공개')
->falseValue('비공개'),
DateTime::make('작성일', 'created_at')
->format('Y-m-d H:i')
->sortable(),
Select::make('카테고리', 'category')
->options([
'news' => '뉴스',
'tech' => '기술',
'life' => '라이프스타일'
])
->displayUsingLabels(),
Image::make('썸네일', 'thumbnail')
->disk('public')
->path('thumbnails')
->prunable()
->hideFromIndex(),
];
}
4.3 관계형 필드 🔗
Nova는 Eloquent 관계를 표현하기 위한 특별한 필드들도 제공해:
- BelongsTo: 일대다 관계의 '다' 쪽
- HasOne: 일대일 관계
- HasMany: 일대다 관계의 '일' 쪽
- BelongsToMany: 다대다 관계
- MorphTo: 다형성 관계
- MorphMany: 다형성 일대다 관계
예를 들어, 게시글과 작성자 관계를 표현하려면:
// Post 리소스
BelongsTo::make('작성자', 'author', User::class),
// User 리소스
HasMany::make('게시글', 'posts', Post::class),
4.4 필드 표시 조건 설정 🔄
필드를 언제 표시할지 조건을 설정할 수 있어:
// 인덱스 페이지에서 숨기기
Text::make('설명', 'description')->hideFromIndex(),
// 상세 페이지에서 숨기기
Number::make('내부 ID', 'internal_id')->hideFromDetail(),
// 폼에서 숨기기
DateTime::make('마지막 로그인', 'last_login_at')->hideWhenCreating()->hideWhenUpdating(),
// 조건부 표시
Text::make('거부 사유', 'rejection_reason')
->onlyOnDetail()
->showOnIndex(function () {
return $this->status === 'rejected';
}),
4.5 필드 유효성 검사 ✅
필드에 유효성 검사 규칙을 쉽게 추가할 수 있어:
Text::make('이메일', 'email')
->rules('required', 'email', 'max:254')
->creationRules('unique:users,email')
->updateRules('unique:users,email,{{resourceId}}'),
Number::make('나이', 'age')
->rules('required', 'integer', 'min:18', 'max:100'),
Password::make('비밀번호')
->onlyOnForms()
->creationRules('required', 'string', 'min:8')
->updateRules('nullable', 'string', 'min:8'),
4.6 필드 포맷팅 및 디스플레이 커스터마이징 🖌️
필드의 표시 방식을 커스터마이징할 수 있어:
// 날짜 포맷팅
DateTime::make('생성일', 'created_at')
->format('Y년 m월 d일 H시 i분'),
// 숫자 포맷팅
Number::make('가격', 'price')
->displayUsing(function ($value) {
return number_format($value) . '원';
}),
// 텍스트 변환
Text::make('이름', 'name')
->displayUsing(function ($value) {
return Str::title($value);
}),
// HTML 표시
Text::make('상태', 'status')
->displayUsing(function ($value) {
$color = $value === 'active' ? 'green' : 'red';
return "<span style=\"color: {$color}\">{$value}</span>";
})
->asHtml(),
Nova의 필드 시스템은 매우 유연하고 강력해! 이를 잘 활용하면 데이터를 효과적으로 표현하고 관리할 수 있어. 필드 타입을 적절히 선택하고 커스터마이징하는 것이 좋은 관리자 패널을 만드는 핵심이야. 🚀
5. 액션(Actions)으로 일괄 처리하기 🔄
Nova의 액션(Actions)은 선택한 여러 리소스에 대해 일괄 작업을 수행할 수 있게 해주는 강력한 기능이야. 예를 들어, 여러 게시글을 한 번에 발행하거나, 사용자 그룹에 이메일을 보내거나, 주문 상태를 변경하는 등의 작업을 쉽게 처리할 수 있지! 👨💻
5.1 기본 액션 생성하기 🛠️
아티즌 명령어로 새 액션을 생성해보자:
php artisan nova:action PublishPosts
이 명령어는 app/Nova/Actions/PublishPosts.php 파일을 생성해. 기본 구조는 다음과 같아:
namespace App\Nova\Actions;
use Illuminate\Bus\Queueable;
use Laravel\Nova\Actions\Action;
use Illuminate\Support\Collection;
use Laravel\Nova\Fields\ActionFields;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;
use Laravel\Nova\Http\Requests\NovaRequest;
class PublishPosts extends Action
{
use InteractsWithQueue, Queueable;
/**
* 액션 실행
*/
public function handle(ActionFields $fields, Collection $models)
{
foreach ($models as $model) {
$model->update(['is_published' => true]);
}
return Action::message('게시글이 성공적으로 발행되었습니다!');
}
/**
* 액션 필드
*/
public function fields(NovaRequest $request)
{
return [];
}
}
5.2 액션에 필드 추가하기 📋
액션 실행 시 사용자로부터 추가 정보를 받고 싶다면 필드를 추가할 수 있어:
public function fields(NovaRequest $request)
{
return [
Text::make('발행 메모', 'publish_note')
->help('발행과 함께 기록할 메모를 입력하세요.'),
Boolean::make('알림 보내기', 'send_notification')
->help('구독자에게 알림을 보낼지 여부'),
Select::make('발행 타입', 'publish_type')
->options([
'immediate' => '즉시 발행',
'scheduled' => '예약 발행'
])
->displayUsingLabels(),
DateTime::make('예약 시간', 'scheduled_time')
->help('예약 발행 시 발행될 시간')
->hideWhen('publish_type', 'immediate'),
];
}
이제 액션 실행 시 이 필드들의 값을 handle 메서드의 $fields 매개변수로 받을 수 있어:
public function handle(ActionFields $fields, Collection $models)
{
foreach ($models as $model) {
$model->publish_note = $fields->publish_note;
if ($fields->publish_type === 'immediate') {
$model->is_published = true;
$model->published_at = now();
} else {
$model->scheduled_publish_at = $fields->scheduled_time;
}
$model->save();
if ($fields->send_notification) {
// 알림 보내기 로직
NotificationService::send($model);
}
}
return Action::message('처리가 완료되었습니다!');
}
5.3 액션을 리소스에 등록하기 🔌
생성한 액션을 리소스에 등록해야 사용할 수 있어:
// app/Nova/Post.php
public function actions(NovaRequest $request)
{
return [
new Actions\PublishPosts,
new Actions\SendToReview,
new Actions\ArchivePosts,
];
}
5.4 액션 응답 타입 🔄
액션은 다양한 응답을 반환할 수 있어:
// 성공 메시지
return Action::message('성공적으로 처리되었습니다!');
// 오류 메시지
return Action::danger('처리 중 오류가 발생했습니다.');
// 다운로드 응답
return Action::download('파일명.pdf', 저장경로);
// 리다이렉트
return Action::redirect('/some-url');
// 외부 URL로 리다이렉트
return Action::openInNewTab('https://example.com');
5.5 액션 실행 조건 설정 🔒
특정 조건에서만 액션을 사용할 수 있도록 제한할 수 있어:
// 특정 사용자만 액션을 볼 수 있도록
public function authorizedToSee(Request $request)
{
return $request->user()->isAdmin();
}
// 특정 조건에서만 액션을 실행할 수 있도록
public function authorizedToRun(Request $request, $model)
{
return $model->status === 'draft';
}
5.6 액션 큐에 넣기 ⏱️
시간이 오래 걸리는 액션은 큐에 넣어 백그라운드에서 처리할 수 있어:
class GenerateReports extends Action implements ShouldQueue
{
use InteractsWithQueue, Queueable;
public $queue = 'reports';
// 나머지 코드...
}
액션은 관리자 패널에서 일괄 작업을 효율적으로 처리하는 강력한 도구야. 특히 재능넷과 같은 플랫폼에서 여러 사용자나 콘텐츠를 한 번에 관리해야 할 때 매우 유용해! 🚀
6. 렌즈(Lenses)로 데이터 시각화하기 🔍
Nova의 렌즈(Lenses)는 리소스 데이터를 특별한 방식으로 필터링하고 표시할 수 있게 해주는 기능이야. 렌즈를 사용하면 데이터의 특정 부분집합을 쉽게 볼 수 있고, 맞춤형 쿼리와 표시 방식을 정의할 수 있어. 📊
6.1 렌즈 생성하기 🆕
아티즌 명령어로 새 렌즈를 생성해보자:
php artisan nova:lens MostActiveUsers
이 명령어는 app/Nova/Lenses/MostActiveUsers.php 파일을 생성해. 기본 구조는 다음과 같아:
namespace App\Nova\Lenses;
use Laravel\Nova\Fields\ID;
use Laravel\Nova\Fields\Text;
use Laravel\Nova\Fields\Number;
use Laravel\Nova\Http\Requests\LensRequest;
use Laravel\Nova\Http\Requests\NovaRequest;
use Laravel\Nova\Lenses\Lens;
use Illuminate\Database\Eloquent\Builder;
class MostActiveUsers extends Lens
{
/**
* 렌즈에서 사용할 쿼리 가져오기
*/
public static function query(LensRequest $request, $query)
{
return $request->withOrdering($request->withFilters(
$query->withCount('posts')
->orderBy('posts_count', 'desc')
));
}
/**
* 렌즈에 표시할 필드 가져오기
*/
public function fields(NovaRequest $request)
{
return [
ID::make('ID', 'id'),
Text::make('이름', 'name'),
Text::make('이메일', 'email'),
Number::make('게시글 수', 'posts_count'),
];
}
/**
* 렌즈 이름 가져오기
*/
public function name()
{
return '가장 활동적인 사용자';
}
}
6.2 렌즈 쿼리 커스터마이징 🔄
렌즈의 핵심은 query 메서드야. 이 메서드에서 데이터를 어떻게 필터링하고 정렬할지 정의할 수 있어:
public static function query(LensRequest $request, $query)
{
return $request->withOrdering($request->withFilters(
$query->whereHas('orders', function (Builder $query) {
$query->where('total', '>', 1000);
})
->withCount('orders')
->withSum('orders', 'total')
->orderBy('orders_sum_total', 'desc')
));
}
이 예시는 총 주문 금액이 1000 이상인 주문을 한 사용자를 찾고, 주문 금액 합계에 따라 정렬해.
6.3 렌즈 필드 정의하기 📋
렌즈에 표시할 필드를 정의할 수 있어. 일반 리소스 필드와 유사하지만, 쿼리에서 계산된 값도 표시할 수 있어:
public function fields(NovaRequest $request)
{
return [
ID::make('ID', 'id'),
Text::make('이름', 'name'),
Text::make('이메일', 'email'),
Number::make('주문 수', 'orders_count'),
Number::make('총 주문 금액', 'orders_sum_total')
->displayUsing(function ($value) {
return number_format($value) . '원';
}),
DateTime::make('가입일', 'created_at')
->format('Y-m-d'),
];
}
6.4 렌즈 액션 및 필터 추가하기 🛠️
렌즈에도 액션과 필터를 추가할 수 있어:
/**
* 렌즈에서 사용할 액션 가져오기
*/
public function actions(NovaRequest $request)
{
return [
new Actions\SendPromotionEmail,
new Actions\AwardLoyaltyPoints,
];
}
/**
* 렌즈에서 사용할 필터 가져오기
*/
public function filters(NovaRequest $request)
{
return [
new Filters\UserType,
new Filters\DateRange,
];
}
6.5 렌즈를 리소스에 등록하기 🔌
생성한 렌즈를 리소스에 등록해야 사용할 수 있어:
// app/Nova/User.php
public function lenses(NovaRequest $request)
{
return [
new Lenses\MostActiveUsers,
new Lenses\RecentlyRegisteredUsers,
new Lenses\HighValueCustomers,
];
}
6.6 렌즈 사용 사례 💡
렌즈를 활용할 수 있는 몇 가지 좋은 사례를 살펴보자:
- 최근 30일 내 가입한 사용자: 최근 가입자 트렌드를 분석
- 미결제 주문: 결제가 완료되지 않은 주문 목록 확인
- 인기 상품: 판매량이 많은 상품 순으로 정렬
- 휴면 계정: 6개월 이상 로그인하지 않은 사용자 확인
- 지역별 사용자 분포: 지역에 따른 사용자 수 분석
렌즈는 데이터를 다양한 관점에서 바라볼 수 있게 해주는 강력한 도구야. 특히 데이터 분석이 필요한 관리자에게 유용한 기능이지. 재능넷과 같은 플랫폼에서도 다양한 렌즈를 활용해 사용자 활동, 거래 패턴 등을 분석할 수 있을 거야! 📈
7. 필터(Filters)로 데이터 정제하기 🧹
Nova의 필터(Filters)는 리소스 목록을 사용자가 원하는 조건으로 필터링할 수 있게 해주는 기능이야. 필터를 사용하면 관리자가 데이터를 더 쉽게 탐색하고 필요한 정보만 볼 수 있어! 🔎
7.1 필터 생성하기 🆕
아티즌 명령어로 새 필터를 생성해보자:
php artisan nova:filter UserType
이 명령어는 app/Nova/Filters/UserType.php 파일을 생성해. 기본 구조는 다음과 같아:
namespace App\Nova\Filters;
use Laravel\Nova\Filters\Filter;
use Laravel\Nova\Http\Requests\NovaRequest;
class UserType extends Filter
{
/**
* 필터 적용
*/
public function apply(NovaRequest $request, $query, $value)
{
return $query->where('type', $value);
}
/**
* 필터 옵션 가져오기
*/
public function options(NovaRequest $request)
{
return [
'일반 회원' => 'regular',
'프리미엄 회원' => 'premium',
'기업 회원' => 'business',
];
}
}
7.2 필터 타입 🔄
Nova는 세 가지 주요 필터 타입을 제공해:
- Filter: 기본 드롭다운 선택 필터
- BooleanFilter: 여러 체크박스로 구성된 필터
- DateFilter: 날짜 범위 선택 필터
7.3 BooleanFilter 예시 ✅
BooleanFilter는 여러 조건을 동시에 적용할 수 있는 체크박스 필터야:
namespace App\Nova\Filters;
use Laravel\Nova\Filters\BooleanFilter;
use Laravel\Nova\Http\Requests\NovaRequest;
class PostStatusFilter extends BooleanFilter
{
/**
* 필터 적용
*/
public function apply(NovaRequest $request, $query, $value)
{
$filters = collect($value)->filter(function ($value) {
return $value;
})->keys()->all();
if (in_array('is_published', $filters)) {
$query->where('is_published', true);
}
if (in_array('has_comments', $filters)) {
$query->has('comments');
}
if (in_array('featured', $filters)) {
$query->where('is_featured', true);
}
return $query;
}
/**
* 필터 옵션 가져오기
*/
public function options(NovaRequest $request)
{
return [
'발행됨' => 'is_published',
'댓글 있음' => 'has_comments',
'추천 게시글' => 'featured',
];
}
}
7.4 DateFilter 예시 📅
DateFilter는 날짜 기반 필터링을 쉽게 구현할 수 있어:
namespace App\Nova\Filters;
use Laravel\Nova\Filters\DateFilter;
use Laravel\Nova\Http\Requests\NovaRequest;
class CreatedAfter extends DateFilter
{
/**
* 필터 이름 가져오기
*/
public function name()
{
return '생성일 이후';
}
/**
* 필터 적용
*/
public function apply(NovaRequest $request, $query, $value)
{
return $query->whereDate('created_at', '>=', $value);
}
}
7.5 필터 기본값 설정 🔧
필터에 기본값을 설정할 수 있어:
/**
* 필터의 기본값 가져오기
*/
public function default()
{
return 'regular';
}
BooleanFilter의 경우:
/**
* 필터의 기본값 가져오기
*/
public function default()
{
return [
'is_published' => true,
'has_comments' => false,
'featured' => false,
];
}
7.6 필터를 리소스에 등록하기 🔌
생성한 필터를 리소스에 등록해야 사용할 수 있어:
// app/Nova/Post.php
public function filters(NovaRequest $request)
{
return [
new Filters\PostStatusFilter,
new Filters\UserType,
new Filters\CreatedAfter,
];
}
7.7 필터 표시 조건 설정 🔒
특정 조건에서만 필터를 표시할 수 있어:
/**
* 현재 사용자가 필터를 볼 수 있는지 결정합니다.
*/
public function authorizedToSee(Request $request)
{
return $request->user()->isAdmin();
}
7.8 고급 필터 예시 🚀
더 복잡한 필터링 로직을 구현할 수도 있어:
namespace App\Nova\Filters;
use Laravel\Nova\Filters\Filter;
use Laravel\Nova\Http\Requests\NovaRequest;
class OrderStatusFilter extends Filter
{
/**
* 필터 적용
*/
public function apply(NovaRequest $request, $query, $value)
{
if ($value === 'pending_payment') {
return $query->where('status', 'pending')
->whereNull('paid_at');
}
if ($value === 'processing') {
return $query->where('status', 'processing')
->whereNotNull('paid_at')
->whereNull('shipped_at');
}
if ($value === 'completed') {
return $query->where('status', 'completed')
->whereNotNull('delivered_at');
}
return $query->where('status', $value);
}
/**
* 필터 옵션 가져오기
*/
public function options(NovaRequest $request)
{
return [
'결제 대기' => 'pending_payment',
'처리 중' => 'processing',
'배송 중' => 'shipped',
'완료' => 'completed',
'취소됨' => 'cancelled',
'환불됨' => 'refunded',
];
}
}
필터는 관리자가 방대한 데이터에서 필요한 정보를 빠르게 찾을 수 있게 해주는 필수 기능이야. 특히 재능넷처럼 다양한 유형의 데이터를 관리해야 하는 플랫폼에서는 효과적인 필터 시스템이 매우 중요해! 🎯
8. 메트릭(Metrics)으로 통계 구현하기 📊
Nova의 메트릭(Metrics)은 데이터에 대한 통계와 인사이트를 시각적으로 표현할 수 있게 해주는 강력한 기능이야. 메트릭을 사용하면 주요 지표를 한눈에 파악하고 데이터 트렌드를 분석할 수 있어! 📈
8.1 메트릭 타입 🔄
Nova는 세 가지 주요 메트릭 타입을 제공해:
- Value: 단일 값을 표시 (예: 총 사용자 수)
- Trend: 시간에 따른 추이를 차트로 표시 (예: 일별 가입자 수)
- Partition: 데이터 분포를 파이 차트로 표시 (예: 사용자 유형별 분포)
8.2 Value 메트릭 생성하기 🔢
아티즌 명령어로 Value 메트릭을 생성해보자:
php artisan nova:value TotalUsers
이 명령어는 app/Nova/Metrics/TotalUsers.php 파일을 생성해. 기본 구조는 다음과 같아:
namespace App\Nova\Metrics;
use App\Models\User;
use Laravel\Nova\Http\Requests\NovaRequest;
use Laravel\Nova\Metrics\Value;
class TotalUsers extends Value
{
/**
* 메트릭 계산
*/
public function calculate(NovaRequest $request)
{
return $this->count($request, User::class);
}
/**
* 메트릭 이름 가져오기
*/
public function name()
{
return '총 사용자 수';
}
}
8.3 Trend 메트릭 생성하기 📈
아티즌 명령어로 Trend 메트릭을 생성해보자:
php artisan nova:trend NewUsers
이 명령어는 app/Nova/Metrics/NewUsers.php 파일을 생성해. 기본 구조는 다음과 같아:
namespace App\Nova\Metrics;
use App\Models\User;
use Laravel\Nova\Http\Requests\NovaRequest;
use Laravel\Nova\Metrics\Trend;
class NewUsers extends Trend
{
/**
* 메트릭 계산
*/
public function calculate(NovaRequest $request)
{
return $this->countByDays($request, User::class);
}
/**
* 메트릭 이름 가져오기
*/
public function name()
{
return '신규 사용자';
}
/**
* 가능한 범위 옵션 가져오기
*/
public function ranges()
{
return [
30 => '30일',
60 => '60일',
90 => '90일',
];
}
}
8.4 Partition 메트릭 생성하기 🍕
아티즌 명령어로 Partition 메트릭을 생성해보자:
php artisan nova:partition UsersPerRole
이 명령어는 app/Nova/Metrics/UsersPerRole.php 파일을 생성해. 기본 구조는 다음과 같아:
namespace App\Nova\Metrics;
use App\Models\User;
use Laravel\Nova\Http\Requests\NovaRequest;
use Laravel\Nova\Metrics\Partition;
class UsersPerRole extends Partition
{
/**
* 메트릭 계산
*/
public function calculate(NovaRequest $request)
{
return $this->count($request, User::class, 'role');
}
/**
* 메트릭 이름 가져오기
*/
public function name()
{
return '역할별 사용자 수';
}
}
8.5 메트릭 커스터마이징 🎨
메트릭의 표시 방식을 커스터마이징할 수 있어:
// Value 메트릭 커스터마이징
public function calculate(NovaRequest $request)
{
return $this->result(User::count())
->previous(User::where('created_at', '<', now()->subMonth())->count())
->format('0,0')
->suffix('명');
}
// Trend 메트릭 커스터마이징
public function calculate(NovaRequest $request)
{
return $this->sumByDays($request, Order::class, 'total')
->showSumValue()
->suffix('원')
->dollars();
}
// Partition 메트릭 커스터마이징
public function calculate(NovaRequest $request)
{
return $this->count($request, User::class, 'role')
->label(function ($value) {
return match($value) {
'admin' => '관리자',
'editor' => '편집자',
'user' => '일반 사용자',
default => $value,
};
})
->colors([
'admin' => '#7e57c2',
'editor' => '#26a69a',
'user' => '#42a5f5',
]);
}
8.6 메트릭을 리소스나 대시보드에 등록하기 🔌
생성한 메트릭을 리소스나 대시보드에 등록해야 사용할 수 있어:
// app/Nova/User.php (리소스에 등록)
public function cards(NovaRequest $request)
{
return [
new Metrics\TotalUsers,
new Metrics\NewUsers,
new Metrics\UsersPerRole,
];
}
// app/Nova/Dashboards/Main.php (대시보드에 등록)
public function cards()
{
return [
new Metrics\TotalUsers,
new Metrics\NewUsers,
new Metrics\UsersPerRole,
new Metrics\OrdersPerDay,
new Metrics\AverageOrderValue,
];
}
8.7 메트릭 새로고침 간격 설정 ⏱️
메트릭이 자동으로 새로고침되는 간격을 설정할 수 있어:
/**
* 메트릭 새로고침 간격 (초)
*/
public function refreshInterval()
{
return 300; // 5분
}
8.8 고급 메트릭 예시 🚀
더 복잡한 메트릭을 구현할 수도 있어:
namespace App\Nova\Metrics;
use App\Models\Order;
use Laravel\Nova\Http\Requests\NovaRequest;
use Laravel\Nova\Metrics\Value;
class ConversionRate extends Value
{
/**
* 메트릭 계산
*/
public function calculate(NovaRequest $request)
{
$totalVisits = \App\Models\Visit::count();
$totalOrders = Order::count();
$conversionRate = $totalVisits > 0
? ($totalOrders / $totalVisits) * 100
: 0;
return $this->result(round($conversionRate, 2))
->suffix('%')
->format('0.00');
}
/**
* 메트릭 이름 가져오기
*/
public function name()
{
return '전환율';
}
}
메트릭은 데이터를 시각적으로 이해하기 쉽게 표현해주는 강력한 도구야. 특히 재능넷과 같은 플랫폼에서는 사용자 활동, 거래량, 수익 등의 중요 지표를 메트릭으로 표시하면 비즈니스 현황을 한눈에 파악할 수 있어! 📊
9. 카드(Cards)로 대시보드 꾸미기 🎴
Nova의 카드(Cards)는 대시보드와 리소스 페이지를 커스터마이징할 수 있게 해주는 기능이야. 카드를 사용하면 메트릭, 차트, 커스텀 컴포넌트 등을 배치해 정보를 효과적으로 표시할 수 있어! 🖼️
9.1 카드 생성하기 🆕
아티즌 명령어로 새 카드를 생성해보자:
php artisan nova:card LatestUsers
이 명령어는 app/Nova/Cards/LatestUsers.php 파일과 Vue 컴포넌트를 생성해. 기본 구조는 다음과 같아:
namespace App\Nova\Cards;
use Laravel\Nova\Card;
class LatestUsers extends Card
{
/**
* 카드 컴포넌트 이름
*/
public function component()
{
return 'latest-users';
}
}
또한 resources/js/cards/LatestUsers.vue 파일도 생성돼:
<template>
<card class="px-4 py-4">
<h3 class="text-lg font-bold mb-4">최근 가입한 사용자</h3>
<div v-if="loading">로딩 중...</div>
<div v-else>
<ul>
<li v-for="user in users" :key="user.id" class="mb-2">
{{ user.name }} - {{ user.created_at }}
</li>
</ul>
</div>
</card>
</template>
<script>
export default {
data() {
return {
loading: true,
users: []
}
},
mounted() {
this.fetchUsers()
},
methods: {
fetchUsers() {
Nova.request().get('/nova-api/latest-users').then(response => {
this.users = response.data.users
this.loading = false
})
}
}
}
</script>
9.2 카드 등록하기 🔌
생성한 카드를 대시보드나 리소스에 등록해야 사용할 수 있어:
// app/Nova/Dashboards/Main.php (대시보드에 등록)
public function cards()
{
return [
new Metrics\TotalUsers,
new Metrics\NewUsers,
new Cards\LatestUsers,
new Cards\PopularProducts,
];
}
// app/Nova/User.php (리소스에 등록)
public function cards(NovaRequest $request)
{
return [
new Metrics\TotalUsers,
new Cards\UserActivityChart,
new Cards\UserRoleDistribution,
];
}
9.3 카드 크기 설정 📏
카드의 너비를 설정할 수 있어:
/**
* 카드 너비 가져오기
*/
public function width()
{
// 'full', '1/2', '1/3', '1/4', '2/3' 중 선택
return '1/2';
}
9.4 카드 API 엔드포인트 생성하기 🔄
카드에 데이터를 제공하기 위한 API 엔드포인트를 생성해야 해:
// routes/api.php
Route::get('/nova-api/latest-users', function () {
return response()->json([
'users' => \App\Models\User::latest()->take(5)->get(['id', 'name', 'email', 'created_at'])
]);
});
9.5 카드에 매개변수 전달하기 📦
카드에 매개변수를 전달할 수 있어:
// 카드 인스턴스 생성 시 매개변수 전달
new Cards\LatestUsers(5), // 5명의 최근 사용자 표시
// 카드 클래스에서 매개변수 처리
class LatestUsers extends Card
{
public $limit;
public function __construct($limit = 5)
{
$this->limit = $limit;
}
public function component()
{
return 'latest-users';
}
public function withMeta(array $meta = [])
{
return parent::withMeta(array_merge([
'limit' => $this->limit,
], $meta));
}
}
// Vue 컴포넌트에서 매개변수 사용
export default {
props: ['card'],
data() {
return {
loading: true,
users: []
}
},
mounted() {
this.fetchUsers()
},
methods: {
fetchUsers() {
Nova.request().get('/nova-api/latest-users', {
params: { limit: this.card.limit }
}).then(response => {
this.users = response.data.users
this.loading = false
})
}
}
}
9.6 다양한 카드 예시 💡
다양한 유형의 카드를 만들 수 있어:
- 최근 활동 로그: 시스템의 최근 활동을 표시
- 인기 제품 목록: 가장 많이 판매된 제품 표시
- 지역별 사용자 지도: 사용자 분포를 지도로 표시
- 시스템 상태 대시보드: 서버 상태, 큐 상태 등 표시
- 외부 API 통합: 날씨, 주식 시세 등 외부 데이터 표시
9.7 대시보드 생성 및 구성 🏠
여러 대시보드를 생성하고 구성할 수 있어:
php artisan nova:dashboard Analytics
이 명령어는 app/Nova/Dashboards/Analytics.php 파일을 생성해. 기본 구조는 다음과 같아:
namespace App\Nova\Dashboards;
use Laravel\Nova\Dashboard;
class Analytics extends Dashboard
{
/**
* 대시보드에 표시할 카드 가져오기
*/
public function cards()
{
return [
new \App\Nova\Metrics\VisitorsPerDay,
new \App\Nova\Metrics\PageViews,
new \App\Nova\Metrics\BounceRate,
new \App\Nova\Cards\TopPages,
new \App\Nova\Cards\UserSources,
];
}
/**
* 대시보드 이름 가져오기
*/
public function name()
{
return '분석 대시보드';
}
}
그리고 app/Providers/NovaServiceProvider.php에 대시보드를 등록해야 해:
protected function dashboards()
{
return [
new \App\Nova\Dashboards\Main,
new \App\Nova\Dashboards\Analytics,
new \App\Nova\Dashboards\Sales,
];
}
카드는 Nova 대시보드를 풍부하고 유용하게 만드는 핵심 요소야. 메트릭과 함께 사용하면 재능넷과 같은 플랫폼의 관리자 패널을 직관적이고 정보가 풍부한 공간으로 만들 수 있어! 🎯
10. 커스텀 필드와 도구 개발하기 🛠️
Nova의 기본 기능만으로도 강력한 관리자 패널을 구축할 수 있지만, 커스텀 필드와 도구를 개발하면 더욱 특화된 기능을 구현할 수 있어! 이제 Nova를 확장하는 방법을 알아보자. 🧩
10.1 커스텀 필드 생성하기 🆕
아티즌 명령어로 새 필드를 생성해보자:
php artisan nova:field ColorPicker
이 명령어는 app/Nova/Fields/ColorPicker.php 파일과 Vue 컴포넌트를 생성해. 기본 구조는 다음과 같아:
namespace App\Nova\Fields;
use Laravel\Nova\Fields\Field;
class ColorPicker extends Field
{
/**
* 필드 컴포넌트
*/
public $component = 'color-picker';
/**
* 기본 HEX 색상 설정
*/
public function defaultColor($color)
{
return $this->withMeta(['defaultColor' => $color]);
}
}
또한 resources/js/fields/ColorPicker.vue 파일도 생성돼:
<template>
<default-field :field="field" :errors="errors">
<template slot="field">
<input
:id="field.name"
type="color"
class="w-full form-control form-input form-input-bordered"
:value="value"
v-on:input="handleChange"
:placeholder="field.name"
/>
<div class="mt-1">{{ value }}</div>
</template>
</default-field>
</template>
<script>
export default {
props: ['resourceName', 'resourceId', 'field'],
data() {
return {
value: this.field.value || this.field.defaultColor || '#000000',
}
},
methods: {
handleChange(event) {
this.value = event.target.value
this.$emit('input', this.value)
}
}
}
</script>
10.2 커스텀 필드 등록하기 🔌
생성한 필드를 NovaServiceProvider에 등록해야 해:
// app/Providers/NovaServiceProvider.php
use Laravel\Nova\Nova;
use App\Nova\Fields\ColorPicker;
public function boot()
{
parent::boot();
Nova::serving(function () {
Nova::script('color-picker', __DIR__ . '/../../public/js/fields/color-picker.js');
});
}
그리고 필드를 컴파일해야 해:
// webpack.mix.js
mix.js('resources/js/fields/ColorPicker.js', 'public/js/fields');
10.3 커스텀 필드 사용하기 📝
이제 리소스에서 커스텀 필드를 사용할 수 있어:
// app/Nova/Product.php
use App\Nova\Fields\ColorPicker;
public function fields(NovaRequest $request)
{
return [
ID::make()->sortable(),
Text::make('이름', 'name'),
ColorPicker::make('색상', 'color')
->defaultColor('#ff5733'),
];
}
10.4 커스텀 도구(Tool) 생성하기 🧰
아티즌 명령어로 새 도구를 생성해보자:
php artisan nova:tool ImportExport
이 명령어는 도구 패키지의 기본 구조를 생성해. 주요 파일은 다음과 같아:
src/ImportExport.php: 도구의 메인 클래스resources/js/tool.js: 도구의 JavaScript 엔트리 포인트resources/js/components/Tool.vue: 도구의 메인 Vue 컴포넌트routes/api.php: 도구의 API 라우트
10.5 커스텀 도구 등록하기 🔌
생성한 도구를 NovaServiceProvider에 등록해야 해:
// app/Providers/NovaServiceProvider.php
protected function tools()
{
return [
new \App\Nova\Tools\ImportExport,
];
}
10.6 커스텀 액션 생성하기 🔄
특별한 UI가 필요한 커스텀 액션을 생성할 수도 있어:
php artisan nova:action ExportToCsv --destructive
이 명령어는 app/Nova/Actions/ExportToCsv.php 파일을 생성해. 기본 구조를 확장해보자:
namespace App\Nova\Actions;
use Illuminate\Bus\Queueable;
use Laravel\Nova\Actions\Action;
use Illuminate\Support\Collection;
use Laravel\Nova\Fields\ActionFields;
use Illuminate\Queue\InteractsWithQueue;
use Laravel\Nova\Fields\Select;
use Laravel\Nova\Fields\Boolean;
use Laravel\Nova\Http\Requests\NovaRequest;
class ExportToCsv extends Action
{
use InteractsWithQueue, Queueable;
/**
* 액션이 파괴적인지 여부
*/
public $destructive = false;
/**
* 액션 실행
*/
public function handle(ActionFields $fields, Collection $models)
{
// CSV 파일 생성
$csv = $this->generateCsv($models, $fields->columns, $fields->include_header);
// 다운로드 제공
return Action::download(
$fields->filename . '.csv',
$csv
);
}
/**
* 액션 필드
*/
public function fields(NovaRequest $request)
{
return [
Select::make('내보낼 컬럼', 'columns')
->options([
'all' => '모든 컬럼',
'basic' => '기본 정보만',
'custom' => '사용자 정의'
])
->displayUsingLabels(),
Boolean::make('헤더 포함', 'include_header')
->default(true),
Text::make('파일명', 'filename')
->default('export-' . date('Y-m-d'))
->rules('required'),
];
}
/**
* CSV 생성 메서드
*/
protected function generateCsv($models, $columnType, $includeHeader)
{
// CSV 생성 로직
$output = fopen('php://temp', 'r+');
// 컬럼 결정
$columns = $this->getColumns($columnType, $models->first());
// 헤더 추가
if ($includeHeader) {
fputcsv($output, $columns);
}
// 데이터 추가
foreach ($models as $model) {
$row = [];
foreach ($columns as $column) {
$row[] = $model->{$column} ?? '';
}
fputcsv($output, $row);
}
rewind($output);
$csv = stream_get_contents($output);
fclose($output);
return $csv;
}
/**
* 컬럼 목록 가져오기
*/
protected function getColumns($columnType, $model)
{
if ($columnType === 'all') {
return array_keys($model->getAttributes());
}
if ($columnType === 'basic') {
return ['id', 'name', 'created_at'];
}
// custom은 별도 로직으로 처리
return ['id', 'name'];
}
}
10.7 커스텀 메트릭 생성하기 📊
특별한 계산이 필요한 커스텀 메트릭을 생성할 수도 있어:
namespace App\Nova\Metrics;
use App\Models\Order;
use App\Models\User;
use Laravel\Nova\Metrics\Value;
use Laravel\Nova\Http\Requests\NovaRequest;
class AverageOrdersPerUser extends Value
{
/**
* 메트릭 계산
*/
public function calculate(NovaRequest $request)
{
$totalUsers = User::count();
$totalOrders = Order::count();
$average = $totalUsers > 0
? $totalOrders / $totalUsers
: 0;
return $this->result(round($average, 2));
}
/**
* 메트릭 이름 가져오기
*/
public function name()
{
return '사용자당 평균 주문 수';
}
/**
* 메트릭 아이콘 가져오기
*/
public function icon()
{
return 'chart-bar';
}
}
10.8 커스텀 리소스 도구 생성하기 🔧
특정 리소스에만 표시되는 도구를 생성할 수도 있어:
php artisan nova:resource-tool UserActivityLog
이 명령어는 리소스 도구의 기본 구조를 생성해. 이를 리소스에 등록하려면:
// app/Nova/User.php
public function fields(NovaRequest $request)
{
return [
ID::make()->sortable(),
// 다른 필드들...
// 상세 페이지에서만 표시
ResourceTools\UserActivityLog::make()
->onlyOnDetail(),
];
}
커스텀 필드와 도구를 개발하면 Nova의 기능을 무한히 확장할 수 있어. 특히 재능넷과 같은 특화된 플랫폼에서는 비즈니스 로직에 맞는 커스텀 컴포넌트를 개발하면 관리 효율성을 크게 높일 수 있어! 🚀
11. Nova 활용 실전 사례 🎯
이제 Laravel Nova를 실제 프로젝트에서 어떻게 활용할 수 있는지 몇 가지 실전 사례를 살펴보자! 특히 재능넷과 같은 플랫폼에서 Nova를 어떻게 활용할 수 있을지 생각해보면 좋을 것 같아. 💡
11.1 콘텐츠 관리 시스템 (CMS) 구축 📝
Nova는 블로그, 뉴스 사이트, 포트폴리오 등의 콘텐츠 관리 시스템을 쉽게 구축할 수 있어:
- 리소스 구성: 게시글, 카테고리, 태그, 댓글 등의 리소스 생성
- WYSIWYG 에디터: Trix 필드를 사용한 풍부한 텍스트 편집
- 미디어 라이브러리: 이미지, 비디오 등의 미디어 관리
- 버전 관리: 게시글 변경 이력 추적
- 예약 발행: 게시글 예약 발행 기능 구현
예시 코드:
// app/Nova/Post.php
public function fields(NovaRequest $request)
{
return [
ID::make()->sortable(),
Text::make('제목', 'title')
->rules('required', 'max:255')
->sortable(),
Slug::make('슬러그', 'slug')
->from('title')
->rules('required', 'max:255')
->hideFromIndex(),
BelongsTo::make('작성자', 'author', User::class),
BelongsTo::make('카테고리', 'category', Category::class),
BelongsToMany::make('태그', 'tags', Tag::class),
Trix::make('내용', 'content')
->rules('required')
->hideFromIndex(),
Image::make('썸네일', 'thumbnail')
->disk('public')
->path('thumbnails')
->prunable()
->hideFromIndex(),
Boolean::make('발행 여부', 'is_published')
->trueValue('발행됨')
->falseValue('임시저장'),
DateTime::make('발행일', 'published_at')
->nullable()
->hideWhenCreating(),
HasMany::make('댓글', 'comments', Comment::class),
];
}
11.2 전자상거래 플랫폼 관리 🛒
Nova로 전자상거래 플랫폼의 관리자 패널을 구축할 수 있어:
- 제품 관리: 제품, 카테고리, 옵션, 재고 관리
- 주문 처리: 주문 상태 관리, 결제 정보 확인
- 고객 관리: 고객 정보, 구매 이력 관리
- 할인 및 프로모션: 쿠폰, 세일, 특별 행사 관리
- 판매 분석: 매출, 인기 제품, 전환율 등 분석
예시 코드:
// app/Nova/Order.php
public function fields(NovaRequest $request)
{
return [
ID::make()->sortable(),
BelongsTo::make('고객', 'customer', User::class),
Select::make('상태', 'status')
->options([
'pending' => '결제 대기',
'paid' => '결제 완료',
'processing' => '처리 중',
'shipped' => '배송 중',
'delivered' => '배송 완료',
'cancelled' => '취소됨',
'refunded' => '환불됨'
])
->displayUsingLabels()
->sortable(),
Number::make('총액', 'total')
->displayUsing(fn ($value) => number_format($value) . '원')
->sortable(),
DateTime::make('주문일', 'created_at')
->format('Y-m-d H:i')
->sortable(),
HasMany::make('주문 상품', 'items', OrderItem::class),
Text::make('배송 주소', 'shipping_address')
->onlyOnDetail(),
Text::make('연락처', 'phone')
->onlyOnDetail(),
Text::make('배송 메모', 'shipping_note')
->onlyOnDetail(),
];
}
public function actions(NovaRequest $request)
{
return [
new Actions\ProcessOrder,
new Actions\ShipOrder,
new Actions\CancelOrder,
new Actions\RefundOrder,
new Actions\SendInvoice,
];
}
11.3 재능 거래 플랫폼 관리 (재능넷 사례) 🌟
재능넷과 같은 재능 거래 플랫폼에서 Nova를 활용하는 방법을 살펴보자:
- 재능 서비스 관리: 등록된 재능 서비스 관리 및 승인
- 사용자 관리: 판매자와 구매자 정보 관리
- 거래 관리: 주문, 결제, 완료 상태 관리
- 리뷰 및 평점 관리: 서비스 리뷰 및 평점 관리
- 카테고리 관리: 서비스 카테고리 및 태그 관리
- 분쟁 해결: 구매자-판매자 간 분쟁 관리
- 수수료 및 정산 관리: 판매자 정산 및 플랫폼 수수료 관리
예시 코드:
// app/Nova/Talent.php (재능 서비스 리소스)
public function fields(NovaRequest $request)
{
return [
ID::make()->sortable(),
Text::make('제목', 'title')
->rules('required', 'max:255')
->sortable(),
BelongsTo::make('판매자', 'seller', User::class),
BelongsTo::make('카테고리', 'category', Category::class),
BelongsToMany::make('태그', 'tags', Tag::class),
Number::make('가격', 'price')
->displayUsing(fn ($value) => number_format($value) . '원')
->sortable(),
Number::make('평균 평점', 'average_rating')
->displayUsing(fn ($value) => $value ? number_format($value, 1) : '평가 없음')
->sortable(),
Number::make('판매 수', 'sales_count')
->sortable(),
Select::make('상태', 'status')
->options([
'pending' => '승인 대기',
'active' => '활성화',
'rejected' => '거부됨',
'paused' => '일시 중지',
'deleted' => '삭제됨'
])
->displayUsingLabels()
->sortable(),
Trix::make('설명', 'description')
->hideFromIndex(),
Images::make('포트폴리오', 'portfolio')
->hideFromIndex(),
DateTime::make('등록일', 'created_at')
->format('Y-m-d')
->sortable(),
];
}
public function actions(NovaRequest $request)
{
return [
new Actions\ApproveTalent,
new Actions\RejectTalent,
new Actions\FeatureTalent,
new Actions\SendMessageToSeller,
];
}
public function cards(NovaRequest $request)
{
return [
new Metrics\TalentsPerCategory,
new Metrics\AverageTalentPrice,
new Metrics\NewTalentsPerDay,
];
}
11.4 대시보드 구성 예시 📊
재능넷 플랫폼의 메인 대시보드 구성 예시:
// app/Nova/Dashboards/Main.php
public function cards()
{
return [
// 주요 지표 (Value 메트릭)
new Metrics\TotalUsers,
new Metrics\TotalTalents,
new Metrics\TotalOrders,
new Metrics\TotalRevenue,
// 트렌드 (Trend 메트릭)
new Metrics\NewUsersPerDay,
new Metrics\OrdersPerDay,
new Metrics\RevenuePerDay,
// 분포 (Partition 메트릭)
new Metrics\UsersPerRole,
new Metrics\TalentsPerCategory,
new Metrics\OrdersPerStatus,
// 커스텀 카드
new Cards\RecentOrders,
new Cards\PendingTalents,
new Cards\TopSellers,
new Cards\RecentReviews,
];
}
11.5 알림 및 메시징 시스템 📨
Nova를 통해 플랫폼 사용자에게 알림을 보내는 시스템을 구축할 수 있어:
// app/Nova/Actions/SendNotification.php
public function handle(ActionFields $fields, Collection $models)
{
foreach ($models as $user) {
// 알림 생성
$notification = new \App\Notifications\CustomNotification(
$fields->title,
$fields->message,
$fields->type
);
// 알림 전송
$user->notify($notification);
}
return Action::message('알림이 ' . count($models) . '명의 사용자에게 전송되었습니다.');
}
public function fields(NovaRequest $request)
{
return [
Text::make('제목', 'title')
->rules('required', 'max:255'),
Textarea::make('내용', 'message')
->rules('required'),
Select::make('알림 유형', 'type')
->options([
'info' => '정보',
'success' => '성공',
'warning' => '주의',
'error' => '오류',
])
->displayUsingLabels()
->rules('required'),
];
}
Nova는 다양한 비즈니스 모델에 맞게 유연하게 적용할 수 있어. 특히 재능넷과 같은 중개 플랫폼에서는 판매자, 구매자, 서비스, 거래 등 복잡한 관계를 효율적으로 관리할 수 있는 강력한 도구가 될 수 있어! 🚀
12. 마무리 및 추가 자료 📚
지금까지 Laravel Nova를 사용하여 관리자 패널을 빠르게 구축하는 방법에 대해 알아봤어! Nova는 강력하면서도 유연한 관리자 패널 솔루션으로, 다양한 웹 애플리케이션에 적용할 수 있어. 특히 재능넷과 같은 복잡한 비즈니스 로직을 가진 플랫폼에서도 효율적인 관리 도구로 활용할 수 있지! 🚀
12.1 Nova의 장단점 정리 ⚖️
장점:
- 빠른 개발 속도: 기본 CRUD 작업을 자동화하여 개발 시간 단축
- 아름다운 UI: 모던하고 직관적인 인터페이스 제공
- 확장성: 커스텀 필드, 카드, 액션 등으로 확장 가능
- Laravel 통합: Laravel 생태계와 완벽하게 통합
- 보안: 견고한 인증 및 권한 시스템 내장
단점:
- 유료 라이선스: 프로젝트당 $199의 비용 발생
- 학습 곡선: Vue.js 지식이 필요한 고급 커스터마이징
- 오버헤드: 작은 프로젝트에는 과도할 수 있음
- 제한된 테마: 기본 테마 커스터마이징의 한계
12.2 Nova 대안 비교 🔄
Nova 외에도 Laravel에서 사용할 수 있는 관리자 패널 솔루션이 있어:
- Voyager: 무료 오픈소스, 드래그 앤 드롭 UI 빌더 포함
- Backpack for Laravel: 유료/무료 하이브리드, 확장 가능한 CRUD 빌더
- Filament: 무료 오픈소스, TALL 스택 기반 관리자 패널
- 직접 구현: 완전한 커스터마이징이 필요한 경우
프로젝트 요구사항과 예산에 따라 적절한 솔루션을 선택하는 것이 중요해!
12.3 추가 학습 자료 📖
Nova에 대해 더 자세히 알아보고 싶다면 다음 자료를 참고해봐:
12.4 Nova 업데이트 및 미래 🔮
Nova는 지속적으로 업데이트되고 있어. 최신 버전인 Nova 4는 Laravel 9+와 PHP 8+를 지원하며, 더 많은 기능과 개선된 성능을 제공해. 앞으로도 Laravel 생태계의 발전에 맞춰 계속 진화할 것으로 예상돼.
특히 주목할 만한 최신 기능들:
- 향상된 검색 기능
- 더 많은 필드 타입
- 개선된 관계 관리
- 더 나은 모바일 지원
- 성능 최적화
12.5 마무리 인사 👋
이제 Laravel Nova를 사용하여 멋진 관리자 패널을 구축할 준비가 되었어! Nova의 강력한 기능을 활용하면 개발 시간을 크게 단축하면서도 사용자 친화적인 관리자 경험을 제공할 수 있어.
재능넷과 같은 플랫폼을 운영하고 있다면, Nova를 도입하여 관리 효율성을 높이고 더 나은 서비스를 제공하는 데 집중할 수 있을 거야. 개발 시간을 절약하고 비즈니스 로직에 더 많은 시간을 투자할 수 있으니까! 💪
Nova에 대해 더 궁금한 점이 있거나 실제 구현에 도움이 필요하다면 언제든지 질문해줘. 함께 멋진 관리자 패널을 만들어보자! 🎉
댓글 작성
이 글에 대한 여러분의 생각을 들려주세요
로그인이 필요합니다
댓글을 작성하려면 먼저 로그인해주세요.
댓글 0
지식인의 숲 - 지적 재산권 보호 고지
지적 재산권 보호 고지
- 저작권 및 소유권: 본 컨텐츠는 재능넷의 독점 AI 기술로 생성되었으며, 대한민국 저작권법 및 국제 저작권 협약에 의해 보호됩니다.
- AI 생성 컨텐츠의 법적 지위: 본 AI 생성 컨텐츠는 재능넷의 지적 창작물로 인정되며, 관련 법규에 따라 저작권 보호를 받습니다.
- 사용 제한: 재능넷의 명시적 서면 동의 없이 본 컨텐츠를 복제, 수정, 배포, 또는 상업적으로 활용하는 행위는 엄격히 금지됩니다.
- 데이터 수집 금지: 본 컨텐츠에 대한 무단 스크래핑, 크롤링, 및 자동화된 데이터 수집은 법적 제재의 대상이 됩니다.
- AI 학습 제한: 재능넷의 AI 생성 컨텐츠를 타 AI 모델 학습에 무단 사용하는 행위는 금지되며, 이는 지적 재산권 침해로 간주됩니다.
아직 댓글이 없습니다.