feat: add card catalog and filters

README.md

@@ -1,5 +1,30 @@
 # Holodream Tools
 
+## Card master data
+
+Collect the current card-related master data and Korean, English, and Japanese text from the public HolodoriDB diff repositories:
+
+```bash
+npm run data:sync
+```
+
+The generated manifest, raw relational bundle, and card-by-card bundle are written to `data/holodoridb`. Card artwork, movies, and voices are intentionally excluded.
+
+### 카드 표시명 수동 수정
+
+특별 버전명이나 번역 이름은 `data/card-overrides.csv`에서 관리합니다.
+
+```csv
+cardId,versionName,displayName
+card-06002-5-uniq-0066-00,수영복,
+```
+
+- `cardId`: 수정할 카드의 고유 ID
+- `versionName`: 기본 이름 옆에 표시할 짧은 버전명
+- `displayName`: 기본 멤버 이름을 완전히 바꿀 때만 입력하며, 평소에는 비워 둡니다.
+
+수정 후 `npm run data:sync`를 실행하면 카드 목록에 반영됩니다. 이 파일은 원본 데이터를 다시 수집해도 덮어쓰지 않습니다.
+
 홀로드림스 덱 최적화와 스킬 로스 분석을 통합할 웹사이트의 개발 기반입니다. 현재 단계에는 게임 기능을 포함하지 않습니다.
 
 ## 구성