# 4tunetale TIER 콘텐츠 규격 2.0

주제와 아이템 이름으로 티어 페이지를 만드는 파일 규격입니다. TEST 규격은 바꾸지 않습니다. 이전 Swiss 점수 방식의 1.x TIER 파일과 자동 호환하지 않습니다.

## 사용하는 방법

1. `/tier/create/`에서 주제와 아이템 이름을 입력합니다. 한 줄에 하나, 10~1,024개입니다.
2. 사진·설명은 선택입니다. 미리보기에서 간단·중간·꼼꼼 모드를 확인합니다.
3. 파일 저장을 누르면 압축 사진을 포함한 `{id}.json` 하나가 내려받아집니다.
4. 파일 불러오기로 다른 브라우저에서도 다시 편집합니다.
5. 사이트 소스의 `content/tiers/`에 파일을 추가하고 빌드·배포하면 `/tier/{id}/` 페이지와 TIER 검색 목록에 자동 등록됩니다. 파일 저장만으로 라이브 사이트에 게시되지는 않습니다. GitHub에 넣는 경우에도 배포 연결이 있어야 실제 사이트가 갱신됩니다.

## GPT에 요청할 예시

“아래 4tunetale TIER 규격 2.0을 따라 [주제]의 아이템 [목록]으로 JSON 파일을 만들어줘. 검증되지 않은 역사·효능은 쓰지 말고, 모르는 설명은 빈 문자열로 둬. 사진이 없으면 image는 빈 문자열. 아이템 이름만으로도 플레이 가능하게 해줘.”

## JSON 구조

```json
{
  "schemaVersion": "2.0",
  "type": "tier",
  "engine": "tier-refinement-v1",
  "id": "cafe-menu",
  "title": "카페 메뉴, 내 취향은?",
  "summary": "가볍게 고르는 나의 카페 메뉴.",
  "category": "음식·음료",
  "tags": ["카페", "메뉴"],
  "items": [
    {
      "id": "americano",
      "name": "아메리카노",
      "image": "",
      "summary": "깔끔한 커피의 기본.",
      "descriptionParagraphs": ["부담 없이 곁들이기 좋은 커피 메뉴. 따뜻하게도, 차갑게도 즐겨요."],
      "wikiUrl": null
    }
  ]
}
```

위 구조 예시는 아이템 1개만 보여줍니다. 실제 저장·플레이에는 서로 다른 10~1,024개가 필요합니다.

## 검사 규칙

- 필수 필드는 위 구조와 같습니다. 선택 내용도 빈 문자열·빈 배열·null로 키를 남깁니다.
- 콘텐츠 id: 64자 이내 영문 소문자·숫자·하이픈. create, play는 예약 이름입니다. 기존 콘텐츠와 중복되면 빌드가 실패합니다. 기본 음료 콘텐츠의 drink-brands도 사용할 수 없습니다.
- 파일 이름은 id.json과 같아야 합니다. title 1~60자, summary 160자 이내, category 30자 이내입니다.
- tags: 최대 10개, 각각 20자 이내입니다.
- items: 10~1,024개. id와 name 중복 금지. 아이템 id는 영문·숫자·하이픈·밑줄 1~128자, name은 1~60자입니다.
- 아이템 summary: 100자 이내. 모바일 카드에는 25~45자를 권합니다.
- descriptionParagraphs: 최대 10문단, 각 1,000자 이내. 보통 150~300자, 2~3문장이 읽기 편합니다. 사실 확인이 필요한 내용은 출처를 먼저 확인합니다.
- wikiUrl: null 또는 실제 https 참고 주소입니다. 내용을 자동 수집하지 않습니다.
- 파일 전체: UTF-8 기준 20MB 이내입니다. 깨진 JSON·중복 이름·누락 필드·허용되지 않은 사진 주소를 불러오면 오류가 표시됩니다.
- 사진이 없어도 텍스트 카드로 모든 기능을 사용할 수 있습니다.

## 이미지 규격

- 권장: 320 × 320 WebP, 흰 배경, 개당 약 20~40KB, 최대 약 64KB.
- 제작 도구에 JPG·PNG·WebP(원본 10MB 이하, 4,000만 화소 이하)를 넣으면 브라우저에서 축소·압축합니다. 원본 메타데이터도 다시 그린 이미지에는 포함하지 않습니다.
- 파일에 사진을 함께 담을 때 image에는 data:image/webp;base64,... 또는 jpeg/png 데이터를 넣습니다. 데이터 주소는 90,000자 이내입니다.
- 아이템이 많으면 별도 이미지 파일을 `public/assets/tiers/{id}/`에 넣고 image에 `/assets/tiers/{id}/americano.webp`처럼 적습니다. 빌드가 파일 존재를 검사합니다.
- 외부 이미지 URL, SVG, 상위 폴더 이동 경로는 허용하지 않습니다. 사진은 사용 권한이 있는 것만 준비합니다.

## 플레이 규칙

모든 아이템을 균형 잡힌 3~4개 묶음으로 한 번씩 보여주고 최고·최저를 선택합니다. 최고는 상위, 최저는 하위, 나머지는 중간 묶음으로 나눕니다. 필요한 묶음만 2~4개씩 추가 비교합니다. 한 개만 남는 비교는 없습니다.

- 간단: 상위 묶음을 S/A로 나누고 중간 B·하위 C. 4단계.
- 중간: 상위 S/A, 중간 B, 하위 C/F. 5단계.
- 꼼꼼: 상위 S/A, 중간 B/C, 하위 D/F. 6단계.
- 추가 비교는 그룹 크기의 절반(내림)만 선택합니다. 하위 묶음에서는 덜 좋아하는 것을, 나머지에서는 더 좋아하는 것을 고릅니다.
- 화면 수: G=ceil(N/4), P=ceil(G/4), Q=ceil((N−2G)/4). 간단 G+P, 중간 G+2P, 꼼꼼 G+2P+Q.
- 10개: 4/5/6화면. 30개: 10/12/16화면. 1,024개: 320/384/512화면.
- 이 방식은 빠른 취향 분류입니다. 정확한 전체 순위를 보장하지 않으며, 대진에 따라 결과가 달라집니다. 같은 티어 안에서는 순위를 매기지 않습니다.
- 중간 완료 후 꼼꼼으로 이어가면 앞선 선택을 유지하고 중간 묶음만 추가 비교합니다.

## 결과 이미지와 저장

- 1080 × 1350 (4:5) JPG 한 장. 4가지 디자인. 브라우저에서 생성합니다.
- 48개 이하는 전체 아이템을 담습니다. 그보다 많으면 티어별 앞 6개와 실제 전체 개수를 담는 요약 이미지입니다. 앞 6개가 별도 상위 순위를 의미하지 않습니다. 전체 목록은 결과 화면에 모두 남습니다.
- 초안은 이 브라우저의 IndexedDB, 참여 기록은 이 브라우저의 localStorage에만 저장합니다. 미리보기의 참여 기록은 저장하지 않습니다.
- 콘텐츠 JSON은 로컬 파일로 저장하고, 결과 JPG는 별도로 저장합니다. 자동 서버 업로드·ZIP·캐러셀 기능은 없습니다.
