🎨 크리에이터 커미션 워크플로우 매니저 - 의뢰부터 납품까지 전 과정 자동화

mkdir creator-commission-workflow-manager && cd creator-commission-workflow-manager

이 폴더에서 Laravel 13.x 프로젝트를 시작합니다.

**목표**: Laravel 프로젝트 초기 설정 및 데이터베이스 스키마 설계

다음을 수행하세요:

1. **Laravel 13.x 프로젝트 생성**:
   - `composer create-project laravel/laravel . "13.*"`
   - `.env` 파일에서 DB 설정 (MySQL 사용, DB명: commission_manager)
   - `php artisan key:generate`

2. **Laravel Breeze 설치** (Blade 스택):
   - `composer require laravel/breeze --dev`
   - `php artisan breeze:install blade`
   - `npm install && npm run build`
   - 마이그레이션 실행: `php artisan migrate`

3. **데이터베이스 스키마 설계 및 마이그레이션 생성**:

   다음 테이블을 생성하는 마이그레이션 파일을 만드세요:

   **a) users 테이블 (Breeze 기본 + 확장)**:
   - role: enum('creator', 'client') - 사용자 역할
   - bio: text nullable - 크리에이터 소개
   - portfolio_url: string nullable
   - hourly_rate: decimal(10,2) nullable - 시간당 요금 (크리에이터용)

   **b) commissions 테이블**:
   - id, uuid (고유 식별자)
   - client_id (users 외래키)
   - creator_id (users 외래키, nullable - 견적 승인 전까지 null)
   - title: string - 커미션 제목
   - type: enum('character_design', 'logo', 'illustration', 'animation', 'other')
   - description: text - 상세 요구사항
   - reference_images: json nullable - 참고 이미지 URL 배열
   - budget_range: string nullable - 예산 범위 (예: "$100-$200")
   - deadline: date nullable - 희망 납품일
   - status: enum('pending', 'quoted', 'in_progress', 'completed', 'cancelled') default 'pending'
   - timestamps

   **c) quotes 테이블** (견적서):
   - id
   - commission_id (외래키)
   - creator_id (외래키)
   - price: decimal(10,2) - 견적 금액
   - estimated_days: integer - 예상 소요 일수
   - message: text - 견적 설명
   - status: enum('pending', 'accepted', 'rejected') default 'pending'
   - timestamps

   **d) workflow_stages 테이블** (작업 단계):
   - id
   - commission_id (외래키)
   - name: string - 단계 이름 (예: "스케치", "초안", "최종본")
   - order: integer - 순서
   - status: enum('pending', 'in_progress', 'completed') default 'pending'
   - completed_at: timestamp nullable
   - timestamps

   **e) commission_files 테이블** (업로드 파일):
   - id
   - commission_id (외래키)
   - workflow_stage_id (외래키, nullable)
   - uploader_id (users 외래키)
   - file_path: string - storage 경로
   - file_name: string - 원본 파일명
   - file_size: integer - 바이트 단위
   - version: integer default 1 - 버전 번호
   - timestamps

   **f) feedbacks 테이블** (피드백/댓글):
   - id
   - commission_id (외래키)
   - workflow_stage_id (외래키, nullable)
   - user_id (외래키)
   - comment: text
   - timestamps

4. **마이그레이션 실행**:
   - `php artisan migrate`

5. **모델 생성 및 관계 설정**:
   - Commission, Quote, WorkflowStage, CommissionFile, Feedback 모델 생성
   - Eloquent 관계 정의:
     - Commission: belongsTo(User, 'client_id'), belongsTo(User, 'creator_id'), hasMany(Quote), hasMany(WorkflowStage), hasMany(CommissionFile), hasMany(Feedback)
     - Quote: belongsTo(Commission), belongsTo(User, 'creator_id')
     - WorkflowStage: belongsTo(Commission), hasMany(CommissionFile)
     - CommissionFile: belongsTo(Commission), belongsTo(WorkflowStage), belongsTo(User, 'uploader_id')
     - Feedback: belongsTo(Commission), belongsTo(WorkflowStage), belongsTo(User)

모든 설정이 완료되면 `php artisan migrate:status`로 확인하세요.

**목표**: 고객이 커미션 의뢰서를 작성하고 제출하는 기능 구현

다음을 수행하세요:

1. **CommissionController 생성**:
   - `php artisan make:controller CommissionController --resource`

2. **라우트 설정** (routes/web.php):
   ```php
   Route::middleware(['auth'])->group(function () {
       Route::resource('commissions', CommissionController::class);
   });
   ```

3. **커미션 생성 폼 뷰** (resources/views/commissions/create.blade.php):
   - Tailwind CSS로 스타일링된 폼 생성
   - 필드:
     - 제목 (input text, required)
     - 작업 유형 (select: character_design, logo, illustration, animation, other)
     - 상세 요구사항 (textarea, required, 최소 50자)
     - 참고 이미지 업로드 (multiple file input, 선택사항, 이미지만 허용)
     - 예산 범위 (input text, 예: "$100-$200")
     - 희망 납품일 (date input)
   - Alpine.js로 파일 업로드 미리보기 기능 추가
   - CSRF 토큰 포함

