Информация, необходимая для установки программного обеспечения «МойСоюз»

НаименованиеМойСоюз
Версия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. Член профсоюза

  1. Открыть в браузере https://myunion.pro и нажать «Войти».
  2. Указать адрес электронной почты. На почту придёт шестизначный код, его нужно ввести на странице входа. При первом входе учётная запись создаётся автоматически.
  3. Заполнить профиль и место работы.
  4. Подать заявление о вступлении в профсоюз или дождаться подтверждения членства председателем.

2.2. Организация (председатель, аппарат)

  1. Оставить заявку на подключение организации на странице https://myunion.pro/for-organizations или по адресу sales@yappix.ru.
  2. Правообладатель подключает организацию и назначает председателя.
  3. Председатель входит по электронной почте, как описано в п. 2.1, и получает доступ к кабинету организации.
  4. Председатель добавляет сотрудников аппарата в разделе «Сотрудники». Приглашение приходит сотруднику на почту.

3. Установка на главный экран (по желанию)

Сервис можно открыть как приложение с главного экрана смартфона:

  • Android (Chrome, Яндекс Браузер): меню браузера → «Добавить на главный экран»;
  • iOS (Safari): «Поделиться» → «На экран „Домой“».

4. Проверка готовности к работе

  1. Страница https://myunion.pro открывается в браузере.
  2. Код входа приходит на почту, после ввода кода открывается личный кабинет.
  3. В меню слева доступны разделы, соответствующие роли пользователя.

Если код не приходит, проверьте папку «Спам» и правильность адреса.

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.js22 LTSсреда выполнения серверной части
pnpm9 и вышеустановка зависимостей, сборка и запуск
PostgreSQL17база данных
PM2актуальнаязапуск процессов и автозапуск после перезагрузки
Nginx1.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. Порядок установки

  1. Скачать дистрибутив 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
  1. Установить зависимости. Вместе с ними формируется клиент базы данных Prisma.
pnpm install --frozen-lockfile
  1. Создать файл настроек .env.local из шаблона и заполнить параметры из таблицы ниже. Параметры, которые начинаются с NEXT_PUBLIC_, учитываются при сборке, поэтому файл заполняется до сборки.
cp .env.example .env.local
ПараметрЗначение
DATABASE_URLpostgresql://myunion:<пароль>@127.0.0.1:5432/myunion_db
NEXTAUTH_URL, NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_SOCKET_URLhttps://<домен>
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почтовый сервер для отправки кодов входа и уведомлений
TZEurope/Moscow

Копию ключей шифрования храните отдельно от сервера: без ключа зашифрованные данные восстановить нельзя.

  1. Восстановить базу данных из дистрибутива: структуру, историю изменений структуры и демонстрационные данные. Команда запросит пароль пользователя myunion из п. 6.3.
pg_restore --no-owner --no-acl -h 127.0.0.1 -U myunion -d myunion_db db/myunion-demo.dump
  1. Установить Chrome для формирования PDF:
npx puppeteer browsers install chrome
  1. Собрать приложение. Ограничения памяти и потоков нужны, чтобы сборка укладывалась в 8 ГБ оперативной памяти:
CIRCLE_NODE_TOTAL=2 TOKIO_WORKER_THREADS=2 NODE_OPTIONS=--max-old-space-size=3072 pnpm build
  1. Запустить веб-приложение и сервер сообщений под управлением PM2 и включить автозапуск:
pm2 start "pnpm start" --name my-union-pro
pm2 start "pnpm socket" --name my-union-socket
pm2 save
pm2 startup
  1. Включить фоновые задания по расписанию:
APP_ROOT=/opt/my-union-pro bash scripts/setup-cron.sh
  1. Настроить 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;
    }
}
  1. Включить сайт и получить сертификат HTTPS:
ln -s /etc/nginx/sites-available/myunion /etc/nginx/sites-enabled/myunion
nginx -t && systemctl reload nginx
certbot --nginx -d <домен>

6.5. Проверка установки

  1. Команда pm2 list показывает процессы my-union-pro и my-union-socket в состоянии online.
  2. Команда curl -I https://<домен> возвращает код 200.
  3. Страница https://<домен> открывается в браузере. После входа по коду из письма открывается личный кабинет. Адреса учётных записей демонстрационной базы во всех ролях приведены в файле README.md дистрибутива.
  4. Сообщение в чате доходит до собеседника без перезагрузки страницы: сервер сообщений работает.
  5. При ошибках смотрите журналы: 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.

copyright zbrq7qg64z2qsesl