first jiwoos commit

mapping_overrides/README.md

@@ -0,0 +1,32 @@
+# Mapping Overrides
+
+이 폴더는 `네이버 야구 텍스트 -> 관리자 사이트 입력 라벨` 매핑을 사람이 직접 검토하고 수정하기 쉽게 정리한 참조용 폴더입니다.
+
+목적:
+- 자동입력 로직에서 쓰는 주요 매핑을 한 곳에 모아 보기 쉽게 관리
+- 새로운 예외 케이스가 생겼을 때 사용자가 직접 규칙을 추가
+- 코드 수정 전에 어떤 라벨이 어떤 의미인지 확인
+
+현재 상태:
+- 이 폴더의 파일들은 "수정/검토용 참조 데이터"입니다.
+- 아직 모든 스크립트가 이 파일을 직접 읽는 구조는 아닙니다.
+- 즉, 지금은 사람이 안전하게 확인/편집하기 위한 기준 문서 역할입니다.
+- 표준 스키마는 [`standard_schema.md`](./standard_schema.md)를 따른다.
+
+파일 설명:
+- `pitch_result_map.json`
+  - 투구 결과 텍스트 매핑
+- `batter_result_map.json`
+  - 타자 결과 타입/텍스트 매핑
+- `runner_event_map.json`
+  - 주루 이벤트 매핑
+- `review_item_map.json`
+  - 합의판정 항목/최종결과 매핑
+- `special_rules.md`
+  - 특수 예외 규칙 정리
+
+권장 사용법:
+1. 실제로 잘못 입력된 사례를 먼저 적습니다.
+2. 어떤 텍스트가 들어왔는지 확인합니다.
+3. 이 폴더의 JSON/문서에 원하는 매핑 규칙을 먼저 정리합니다.
+4. 그 다음 코드에 반영합니다.