4. **CommissionController@store 메서드**:
   - FormRequest 생성: `php artisan make:request StoreCommissionRequest`
   - 검증 규칙:
     - title: required, max:255
     - type: required, in:character_design,logo,illustration,animation,other
     - description: required, min:50
     - reference_images.*: image, max:5120 (5MB)
     - budget_range: nullable, max:50
     - deadline: nullable, date, after:today
   - 로직:
     - 참고 이미지를 storage/app/public/references에 저장
     - Commission 레코드 생성 (client_id는 auth()->id())
     - reference_images는 JSON 배열로 저장
     - 성공 시 성공 메시지와 함께 대시보드로 리디렉션

5. **대시보드 뷰 수정** (resources/views/dashboard.blade.php):
   - 역할별 대시보드:
     - **고객**: "새 커미션 의뢰하기" 버튼, 내 의뢰 목록 (상태별 필터)
     - **크리에이터**: 새로운 의뢰 목록 (status='pending'), 진행 중인 작업 목록
   - 각 커미션 카드에 제목, 유형, 상태, 생성일 표시
   - 카드 클릭 시 상세 페이지로 이동

6. **네비게이션 메뉴 업데이트** (resources/views/layouts/navigation.blade.php):
   - "내 커미션" 링크 추가
   - 역할에 따라 다른 메뉴 표시 (크리에이터는 "의뢰 목록", 고객은 "내 의뢰")

7. **테스트**:
   - 고객 계정으로 로그인 후 커미션 생성 폼 작성 및 제출
   - 데이터베이스에 정상 저장 확인
   - 이미지 파일이 storage/app/public/references에 저장되는지 확인
   - 심볼릭 링크 생성: `php artisan storage:link`

**목표**: 크리에이터가 의뢰를 검토하고 견적서를 발송하는 기능 구현

다음을 수행하세요:

1. **QuoteController 생성**:
   - `php artisan make:controller QuoteController`

2. **라우트 추가** (routes/web.php):
   ```php
   Route::middleware(['auth'])->group(function () {
       Route::post('commissions/{commission}/quotes', [QuoteController::class, 'store'])->name('quotes.store');
       Route::patch('quotes/{quote}/accept', [QuoteController::class, 'accept'])->name('quotes.accept');
       Route::patch('quotes/{quote}/reject', [QuoteController::class, 'reject'])->name('quotes.reject');
   });
   ```

3. **커미션 상세 페이지** (resources/views/commissions/show.blade.php):
   - 커미션 정보 표시:
     - 제목, 유형, 상세 설명, 예산 범위, 희망 납품일
     - 참고 이미지 갤러리 (있는 경우)
     - 현재 상태 배지 (pending, quoted, in_progress, completed)
   - **크리에이터 전용 섹션** (status='pending'일 때만 표시):
     - 견적서 작성 폼:
       - 견적 금액 (input number, required)
       - 예상 소요 일수 (input number, required)
       - 견적 설명 (textarea, required)
       - "견적서 발송" 버튼
   - **고객 전용 섹션** (status='quoted'일 때만 표시):
     - 받은 견적서 목록 (가격, 소요 일수, 설명, 크리에이터 정보)
     - 각 견적서마다 "승인" / "거절" 버튼
   - Alpine.js로 견적서 폼 토글 기능 추가

4. **QuoteController@store 메서드**:
   - FormRequest 생성: `php artisan make:request StoreQuoteRequest`
   - 검증 규칙:
     - price: required, numeric, min:1
     - estimated_days: required, integer, min:1
     - message: required, min:20
   - 로직:
     - 크리에이터만 견적서 작성 가능 확인 (role='creator')
     - Quote 레코드 생성 (creator_id는 auth()->id())
     - Commission 상태를 'quoted'로 업데이트
     - 고객에게 이메일 발송 (Queue 사용)
   - 성공 시 "견적서가 발송되었습니다" 메시지

5. **QuoteController@accept 메서드**:
   - 로직:
     - 고객만 승인 가능 확인 (commission의 client_id와 auth()->id() 일치)
     - Quote 상태를 'accepted'로 변경
     - Commission의 creator_id를 견적서 작성자로 설정
     - Commission 상태를 'in_progress'로 변경
     - 기본 워크플로우 단계 자동 생성:
       - "스케치" (order=1, status='in_progress')
       - "초안" (order=2, status='pending')
       - "수정" (order=3, status='pending')
       - "최종본" (order=4, status='pending')
     - 크리에이터에게 "계약 성사" 이메일 발송
   - 성공 시 "견적서가 승인되었습니다. 작업이 시작됩니다!" 메시지

6. **QuoteController@reject 메서드**:
   - Quote 상태를 'rejected'로 변경
   - 크리에이터에게 거절 알림 이메일 발송

