Информация, необходимая для установки программного обеспечения «МойСоюз»
| Наименование | МойСоюз |
| Версия | 2.3.9 |
| Правообладатель | ООО «ЯППИКС», ОГРН 1267700040684, ИНН 9707055804 |
| Способ распространения | Облачный сервис (SaaS) по адресу https://myunion.pro |
Программа состоит из серверной части и клиентской части, которая работает в браузере. Серверная часть установлена на серверах правообладателя. Пользователю и организации устанавливать ничего не нужно: работа ведётся через браузер, размещение, обновление и резервное копирование выполняет правообладатель.
Разделы 1–5 описывают начало работы пользователя. Раздел 6 описывает установку серверной части: по этому порядку развёрнут экземпляр программы по адресу https://myunion.pro. Для экспертной проверки дистрибутив серверной части с демонстрационной базой данных можно скачать на странице https://myunion.pro/dokumentaciya/distributiv по логину и паролю, указанным в заявлении.
1. Требования к рабочему месту
- компьютер, ноутбук, планшет или смартфон с доступом в Интернет;
- современный браузер: Яндекс Браузер, Chrome, Edge, Firefox или Safari актуальной версии;
- включённые JavaScript и cookie;
- адрес электронной почты для входа;
- для push-уведомлений — разрешение уведомлений в браузере.
Дополнительное программное обеспечение, плагины и драйверы не нужны.
2. Порядок начала работы
2.1. Член профсоюза
- Открыть в браузере https://myunion.pro и нажать «Войти».
- Указать адрес электронной почты. На почту придёт шестизначный код, его нужно ввести на странице входа. При первом входе учётная запись создаётся автоматически.
- Заполнить профиль и место работы.
- Подать заявление о вступлении в профсоюз или дождаться подтверждения членства председателем.
2.2. Организация (председатель, аппарат)
- Оставить заявку на подключение организации на странице https://myunion.pro/for-organizations или по адресу sales@yappix.ru.
- Правообладатель подключает организацию и назначает председателя.
- Председатель входит по электронной почте, как описано в п. 2.1, и получает доступ к кабинету организации.
- Председатель добавляет сотрудников аппарата в разделе «Сотрудники». Приглашение приходит сотруднику на почту.
3. Установка на главный экран (по желанию)
Сервис можно открыть как приложение с главного экрана смартфона:
- Android (Chrome, Яндекс Браузер): меню браузера → «Добавить на главный экран»;
- iOS (Safari): «Поделиться» → «На экран „Домой“».
4. Проверка готовности к работе
- Страница https://myunion.pro открывается в браузере.
- Код входа приходит на почту, после ввода кода открывается личный кабинет.
- В меню слева доступны разделы, соответствующие роли пользователя.
Если код не приходит, проверьте папку «Спам» и правильность адреса.
5. Поддержка при подключении
- Техническая поддержка: support@myunion.pro
- Подключение организации: sales@yappix.ru, +7 995 095-55-93
- Режим работы: пн–пт, 09:00–18:00 (Москва)
6. Установка серверной части
Установку выполняет администратор сервера с правами root. Команды приведены для Ubuntu 22.04 LTS.
6.1. Состав серверной части
- веб-приложение на Next.js: интерфейс и программный интерфейс (API), порт 3004;
- сервер сообщений реального времени на Socket.IO: чаты и уведомления, порт 3005;
- база данных PostgreSQL;
- фоновые задания по расписанию (cron): сроки документооборота и обращений, напоминания о задачах, рассылки, обновление скидок;
- Nginx: приём запросов по HTTPS и передача их приложению и серверу сообщений.
6.2. Требования к серверу
| Параметр | Значение |
|---|---|
| Процессор | от 4 ядер (vCPU), архитектура x86-64 |
| Оперативная память | от 8 ГБ |
| Диск | от 40 ГБ, SSD |
| Операционная система | Ubuntu 22.04 LTS |
| Сеть | доступ в Интернет, открытые порты 80 и 443, доменное имя |
| Программное обеспечение | Версия | Назначение |
|---|---|---|
| Node.js | 22 LTS | среда выполнения серверной части |
| pnpm | 9 и выше | установка зависимостей, сборка и запуск |
| PostgreSQL | 17 | база данных |
| PM2 | актуальная | запуск процессов и автозапуск после перезагрузки |
| Nginx | 1.18 и выше | HTTPS и передача запросов приложению |
| Certbot | актуальная | сертификат HTTPS Let's Encrypt |
| Git | актуальная | получение исходного кода |
| Chrome для Puppeteer | устанавливается в п. 6.4 | формирование PDF-документов |
6.3. Подготовка сервера
Установить системные пакеты, Node.js 22, pnpm и PM2:
apt update
apt install -y git curl nginx certbot python3-certbot-nginx
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs
npm install -g pnpm pm2
Установить библиотеки, необходимые для запуска Chrome при формировании PDF:
apt install -y ca-certificates fonts-liberation libnss3 libatk1.0-0 libgbm1 libgtk-3-0 libx11-6 libxcb1 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libdrm2 libasound2 libpango-1.0-0 libcups2 libdbus-1-3 libglib2.0-0
Установить PostgreSQL 17 из официального репозитория PostgreSQL и создать базу данных:
apt install -y postgresql-common
/usr/share/postgresql-common/pgdg/apt.postgresql.org.sh -y
apt install -y postgresql-17
sudo -u postgres psql -c "CREATE USER myunion WITH PASSWORD '<пароль>';"
sudo -u postgres psql -c "CREATE DATABASE myunion_db OWNER myunion;"
6.4. Порядок установки
- Скачать дистрибутив
myunion-2.3.9.tar.gzна странице https://myunion.pro/dokumentaciya/distributiv и распаковать его в каталог/opt/my-union-pro. В архиве исходный код программы, демонстрационная база данныхdb/myunion-demo.dumpи файлREADME.mdс учётными записями демонстрационной базы.
mkdir -p /opt/my-union-pro
tar -xzf myunion-2.3.9.tar.gz --strip-components=1 -C /opt/my-union-pro
cd /opt/my-union-pro
- Установить зависимости. Вместе с ними формируется клиент базы данных Prisma.
pnpm install --frozen-lockfile
- Создать файл настроек
.env.localиз шаблона и заполнить параметры из таблицы ниже. Параметры, которые начинаются сNEXT_PUBLIC_, учитываются при сборке, поэтому файл заполняется до сборки.
cp .env.example .env.local
| Параметр | Значение |
|---|---|
DATABASE_URL | postgresql://myunion:<пароль>@127.0.0.1:5432/myunion_db |
NEXTAUTH_URL, NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_SOCKET_URL | https://<домен> |
NEXTAUTH_SECRET | случайная строка, команда openssl rand -base64 32 |
HEALTH_ENCRYPTION_KEY, EDO_ENCRYPTION_KEY | ключи шифрования сведений о здоровье и файлов документооборота, команда openssl rand -base64 32 для каждого |
SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, SMTP_FROM | почтовый сервер для отправки кодов входа и уведомлений |
TZ | Europe/Moscow |
Копию ключей шифрования храните отдельно от сервера: без ключа зашифрованные данные восстановить нельзя.
- Восстановить базу данных из дистрибутива: структуру, историю изменений структуры и демонстрационные данные. Команда запросит пароль пользователя
myunionиз п. 6.3.
pg_restore --no-owner --no-acl -h 127.0.0.1 -U myunion -d myunion_db db/myunion-demo.dump
- Установить Chrome для формирования PDF:
npx puppeteer browsers install chrome
- Собрать приложение. Ограничения памяти и потоков нужны, чтобы сборка укладывалась в 8 ГБ оперативной памяти:
CIRCLE_NODE_TOTAL=2 TOKIO_WORKER_THREADS=2 NODE_OPTIONS=--max-old-space-size=3072 pnpm build
- Запустить веб-приложение и сервер сообщений под управлением PM2 и включить автозапуск:
pm2 start "pnpm start" --name my-union-pro
pm2 start "pnpm socket" --name my-union-socket
pm2 save
pm2 startup
- Включить фоновые задания по расписанию:
APP_ROOT=/opt/my-union-pro bash scripts/setup-cron.sh
- Настроить Nginx: создать файл
/etc/nginx/sites-available/myunionс содержимым ниже, подставив свой домен.
server {
listen 80;
server_name <домен>;
client_max_body_size 100M;
location /socket.io/ {
proxy_pass http://127.0.0.1:3005/socket.io/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 86400;
}
location / {
proxy_pass http://127.0.0.1:3004;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 300s;
proxy_connect_timeout 60s;
}
}
- Включить сайт и получить сертификат HTTPS:
ln -s /etc/nginx/sites-available/myunion /etc/nginx/sites-enabled/myunion
nginx -t && systemctl reload nginx
certbot --nginx -d <домен>
6.5. Проверка установки
- Команда
pm2 listпоказывает процессыmy-union-proиmy-union-socketв состоянииonline. - Команда
curl -I https://<домен>возвращает код200. - Страница
https://<домен>открывается в браузере. После входа по коду из письма открывается личный кабинет. Адреса учётных записей демонстрационной базы во всех ролях приведены в файлеREADME.mdдистрибутива. - Сообщение в чате доходит до собеседника без перезагрузки страницы: сервер сообщений работает.
- При ошибках смотрите журналы:
pm2 logs my-union-pro --lines 100иpm2 logs my-union-socket --lines 100.
6.6. Обновление
Перед обновлением сделайте резервную копию базы данных:
sudo -u postgres pg_dump -Fc myunion_db > /root/myunion_db-$(date +%F).dump
Обновление до новой версии: распаковать архив новой версии поверх каталога программы (файл .env.local и каталог storage сохраняются), затем установить зависимости, применить изменения структуры базы данных, собрать и перезапустить приложение:
cd /opt/my-union-pro
tar -xzf myunion-<версия>.tar.gz --strip-components=1 -C /opt/my-union-pro
pnpm install --frozen-lockfile
pnpm prisma migrate deploy
rm -rf .next
CIRCLE_NODE_TOTAL=2 TOKIO_WORKER_THREADS=2 NODE_OPTIONS=--max-old-space-size=3072 pnpm build
pm2 restart my-union-pro --update-env
pm2 restart my-union-socket --update-env
pm2 save
Команда pnpm prisma migrate deploy применяет только новые изменения структуры базы данных, данные сохраняются. После обновления выполните проверку по п. 6.5.