DEV Community: WildTuna

500+ коммитов за пять месяцев: как я в одиночку запустил RetroPoint

WildTuna — Thu, 03 Sep 2026 22:46:43 +0000

Пятого апреля 2026 года я начал проверять гипотезу: можно ли собрать работающий MVP SaaS за месяц на подписке Cursor за $20, работая по три-четыре часа четыре вечера в неделю. Через месяц MVP был. Второго сентября я выкатил релиз 2026.09.2, а между этими датами уместились больше 500 коммитов, семь модулей в проде и более шестидесяти пройденных фаз разработки.

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

Оговорюсь сразу о двух вещах. RetroPoint делаю я, так что читайте это как рассказ заинтересованного лица. И разработчик тут действительно один, но не с чистого листа.

Дизайн RetroPoint я заказал у дизайнера Натальи 10 декабря 2022 года. Она проработала только модуль ретроспектив, но этого хватило, чтобы задать визуальный язык продукта. До полноценной разработки постоянно не доходили руки. Я вернулся к отложенной идее весной 2026-го, когда развитие AI-моделей и агентов сделало такой запуск в одиночку реалистичным. С помощью Claude Design и современных AI-моделей я продолжил исходную систему уже без дальнейшего участия дизайнера и перенес ее на остальные модули.

Почему пришлось собирать свое

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

Потом привычный набор рабочих сервисов стал менее предсказуемым.

Менялись условия оплаты и доступа, а вместе с ними появлялся риск потерять накопленную историю встреч. Я не хотел снова строить процесс команды вокруг инструментов, доступность которых не контролирую.

Российские сервисы никуда не делись и работают. Когда я выбирал замену как тимлид, доступные мне продукты хорошо закрывали отдельные процессы, но не связывали их результаты в единый рабочий цикл.

Чего мне не хватало

Хорошая ретроспектива заканчивается договоренностями. Ради них встречу и собирали. Но после фиксации решений работа в инструментах обычно заканчивалась.

В командах, которыми я руководил, процесс чаще всего ломался в трех местах:

Контекст распадается. Цели живут в таблице, встречи в календаре, договоренности в чате, а личные заметки руководителя отдельно от всего этого.
Договоренность теряется. Записать решение мало. Нужно понимать, к какой цели оно ведет, кто отвечает, насколько это важно и к какому сроку.
Тимлид сшивает воркфлоу руками. Перед каждой встречей он заново собирает факты и переносит следующие шаги между сервисами.

Мне нужна была не доска, а связка «встреча, решение, действие с ответственным и сроком», чтобы следующий цикл начинался с того, чем закончился прошлый.

Что получилось

Сейчас в проде семь самостоятельных модулей: ретроспективы с 19 готовыми техниками, Planning Poker, OKR, встречи 1‑2‑1, Performance Review, рабочие встречи и календарь отсутствий с днями рождения.

Что я сделал и о чем не жалею:

Модули подключаются по одному. Неподключенный модуль не появляется в меню, поэтому рабочее место не зарастает кнопками, которыми никто не пользуется.
Участник заходит на публичную доску по ссылке без регистрации и без обязательного имени. Аккаунт нужен только организатору.
Договоренность превращается в действие с ответственным, сроком и ссылкой на исходную встречу.
AI-помощник собирает темы, готовит итоги и предлагает следующие шаги, но ничего не применяет без подтверждения человека.
Данные хранятся в России, оплата идет в рублях, а 27 июля продукт включили в реестр операторов персональных данных. Для части российских команд это входное требование к новому сервису.

Как это устроено

Бэкенд работает на Python 3.12 и FastAPI, данные лежат в PostgreSQL 16 через SQLAlchemy 2.0 и Alembic. Слои обычные: api, service, repository и adapters. Доска обновляется у всех участников через SSE, PDF собирается reportlab, файлы уходят в S3-совместимое хранилище.

На фронтенде React 18 с TypeScript и сборка на Vite. Перетаскивание карточек на dnd-kit, текстовые поля на TipTap, графики на ECharts. Инфраструктура простая: Docker Compose, GitLab CI, VDS на Ubuntu и nginx.

Дольше всего я возился с SEO у SPA. Публичная часть сайта живет на том же React-роутере, и по умолчанию поисковый робот получает пустой <div id="root">. Решение немодное, но работает. На сборке я собираю второй, серверный бандл через vite build --ssr, прогоняю по нему все публичные маршруты и раскладываю готовый HTML рядом со статикой. Оттуда же генерируется sitemap.xml из тех же данных, что и сами страницы, поэтому карта сайта не расходится с реальностью. Сборка падает, если у страницы пустой <title>, отсутствует description или подозрительно мало HTML внутри #root.

В public лежит еще один файл, llms.txt. В нем карта публичной части сайта с явными границами для AI-агентов: где смотреть актуальные тарифы и почему этот файл не служит API. Мне важно, чтобы бот, которого спросили про сервисы ретроспектив, читал текущие условия, а не пересказ статьи двухлетней давности. Проверять такой файл глазами бессмысленно, поэтому у него есть контрактный тест. Меняются тарифы или состав модулей в коде, а llms.txt не обновлен, и тест краснеет.

Как один человек тянет больше 60 фаз