7. **Mailable 생성**:
   - `php artisan make:mail QuoteSentMail --markdown=emails.quote-sent`
   - `php artisan make:mail QuoteAcceptedMail --markdown=emails.quote-accepted`
   - 각 메일에 커미션 정보, 견적 정보 포함

8. **Queue 설정**:
   - .env에서 QUEUE_CONNECTION=database 설정
   - `php artisan queue:table`
   - `php artisan migrate`
   - 이메일 발송 시 `Mail::to($user)->queue(new QuoteSentMail($quote))`

9. **테스트**:
   - 크리에이터 계정으로 로그인 후 pending 커미션에 견적서 작성
   - 고객 계정으로 로그인 후 견적서 승인
   - 워크플로우 단계가 자동 생성되는지 확인
   - Queue 워커 실행: `php artisan queue:work`
   - 이메일이 발송되는지 확인 (Mailtrap 사용 권장)

**목표**: 작업 단계별 진행 상황 관리 및 파일 업로드 기능 구현 (Kanban 보드 스타일)

다음을 수행하세요:

1. **WorkflowStageController 생성**:
   - `php artisan make:controller WorkflowStageController`

2. **라우트 추가** (routes/web.php):
   ```php
   Route::middleware(['auth'])->group(function () {
       Route::patch('workflow-stages/{stage}/status', [WorkflowStageController::class, 'updateStatus'])->name('workflow-stages.update-status');
       Route::post('workflow-stages/{stage}/files', [WorkflowStageController::class, 'uploadFile'])->name('workflow-stages.upload-file');
   });
   ```

3. **커미션 상세 페이지 확장** (resources/views/commissions/show.blade.php):
   - **워크플로우 보드 섹션** (status='in_progress'일 때만 표시):
     - Kanban 스타일 보드 레이아웃 (Tailwind CSS Grid 사용)
     - 각 단계를 카드로 표시:
       - 단계명 (예: "스케치")
       - 상태 배지 (pending, in_progress, completed)
       - 업로드된 파일 목록 (썸네일 + 파일명 + 다운로드 링크)
       - 파일 업로드 버튼 (크리에이터만 표시)
       - 상태 변경 버튼 (크리에이터만 표시):
         - pending → "작업 시작" (in_progress로 변경)
         - in_progress → "완료" (completed로 변경, 다음 단계를 in_progress로)
     - Alpine.js로 파일 업로드 모달 구현
     - 드래그앤드롭 파일 업로드 영역 추가

4. **WorkflowStageController@updateStatus 메서드**:
   - 로직:
     - 크리에이터만 상태 변경 가능 확인
     - 현재 단계 상태 업데이트
     - completed로 변경 시:
       - completed_at 타임스탬프 기록
       - 다음 순서 단계를 자동으로 'in_progress'로 변경
       - 모든 단계가 완료되면 Commission 상태를 'completed'로 변경
     - 고객에게 단계 완료 알림 이메일 발송
   - 성공 시 "단계가 업데이트되었습니다" 메시지

5. **WorkflowStageController@uploadFile 메서드**:
   - FormRequest 생성: `php artisan make:request UploadStageFileRequest`
   - 검증 규칙:
     - file: required, mimes:jpg,png,pdf,zip,psd,ai, max:20480 (20MB)
   - 로직:
     - 크리에이터만 업로드 가능 확인
     - 파일을 storage/app/public/commission-files/{commission_id}에 저장
     - CommissionFile 레코드 생성:
       - file_path, file_name, file_size 저장
       - version은 해당 단계의 기존 파일 개수 + 1
     - 고객에게 "새 파일이 업로드되었습니다" 이메일 발송
   - 성공 시 "파일이 업로드되었습니다" 메시지

6. **파일 다운로드 라우트 추가**:
   ```php
   Route::get('commission-files/{file}/download', [CommissionFileController::class, 'download'])->name('commission-files.download');
   ```
   - CommissionFileController@download 메서드:
     - Policy로 권한 확인 (커미션의 고객 또는 크리에이터만 다운로드 가능)
     - `return Storage::download($file->file_path, $file->file_name);`

7. **Policy 생성**:
   - `php artisan make:policy CommissionPolicy --model=Commission`
   - update 메서드: 커미션의 크리에이터만 수정 가능
   - view 메서드: 커미션의 고객 또는 크리에이터만 조회 가능
   - AuthServiceProvider에 등록

8. **Mailable 생성**:
   - `php artisan make:mail StageCompletedMail --markdown=emails.stage-completed`
   - `php artisan make:mail FileUploadedMail --markdown=emails.file-uploaded`

9. **UI 개선**:
   - 각 단계 카드에 진행률 바 추가 (completed 단계 개수 / 전체 단계 개수)
   - 완료된 단계는 초록색 배경, 진행 중은 파란색, 대기 중은 회색으로 표시
   - 파일 썸네일 (이미지인 경우 미리보기, 그 외는 파일 아이콘)

