🎓 온라인 강의 플랫폼 - LMS 풀스택 구현 with 동영상 스트리밍

mkdir online-course-lms-platform && cd online-course-lms-platform

이 폴더에서 Laravel 13.x 기반 온라인 강의 플랫폼 프로젝트를 시작합니다.

## 요구사항
1. Laravel 13.x 최신 버전으로 프로젝트 생성
2. 기본 설정 파일 구성:
   - .env 파일에 SQLite 데이터베이스 설정
   - APP_NAME을 'CourseHub'로 변경
   - Redis 캐시 드라이버 설정
   - Queue 드라이버를 'database'로 설정
3. 필수 패키지 설치:
   - laravel/fortify (인증)
   - spatie/laravel-medialibrary (파일 관리)
   - spatie/laravel-permission (권한 관리)
   - stripe/stripe-php (결제)
   - barryvdh/laravel-dompdf (PDF 생성)
4. Tailwind CSS 설정 (Laravel Mix 또는 Vite)
5. 기본 디렉토리 구조 생성:
   - app/Models (User, Course, Lesson, Enrollment, Payment 등)
   - app/Http/Controllers (Auth, Course, Lesson, Payment 등)
   - resources/views/layouts (app.blade.php, guest.blade.php)
   - resources/views/components (Blade 컴포넌트)
6. Git 초기화 및 .gitignore 설정

프로젝트 생성 후 README.md에 설치 가이드를 작성하세요.

데이터베이스 스키마를 설계하고 마이그레이션 파일을 생성하세요.

## 필요한 테이블 및 관계

### users 테이블
- id, name, email, password, email_verified_at
- role (enum: 'student', 'instructor', 'admin')
- avatar (nullable)
- bio (text, nullable)
- timestamps

### courses 테이블
- id, instructor_id (foreign key to users)
- title, slug (unique)
- description (text)
- price (decimal)
- thumbnail (nullable)
- category (enum: 'programming', 'design', 'business', 'marketing', 'etc')
- level (enum: 'beginner', 'intermediate', 'advanced')
- is_published (boolean, default false)
- timestamps, soft deletes

### lessons 테이블
- id, course_id (foreign key)
- chapter_id (nullable, foreign key to chapters)
- title, slug
- description (text, nullable)
- video_path (nullable)
- duration (integer, 초 단위)
- order (integer)
- is_free (boolean, 샘플 영상 여부)
- timestamps

### chapters 테이블
- id, course_id (foreign key)
- title
- order (integer)
- timestamps

### enrollments 테이블 (수강 등록)
- id, user_id, course_id
- enrolled_at (timestamp)
- completed_at (nullable timestamp)
- progress (decimal, 0-100)
- unique constraint on (user_id, course_id)
- timestamps

### lesson_progress 테이블
- id, enrollment_id, lesson_id
- watched_duration (integer, 초 단위)
- is_completed (boolean)
- last_watched_at (timestamp)
- timestamps

### payments 테이블
- id, user_id, course_id
- stripe_payment_id (unique)
- amount (decimal)
- currency (default 'krw')
- status (enum: 'pending', 'completed', 'refunded')
- refunded_at (nullable timestamp)
- timestamps

### reviews 테이블
- id, user_id, course_id
- rating (integer, 1-5)
- comment (text, nullable)
- timestamps

### qna_posts 테이블
- id, user_id, course_id, lesson_id (nullable)
- title, content (text)
- is_answered (boolean, default false)
- timestamps

### qna_answers 테이블
- id, post_id (foreign key), user_id
- content (text)
- is_instructor_answer (boolean)
- timestamps

## 추가 요구사항
1. 외래 키 제약 조건 설정 (onDelete cascade/restrict)
2. 인덱스 추가 (slug, instructor_id, course_id 등)
3. Eloquent 모델 생성 및 관계 정의:
   - User hasMany Courses (as instructor)
   - User belongsToMany Courses through Enrollments
   - Course hasMany Lessons, Reviews, Enrollments
   - Course belongsTo User (instructor)
   - Lesson belongsTo Course, Chapter
   - Enrollment belongsTo User, Course
   - Enrollment hasMany LessonProgress
4. 모델에 fillable/guarded 속성 정의
5. 모델에 casts 정의 (JSON, datetime 등)

php artisan migrate 실행 전 마이그레이션 파일을 검토하세요.