Такой объем в одиночку я бы не вытянул без AI-агентов, но подход «просто попросить написать код» не работает вообще.

В моей схеме сильная модель принимает решения, а более доступная их исполняет. Claude Opus внутри Cursor снимал неопределенность: выбирал продуктовое и архитектурное решение, а потом превращал его в подробное ТЗ с критериями готовности. Реализацию по готовому контракту забирали более доступные модели. Главная экономия была не в стоимости запросов, а в том, что решение принималось один раз. Более доступные модели получали готовое ТЗ и не тратили время на повторный выбор подхода.

Когда ТЗ можно отдавать исполнителю. Да-да, по ходу работы я изобрел свой велосипед — локальную версию Spec-Driven Development. Superpowers, Spec Kit и OpenSpec я не использовал. Вместо готового фреймворка постепенно собрал процесс вокруг проектных спецификаций в файлах docs/plan/phase-NN-*.md, которые появляются до кода. Передавать план можно, когда в нем приняты все ключевые решения. Исполнителю не нужно угадывать, зачем нужен сценарий и кто им пользуется, что входит в scope и что намеренно исключено, какой существующий паттерн продолжать, какие роли, права, тарифы и состояния учитывать, как выглядит API-контракт и чем доказывать готовность. Если хоть по одному пункту осталась развилка, исполнитель тихо начинает работать архитектором, и дешевая реализация превращается в дорогую переделку. Половина ошибок отсекается прямо здесь, потому что противоречие видно в тексте, а не в диффе на 900 строк.

Дизайн-токены сделали визуальное ТЗ достаточно точным. Исходный дизайн покрывал только ретро, но уже задавал палитру и типографику продукта. Все остальные модули, от Planning Poker до Performance Review, я проектировал в Claude Design поверх этой системы. Помог не запрос «нарисуй красиво». Помогло то, что у агента были docs/design-tokens.md и tokens.css: семантические роли цвета, шкала типографики, 8pt-сетка, радиусы и размеры контролов. Макет показывает одно правильное решение. Дизайн-токены объясняют агенту, почему это решение принадлежит именно этому продукту. Иерархию, плотность, состояния и права по-прежнему принимал я.

Где схема ломалась. На сквозном фронтенде несколько попыток Claude Sonnet и Composer 2.5 не прошли мою приемку. Дело было не в моделях. Под видом реализации я отдавал им еще не законченное проектирование. Это хорошо показывает Planning Poker: коммит 9e5ba4c затронул 42 файла и добавил 4839 строк, а полный прогон включал 323 теста. Сложность там создает не объем JSX. Экран одновременно держит состояние сессии, роли участников, ограничения тарифа и визуальную иерархию. Opus снял развилки, и после этого части снова уходили исполнителям.

Проектные скиллы в репозитории. Для RetroPoint я сделал отдельные скиллы и храню их рядом с кодом. Это не универсальные инструкции для любого репозитория, а накопленный контекст конкретного продукта. В них зафиксированы карта UI-примитивов, правила слоев бэкенда, подход к архитектурным планам, редакционный стиль и требования внешних площадок. Поэтому агент точнее понимает существующие решения, а договоренности не теряются между чатами.

Скучные правила репозитория. Ни npm, ни python с хоста, все команды идут в контейнерах api и frontend из корневого compose. Скучно, зато «у меня работает» больше не случается. Второе правило с первого дня: агент не коммитит без явной команды и не решает сам, что работа закончена.

Контрактные тесты на публичные обещания. Критичные обещания на сайте проверяются кодом. Один тест сверяет цифры на странице тарифов с лимитами в бэкенде. Другой держит llms.txt. Третий проверяет SEO-метаданные на сборке фронта. Агент может уверенно написать «до 10 активных досок», и остановит его только красный тест.

Что не сработало

Теперь про грабли.

Страница тарифов. Я собрал четыре тарифа и шестнадцать дополнительных пакетов с отдельной таблицей возможностей для каждого. Вышла страница высотой около 28 500 пикселей с восемью таблицами. Мне казалось, что так честнее: человек видит все и выбирает точно. На деле выбор такой сложности человек не делает, он закрывает вкладку. В 55-й фазе я переупаковал все заново и свел линейку к постоянному бесплатному тарифу, двум платным вариантам для одной команды и небольшого направления, а также корпоративному тарифу по запросу. При регистрации по-прежнему доступны 30 дней полного продукта без карты и автосписания.

Приватная фича, из-за которой сайт пропал из выдачи всех поисковиков. Одиннадцатого апреля я поднял pre-render всех публичных маршрутов и успокоился. Двадцать первого мая, занимаясь совсем другой задачей про восстановление сессии в новой вкладке, я поставил AuthSessionProvider, который возвращал null, пока не проверит cookie. В статике все лежало правильно. Но React гидратировался, вычищал #root и держал его пустым до ответа бэкенда, так что краулер с JS получал пустую страницу на каждом публичном маршруте. Так продолжалось неделю, и этого хватило, чтобы поисковики убрали RetroPoint из выдачи. Сборка все это время была зеленой, потому что SEO-ассершены проверяли файл на диске, а не то, что остается после гидратации. Починил двадцать восьмого мая, вторым заходом второго июня добил клиентский рендер, а правильный вывод сделал только в конце июля, когда добавил post-deploy smoke по опубликованным адресам.

