# Содержание

## Назначение документа

Целью создания данного документа является предоставление информации о конфигурации продукта, в частности, предоставление детализированного описания:

> - созданных объектов
> - произведенных настроек
> - предполагаемого процесса работы в системе согласно назначению продукта.

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

## Методология внедрения

### Получение ресурсов (боевого и тестового стенда)

Характеристики серверов:

- Хранилище Jackrabbit
- Поисковые индексы Lucene
- 16 Гб ОЗУ
- Debian GNU/Linux (jessie, wheezy)
- CPU 8-core
- HDD/SSD с 10Гб свободного дискового пространства.

Предупреждение

Настоятельно рекомендуем развернуть тестовый стенд, полностью дублирующий конфигурацию системы боевого сервера, для диагностики и воспроизведения потенциальных проблем, тестирования обновления и изменений конфигурации.

### Установка и настройка системы

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

### Кастомизация процессов по факту выявленных пожеланий

1. Для выявления пожеланий по изменению стандартной конфигурации продукта, устанавливаемой по-умолчанию, рекомендуется провести демонстрацию всем заинтересованным лицам проекта, в том числе, конечным пользователем: сотрудникам первой и второй линии.
2. Все пожелания/замечания к продукту должны быть задокументированы и проанализированы на сложность и сроки адаптации продукта под данные требования.
3. В качестве вспомогательного инструмента к определению необходимых настроек в системе для реализации тех или иных пожеланий, рекомендуется ознакомиться со Структурой продукта, а также Руководством разработчика

Предупреждение

Настоятельно рекомендуем провести полное тестирование всех процессов, после произведения настроек конфигурации.

### Обучение сотрудников работе в системе

1. Все сотрудники организации, которым в рамках проекта предполагается обучение, могут быть объединены в группы согласно осуществляемым ими ролям (диспетчеры, исполнители и т.д.)
2. Рекомендуем адаптировать руководство пользователя, представленное по-умолчанию, согласно произведенным изменениям конфигурации, оргстукртуе компании и прочей специфики проекта.
3. В первую очередь, должны быть обучены сотрудники, исполняющие основные роли в процессах, попадающих под опытную эксплуатацию

### Опытная эксплуатация

1. Процесс опытной эксплуатации представляет собой имитацию полноценной работы системы в боевом режиме, но в меньших масштабах. Это может быть прогон основных боевых процессов на выделенном подразделении или на определенной категории документов.
2. Продолжительность процесса опытной эксплуатации зависит от масштабов проекта и количество внедряемых одновременно процессов.
3. Результатом опытной эксплуатации должен являться подтвержденный всеми заинтересованными сторонами факт готовности системы к использованию в промышленном режиме.
4. В случае выявления замечаний в ходе опытной эксплуатации, должны быть произведены соответствующие настройки в системе и измененные процессы должны быть протестированы повторно.

Примечание

Рекомендуем адаптировать руководство пользователя, представленное по-умолчанию, согласно произведенным изменениям конфигурации, оргстукртуе компании и прочей специфики проекта.

### Запуск в промышленную эксплуатацию

## Инструкция по установке Arta Synergy Service

### Предварительные требования

Важно! Для работы системы требуется:

- установить Arta Synergy 4.1 minsky (инструкция по установке)
- в подсистеме администрирования обновить БД и процессы.

### Подключение репозиториев

Установочный пакет находится в репозитории product-stable. В файле `/etc/apt/sources.list` необходимо добавить либо раскомментировать следующую строку:

`deb http://deb.arta.kz/tengri product-stable main contrib non-free`

### Установка приложения

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

    # apt-get update
    # apt-get install arta-synergy-apps-service

В ходе установки необходимо выбрать тип установки из предложенного списка

Примечание

1. Вариант `Clean` полностью удаляет все ранее установленные данные Synergy, устанавливает приложение Synergy Project, автоматически загружает его конфигурацию и загружает дампы базы данных.
2. Вариант `Install/Upgrade Configuration` устанавливает приложение Synergy Project, автоматически загружает его конфигурацию и настраивает необходимые конфигурационные файлы.
3. Вариант `Manual` устанавливает приложение Synergy Project без автоматической загрузки конфигурации (т.е. только заменяет `war`-файлы).