10. **테스트**:
    - 크리에이터 계정으로 각 단계에 파일 업로드
    - 단계 상태 변경 및 자동 진행 확인
    - 고객 계정으로 업로드된 파일 다운로드
    - 모든 단계 완료 시 커미션 상태가 'completed'로 변경되는지 확인

**목표**: 고객 피드백 시스템 및 댓글 기능 구현

다음을 수행하세요:

1. **FeedbackController 생성**:
   - `php artisan make:controller FeedbackController`

2. **라우트 추가** (routes/web.php):
   ```php
   Route::middleware(['auth'])->group(function () {
       Route::post('commissions/{commission}/feedbacks', [FeedbackController::class, 'store'])->name('feedbacks.store');
       Route::delete('feedbacks/{feedback}', [FeedbackController::class, 'destroy'])->name('feedbacks.destroy');
   });
   ```

3. **커미션 상세 페이지에 피드백 섹션 추가** (resources/views/commissions/show.blade.php):
   - 각 워크플로우 단계 카드 하단에 "피드백" 탭 추가
   - 피드백 목록 표시:
     - 작성자 이름 (고객/크리에이터 구분 배지)
     - 댓글 내용
     - 작성 시간 (Carbon diffForHumans 사용)
     - 삭제 버튼 (본인만 표시)
   - 피드백 작성 폼:
     - textarea (placeholder: "이 단계에 대한 피드백을 남겨주세요")
     - "피드백 등록" 버튼
   - Alpine.js로 댓글 토글 및 실시간 추가 기능

4. **FeedbackController@store 메서드**:
   - FormRequest 생성: `php artisan make:request StoreFeedbackRequest`
   - 검증 규칙:
     - comment: required, min:10, max:1000
     - workflow_stage_id: nullable, exists:workflow_stages,id
   - 로직:
     - Feedback 레코드 생성 (user_id는 auth()->id())
     - 상대방(고객↔크리에이터)에게 "새 피드백이 등록되었습니다" 이메일 발송
   - AJAX 요청으로 처리 (JSON 응답)
   - 성공 시 새 피드백 HTML 반환

5. **FeedbackController@destroy 메서드**:
   - Policy로 본인만 삭제 가능 확인
   - Feedback 레코드 삭제
   - AJAX 요청으로 처리

6. **Blade 컴포넌트 생성**:
   - `php artisan make:component FeedbackItem`
   - resources/views/components/feedback-item.blade.php:
     - 피드백 한 개를 표시하는 재사용 가능한 컴포넌트
     - props: $feedback, $canDelete

7. **Mailable 생성**:
   - `php artisan make:mail FeedbackReceivedMail --markdown=emails.feedback-received`

8. **실시간 업데이트 (선택사항)**:
   - Alpine.js로 5초마다 새 피드백 자동 로드 (fetch API 사용)
   - 또는 Laravel Echo + Pusher로 실시간 알림 (보너스)

9. **UI 개선**:
   - 피드백 목록을 시간순 정렬 (최신순)
   - 고객 피드백은 파란색, 크리에이터 피드백은 초록색 배경
   - 피드백 개수 배지 표시 (각 단계별)

10. **테스트**:
    - 고객 계정으로 각 단계에 피드백 작성
    - 크리에이터 계정으로 답변 작성
    - 피드백 삭제 기능 확인
    - 이메일 알림 확인

**목표**: 대시보드 통계 및 수익 분석 기능 구현

다음을 수행하세요:

1. **DashboardController 생성**:
   - `php artisan make:controller DashboardController`

2. **라우트 수정** (routes/web.php):
   ```php
   Route::get('/dashboard', [DashboardController::class, 'index'])->middleware(['auth', 'verified'])->name('dashboard');
   ```

3. **DashboardController@index 메서드**:
   - 역할별 데이터 로드:

   **크리에이터 대시보드**:
   - 통계:
     - 총 수익: 승인된 견적서(status='accepted')의 price 합계
     - 진행 중인 커미션 개수 (status='in_progress')
     - 완료된 커미션 개수 (status='completed')
     - 평균 작업 소요 시간: (완료일 - 승인일)의 평균
   - 차트 데이터:
     - 월별 수익 (최근 6개월)
     - 작업 유형별 커미션 개수 (파이 차트용)
   - 최근 피드백 3개
   - 다가오는 마감일 (deadline 기준 7일 이내)

   **고객 대시보드**:
   - 통계:
     - 총 의뢰 개수
     - 진행 중인 커미션 개수
     - 완료된 커미션 개수
     - 총 지출 금액
   - 최근 의뢰 목록 (상태별 필터 탭)
   - 최근 받은 피드백 3개

4. **대시보드 뷰 리팩토링** (resources/views/dashboard.blade.php):
   - Tailwind CSS로 카드 레이아웃 구성
   - 통계 카드:
     - 아이콘 + 숫자 + 레이블
     - 전월 대비 증감률 표시 (선택사항)
   - Chart.js 라이브러리 추가:
     - CDN: `<script src="https://cdn.jsdelivr.net/npm/chart.js"></script>`
     - 월별 수익 선 그래프
     - 작업 유형별 도넛 차트
   - 최근 활동 타임라인 (피드백, 파일 업로드, 단계 완료 등)

