Обновление 3.21: различия между версиями

Текущая версия от 07:48, 19 мая 2026

en | uk | ru

Версия: 3.21

Требуется версия: 3.12 и выше

Несколько слов от автора

Сделан архитектурный переход от числовых идентификаторов объектов (ID) к строковым идентификаторам (UUID). Для многих типов объектов - старый ID остался для удобства (например "Задание №7562" удобнее чем "Задание №ae4ae420-7643-4572-a752-9ecfdbeca371"). Но внутри базы и ядра - привязка идёт по UUID. Кроме прочего это даёт возможность чуть позже сделать следующий шаг - возможность объединения нескольких систем в одну при необходимости. Очень важно - так как такая миграция ID/UUID затрагивает практически всю базу (и часто неоднократно) то после завершения обновления необходимо сделать FULL VACUUM. Без этого шага всё будет работать очень медленно. Также стоит учесть, что на большой базе обновление/миграция может занимать часы.

Проведён глубокий рефакторинг и обновление UI/UX. Исключена т.н. "мобильная версия" как таковая и сделан упор на комфортный внешний вид в мобильных устройствах.

У нас появилась/переработана/документирована событийная система Internal API v2. Версия v1 пока поддерживается (custom_api.php) но постепенно переходите на v2.

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

Наша группа в Telegram для взаимного общения клиентов между собой: https://t.me/usersideeu и канал для новостей: https://t.me/userside

Особенности в проведении обновления

Если вы обновляетесь с версии 3.10 - ознакомьтесь со страницей: Обновление 3.11

Если вы обновляетесь с версии 3.11 и ранее - ознакомьтесь со страницей: Обновление 3.12

Если вы обновляетесь с версии 3.12 и ранее - ознакомьтесь со страницей: Обновление 3.13

Если вы обновляетесь с версии 3.13 и ранее - ознакомьтесь со страницей: Обновление 3.14

Если вы обновляетесь с версии 3.14 и ранее - ознакомьтесь со страницей: Обновление 3.15

Если вы обновляетесь с версии 3.15 и ранее - ознакомьтесь со страницей: Обновление 3.16

Если вы обновляетесь с версии 3.16 и ранее - ознакомьтесь со страницей: Обновление 3.17

Если вы обновляетесь с версии 3.17 и ранее - ознакомьтесь со страницей: Обновление 3.18

Если вы обновляетесь с версии 3.18 и ранее - ознакомьтесь со страницей: Обновление 3.19

Если вы обновляетесь с версии 3.19 и ранее - ознакомьтесь со страницей: Обновление 3.20

Перенесите/удалите посторонние файлы, каталоги и прочее из директории userside. Там должны находится только дистрибутивные файлы самой системы и файлы, которые система создает во время своей работы. Модули userside (usm) также не должны там хранится. Используйте отдельные каталоги для них (например, /opt/userside). Посторонние файлы из директории userside могут быть удалены в процессе обновления

Версия 3.21 требует PHP версии 8.4. Остальные требования остаются такими же как для версии 3.20

С помощью автоматического инсталлятора выполните обновление:

curl -fsSL https://my.userside.eu/install.sh | sudo -u www-data bash
sudo -u www-data ./installer install

Обязательно выполните FULL VACUUM после обновления

Не забудьте обновить все модули на их свежие версии

Возможно часть сохранённых пользовательских фильтров собьётся (в списке абонентов, заданий...), т.к. поменялись как ID/UUID так и расширены возможности фильтрации очень сильно. Их необходимо будет перенастроить по-новой.

Список изменений: просмотреть

Проведение обновления: инструкция

@@ Строка 1: / Строка 1: @@
-[[Upgrade_3.21|en]] | [[Обновление_3.21_UK|uk]] | '''ru'''
+[[Upgrade_3.21|en]] | [[Оновлення_3.21|uk]] | '''ru'''
 Версия: '''[[3.21]]'''
@@ Строка 6: / Строка 6: @@
 == Несколько слов от автора ==
-*
+* Сделан архитектурный переход от числовых идентификаторов объектов ''(ID)'' к строковым идентификаторам ''(UUID)''. Для многих типов объектов - старый ID остался для удобства ''(например "Задание №7562" удобнее чем "Задание №ae4ae420-7643-4572-a752-9ecfdbeca371")''. Но внутри базы и ядра - привязка идёт по UUID. Кроме прочего это даёт возможность чуть позже сделать следующий шаг - возможность объединения нескольких систем в одну при необходимости. '''Очень важно''' - так как такая миграция ID/UUID затрагивает практически всю базу ''(и часто неоднократно)'' то после завершения обновления необходимо сделать FULL VACUUM. Без этого шага всё будет работать очень медленно. Также стоит учесть, что на большой базе '''обновление/миграция может занимать часы'''.
+* Проведён глубокий рефакторинг и обновление UI/UX. Исключена т.н. "мобильная версия" как таковая и сделан упор на комфортный внешний вид в мобильных устройствах.
+* У нас появилась/переработана/документирована событийная система Internal API v2. Версия v1 пока поддерживается ''(custom_api.php)'' но постепенно переходите на v2.
 * [[Обновление]]. '''Рекомендую иметь два инстанса системы'''. Отдельно действующую и отдельно тестовую. На тестовой вы можете периодически обновлять базу данных с действующей системы и проводить обновление, убеждаясь, что всё работает, ознакомиться с нововведениями или выявлять моменты, которые у вас перестали работать.
@@ Строка 35: / Строка 40: @@
 * Перенесите/удалите посторонние файлы, каталоги и прочее из директории userside. Там должны находится только дистрибутивные файлы самой системы и файлы, которые система создает во время своей работы. Модули userside (usm) также не должны там хранится. Используйте отдельные каталоги для них (например, /opt/userside). Посторонние файлы из директории userside могут быть удалены в процессе обновления
+* Версия 3.21 требует PHP версии 8.4. Остальные требования остаются такими же как для версии 3.20
 * С помощью автоматического [[Инсталлятор|инсталлятора]] выполните [[Обновление|обновление]]:
- sudo -u www-data php userside_install.phar install
+<pre>
+curl -fsSL https://my.userside.eu/install.sh | sudo -u www-data bash
+sudo -u www-data ./installer install
+</pre>
+* '''Обязательно выполните FULL VACUUM после обновления'''
 * Не забудьте обновить все модули на их свежие версии
+* Возможно часть сохранённых пользовательских фильтров собьётся ''(в списке абонентов, заданий...)'', т.к. поменялись как ID/UUID так и расширены возможности фильтрации очень сильно. Их необходимо будет перенастроить по-новой.
 '''Список изменений:''' [[3.21|просмотреть]]
 '''Проведение обновления:''' [[Обновление|инструкция]]