인증 시스템과 역할 기반 접근 제어(RBAC)를 구현하세요.

## 요구사항

### 1. Laravel Fortify 설정
- Fortify 설치 및 설정
- 회원가입, 로그인, 로그아웃 라우트 활성화
- 이메일 인증 활성화
- 비밀번호 재설정 활성화
- 2단계 인증 (선택 사항)

### 2. Spatie Permission 설정
- Role 생성: 'student', 'instructor', 'admin'
- Permission 정의:
  - 'create-course', 'edit-course', 'delete-course'
  - 'view-analytics', 'manage-users'
  - 'refund-payment'
- Seeder 생성 및 기본 역할/권한 할당

### 3. 커스텀 미들웨어
- EnsureUserIsInstructor 미들웨어 생성
- EnsureUserIsStudent 미들웨어 생성
- 라우트에 미들웨어 적용

### 4. 인증 뷰 (Blade)
- resources/views/auth/login.blade.php (Tailwind CSS)
- resources/views/auth/register.blade.php
  - 회원가입 시 역할 선택 (강사/수강생)
- resources/views/auth/forgot-password.blade.php
- resources/views/auth/verify-email.blade.php

### 5. 레이아웃 및 네비게이션
- resources/views/layouts/app.blade.php
  - 로그인/로그아웃 상태에 따른 네비게이션 바
  - 역할에 따라 다른 메뉴 표시 (강사는 '내 강의', 수강생은 '내 학습')
- resources/views/layouts/guest.blade.php (비로그인 사용자용)

### 6. UserSeeder 생성
- 테스트용 관리자 계정 (admin@example.com)
- 테스트용 강사 계정 (instructor@example.com)
- 테스트용 수강생 계정 (student@example.com)

### 7. 라우트 정의
- routes/web.php에 인증 관련 라우트 그룹 생성
- 미들웨어로 보호된 라우트 설정

## 디자인 요구사항
- Tailwind CSS로 깔끔한 폼 디자인
- 반응형 레이아웃
- 유효성 검사 에러 메시지 표시
- 성공/실패 플래시 메시지 (session flash)

Seeder 실행 후 테스트 계정으로 로그인 가능한지 확인하세요.

강사용 강의 관리 CRUD 기능을 구현하세요.

## 요구사항

### 1. CourseController 생성
- InstructorCourseController (강사 전용)
- 메서드: index, create, store, edit, update, destroy
- Policy 생성: CoursePolicy (강사만 자신의 강의 수정 가능)

### 2. 강의 목록 페이지
- resources/views/instructor/courses/index.blade.php
- 강사가 생성한 모든 강의 표시 (테이블 또는 카드 형식)
- 각 강의별 정보:
  - 썸네일, 제목, 카테고리, 가격
  - 수강생 수, 총 매출
  - 상태 (공개/비공개)
  - 수정/삭제 버튼
- '새 강의 만들기' 버튼
- 페이지네이션 (10개씩)

### 3. 강의 생성 페이지
- resources/views/instructor/courses/create.blade.php
- 폼 필드:
  - 제목 (required)
  - 설명 (Markdown 에디터 또는 Textarea)
  - 카테고리 선택 (드롭다운)
  - 난이도 선택 (라디오 버튼)
  - 가격 (숫자 입력, KRW)
  - 썸네일 업로드 (이미지 미리보기)
- 유효성 검사: FormRequest 클래스 생성
- 썸네일 업로드: Spatie Media Library 사용

### 4. 강의 수정 페이지
- resources/views/instructor/courses/edit.blade.php
- 기존 데이터 로드하여 폼에 표시
- 썸네일 변경 기능 (기존 이미지 유지 또는 새 이미지 업로드)
- Slug 자동 생성 (제목 기반, 중복 방지)

### 5. 강의 삭제
- Soft Delete 사용 (강의 복구 가능)
- 삭제 전 확인 모달 (Alpine.js 또는 Blade 컴포넌트)
- 수강생이 있는 강의는 삭제 불가 (정책 검증)

### 6. 라우트 정의
- routes/web.php에 instructor 그룹 추가
- Route::middleware(['auth', 'instructor'])->group()
- 리소스 라우트: Route::resource('courses', InstructorCourseController::class)