5. **Chart.js 데이터 전달**:
   - 컨트롤러에서 JSON 데이터를 뷰로 전달
   - Blade에서 JavaScript 변수로 변환:
     ```blade
     <script>
     const monthlyRevenue = @json($monthlyRevenue);
     const typeDistribution = @json($typeDistribution);
     </script>
     ```

6. **필터 및 정렬 기능**:
   - 커미션 목록에 필터 추가:
     - 상태별 (pending, in_progress, completed)
     - 작업 유형별
     - 날짜 범위
   - Alpine.js로 클라이언트 사이드 필터링

7. **검색 기능**:
   - 커미션 제목/설명 검색 (LIKE 쿼리)
   - 검색 입력 시 debounce 처리 (Alpine.js)

8. **페이지네이션**:
   - 커미션 목록에 페이지네이션 추가 (Laravel paginate)
   - Tailwind CSS 스타일 페이지네이션 컴포넌트

9. **반응형 디자인**:
   - 모바일에서도 차트가 정상 표시되도록 조정
   - 카드 레이아웃을 모바일에서는 1열, 태블릿 2열, 데스크톱 3열로 반응형 구성

10. **테스트**:
    - 더미 데이터로 차트가 정상 렌더링되는지 확인
    - 필터 및 검색 기능 동작 확인
    - 모바일 뷰 테스트

**목표**: 이메일 알림 자동화 및 Laravel Scheduler 설정

다음을 수행하세요:

1. **모든 Mailable 클래스 완성**:
   - 지금까지 생성한 Mailable 클래스들의 마크다운 템플릿 작성:
     - QuoteSentMail: 견적서 정보, 커미션 상세 링크 포함
     - QuoteAcceptedMail: 계약 성사 축하, 워크플로우 링크
     - StageCompletedMail: 완료된 단계명, 다음 단계 안내
     - FileUploadedMail: 업로드된 파일 정보, 다운로드 링크
     - FeedbackReceivedMail: 피드백 내용, 답변하기 링크
   - 각 메일에 커미션 제목, 고유 번호(uuid), CTA 버튼 포함
   - 브랜드 컬러 적용 (config/mail.php에서 theme 설정)

2. **커스텀 Notification 생성** (선택사항):
   - `php artisan make:notification DeadlineReminderNotification`
   - 마감일 3일 전 크리에이터에게 알림
   - 이메일 + 데이터베이스 채널 사용

3. **Laravel Scheduler 설정**:
   - app/Console/Kernel.php의 schedule 메서드에 작업 등록:
     ```php
     protected function schedule(Schedule $schedule)
     {
         // 매일 오전 9시에 마감일 3일 전인 커미션 확인
         $schedule->call(function () {
             $commissions = Commission::where('status', 'in_progress')
                 ->whereDate('deadline', '=', now()->addDays(3)->toDateString())
                 ->with('creator')
                 ->get();

             foreach ($commissions as $commission) {
                 $commission->creator->notify(new DeadlineReminderNotification($commission));
             }
         })->dailyAt('09:00');
     }
     ```

4. **Cron 설정 안내 문서 작성** (README.md):
   - 프로덕션 서버에서 스케줄러 실행 방법:
     ```bash
     * * * * * cd /path-to-project && php artisan schedule:run >> /dev/null 2>&1
     ```
   - 로컬 개발 시: `php artisan schedule:work`

5. **Queue 워커 자동 재시작**:
   - Supervisor 설정 예시 작성 (README.md에 포함)
   - Laravel Horizon 대신 간단한 queue:work 사용

6. **이메일 테스트**:
   - Mailtrap 또는 MailHog으로 모든 이메일 템플릿 확인
   - 각 이벤트별로 이메일 발송 테스트:
     - 견적서 발송
     - 견적서 승인
     - 단계 완료
     - 파일 업로드
     - 피드백 등록
     - 마감일 리마인더

7. **에러 처리**:
   - 이메일 발송 실패 시 로그 기록
   - Queue 실패 처리 (failed_jobs 테이블 활용)
   - `php artisan queue:failed` 명령으로 실패한 작업 확인

8. **환경변수 설정 가이드** (.env.example 업데이트):
   ```
   MAIL_MAILER=smtp
   MAIL_HOST=smtp.mailtrap.io
   MAIL_PORT=2525
   MAIL_USERNAME=your-username
   MAIL_PASSWORD=your-password
   MAIL_ENCRYPTION=tls
   MAIL_FROM_ADDRESS=noreply@commissionmanager.test
   MAIL_FROM_NAME="Commission Manager"

   QUEUE_CONNECTION=database
   ```

