av
eacaf76d5f
- четыре новые записи: проверить шаг migrations так же, как шаг сверки версий Go; свести шесть расхождений между документами канона; запретить обращаться к Bot API мимо клиента бота; разведка о шагах гейта, теряющих предмет - context-cancel-in-pipeline приведена к правде: дописан перечень сделанного попутно, критерий с оракулом «тест на трёх прерываниях подряд» разбит надвое — проверена была только его узкая половина
51 lines
4.0 KiB
Markdown
51 lines
4.0 KiB
Markdown
# 🧹 Запретить обращаться к Bot API мимо клиента бота
|
||
|
||
- **Тип:** chore
|
||
- **Категория:** Очередь — Класс уже дал утечку токена; сегодня его держат две проверки на сегодняшних местах, а не правило.
|
||
- **Зачем:** Чистка отказа от адреса с токеном живёт в клиенте; свой http.Client в транспорте вернёт утечку молча — правило noctx такую подмену не ловит, а класс уже стоил одного дефекта.
|
||
|
||
Токен бота стоит в пути каждого обращения к Bot API, а `http.Client` кладёт
|
||
адрес запроса в `*url.Error` целиком. Поэтому 2026-08-13 чистка перенесена на
|
||
границу клиента: `internal/adapter/telegram`, `NewBot` — свой `Do` разворачивает
|
||
отказ в первопричину, а подменённый логгер вычищает токен из строк самой
|
||
библиотеки. Случай записан в журнал дефектов
|
||
[review.md](../../docs/review.md), 2026-08-13.
|
||
|
||
Держится это на двух стыках, и оба обходятся одной строкой: скачивание записи
|
||
берёт клиента у бота (`c.bot.Client.Do`), а не общий, и бот заводится единой
|
||
точкой, а не `tgbotapi.NewBotAPI`. Проверки на оба стыка есть
|
||
(`internal/controller/tg/download_test.go`,
|
||
`internal/adapter/telegram/bot_test.go`), но они судят **сегодняшние** места:
|
||
новый файл в транспорте, заведший свой клиент, они не увидят.
|
||
|
||
Ступень по лестнице механизации — четвёртая: свойство о структуре, а не о
|
||
вызове, и выражается тест-сканером в `internal/archrules`.
|
||
|
||
## Затрагивает
|
||
|
||
- `internal/archrules` — новое правило-сканер и его перечень предметов;
|
||
- `internal/controller/tg` — как поднадзорный пакет;
|
||
- `internal/adapter/telegram` — как единственное законное место, где клиент
|
||
заводится;
|
||
- [go-linters.md](../../docs/conventions/go-linters.md) — строка в перечне
|
||
механизированного и снятие соответствующей прозы.
|
||
|
||
## Критерии приёмки
|
||
|
||
- Свой `http.Client`, `http.DefaultClient` или `tgbotapi.NewBotAPI` в
|
||
`internal/controller/tg` роняет проверку и называет файл. Оракул — мутация:
|
||
внести каждую из трёх форм по очереди, все три краснеют.
|
||
- Законное употребление в `internal/adapter/telegram` проверку не роняет.
|
||
Оракул — тот же прогон на нетронутом дереве, зелёный.
|
||
- Правило не молчит, потеряв предмет: переименованный или исчезнувший пакет
|
||
роняет проверку, а не проходит обходом по пустому перечню. Оракул — мутация с
|
||
переименованием каталога.
|
||
- Правило записано строкой в `go-linters.md`, и проза, которую оно заменило,
|
||
оттуда снята. Оракул — чтение записи.
|
||
|
||
## Рамки
|
||
|
||
Боевым токеном не запускаться: сканер читает исходники, живого бота ему не
|
||
нужно. Внутренний логгер библиотеки правилом не выражается — его сторожит
|
||
проверка `TestLibraryLoggerIsActuallyInstalled`, и это остаётся так.
|