### 7. Blade 컴포넌트
- <x-course-card> 컴포넌트 (강의 카드 UI)
- <x-form-input> 컴포넌트 (재사용 가능한 입력 필드)
- <x-alert> 컴포넌트 (성공/에러 메시지)

## 디자인 요구사항
- Tailwind CSS로 모던한 대시보드 디자인
- 반응형 레이아웃 (모바일에서도 사용 가능)
- 썸네일 업로드 시 드래그앤드롭 지원
- 로딩 상태 표시 (폼 제출 시)

CRUD 완성 후 강사 계정으로 로그인하여 강의 생성/수정/삭제를 테스트하세요.

챕터 및 레슨 관리 기능을 구현하세요 (드래그앤드롭 순서 변경 포함).

## 요구사항

### 1. ChapterController 및 LessonController 생성
- InstructorChapterController
- InstructorLessonController
- 중첩 라우트 사용: courses/{course}/chapters, courses/{course}/lessons

### 2. 챕터 관리
- 챕터 CRUD (생성, 수정, 삭제)
- 챕터 순서 변경 (드래그앤드롭)
- 챕터별 레슨 그룹핑

### 3. 레슨 관리 페이지
- resources/views/instructor/courses/lessons/index.blade.php
- 챕터별로 레슨 목록 표시 (아코디언 또는 탭)
- 드래그앤드롭으로 레슨 순서 변경 (SortableJS 또는 Alpine.js)
- 각 레슨 정보:
  - 제목, 시간, 무료 여부
  - 수정/삭제 버튼

### 4. 레슨 생성/수정 페이지
- resources/views/instructor/courses/lessons/create.blade.php
- resources/views/instructor/courses/lessons/edit.blade.php
- 폼 필드:
  - 제목 (required)
  - 설명 (optional)
  - 챕터 선택 (드롭다운, 없으면 미지정)
  - 동영상 업로드 (MP4, 최대 500MB)
  - 무료 공개 여부 (체크박스)
  - 학습 자료 첨부 (PDF, ZIP 등)

### 5. 동영상 업로드 및 처리
- Spatie Media Library로 동영상 저장
- Laravel Queue로 백그라운드에서 동영상 인코딩
  - Job 클래스: ProcessVideoUpload
  - FFmpeg 사용하여 HLS 포맷으로 변환 (선택 사항)
  - 썸네일 자동 생성
  - 영상 길이(duration) 자동 추출
- 업로드 진행률 표시 (Livewire 또는 JavaScript fetch)

### 6. 드래그앤드롭 순서 변경
- SortableJS 라이브러리 사용
- AJAX 요청으로 순서 업데이트
  - POST /courses/{course}/lessons/reorder
  - JSON payload: [{ id: 1, order: 1 }, { id: 2, order: 2 }]
- Optimistic UI 업데이트 (즉시 반영)

### 7. 학습 자료 관리
- 레슨별 파일 첨부 (PDF, ZIP, 이미지 등)
- 파일 다운로드 라우트 (인증 필요)
- 파일 크기 제한 (10MB)

### 8. 라우트 정의
- Route::resource('courses.chapters', InstructorChapterController::class)
- Route::resource('courses.lessons', InstructorLessonController::class)
- Route::post('courses/{course}/lessons/reorder', [InstructorLessonController::class, 'reorder'])

## 디자인 요구사항
- 드래그앤드롭 시각적 피드백 (그림자, 커서 변경)
- 동영상 업로드 중 프로그레스 바
- 반응형 레이아웃

동영상 업로드 후 Queue Worker를 실행하여 인코딩이 정상 작동하는지 확인하세요 (php artisan queue:work).

수강생용 강의 탐색 및 상세 페이지를 구현하세요.

## 요구사항

### 1. CourseController (수강생용)
- PublicCourseController 생성
- 메서드: index, show

### 2. 강의 목록 페이지
- resources/views/courses/index.blade.php
- 필터링 기능:
  - 카테고리별 필터 (사이드바 또는 탭)
  - 난이도별 필터 (체크박스)
  - 가격 범위 필터 (슬라이더)
  - 검색 기능 (제목, 설명)
- 정렬 옵션:
  - 최신순, 인기순 (수강생 수), 평점 높은 순, 가격 낮은 순
- 강의 카드 표시:
  - 썸네일, 제목, 강사명
  - 가격, 평점 (별 아이콘)
  - 수강생 수, 레슨 수