9. **알림 환경설정 추가**:
   - 사용자 프로필에 "이메일 알림 수신 여부" 설정 추가 (선택사항)
   - users 테이블에 email_notifications boolean 컬럼 추가
   - 알림 발송 전 사용자 설정 확인

10. **테스트**:
    - Queue 워커 실행 상태에서 각 이벤트 트리거
    - 이메일이 정상 발송되는지 확인
    - Scheduler 작동 테스트 (시간을 조작하여 확인)
    - 실패한 작업 재시도: `php artisan queue:retry all`

**목표**: 사용자 프로필 관리 및 크리에이터 포트폴리오 페이지 구현

다음을 수행하세요:

1. **ProfileController 확장**:
   - Breeze 기본 프로필 컨트롤러에 추가 필드 업데이트 기능 추가

2. **프로필 편집 폼** (resources/views/profile/edit.blade.php):
   - 기존 Breeze 폼에 추가 필드:
     - **크리에이터 전용**:
       - 자기소개 (bio, textarea)
       - 포트폴리오 URL (portfolio_url, input url)
       - 시간당 요금 (hourly_rate, input number)
       - 프로필 사진 업로드 (storage에 저장)
     - **공통**:
       - 이메일 알림 수신 여부 (checkbox)
   - Alpine.js로 역할별 필드 토글

3. **ProfileController@update 확장**:
   - FormRequest 생성: `php artisan make:request UpdateProfileRequest`
   - 검증 규칙:
     - bio: nullable, max:500
     - portfolio_url: nullable, url
     - hourly_rate: nullable, numeric, min:0
     - profile_photo: nullable, image, max:2048
   - 프로필 사진 업로드 처리:
     - storage/app/public/profile-photos에 저장
     - 기존 사진이 있으면 삭제 후 새 사진 저장

4. **크리에이터 포트폴리오 페이지** (resources/views/creators/show.blade.php):
   - 공개 페이지 (인증 불필요)
   - 라우트: `Route::get('/creators/{user}', [CreatorController::class, 'show'])->name('creators.show');`
   - 표시 내용:
     - 프로필 사진, 이름, 자기소개
     - 시간당 요금, 포트폴리오 링크
     - 완료된 커미션 갤러리:
       - 고객이 공개 허용한 커미션만 표시 (commissions 테이블에 is_public boolean 컬럼 추가)
       - 각 커미션의 최종 결과물 이미지 (commission_files에서 workflow_stage의 order가 가장 높은 파일)
       - 작업 유형, 완료일 표시
     - 고객 리뷰 (보너스 기능)
   - Tailwind CSS로 그리드 레이아웃 갤러리
   - Lightbox 효과 (Alpine.js 또는 Fancybox 라이브러리)

5. **CreatorController 생성**:
   - `php artisan make:controller CreatorController`
   - show 메서드:
     - 크리에이터 정보 로드 (role='creator'만)
     - 공개 커미션 로드 (is_public=true, status='completed')
     - 최종 결과물 파일 로드 (eager loading)

6. **커미션 공개 설정 기능**:
   - 커미션 상세 페이지에 "포트폴리오에 공개" 토글 추가 (크리에이터 전용)
   - AJAX로 is_public 값 업데이트
   - 고객 동의 필요 시 고객에게 알림 발송 (선택사항)

7. **크리에이터 목록 페이지** (resources/views/creators/index.blade.php):
   - 모든 크리에이터 목록 표시
   - 필터:
     - 작업 유형 (character_design, logo 등)
     - 시간당 요금 범위
   - 정렬:
     - 최신 가입순
     - 완료 작업 많은 순
   - 각 크리에이터 카드에 프로필 사진, 이름, 완료 작업 개수, 시간당 요금 표시
   - 카드 클릭 시 포트폴리오 페이지로 이동

8. **네비게이션 메뉴 업데이트**:
   - "크리에이터 둘러보기" 링크 추가
   - 크리에이터는 "내 포트폴리오" 링크 추가

9. **SEO 최적화** (선택사항):
   - 크리에이터 포트폴리오 페이지에 메타 태그 추가
   - Open Graph 이미지 (프로필 사진 사용)

10. **테스트**:
    - 크리에이터 프로필 편집 및 포트폴리오 URL 확인
    - 완료된 커미션을 공개로 설정 후 포트폴리오 페이지에 표시되는지 확인
    - 크리에이터 목록 페이지에서 필터/정렬 기능 확인

**목표**: Seeder로 더미 데이터 생성 및 테스트 환경 구축

다음을 수행하세요:

1. **Factory 생성**:
   - `php artisan make:factory CommissionFactory`
   - `php artisan make:factory QuoteFactory`
   - `php artisan make:factory WorkflowStageFactory`
   - `php artisan make:factory CommissionFileFactory`
   - `php artisan make:factory FeedbackFactory`

