Ensi Dev News

Небольшое обновление elc-workspace: сервисы admin-gui-frontend и seller-gui-fronend теперь запускаются в dev режиме - с hot-reload.

Репозиторий сервиса customer-api-gateway переведён в read-only.
Актуальная версия этого сервиса теперь написана на golang и находится в репозитории customer-api-gateway-go.

Для golang создан свой раздел на docs.ensi.tech

Выпущена версия ELC 1.1.0

Основное изменение - добавлена поддержка git worktrees.
Можно вытащить ветку в отдельную папку, не теряя возможности выполнять в ней команды вроде elc start и elc exec.

elc wt add task-123  # создать worktree
elc wt launch -b task-123 opencode  # создать worktree и запустить в его папке opencode

Цель: запускать ИИ-агентов в изолированных ветках для параллельного выполнения задач без конфликтов.

Выпущена версия ELC 1.0.0

Существенное изменение только одно - установка и обновление через homebrew, работает одинаково для linux и mac.
Обновлены зависимости, исправлен мелкий баг.

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

Логирование действий пользователя админ-панели

В систему добавлен новый сервис для хранения логов действий пользователей админ-панели.

Запись о действии содержит:
- имя и логин того кто его выполнил
- время
- тип действия: вход, обновление сущности, запуск импорта и т.д.
- тип изменяемой сущности: товар, заказ и т.д.
- ID изменяемой сущности
- Title изменяемой сущности
- Payload с дополнительными данными о событии, специфичными для конкретного действия

Сервис рассчитан на работу с несколькими админ-панелями, например можно подключить дополнительно аудит действий в ЛК продавца.

Ссылки:
- https://gitlab.com/greensight/ensi/units/action-audit
- https://gitlab.com/greensight/ensi/packages/action-audit-event-producer
- https://docs.ensi.tech/backend-guides/principles/audit-events

Пакет @ensi-platform/typescript-openapi-generator официально выпущен!

Основные изменения:

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

Более подробную информацию обо всех изменениях вы можете найти в документации к пакету.

Обновили GDS до 4.1.5
- Изменена точка входа, теперь @greensight/gds ведет на @greensight/gds/scss

Обновили GDS до 4.1.3
- Для компонентов GridLayout/FlexLayout был исправлен проп ref

Обновили Laravel до 11 версии, т.е теперь:

1. Все наши composer пакеты поддерживают 11 версию
2. Обновлены сами сервисы

Для обновления платформы нужно:
1. Обновить openapi-client-generator-php-templates и обновить все клиенты
2. Обновить сервисы
3. В Auth сервисах дополнительно нужно поправить app/Providers/AuthServiceProvider.php
4. В сервисах customer-api-gateway/gui-backend (т.е. в сервисах, использующих Illuminate\Contracts\Auth\UserProvider и Illuminate\Contracts\Auth\Authenticatable) нужно добавить новые методы


Гайд самого ларавель можно посмотреть тут

Обратите особое внимание на то что теперь а) в миграциях при изменениях колонки должны быть указаны не только изменения, а весь набор модификаторов б) в Carbon методы diffIn* возвращают float в) удалены методы unsignedDecimal, unsignedDouble и unsignedFloat в миграциях

Список ПР по всем сервисам тут

Обновление GDS v4.1.0

- Реализован функционал инициализации конфигурационного файла gds.config.json
- Добавлена поддержка градиентов в дизайн-системе
- Введена возможность использования директивы @layer для SCSS компонентов
- Произошли соответствующие изменения в структуре и содержании gds.config.json

Из-за добавления поддержки @layer для SCSS компонентов произошли некоторые изменения в структуре конфигурационного файла:

- Добавлено новое поле scss для настройки SCSS компонентов
- Поле scssDir переименовано в scss.dir
- Эти изменения подготовили основу для возможных будущих расширений функциональности SCSS компонентов

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 4.0.0.
Пакет был разделен на 2 части:
- emotion
- scss
Обновили зависимости.

Одним из значительных улучшений является то, что теперь пакет совместим с app router в Next.js, а также стили больше не компилируются во время выполнения, благодаря переписыванию компонентов на scss. Это означает, что все новые компоненты теперь используют чистый CSS после итоговой копиляции, что значительно упрощает их интеграцию и улучшает перформанс.

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

Пакет 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.7

Было пофикшено несколько багов + переименовали функции.
В 3.1.7 появилась возможность генерировать файл с классами для типографии на основе токенов, что позволит изменять типографию в компонентах через пропы.
Более подробно с релизами можно ознакомиться по ссылке

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

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

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

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