Страница регистрации отдавала 404. Пре-рендер знает только публичные маршруты, а все остальное в nginx уходило в error_page 404. Внешне все выглядело прилично: приложение поднималось и рисовало нужный экран. Но код ответа был 404, и в первом кадре успевала мигнуть надпись «Страница не найдена». Живой человек этого почти не замечал, а вот рекламный кабинет отклонял /register как посадочную страницу, и краулеры превью показывали в мессенджерах ошибку вместо карточки ссылки. Лечится SPA-фолбэком для приложенческих префиксов, при котором на все прочие адреса остается честный 404. Чувствительные файлы и раньше не попадали в публичную статику: .env исключался из сборочного контекста, секреты бэкенда хранились отдельно, а деплой публиковал только собранный фронтенд. В nginx я добавил еще один рубеж защиты. Теперь скрытые файлы и карты исходников возвращают 404, даже если однажды случайно окажутся в релизе. На эту мысль навели логи: сканеры регулярно пытались достать /app/.env. Конфиг уехал на прод первого сентября, за день до того, как я сел писать этот текст.

Один провайдер входа оказался точкой отказа. По срезу на второе сентября у 67 владельцев аккаунтов из 110 вообще не было локального пароля: они входили только через внешнего провайдера. До отключения Google был самым популярным внешним способом входа. Поэтому в июле исчезла не просто одна из кнопок, а привычный путь в продукт для заметной части аудитории. Часть 10 статьи 8 закона № 149-ФЗ ограничивает способы авторизации пользователей в России для российских владельцев сайтов и приложений. С 7 июля 2026 года закон № 199-ФЗ ввел за нарушение административную ответственность.

Яндекс уже был подключен, но закрывал только часть потребности. Неожиданным для меня оказалось другое: заметная часть регистраций через него пришла с корпоративных доменов. Корпоративные решения Яндекса привели в RetroPoint аудиторию, которую я не ожидал увидеть в этом канале.

После отключения Google я стал искать российский способ входа, который с высокой вероятностью уже есть у целевой аудитории. Выбор пал на Сбер ID и быстро себя оправдал. В срезе на четвертое сентября у Сбер ID было восемь регистраций, у Яндекса 38, у отключенного Google 25, а у VK ни одной. Сбер ID появился в продукте только шестого августа, поэтому восемь регистраций примерно за месяц стали для меня заметным сигналом спроса.

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

Заодно выяснилось, что OAuth совсем не сводится к кнопке в форме. Нужно учесть callback, state и PKCE, привязку при занятом email, восстановление доступа, флаг функции, ошибки конкретного провайдера и отдельную приемку в рабочей среде.

Семь модулей, но ни один пока не стал привычкой. Срез рабочей среды на десятое сентября: 110 активных владельцев аккаунтов, 106 из них сейчас внутри 30-дневного триала. Ретро-доски с карточками есть у 43 человек, всего 48 досок и 871 карточка. Дальше цифры падают: 8 команд, 20 встреч 1‑2‑1, 22 задачи в двух сессиях Planning Poker, один цикл Performance Review и ни одного цикла OKR. Признак повторения есть у 11 владельцев из 43: девять возвращались на ту же доску в другой день, трое завели вторую доску. Сначала я считал повторением только вторую доску и получил трех человек, но это неверно: несколько ретроспектив часто проходят на одной доске, которую просто правят заново. С деньгами так же: одна оплата от внешнего пользователя за все время, 200 ₽ 12 мая. Вывод получился неприятный. Скорость разработки не равна скорости изменения привычек, и семь процессов я построил заметно раньше, чем у четверти пришедших появился признак повторения хотя бы одного. Пять месяцев я занимался тем, что умею, архитектурой и модулями, и почти не занимался ни дистрибуцией, ни тем, чтобы довести до второй ретроспективы тех, кто уже пришел. С этой статьи и начинаю исправлять.

Что дальше

Дальше по плану аналитика воронки и UTM-атрибуция, а следом работа с дистрибуцией вместо очередного модуля.

Посмотреть, что получилось, можно на retropoint.ru. Бесплатный тариф с ретро-досками остается бесплатным.

Если вы тоже запускали продукт в одиночку, расскажите, как вы поняли, что пора отложить новые функции и заняться привлечением пользователей и продажами. Я слишком долго оценивал прогресс по темпу разработки. Коммитов и модулей становилось больше, но повторных пользователей и оплат почти не прибавлялось.

MacOS: Внешние диски и APFS (format external ssd drive in APFS)

WildTuna — Mon, 05 Sep 2022 13:28:01 +0000