2. **Factory 정의**:
   - **CommissionFactory**:
     - title: 무작위 커미션 제목 (예: "캐릭터 디자인 의뢰", "회사 로고 제작")
     - type: 무작위 enum 값
     - description: 최소 100자 이상의 더미 텍스트
     - budget_range: "$100-$500" 형식
     - deadline: 7~30일 후 무작위 날짜
     - status: 무작위 (pending, quoted, in_progress, completed)
     - uuid: Str::uuid()

   - **QuoteFactory**:
     - price: 100~1000 사이 무작위
     - estimated_days: 3~21 사이 무작위
     - message: 더미 견적 설명
     - status: 무작위 (pending, accepted, rejected)

   - **WorkflowStageFactory**:
     - name: ["스케치", "초안", "수정", "최종본"] 중 하나
     - order: 1~4
     - status: 무작위

3. **DatabaseSeeder 작성** (database/seeders/DatabaseSeeder.php):
   ```php
   public function run()
   {
       // 크리에이터 1명
       $creator = User::factory()->create([
           'name' => 'Jane Creator',
           'email' => 'creator@example.com',
           'role' => 'creator',
           'bio' => 'Professional illustrator with 5 years of experience.',
           'hourly_rate' => 50.00,
       ]);

       // 고객 3명
       $clients = User::factory()->count(3)->create([
           'role' => 'client',
       ]);

       // 각 고객당 커미션 2개씩 생성
       foreach ($clients as $client) {
           $commissions = Commission::factory()->count(2)->create([
               'client_id' => $client->id,
               'creator_id' => $creator->id,
               'status' => 'in_progress',
           ]);

           foreach ($commissions as $commission) {
               // 견적서 생성
               Quote::factory()->create([
                   'commission_id' => $commission->id,
                   'creator_id' => $creator->id,
                   'status' => 'accepted',
               ]);

               // 워크플로우 단계 생성
               $stages = [
                   ['name' => '스케치', 'order' => 1, 'status' => 'completed'],
                   ['name' => '초안', 'order' => 2, 'status' => 'in_progress'],
                   ['name' => '수정', 'order' => 3, 'status' => 'pending'],
                   ['name' => '최종본', 'order' => 4, 'status' => 'pending'],
               ];

               foreach ($stages as $stageData) {
                   $stage = WorkflowStage::factory()->create([
                       'commission_id' => $commission->id,
                       ...$stageData,
                   ]);

                   // 완료된 단계에 파일 추가
                   if ($stageData['status'] === 'completed') {
                       CommissionFile::factory()->count(2)->create([
                           'commission_id' => $commission->id,
                           'workflow_stage_id' => $stage->id,
                           'uploader_id' => $creator->id,
                       ]);
                   }
               }

               // 피드백 생성
               Feedback::factory()->count(3)->create([
                   'commission_id' => $commission->id,
                   'user_id' => fake()->randomElement([$client->id, $creator->id]),
               ]);
           }
       }
   }
   ```

4. **더미 파일 생성**:
   - storage/app/public/commission-files 폴더에 샘플 이미지 파일 배치
   - CommissionFileFactory에서 실제 파일 경로 참조

5. **Seeder 실행**:
   - `php artisan migrate:fresh --seed`
   - 데이터베이스 초기화 후 더미 데이터 생성

6. **테스트 계정 안내** (README.md):
   ```markdown
   ## 테스트 계정

   - **크리에이터**: creator@example.com / password
   - **고객 1**: (자동 생성된 이메일) / password
   - **고객 2**: (자동 생성된 이메일) / password
   - **고객 3**: (자동 생성된 이메일) / password
   ```

7. **환경 설정 검증 스크립트**:
   - Artisan 커맨드 생성: `php artisan make:command CheckEnvironment`
   - 실행 시 다음 항목 검증:
     - 데이터베이스 연결
     - Storage 심볼릭 링크
     - Queue 설정
     - Mail 설정
     - 필수 디렉토리 권한

8. **테스트**:
   - 더미 데이터로 모든 기능 동작 확인
   - 크리에이터/고객 계정으로 로그인하여 UI 확인
   - 대시보드 통계가 정상 표시되는지 확인

**목표**: 프로젝트 문서화, 배포 준비, 최종 테스트 및 보안 강화

다음을 수행하세요:

1. **README.md 작성**:
   ```markdown
   # 🎨 Creator Commission Workflow Manager

   크리에이터를 위한 커미션 작업 전 과정 관리 플랫폼

   ## 기능

   - ✅ 커미션 의뢰 시스템
   - ✅ 견적서 발송 & 승인
   - ✅ 작업 단계별 워크플로우 (Kanban 보드)
   - ✅ 파일 업로드 & 버전 관리
   - ✅ 고객 피드백 시스템
   - ✅ 이메일 알림 자동화
   - ✅ 대시보드 통계 & 차트
   - ✅ 크리에이터 포트폴리오 페이지

   ## 기술 스택

   - Laravel 13.x
   - Blade Templates
   - Tailwind CSS
   - Alpine.js
   - Chart.js
   - MySQL

   ## 설치 방법

   1. 리포지토리 클론
   2. `composer install`
   3. `npm install && npm run build`
   4. `.env` 설정 (데이터베이스, 메일)
   5. `php artisan key:generate`
   6. `php artisan migrate --seed`
   7. `php artisan storage:link`
   8. `php artisan serve`

   ## 테스트 계정

   - 크리에이터: creator@example.com / password
   - 고객: (Seeder로 자동 생성)

   ## 라이선스

   MIT
   ```

