🎓 온라인 코스 수강 후기 & 강사 평점 플랫폼

mkdir course-review-rating-platform && cd course-review-rating-platform

이 폴더에서 Laravel 13.x + Inertia.js + React 19 프로젝트를 시작합니다.

다음 명령으로 Laravel Breeze (React + Inertia) starter kit을 설치하세요:

```bash
composer create-project laravel/laravel .
composer require laravel/breeze --dev
php artisan breeze:install react
npm install
npm run build
```

프로젝트 초기 설정:
1. `.env` 파일에서 데이터베이스를 SQLite로 설정 (`DB_CONNECTION=sqlite`, `database/database.sqlite` 파일 생성)
2. `php artisan migrate` 실행하여 기본 테이블 생성
3. `npm run dev` 실행하여 Vite 개발 서버 시작
4. `php artisan serve` 실행하여 Laravel 서버 시작

기본 구조가 정상 작동하는지 확인하세요 (Welcome 페이지 또는 Breeze 로그인 페이지 접속).

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

다음 세 개의 모델과 마이그레이션이 필요합니다:

1. **Instructor (강사)**
   - `id` (Primary Key)
   - `name` (강사 이름, string)
   - `bio` (소개, text)
   - `profile_image` (프로필 이미지 URL, string, nullable)
   - `timestamps`

2. **Course (코스)**
   - `id` (Primary Key)
   - `instructor_id` (Foreign Key → instructors.id)
   - `title` (코스 제목, string)
   - `description` (코스 설명, text)
   - `thumbnail` (썸네일 이미지 URL, string, nullable)
   - `price` (가격, decimal 8,2, nullable)
   - `timestamps`

3. **Review (리뷰)**
   - `id` (Primary Key)
   - `course_id` (Foreign Key → courses.id)
   - `user_id` (Foreign Key → users.id, Breeze 기본 User 모델 활용)
   - `rating` (별점, integer, 1~5)
   - `comment` (후기 내용, text)
   - `is_recommended` (추천 여부, boolean, default false)
   - `helpful_count` (도움됨 투표 수, integer, default 0)
   - `timestamps`

마이그레이션 생성 명령:
```bash
php artisan make:model Instructor -m
php artisan make:model Course -m
php artisan make:model Review -m
```

각 마이그레이션 파일에 위 스키마를 작성하고, `php artisan migrate`를 실행하세요.

모델 파일 (`app/Models/`)에 Eloquent 관계를 정의하세요:
- `Instructor` hasMany `Course`
- `Course` belongsTo `Instructor`, hasMany `Review`
- `Review` belongsTo `Course`, belongsTo `User`

시더(Seeder)를 만들어 샘플 데이터를 생성하세요 (강사 3명, 코스 10개, 리뷰 30개 정도):
```bash
php artisan make:seeder DatabaseSeeder
```

`DatabaseSeeder.php`에서 팩토리 또는 수동으로 샘플 데이터를 생성하고, `php artisan db:seed` 실행.

코스 목록 페이지를 구현하세요.

Laravel 컨트롤러와 Inertia 페이지 컴포넌트를 생성합니다.

1. **컨트롤러 생성:**
```bash
php artisan make:controller CourseController
```

`CourseController`에 `index` 메서드를 작성하세요:
- 모든 코스를 조회하고, 각 코스의 평균 별점(`reviews`의 `rating` 평균)과 리뷰 개수를 계산
- `withAvg('reviews', 'rating')`, `withCount('reviews')` 사용
- Instructor 정보도 함께 로드 (`with('instructor')`)
- Inertia::render()로 'Courses/Index' 페이지에 데이터 전달

2. **라우트 등록 (`routes/web.php`):**
```php
use App\Http\Controllers\CourseController;

Route::get('/courses', [CourseController::class, 'index'])->name('courses.index');
```

3. **React 페이지 컴포넌트 생성 (`resources/js/Pages/Courses/Index.jsx`):**
- Inertia의 `usePage()` 훅으로 전달받은 courses 데이터 사용
- 코스 목록을 그리드 레이아웃(Tailwind CSS grid)으로 표시
- 각 코스 카드에 썸네일, 제목, 강사 이름, 평균 별점(⭐ 아이콘), 리뷰 수 표시
- 별점은 숫자 또는 별 아이콘으로 시각화 (예: 4.5 → ⭐⭐⭐⭐☆)
- 코스 카드 클릭 시 상세 페이지로 이동 (`/courses/{id}`)

