User Documentation — Structure

1. Назначение

Платформа РхР предназначени для объединения продуктовых предложений СК, партнеров в единый каталог,

Платформа РхР позволяет решить следующие задачи:

• Создание единого каталога продуктов и поддержание его у актуальном состоянии
• Настройка страховых тарифов
• Настройка печатных форм
• Быстрое подключение API партнеров
• Обеспечение гибкой функциональности, разграничение прав доступа

2. Key Concepts (Business Overview)

Данный раздел описывает ключевые бизнес-понятия системы и их назначение. Он предназначен для бизнес-пользователей, владельцев продукта и аналитиков и не требует технических знаний.

Назначение системы

Система предназначена для поддержки полного жизненного цикла страховых договоров — от настройки продуктов и работы с клиентами до выпуска полисов, расчёта комиссий и формирования печатных документов.

Система обеспечивает:

• единое рабочее пространство для страховых агентов и сотрудников,
• единые правила управления доступом и полномочиями,
• централизованное управление страховыми продуктами,
• прозрачность и контролируемость бизнес-процессов.

Организационная модель

Account (Организационная единица)

Account — это организационная структура компании (агентство, филиал, подразделение).

Основные принципы:

1. Accounts образуют иерархию (дерево), аналогично organizational units в Guidewire.
2. Правила и настройки могут наследоваться от родительских Account.
3. Account используется как базовый контекст для:

• управления доступом,
• продуктовых правил
• комиссионных схем.

User (Пользователь)

User — это человек, работающий в системе (агент, менеджер, администратор). Важно:

• пользователь всегда работает в контексте Account,
• пользователь не владеет бизнес-данными напрямую,
• его права определяются ролью в Account.

Role (Роль)

Role определяет, какие действия пользователь может выполнять в системе (например: просмотр, создание, выпуск, согласование). Ключевая особенность:

1. роли назначаются на Account, а не напрямую на пользователя,
2. фактические полномочия пользователя вычисляются на основе:

• его позиции в иерархии Account,
• правил наследования ролей.

Страховые продукты

Insurance Product (Страховой продукт) Insurance Product описывает страховое предложение компании. Продукт включает:

• страховые покрытия (Coverages),
• страховые суммы и лимиты,
• правила тарификации
• допустимые печатные формы и документы.

Продукт не является договором, а служит основой для его создания.

Product Version (Версия продукта)

Product Version — это зафиксированная версия продукта. Особенности:

1. версия продукта не изменяется после публикации,
2. каждая версия используется для:

• создания договоров,
• валидации данных,
• генерации документов,

1. действующие договоры всегда ссылаются на конкретную версию продукта.

Договор страхования

Policy (Полис / Договор)

Policy — это действующий страховой договор между страховщиком и клиентом.

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

• создаётся на основе конкретной версии продукта,
• содержит структурированные данные договора,
• проходит стандартный жизненный цикл: Draft → Issued → Amended → Terminated.

Draft (Черновик договора)

Draft — это незавершённый договор, находящийся в процессе заполнения. Назначение:

• поэтапный ввод данных,
• проверка правил и ограничений,
• подготовка к выпуску полиса.

Клиенты

Client (Клиент) Client — это страхователь или застрахованное лицо. Особенности:

• клиентские данные могут использоваться в нескольких договорах,
• клиент существует независимо от продукта и полиса,
• поддерживается повторное использование данных клиента.

Комиссии

Commission (Комиссия)

Commission определяет правила вознаграждения агентов и посредников. Комиссия зависит от:

• страхового продукта,
• параметров договора,
• соглашений, привязанных к Account.

Документы и печатные формы

Print Form (Печатная форма)

Print Form — это шаблон документа (PDF или печатная форма), используемый для оформления договора.

Особенности:

• печатные формы версионируются,
• привязываются к продуктам и версиям продуктов,
• формируются на основе данных полиса.

Модель доступа (обзор)

Система использует контекстную модель авторизации.

Решение о доступе принимается на основе:

• пользователя,
• Account,
• выполняемой операции,
• вычисленной роли пользователя.

Это позволяет:

• централизованно управлять доступом,
• избегать жёстко зашитых прав,
• поддерживать сложные организационные структуры.

Мультиарендность (Multi-Tenancy)

Система поддерживает полную изоляцию арендаторов (Tenants):

• каждый Tenant имеет собственные данные,
• доступ к данным невозможен между Tenant,
• контекст Tenant обязателен для любой операции.

3. User Roles & Responsibilities

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

• Системный администратор
• Администратор продуктов
• Бизнес администратор группы
• Бизнес пользователь
• Бизнес пользоватль с ограниченными правами

Роли различаются по набору разрешений и по доступу к данным.

