가격.kr — 커뮤니티 기반 한글 단축 URL 서비스

만두.가격.kr  → 만두 최저가 검색
가방.가격.kr  → 가방 최저가 검색
iphone.가격.kr → iPhone 최저가 검색

Issue 제안 → 자동 검증 → PR 생성 → 커뮤니티 투표 → 자동 병합 → KV 동기화
   ┌─────┐    ┌─────┐    ┌─────┐    ┌──────────┐    ┌──────┐    ┌────────┐
   │ 제안 │───→│ 검증 │───→│  PR  │───→│ 👍 투표  │───→│ 병합  │───→│ KV 반영│
   └─────┘    └─────┘    └─────┘    └──────────┘    └──────┘    └────────┘
   Issue 작성   블록리스트   자동 생성   3+ 찬성        24시간     Cloudflare
               비속어 필터              (변경 5+)      대기 후     자동 동기화
               자모 우회 탐지
               도메인 화이트리스트
               Safe Browsing

사용자 → 만두.가격.kr
         ↓
  Cloudflare Workers (와일드카드 DNS)
    → Host 헤더에서 서브도메인 추출
    → Punycode 디코딩 (xn--hu1b07h → 만두)
    → KV 조회 → 302 리다이렉트
    → (KV 실패 시) GitHub Raw Content 폴백
    → (키워드 미등록 시) Vercel 웹앱으로 안내

price.kr/
├── LICENSE               # MIT 라이선스
├── CODE_OF_CONDUCT.md    # 행동 강령
├── CONTRIBUTING.md       # 기여 가이드
├── SECURITY.md           # 보안 정책
├── CLAUDE.md             # Claude Code 설정
├── workers/              # Cloudflare Workers 리다이렉트 엔진
│   └── src/              #   subdomain.ts, fallback.ts, index.ts
├── web/                  # Next.js 15 App Router (Vercel)
│   ├── app/              #   검색 UI, [keyword] 페이지, 개인정보처리방침
│   ├── components/       #   SearchBar (자동완성, 초성 검색)
│   └── lib/              #   hangul.ts, keywords.ts
├── scripts/              # 공유 유틸리티
│   ├── hangul-path.ts    #   초성 추출, 키워드→파일 경로 계산
│   ├── validate-keyword.ts # 키워드 검증 (블록리스트, 비속어, 자모 우회 탐지)
│   ├── sync-kv.ts        #   JSON → Cloudflare KV 동기화
│   ├── seed-data.ts      #   TSV → 키워드 JSON 일괄 생성
│   └── generate-top1000-tsv.ts  # Top 1000 키워드 TSV 생성
├── data/                 # 키워드 데이터 (3단계 디렉토리 구조)
│   ├── {초성}/{첫글자}/{keyword}.json  # 한글 키워드
│   ├── _en/{keyword}.json              # 영문 키워드
│   ├── _num/{keyword}.json             # 숫자 시작 키워드
│   ├── blocklist.json        # 상표명 블록리스트
│   ├── whitelist.json        # 허용 도메인 목록
│   └── profanity-blocklist.json  # 비속어 블록리스트
├── .github/
│   ├── CODEOWNERS            # 코드 리뷰 규칙
│   ├── PULL_REQUEST_TEMPLATE.md  # PR 체크리스트
│   ├── ISSUE_TEMPLATE/       # Issue 양식 (제안/변경/삭제/버그/기능)
│   └── workflows/
│       ├── validate-issue.yml  # Issue → 키워드/URL 검증 → 자동 PR
│       ├── sync-kv.yml         # main push → KV 동기화
│       └── auto-merge.yml      # 커뮤니티 투표 → 자동 병합
└── docs/
    ├── PRD.md              # 제품 요구사항 정의서
    ├── OPERATIONS.md       # 운영 가이드
    ├── DEV_PROGRESS.md     # 개발 진행 상황
    ├── DEV_LOG.md          # 기술적 결정 기록
    ├── PLAN-top100-keywords.md  # 키워드 확장 계획
    └── superpowers/        # 설계 문서 및 구현 계획