Tailwind CSS로 반응형 디자인 적용 (모바일: 1열, 태블릿: 2열, 데스크톱: 3열).

브라우저에서 `/courses` 접속하여 코스 목록이 정상 표시되는지 확인하세요.

코스 상세 페이지를 구현하세요.

1. **컨트롤러 메서드 추가 (`CourseController::show`):**
- 특정 코스 ID로 코스 조회
- Instructor, Reviews(+User 정보) eager loading
- 평균 별점, 리뷰 개수, 별점 분포(1~5점별 개수) 계산
- Inertia::render()로 'Courses/Show' 페이지에 데이터 전달

2. **라우트 추가:**
```php
Route::get('/courses/{course}', [CourseController::class, 'show'])->name('courses.show');
```

3. **React 페이지 컴포넌트 (`resources/js/Pages/Courses/Show.jsx`):**
- 코스 정보 섹션: 썸네일(큰 이미지), 제목, 강사 이름(클릭 시 강사 프로필로 이동), 설명, 가격
- 평균 별점 및 리뷰 통계 섹션:
  - 큰 별점 숫자 (예: 4.3 / 5.0)
  - 별점 분포 바 차트 (1~5점별 리뷰 개수를 가로 막대로 표시)
  - 총 리뷰 개수
- 리뷰 목록 섹션:
  - 각 리뷰: 작성자 이름, 별점, 작성일, 후기 내용, 추천 여부 배지
  - 최신순 정렬 (나중에 필터 추가)
- "리뷰 작성하기" 버튼 (클릭 시 리뷰 작성 폼으로 이동 또는 모달 열기)

Tailwind CSS로 레이아웃 구성 (2열 레이아웃: 왼쪽 코스 정보, 오른쪽 리뷰 목록).

브라우저에서 코스 카드 클릭 → 상세 페이지 이동 확인.

리뷰 작성 기능을 구현하세요.

1. **리뷰 작성 폼 컴포넌트 (`resources/js/Pages/Reviews/Create.jsx` 또는 모달 컴포넌트):**
- 별점 선택 UI (1~5 별 아이콘 클릭 또는 라디오 버튼)
- 후기 내용 텍스트 영역 (필수, 최소 10자)
- 추천 여부 체크박스 ("이 코스를 추천하시나요?")
- 제출 버튼

2. **컨트롤러 메서드 (`ReviewController`):**
```bash
php artisan make:controller ReviewController
```

- `create` 메서드: 리뷰 작성 폼 페이지 렌더링 (course_id를 URL 파라미터로 전달)
- `store` 메서드:
  - 폼 데이터 검증 (rating: required|integer|between:1,5, comment: required|min:10)
  - 현재 로그인 유저 ID (Breeze 인증 사용, `auth()->id()`)
  - Review 모델에 데이터 저장
  - 저장 후 코스 상세 페이지로 리다이렉트 (`redirect()->route('courses.show', $course)`)

3. **라우트 추가:**
```php
Route::middleware('auth')->group(function () {
    Route::get('/courses/{course}/reviews/create', [ReviewController::class, 'create'])->name('reviews.create');
    Route::post('/courses/{course}/reviews', [ReviewController::class, 'store'])->name('reviews.store');
});
```

4. **코스 상세 페이지에서 "리뷰 작성하기" 버튼 연결:**
- `<Link href={route('reviews.create', course.id)}>리뷰 작성</Link>` (Inertia Link 컴포넌트 사용)
- 로그인하지 않은 경우 로그인 페이지로 리다이렉트 (미들웨어 처리)

5. **폼 제출 처리 (React):**
- Inertia의 `useForm()` 훅 사용
- 폼 검증 에러 표시 (Laravel 검증 에러를 Inertia가 자동 전달)

리뷰 작성 후 코스 상세 페이지에서 새 리뷰가 목록에 추가되었는지 확인하세요.

리뷰 필터링 및 정렬 기능을 추가하세요.

1. **코스 상세 페이지에 필터 UI 추가 (`Courses/Show.jsx`):**
- 별점 필터 버튼 (전체, 5점, 4점, 3점, 2점, 1점)
- 정렬 드롭다운 (최신순, 추천순, 별점 높은 순, 별점 낮은 순)