Дальнейший ход установки зависит от выбранного типа установки:

- для варианта `Clean`:

  > - указать URL сервера Synergy, на котором производится работа (например: `http://192.168.0.187:8080/Synergy`)
  > - ввести пароль пользователя, имеющего root-права mysql, от имени которого будут применены дампы базы данных
  > - после завершения установки обязательно нужно выполнить полную переиндексацию форм, файлов и документов в Административном приложении Synergy.

- для вариантов `Install/Upgrade Configuration` и `Manual`:

  > - указать URL сервера Synergy, на котором производится работа (например: `http://192.168.0.187:8080/Synergy`):
  > - ввести последовательно логин и пароль Системного пользователя:

Внимание

Для предотвращения дальнейшей нечаянной установки нестабильных версий пакетов из репозитория `unstable`, после установки пакета `arta-synergy-apps-project` рекомендуется закомментировать этот репозиторий в файле `/etc/apt/sources.list`.

После установки приложения обязательно выполнить пункты (Инструкция по первичной настройке)

## Инструкция по первичной настройке

### В конфигураторе

1. Внести организационную структуру.

Обязательно должны присутствовать сотрудники с ролями:

- Диспетчер
- Исполнитель

2. В организационной структуре обязательно должна присутствовать должность Клиент с кодом `service_clients`

4. Добавить пользователей в группы `service_admin_group` и `service_client_group` и/или настроить и разграничить права на реестры по потребности.
5. Создать формы и реестры на виды услуг в папке `orders` в конфигурации

Примечание

Не рекомендуется использовать созданные для примере order1…order6 так как при обновлении ваши изменения на этих формах могут быть потеряны.

6. Создать формы завершения (В дополнительных настройках конфигуратора), ссылаясь на созданные формы: Форма завершения заявки и Форма подтверждения заявки (формы созданные по-умолчанию расположены в папке `orders`).
7. Проверить корректность указанных форм завершения (для автоматического перехода на следующий этап все формы завершения имеют опцию «не требовать подтверждения») для этапов в маршрутах реестра.

### В пользовательской подсистеме SYNERGY

1. Заполнить реестр Услуги, указав коды форм и реестров, созданных в конфигураторе
2. Заполнить реестры Типы активов, Активы, Исполнители, Локации.

## Структура продукта

### Как все устроено

Система Synergy Service реализована на базе платформы ARTA SYNERGY, путем создания конфигурации, допускающей гибкую настройку объектов: форм, маршрутов, статусов и пр…

В системе Synergy Service реализованы следующие глобальные процессы и их подпроцессы:

- Портал самообслуживания
- Диспетчеризация заявок
- Исполнение заявок
- Управление каталогами услуг, активов, исполнителей

В конфигураторе приложение `SynergyService` состоит из следующих папок:

- `assets` - Активы и Локации
    - Справочник видов активов
    - Формы, реестры Активов
    - Формы, реестры Локаций
- `clients` - объекты Документооборота
    - Форма и реестр карточки клиента
- `orders` - Группы пользователей
    - ``interpreter_scripts``Скрипты для автоматической смены статусов
    - Папки на каждую услугу, содержащие форму и реестр (в конфигурации по-умолчанию - их 6)
    - Формы завршения заявки и подтверждения завершения заявки
    - Счетчик и шаблон номера
    - Справочник статусов исполнения заявок
- `performers`
    - Форма и реестр карточек исполнителей
    - Форма и реестр навыков исполнителей
    - Форма и реестр полей исполнителей
- `services` - Услуги
    - Форма и реестр услуг
- Группы:
    - `SynergyService` - группа для объединения всех реестров
    - `service_admin_group` - группа пользователей с полным доступом
    - `service_client_group` - группа пользователей на портал (клиенты)

В конструкторе приложение `SynergyService` состоит из следующих страниц:

- `auth_page` - Авторизация
- `main_page` - Главная
- `my_orders` - Мои заявки
- `registration_page` - Регистрация

Read the Docs v: latest

Versions
  latest
  service-1.9
  service-1.8
  service-1.7
  service-1.6
  service-1.5
  service-1.4
  service-1.3

Downloads
  pdf
  docx
  htmlzip
  epub

On Read the Docs
  Project Home
  Builds

Free document hosting provided by Read the Docs.