📝 헤드리스 블로그 API 엔진 - RESTful 콘텐츠 관리 시스템

mkdir headless-blog-api-engine && cd headless-blog-api-engine

이 폴더에서 헤드리스 블로그 API 프로젝트를 시작합니다.

먼저 프로젝트 기본 구조와 SQLite 데이터베이스 스키마를 설정하세요.

**요구사항:**

1. 다음 디렉토리 구조를 생성하세요:
```
public/
  index.php
  uploads/
src/
  Controllers/
  Models/
  Middleware/
  Services/
  Database.php
cache/
logs/
database/
  schema.sql
config/
  config.php
README.md
```

2. `config/config.php` 파일에 다음 설정을 작성하세요:
   - JWT secret key (랜덤 문자열)
   - 데이터베이스 경로 (`database/blog.db`)
   - 업로드 디렉토리 경로
   - 캐시 TTL (3600초)
   - Rate Limit 설정 (IP당 분당 60회)

3. `database/schema.sql` 파일에 다음 테이블 스키마를 작성하세요:
   - **users**: id, username, password_hash, created_at
   - **posts**: id, user_id, title, slug, content, category_id, status(draft/published), view_count, created_at, updated_at, published_at
   - **categories**: id, name, slug, description
   - **tags**: id, name, slug
   - **post_tags**: post_id, tag_id (복합 기본키)
   - **post_revisions**: id, post_id, title, content, revised_at, revised_by
   - **media**: id, filename, filepath, mime_type, size, uploaded_at

   인덱스 추가:
   - posts 테이블: `INDEX idx_status_published (status, published_at)`
   - posts 테이블: `INDEX idx_category (category_id)`
   - post_tags 테이블: `INDEX idx_post (post_id)`, `INDEX idx_tag (tag_id)`

4. `src/Database.php` 클래스를 작성하세요:
   - PDO 싱글톤 패턴으로 SQLite 연결 관리
   - `getInstance()` 메서드로 PDO 객체 반환
   - 에러 모드를 `PDO::ERRMODE_EXCEPTION`으로 설정
   - `schema.sql` 파일을 읽어 테이블 자동 생성하는 `initDatabase()` 메서드 포함

5. `public/index.php`에 기본 라우터를 작성하세요:
   - `$_SERVER['REQUEST_URI']`와 `$_SERVER['REQUEST_METHOD']`로 라우팅
   - 간단한 라우트 매칭 함수 구현 (정규식 사용)
   - 404 응답 처리
   - JSON 응답 헬퍼 함수 (`jsonResponse($data, $statusCode)`)

6. README.md에 프로젝트 설명, 설치 방법, API 서버 실행 명령어를 작성하세요:
   ```bash
   php -S localhost:8000 -t public
   ```

모든 파일을 생성하고, `php -S localhost:8000 -t public` 명령으로 서버를 실행했을 때 `http://localhost:8000/api/health` 엔드포인트에서 `{"status": "ok"}` JSON 응답이 나오도록 구현하세요.

이제 JWT 인증 시스템을 구현하세요.

**요구사항:**

1. `src/Services/JWTService.php` 클래스를 작성하세요:
   - `generateToken($userId, $username)`: JWT 토큰 생성 (HS256)
     - 헤더: `{"alg": "HS256", "typ": "JWT"}`
     - 페이로드: `{"user_id": ..., "username": ..., "iat": ..., "exp": ...}` (만료 1시간)
     - 서명: `hash_hmac('sha256', $header.$payload, $secret)`
     - 최종 토큰: `base64_encode($header).".".base64_encode($payload).".".base64_encode($signature)`
   - `verifyToken($token)`: 토큰 검증 및 페이로드 반환
     - 토큰 분해 및 서명 검증
     - 만료 시간 확인
     - 유효하면 페이로드 배열 반환, 실패 시 false
   - `refreshToken($oldToken)`: 기존 토큰으로 새 토큰 발급 (만료 연장)

2. `src/Middleware/AuthMiddleware.php` 클래스를 작성하세요:
   - `authenticate()`: Authorization 헤더에서 Bearer 토큰 추출
   - JWTService로 토큰 검증
   - 유효하면 `$_SERVER['AUTH_USER']`에 사용자 정보 저장
   - 실패 시 401 Unauthorized JSON 응답