- 페이지네이션 (12개씩)
- 무한 스크롤 옵션 (선택 사항)

### 3. 강의 상세 페이지
- resources/views/courses/show.blade.php
- 상단 섹션:
  - 썸네일 (또는 샘플 영상 플레이어)
  - 제목, 강사 정보 (아바타, 이름, 소개)
  - 가격, 평점, 수강생 수
  - '장바구니 담기', '위시리스트 추가', '바로 구매' 버튼
- 탭 메뉴:
  - 강의 소개 (description)
  - 커리큘럼 (챕터 및 레슨 목록, 무료 레슨 표시)
  - 리뷰 (별점 분포 차트, 최신 리뷰 5개)
  - 강사 정보
  - Q&A (질문 목록)
- 커리큘럼 섹션:
  - 아코디언으로 챕터 펼치기/접기
  - 각 레슨: 제목, 시간, 무료 여부
  - 무료 레슨은 '미리보기' 버튼 (모달로 영상 재생)
- 샘플 영상 모달:
  - Video.js 또는 Plyr.js 플레이어
  - 전체화면 지원

### 4. 검색 기능
- Laravel Scout + Meilisearch 설정
- Course 모델에 Searchable trait 추가
- 검색 결과 페이지 (resources/views/courses/search.blade.php)
- 자동완성 (Alpine.js 또는 JavaScript fetch)

### 5. 위시리스트 기능
- wishlist 테이블 생성 (user_id, course_id, unique constraint)
- WishlistController (add, remove)
- 위시리스트 페이지 (resources/views/wishlist/index.blade.php)
- 하트 아이콘 토글 (AJAX)

### 6. 라우트 정의
- Route::get('/courses', [PublicCourseController::class, 'index'])->name('courses.index')
- Route::get('/courses/{course:slug}', [PublicCourseController::class, 'show'])->name('courses.show')
- Route::post('/wishlist/{course}', [WishlistController::class, 'add'])->middleware('auth')
- Route::delete('/wishlist/{course}', [WishlistController::class, 'remove'])->middleware('auth')

## 디자인 요구사항
- Tailwind CSS로 이커머스 스타일 디자인
- 반응형 레이아웃 (모바일에서 탭은 드롭다운으로)
- 이미지 Lazy Loading
- 스켈레톤 로딩 (데이터 로드 전)

Meilisearch 설정 및 인덱싱 후 검색 기능을 테스트하세요.

Stripe 결제 연동 및 장바구니 기능을 구현하세요.

## 요구사항

### 1. Stripe 설정
- Stripe PHP SDK 설치 (composer require stripe/stripe-php)
- .env에 Stripe API 키 추가 (테스트 모드)
  - STRIPE_PUBLIC_KEY
  - STRIPE_SECRET_KEY
- config/services.php에 Stripe 설정 추가

### 2. 장바구니 기능
- cart 테이블 생성 (user_id, course_id, added_at)
- CartController (index, add, remove, clear)
- resources/views/cart/index.blade.php
  - 장바구니에 담긴 강의 목록
  - 각 강의: 썸네일, 제목, 가격, 삭제 버튼
  - 총 금액 표시
  - '결제하기' 버튼

### 3. 결제 페이지
- resources/views/checkout/index.blade.php
- Stripe Checkout Session 생성
  - PaymentController::createCheckoutSession()
  - 장바구니 아이템을 Stripe Line Items로 변환
  - 성공/실패 리다이렉트 URL 설정
- Stripe Elements 통합 (카드 입력 폼)
- 결제 버튼 클릭 시 Stripe Checkout 페이지로 리다이렉트

### 4. 결제 완료 처리
- Stripe Webhook 설정
  - Route::post('/webhook/stripe', [WebhookController::class, 'handleStripe'])
  - Webhook 서명 검증
- checkout.session.completed 이벤트 처리:
  - Payment 레코드 생성 (status: 'completed')
  - Enrollment 레코드 생성 (수강 등록)
  - 장바구니 비우기
  - 이메일 알림 발송 (구매 확인 메일)

### 5. 결제 성공/실패 페이지
- resources/views/checkout/success.blade.php
  - 구매 완료 메시지
  - 구매한 강의 목록
  - '내 학습 페이지로 이동' 버튼
- resources/views/checkout/cancel.blade.php
  - 결제 취소 메시지
  - '장바구니로 돌아가기' 버튼

