🎓 온라인 워크숍 예약 & 출석 관리 플랫폼 - 실시간 좌석 현황 & QR 체크인

mkdir workshop-booking-attendance-platform && cd workshop-booking-attendance-platform

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

## 목표
SQLite 데이터베이스 스키마를 설계하고, 기본 디렉토리 구조 및 DB 연결 헬퍼를 만듭니다.

## 요구사항
1. 다음 디렉토리 생성:
   - `includes/` (헬퍼 파일)
   - `admin/` (관리자 페이지)
   - `assets/css/`, `assets/js/` (정적 파일)
   - `uploads/` (워크숍 이미지)
   - `cache/` (캐시 파일)
   - `qrcodes/` (QR 코드 이미지)

2. `includes/db.php` 작성:
   - PDO로 SQLite 연결 (`database.sqlite`)
   - 에러 모드: ERRMODE_EXCEPTION
   - 자동으로 테이블 생성 (없을 경우)

3. 테이블 설계 (SQL):
   ```sql
   CREATE TABLE IF NOT EXISTS users (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     email TEXT UNIQUE NOT NULL,
     password TEXT NOT NULL,
     name TEXT NOT NULL,
     role TEXT DEFAULT 'user' CHECK(role IN ('user', 'admin')),
     created_at DATETIME DEFAULT CURRENT_TIMESTAMP
   );

   CREATE TABLE IF NOT EXISTS workshops (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     title TEXT NOT NULL,
     description TEXT,
     category TEXT NOT NULL,
     instructor TEXT NOT NULL,
     location TEXT NOT NULL,
     start_datetime DATETIME NOT NULL,
     end_datetime DATETIME NOT NULL,
     capacity INTEGER NOT NULL,
     price REAL DEFAULT 0,
     image TEXT,
     created_by INTEGER,
     created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
     FOREIGN KEY (created_by) REFERENCES users(id)
   );

   CREATE TABLE IF NOT EXISTS bookings (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     user_id INTEGER NOT NULL,
     workshop_id INTEGER NOT NULL,
     status TEXT DEFAULT 'confirmed' CHECK(status IN ('confirmed', 'cancelled', 'waitlist')),
     qr_code TEXT UNIQUE,
     booked_at DATETIME DEFAULT CURRENT_TIMESTAMP,
     FOREIGN KEY (user_id) REFERENCES users(id),
     FOREIGN KEY (workshop_id) REFERENCES workshops(id),
     UNIQUE(user_id, workshop_id)
   );

   CREATE TABLE IF NOT EXISTS attendance (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     booking_id INTEGER NOT NULL,
     checked_in_at DATETIME,
     FOREIGN KEY (booking_id) REFERENCES bookings(id)
   );

   CREATE INDEX idx_workshops_start ON workshops(start_datetime);
   CREATE INDEX idx_bookings_user ON bookings(user_id);
   CREATE INDEX idx_bookings_workshop ON bookings(workshop_id);
   ```

4. `includes/helpers.php` 작성:
   - `csrf_token()`: CSRF 토큰 생성 및 세션 저장
   - `verify_csrf()`: 토큰 검증
   - `escape($str)`: htmlspecialchars 래퍼
   - `redirect($url)`: 리다이렉트 헬퍼
   - `is_logged_in()`: 로그인 여부 확인
   - `is_admin()`: 관리자 권한 확인
   - `log_error($message)`: error.log 파일에 에러 기록

5. 테스트 데이터 삽입 (관리자 계정 1개, 샘플 워크숍 3개):
   - 관리자: admin@example.com / password123 (해시 저장)
   - 워크숍: '웹 개발 부트캠프', 'UI/UX 디자인 워크숍', '데이터 분석 입문'

## 완료 조건
- `php -S localhost:8000`로 서버 실행 시 에러 없음
- `database.sqlite` 파일 생성 확인
- 테이블 4개 생성 확인 (users, workshops, bookings, attendance)
- 테스트 데이터 삽입 확인

## 목표
사용자 인증 시스템을 구축합니다 (회원가입, 로그인, 로그아웃).

## 요구사항
1. `includes/auth.php` 작성:
   - `register_user($email, $password, $name)`: 회원가입
     - 이메일 중복 체크
     - 비밀번호 해싱 (password_hash with PASSWORD_BCRYPT)
     - DB 삽입 후 자동 로그인
   - `login_user($email, $password)`: 로그인
     - 이메일로 사용자 조회
     - password_verify로 비밀번호 확인
     - 세션에 user_id, email, role 저장
   - `logout_user()`: 로그아웃 (세션 파괴)
   - `require_login()`: 로그인 필수 페이지용 미들웨어
   - `require_admin()`: 관리자 전용 페이지용 미들웨어