3. `src/Controllers/AuthController.php` 클래스를 작성하세요:
   - `login()`: POST /api/auth/login
     - JSON 요청 본문에서 username, password 받기
     - users 테이블에서 username 조회
     - `password_verify()`로 비밀번호 확인
     - 성공 시 JWT 토큰 반환: `{"token": "...", "expires_in": 3600}`
     - 실패 시 401 응답
   - `refresh()`: POST /api/auth/refresh
     - Authorization 헤더에서 기존 토큰 받기
     - 새 토큰 발급하여 반환

4. `public/index.php`에 인증 라우트를 추가하세요:
   - `POST /api/auth/login` → AuthController::login()
   - `POST /api/auth/refresh` → AuthController::refresh()

5. 테스트용 사용자를 데이터베이스에 추가하세요:
   - username: `admin`
   - password: `password123` (bcrypt 해시로 저장)
   - 초기 데이터 삽입 스크립트를 `database/seed.php`로 작성

서버를 재시작하고 다음 요청을 테스트하세요:
```bash
curl -X POST http://localhost:8000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "admin", "password": "password123"}'
```

JWT 토큰이 반환되어야 합니다.

게시글 CRUD API를 구현하세요.

**요구사항:**

1. `src/Models/Post.php` 클래스를 작성하세요:
   - `getAll($filters, $page, $perPage)`: 게시글 목록 조회
     - $filters: `["status" => "published", "category_id" => 1, "search" => "keyword"]`
     - WHERE 절 동적 생성 (Prepared Statement 사용)
     - LIMIT/OFFSET으로 페이지네이션
     - 카테고리명, 태그 목록 JOIN으로 함께 조회
     - 반환: `["data" => [...], "total" => 100, "page" => 1, "per_page" => 10]`
   - `getById($id)`: 게시글 상세 조회 (조회수 증가)
   - `create($data)`: 게시글 생성
     - slug 자동 생성 (title을 URL-safe 문자열로 변환)
     - created_at, updated_at 자동 설정
   - `update($id, $data)`: 게시글 수정
     - 수정 전 기존 데이터를 post_revisions에 저장
     - updated_at 갱신
   - `delete($id)`: 게시글 삭제 (실제 DELETE)
   - `attachTags($postId, $tagIds)`: 태그 연결 (post_tags 테이블)
   - `detachTags($postId)`: 기존 태그 제거

2. `src/Controllers/PostController.php` 클래스를 작성하세요:
   - `index()`: GET /api/posts
     - 쿼리 파라미터로 필터링: `?status=published&category_id=1&search=keyword&page=1&per_page=10`
     - Post::getAll() 호출하여 결과 반환
   - `show($id)`: GET /api/posts/{id}
     - Post::getById() 호출
     - 404 처리
   - `store()`: POST /api/posts (인증 필요)
     - JSON 요청 본문 파싱
     - 필수 필드 검증 (title, content)
     - Post::create() 호출
     - tags 배열 있으면 Post::attachTags() 호출
     - 201 Created 응답
   - `update($id)`: PUT /api/posts/{id} (인증 필요)
     - 권한 확인 (작성자 본인만 수정 가능)
     - Post::update() 호출
     - 태그 업데이트 (기존 태그 제거 후 새 태그 연결)
   - `destroy($id)`: DELETE /api/posts/{id} (인증 필요)
     - 권한 확인
     - Post::delete() 호출
     - 204 No Content 응답

3. `public/index.php`에 게시글 라우트를 추가하세요:
   - `GET /api/posts` → PostController::index()
   - `GET /api/posts/{id}` → PostController::show($id)
   - `POST /api/posts` → AuthMiddleware + PostController::store()
   - `PUT /api/posts/{id}` → AuthMiddleware + PostController::update($id)
   - `DELETE /api/posts/{id}` → AuthMiddleware + PostController::destroy($id)

4. 테스트용 게시글 3개를 데이터베이스에 추가하세요 (seed.php):
   - 각각 다른 카테고리, 여러 태그 연결

