Вредные советы для разработчиков

Вредные советы для разработчиков: как создать хуёвый проект и гордиться им

Next.js для статичного сайта, GraphQL ради двадцати запросов, Kafka для трёх пользователей и собственный фреймворк поверх чужого. Более 20 вредных советов о том, как превратить простое приложение в архитектурный кошмар, потратить побольше денег и убедить всех, что именно так выглядит современная разработка.

Превью

Предисловие

Эта статья предназначена для разработчиков, которые хотят создавать по-настоящему современные проекты, но не желают тратить время на документацию, чужой опыт и здравый смысл.

Следуйте нашим советам (нет): выбирайте самые модные технологии, усложняйте простые задачи и героически решайте проблемы, которые сами же создали. Совсем скоро пользователи перестанут возвращаться, серверы — справляться с нагрузкой, а коллеги — отвечать на ваши сообщения.

Не позволяйте коллегам, дизайнерам и тем более пользователям вмешиваться в вашу работу. Они могут предложить что-нибудь упростить, убрать лишнее или, чего доброго, сделать удобно.

Помните: хороший разработчик не должен идти на поводу у людей, которые ничего не понимают в программировании. Зато вы сможете с гордостью сказать, что построили современную, масштабируемую систему.

А то, что она никому нахуй не нужна, — уже проблемы пользователей.


Первый совет

Если хочешь программистом
Стать серьёзным и большим,
Не читай документаций,
Не пытайся код понять.

Попроси у нейросетки
Всё за вечер написать,
А когда она сломает
То, что сделала с утра,

Попроси её исправить,
И ещё раз переделать.
Хорошо работать вместе:
Ты ей ставишь все задачи,
А она тебе — другие.

Иллюстрация


Совет 2

Если фирме нужен сайт
С фотографией директора,
Кнопкой входа и оплатой,
Выбирай ты Next.js.

Пусть и фронт твой, и бэкенд
Будут жить в одной коробке,
Чтоб случайно не пришлось
Разделять свои заботы.

Если что-нибудь сломалось
И не видно, где причина,
Это даже очень кстати:
Всё сломалось — всё понятно.


Совет 3

Если сайт у вас статичный,
Не спешите делать файлы,
Чтобы Nginx их мог спокойно
Посетителям отдать.

Запустите целый сервер,
В нём отдельный Node.js,
Чтобы надпись «О компании»
Появлялась лишь тогда,

Когда сервер не чихает,
Не устал и не завис.
Посетитель сразу видит:
Здесь серьёзные машины
Охраняют три абзаца.

Иллюстрация


Совет 4

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

Можно выбрать только то,
Что действительно вам нужно.
Выбирай же все поля,
Все объекты, все их связи,

И повторно двадцать раз
Всё у сервера спроси.
Если сервер вдруг устанет,
Объясни ему спокойно:
Ты тут экономишь трафик,
Он обязан потерпеть.


Совет 5

Если вдруг в вашем канбане
Десять разных есть колонок,
Не просите их у сервера
Все одновременно.

Пусть за каждою колонкой
Ходит свой запрос отдельный,
А за каждою задачей
Посылай ещё один.

И когда придёт десятый,
Первый будет устаревший.
Это очень хорошо:
Пользователь сможет сразу
Посмотреть и на прошедшее,
И немножко в будущее.

Иллюстрация


Совет 6

Если добрый ваш дизайнер
Нарисует вам страницу,
Не пытайтесь повторить
Его прекрасные задумки.

Есть уже ведь компоненты,
Их поставишь — сайт готов.
Пусть он станет так похожим
На десяток прочих сайтов,

Что никто уже не вспомнит,
Для кого его писали.
Зато кнопки все на месте,
И 5 дней убил на стили.

Иллюстрация


Совет 7

Если сотня платежей есть,
Пусть таблица аккуратно
Выведет сто ровных строчек
На странице у клиента.

Но не смейте вместе с ними
Передать готовых данных.
Пусть строка сама отдельно
Всё о платеже узнает.

Сто запросов отправляйте,
А потом ещё сто новых,
Чтобы каждая из строчек
Всё сама в себе считала.

Если серверу не нравится,
Пусть научится дружить
С независимыми строчками.


Совет 8

Если кто-то на ваш лендинг
Посмотреть пришёл тарифы,
Не спешите сразу цены
Перед ним изображать.

Пусть шесть карточек отдельно
Спросят сервер, кто пришёл.
И на каждый из запросов
Сервер скажет: «Я не знаю».