### 6. 환불 기능
- PaymentController::refund()
- 7일 이내 전액 환불 정책 검증
- Stripe Refund API 호출
- Payment 상태 업데이트 (status: 'refunded')
- Enrollment 삭제 (학습 진도율 10% 이하일 경우만)
- 환불 알림 이메일 발송

### 7. 주문 내역 페이지
- resources/views/orders/index.blade.php
- 사용자의 모든 주문 내역 표시
- 각 주문: 강의명, 결제일, 금액, 상태
- 영수증 다운로드 버튼 (PDF)
- 환불 요청 버튼 (조건 충족 시)

### 8. 쿠폰 시스템
- coupons 테이블 생성 (code, discount_type, discount_value, expires_at)
- 장바구니 페이지에 쿠폰 입력 필드
- 쿠폰 검증 및 할인 적용
- Stripe Checkout에 쿠폰 정보 전달

## 보안 요구사항
- CSRF 토큰 검증
- Webhook 서명 검증 (Stripe::constructEvent)
- 중복 결제 방지 (idempotency key)
- 결제 금액 서버 검증 (클라이언트 조작 방지)

## 디자인 요구사항
- Tailwind CSS로 체크아웃 페이지 디자인
- 결제 진행 단계 표시 (프로그레스 바)
- 로딩 상태 표시 (결제 처리 중)

Stripe CLI로 Webhook 테스트 후 실제 결제 플로우를 확인하세요 (stripe listen --forward-to localhost:8000/webhook/stripe).

수강생용 학습 페이지와 진도율 추적 시스템을 구현하세요.

## 요구사항

### 1. 학습 페이지
- resources/views/learn/show.blade.php
- 레이아웃:
  - 왼쪽: 동영상 플레이어 (Video.js 또는 Plyr.js)
  - 오른쪽 사이드바: 커리큘럼 목록 (챕터 및 레슨)
  - 하단: 레슨 설명, 학습 자료 다운로드 링크
- 플레이어 기능:
  - 재생/일시정지, 볼륨 조절
  - 배속 조절 (0.5x, 1x, 1.25x, 1.5x, 2x)
  - 전체화면 모드
  - 키보드 단축키 (스페이스바: 재생/일시정지, 화살표: 앞뒤 이동)
  - PIP (Picture-in-Picture) 모드
- 커리큘럼 사이드바:
  - 완료한 레슨 체크 표시
  - 현재 재생 중인 레슨 강조
  - 다음 레슨 자동 재생 옵션 (토글)

### 2. 진도율 추적
- LessonProgressController 생성
- 시청 시간 기록:
  - JavaScript로 10초마다 현재 재생 시간을 서버에 전송
  - POST /lessons/{lesson}/progress
  - JSON payload: { watched_duration: 120 }
- 레슨 완료 조건:
  - 시청 시간이 전체 길이의 90% 이상일 때 자동 완료
  - is_completed 플래그 업데이트
- 강의 전체 진도율 계산:
  - (완료한 레슨 수 / 전체 레슨 수) * 100
  - Enrollment 모델의 progress 필드 업데이트

### 3. 북마크 기능
- lesson_bookmarks 테이블 생성 (user_id, lesson_id, timestamp, note)
- 플레이어에서 '북마크 추가' 버튼
- 현재 재생 시간과 메모 저장
- 북마크 클릭 시 해당 시간으로 이동

### 4. 노트 작성 기능
- lesson_notes 테이블 생성 (user_id, lesson_id, timestamp, content)
- 학습 페이지 하단에 노트 에디터 (Markdown 지원)
- 타임스탬프별 노트 목록 표시
- 노트 클릭 시 해당 시간으로 이동

### 5. 내 학습 대시보드
- resources/views/dashboard/learning.blade.php
- 수강 중인 강의 목록:
  - 각 강의: 썸네일, 제목, 진도율 (프로그레스 바)
  - '이어서 학습하기' 버튼 (마지막 시청 레슨으로 이동)
- 학습 통계:
  - 총 학습 시간 (주별, 월별 차트)
  - 완강한 강의 수
  - 진행 중인 강의 수
- 최근 시청한 레슨 (5개)

### 6. 수료증 발급
- CertificateController::generate()
- 진도율 100% 달성 시 자동 발급
- Laravel DomPDF로 PDF 생성
  - 템플릿: resources/views/certificates/template.blade.php
  - 내용: 수강생 이름, 강의명, 완강일, 강사 서명