2. **필터/정렬 상태 관리 (React useState):**
- `selectedRating` (null 또는 1~5)
- `sortBy` ('latest', 'recommended', 'rating_high', 'rating_low')

3. **필터 변경 시 Laravel 컨트롤러에 쿼리 파라미터 전달:**
- Inertia Link 또는 useForm으로 GET 요청 (`/courses/{id}?rating=5&sort=latest`)
- 컨트롤러에서 `request()->query('rating')`, `request()->query('sort')` 읽기
- 리뷰 조회 시 조건 적용:
  - rating 필터: `$query->where('rating', $rating)`
  - sort: `$query->orderBy('created_at', 'desc')` (최신순), `$query->orderBy('rating', 'desc')` (별점 높은 순) 등

4. **필터 적용 후 리뷰 목록 업데이트:**
- Inertia가 자동으로 페이지를 다시 렌더링하며 필터된 리뷰 표시

5. **UI 개선:**
- 현재 선택된 필터 버튼 강조 (Tailwind CSS 조건부 클래스)
- 필터 초기화 버튼 추가 ("전체 보기")

브라우저에서 별점 필터 클릭 → 해당 별점의 리뷰만 표시되는지 확인하세요.

강사 프로필 페이지를 구현하세요.

1. **컨트롤러 생성:**
```bash
php artisan make:controller InstructorController
```

`InstructorController::show` 메서드:
- 특정 강사 ID로 강사 조회
- 강사가 담당하는 코스 목록 조회 (`with('courses')`)
- 강사의 전체 평균 평점 계산 (모든 코스의 리뷰 평균)
- Inertia::render()로 'Instructors/Show' 페이지에 데이터 전달

2. **라우트 추가:**
```php
Route::get('/instructors/{instructor}', [InstructorController::class, 'show'])->name('instructors.show');
```

3. **React 페이지 컴포넌트 (`resources/js/Pages/Instructors/Show.jsx`):**
- 강사 프로필 섹션:
  - 프로필 이미지 (원형 또는 정사각형)
  - 강사 이름, 소개(bio)
  - 전체 평균 평점 (⭐ 아이콘)
- 담당 코스 목록 섹션:
  - 코스 카드 그리드 (코스 목록 페이지와 동일한 스타일)
  - 각 코스 카드 클릭 시 코스 상세 페이지로 이동

4. **코스 상세 페이지에서 강사 이름 클릭 시 강사 프로필로 이동:**
- `<Link href={route('instructors.show', course.instructor.id)}>{course.instructor.name}</Link>`

Tailwind CSS로 프로필 레이아웃 구성 (상단: 프로필 정보, 하단: 코스 그리드).

브라우저에서 코스 상세 → 강사 이름 클릭 → 강사 프로필 페이지 확인.

보너스 기능: 리뷰 "도움됨" 투표 기능을 추가하세요.

1. **리뷰 테이블에 `helpful_count` 컬럼이 이미 있는지 확인 (step 2에서 추가).**

2. **컨트롤러 메서드 (`ReviewController::helpful`):**
- 특정 리뷰의 `helpful_count`를 1 증가
- `$review->increment('helpful_count');`
- JSON 응답으로 업데이트된 카운트 반환 (또는 Inertia 리다이렉트)

3. **라우트 추가:**
```php
Route::post('/reviews/{review}/helpful', [ReviewController::class, 'helpful'])->name('reviews.helpful');
```

4. **코스 상세 페이지 리뷰 목록에 "도움됨" 버튼 추가 (`Courses/Show.jsx`):**
- 각 리뷰 카드에 👍 버튼과 카운트 표시
- 버튼 클릭 시 Inertia `post` 요청으로 `/reviews/{review.id}/helpful` 호출
- 성공 후 페이지 새로고침하여 카운트 업데이트 (또는 React 상태로 즉시 반영)

5. **베스트 리뷰 배지 추가:**
- `helpful_count >= 10`인 리뷰에 "🏆 베스트 리뷰" 배지 표시 (Tailwind CSS 배지 스타일)

6. **정렬 옵션에 "추천순" 추가:**
- 컨트롤러에서 `orderBy('helpful_count', 'desc')` 적용

브라우저에서 리뷰 "도움됨" 버튼 클릭 → 카운트 증가 확인, 10개 이상 시 배지 표시 확인.