Если вы пользователь MacOS, то скорее всего сталкивались с подключением внешних дисков. Как вы уже знаете система монтирует их в /Volumes/*. Система MacOS устроена таким образом, что она создает разные скрытые файлы с метаданными всех файлов и директорий. В APFS это как правило .DS_Store и еще несколько директорий для корзины и Spotlight. Если же мы говорим о других файловых системах, с которыми могут работать и другие операционные системы (ExFat, NTFS), то MacOS создает гораздо больше файлов. Сразу могут броситься файлы, которые начинаются на ._ (dot underscore) - это и есть метаданные по файлам и директориям, которые использует MacOS. Помимо внешних дисков файлы .DS_Store создаются и на сетевых дисках.

Для отключения создания .DS_Store файлов на сетевых дисках в MacOS предусмотрена специальная директива. Выполните эту команду в терминале, чтобы .DS_Store файлы не создавались на сетевых дисках:

defaults write com.apple.desktopservices DSDontWriteNetworkStores -bool true

Для новых версиях MacOS появилас аналогичная директива и для USB дисков:

defaults write com.apple.desktopservices DSDontWriteUSBStores -bool true

Также нужно отключить индексирование внешнего диска:

sudo mdutil -i off /Volumes/<DISK NAME>

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

К сожалению запретить создание файлов ._ нельзя. Эти файлы очень мешают при работе с Git и Docker. Единственное, что можно сделать - это удалить их вручную командой в терминале dot_clean -n <dirname>, где <dirname> - это директория, в которой нужно удалить начинающиеся с ._ файлы. Для рекурсивного удаление в текущей директории и всех поддиректориях используйте команду

dot_clean -n .

Но есть и хорошая новость! Эти файлы создаются только на файловых системах, отличных от Apple-овских. Поэтому, если отформатировать диск в MacOS Extended или APFS проблема с ._ (dot underscore) пропадет.

Для того, чтобы переформатировать жесткий диск нам понадобится "Дисковая утилита". В левом меню выбираем нужный диск, в быстром меню (правая кнопка мыши) выбираем "Стереть..." и в открывшемся окне выбираем нужную файловую систему. На рисунке ниже отображено окно форматирования подключенного по USB SSD диска.

Но где же заветная APFS? Все дело в том, что большинство дисков, которые продаются используют разметку MBR, которая не совместима с APFS. Для форматирования диска в APFS у него должна быть разметка GPT (иногда ее называют GUID). Сделать этого в GUI версии "Дисковой утилиты" не получится. Обратимся к консольной. Для этого в терминале нужно выполнить последовательность действий ниже.

Смотрим под каким номером примонтирован интересующий нас диск. Для этого выполним команду diskutil list

На рисунке выше мы видим результат выполнения этой команды. Интересующий нас диск я выделил красным. Он примонтирован как /dev/disk2 - это понадобится для команды форматирования.

Собственно для форматирования диска в APFS нужно выполнить эту команду:

diskutil partitionDisk <disk number> 1 GPT APFS <disk name> R

Где <disk number> - это примонтированный диск, а <disk name> - это имя диска, с которым он будет отображаться в приложениях и в /Volumes/*.

Пример команды с заполненными параметрами:

diskutil partitionDisk /dev/disk4 1 GPT APFS KINGSTON R

После успешного выполнения команды в diskutil list мы увидим, что диска теперь два и нужный отформатирован в APFS. На рисунке ниже приведен результат этой команды после форматирования.

Теперь у вас внешний диск в APFS и на нем не будут создаваться файлы с ._ (dot underscore). Так же в этой файловой системе у меня увеличилась скорость чтения и записи на 200Mb/s в сравнении с ExFat.

Ошибка обновления GitLab из-за ошибки обновления Let’s Encrypt

WildTuna — Fri, 20 May 2022 08:55:07 +0000

Столкнулся недавно с проблемой обновления GitLab до версии 12.6 из-за ошибки реконфигурации, вызываемой попыткой обновления сертификата Let’s Encrypt. Так получилось, что обновление пришлось на день, когда был просрочен сертификат. Не беда! Отключаем использование сертификата в /etc/gitlab/gitlab.rb и запускаем реконфигурацию вручную:

nano /etc/gitlab/gitlab.rb
// Находим это строку и выставляем значение false
letsencrypt['enable'] = false
// Сохраняем файл и выполняем реконфигурацию
gitlab-ctl reconfigure

Теперь GitLab успешно применит новые параметры и сможет обновиться. После завершения обновления возвращаем использование Let’s Encrypt в /etc/gitlab/gitlab.rb, снова реконфигурируем GitLab и… снова получаем прежнюю ошибку!

Running handlers:
There was an error running gitlab-ctl reconfigure:
letsencrypt_certificate[git.hostname.com] (letsencrypt::http_authorization line 5) had an error: RuntimeError: acme_certificate[staging] (/opt/gitlab/embedded/cookbooks/cache/cookbooks/letsencrypt/resources/certificate.rb line 25) had an error: RuntimeError: ruby_block[create certificate for git.lapaygroup.ru] (/opt/gitlab/embedded/cookbooks/cache/cookbooks/acme/resources/certificate.rb line 108) had an error: RuntimeError: [git.hostname.com] Validation failed, unable to request certificate

Огорченный полез гуглить. Оказалось, проблема не только у меня, но четкого решения проблемы нет. После пары часов изучения баг-трекера GitLab и тщетных попыток устранить проблему мой рецепт решения был найден, и он очень простой:

проверить, что порты 80 и 443 открыты;
проверить домен на сайте Let’s Encrypt;
установить параметры в /etc/gitlab/gitlab.rb: nginx[‘redirect_http_to_https’] = true nginx[‘redirect_http_to_https_port’] = 80
удалить файлы проблемного сертификата из папки /etc/gitlab/ssl;
запросить новый сертификат: gitlab-ctl renew-le-certs.

В моем случае оказался закрыт 80 порт и что-то случилось с правами на файлы сертификата в /etc/gitlab/ssl — при обновлении GitLab не мог их заменить.

Надеюсь, мой рецепт поможет решить проблему и вам!

Удаление Checkpoint Endpoint Security client on Mac (Uninstall)

WildTuna — Fri, 20 May 2022 08:45:02 +0000

Для удаление Checkpoint Endpoint Security client on Mac на MacOS необходимо выполнить shell скрипт в терминале.

#bash
sh /Library/Application Support/Checkpoint/Endpoint Security/uninstall
Или (зависит от установленной версии)
sh /Library/Application Support/Checkpoint/Endpoint Security/uninstall.sh

Как обновить GitLab 12.9 до 13.1 в Debian и Ubuntu

WildTuna — Fri, 20 May 2022 08:43:01 +0000

Если вы пропустили несколько обновлений GitLab и теперь при попытке апдейта через apt update && apt upgrade получаете ошибку перехода на мажорную версию (см. текст ошибки ниже), то устанавливать обновления придется поочередно.

Preparing to unpack .../gitlab-ce_13.1.3-ce.0_amd64.deb ...
gitlab preinstall: It seems you are upgrading from major version 12 to major version 13.
gitlab preinstall: It is required to upgrade to the latest 13.0.x version first before proceeding.
gitlab preinstall: Please follow the upgrade documentation at https://docs.gitlab.com/ee/policy/maintenance.html#upgrade-recommendations
dpkg: error processing archive /var/cache/apt/archives/gitlab-ce_13.1.3-ce.0_amd64.deb (--unpack):
 subprocess new pre-installation script returned error exit status 1
Errors were encountered while processing:
 /var/cache/apt/archives/gitlab-ce_13.1.3-ce.0_amd64.deb

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

// Ставим последнюю 12 версию
apt install gitlab-ce=12.10.10-ce.0
// Ставим новую мажорную версию
apt install gitlab-ce=13.0.4-ce.0
// Ставим последнее обновление
apt upgrade

Принцип подходит для любой ошибки пропуска версий, главное — соблюдать порядок их обновления. Список всех версий можно посмотреть тут.

Надеюсь, статья была полезна. Спасибо, что дочитали до конца!

Проверка доступности TCP/UDP- порта в Linux-server

WildTuna — Fri, 20 May 2022 06:29:46 +0000

Приветствую тебя, читатель! Если ты попал сюда, видимо, ты находишься в поиске информации, как проверять сетевые доступы в командной строке Linux. Постараюсь ответить на этот вопрос.

Проверка доступности TCP-порта

Для проверки доступности TCP-порта в командной строке Linux идеально подходит утилита telnet. Ниже я приведу несколько примеров:

// Порт 3306 доступен и его слушает MySQL 5.5.62, установленный на ОС Debian 8
telnet testmysql.domain.com 3306
Trying 10.80.80.1...
Connected to testmysql.domain.com.
Escape character is '^]'.
W
5.5.62-0+deb8u1-log
// Для выхода из окна отправки команд на порт нужно ввести quit или сочетание клавиш ctrl/cmd + C
// Нет разрешения на подключение (Firewall) или порт никто не слушает)
telnet testmysql.domain.com 3307
Trying 10.80.80.1...

Вместо telnet можно воспользоваться утилитой nc (NetCat), команды у нее очень простые. Ниже приведу аналогичную проверку доступности порта MySQL:

nc testmysql.domain.com 3306
W
5.5.62-0+deb8u1-log��sU/({V{)��!�X^OS2@+UIQ9hmysql_native_password
// -z - Не посылать данные (сканирование портов) 
// -v - Дополнительная диагностика (verbose)
nc -z -v testmysql.domain.com 3306
Connection to testmysql.domain.com port 3306 [tcp/mysql] succeeded!

С полным списком доступных ключей утилиты nc и их описанием можно ознакомиться тут.

Проверка доступности UDP-порта

Для проверки UDP-портов выбор утилит меньше. Я использую в основном nc (NetCat). Ниже приведу несколько примеров проверки UDP-порта:

// MacOS
nc -z -v -u grayloghost.com 12311
Connection to grayloghost.com port 12311 [udp/*] succeeded!
// Linux
nc -z -v -u grayloghost.com 12311
Ncat: Version 7.50 ( https://nmap.org/ncat )
Ncat: Connected to 10.80.80.2:12311.
Ncat: UDP packet sent successfully
Ncat: 1 bytes sent, 0 bytes received in 2.01 seconds.

Надеюсь, статья была полезна. Спасибо, что дочитали до конца!

GitHub: Authentication failed on git push

WildTuna — Fri, 20 May 2022 06:21:46 +0000

Столкнулся тут с проблемой внесения изменений в одну из своих библиотек на GitHub, а именно ошибкой аутентификации.

Достаточно странно. Пароль точно верный, но в чем же дело? Стал вспоминать, что последнее делал в GitHub и вспомнил. Я включил двухфакторную аутентификацию.

Лечится эта проблема просто. Заходим в Settings -> Developer settings (отдельная кнопка внизу в левом меню). В открывшемся окне выбираем Personal access tokens и наживаем на кнопку Generate new token (https://github.com/settings/tokens/new). В открывшемся окне указываем название токена и нужные права доступа.

После заполнения нажимаем кнопку Generate token и копируем полученный токен в буфер обмена, он понадобится для аутентификации в git push.

Рекомендую сохранить его, так как повторный просмотр в интерфейсе невозможен.

Тепер возвращаемся к терминалу в каталог с локальным репозиторием и вводим команду git push. Git запросит Username и Password. Вводим ваш Username на GitHub и созданный access token вместо своего пароля.

Вот и все, теперь аутентификация снова работает! Удачи!

Visual Studio Code как альтернатива PHPStorm для Backend-разработчика

WildTuna — Thu, 19 May 2022 22:13:00 +0000

В сложившейся ситуации с покупкой продуктов JetBrains на территории РФ задумался об альтернативе одному из их продуктов PHPStorm. Давно слышал много хороших отзывов о VSCode и решил попробовать поработать в нем недельку. Начал с изучения доступных расширений и их настройки. В итоге мне удалось собрать под себя очень достойную альтернативу PHPStorm. В чем-то она хуже, в чем то лучше продукта от JetBrains, но для себя я решил пока остаться на VSCode. Ниже я поделюсь с вами расширениями, которые использую и настройками.

Начинаем с установки Visual Studio Code. Для этого нужно скачать установщик с официального сайта. После установки мы получим голый VSCode.

При желании можно установить языковый пакет, который локализует интерфейс приложения.

Установка расширений

Менеджер проектов

По умолчанию в VSCode нет привычной работы с проектами, но эту проблему легко решить используя расширение Project Manager. Чтобы создать проект открываем папку с файлами, которую хотим использовать как проект, нажимаем ctrl+shift+P, в появившейся строке вводит Project и выбираем выделенный ниже элемент списка.

Будет предложено ввести имя проекта.

После подтверждения проект будет создан и его можно будет увидеть в разделе с проектами.

При клике на проект VSCode сразу откроет папку, к которой был привязан проект.

Расширения для PHP

Для комфортной работы с PHP необходимо установить эти расширения:

Для отладки через XDebug
Самое удобное расширение для работы с PHP кодом в VSCode от DevSense с AI подсказками
Альтернатива предыдущего расширения для работы с кодом PHP Intelephense (Очень советую приобрести Premium версию)
Альтернатива предыдущего расширения для работы с кодом PHP IntelliSense (На мой взгляд хуже предыдущего)
Для работы с DocBlock PHP DocBlocker
Для автовставки Namespace PHP Namespace Resolver
Для генерации getters и setters
Генератор конструктора PHP Constructor
Добавляет генерацию классов, интерфейсов, трейтов, enum при создании нового файла PHP Create Class
Вставка подсказок type hints и входных параметров PHP Parameter Hint
Для работы с Composer
Для подсказок пакетов и версий в composer.json Composer IntelliSense
CSFixer по желанию, требуется установленный на машине PHP

Если включить одновременно IntelliSense и Intelephense, то будут задвоены подсказки методов и аннотации с описанием функций.

После установки расширений нужно отключить базовые подсказки PHP VSCode. Для этого нужно в расширениях в поисковой строке ввести @builtin php и отключить расширение PHP Language Features.

Расширения для Symfony

Symfony for VSCode
Symfony Console Run All Symfony Commands
Symfony code snippets And Twig Support & Yaml

Расширения для Laravel

Laravel Artisan
Laravel Blade Snippets
Laravel Blade Spacer
Laravel Extra Intellisense
Laravel Goto Controller
Laravel goto view
Laravel Snippets

Работа с тэгами

Для удобства работы с HTML, XML и прочими документами с тэгами:

Auto Rename Tag
Auto Close Tag
Auto Complete Tag Ставит сам два расширения выше

Встроенный Rest Client

Rest client по аналогии с тем, что был добавлен в PHPStorm
REST Client.
Thunder Client - встроенный клиент, похожий на Postman.

Работа с проектом по FTP/SFTP

Для работы с проектами на удаленных машинах нужно установить расширение SFTP. Оно добавляет возможность в проектах добавлять SFTP конфиг, в котором можно указать опции синхронизации.

Системы контроля версий VCS

Для работы с Git, пожалуй, лучшее расширение GitLens — Git supercharged.

Для отображения веток в виде графа Git Graph.

Для удобного просмотра истории Git History.

Для работы с GitLab и проведения CodeReview есть хорошее официальное расширение GitLab Workflow.

Есть еще интересный проект New Relic CodeStream, но мне не нравится, что там нужна регистрация и части кода, который комментируется, сохраняются на их серверах.

Верстка и шаблонизаторы

Для быстрого составления HTML Emmet

Для поддержки синтаксиса TWIG Twig Language 2

Для удобной работы с CSS CSS Peek

JavaScript (ES6) code snippets JavaScript (ES6) code snippets

Работа с СУБД

Для работы с СУБД из VSCode SQLTools Есть драйвера для всех популярных СУБД (ставятся отдельными расширениями).

Работа с Docker

Для удобной работы с контейнерами, сетями, образами, voluems и т.д. есть отличное расширение от Microsoft Docker.

Документация

Для работы с Markdown markdownlint
Для предпросмотра Swagger прямо в IDE Swagger Viewer
Автоподсказки для написания Swagger Swagger Snippets

Форматирование и читаемый вид

Крутое расширение для форматирования и работы с XML от RedHat.

При нажатии правой кнопкой мыши в открывшемся меню появится новый блок для форматирования после установки расширения.

Альтернатива расширениею выше для работы c XML.

Форматирование JSON JSON Tools
Для форматирования нужно использовать комбинации славишь ниже:

Ctrl(Cmd)+Alt+M для преобразования JSON в читаемый вид
Alt+M для минимизализации JSON

Форматирование SQL SQL Formatter
При нажатии правой кнопки мыши по выделенному SQL в меню появится новый блок после установки расширения.

Для работы с GraphQL.

TODO и FIXME

Работая с PHPStorm многие из вас привыкли к удобному просмотру TODO и FIXME в виде списка по всему проекту. В VSCode для этой задачи есть два расширения.

Todo Tree - очень удобное расширение, позволяет видеть все TODO в виде списка, огромные возможности кастомизации отображения, возможность добавлять свои тэги.

TODO Highlight - расширение попроще предыдущего, но также позволяет кастомизировать отображение и добавлять свои тэги. На мой взгляд менее удобно реализован листинг TODO по проекту.

Работа с таск-трекерами

Для быстрой работы с задачами прямо из VSCode для себя использую эти расширения:

Redmine - позволяет быстро просматривать список задач, менять статусы и трекать затраченное время;
YouTrack - позволяет смотреть задачи, создавать ветки при открытии задачи, MR и прочее;
YouTrack Issues - попроще предыдущего, но мне он нравится больше, так как сосредоточен только на работе с задачами и более удобный листинг задач;
Jira and Bitbucket - официальное расширение, которое отлично реализует работу с задачами в Jira и Bitbucket.

Темы

В магазине VSCode есть большой выбор тем. Мне больше всего нравится во всех IDE Twilight Twilight Theme Многим нравится GitHub Theme. В целом в магазине каждый найдет что-то на свой вкус.

Если вы обычно работаете с несколькими окнами VSCode одновременно, то вас может заинтересовать расширение Peacock, которое позволяет задать окнам IDE разную палитру и проще ориентироваться в открытых проектах.

Прочее

Total Lines - добавляет в тулбар информацию, о количестве строк в файле.
Regex Previewer - быстрая отладка регулярных выражений прямо в VSCode.
Bookmarks - для удобных флажков на строчки кода.
Better Comments - кастомизация комментариев в коде.
Edit CSV - просмотр и редактирвоание CSV.
Hungry Delete - быстрое удаление пустых строк и пробелов одним нажатием.
Path Intellisense - автоподставление путей к файлам.

Настройки

Посе установки всех необходимых расширений необходимо произвести некоторые настройки в самом settings.json VSCode и в проектах настроить файлы-конфигурации расширений для их использования.

Базовые настройки VSCode

Для комфортной работы расширений нужно произвести настройки в главном settongs.json.
Для открытия его редактирования нужно набрать ctrl + shift + P и в строке ввести settings.json.
В выпадающем списке выбрать выделенный на скрине вариант.

Откроется глобальный settings.json для всего VSCode, в котором нужно добавить / обновить значение узлов, как показано ниже.

{
        / Если нужен прокси для выкачивания плагинов
        "http.proxyStrictSSL": false,
        "http.proxy": "http://proxy-host.ru:3128",
        "editor.wordSeparators": "`~!@#%^&*()-=+[{]}\\|;:'\",.<>/?", // Чтобы символ $ попадал в выделение слова при двойном клике
    "editor.rulers": [ 125 ], // Максимальное количество символов в строке. Рисуется вертикальная линия, как в PHPStorm
        // Настройки, чтобы подсказки работали везде (аннотации и прочее)
    "editor.quickSuggestions": { 
        "other": true,
        "comments": true,
        "strings": true
    },
    "workbench.editor.labelFormat": "medium", // Показывать путь до файла в табе вкладки (long, medium, short, default)
    "workbench.colorCustomizations": {
        // Цвет текста у подсказок TypeHint
        "phpParameterHint.hintForeground": "#757373",
        // Цвет фона у подсказок TypeHint
        "phpParameterHint.hintBackground": "#2b2b2b"
    },
    // Путь до интерпретатора PHP для линтеров (пример пути для Windows)
    "php.executablePath": "D:/Users/user/php/php.exe",
    "php.validate.executablePath": "D:/Users/user/php/php.exe",
      // Путь до интерпретатора PHP для Symfony VSCode расширения
    "symfony-vscode.phpExecutablePath": "/usr/local/bin/php",
    // Чтобы в терминале поддерживался шрифт Menlo для Powerline
      "terminal.integrated.fontFamily": "Menlo for Powerline",
    // Отключаем отправку данных об использовании
      "redhat.telemetry.enabled": false,
      // Путь до исполняемого файла Composer
    "composer.executablePath": "/usr/local/bin/composer",
    // Переопределяем шаблоны исключения для расширения подсказок
      "intelephense.files.exclude": [
        "**/.git/**",
        "**/.svn/**",
        "**/.hg/**",
        "**/CVS/**",
        "**/.DS_Store/**",
        "**/node_modules/**",
        "**/bower_components/**",
        "**/vendor/**/{Test,test,Tests,tests}/**/*Test.php"
    ],
      // Чтобы Twig обрабатывался как HTML (расширение добавляет само)
    "emmet.includeLanguages": {
        "twig": "html"
    },
      // Настройки для расширения автозакрытия тэгов (расширение добавляет само)
    "auto-close-tag.activationOnLanguage": [
        "xml",
        "php",
        "blade",
        "ejs",
        "jinja",
        "javascript",
        "javascriptreact",
        "typescript",
        "typescriptreact",
        "plaintext",
        "markdown",
        "vue",
        "liquid",
        "erb",
        "lang-cfml",
        "cfml",
        "HTML (EEx)",
        "HTML (Eex)",
        "plist"
    ]
}