- 수료증 다운로드 버튼 (학습 대시보드)

### 7. 라우트 정의
- Route::get('/learn/{enrollment}', [LearnController::class, 'show'])->middleware('auth')
- Route::post('/lessons/{lesson}/progress', [LessonProgressController::class, 'update'])
- Route::post('/lessons/{lesson}/bookmarks', [BookmarkController::class, 'store'])
- Route::get('/certificates/{enrollment}', [CertificateController::class, 'download'])

## 디자인 요구사항
- 플레이어 중심의 몰입형 레이아웃
- 다크 모드 지원 (토글 버튼)
- 반응형 (모바일에서는 사이드바가 하단으로 이동)

동영상 재생 중 진도율이 정상적으로 업데이트되는지 확인하세요.

리뷰 시스템과 Q&A 게시판을 구현하세요.

## 요구사항

### 1. 리뷰 시스템
- ReviewController (store, update, destroy)
- 리뷰 작성 조건:
  - 강의를 구매한 수강생만 가능
  - 진도율 10% 이상일 때만 가능
  - 1인당 1개의 리뷰만 작성 가능 (수정은 가능)
- 리뷰 폼 (강의 상세 페이지):
  - 별점 (1-5, 별 아이콘 클릭)
  - 코멘트 (Textarea, 최소 20자)
  - '리뷰 작성' 버튼
- 리뷰 목록 (강의 상세 페이지 탭):
  - 최신순, 평점 높은 순, 평점 낮은 순 정렬
  - 각 리뷰: 작성자 아바타, 이름, 별점, 작성일, 코멘트
  - 본인 리뷰는 수정/삭제 버튼 표시
  - 페이지네이션 (10개씩)
- 평점 통계:
  - 평균 평점 (소수점 1자리)
  - 별점별 분포 (5점: 50%, 4점: 30%, ...)
  - 총 리뷰 수

### 2. Q&A 게시판
- QnaController (index, create, store, show, update, destroy)
- QnaAnswerController (store, update, destroy)
- 질문 작성 (강의 상세 페이지 또는 학습 페이지):
  - 제목, 내용 (Markdown 지원)
  - 레슨 선택 (선택 사항)
  - '질문하기' 버튼
- 질문 목록 (강의 상세 페이지 탭):
  - resources/views/qna/index.blade.php
  - 각 질문: 제목, 작성자, 작성일, 답변 수, 해결 여부
  - 미해결 질문 우선 표시
  - 검색 기능 (제목, 내용)
  - 페이지네이션
- 질문 상세 페이지:
  - resources/views/qna/show.blade.php
  - 질문 내용 (Markdown 렌더링)
  - 답변 목록 (최신순)
  - 답변 작성 폼 (Textarea)
  - 강사 답변은 '강사' 뱃지 표시
  - 질문 작성자는 답변을 '채택'할 수 있음 (is_answered 업데이트)
- 강사 전용 기능:
  - 미답변 질문 알림 (대시보드)
  - 답변 작성 시 이메일 알림 발송

### 3. 알림 시스템
- notifications 테이블 생성 (Laravel 기본 알림)
- 알림 타입:
  - 새 리뷰 작성 (강사에게)
  - 새 질문 작성 (강사에게)
  - 답변 작성 (질문 작성자에게)
  - 새 레슨 업로드 (수강생에게)
- 알림 표시:
  - 네비게이션 바에 알림 아이콘 (읽지 않은 알림 수 표시)
  - 드롭다운으로 최근 알림 5개 표시
  - '모두 읽음' 버튼
- 알림 페이지:
  - resources/views/notifications/index.blade.php
  - 모든 알림 목록 (읽음/읽지 않음 필터)

### 4. 이메일 알림
- Laravel Mail 설정 (Mailtrap 또는 SMTP)
- Mailable 클래스 생성:
  - NewReviewNotification (강사에게)
  - NewQuestionNotification (강사에게)
  - NewAnswerNotification (질문 작성자에게)
- Queue로 이메일 발송 (비동기 처리)

