В чате разработки начался сущий кошмар, когда они увидели этот метод

Я видел однажды, как он убил прод… методом.

В Джоне Уике (2014) Киану Ривз убил троих карандашом, но только не методом /GET и не на проде.
У нас же «оружием» иногда становится плохо описанный метод, который может завалить проект ничуть не хуже🤯.

Какие есть подводные?

1. Неясные входные параметры
Аналитик не указал, какие поля обязательные.
На проде метод вызывают без нужного параметра → упали.

2. Неопределённые типы данных
Ожидали int, прилетел string → через некоторое время приходит баг.

3. Нет описания ошибок и кодов ответа
Метод возвращает какой-то ответ, но без описания.
В итоге каждый понимает его по-своему.

4. Логика описана не полностью
Запись не найдена, сервис вернул пустой ответ, превышен лимит и т. д.
На проде это превращается в зависший UI или кривые данные.

5. Нет ограничений по производительности
Не уточнили, что метод должен отдавать максимум 50 записей.
Фронт запросил все транзакции клиента (500 строк) → таймаут, нагрузка, сервер лёг.

📎 В общем, делюсь шаблоном, который использую сам. Может, кто-то найдёт для себя что-то новое.

А у вас как описывают методы в проектах?

IT АНАЛитика | Подписаться