다음 요청을 테스트하세요:
```bash
# 게시글 목록
curl http://localhost:8000/api/posts

# 게시글 생성 (인증 필요)
curl -X POST http://localhost:8000/api/posts \
  -H "Authorization: Bearer {토큰}" \
  -H "Content-Type: application/json" \
  -d '{"title": "New Post", "content": "Content here", "category_id": 1, "tags": [1, 2]}'
```

카테고리/태그 API와 검색 기능을 구현하세요.

**요구사항:**

1. `src/Models/Category.php` 클래스를 작성하세요:
   - `getAll()`: 모든 카테고리 조회 (게시글 수 포함, COUNT 서브쿼리)
   - `getById($id)`: 카테고리 상세 조회
   - `create($data)`: 카테고리 생성 (인증 필요)
   - `update($id, $data)`: 카테고리 수정
   - `delete($id)`: 카테고리 삭제 (해당 카테고리의 게시글도 함께 삭제 또는 NULL 처리)

2. `src/Models/Tag.php` 클래스를 작성하세요:
   - `getAll()`: 모든 태그 조회 (사용 횟수 포함, COUNT 서브쿼리)
   - `getById($id)`: 태그 상세 조회
   - `create($data)`: 태그 생성
   - `delete($id)`: 태그 삭제 (post_tags에서 연결 제거)
   - `search($keyword)`: 태그명으로 검색 (LIKE)

3. `src/Controllers/CategoryController.php` 클래스를 작성하세요:
   - `index()`: GET /api/categories
   - `show($id)`: GET /api/categories/{id}
   - `store()`: POST /api/categories (인증 필요)
   - `update($id)`: PUT /api/categories/{id} (인증 필요)
   - `destroy($id)`: DELETE /api/categories/{id} (인증 필요)

4. `src/Controllers/TagController.php` 클래스를 작성하세요:
   - `index()`: GET /api/tags
   - `show($id)`: GET /api/tags/{id}
   - `store()`: POST /api/tags (인증 필요)
   - `destroy($id)`: DELETE /api/tags/{id} (인증 필요)

5. Post 모델에 검색 기능을 강화하세요:
   - `search($keyword)`: 제목/내용에서 전문 검색
     - `WHERE title LIKE ? OR content LIKE ?`
     - 또는 SQLite FULLTEXT INDEX 사용 (FTS5)
   - 검색 결과에 하이라이트 적용 (매칭된 키워드 강조)

6. `public/index.php`에 라우트를 추가하세요:
   - `GET /api/categories` → CategoryController::index()
   - `POST /api/categories` → AuthMiddleware + CategoryController::store()
   - `GET /api/tags` → TagController::index()
   - `POST /api/tags` → AuthMiddleware + TagController::store()
   - `GET /api/posts/search?q=keyword` → PostController::search()

7. 테스트용 카테고리 3개, 태그 5개를 추가하세요 (seed.php).

다음 요청을 테스트하세요:
```bash
# 카테고리 목록
curl http://localhost:8000/api/categories

# 태그 목록
curl http://localhost:8000/api/tags

# 게시글 검색
curl "http://localhost:8000/api/posts/search?q=PHP"
```

파일 업로드 & 미디어 라이브러리 API를 구현하세요.

**요구사항:**

1. `src/Services/FileUploadService.php` 클래스를 작성하세요:
   - `upload($file)`: 파일 업로드 처리
     - `$_FILES['file']` 검증 (UPLOAD_ERR_OK, MIME 타입, 크기 제한 5MB)
     - 허용 MIME 타입: image/jpeg, image/png, image/gif, image/webp
     - 파일명 중복 방지 (UUID 또는 타임스탬프 사용)
     - `public/uploads/` 디렉토리에 저장
     - 반환: `["filename" => ..., "filepath" => ..., "size" => ..., "mime_type" => ...]`
   - `generateThumbnail($filepath, $width, $height)`: GD 라이브러리로 썸네일 생성
     - 원본 비율 유지하며 리사이즈
     - `public/uploads/thumbnails/` 디렉토리에 저장
     - 반환: 썸네일 경로
   - `delete($filepath)`: 파일 삭제 (원본 + 썸네일)

2. `src/Models/Media.php` 클래스를 작성하세요:
   - `create($data)`: 미디어 정보 데이터베이스에 저장
   - `getAll($page, $perPage)`: 미디어 목록 조회 (페이지네이션)
   - `getById($id)`: 미디어 상세 조회
   - `delete($id)`: 미디어 삭제 (파일도 함께 삭제)