Роль	Описание	Lоступ к бизнес данным
Sys_admin	Создается при установке системы. может создавать новые тенанты и системных администраторов для них.	Доступа к данным нет
Tenant_admin	Системный администратор в рамках своего тенанта. Может администрировать пользователей, добавлять новые интеграции и т.д.	Доступа к данным нет
Product_admin	Управзяет каталогом продуктов в рамках своего тенанта, настраивает тарификацию, правила продажи, выводит продукт в прод.	Доступ только в схеме данных Dev
Group_admin	Бизнес администратор группы пользователей. Может управлять пользователями в рамках своей группы, видит все продажи. Сам продавать не может	Доступ к данным в схеме prod
Accoutn	Бизнес пользователь. Продавец продуктов в рамках страхового портфеля. Может выполнять любые действия с продуктом в рамках своих разрешений.	Доступ к данным в схеме prod
Sub	Пользователь, видит все данные родительского страхового портфеля, но с ограниченными правами на действия.	Доступ к данным в схеме prod

4. Getting Started

(Быстрый старт) Доступ к системе Авторизация Общий обзор интерфейса Навигация

5. Product Configuration

Раздел описывает, как в системе настраиваются страховые продукты, из каких элементов они состоят и как используются при создании договоров.

5.1 Страховой продукт и его жизненный цикл

Что такое страховой продукт

Страховой продукт (Insurance Product)— это формализованное описание страхового предложения компании.

Продукт определяет:

• что страхуется (объекты страхования),
• от каких рисков предоставляется защита,
• на каких условиях заключается договор,
• какие данные должны быть указаны при оформлении,
• какие документы формируются по договору.

Продукт не является договором и не содержит данных конкретного клиента. Он используется как шаблон и набор бизнес-правил для создания полисов.

Жизненный цикл продукта

Каждый продукт проходит стандартный жизненный цикл:

1. Draft (Черновик)

Продукт создаётся и настраивается:

• структура продукта,
• атрибуты,
• покрытия и риски,
• правила и ограничения.

1. Published (Опубликован)

Продукт становится доступным для использования:

• на его основе можно создавать договоры,
• создаётся версия продукта.

1. Deprecated (Устаревший)

Продукт больше не используется для новых договоров, но:

• ранее выпущенные полисы продолжают действовать,
• данные остаются доступными для просмотра и обслуживания.

5.2 Структура страхового продукта

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

Объекты страхования (Insurable Objects)

Объект страхования — это то, что подлежит страховой защите.

Примеры: человек, недвижимое имущество, электронные устройства, перевозки.

Особенности: продукт может содержать один или несколько объектов страхования, каждый объект имеет собственные атрибуты и покрытия, объект страхования определяет контекст для рисков и лимитов. ( в текущей версии продукт ограничен одним объектом страхования )

Атрибуты (Attributes)

Атрибуты — это параметры, описывающие объект страхования или договор в целом.

Примеры атрибутов:

• тип объекта,
• год выпуска,
• страховая сумма,
• территория действия,
• период страхования.

Назначение атрибутов:

• сбор данных при оформлении договора,
• валидация условий,
• участие в расчётах тарифа,
• управление доступными покрытиями.

Атрибуты могут:

• быть обязательными или необязательными,
• иметь ограничения по значениям,
• зависеть от других атрибутов.

Покрытия (Coverages)

Покрытие (Coverage) — это часть страховой защиты, предоставляемой по договору. Покрытие определяет:

• какие риски включены,
• страховые суммы или лимиты,
• франшизы и условия выплаты.

Особенности:

• покрытия привязываются к объектам страхования,
• могут быть обязательными или опциональными,
• могут зависеть от выбранных атрибутов.

Риски (Risks)

Риск — это страховое событие, от наступления которого предоставляется защита.

Примеры:

• пожар,
• кража,
• дорожно-транспортное происшествие,
• гражданская ответственность.

Принципы:

• риски группируются внутри покрытий,
• один риск не существует вне покрытия,
• условия риска влияют на расчёт премии и выплаты.

Связь элементов продукта

В упрощённом виде структура продукта выглядит так: Product Insurable Object Attributes Coverages Risks

Такая модель обеспечивает:

• гибкость настройки продуктов,
• прозрачность для бизнеса,
• масштабируемость при добавлении новых продуктов.

5.3 Версии продукта

При каждом значимом изменении создаётся новая версия продукта.

Принципы:

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

Создание новой версии

Копирование версии

Активация версии

6. Pricing & Calculation

6.1. Введение

Калькулятор — это модуль (движок), который автоматически рассчитывает страховую премию (стоимость полиса) на основе информации о клиенте, объекте страхования и выбранных параметрах риска.

Он работает по принципу "Конструктора": загружает ваши данные → применяет математическую формулу → выдает итоговую стоимость.

6.2. Глоссарий (Ключевые термины)