2. `register.php` 작성:
   - GET: 회원가입 폼 표시
     - 이메일, 비밀번호, 비밀번호 확인, 이름 입력 필드
     - CSRF 토큰 hidden 필드
   - POST: 회원가입 처리
     - CSRF 토큰 검증
     - 입력 유효성 검사 (이메일 형식, 비밀번호 길이 8자 이상)
     - 비밀번호 확인 일치 여부
     - `register_user()` 호출
     - 성공 시 index.php로 리다이렉트
     - 실패 시 에러 메시지 표시

3. `login.php` 작성:
   - GET: 로그인 폼 표시
     - 이메일, 비밀번호 입력 필드
     - CSRF 토큰 hidden 필드
     - 회원가입 링크
   - POST: 로그인 처리
     - CSRF 토큰 검증
     - `login_user()` 호출
     - 성공 시 index.php로 리다이렉트
     - 실패 시 에러 메시지 표시

4. `logout.php` 작성:
   - `logout_user()` 호출 후 login.php로 리다이렉트

5. 기본 CSS 스타일링 (`assets/css/style.css`):
   - 폼 스타일 (입력 필드, 버튼, 에러 메시지)
   - 반응형 레이아웃 (Flexbox)
   - 색상 테마 (주요 색상: #3498db, 보조 색상: #2c3e50)

## 완료 조건
- 회원가입 폼에서 새 계정 생성 가능
- 로그인 폼에서 생성한 계정으로 로그인 가능
- 로그인 후 세션에 사용자 정보 저장 확인
- 로그아웃 시 세션 파괴 확인
- CSRF 토큰 검증 동작 확인
- 비밀번호 해싱 확인 (DB에 평문 저장 금지)

## 목표
워크숍 목록 페이지와 상세 페이지를 만듭니다. 사용자가 워크숍을 검색하고 필터링할 수 있어야 합니다.

## 요구사항
1. `index.php` (워크숍 목록 페이지):
   - 헤더: 로그인/로그아웃 링크, 사용자 이름 표시
   - 검색 폼:
     - 키워드 검색 (제목, 설명에서 검색)
     - 카테고리 필터 (드롭다운: 전체, 개발, 디자인, 비즈니스, 기타)
     - 날짜 필터 (시작일 이후 워크숍만 표시)
   - 워크숍 카드 리스트:
     - 각 카드: 이미지(썸네일), 제목, 강사, 일시, 장소, 정원/잔여석, 가격
     - 잔여석 계산: `capacity - (SELECT COUNT(*) FROM bookings WHERE workshop_id = ? AND status = 'confirmed')`
     - 잔여석 0일 경우 "마감" 배지 표시
     - "자세히 보기" 버튼 (workshop.php?id=X)
   - 페이지네이션 (한 페이지당 9개)
   - 캐싱:
     - 검색 조건이 없을 때 워크숍 목록을 `cache/workshops.json`에 10분간 캐시
     - `includes/cache.php` 작성 (`get_cache($key)`, `set_cache($key, $data, $ttl)`)

2. `workshop.php` (워크숍 상세 페이지):
   - GET 파라미터로 워크숍 ID 받기
   - 워크숍 정보 조회 (제목, 설명, 강사, 일시, 장소, 정원, 가격, 이미지)
   - 실시간 잔여석 표시 (AJAX 폴링으로 10초마다 갱신)
   - 예약 버튼:
     - 로그인 필요 (미로그인 시 login.php로 리다이렉트)
     - 잔여석 있을 경우: "예약하기" 버튼
     - 잔여석 없을 경우: "대기 등록" 버튼
   - 이미 예약한 경우: "예약 완료" 배지 표시
   - 워크숍 설명 마크다운 렌더링 (간단한 \n -> <br> 변환)

3. JavaScript (`assets/js/main.js`):
   - 실시간 잔여석 갱신 함수 (AJAX):
     ```javascript
     async function updateAvailableSeats(workshopId) {
       const response = await fetch(`api/seats.php?id=${workshopId}`);
       const data = await response.json();
       document.getElementById('available-seats').textContent = data.available;
       if (data.available === 0) {
         document.getElementById('book-btn').textContent = '대기 등록';
       }
     }
     setInterval(() => updateAvailableSeats(workshopId), 10000);
     ```

4. `api/seats.php` 작성:
   - GET 파라미터로 워크숍 ID 받기
   - 잔여석 계산 후 JSON 응답:
     ```json
     {"available": 5, "capacity": 20}
     ```

## 완료 조건
- 워크숍 목록 페이지에서 모든 워크숍 표시 확인
- 검색 및 필터링 동작 확인
- 페이지네이션 동작 확인
- 워크숍 상세 페이지에서 정보 정확히 표시
- 실시간 잔여석 갱신 확인 (10초마다)
- 캐싱 동작 확인 (`cache/workshops.json` 파일 생성)

## 목표
워크숍 예약 시스템을 구현합니다. 사용자가 워크숍을 예약하고, QR 코드를 받으며, 예약 확인 이메일을 받습니다.

## 요구사항
1. `booking.php` 작성:
   - POST 요청 처리 (workshop_id 파라미터)
   - 로그인 필수 (`require_login()`)
   - CSRF 토큰 검증
   - 중복 예약 체크 (user_id + workshop_id 조합)
   - 잔여석 확인:
     - DB 트랜잭션 시작
     - SELECT ... FOR UPDATE로 워크숍 잠금
     - 잔여석 계산
     - 잔여석 있으면: status = 'confirmed'
     - 잔여석 없으면: status = 'waitlist'
   - 예약 삽입 (bookings 테이블)
   - QR 코드 생성:
     - 예약 ID를 암호화 (base64 + HMAC-SHA256)
     - `includes/qr.php` 작성 (`generate_qr_code($data)` 함수)
     - QR 코드 이미지를 `qrcodes/{booking_id}.png`로 저장
     - bookings 테이블의 qr_code 필드 업데이트
   - 출석 레코드 생성 (attendance 테이블, checked_in_at은 NULL)
   - 트랜잭션 커밋
   - 예약 확인 이메일 발송:
     - `includes/email.php` 작성 (`send_booking_confirmation($user_email, $booking_data)` 함수)
     - 이메일 내용: 워크숍 정보, 예약 번호, QR 코드 이미지 첨부
     - PHP mail() 함수 사용 (또는 SMTP 설정 가능)
   - 성공 시 my-bookings.php로 리다이렉트

2. `includes/qr.php` 작성:
   - `generate_qr_code($data)` 함수:
     - 입력: 예약 ID
     - 암호화: HMAC-SHA256으로 서명 생성 (비밀키는 환경변수 또는 상수)
     - QR 코드 데이터: `{"booking_id": X, "signature": "..."}`
     - 간단한 QR 코드 생성 로직 (순수 PHP로 구현 또는 SVG 템플릿 활용)
     - PNG 이미지 파일로 저장
   - `verify_qr_code($qr_data)` 함수:
     - QR 코드 데이터 파싱
     - 서명 검증
     - 예약 ID 반환 (검증 실패 시 false)

3. `my-bookings.php` (내 예약 내역 페이지):
   - 로그인 필수 (`require_login()`)
   - 현재 사용자의 예약 목록 조회:
     - JOIN workshops ON bookings.workshop_id = workshops.id
     - 예약 상태별 필터링 (confirmed, cancelled, waitlist)
   - 각 예약 카드:
     - 워크숍 제목, 일시, 장소
     - 예약 상태 배지
     - QR 코드 이미지 표시
     - "예약 취소" 버튼 (워크숍 시작 24시간 전까지만 가능)
     - "QR 코드 다운로드" 버튼

4. `cancel-booking.php` 작성:
   - POST 요청 처리 (booking_id 파라미터)
   - 로그인 필수 + 본인 예약인지 확인
   - CSRF 토큰 검증
   - 취소 가능 시간 체크 (워크숍 시작 24시간 전)
   - 예약 상태를 'cancelled'로 업데이트
   - 대기자가 있으면 자동으로 첫 번째 대기자를 'confirmed'로 변경
   - 성공 시 my-bookings.php로 리다이렉트

## 완료 조건
- 워크숍 예약 시 DB에 예약 레코드 생성 확인
- QR 코드 이미지 파일 생성 확인 (`qrcodes/` 디렉토리)
- 예약 확인 이메일 발송 확인 (로컬 환경에서는 로그 파일로 대체 가능)
- 내 예약 내역 페이지에서 예약 목록 표시 확인
- 예약 취소 동작 확인
- 대기자 자동 승격 동작 확인
- 동시 예약 시 트랜잭션으로 데이터 무결성 보장

## 목표
관리자 페이지를 구축합니다. 관리자는 워크숍을 생성/수정/삭제하고, 예약자 목록을 조회할 수 있습니다.

## 요구사항
1. `admin/dashboard.php` (관리자 대시보드):
   - 관리자 전용 (`require_admin()`)
   - 통계 카드:
     - 전체 워크숍 수
     - 전체 예약 수
     - 오늘 시작하는 워크숍 수
     - 이번 주 예약 수
   - 최근 예약 목록 (최근 10개)
   - 워크숍 관리, 예약자 관리, QR 스캔 메뉴 링크

2. `admin/workshops.php` (워크숍 관리):
   - 관리자 전용 (`require_admin()`)
   - GET: 워크숍 목록 표시
     - 테이블 형식 (제목, 강사, 일시, 정원, 예약 수, 작업)
     - 각 행에 "수정", "삭제" 버튼
     - "새 워크숍 추가" 버튼
   - GET (id 파라미터 있을 경우): 워크숍 수정 폼 표시
     - 모든 필드 편집 가능 (제목, 설명, 카테고리, 강사, 장소, 일시, 정원, 가격)
     - 이미지 업로드 필드
   - POST: 워크숍 생성/수정 처리
     - CSRF 토큰 검증
     - 입력 유효성 검사
     - 이미지 업로드 처리:
       - 허용 확장자: jpg, png, gif
       - 최대 크기: 5MB
       - MIME 타입 검증
       - 파일명: `workshop_{id}_{timestamp}.{ext}`
       - `uploads/` 디렉토리에 저장
     - DB 삽입/업데이트
     - 캐시 무효화 (`cache/workshops.json` 삭제)
     - 성공 시 admin/workshops.php로 리다이렉트

3. `admin/delete-workshop.php` 작성:
   - POST 요청 처리 (id 파라미터)
   - 관리자 전용 (`require_admin()`)
   - CSRF 토큰 검증
   - 해당 워크숍의 모든 예약 취소 처리
   - 워크숍 삭제 (CASCADE로 예약도 삭제)
   - 캐시 무효화
   - 성공 시 admin/workshops.php로 리다이렉트

4. `admin/attendees.php` (예약자 관리):
   - 관리자 전용 (`require_admin()`)
   - GET 파라미터로 워크숍 ID 받기
   - 해당 워크숍의 예약자 목록 조회:
     - JOIN users ON bookings.user_id = users.id
     - 예약 상태, 예약일시, 출석 여부 표시
   - 테이블 형식 (이름, 이메일, 예약 상태, 출석 여부, QR 코드)
   - 각 행에 "출석 체크" 버튼 (수동 출석 처리)
   - CSV 내보내기 버튼

5. 관리자 네비게이션 메뉴:
   - 모든 관리자 페이지에 공통 헤더 포함
   - 메뉴: 대시보드, 워크숍 관리, QR 스캔, 통계

## 완료 조건
- 관리자 대시보드에서 통계 정보 표시 확인
- 워크숍 생성/수정/삭제 동작 확인
- 이미지 업로드 및 저장 확인
- 예약자 목록 조회 확인
- 캐시 무효화 동작 확인
- 관리자 권한 체크 동작 확인 (일반 사용자 접근 시 리다이렉트)

## 목표
QR 코드 스캔 및 출석 체크 시스템을 구현합니다. 관리자가 참가자의 QR 코드를 스캔하여 출석을 확인할 수 있습니다.

## 요구사항
1. `admin/qr-scanner.php` (QR 스캔 페이지):
   - 관리자 전용 (`require_admin()`)
   - 두 가지 스캔 방법 제공:
     - 카메라로 실시간 스캔 (JavaScript 웹캠 API)
     - QR 코드 이미지 파일 업로드
   - JavaScript (`assets/js/qr-scanner.js`):
     - 웹캠 접근 권한 요청
     - 실시간 비디오 스트림에서 QR 코드 감지 (jsQR 라이브러리 또는 순수 JS)
     - QR 코드 데이터를 서버로 전송 (AJAX)
   - 파일 업로드 폼:
     - QR 코드 이미지 파일 선택
     - 서버에서 이미지 파싱 (PHP GD 또는 Imagick)
     - QR 코드 데이터 추출

2. `admin/check-attendance.php` 작성:
   - POST 요청 처리 (qr_data 파라미터)
   - 관리자 전용 (`require_admin()`)
   - CSRF 토큰 검증
   - QR 코드 검증:
     - `verify_qr_code($qr_data)` 호출
     - 예약 ID 추출
     - 예약 정보 조회 (bookings 테이블)
     - 예약 상태 확인 (confirmed만 출석 가능)
   - 중복 출석 체크 (attendance 테이블에서 checked_in_at이 NULL인지 확인)
   - 출석 처리:
     - attendance 테이블의 checked_in_at을 현재 시간으로 업데이트
   - JSON 응답:
     ```json
     {
       "success": true,
       "message": "출석 완료",
       "user": {"name": "홍길동", "email": "hong@example.com"},
       "workshop": {"title": "웹 개발 부트캠프"}
     }
     ```
   - 실패 시:
     ```json
     {
       "success": false,
       "error": "유효하지 않은 QR 코드입니다."
     }
     ```

3. `admin/manual-checkin.php` 작성:
   - POST 요청 처리 (booking_id 파라미터)
   - 관리자 전용 (`require_admin()`)
   - CSRF 토큰 검증
   - 수동 출석 처리 (QR 코드 없이 관리자가 직접 체크)
   - 성공 시 admin/attendees.php로 리다이렉트

4. QR 스캔 UI:
   - 실시간 카메라 프리뷰 (비디오 요소)
   - 스캔 결과 표시 영역 (성공/실패 메시지, 사용자 정보)
   - 스캔 이력 리스트 (최근 10개)
   - "다시 스캔" 버튼

5. QR 코드 보안 강화:
   - QR 코드 데이터에 타임스탬프 포함 (유효기간 설정, 예: 24시간)
   - 서명 검증 시 타임스탬프 체크
   - 재사용 방지 (한 번 스캔된 QR 코드는 재사용 불가)

## 완료 조건
- QR 스캔 페이지에서 카메라 접근 확인
- 실시간 QR 코드 스캔 동작 확인
- 파일 업로드로 QR 코드 스캔 동작 확인
- QR 코드 검증 및 출석 처리 확인
- 중복 출석 방지 확인
- 유효하지 않은 QR 코드 거부 확인
- 수동 출석 체크 동작 확인

## 목표
관리자 통계 페이지를 구현합니다. 워크숍별 출석률, 예약 현황, 수익 통계 등을 시각화합니다.

## 요구사항
1. `admin/stats.php` (통계 페이지):
   - 관리자 전용 (`require_admin()`)
   - 전체 통계 카드:
     - 전체 워크숍 수
     - 전체 예약 수 (confirmed + waitlist)
     - 전체 출석 수
     - 전체 수익 (예약 * 가격 합계)
   - 워크숍별 통계 테이블:
     - 각 워크숍: 제목, 정원, 예약 수, 출석 수, 출석률, 수익
     - 출석률 계산: `(출석 수 / 예약 수) * 100`
     - 수익 계산: `예약 수 * 가격`
   - 카테고리별 통계 차트:
     - Chart.js 라이브러리 사용 (CDN)
     - 파이 차트: 카테고리별 워크숍 수
     - 막대 차트: 카테고리별 예약 수
   - 월별 예약 추이 차트:
     - 라인 차트: 최근 6개월간 월별 예약 수
   - 날짜 범위 필터:
     - 시작일 ~ 종료일 선택 (기본: 최근 30일)
     - 필터 적용 시 통계 재계산

2. `api/stats-data.php` 작성:
   - GET 파라미터로 날짜 범위 받기 (start_date, end_date)
   - 관리자 전용 (`require_admin()`)
   - SQL 쿼리로 통계 데이터 계산:
     - 워크숍별 예약 수: `SELECT workshop_id, COUNT(*) FROM bookings GROUP BY workshop_id`
     - 워크숍별 출석 수: `SELECT workshop_id, COUNT(*) FROM bookings JOIN attendance ON bookings.id = attendance.booking_id WHERE checked_in_at IS NOT NULL GROUP BY workshop_id`
     - 카테고리별 워크숍 수: `SELECT category, COUNT(*) FROM workshops GROUP BY category`
     - 월별 예약 수: `SELECT strftime('%Y-%m', booked_at) as month, COUNT(*) FROM bookings GROUP BY month`
   - JSON 응답:
     ```json
     {
       "workshops": [...],
       "categories": {...},
       "monthly": [...]
     }
     ```

3. JavaScript 차트 렌더링 (`assets/js/stats.js`):
   - AJAX로 `api/stats-data.php` 호출
   - Chart.js로 차트 그리기:
     ```javascript
     const ctx = document.getElementById('categoryChart').getContext('2d');
     new Chart(ctx, {
       type: 'pie',
       data: {
         labels: Object.keys(data.categories),
         datasets: [{
           data: Object.values(data.categories),
           backgroundColor: ['#3498db', '#e74c3c', '#2ecc71', '#f39c12']
         }]
       }
     });
     ```
   - 날짜 범위 필터 변경 시 차트 업데이트

4. CSV 내보내기 기능:
   - "CSV 다운로드" 버튼
   - `admin/export-stats.php` 작성:
     - 관리자 전용 (`require_admin()`)
     - 통계 데이터를 CSV 형식으로 생성
     - Content-Type: text/csv 헤더
     - 파일명: `workshop_stats_{date}.csv`

## 완료 조건
- 통계 페이지에서 전체 통계 카드 표시 확인
- 워크숍별 통계 테이블 정확히 표시
- Chart.js 차트 렌더링 확인 (파이, 막대, 라인 차트)
- 날짜 범위 필터 동작 확인
- CSV 내보내기 동작 확인
- 통계 데이터 정확성 검증

## 목표
이메일 알림 시스템을 구현합니다. 워크숍 시작 1일 전 자동 알림, 대기자 승격 알림 등을 발송합니다.

## 요구사항
1. `includes/email.php` 개선:
   - `send_booking_confirmation($user_email, $booking_data)`: 예약 확인 이메일
     - 제목: "[워크숍 예약 완료] {워크숍 제목}"
     - 내용: 워크숍 정보, 예약 번호, QR 코드 이미지 첨부
   - `send_reminder($user_email, $workshop_data)`: 워크숍 시작 1일 전 알림
     - 제목: "[내일 워크숍 시작] {워크숍 제목}"
     - 내용: 일시, 장소, 준비물 안내
   - `send_waitlist_promotion($user_email, $booking_data)`: 대기자 승격 알림
     - 제목: "[예약 확정] {워크숍 제목} 대기가 해제되었습니다"
     - 내용: 예약 확정 안내, QR 코드 재발급
   - `send_cancellation_notice($user_email, $workshop_data)`: 워크숍 취소 안내
     - 제목: "[워크숍 취소 안내] {워크숍 제목}"
     - 내용: 취소 사유, 환불 안내

2. `cron/send-reminders.php` 작성 (크론잡 스크립트):
   - CLI 모드에서 실행 (`php cron/send-reminders.php`)
   - 내일 시작하는 워크숍 조회:
     ```sql
     SELECT * FROM workshops 
     WHERE DATE(start_datetime) = DATE('now', '+1 day')
     ```
   - 각 워크숍의 confirmed 예약자들에게 알림 발송
   - 발송 로그 기록 (`logs/email.log`)

3. 대기자 자동 승격 개선:
   - `cancel-booking.php` 수정:
     - 예약 취소 시 대기자 목록 조회 (waitlist 상태, 예약일시 순)
     - 첫 번째 대기자를 confirmed로 변경
     - QR 코드 재생성
     - 승격 알림 이메일 발송

4. 이메일 템플릿 시스템:
   - `templates/email/` 디렉토리 생성
   - HTML 이메일 템플릿 작성:
     - `booking_confirmation.html`
     - `reminder.html`
     - `waitlist_promotion.html`
     - `cancellation_notice.html`
   - 템플릿 변수 치환 함수:
     ```php
     function render_email_template($template, $vars) {
       $html = file_get_contents("templates/email/{$template}.html");
       foreach ($vars as $key => $value) {
         $html = str_replace("{{{$key}}}", $value, $html);
       }
       return $html;
     }
     ```

5. 이메일 발송 로깅:
   - 모든 이메일 발송 시 `logs/email.log`에 기록
   - 로그 형식: `[2024-01-15 10:30:00] TO: user@example.com, SUBJECT: 예약 확인, STATUS: sent`

## 완료 조건
- 예약 확인 이메일 발송 확인 (QR 코드 첨부)
- 워크숍 1일 전 알림 이메일 발송 확인 (크론잡 실행)
- 대기자 승격 알림 이메일 발송 확인
- 이메일 템플릿 렌더링 확인
- 이메일 발송 로그 기록 확인
- HTML 이메일 스타일링 확인 (인라인 CSS)

## 목표
보안 강화 및 에러 핸들링을 개선합니다. 프로덕션 환경에 대비한 최종 점검을 수행합니다.

## 요구사항
1. 보안 강화:
   - **세션 보안**:
     - `session_start()` 전에 `session_regenerate_id(true)` 호출 (세션 고정 공격 방지)
     - 세션 쿠키 설정: `httponly=true`, `secure=true` (HTTPS 환경)
     - 세션 타임아웃: 30분 (마지막 활동 시간 기록)
   - **비밀번호 정책**:
     - 최소 8자, 대소문자/숫자/특수문자 포함 검증
     - 비밀번호 변경 기능 추가 (`change-password.php`)
   - **파일 업로드 보안**:
     - MIME 타입 검증 강화 (finfo_file 사용)
     - 파일명 랜덤화 (UUID 또는 해시)
     - 업로드 디렉토리 .htaccess 설정 (PHP 실행 금지)
   - **SQL Injection 재확인**:
     - 모든 쿼리에 prepared statements 사용 확인
     - 동적 쿼리 제거 (ORDER BY, LIMIT 등)
   - **XSS 방어**:
     - 모든 출력에 `htmlspecialchars()` 적용 확인
     - 사용자 입력 HTML 태그 제거 (strip_tags)
   - **CSRF 토큰 개선**:
     - 토큰 만료 시간 설정 (1시간)
     - 토큰 재생성 주기 (페이지 로드마다)

2. 에러 핸들링:
   - **에러 로깅 개선**:
     - `set_error_handler()`로 커스텀 에러 핸들러 등록
     - 에러 레벨별 로깅 (ERROR, WARNING, NOTICE)
     - 로그 파일 크기 제한 (10MB, 로테이션)
   - **예외 처리**:
     - try-catch 블록으로 DB 쿼리 감싸기
     - 사용자 친화적 에러 메시지 표시
     - 관리자에게 에러 알림 이메일 발송 (치명적 에러 시)
   - **404/500 에러 페이지**:
     - `404.php`: 페이지를 찾을 수 없음
     - `500.php`: 서버 내부 오류
     - .htaccess에서 ErrorDocument 설정

3. 성능 최적화:
   - **DB 쿼리 최적화**:
     - N+1 쿼리 제거 (JOIN 사용)
     - 인덱스 추가 확인 (workshops.start_datetime, bookings.user_id 등)
   - **캐싱 개선**:
     - 워크숍 목록 캐시 TTL 조정 (5분)
     - 통계 데이터 캐시 (1시간)
   - **이미지 최적화**:
     - 업로드 시 자동 리사이즈 (최대 1200x800)
     - WebP 변환 (GD 또는 Imagick)
   - **Gzip 압축**:
     - .htaccess에서 mod_deflate 설정

4. 테스트:
   - **단위 테스트** (간단한 함수 테스트):
     - `tests/test_helpers.php` 작성
     - `csrf_token()`, `escape()` 함수 테스트
   - **통합 테스트** (시나리오 기반):
     - 사용자 회원가입 -> 로그인 -> 예약 -> 출석 체크 전체 흐름
   - **보안 테스트**:
     - CSRF 토큰 없이 폼 제출 시 거부 확인
     - SQL Injection 시도 (예: `' OR '1'='1`) 차단 확인
     - XSS 시도 (예: `<script>alert('XSS')</script>`) 이스케이프 확인

5. 문서화:
   - `README.md` 작성:
     - 프로젝트 개요
     - 설치 방법 (`php -S localhost:8000`)
     - 기능 목록
     - 디렉토리 구조
     - 보안 고려사항
     - 라이선스
   - `SETUP.md` 작성:
     - 환경 요구사항 (PHP 8.3+, SQLite, GD)
     - 초기 설정 (DB 생성, 관리자 계정)
     - 크론잡 설정 (`cron/send-reminders.php`)

## 완료 조건
- 세션 보안 설정 확인 (httponly, secure 쿠키)
- 비밀번호 정책 검증 동작 확인
- 파일 업로드 보안 테스트 통과
- SQL Injection, XSS, CSRF 공격 차단 확인
- 에러 로깅 동작 확인 (error.log 파일)
- 404/500 에러 페이지 표시 확인
- DB 쿼리 성능 측정 (EXPLAIN 사용)
- 캐싱 동작 확인 (파일 생성 및 TTL)
- 이미지 리사이즈 및 WebP 변환 확인
- 테스트 스크립트 실행 성공
- README.md 및 SETUP.md 작성 완료

## 목표
최종 테스트 및 배포 준비를 완료합니다. 사용자 경험을 개선하고, 프로젝트를 마무리합니다.

## 요구사항
1. UI/UX 개선:
   - **반응형 디자인 완성**:
     - 모바일 (< 768px): 단일 컬럼 레이아웃
     - 태블릿 (768px ~ 1024px): 2컬럼 레이아웃
     - 데스크톱 (> 1024px): 3컬럼 레이아웃
     - 햄버거 메뉴 (모바일)
   - **로딩 상태 표시**:
     - AJAX 요청 시 스피너 표시
     - 버튼 비활성화 (중복 클릭 방지)
   - **사용자 피드백**:
     - Toast 알림 (성공/에러 메시지)
     - 폼 유효성 검사 실시간 피드백
   - **접근성 개선**:
     - ARIA 속성 추가 (role, aria-label 등)
     - 키보드 네비게이션 지원
     - 색상 대비 개선 (WCAG 2.1 AA 기준)

2. 추가 기능 구현:
   - **워크숍 리뷰 시스템**:
     - 워크숍 종료 후 리뷰 작성 가능
     - 별점 (1~5점), 텍스트 리뷰
     - 리뷰 목록 표시 (workshop.php)
   - **위시리스트 기능**:
     - 관심 워크숍 담기 버튼
     - 내 위시리스트 페이지 (`wishlist.php`)
   - **소셜 공유 기능**:
     - 워크숍 상세 페이지에 공유 버튼 (Facebook, Twitter, 카카오톡)
     - Open Graph 메타 태그 추가
   - **검색 자동완성**:
     - 워크숍 제목 검색 시 자동완성 제안 (AJAX)

3. 프로덕션 환경 설정:
   - **환경 변수 분리**:
     - `.env` 파일 생성 (DB 경로, 비밀키, SMTP 설정 등)
     - `includes/config.php` 작성 (환경변수 로드)
   - **디버그 모드 비활성화**:
     - `error_reporting(0)` 설정
     - 에러 메시지 숨김 (사용자에게 노출 금지)
   - **HTTPS 강제**:
     - .htaccess에서 HTTP -> HTTPS 리다이렉트
   - **보안 헤더 추가**:
     - X-Frame-Options: DENY
     - X-Content-Type-Options: nosniff
     - Content-Security-Policy 설정

4. 최종 테스트:
   - **사용자 시나리오 테스트**:
     - 시나리오 1: 신규 사용자 회원가입 -> 워크숍 검색 -> 예약 -> QR 코드 확인
     - 시나리오 2: 관리자 로그인 -> 워크숍 생성 -> 예약자 조회 -> QR 스캔 -> 출석 체크
     - 시나리오 3: 예약 취소 -> 대기자 자동 승격 -> 알림 이메일 확인
   - **브라우저 호환성 테스트**:
     - Chrome, Firefox, Safari, Edge 최신 버전
   - **성능 테스트**:
     - 페이지 로딩 시간 측정 (< 2초)
     - DB 쿼리 개수 최적화 (페이지당 < 10개)
   - **부하 테스트** (선택):
     - Apache Bench 또는 Siege로 동시 접속 테스트

5. 배포 가이드 작성:
   - `DEPLOYMENT.md` 작성:
     - 서버 요구사항 (Apache/Nginx, PHP 8.3, SQLite)
     - 파일 권한 설정 (uploads, cache, qrcodes 디렉토리 쓰기 권한)
     - .htaccess 설정 (URL 재작성, 보안 헤더)
     - 크론잡 등록 (`cron/send-reminders.php` 매일 오전 9시)
     - 백업 전략 (DB 파일, 업로드 이미지)

## 완료 조건
- 반응형 디자인 모든 디바이스에서 확인
- 로딩 상태 및 Toast 알림 동작 확인
- 접근성 테스트 통과 (키보드 네비게이션, ARIA)
- 워크숍 리뷰 시스템 동작 확인
- 위시리스트 기능 동작 확인
- 소셜 공유 버튼 동작 확인
- 검색 자동완성 동작 확인
- 환경 변수 분리 확인 (.env 파일)
- HTTPS 강제 리다이렉트 확인
- 보안 헤더 확인 (개발자 도구 Network 탭)
- 모든 사용자 시나리오 테스트 통과
- 브라우저 호환성 테스트 통과
- 성능 테스트 통과 (페이지 로딩 < 2초)
- DEPLOYMENT.md 작성 완료
- 프로젝트 GitHub 리포지토리에 푸시 완료