3. `src/Controllers/MediaController.php` 클래스를 작성하세요:
   - `index()`: GET /api/media
     - Media::getAll() 호출
     - 썸네일 URL 포함하여 반환
   - `upload()`: POST /api/media (인증 필요)
     - multipart/form-data로 파일 받기
     - FileUploadService::upload() 호출
     - 썸네일 생성 (300x300)
     - Media::create()로 DB에 저장
     - 201 Created 응답 (파일 URL 포함)
   - `show($id)`: GET /api/media/{id}
   - `destroy($id)`: DELETE /api/media/{id} (인증 필요)
     - FileUploadService::delete() 호출
     - Media::delete() 호출

4. `public/index.php`에 미디어 라우트를 추가하세요:
   - `GET /api/media` → MediaController::index()
   - `POST /api/media` → AuthMiddleware + MediaController::upload()
   - `GET /api/media/{id}` → MediaController::show($id)
   - `DELETE /api/media/{id}` → AuthMiddleware + MediaController::destroy($id)

5. Post 모델에 `featured_image_id` 필드를 추가하고, 게시글 생성/수정 시 대표 이미지를 연결할 수 있도록 수정하세요.

6. `public/uploads/` 디렉토리가 없으면 자동 생성하도록 처리하세요.

다음 요청을 테스트하세요:
```bash
# 이미지 업로드
curl -X POST http://localhost:8000/api/media \
  -H "Authorization: Bearer {토큰}" \
  -F "file=@test.jpg"

# 미디어 목록
curl http://localhost:8000/api/media
```

캐싱 시스템과 Rate Limiting을 구현하세요.

**요구사항:**

1. `src/Services/CacheService.php` 클래스를 작성하세요:
   - `get($key)`: 캐시 조회
     - `cache/{$key}.json` 파일 읽기
     - TTL 확인 (만료되면 null 반환)
   - `set($key, $value, $ttl)`: 캐시 저장
     - JSON으로 직렬화하여 파일에 저장
     - `["data" => $value, "expires_at" => time() + $ttl]` 형식
   - `delete($key)`: 캐시 삭제
   - `clear()`: 모든 캐시 파일 삭제

2. Post 모델에 캐싱 적용:
   - `getAll()`: 캐시 키 `posts_list_{$page}_{$filters_hash}` 사용
     - 캐시 있으면 반환, 없으면 DB 조회 후 캐시 저장 (TTL 3600초)
   - `getById($id)`: 캐시 키 `post_{$id}` 사용
   - `create()`, `update()`, `delete()`: 관련 캐시 무효화
     - `posts_list_*` 캐시 모두 삭제
     - `post_{$id}` 캐시 삭제

3. `src/Middleware/RateLimitMiddleware.php` 클래스를 작성하세요:
   - `check()`: IP 기반 요청 제한
     - `$_SERVER['REMOTE_ADDR']`로 IP 추출
     - `cache/rate_limit_{$ip}.json` 파일에 요청 기록 저장
     - 1분 동안 60회 초과 시 429 Too Many Requests 응답
     - `X-RateLimit-Remaining` 헤더에 남은 요청 수 표시
   - 매 요청마다 카운트 증가, 1분 후 리셋

4. `public/index.php`에 Rate Limit 미들웨어를 모든 API 요청에 적용하세요:
   - 라우팅 전에 RateLimitMiddleware::check() 호출

5. Cache-Control 헤더 설정:
   - 게시글 목록/상세 조회 시 `Cache-Control: public, max-age=3600` 헤더 추가
   - 인증이 필요한 엔드포인트는 `Cache-Control: no-store` 설정

6. 캐시 통계 API를 추가하세요:
   - `GET /api/cache/stats` (인증 필요)
     - 캐시 파일 수, 총 크기 반환
   - `DELETE /api/cache` (인증 필요)
     - 모든 캐시 삭제

다음 요청을 테스트하세요:
```bash
# 게시글 목록 조회 (캐시 생성)
curl -i http://localhost:8000/api/posts

# 동일 요청 (캐시에서 반환, 빠름)
curl -i http://localhost:8000/api/posts

# Rate Limit 테스트 (60회 이상 요청)
for i in {1..70}; do curl http://localhost:8000/api/posts; done
```