### 5. 라우트 정의
- Route::resource('courses.reviews', ReviewController::class)->middleware('auth')
- Route::resource('courses.qna', QnaController::class)->middleware('auth')
- Route::post('qna/{qna}/answers', [QnaAnswerController::class, 'store'])
- Route::post('qna/{qna}/mark-answered', [QnaController::class, 'markAnswered'])
- Route::get('/notifications', [NotificationController::class, 'index'])
- Route::post('/notifications/mark-read', [NotificationController::class, 'markAllRead'])

## 디자인 요구사항
- 별점은 별 아이콘으로 시각화 (클릭 가능)
- Q&A는 포럼 스타일 디자인
- 알림 드롭다운은 부드러운 애니메이션
- Markdown 렌더링 (league/commonmark)

리뷰 작성 후 평균 평점이 자동 업데이트되는지 확인하세요.

Redis 캐싱, 성능 최적화, 테스트 작성을 완료하세요.

## 요구사항

### 1. Redis 캐싱
- Redis 설치 및 Laravel 설정
- 캐싱 전략:
  - 강의 목록 (1시간 캐싱)
    - Cache::remember('courses.all', 3600, fn() => Course::with('instructor')->get())
  - 인기 강의 (1일 캐싱)
    - Cache::remember('courses.popular', 86400, fn() => Course::orderBy('enrollments_count', 'desc')->take(10)->get())
  - 강의 상세 정보 (30분 캐싱)
    - Cache::remember("course.{$id}", 1800, fn() => Course::with('lessons', 'reviews')->find($id))
- 캐시 무효화:
  - 강의 수정/삭제 시 캐시 삭제
  - Cache::forget("course.{$id}")
  - Cache::tags(['courses'])->flush()

### 2. 데이터베이스 최적화
- Eager Loading으로 N+1 쿼리 문제 해결:
  - Course::with('instructor', 'lessons', 'reviews')->get()
- 인덱스 추가:
  - courses 테이블: slug, instructor_id, category
  - lessons 테이블: course_id, order
  - enrollments 테이블: user_id, course_id
- 페이지네이션 최적화 (Cursor Pagination)

### 3. 이미지 최적화
- Spatie Media Library로 썸네일 자동 생성
  - 여러 크기 (small, medium, large)
- Lazy Loading 적용 (loading="lazy")
- WebP 포맷 변환 (선택 사항)

### 4. 보안 강화
- CSRF 토큰 검증 (모든 POST 요청)
- XSS 방지 ({{ }} Blade 이스케이핑)
- SQL Injection 방지 (Eloquent ORM 사용)
- Rate Limiting:
  - 로그인 시도: 5회/분
  - 리뷰 작성: 3회/시간
  - API 요청: 60회/분
- HTTPS 강제 (프로덕션)

### 5. 테스트 작성 (PHPUnit)
- Feature Tests:
  - CourseTest (CRUD 테스트)
  - EnrollmentTest (수강 등록 테스트)
  - PaymentTest (결제 플로우 테스트)
  - ReviewTest (리뷰 작성 테스트)
- Unit Tests:
  - CoursePolicy (권한 테스트)
  - ProgressCalculation (진도율 계산 테스트)
- Database Factories 생성:
  - UserFactory, CourseFactory, LessonFactory
- Seeder 작성:
  - DatabaseSeeder (테스트 데이터 생성)

### 6. 에러 핸들링
- 커스텀 에러 페이지:
  - resources/views/errors/404.blade.php
  - resources/views/errors/500.blade.php
- 예외 로깅 (Sentry 또는 Laravel Log)
- 사용자 친화적 에러 메시지

### 7. 프로덕션 준비
- .env.example 업데이트
- README.md 작성:
  - 설치 가이드
  - 환경 변수 설정
  - 마이그레이션 및 시딩
  - Queue Worker 실행 방법
- Composer 최적화:
  - composer install --optimize-autoloader --no-dev
- 캐시 생성:
  - php artisan config:cache
  - php artisan route:cache
  - php artisan view:cache

### 8. 배포 체크리스트
- APP_ENV=production 설정
- APP_DEBUG=false 설정
- Stripe 프로덕션 키로 변경
- HTTPS 강제 (AppServiceProvider)
- Queue Worker 데몬 실행 (Supervisor)
- 스케줄러 설정 (Cron)
- 백업 설정 (Laravel Backup)

## 테스트 실행
- php artisan test --coverage
- 커버리지 70% 이상 목표

모든 테스트를 통과하고, 성능 최적화가 완료되면 프로젝트가 완성됩니다!