2. **보안 강화**:
   - **CSRF 보호**: 모든 폼에 @csrf 확인
   - **XSS 방지**: Blade {{ }} 이스케이핑 확인, 사용자 입력 출력 시 htmlspecialchars
   - **SQL Injection 방지**: Eloquent ORM 사용, 직접 쿼리 금지
   - **파일 업로드 검증**:
     - MIME 타입 검증 (mimes 규칙)
     - 파일 크기 제한
     - 업로드 디렉토리 권한 설정 (755)
   - **Rate Limiting**:
     - 로그인 시도 제한 (Breeze 기본 제공)
     - API 엔드포인트에 throttle 미들웨어 추가
   - **.env 보안**:
     - .env.example 제공, .env는 .gitignore에 포함
     - APP_DEBUG=false (프로덕션)
     - APP_ENV=production

3. **성능 최적화**:
   - **Eager Loading**: N+1 쿼리 방지
     - 커미션 목록 로드 시 with(['client', 'creator', 'workflowStages'])
   - **캐싱**:
     - 대시보드 통계 캐시 (5분 TTL)
     - `Cache::remember('creator-stats-' . $userId, 300, function() {...})`
   - **인덱스 추가**:
     - commissions 테이블: client_id, creator_id, status에 인덱스
     - workflow_stages: commission_id, order에 복합 인덱스
   - **이미지 최적화**:
     - 업로드 시 자동 리사이즈 (Intervention Image 라이브러리)
     - 썸네일 생성

4. **에러 처리 개선**:
   - **커스텀 에러 페이지**:
     - resources/views/errors/404.blade.php
     - resources/views/errors/500.blade.php
     - Tailwind CSS로 스타일링
   - **로그 설정**:
     - config/logging.php에서 daily 채널 사용
     - 중요 작업(결제, 파일 업로드)에 로그 추가
   - **사용자 친화적 메시지**:
     - try-catch로 예외 처리
     - 에러 발생 시 "문제가 발생했습니다. 다시 시도해주세요" 메시지

5. **코드 품질 검증**:
   - **Laravel Pint** (코드 스타일):
     - `composer require laravel/pint --dev`
     - `./vendor/bin/pint`
   - **PHPStan** (정적 분석, 선택사항):
     - `composer require --dev phpstan/phpstan`
     - `./vendor/bin/phpstan analyse`

6. **배포 체크리스트** (DEPLOYMENT.md 작성):
   ```markdown
   ## 배포 전 체크리스트

   - [ ] .env 설정 (APP_ENV=production, APP_DEBUG=false)
   - [ ] 데이터베이스 마이그레이션 실행
   - [ ] Storage 심볼릭 링크 생성
   - [ ] Composer autoload 최적화 (`composer install --optimize-autoloader --no-dev`)
   - [ ] Config 캐시 (`php artisan config:cache`)
   - [ ] Route 캐시 (`php artisan route:cache`)
   - [ ] View 캐시 (`php artisan view:cache`)
   - [ ] Queue 워커 설정 (Supervisor)
   - [ ] Cron 작업 등록 (Scheduler)
   - [ ] HTTPS 설정
   - [ ] 방화벽 규칙 설정
   ```

7. **Git 설정**:
   - .gitignore 확인:
     - /node_modules
     - /public/hot
     - /public/storage
     - /storage/*.key
     - .env
   - 첫 커밋:
     ```bash
     git init
     git add .
     git commit -m "feat: initial commit - commission workflow manager"
     ```

8. **최종 기능 테스트**:
   - [ ] 사용자 등록/로그인
   - [ ] 커미션 생성 (고객)
   - [ ] 견적서 발송 (크리에이터)
   - [ ] 견적서 승인 (고객)
   - [ ] 파일 업로드 (크리에이터)
   - [ ] 단계 진행 및 완료
   - [ ] 피드백 작성 (양방향)
   - [ ] 이메일 발송 확인
   - [ ] 대시보드 통계 확인
   - [ ] 포트폴리오 페이지 확인
   - [ ] 모바일 반응형 확인

9. **선택 사항 - 보너스 기능**:
   - Stripe 결제 연동 (테스트 모드)
   - 고객 리뷰 시스템
   - 실시간 알림 (Laravel Echo + Pusher)
   - 다국어 지원 (Laravel Localization)

10. **프로젝트 완료 확인**:
    - 모든 기능이 정상 작동하는지 최종 검증
    - README.md에 스크린샷 추가 (선택사항)
    - GitHub에 푸시
    - 데모 사이트 배포 (선택사항)

축하합니다! 🎉 실무 수준의 커미션 관리 플랫폼이 완성되었습니다.