/**
 @defgroup public_capital_import_contributor_process Импорт участников
 @ingroup public_capital_processes

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

 \htmlonly
 <div class="mermaid">
 sequenceDiagram
     participant А as Кооператив
     participant К as Capital Contract
     participant С as Soviet Contract

     А->>К: 1. Импорт участника с взносами
     Note over К: Проверка отсутствия конфигурации кооператива
     Note over К: Валидация суммы взносов
     Note over К: Проверка уникальности участника
     К->>К: 2. Создание записи участника
     Note over К: Статус ACTIVE, внешний договор
     К->>С: 3. Открытие программного кошелька
     Note over С: Создание кошелька в программе благороста
     К->>С: 4. Зачисление первоначальных взносов
     Note over С: Блокировка средств в программе благороста
 </div>
 \endhtmlonly

 ## Пошаговое описание процесса

 ### Шаг 1: Импорт участника с взносами
 <b>Действие:</b> @ref capital::importcontrib "импорт участника"

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

 @post Проверяется отсутствие конфигурации кооператива
 @post Валидируется сумма взносов
 @post Проверяется уникальность участника

 ### Шаг 2: Создание записи участника
 <b>Действие:</b> @ref capital::importcontrib "создание записи участника"

 Система создает запись участника со статусом ACTIVE, помечая его как импортированного
 с внешним договором УХД и фиксированной почасовой ставкой.

 @post Создается запись участника со статусом ACTIVE
 @post Устанавливается флаг внешнего договора УХД
 @post Фиксируется почасовая ставка для импортированного участника

 ### Шаг 3: Открытие программного кошелька
 <b>Действие:</b> @ref soviet::openprogwall "открытие кошелька программы"

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

 @post Создается программный кошелек в программе благороста
 @post Инициализируется кошелек с нулевыми балансами

 ### Шаг 4: Зачисление первоначальных взносов
 <b>Действие:</b> @ref capital::importcontrib "зачисление взносов"

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

 @post Зачисляются первоначальные взносы в программный кошелек
 @post Средства блокируются в программе благороста
 @post Создается запись о зачислении с комментарием

 ## Результат процесса

 После успешного завершения:
 1. Внешний участник становится полноценным участником системы благороста
 2. Открыт программный кошелек для участии в программе благороста
 3. Внесены первоначальные взносы в программу благороста

 ## Эффекты процесса
 @include{doc} import-contributor-effect.dox

 ## Связанные процессы

 - @ref public_capital_registration_process "Регистрация новых участников"
 - @ref public_capital_joining_process "Получение допуска к проекту"

 */
