GDS 4.0.12

В 4.0.12 версии проведены небольшие модификации в процессе работы с типографией. По-прежнему доступна возможность разработки собственного хелпера с использованием классов из файла typography.scss. Начиная с версии 4.0.12, появилась возможность применения стилей через хук useScssTheme.

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

Также стоит отметить проведение легкого рефакторинга интерфейса стейта провайдера. Вместо предыдущего использования styles теперь применяется components, что упрощает понимание назначения данного раздела.
Добавлено новое поле typography, для которого необходимо передать css module на базе typography.scss. Это изменение необходимо для того чтобы работать с типографикой через useScssTheme.

Были изменены названия классов в файле typography.scss, поэтому после обновления нужно выполнить скрипт gds\-scss\-tokens

Было выпущено несколько обновлений для GDS, последняя стабильная версия 4.0.10.

Обновления включили в себя решения проблем, связанных с автокитами, и обеспечивают их совместимость с Vite. Были внесены исправления по дерективе 'use client' для клиентских компонентов и устранены ошибки, связанные с es модулями.
Кроме того, обновления затронули и лейауты, где были исправлены незначительные ошибки.

Пакет gds был обновлен до версии 3.2.0, в которой была внесена корректировка функционала. В этой новой версии команде gds\-scss\-tokens предоставлены возможности для генерации новых миксинов, которые могут быть использованы для работы с grid и flex, подобно Layout. Также стоит отметить, что gds\-scss\-tokens теперь совместима с локальной настройкой Prettier и Stylelint для обработки генерируемых файлов.

Вышло обновление пакета ensi/octane\-swoole\-urgent\-starter, которое позволяет немного снизить потребление памяти.
Начиная с версии 2.0.1 вы можете вместо команды octane:start запускать сервер выполнив последовательно команды для настройки и старта сервера

php artisan octane:dump\-server\-state \-\-host=0.0.0.0 \-\-port=8000 \-\-workers=20 php ./vendor/bin/swoole\-server /var/www/storage/logs/octane\-server\-state.json

это позволяет не запускать лишний процесс, который потребляет порядка 30Mb RAM.

Для применения этого в проекте необходимо:
1) обновить пакет в каждом сервисе
2) настроить запуск сервисов в соответствии с инструкциями

Все пакеты (например) были унифицированы под единый формат разработки:
- Добавлены гит хуки через elc
- Добавлена проверка через phpstan
- Сделан везде единый конфиг cs fixer
- Тесты теперь реализуются через pest
- Readme приведён к единой структуре
- Поддерживаемые версии laravel: >= 9
- Поддерживаемые версии php: >= 8.1

а) В большинстве случаев это привело к выпуску новой мажорной версии. Актуальные версии пакетов можно посмотреть в PR.
б) Также обратите внимание на пакеты
ensi/dadata-sdk-php -> ^1.1.0
ensi/laravel-auditing -> ^0.4.0
ensi/laravel-elastic-query -> ^7.1.0 и ^8.1.0
ensi/laravel-elastic-query-specification -> ^7.1.0 и ^8.1.0
ensi/laravel-serve-swagger -> ^0.4.0
в) При обновлении пакета ensi/laravel-test-factories необходимо заменить namespace "\TestFactories" => "\LaravelTestFactories"

Обновили gds до 3.1.8

Добавлен генератор базовых стилей.
После использования команды
gds\-scss\-tokens
будет автоматически сгенерирован файл base.scss. Этот файл можно легко импортировать в ваш проект для доступа к общим стилям и переменным.

Более подробно с релизом можно ознакомиться по ссылке

Обновили gds до 3.1.3

Версия gds 3.1.3 была выпущена с обновленными зависимостями peerDependencies до последних версий и добавлена новая функциональность для генерации токенов в формате SCSS модулей.
Более подробно можно ознакомиться по ссылке

В Ensi был внедрен новый компонент для создания списка - ListBuilder. Компонент объединяет все основные функции, связанные с листингом, в одном месте, что значительно ускоряет и упрощает процесс разработки страницы.

Для детального изучения можно посетить следующую ссылку

Логирование запросов в Elasticsearch

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

Для добавления необходимо:
1. Добавить новый канал в config/logging.php
2. Добавить в config/laravel\-elastic\-query.php:
- для v8:

'http\_client' => GuzzleHttp\Client::class, 'http\_client\_options' => [My\HttpClientOptionsBuilder::class, 'getHttpClientOptions']

- для v7:

'handler' => [My\ClientHandlerBuilder::class, 'build']

1. Создать
   My\HttpClientOptionsBuilder::class

- для v8:
Можно забрать как есть в ensi
- для v7:
Реализация сильно отличается, см. в приложенном файле

Обработка Laravel Queue Job на контуре с несколькими площадками

Проблема: Если в одном контуре развёрнуто несколько копий одного сервиса (при работе по концепции feature-стендов), то разные копии воркера будут бороться за выполнение Job из очереди. В итоге усложняется процесс отладки, поиска логов и т.д.

Эту проблему обходили за счёт добавления APP_STAGE в название очереди и ручного изменения этой переменной при необходимости

Теперь есть более целостное решение: в префикс очередей автоматически добавляется название текущей git ветки (env GIT_BRANCH). Локально и на проде это всегда master, а вот на стендах этот env можно автоматически заполнять текущей веткой.

Таким образом любая копия сервиса на одном стенде будет всегда сама обрабатывать свой Job.

Чтобы забрать себе изменения необходимо:
1. Внести правки в конфиг config/database.php
2. Добавить на ci/cd автоматическое заполнение этого env. Если у вас Jenkins, то используйте пример из ПР выше
3. Убрать ручное добавление APP_STAGE в названия очередей из сервиса и из helm-values