Цифровой Кооператив
Платформа «Цифровой Кооператив» — комплексное программное обеспечение для управления кооперативными организациями на основе блокчейна EOSIO. Система обеспечивает полный цикл управления кооперативом: от регистрации пайщиков и электронного документооборота до проведения собраний и финансового учёта. Построена на принципах прозрачности, децентрализации и простой электронной подписи.
Проект является частью экосистемы Кооперативная Экономика.
Архитектура
| Компонент | Пакет | Описание |
|---|
| boot | @coopenomics/boot | CLI для инициализации и управления блокчейн-инфраструктурой |
| cleos | @coopenomics/cleos | Утилита командной строки для работы с блокчейн-кошельком |
| contracts | @coopenomics/contracts | Смарт-контракты EOSIO на C++ |
| controller | @coopenomics/controller | GraphQL API сервер (NestJS) |
| cooptypes | cooptypes | Общие типы и интерфейсы блокчейн-контрактов |
| desktop | @coopenomics/desktop | Рабочий стол кооператива (Vue 3 + Quasar) |
| factory | @coopenomics/factory | Генератор юридических документов |
| migrator | migrator | Утилита миграции данных |
| notifications | @coopenomics/notifications | Библиотека уведомлений на основе Novu |
| sdk | @coopenomics/sdk | TypeScript SDK для GraphQL API |
| setup | @coopenomics/setup | Мастер первоначальной настройки |
Быстрый старт
Предварительные требования
- Node.js 22 — та же версия, что в рантайм-образах (
node:22-slim) и во всех CI-workflow'ах
- pnpm 10.33.0 — пин в поле
packageManager корневого package.json, ставится через corepack enable
- Docker и Docker Compose
- WeasyPrint (для генерации PDF)
Про версию Node. Она не рекомендация, а требование: нативные модули привязаны
к ABI ноды (Node 22 → 127, Node 24 → 137). Готовые бинарники лежат в репозитории
(vendor/prebuilds/<пакет>/<версия>/node-v<ABI>/linux-<arch>/) и подкладываются
postinstall-скриптом scripts/install-native-prebuilds.mjs — ничего не скачивается
и не компилируется при установке. Сейчас завендорены ABI 127 и 137. На другой
версии Node установка остановится с явным сообщением о том, какого prebuild'а
не хватает; лечится добавлением файла в vendor/prebuilds/, а не пересборкой.
Установка
pnpm install
Конфигурация
pnpm run setup
Интерактивный мастер создаст необходимые .env файлы для всех компонентов.
Запуск инфраструктуры
docker compose up -d
pnpm run reboot
Вклад в проект
Правила работы с ветками, Pull Request'ами и проверками качества — в CONTRIBUTING.md.
Разработка
Бэкенд (controller + parser)
pnpm run dev:backend
Фронтенд (desktop)
pnpm run dev:desktop
Библиотеки (factory + cooptypes)
pnpm run dev:lib
Все сервисы одновременно
pnpm run dev:all
Примечание: установка пакетов производится только через фильтр: pnpm add <пакет> --filter <компонент>
Тестирование
# Все тесты
pnpm run test
# Юнит-тесты (cooptypes, parser, notifications)
pnpm run test:unit
# Компонентные тесты (factory)
pnpm run test:component
# Интеграционные тесты (boot + blockchain)
pnpm run test:integration
Сборка
# Библиотеки (cooptypes, factory)
pnpm run build:lib
# Смарт-контракты
pnpm run build:contracts:all
# Desktop (SSR)
pnpm --filter @coopenomics/desktop run build
Лицензия
Продукт Потребительского Кооператива «ВОСХОД» распространяется по лицензии BY-NC-SA 4.0.
Разрешено делиться, копировать и распространять материал, адаптировать и создавать производные произведения при условии указания авторства и сохранения той же лицензии. Коммерческое использование запрещено.
