tarkov-data-overlay

tarkov-data-overlay는 tarkov.dev API를 위한 데이터 수정 및 추가 사항을 담은 커뮤니티 유지 관리 오버레이입니다. 게임 업데이트 속도가 데이터 업데이트 속도보다 빠를 수 있다는 점에 착안하여, 퀘스트 레벨이나 맵 요구 사항과 같은 잘못된 값을 수정하고 게임 에디션과 같이 업스트림 API에 없는 데이터 유형을 추가함으로써 그 간극을 메웁니다. 사용법 오버레이는 JSON 파일로 게시되며 jsDelivr CDN에서 가져옵니다. 사용자는 이를 tarkov.dev 응답과 병합하여 사용합니다. README에서는 브랜치 URL이 저장소의 최신 상태를 추적하므로, 프로덕션 환경에서는 불변의 릴리스 태그나 커밋을 고정하여 사용할 것을 권장합니다. 내장된 다이제스트를 통해 데이터 손상이나 오래된 데이터를 감지할 수 있지만, CDN 응답의 진위 여부를 증명하지는 않습니다. 통합 세부 사항은 통합 가이드에 있으며, 퀘스트 가용성 및 잠금 상태 추적, 카운터 데이터 계약에 관한 별도 문서가 제공됩니다. 검증된 진행도 기반 카운터와 명시적인 알 수 없음 결과를 위해 evaluateTaskProgression 헬퍼가 참조됩니다. 모니터 호스팅된 모니터를 사용할 수 있으며, 동일한 모니터를 npm 스크립트를 통해 로컬에서 실행할 수 있습니다. 기본적으로 읽기 전용입니다. 로컬 "Update overlay" 작업은 리빌드 토큰을 통한 명시적인 옵트인이 필요하며, 리빌드 시에는 항상 Authorization Bearer 헤더에 비어 있지 않은 토큰을 전달해야 합니다. 서버는 기본적으로 루프백에 바인딩되며, 신뢰할 수 있는 리버스 프록시나 네트워크 경계 뒤에서만 다른 곳에 바인딩하는 것이 권장됩니다. 신뢰할 수 있는 프록시에서 HTTPS가 종료되는 경우 별도의 플래그를 통해 리빌드를 활성화할 수 있으며, 이 모드에서 클라이언트별 이벤트 스트림 할당량은 첫 번째 유효한 X-Forwarded-For 주소를 사용하므로 프록시가 해당 헤더를 덮어써야 합니다. 리빌드는 기본 오버레이 출력 경로를 대상으로 하며, 사용자 정의 로컬 및 HTTP(S) 오버레이 대상은 읽기 전용으로 유지됩니다. 유지 관리 check-overrides 명령은 모든 오버라이드를 현재 API 데이터와 비교하여 여전히 필요한 항목, 업스트림에서 수정되어 제거 가능한 항목, API에서 사라진 퀘스트, 업스트림 데이터 품질 저하 항목을 보고합니다. 보고가 기본 설정이며, 세 가지 옵트인 게이트가 실패 동작을 제어합니다. 엄격한 불일치 검사, 업스트림에서 이제 제공하는 오래된 데이터(CI에서 실행되는 게이트), 업스트림 회귀에 대해 각각 별도의 종료 코드를 가집니다. 업스트림 게이트는 해당 문제가 tarkov.dev 데이터에서 발생하여 이 저장소에서 해결할 수 없으므로 의도적으로 CI에서 제외되었습니다. 로컬 검증, 타입 체크 및 테스트는 별도의 npm 스크립트를 통해 실행됩니다. 거버넌스 및 기여 기여 및 트리아지 가이드가 제공됩니다. 이 프로젝트는 커뮤니티 유지 관리 및 최선 노력(best-effort) 방식으로 운영되며, 수정 사항에 대해 위키 링크나 스크린샷과 같은 증거를 요구합니다. 또한 tarkov.dev의 대체제가 아닌 데이터 공백 기간 동안의 가교 역할을 지향하며, Git을 통해 투명한 이력을 유지합니다. 라이선스 약관은 저장소의 LICENSE 파일에 명시되어 있습니다.