• Базовый тариф (Rate): Исходная стоимость единицы страховой суммы (например, 0.5% от суммы).
• Страховая сумма (Sum Insured): Максимальный размер выплаты (лимит).
• Страховая премия (Premium): Итоговая цена полиса, которую платит клиент.
• Коэффициент (K): Корректирующий множитель, зависящий от риска (например, возраст водителя, материал стен дома).
• Контекст расчета: Набор вводных данных, которые меняются от договора к договору (возраст, стаж, адрес).
• Константа: Значение, которое не меняется для конкретного продукта (например, базовый процент для данного типа полиса).

6.3. Архитектура тарификации (Как это работает)

Тарификатор использует подход "Контекст + Константы + Таблицы + Формула".

1. Сбор данных: Система берет данные из договора (Контекст расчета).
2. Подстановка: Находит нужные значения в Тарифных таблицах (например, коэффициент региона).
3. Расчет: Подставляет эти числа в формулу.
4. Результат: Вы получаете итоговую премию.

6.4. Компоненты системы

4.1. Контекст расчета (Входные данные)

Это переменные, которые зависят от конкретного запроса на страхование. Они передаются в тарификатор при каждом расчете.

Примеры параметров:

  - Для страхования имущества:* Год постройки дома, Материал стен, Площадь.
  - Для страхования жизни:* Возраст застрахованного, Пол, Наличие хронических заболеваний.
  - Для страхования ТС (каско):* Возраст водителя, Стаж вождения, Мощность авто.

4.2. Константы расчета (Статичные правила)

Это жестко заданные параметры для конкретного продукта или акции. Значения, которые не меняются в процессе расчета или меняются администратором крайне редко.

Примеры:

  - `BASE_RATE`: 0.2 (Базовый процент = 0.2% от суммы).
  - `MIN_PREMIUM`: 500 (Минимальная стоимость полиса в рублях).

4.3. Тарифные таблицы (Справочники коэффициентов)

Используются для поиска коэффициента в зависимости от значения "Контекста". Так же можно использовать для проверки контекста, например допустимого диапазона страховой суммы.

Пример таблицы "Возрастные коэффициенты":

Диапазон возраста (лет)	Коэффициент (K_age)
0 - 25	1.20
26 - 40	1.00
41 - 60	1.10
61+	1.50

Пример таблицы "Диапазон страховых сумм":

Запрашиваемая страховая сумма	Коэффициент (K_region)
1 - 100 000	1
Иначе -1

Если страховая сумма не попадает в диапазон, то пулучится -1, что трактуется калькулятором как недопустимый диапазон.

4.4. Тарифная формула (Алгоритм расчета)

Формула определяет, как именно перемножать или складывать все вышеперечисленные компоненты, чтобы получить премию.

Общий вид: Премия=Страховая сумма×Базовый тариф×Коэффициент A×Коэффициент B×…

5. Примеры использования

5.1. Расчет премии при оформлении договора ( простой тариф )

1. Условие: Премия = 2% * Страховая сумма
2. Настройка:

Добавить константу в калькулятор `BASE_RATE` = 0.02 .
Добавить строку формулы Премия по договору = Страховая сумма объекта страхования * BASE_RATE.

5.2. Расчет премии ( ступенчатый тариф )

1. Условие: Задана тадлицадля расчета премии вида ( мин. страх. сумма, макс. страх. сумма., премия )
2. Настройка:

Добавить тарифную таблицу LookupTableRating  
Первая колонка <= страховой сумме  
Вторая колонка > страховой суммы  
Результана - премия
Добавить формулу 
Премия по договору = `LookupTableRating`

5.3 LookupTableRating

Использование LookupTableRating является иниверсальным способом для расчета премии, получения коэффициентов, проверки допустимого диапазона страховой суммы.

7. Reference Data (Code Lists)

Что такое справочники

Где используются коды

Как коды отображаются в документах

Примеры справочников

8. Policy Lifecycle

8.1 Policy Draft

Создание проекта договора

Изменение данных

Пересчёт

8.2 Policy Issuance

Проверка данных

Выпуск договора

Фиксация данных

8.3 Policy Statuses

Статусы договора

Переходы между статусами

9. Document Generation

9.1 Document Types

Полис

Условия договора

Приложения

9.2 Templates

Что такое шаблон

Версии шаблонов

Связь шаблона с продуктом

9.3 Generated Documents

Когда формируется документ

Как проверить данные

Хранение и повторная генерация

10. Partner & Channel Usage

Работа с внешними партнёрами

Каналы продаж

Ограничения и правила

Ответственность партнёров

11. Errors & Validation Messages

Типы ошибок

Частые причины

Как исправить

📌 Очень важно для поддержки.

12. Audit & Traceability

Как понять, как была рассчитана цена

Как проверить версию продукта

История изменений

13. Best Practices

Рекомендации по настройке продуктов

Типовые ошибки

Советы по управлению версиями

14. FAQ

Часто задаваемые вопросы

Типовые сценарии

15. Glossary

Термины и определения

Бизнес-язык без ИТ

Как это масштабируется

Business users читают 1–9

Partners читают 1–4 + 10

Support читает 11–14

Management читает 1–2