Персоны

Что такое Система Персон?#

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

Архитектура системы персон#

Персона — Центральная сущность#

Основной профиль физического лица в системе
Привязка к организации — каждая персона принадлежит конкретной организации
Статус верификации (is_verified) — подтвержденность личности
Связь с flow-сессиями — отслеживание всех проверок, в которых участвовала персона
Уникальность в рамках организации обеспечивается через систему алиасов
Автоматическое создание системного ID при создании персоны
Поддержка восстановления — возможность восстановить "удаленную" персону

Алиасы — Система идентификации#

Множественные идентификаторы одной персоны для различных способов поиска
Типы алиасов:
- SYSTEM_ID — внутренний UUID, создается автоматически, неизменяемый
- PHONE — номер телефона из eDocument результатов
- PERSONAL_NUMBER — ИИН/персональный номер из документов
- DOCUMENT_NUMBER — номер паспорта или удостоверения личности
- CUSTOM — пользовательские идентификаторы из метаданных
Гарантия уникальности в рамках организации
Защита системных алиасов — нельзя удалить/изменить SYSTEM_ID
Автоматическое извлечение из результатов проверок документов
Проверка конфликтов при добавлении новых алиасов
Поиск и дедупликация — основной механизм предотвращения дубликатов

Фотографии — Мультимедиа профиль#

Различные источники изображений персоны
Типы фотографий по приоритету:
- DIGITAL (приоритет 1) — цифровое фото из чипа документа
- SCAN (приоритет 2) — портрет со сканированного документа
- LIVE (приоритет 3) — лучший кадр с liveness-проверки
- OTHER (приоритет 4) — загруженные вручную фото
Основное фото (is_default) — автоматический выбор по приоритету типа
Защита основного фото — нельзя удалить единственное основное фото
Автоматическое управление — при добавлении фото с высшим приоритетом, оно становится основным

Действия — Аудит и история#

Полное логирование всех операций с персоной
Типы действий:
- Создание персоны
- Изменение статуса верификации
- Операции с алиасами
- Операции с фотографиями
- Удаление персоны
Источники действий:
- FLOW — автоматические действия из flow сессий
- API — действия через Backend API
- CABINET — действия через веб-интерфейс кабинета
Привязка к пользователю — кто выполнил действие (если применимо)
Временные метки — когда было выполнено действие
Иммутабельность — действия нельзя изменить или удалить

Конфигурация персон — Настройки поведения в рамках Flow#

Привязка к flow-технологии — настройки для конкретного потока проверок
Управление сбором:
- Включить / Выключить автоматический сбор персон
- Принудительная верификация новых персон
- Пропускать технологии для известных персон
- Использовать фото персоны для Face2Face проверок

Интеграции и зависимости#

Система подписок — контроль лимитов создания персон
Flow-сессии — источник автоматических данных
Технологии проверок — EDocument, Liveness, Document Recognition
Организации — изоляция данных между клиентами
Пользователи — привязка действий к конкретным операторам

Автоматический сбор и обработка данных#

Извлечение из EDocument:

Автоматическое распознавание персональных данных из результатов получения электронных документов
Извлечение ИИН, номера документа, номера телефона
Сохранение цифрового фото (DIGITAL) с электронного документа

Извлечение из Liveness:

Сохранение лучшего кадра (Live)

Извлечение из Document Recognition:

Извлечение персонального номера, номера документа
Сохранения портретных фото (SCAN) с документа

Способы работы с системой персон#

Backend API — Интеграция с внешними системами#

Назначение: Программная интеграция с внешними системами для создания и управления персонами через REST API.

Детальное описание смотреть здесь

Типичные сценарии использования#

Миграция данных из существующих систем
Интеграция с CRM для создания профилей клиентов
Пакетная загрузка персон из внешних источников
Синхронизация с базами данных третьих сторон

Cabinet (Веб-интерфейс) — Ручное управление#

