> For the complete documentation index, see [llms.txt](https://docs.ipcheck.ing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipcheck.ing/developer/ru/contributing/reporting-issues.md).

# Сообщение о проблемах

Все ошибки и запросы на новые функции отправляются в [GitHub Issues](https://github.com/jason5ng32/MyIP/issues). В репозитории есть два шаблона — отчёт об ошибке и запрос на новую функцию — и выбор правильного экономит всем время на лишнюю переписку.

## Перед тем как подать

{% hint style="info" %}
Большинство сообщений о самостоятельных развёртываниях оказываются проблемами конфигурации, а не ошибками. Сначала проверьте их.
{% endhint %}

1. **Поиск существующих issue**, открытым и закрытым. Возможно, о вашей проблеме уже сообщили, на неё ответили или её уже исправили в `dev`.
2. **Прочитайте** [**FAQ**](/developer/ru/reference/faq.md)**.** В нём описаны распространённые проблемы развёртывания и конфигурации.
3. **Проверьте свою конфигурацию.** Требуется MaxMind — см. [Настройка MaxMind](/developer/ru/getting-started/maxmind-setup.md). Некоторые функции зависят от необязательных API-ключей; см. [Необязательные API-ключи](/developer/ru/configuration/optional-api-keys.md).
4. **Попробуйте последнюю версию.** Ошибка, возможно, уже устранена.

## Подача отчёта об ошибке

Используйте **Отчёт об ошибке** шаблон. Он помечен как `ошибка` автоматически. Шаблон запрашивает следующее.

### Окружение

* Операционная система
* Браузер, если применимо
* Версия Node
* Версия Vite
* Версия Vue 3
* Версия Docker, если применимо
* Способ развёртывания — Vercel, Docker или Node
* Переменные окружения, **с удалёнными всеми секретами**
* Любые другие релевантные версии ПО

{% hint style="danger" %}
Никогда не вставляйте API-ключи, токены или учётные данные MaxMind в issue. Замаскируйте их. Если вы уже раскрыли один из них, замените его.
{% endhint %}

### Описание и шаги воспроизведения

Чёткое описание ошибки, за которым следуют пронумерованные шаги для её воспроизведения. Шаги воспроизведения — самая полезная часть отчёта.

### Ожидаемое и фактическое поведение

Что вы ожидали, и что произошло на самом деле. Для всего визуального помогут скриншоты или короткая запись экрана.

### Логи терминала и консоли

Шаблон выделяет это как важное, и так оно и есть. Включите оба варианта, если они применимы:

* **Логи терминала** из бэкенда — сообщения об ошибках и трассировки стека.
* **Логи консоли браузера** для всего, что ломается во фронтенде.

<details>

<summary>Получение более подробных сведений из бэкенда</summary>

Бэкенд ведёт логирование через общий `pino` логгер. Повышайте уровень, чтобы собирать больше данных перед воспроизведением:

```bash
LOG_LEVEL=debug pnpm dev
```

См. [Логирование](/developer/ru/configuration/logging.md) для других параметров, включая `LOG_FORMAT` и `LOG_HTTP`.

</details>

### Необязательные дополнения

* **Дополнительный контекст** — ссылки на связанные issue, всё остальное, что имеет отношение.
* **Возможное решение** — если у вас уже есть идея исправления, опишите её. Если хотите написать его сами, скажите об этом и прочитайте [Как внести вклад](/developer/ru/contributing/how-to-contribute.md) сначала.

## Подача запроса на новую функцию

Используйте **Запрос на новую функцию** шаблон. Он помечен как `улучшение` автоматически, и он задаёт четыре вопроса:

| Поле                                           | Что писать                                                  |
| ---------------------------------------------- | ----------------------------------------------------------- |
| Это связано с проблемой?                       | Конкретная причина неудовлетворённости, стоящая за запросом |
| Опишите желаемое решение                       | Что должно происходить с точки зрения пользователя          |
| Опишите альтернативы, которые вы рассматривали | Другие подходы и почему они не подходят                     |
| Дополнительный контекст                        | Скриншоты, макеты, ссылки на существующие решения           |

Объясните пользу для пользователя, а не только реализацию. Запрос, который начинается с реальной проблемы, оценить гораздо проще, чем тот, который начинается с предлагаемого API.

{% hint style="info" %}
Планируете реализовать эту функцию сами? Всё равно откройте issue и дождитесь, пока сопровождающий подтвердит направление, прежде чем писать код. См. [Как внести вклад](/developer/ru/contributing/how-to-contribute.md).
{% endhint %}

## Вопросы безопасности отличаются

Не открывайте обычный отчёт об ошибке для уязвимости. Следуйте [Политике безопасности](/developer/ru/contributing/security-policy.md) вместо этого.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ipcheck.ing/developer/ru/contributing/reporting-issues.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.