Настройка SFTP / FTP подключения в проекте

Для настройки SFTP / FTP подключения в проекте нужно создать файл-конфигурацию sftp.json в проекте. Для этого нужно набрать ctrl + shift + P, в строке ввести SFTP: Config и выбрать выделенный ниже элемент списка.

Оптимальный файл-конфигурации приведен ниже.

{
    "name": "Connection Name", // Название соединения
    "host": "test.ru", // Адрес сервера
    "interactiveAuth": true, // Чтобы работал 2fa (DUO, Мультифактор и т.п.)
    "protocol": "sftp", // Протокол подключения к серверу
    "port": 22, // Порт подключения к серверу
    "username": "user", // Имя пользователя, под которым подключаемся
    "privateKeyPath": "/Users/user/.ssh/id_rsa", // Путь к приватному SSH ключу на ПК
    "remotePath": "/var/www/html", // Каталог, который нужно синхронизировать
    "downloadOnOpen": true, // Скачивать файл с сервера при открытии
    "uploadOnSave": true, // Загружать файл на сервер при сохранении
    "ignore": [ // Список файлов и папок, которые нужно исключить из синхронизации
        ".vscode",
        ".idea",
        ".git",
        ".DS_Store",
        "var"
    ],
    "remoteExplorer": { // Список файлов и папок, которые нужно исключить из визора файлов на сервере
        "filesExclude": [
            "/var"
        ]
    }
}

