Files

91 lines
10 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
@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
*/