클로드 코드로 시스템 만들기
— 요구사항·문서부터 가드레일까지

블로그 시스템을 만들 거야. 다음을 docs/requirements.md 에 작성해줘.

1. 기능 요구사항 — 사용자/관리자 시나리오 단위로 목록화
2. 핵심 엔터티와 속성 정의
3. 엔터티 관계를 Mermaid erDiagram 으로 작성

지금은 문서만 만들고 코드는 작성하지 마.

```mermaid
erDiagram
    USER ||--o{ POST : writes
    USER ||--o{ COMMENT : writes
    POST ||--o{ COMMENT : has
    POST }o--o{ TAG : tagged

    USER {
      string id PK
      string email
      string name
      datetime createdAt
    }
    POST {
      string id PK
      string title
      string body
      string authorId FK
      datetime publishedAt
    }
```

# 화면: 글 목록 (PostList)

## 경로 `/posts`

## 구성 요소
| 영역 | 내용 | 데이터 출처 |
|------|------|------------|
| 헤더 | 검색 입력, 태그 필터 | - |
| 목록 | 카드(제목·요약·작성자·날짜) | `GET /api/posts` |
| 페이지네이션 | 이전/다음 | `?page`, `?size` |

## 동작
- 카드 클릭 → `/posts/:id` 이동
- 태그 클릭 → `?tag=` 필터 적용

## 상태
- 로딩 / 빈 목록 / 에러 각각의 UI 정의

paths:
  /api/posts:
    get:
      summary: 글 목록 조회
      parameters:
        - name: page
          in: query
          schema: { type: integer, default: 1 }
      responses:
        '200':
          description: 목록
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostList'

## API: GET /api/posts

| ID | 케이스 | 입력 | 기대 결과 |
|----|--------|------|-----------|
| TC-01 | 기본 목록 | page 없음 | 200, 최신순 10건 |
| TC-02 | 페이지네이션 | `?page=2` | 200, 11~20번째 |
| TC-03 | 태그 필터 | `?tag=js` | 200, 해당 태그만 |
| TC-04 | 잘못된 page | `?page=-1` | 400 검증 에러 |

## 인증: POST /api/login
| ID | 케이스 | 입력 | 기대 결과 |
|----|--------|------|-----------|
| TC-10 | 성공 | 올바른 자격 | 200 + 토큰 |
| TC-11 | 비번 오류 | 틀린 비번 | 401 |

# 프로젝트 지침

설계 문서는 docs/ 에 있다. 코드 작성 전 반드시 참고할 것.
- 요구사항·ER: `docs/requirements.md`
- 화면 정의서: `docs/screens/`
- API 명세: `docs/openapi.yaml`
- 테스트 명세: `docs/test-spec.md`

세부 규칙은 각 디렉토리의 CLAUDE.md 를 따른다.

# 백엔드 규칙

- DB 접근은 Prisma Client 로만. raw SQL 금지.
- 모든 입력은 zod 로 검증 후 처리.
- 응답 스키마는 `docs/openapi.yaml` 과 일치시킬 것.
- 새 엔드포인트는 `docs/test-spec.md` 케이스를 먼저 통과시킬 것.

import js from '@eslint/js';
import ts from 'typescript-eslint';

export default [
  js.configs.recommended,
  ...ts.configs.recommended,
  {
    rules: {
      'no-unused-vars': 'error',
      'no-console': 'warn',
      '@typescript-eslint/no-explicit-any': 'error',
    },
  },
];

$ npm install -D eslint @eslint/js typescript-eslint
$ npx eslint . # 작업 후 매번 실행 → 0 errors 가 완료 조건

docs/requirements.md 의 ER 다이어그램을 참고해서
prisma/schema.prisma 를 작성해줘.

- 관계(1:N, N:M)를 정확히 반영
- id 는 cuid, 타임스탬프 필드 포함
- 최신 Prisma 문법으로. use context7

model Post {
  id          String    @id @default(cuid())
  title       String
  body        String
  author      User      @relation(fields: [authorId], references: [id])
  authorId    String
  comments    Comment[]
  tags        Tag[]
  publishedAt DateTime?
  createdAt   DateTime  @default(now())
}