Для скачивания проекта файлов с сервера нужно ввести SFTP Download и выбрать выделенный ниже элемент списка.

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

Настройка SQLTool

Для добавления подключения к СУБД нужно нажать ctrl+shift+P, в строке ввести SQLTool и выбрать выделенный ниже элемент списка.

Откроется ассистент настройки подключения

В итоге будет получен settings.json файл с параметрами подключения.

В одном проекте может быть несколько подключений к разным БД.
Для MySQL файл-конфиграции выглядит как приведено ниже.

{
    "sqltools.connections": [
        {
            "mysqlOptions": {
                "authProtocol": "default"
            },
            "previewLimit": 50, // Количество строк в превью
            "server": "test.ru", // Адрес сервера СУБД
            "port": 3306, // Порт СУБД
            "driver": "MySQL", // Драйвер 
            "name": "ConnactionName", // Имя подключения в визоре
            "database": "testdb", // Имя БД
            "username": "user", // Пользователь БД
            "connectionTimeout": 60, // Тайм-аут подключения в секундах
            "password": "db_password" // Пароль пользователя БД
        }
    ]
}

Настройка расширения XDebug

Для отладки PHP кода средствами Xdebug нужно составить файл-конфигурацию.
Для этого в меню Run нужно выбрать Add Configuration...