게시글 버전 관리와 통계 API를 구현하세요.

**요구사항:**

1. Post 모델에 버전 관리 기능을 추가하세요:
   - `update()` 메서드 수정:
     - 수정 전 기존 데이터를 `post_revisions` 테이블에 저장
     - `revised_by`에 현재 사용자 ID 저장
   - `getRevisions($postId)`: 게시글의 모든 버전 히스토리 조회
     - 최신순 정렬
   - `restoreRevision($postId, $revisionId)`: 특정 버전으로 복원
     - 해당 버전의 title, content를 현재 게시글에 덮어쓰기
     - 복원 시에도 새 버전 생성

2. `src/Controllers/PostController.php`에 버전 관리 엔드포인트 추가:
   - `revisions($postId)`: GET /api/posts/{id}/revisions (인증 필요)
     - Post::getRevisions() 호출
   - `restore($postId, $revisionId)`: POST /api/posts/{id}/revisions/{revisionId}/restore (인증 필요)
     - Post::restoreRevision() 호출

3. `src/Controllers/StatsController.php` 클래스를 작성하세요:
   - `overview()`: GET /api/stats
     - 총 게시글 수
     - 카테고리별 게시글 수 (GROUP BY)
     - 태그 사용 횟수 TOP 10
     - 최근 7일간 게시글 수 (날짜별 GROUP BY)
     - 총 조회수
   - `postStats($id)`: GET /api/posts/{id}/stats
     - 해당 게시글의 조회수, 수정 횟수, 최근 수정 시간

4. `public/index.php`에 라우트를 추가하세요:
   - `GET /api/posts/{id}/revisions` → PostController::revisions($id)
   - `POST /api/posts/{id}/revisions/{revisionId}/restore` → AuthMiddleware + PostController::restore($id, $revisionId)
   - `GET /api/stats` → StatsController::overview()
   - `GET /api/posts/{id}/stats` → StatsController::postStats($id)

5. 통계 데이터도 캐싱 적용:
   - 캐시 키 `stats_overview` (TTL 1800초)
   - 게시글 생성/수정/삭제 시 캐시 무효화

다음 요청을 테스트하세요:
```bash
# 게시글 수정 (버전 자동 저장)
curl -X PUT http://localhost:8000/api/posts/1 \
  -H "Authorization: Bearer {토큰}" \
  -H "Content-Type: application/json" \
  -d '{"title": "Updated Title", "content": "Updated content"}'

# 버전 히스토리 조회
curl -H "Authorization: Bearer {토큰}" \
  http://localhost:8000/api/posts/1/revisions

# 통계 조회
curl http://localhost:8000/api/stats
```

에러 핸들링, 로깅, CORS 설정을 강화하세요.

**요구사항:**

1. `src/Exceptions/` 디렉토리를 생성하고 커스텀 예외 클래스를 작성하세요:
   - `ApiException.php`: 기본 API 예외 클래스
     - 프로퍼티: `$statusCode`, `$message`, `$errors`
     - `toJson()`: RFC 7807 Problem Details 형식으로 반환
       ```json
       {
         "type": "https://example.com/errors/not-found",
         "title": "Resource Not Found",
         "status": 404,
         "detail": "Post with ID 999 does not exist",
         "instance": "/api/posts/999"
       }
       ```
   - `ValidationException.php`: 입력 검증 실패 (422)
   - `UnauthorizedException.php`: 인증 실패 (401)
   - `ForbiddenException.php`: 권한 없음 (403)
   - `NotFoundException.php`: 리소스 없음 (404)

2. `src/Services/LogService.php` 클래스를 작성하세요:
   - `error($message, $context)`: 에러 로그 기록
     - `logs/error.log` 파일에 추가
     - 형식: `[2024-01-15 10:30:00] ERROR: {$message} | Context: {json_encode($context)}`
   - `info($message)`: 정보 로그 기록
   - `request($method, $uri, $statusCode, $duration)`: API 요청 로그
     - `logs/access.log` 파일에 추가
     - 형식: `[2024-01-15 10:30:00] {$method} {$uri} - {$statusCode} ({$duration}ms)`