Если гость не регистрировался,
Пусть получит шесть отказов.
Так надёжней: вдруг на пятом
Сервер вспомнит, кто пришёл?

Иллюстрация


Совет 9

Чтобы помнить, кто твой юзер,
Накати в проект Redux.
Рядом поселите Zustand,
Следом Jotai пригласите.

И TanStack Query поставьте,
Чтобы было веселей.
Пусть все четверо запомнят
Имя одного балбеса.

Первый помнит, кто вошёл,
А второй — кто вышел.
Третий помнит прошлый вторник,
А четвёртый снова спросит.

Если кто-нибудь захочет
Всё же имя то узнать,
Пусть сначала все четыре
Меж собою договорятся.


Совет 10

Если в коде вдруг осталось
Место без приставки use,
Это место непременно
Следует заполнить хуком.

Пусть useQuery носит воду,
useCache её хранит,
А useEffect ведро уронит,
Чтоб useQuery снова бегал.

Чтобы реже бегать к крану,
Кэш на целую секунду
Обязательно устройте.
За секунду он успеет
Отдохнуть перед работой.

Иллюстрация


Совет 11

Если нужно с сервера
Взять один кусок JSON-а,
Не берите просто fetch,
Он доступен слишком быстро.

Позовите лучше Axios,
Сделайте над ним обёртку,
А над нею — ещё две,
Чтобы было всё надёжно.

Пусть для получения списка
Из трёх маленьких объектов
Вам потребуется целый
Штат почтовых голубей.

И пускай они летают,
Раз уж вы их завели.


Совет 12

Если база может быстро
Отыскать десяток строчек,
Не давайте ей возможность
Всё это самой искать.

Подключайте лучше Prisma
Или TypeORM солидный.
Если сложный вдруг запрос,
Не пишите SQL.

Загрузите миллион,
А потом уж на бэкенде
Отфильтруйте всё руками.
Если память переполнится,
Значит, кто-то очень жадный
Пожалел оперативки.
Это ведь уже highload.

Иллюстрация


Совет 13

Если в вашей базе данных
Больше тридцати колонок,
Сокращайте до восьми,
Остальное в JSONB пряча.

Там и суммы, там и даты,
И кому кто что-то должен,
И когда кому платить,
И откуда всё взялось.

Индексов не создавайте,
Не придумывайте связей.
Пусть для поиска копейки
База всё переберёт.

Ведь чем дольше ждёт клиент,
Тем ценнее результат.


Совет 14

Если в базе есть колонка,
Что сегодня не пригодна,
Не меняйте ей название,
Не держите про запас.

Смело удаляйте сразу,
И без права возвращенья.
Если завтра старый сервер
Станет требовать пропажу,

Объясните, что нельзя
Постоянно жить вчерашним.
А откатывать обратно
Ничего уже не нужно:

Раз дороги больше нет,
Значит, только путь вперёд.

Иллюстрация


Совет 15

Если сайт умеет просто
Узнавать своих клиентов,
В cookie сессию не храните,
Это слишком уж легко.

Лучше дайте JWT,
И ещё один для смены,
И устройте обновление,
И ротацию ключей.

В localStorage положите
Самый главный свой секрет,
Чтоб случайно посторонний
Не остался без вниманья.

А секрет коль украдут,
Не волнуйтесь понапрасну:
Раз его смогли прочесть,
Значит, всё у вас в порядке.


Совет 16

Если бизнес состоит ваш
Из директора и кнопки,
Не пытайтесь их держать
В том же самом приложенье.

Нужно восемь микросервисов,
Точно нужен брокер Kafka,
Чтобы смена username-а
Побывала на экскурсии

Сквозь контейнеров десяток,
Через очередь и шлюз.
И когда вернётся имя,
Объявите всем с порога:

«У нас архитектура,
Как у Netflix.
Только без Netflix».

Иллюстрация


Совет 17

Если вам чужой фреймворк
Кажется вдруг неудобным,
Не читайте его доки,
Не ищите, что не так.

Напишите сверху новый,
Свою собственную крышу,
А над крышей — ещё крышу,
Чтобы точно не промок.

И когда простой маршрут
Вы добавить захотите,
Нужно будет восемь крыш
Разобрать и сложить снова.

Зато входа в это здание
Не найдёт уже никто,
Кроме вас. И то случайно.

Иллюстрация


Совет 18

Если надо на экране
Показать число и дату,
Не бери HTTP —
Слишком просто получается.

Проводите вы WebSocket
К каждой кнопке и картинке.
Пусть по проводу узнают
Даже цвет пустой страницы.

