/**
@mainpage

# Обзор

Протокол COOPENOMICS представляет собой комплексную систему смарт-контрактов, обеспечивающую полный жизненный цикл кооперативной экономической деятельности на блокчейне COOPOS.

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

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

## Основные контракты

### Управление участниками и регистрация

#### Контракт REGISTRATOR
Основной входной контракт системы @ref public_registrator "REGISTRATOR", обеспечивающий регистрацию новых аккаунтов в блокчейне, создание карточек физических и юридических лиц, управление заявлениями на вступление в кооперативы, создание и управление кооперативами, а также верификацию участников.

#### Контракт BRANCH
Отвечает за управление территориальной структурой кооперативов @ref public_branch "BRANCH". Обеспечивает создание и управление кооперативными участками, назначение и управление доверенными лицами, территориальную привязку участников.

### Управление и принятие решений

#### Контракт SOVIET
Центральный контракт управления и принятия решений @ref public_soviet "SOVIET". Обеспечивает создание и управление советом кооперативов, голосование и принятие коллективных решений, управление документооборотом и соглашениями, автоматизацию административных процессов, управление правами и полномочиями, а также базовое управление целевыми программами.

#### Контракт MEET
Организует общие собрания участников @ref public_meet "MEET". Позволяет создавать и проводить собрания пайщиков, организовывать голосование по повестке дня, вести документооборот собраний, создавать протоколы и фиксировать решения собраний.

### Финансовое управление

#### Контракт CAPITAL
Отвечает за благорост интеллектуальной деятельности и управление проектами @ref public_capital "CAPITAL". Обеспечивает создание и управление проектами кооперативов, регистрацию участников в проектах, управление инвестиционными программами, голосование по проектным решениям, распределение результатов проектной деятельности и управление долговыми обязательствами по проектам.

#### Контракт FUND
Центральная система управления фондами кооперативов @ref public_fund "FUND". Позволяет создавать фонды накопления и списания, управлять паевым фондом кооператива, распределять членские взносы по фондам, авторизовать и выполнять выплаты из фондов, а также контролировать финансовые потоки.

#### Контракт WALLET
Цифровой кошелек для управления паевыми взносами @ref public_wallet "WALLET". Обеспечивает прием паевых взносов от участников, обработку возвратов паевых взносов, интеграцию с платежными системами, подтверждение и отклонение платежей.

#### Контракт LEDGER
Бухгалтерская система кооперативов @ref public_ledger "LEDGER". Ведет счета согласно кооперативным стандартам, выполняет операции пополнения и списания со счетов, блокировку и разблокировку средств, атомарные операции списания через совет, интеграцию с внешними платежными системами.

#### Контракт LOAN
Управляет займами и долговыми обязательствами @ref public_loan "LOAN". Позволяет создавать долговые обязательства между участниками, выполнять погашение займов и долгов, интегрируется с системой учета.

### Экономическая деятельность

#### Контракт MARKETPLACE
Кооперативный маркетплейс для обмена товарами и услугами @ref public_marketplace "MARKETPLACE". Обеспечивает создание заявок на обмен товарами и услугами, полный цикл поставки от заказа до получения, систему транспортировки и логистики, гарантийные обязательства и возвраты, разрешение споров через систему голосования, интеграцию с финансовой системой кооперативов.

#### Контракт GATEWAY
Платежный процессинг для интеграции с внешними системами @ref public_gateway "GATEWAY". Выполняет обработку входящих банковских и криптовалютных платежей, управление исходящими платежами, интеграцию с традиционными банковскими системами, обработку статусов платежей.

### Вспомогательные системы

#### Контракт DRAFT
Управляет шаблонами документов @ref public_draft "DRAFT". Обеспечивает создание и редактирование шаблонов документов, многоязычную поддержку документов, версионирование шаблонов, переводы документов на разные языки.

### Системные контракты

Система также включает контракты:
- **system** - основной системный контракт
- **token** - управление токенами
- **msig** - мультиподписи
- **wrap** - выполнение привилегированных действий

## Принципы работы системы

### Жизненный цикл участника

Участник проходит следующий путь в системе: сначала происходит регистрация через контракт @ref public_registrator "REGISTRATOR", затем выбор территориального участка через @ref public_branch "BRANCH", подача заявления в кооператив через @ref public_soviet "SOVIET", внесение паевых взносов через @ref public_wallet "WALLET", участие в экономической деятельности через @ref public_marketplace "MARKETPLACE" и @ref public_capital "CAPITAL".

### Финансовые потоки

Все финансовые операции в системе централизованы и проходят через контракт @ref public_fund "FUND" с ведением полного бухгалтерского учета в @ref public_ledger "LEDGER". Внешние платежи обрабатываются через @ref public_gateway "GATEWAY". Средства поступают в систему от участников через @ref public_wallet "WALLET", от торговых операций через @ref public_marketplace "MARKETPLACE", от проектной деятельности через @ref public_capital "CAPITAL".

### Управление и контроль

Все важные решения в кооперативе принимаются через систему голосования в контракте @ref public_soviet "SOVIET". Для принятия стратегических решений может созываться общее собрание пайщиков через контракт @ref public_meet "MEET". Документооборот обеих систем опирается на шаблоны документов из контракта @ref public_draft "DRAFT".

## Технологический стек

- **Блокчейн**: COOPOS
- **Язык контрактов**: C++
- **Система сборки**: CMake с CDT (Contract Development Toolkit)
- **Тестирование**: COOPOS Tester Framework
- **Документация**: Doxygen

*/