3. `public/index.php`에 전역 에러 핸들러를 추가하세요:
   - `set_exception_handler(function($e) { ... })`
     - ApiException이면 해당 상태 코드와 메시지로 JSON 응답
     - 기타 예외는 500 Internal Server Error
     - LogService::error()로 에러 로그 기록
   - 모든 API 요청의 시작/종료 시간을 측정하여 LogService::request() 호출

4. CORS 설정:
   - `src/Middleware/CorsMiddleware.php` 클래스 작성
     - `handle()`: CORS 헤더 설정
       - `Access-Control-Allow-Origin: *` (또는 특정 도메인)
       - `Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS`
       - `Access-Control-Allow-Headers: Content-Type, Authorization`
       - `Access-Control-Max-Age: 86400`
     - OPTIONS 요청 시 204 No Content 응답
   - `public/index.php`에서 모든 요청 전에 CorsMiddleware::handle() 호출

5. 입력 검증 헬퍼 함수 추가:
   - `src/Helpers/Validator.php` 클래스 작성
     - `validate($data, $rules)`: 규칙 기반 검증
       - 규칙 예: `["title" => "required|max:200", "email" => "required|email"]`
       - 검증 실패 시 ValidationException 던지기

6. 모든 컨트롤러에서 입력 검증 적용:
   - PostController::store(), update()에서 Validator::validate() 사용
   - 필수 필드, 길이 제한, 타입 검증

다음 요청을 테스트하세요:
```bash
# 잘못된 요청 (검증 실패)
curl -X POST http://localhost:8000/api/posts \
  -H "Authorization: Bearer {토큰}" \
  -H "Content-Type: application/json" \
  -d '{"title": ""}'

# 존재하지 않는 게시글 조회
curl http://localhost:8000/api/posts/99999
```

`logs/error.log`와 `logs/access.log` 파일에 로그가 기록되는지 확인하세요.

API 문서화 (OpenAPI Spec)와 Webhook 기능을 구현하세요.

**요구사항:**

1. `src/Services/OpenApiService.php` 클래스를 작성하세요:
   - `generate()`: OpenAPI 3.0 스펙 JSON 생성
     - 기본 정보: title, version, description
     - 서버 URL: `http://localhost:8000`
     - 모든 엔드포인트 정의:
       - 경로, HTTP 메서드, 파라미터, 요청/응답 스키마
       - 인증 필요 여부 (Bearer Token)
     - 예시 응답 포함
   - 반환: OpenAPI JSON 객체

2. `src/Controllers/DocsController.php` 클래스를 작성하세요:
   - `spec()`: GET /api/docs
     - OpenApiService::generate() 호출하여 JSON 반환
   - `ui()`: GET /api/docs/ui
     - Swagger UI HTML 페이지 반환
     - CDN에서 Swagger UI 로드하여 `/api/docs` 스펙 표시

3. `public/index.php`에 문서 라우트를 추가하세요:
   - `GET /api/docs` → DocsController::spec()
   - `GET /api/docs/ui` → DocsController::ui()

4. Webhook 기능 구현:
   - `src/Services/WebhookService.php` 클래스 작성
     - `send($event, $data)`: 외부 URL로 POST 요청 전송
       - `file_get_contents()` 또는 `curl`로 HTTP 요청
       - 요청 본문: `{"event": "post.published", "data": {...}}`
       - 타임아웃 5초 설정
       - 실패 시 LogService::error() 기록
   - Webhook URL은 config.php에 설정

5. Post 모델에 Webhook 트리거 추가:
   - `create()`: 게시글 생성 시 `post.created` 이벤트 전송
   - `update()`: 게시글 수정 시 `post.updated` 이벤트 전송
   - `delete()`: 게시글 삭제 시 `post.deleted` 이벤트 전송
   - status가 'published'로 변경될 때 `post.published` 이벤트 전송

6. Webhook 설정 API 추가:
   - `GET /api/webhooks` (인증 필요): 등록된 Webhook URL 목록 조회
   - `POST /api/webhooks` (인증 필요): 새 Webhook URL 등록
   - `DELETE /api/webhooks/{id}` (인증 필요): Webhook 삭제

7. 테스트용 Webhook 수신 서버를 별도 포트(8001)에서 실행:
   - `test/webhook-receiver.php` 파일 생성
   - 모든 POST 요청을 받아 로그에 기록

