В мониторинге: Как программно сформировать путь к изображению карты сервера, используя слаг игры и имя текущей карты?

При разработке систем мониторинга игровых серверов часто возникает задача динамически формировать путь к изображению карты (map image), которая в данный момент активна на сервере. Для этого используются два ключевых параметра: **слаг игры** (game slug) — уникальный строковый идентификатор игры в нижнем регистре (например, `csgo`, `rust`, `tf2`) — и **имя текущей карты** (map name), которое возвращает API или сам игровой сервер (например, `de_dust2`, `the_island`, `cp_badlands`).

## Общий подход к формированию пути

Путь к изображению карты, как правило, строится по шаблону:

/images/maps/{game_slug}/{map_name}.jpg

или в виде полного URL:

https://cdn.example.com/maps/{game_slug}/{map_name}.png

## Пример реализации на Python

python
def get_map_image_path(game_slug: str, map_name: str, base_url: str = «/images/maps») -> str:
game_slug = game_slug.lower().strip()
map_name = map_name.lower().strip()
return f»{base_url}/{game_slug}/{map_name}.jpg»

# Пример использования
path = get_map_image_path(«csgo», «de_dust2»)
print(path) # /images/maps/csgo/de_dust2.jpg

## Пример на JavaScript

javascript
function getMapImagePath(gameSlug, mapName, baseUrl = ‘/images/maps’) {
const slug = gameSlug.toLowerCase().trim();
const map = mapName.toLowerCase().trim();
return `${baseUrl}/${slug}/${map}.jpg`;
}

// Пример
const path = getMapImagePath(‘rust’, ‘the_island’);
console.log(path); // /images/maps/rust/the_island.jpg

## Важные нюансы

1. **Нормализация строк**: всегда приводите слаг и имя карты к нижнему регистру, убирайте лишние пробелы — это предотвращает ошибки при несовпадении регистра.
2. **Fallback-изображение**: если файл для конкретной карты не найден, предусмотрите изображение по умолчанию (`default.jpg`), чтобы не отображать битые ссылки.
3. **Расширение файла**: уточните, какой формат используется в вашем хранилище — `.jpg`, `.png` или `.webp`.
4. **Санитизация входных данных**: если имя карты приходит с внешнего сервера, проверяйте его на наличие недопустимых символов (`/`, `..`, пробелы), чтобы избежать path traversal уязвимостей.
5. **CDN и кэширование**: при использовании CDN добавляйте версионирование или хэш к URL для инвалидации кэша при обновлении изображений.

Такой подход позволяет масштабировать систему мониторинга на любое количество игр и карт без изменения логики отображения.