Откроется редактор launch.json.
Пример заполненного файла конфигурации для xdebug приведен ниже.

{
    // Используйте IntelliSense, чтобы узнать о возможных атрибутах.
    // Наведите указатель мыши, чтобы просмотреть описания существующих атрибутов.
    // Для получения дополнительной информации посетите: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug", // Название дебаггера
            "type": "php",
            "request": "launch",
            "pathMappings": {
                "/application": "${workspaceFolder}/application" // Слева директория приложеиня
            },
            "port": 9005 // Порт, который слушает xdebug
        }
    ]
}

По итогу работа отладчика будет выглядеть, как на скрине ниже

Настройка расширения Redmine

Для работы с задачами в таск-трекере Redmine в конфигурационном файле settings.json в каталоге .vscode проекта нужно добавить настройки ниже. После сохранения для работы нужно перезапустить VSCode.

    "redmine.url": "https://redmine.example.ru", // Адрес Redmine
    "redmine.apiKey": "ApiKey", // API Ключ Redmine
    "redmine.rejectUnauthorized": true, // Если самоподписанные SSL сертификат

Настройка расширения Intelephense

Чтобы указать версию PHP у проекта для корректной работы линтера нужно в файле settings.json в проекте указать ее, как показано ниже.

    "intelephense.environment.phpVersion": "7.4.0"

Спасибо, что дочитали до конца! Надеюсь, моя инструкция будет полезна и вам!