tarkov-data-overlay

tarkov-data-overlay es una capa de correcciones y adiciones de datos mantenida por la comunidad para la API de tarkov.dev. La motivación declarada es que las actualizaciones del juego pueden superar a las de los datos, por lo que el proyecto llena ese vacío de dos maneras: corrigiendo valores incorrectos, como los niveles de las tareas o los requisitos del mapa, y añadiendo tipos de datos que la API original no incluye, como las ediciones del juego. Uso La capa se publica como un archivo JSON y se obtiene desde la CDN de jsDelivr. Los consumidores la fusionan con las respuestas de tarkov.dev. El README aconseja fijar una etiqueta de versión inmutable o un commit para su uso en producción, ya que una URL de rama sigue el estado dinámico del repositorio; el resumen (digest) embebido puede detectar corrupción o datos obsoletos, pero no prueba la autenticidad de una respuesta de la CDN. Los detalles de integración se encuentran en una guía de integración, con documentos separados que cubren la disponibilidad de tareas y el seguimiento del estado de desbloqueo y un contrato de datos de contador; se hace referencia a un ayudante evaluateTaskProgression para contadores basados en el progreso verificado y resultados desconocidos explícitos. Monitor Hay un monitor alojado disponible, y el mismo monitor puede ejecutarse localmente mediante un script de npm. Es de solo lectura por defecto. Una acción local de "Update overlay" requiere la aceptación explícita con un token de reconstrucción, y las reconstrucciones siempre requieren un token no vacío pasado en un encabezado Authorization Bearer. El servidor se vincula al loopback por defecto; se recomienda vincularlo en otro lugar solo detrás de un proxy inverso o límite de red confiable. Cuando el HTTPS es terminado por un proxy confiable, un indicador separado habilita las reconstrucciones, y en ese modo, las cuotas de flujo de eventos por cliente utilizan la primera dirección X-Forwarded-For válida, por lo que el proxy debe sobrescribir ese encabezado. Las reconstrucciones se dirigen a la ruta de salida predeterminada de la capa; los objetivos de capa locales y HTTP(S) personalizados permanecen de solo lectura. Mantenimiento Un comando check-overrides compara todas las anulaciones con los datos actuales de la API e informa cuáles son aún necesarias, qué correcciones han sido solucionadas en la fuente original y pueden eliminarse, qué tareas desaparecieron de la API y las regresiones de calidad de los datos originales. La generación de informes es el comportamiento predeterminado; tres puertas de acceso opcionales controlan el comportamiento de falla, con códigos de salida distintos para comprobaciones de inconsistencia estrictas, datos obsoletos que la fuente original ahora suministra (la puerta ejecutada en CI) y regresiones de la fuente original. La puerta de la fuente original se excluye deliberadamente de la CI porque tales problemas se originan en los datos de tarkov.dev y no pueden solucionarse desde este repositorio. La validación local, la comprobación de tipos y las pruebas se ejecutan a través de scripts de npm independientes. Gobernanza y contribución Se proporcionan guías de contribución y triaje. El proyecto se describe a sí mismo como mantenido por la comunidad y basado en el mejor esfuerzo, requiere pruebas como enlaces a la wiki o capturas de pantalla para las correcciones, se presenta como un puente durante los vacíos de datos en lugar de un reemplazo de tarkov.dev, y mantiene un historial transparente a través de Git. Los términos de la licencia se encuentran en el archivo LICENSE del repositorio.