Назначение: Веб-интерфейс для администраторов и операторов для ручного управления персонами через браузер.

Доступные операции:#

Просмотр списка персон
Детальный просмотр персоны
Создание персоны
Управление фотографиями
Управление алиасами

Особенности веб-интерфейса#

Файловая загрузка — прямая загрузка изображений через форму
Предпросмотр фотографий — возможность просмотра всех изображений
Расширенная фильтрация — множественные критерии поиска
Пользовательский аудит — все действия привязываются к пользователю

Типичные сценарии использования#

Ручная корректировка данных персон
Административное управление — массовые операции
Расследование инцидентов — анализ истории действий
Контроль качества — проверка автоматически созданных персон
Обучение операторов — удобный интерфейс для новых сотрудников

Flow (Автоматический сбор)#

Назначение: Автоматическое создание и обновление персон на основе результатов завершенных flow сессий.

Механизм работы#

Асинхронная обработка — задачи выполняются в фоновом режиме
Триггер запуска — автоматический старт после завершения flow сессии
Конфигурируемость — поведение настраивается через конфигурации технологии Flow

Алгоритм автоматического сбора#

1. Извлечение данных из результатов

EDocument результаты → ИИН, номер документа, телефон, DIGITAL фото
Document Recognition → персональный номер, номер документа, SCAN фото
Liveness результаты → LIVE фото(лучший кадр)
Метаданные сессии → CUSTOM алиас(если указан в метаданных flow сессии)

2. Поиск существующих персон

Поиск персон по всем извлеченным алиасам
Если найдена одна персона → обновление
Если не найдено → создание новой персоны

3. Создание / обновление персоны

Фильтрация новых алиасов(исключение существующих)
Фильтрация новых фотографий по типу
Установка основного фото по приоритету типов
Определение статуса верификации(Face2Face результат)

Конфигурация через конфиг Персон#

Детальное поведение:

Выключен сбор персон

Персоны не создаются автоматически
Flow сессии завершаются без сбора данных
Ручное создание через API/Cabinet остается доступным

Принудительная верификация персон

Все новые персоны создаются с is_verified = True
Игнорируется результат Face2Face проверки

Пропуск технологий по существующим результатам

Поиск персоны по метаданным flow сессии
Копирование результатов предыдущих технологий (EDocument)
Пропуск повторного выполнения уже пройденных проверок
Ускорение повторных проверок известных персон

Использование в Face2Face

Использование фотографий персоны для Face2Face сравнения
Автоматический выбор лучшего доступного фото
Улучшение точности биометрического сравнения

Приоритеты обработки фотографий#

DIGITAL(приоритет 1) → основное фото
SCAN(приоритет 2) → если нет DIGITAL
LIVE(приоритет 3) → если нет DIGITAL и SCAN
OTHER(приоритет 4) → самый низкий приоритет

Сценарии автоматической обработки#

Сценарий 1: Новый пользователь

Flow: EDocument + Liveness
Результат: 
- Создание персоны с ИИН и номером документа
- Два фото: DIGITAL (основное) + LIVE
- Верификация по умолчанию false

Сценарий 2: Повторная проверка

Flow: EDocument + Liveness + Face2Face
Результат:
- Обновление существующей персоны
- Добавление нового LIVE фото (если типа еще не было)
- Верификация = true (успешный Face2Face)

Сценарий 3: Быстрая проверка - Пропуск технологий по существующим результатам

Персона найдена по алиасу в метаданных
Результат:
- Копирование EDocument результата из предыдущей сессии
- Пропуск повторного выполнения EDocument
- Выполнение только новых технологий

Сравнение способов работы#

Характеристика	Backend API	Cabinet UI	Flow
Инициатор	Внешняя система	Человек-оператор	Система (автоматически)
Тип операций	Программные	Интерактивные	Автоматические
Загрузка фото	Base64	Файл через форму	Извлечение из результатов
Аутентификация	API ключ	Веб-сессия	-