Если связь оборвалась,
Пусть и дата пропадёт.
Без прямой живой беседы
Календарь не существует.

А на все вопросы смело
Говорите: «Так быстрее!
Мы зато соединение
Каждый раз не открываем».


Совет 19

Всякий раз, когда клиенту
Что-то нужно от бэкенда,
Отправляйте POST /api,
Внутрь кладите слово action.

Если всё прошло успешно,
Отвечайте кодом 200.
Если всё сгорело тоже,
Отвечайте тоже 200.

Если денег не хватило,
Если кто-то вдруг не найден,
Если база отключилась,
Всё равно ответьте 200.

Пусть клиент отдельный, умный,
По секретному JSON
Разбирается, что плохо,
А что всё-таки окей.

Иллюстрация


Совет 20

Если тысячу картинок
Надо быстро обработать,
Очередь здесь не нужна,
Пусть страдает HTTP.

Крутится пусть полчаса
Скромный круг над кнопкой «Ждать».
Если Nginx потеряет
Веру в долгую работу,

Надо поднимать таймаут.
И ещё чуть-чуть, на всякий.
А если клиент устал,
и вышел с сайта загрустив,
Ничего, зато теперь
Можно всё начать сначала.


Совет 21

Если нужен Excel людям
На сто тысяч платежей,
Пусть сервер вам не собирает
Никаких таких отчётов.

Загружайте по страничке
Платежи все прямо в браузер,
И прямо там же склейте их
В ту красивую таблицу.

Если вдруг закроют вкладку,
Не ругайте человека:
Он ещё раз двести сходит
К серверу за тем же самым.

Так полезно иногда
Повторенье - мать ученья.

Иллюстрация


Совет 22

Если снимков 6 гигов
Нужно где-нибудь оставить,
Не ищите вы хранилищ,
Не тревожьте simple storage.

Закодируйте всё в base,
И в таблицу положите.
А когда начальник спросит:
«Почему бэкап так вырос?»,

Вы ответьте: «В нашей базе
Появилось много лиц».
Ведь теперь она не только
База данных строк и чисел.
Но теперь ещё в добавок,
И семейный фотоальбом.


Совет 23

Если вдруг клиент решил
Купить подписку на три месяца,
Первым делом деньги списывайте,
А потом заказ создайте.

После выдайте подписку,
Если хватит вам терпения.
Если что-то не сработало,
Не волнуйтесь понапрасну:

Деньги-то уже списались,
Значит, первая задача
Выполнена безупречно.

А когда придёт два раза
Весть об этой же оплате,
Обработайте два раза.

Не ваши ведь списали деньги,
Что же вам переживать?

Иллюстрация


Совет 24

Если люди к вам приходят
Поработать на платформе,
Не просите их рассказывать,
Как им было бы удобно.

Не зовите вы дизайнера,
Не рисуйте и макета,
Сразу делайте как нравится
Лично вам. Зачем иначе?

Если люди вдруг пожаловались,
Что работать стало трудно,
Объясните им спокойно:
«Вы неправильно привыкли
Пользоваться приложеньем».

Разработчику виднее,
Как должны работать люди.


Совет 25

Если кнопку на странице
Вы нечаянно создали,
Не пытайтесь удалять.
Время ж на неё потратили.

Лучше сделайте на сервере
Для неё отдельный метод.
Если метод вышел лишним,
То тогда добавьте кнопку.

Между ними пусть находится
Пять дверей и семь окошек.
Кто дойдёт до завершенья,
Тот достоин этой кнопки.

А кому так неудобно,
Могут вовсе и не жать.
Меньше будут отвлекаться
От прекрасного дизайна.

Иллюстрация


Совет 26

Если сайт ваш еле дышит
От ста лишних обращений,
Не ищите, кто виновен,
Не пытайтесь их убрать.

Покупайте сервер больше,
Разместив второй с ним рядом.
Пусть потянут все запросы
И десятки ваших хуков.

Если оба вдруг устанут,
Покупайте третий сервер.
Так докажете начальству,
Что проект готов к нагрузке.

Люди, правда, не вернутся,
Но зато у вас теперь
Целых три больших серва.


Последний совет

Если вы уже подняли
Микросервисов штук 20,
Подключили Kafka, Jotai,
Redux, Zustand, GraphQL,

Написали свой фреймворк,
Запустили Next на ноде,
Даже если сайт статичный,
И придумали сто хуков,

А клиент сидит и плачет,
Ничего не понимая,
Не пытайтесь помогать.

Это просто пользователи
До высоких технологий
никогда им не дойти.

Иллюстрация