====== Функциональные характеристики ПО “OdgAssist” ======

**Общая информация**

Программное обеспечение OdgAssist (EQMS) предназначено для автоматизации и управления документацией в области качества.  Под документацией понимаются:

  * бумажные документы – заполняемые формы, бумажные журналы; 
  * электронные текстовые документы – инструкции, процедуры и т.д; 
  * электронные документы с функцией контроля – отклонения, изменения, CAPA и т.д. 
  *

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

**Рекомендуемые системные требования для программного комплекса odgAssist**

**Требования к аппаратному обеспечению сервера:**

^ Конкурентных пользователей ^ CPU, vCPU ^ RAM, ГБ (DDR4) ^ SSD, ГБ ^
| 10 | 10 | 20 | 300 |
| 25 | 12 | 20 | 300 |
| 50 | 20 | 32 | 300 |
| 75 | 24 | 48 | 320 |
| 100 | 30 | 60 | 450 |
| 150 | 44 | 84 | 500 |
| 200 | 54 | 112 | 800 |
| 250 | 68 | 136 | 1000 |

Рекомендовано использование RAID для обеспечения резервирования и повышения производительности базы данных.

**Требования к программному обеспечению сервера:**

  * Операционная система: Linux Ubuntu  24.04 и выше
  * Сервер базы данных: Postgresql 16 +
  * Виртуальная машина:  OpenJDK 8u502 +
  * WEB сервер: Nginx 1.24.0 +
  * Менеджер управления процессами: Supervisor 4.2.5 +
  * Интерпретатор языка Python: Python 3.12.3

**Минимальные требования к программно-аппаратному обеспечению рабочей станции пользователя:**

  * Процессор: 4-х ядерный, 2ГГц
  * Оперативная память 4ГБ
  * Жесткий диск (SATA): 50Гб
  * Операционная система: Windows 8/10/11
  * Браузер: Google Chrome 154.0.8037.97 +
  * Microsoft Office: Word, Excell  2016 +

+  допустима версия ПО выше указанной

Для обслуживания сервера сотрудниками исполнителя к нему необходим прямой доступ по ssh.  Сервер должен иметь доступ в интернет.

====== Установка odgassist 5.0 ======



===== Установка приложения на UBUNTU 24.04: =====

Для работы приложения odgassist необходимы следующие программы: \\  -Postgres 16 \\  -Nginx \\  -Supervisor \\  -Open jdk 8 \\

Команды для установки требуемого программного обеспечения: \\  Обновить и установить пакеты программного обеспечения: \\

<code ->
sudo apt-get update &&  sudo apt-get -y upgrade;
</code>

=== Установка Java ===
Установить openjdk: \\

<code ->
sudo apt-get install -y openjdk-8-jdk
</code>

Проверить <code bash> java -version </code>

=== Настройка русской локали === 
Проверить наличие русской локали:  \\

<code -> locale -a | grep ru_RU  </code>

Если локали нет — установить языковой пакет

<code bash>  sudo apt-get install language-pack-ru;  </code>

Сгенерировать локаль:
<code bash> sudo locale-gen ru_RU.UTF-8 </code>

Перезапустить сервер для обновления локали.

=== Установка Postgres 16 === 

<code bash> sudo apt install -y postgresql-16 postgresql-client-16 </code>

Проверить статус
<code bash> sudo systemctl status postgresql </code>
 
Добавить базу данных для odgassist: \\

<code ->
sudo -u postgres psql -c "CREATE DATABASE \"odgassist\" WITH OWNER \"postgres\" ENCODING 'UTF8' LC_COLLATE = 'ru_RU.UTF-8' LC_CTYPE = 'ru_RU.UTF-8' TEMPLATE template0;"
sudo -u postgres psql -c "ALTER USER postgres PASSWORD 'ваш_пароль';"
</code>

=== Установка NGINX ===

Установить nginx: \\
<code bash> sudo apt install -y nginx  </code>

Проверить:
<code bash> sudo systemctl status nginx </code>

=== Установка supervisor ===

Установить supervisor: \\
<code bash> sudo apt -y install supervisor; </code>

Проверить статус: \\
<code bash> sudo systemctl status supervisor </code>

Добавьте пользователя runner: \\

<code ->
sudo useradd -m -p $(openssl rand -base64 12) runner 
</code>

Добавьте необходимые директории для работы приложения odgassist: \\

<code ->
sudo mkdir /home/dumps && chmod 777 /home/dumps;
sudo mkdir /etc/ssl/cuba && mkdir /etc/ssl/odg;
sudo mkdir /home/runner/cuba && chown runner:runner /home/runner/cuba;
sudo mkdir /home/cuba_jar && chmod 777 /home/cuba_jar;
</code>

Скачайте необходимые файлы для работы приложения odgassist: \\

<code ->
wget https://wiki.odgassist.ru/lib/exe/fetch.php/odg_assist_5.0:app.jar
;
mv odg_assist_5.0:app.jar /home/runner/cuba/app.jar && chown runner:runner /home/runner/cuba/app.jar && chmod +x /home/runner/cuba/app.jar;
 wget https://wiki.odgassist.ru/lib/exe/fetch.php/odg_assist_5.0:nofileonserver.docx && mv odg_assist_5.0:nofileonserver.docx /srv/assist/nofileonserver.docx && sudo chown runner:runner /srv/assist/nofileonserver.docx ;

chown runner:runner /srv/assist/nofileonserver.docx;
</code>

{{ :odg_assist_5.0:nofileonserver.docx }}

Добавьте в конфигурацию supervisor  файл /etc/supervisor/conf.d/cubaodg.conf:

<code bash>
[program:cuba]
command=java -Xms5G -Xmx5G -jar app.jar -port 9090
directory=/home/runner/cuba
stdout_logfile=/var/log/supervisor/cuba.log
stderr_logfile=/var/log/supervisor/cuba.log
autostart=true
user=runner
</code>

Обновите конфигурацию supervisor: \\

<code bash>
sudo supervisorctl reread && sudo supervisorctl update;
sudo supervisorctl status;
</code>

Статус приложения cuba должно быть RUNNING \\

После запуска приложения подождите 5 минут пока производится настройка базы данных.

Затем переходите к следующему [[https://wiki.odgassist.ru/doku.php/odg_assist_5.0:%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_odg#%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F|этапу]]. \\