번역 문서 사용 통계와 출처 추가 가이드 (Step 2)

.gitignore

@@ -8,6 +8,8 @@ pnpm-debug.log*
 lerna-debug.log*
 
 node_modules
+__pycache__/
+*.pyc
 dist
 dist-ssr
 *.local

CONTRIBUTING.md

@@ -77,6 +77,10 @@ Pull Request를 제출하기 전에 다음 사항을 확인해주세요:
 - [ ] `npm run build` 가 성공합니다
 - [ ] 추가한 용어의 정의가 명확하고 정확합니다
 
+## 번역 문서 사용 통계에 기여하기
+
+용어 상세 페이지의 표기 출현 통계에 새 번역 문서 출처를 추가하려면 [사용 통계 문서](docs/usage-statistics/README.md)와 [출처 추가 절차](docs/usage-statistics/adding-source.md)를 참고해주세요. 사람과 에이전트가 동일한 집계·검증 기준을 따르도록 설계와 실행 절차를 함께 관리합니다.
+
 ## 로컬 개발 방법
 
 프로젝트를 로컬에서 실행하여 변경사항을 확인할 수 있습니다:

package.json

@@ -18,10 +18,13 @@
     "predev": "node scripts/sync-public-data.mjs",
     "dev": "vite",
     "prebuild": "node scripts/sync-public-data.mjs",
-    "build": "npm run validate:data && tsc -b && vite build",
+    "build": "npm run validate:data && npm run validate:usage && tsc -b && vite build",
     "lint": "eslint .",
     "audit:security": "npm audit --audit-level=moderate && npm audit signatures",
     "validate:data": "node scripts/validate-term-data.mjs",
+    "validate:usage": "node scripts/usage-statistics/validate-usage-data.mjs",
+    "test:usage": "python3 -m unittest discover -s tests -p 'test_*.py' && node --test tests/source-links.test.mjs tests/usage-communities.test.mjs tests/trends-embed.test.mjs && npm run validate:usage",
+    "update:usage": "python3 scripts/usage-statistics/update_usage_counts.py",
     "preview": "vite preview"
   },
   "dependencies": {