다음 요청을 테스트하세요:
```bash
# API 문서 조회
curl http://localhost:8000/api/docs

# Swagger UI 열기
open http://localhost:8000/api/docs/ui

# Webhook 등록
curl -X POST http://localhost:8000/api/webhooks \
  -H "Authorization: Bearer {토큰}" \
  -H "Content-Type: application/json" \
  -d '{"url": "http://localhost:8001/webhook"}'

# 게시글 생성 (Webhook 트리거)
curl -X POST http://localhost:8000/api/posts \
  -H "Authorization: Bearer {토큰}" \
  -H "Content-Type: application/json" \
  -d '{"title": "Test", "content": "Content", "status": "published"}'
```

Webhook 수신 서버 로그에서 이벤트가 기록되는지 확인하세요.

성능 최적화, 보안 강화, 테스트 코드를 추가하세요.

**요구사항:**

1. 성능 최적화:
   - **데이터베이스 인덱스 추가**:
     - posts 테이블: `CREATE INDEX idx_title_search ON posts(title)`
     - posts 테이블: `CREATE INDEX idx_created_at ON posts(created_at DESC)`
   - **N+1 쿼리 방지**:
     - Post::getAll()에서 카테고리, 태그를 JOIN으로 한 번에 조회
   - **페이지네이션 최적화**:
     - OFFSET 대신 커서 기반 페이지네이션 옵션 추가 (`?cursor=last_id`)
   - **캐시 워밍**:
     - `src/Commands/WarmCache.php` 스크립트 작성
     - 모든 게시글 목록/상세를 미리 캐싱

2. 보안 강화:
   - **CSRF 방어**:
     - `src/Middleware/CsrfMiddleware.php` 클래스 작성
     - POST/PUT/DELETE 요청 시 `X-CSRF-Token` 헤더 검증
     - 토큰은 세션에 저장, `/api/csrf-token` 엔드포인트에서 발급
   - **SQL Injection 방어 확인**:
     - 모든 쿼리가 Prepared Statement 사용하는지 검증
   - **XSS 방어**:
     - 모든 출력에 `htmlspecialchars()` 적용 확인
   - **비밀번호 보안**:
     - bcrypt 해시 사용 확인 (cost 12 이상)
   - **파일 업로드 보안**:
     - MIME 타입 검증 강화 (확장자와 실제 타입 비교)
     - 업로드 디렉토리 실행 권한 제거

3. 테스트 코드 작성:
   - `tests/` 디렉토리 생성
   - `tests/ApiTest.php` 파일 작성 (PHPUnit 없이 간단한 테스트 함수)
     - `testPostCreation()`: 게시글 생성 API 테스트
     - `testPostUpdate()`: 게시글 수정 API 테스트
     - `testAuthentication()`: JWT 인증 테스트
     - `testRateLimit()`: Rate Limit 테스트
     - `testCaching()`: 캐시 작동 테스트
   - 각 테스트 함수는 API 요청을 보내고 응답 검증
   - `php tests/ApiTest.php` 명령으로 실행

4. 헬스 체크 API 강화:
   - `GET /api/health` 엔드포인트 수정
     - 데이터베이스 연결 상태 확인
     - 캐시 디렉토리 쓰기 권한 확인
     - 업로드 디렉토리 쓰기 권한 확인
     - 반환: `{"status": "ok", "database": "connected", "cache": "writable", "uploads": "writable"}`

5. README.md 업데이트:
   - API 엔드포인트 전체 목록 추가
   - 인증 방법 설명
   - 예제 요청/응답
   - 성능 최적화 팁
   - 보안 체크리스트

6. 환경 변수 설정:
   - `.env.example` 파일 생성
   - `JWT_SECRET`, `DB_PATH`, `UPLOAD_DIR`, `WEBHOOK_URL` 등 설정
   - `config/config.php`에서 환경 변수 로드

다음 명령으로 테스트를 실행하세요:
```bash
# 테스트 실행
php tests/ApiTest.php

# 캐시 워밍
php src/Commands/WarmCache.php

# 헬스 체크
curl http://localhost:8000/api/health
```

모든 테스트가 통과하고, 헬스 체크에서 `status: ok`가 반환되는지 확인하세요.