diff --git a/tasks/BACKLOG.md b/tasks/BACKLOG.md index 508b63e..b9a2e0b 100644 --- a/tasks/BACKLOG.md +++ b/tasks/BACKLOG.md @@ -51,7 +51,6 @@ - [🔬 Адрес объекта в тексте отказа SpeechKit](items/speechkit-error-text-leak.md) — Текст отказа операции приходит от Yandex и уезжает в журнал и в колонку error_text: если он несёт URI объекта, из журнала снова собирается ссылка на чужую запись. - [🧹 Разобрать мелочи http-транспорта](items/http-transport-nits.md) — Маршруты зарегистрированы дважды, и переименование пути в main.go проходит проверки зелёным; обработчик пишет в журнал через стандартный log и дублирует запись, уже сделанную сервисом. - [🧹 Запретить обращаться к Bot API мимо клиента бота](items/bot-api-only-through-bot-client.md) — Чистка отказа от адреса с токеном живёт в клиенте; свой http.Client в транспорте вернёт утечку молча — правило noctx такую подмену не ловит, а класс уже стоил одного дефекта. -- [🧹 Переименовать образец конфига в config.example.toml](items/config-example-toml.md) — Конвенция называет config.dist.toml объявленным расхождением, но тут же пишет это имя как правило — документ противоречит сам себе, а образец расходится с конвенцией. - [🧹 Свести пять расхождений между документами канона](items/docs-consistency-2026-08-13.md) — Сверка 2026-08-13 нашла шесть мест, где два документа отвечают на один вопрос по-разному; одно сведено при повышении раскладки, а три из пяти оставшихся стоят в architecture.md, и по ним читатель строит решения о выкладке и о периметре. - [✨ Привязать запись к владельцу и отдавать только свои](items/record-ownership.md) — У задачи и файла нет владельца, поэтому знание UUID задачи и есть право её читать. - [✨ Свести приём и чтение записей к одному контракту для приложения](items/json-api-for-spa.md) — Сегодняшний API отвечает 404 на любую ошибку чтения и 500 на любую ошибку приёма: строить на нём экраны нечем. diff --git a/tasks/items/config-example-toml.md b/tasks/items/config-example-toml.md deleted file mode 100644 index 33b3f0d..0000000 --- a/tasks/items/config-example-toml.md +++ /dev/null @@ -1,45 +0,0 @@ -# 🧹 Переименовать образец конфига в config.example.toml - -- **Тип:** chore -- **Категория:** Очередь — Поднято наверх: шесть задач ниже правят конфиг и каждая допишет старое имя образца, удлиняя перечень мест переименования. -- **Зачем:** Конвенция называет config.dist.toml объявленным расхождением, но тут же пишет это имя как правило — документ противоречит сам себе, а образец расходится с конвенцией. - -Конвенция конфигурации взята из проекта jellybit и **сама называет сегодняшнее -имя расхождением**: `docs/conventions/config.md`, строка 7 — «образец называется -`config.dist.toml`, а не `config.example.toml`». Но строки 31 и 34 того же -документа пишут `config.dist.toml` как правило, с заголовком раздела и всем -прочим. Документ противоречит сам себе, и который из двух читать — не выводится. - -Задача закрывает расхождение в пользу конвенции: файл переименовывается, а -документ перестаёт спорить сам с собой. - -## Затрагивает - -- `config.dist.toml` в корне — переименование; -- `docs/conventions/config.md` — строка расхождения, заголовок раздела и все - упоминания имени; -- `CLAUDE.md`, раздел «Команды» — строка про то, что копировать; -- `README.md` — команда `cp` и абзац про недостающий ключ; -- `docs/review.md`, «Триггеры метки» — упоминание образца; -- `docs/conventions/README.md` — строка про самодокументируемый образец; -- `tasks/items/external-call-timeouts.md`, `telegram-account-link.md`, - `oidc-login.md` — разделы «Затрагивает» ссылаются на имя. - -## Критерии приёмки - -- Имени `config.dist.toml` в репозитории не осталось. Оракул — - `grep -rn 'config\.dist\.toml' . --exclude-dir=.git` пуст. -- Образец лежит под именем `config.example.toml` и по-прежнему не даёт - закоммитить реальный конфиг. Оракул — `git ls-files config.example.toml` - отдаёт файл, `git check-ignore config.toml` отдаёт `config.toml`. -- Конвенция больше не называет имя образца расхождением. Оракул — - `grep -n 'config\.example\.toml' docs/conventions/config.md` не находит строки, - противопоставляющей одно имя другому (сегодня это строка 7). -- Гейт зелёный: битых ссылок правка не оставила. Оракул — `task docs`. - -## Рамки - -Состав полей образца и его комментарии не пересматриваются — задача про имя и -про ссылки на него. Прорехи образца, помеченные в конвенции строками -«*Расхождение:*», остаются на месте. -