audio-stream

Изменена логика создания Contributor с "при первом вкладе" на "при подтверждении доступа к проекту".
Теперь Contributor создается автоматически при одобрении appendix (confirmClearance).

Acceptance Criteria:
- Участник отображается в виджете сразу после подписания соглашения об участии
- Не требуется делать вклад для отображения в списке участников
- Логика создания Contributor изменена с "при первом вкладе" на "при подтверждении доступа"

Technical Changes:
- Добавлена логика создания Contributor в ClearanceManagementInteractor.handleConfirmClearance()
- Contributor создается со статусом APPROVED при подтверждении доступа
- Добавлены необходимые импорты и зависимости
- Обновлен статус спринта

Co-authored-by: Cursor <cursoragent@cursor.com>

.github/workflows/build-containers.yaml

@@ -2,8 +2,6 @@ name: Build Docker Images
 
 on:
   push:
-    branches:
-      - testnet
     tags:
       - '*'
 
@@ -28,12 +26,23 @@ jobs:
           echo "Проверяем файлы в middlewares:"
           ls -la components/desktop/src-ssr/middlewares/ || echo "Директория middlewares не найдена!"
           
-      - name: Set docker tag
+      - name: Set docker tags
         run: |
           if [[ $GITHUB_REF == refs/tags/* ]]; then
-            echo "DOCKER_TAG=${GITHUB_REF#refs/tags/}" >> $GITHUB_ENV
+            TAG_NAME=${GITHUB_REF#refs/tags/}
+            echo "DOCKER_TAG=$TAG_NAME" >> $GITHUB_ENV
+            
+            # Проверяем, является ли тег продакшн-тегом (не содержит alpha, beta, rc и т.д.)
+            if [[ ! $TAG_NAME =~ -(alpha|beta|rc|test) ]]; then
+              echo "IS_PRODUCTION_TAG=true" >> $GITHUB_ENV
+              echo "Это продакшн тег, будем добавлять latest"
+            else
+              echo "IS_PRODUCTION_TAG=false" >> $GITHUB_ENV
+              echo "Это не продакшн тег, latest не добавляем"
+            fi
           else
             echo "DOCKER_TAG=latest" >> $GITHUB_ENV
+            echo "IS_PRODUCTION_TAG=false" >> $GITHUB_ENV
           fi
           
       - name: Login to DockerHub
@@ -47,6 +56,12 @@ jobs:
         run: |
           docker build --target runtime -t dicoop/mono-base:${{ env.DOCKER_TAG }} .
           docker push dicoop/mono-base:${{ env.DOCKER_TAG }}
+          
+          # Если это продакшн тег, добавляем latest
+          if [[ "${{ env.IS_PRODUCTION_TAG }}" == "true" ]]; then
+            docker tag dicoop/mono-base:${{ env.DOCKER_TAG }} dicoop/mono-base:latest
+            docker push dicoop/mono-base:latest
+          fi
             
       # Создаем сервисные образы на основе базового
       - name: Build desktop image
@@ -55,6 +70,11 @@ jobs:
           echo "CMD [\"pnpm\", \"-F\", \"@coopenomics/desktop\", \"run\", \"start\"]" >> Dockerfile.desktop
           docker build -t dicoop/desktop:${{ env.DOCKER_TAG }} -f Dockerfile.desktop .
           docker push dicoop/desktop:${{ env.DOCKER_TAG }}
+          
+          if [[ "${{ env.IS_PRODUCTION_TAG }}" == "true" ]]; then
+            docker tag dicoop/desktop:${{ env.DOCKER_TAG }} dicoop/desktop:latest
+            docker push dicoop/desktop:latest
+          fi
             
       - name: Build controller image
         run: |
@@ -62,6 +82,11 @@ jobs:
           echo "CMD [\"pnpm\", \"-F\", \"@coopenomics/controller\", \"run\", \"start\"]" >> Dockerfile.coopback
           docker build -t dicoop/coopback:${{ env.DOCKER_TAG }} -f Dockerfile.coopback .
           docker push dicoop/coopback:${{ env.DOCKER_TAG }}
+          
+          if [[ "${{ env.IS_PRODUCTION_TAG }}" == "true" ]]; then
+            docker tag dicoop/coopback:${{ env.DOCKER_TAG }} dicoop/coopback:latest
+            docker push dicoop/coopback:latest
+          fi
             
       - name: Build parser image
         run: |
@@ -69,6 +94,11 @@ jobs:
           echo "CMD [\"pnpm\", \"-F\", \"@coopenomics/parser\", \"run\", \"start\"]" >> Dockerfile.cooparser
           docker build -t dicoop/cooparser:${{ env.DOCKER_TAG }} -f Dockerfile.cooparser .
           docker push dicoop/cooparser:${{ env.DOCKER_TAG }}
+          
+          if [[ "${{ env.IS_PRODUCTION_TAG }}" == "true" ]]; then
+            docker tag dicoop/cooparser:${{ env.DOCKER_TAG }} dicoop/cooparser:latest
+            docker push dicoop/cooparser:latest
+          fi
             
       - name: Build notificator image
         run: |
@@ -76,6 +106,11 @@ jobs:
           echo "CMD [\"pnpm\", \"-F\", \"coop-notificator\", \"run\", \"start\"]" >> Dockerfile.notificator
           docker build -t dicoop/notificator:${{ env.DOCKER_TAG }} -f Dockerfile.notificator .
           docker push dicoop/notificator:${{ env.DOCKER_TAG }}
+          
+          if [[ "${{ env.IS_PRODUCTION_TAG }}" == "true" ]]; then
+            docker tag dicoop/notificator:${{ env.DOCKER_TAG }} dicoop/notificator:latest
+            docker push dicoop/notificator:latest
+          fi
       
       - name: Build notifications image
         run: |
@@ -83,35 +118,41 @@ jobs:
           echo "CMD [\"pnpm\", \"-F\", \"@coopenomics/notifications\", \"run\", \"sync\"]" >> Dockerfile.notifications
           docker build -t dicoop/notifications:${{ env.DOCKER_TAG }} -f Dockerfile.notifications .
           docker push dicoop/notifications:${{ env.DOCKER_TAG }}
+          
+          if [[ "${{ env.IS_PRODUCTION_TAG }}" == "true" ]]; then
+            docker tag dicoop/notifications:${{ env.DOCKER_TAG }} dicoop/notifications:latest
+            docker push dicoop/notifications:latest
+          fi
                  
       # Отправка хука для деплоя
       - name: Trigger deployment webhook
         if: ${{ success() }}
         run: |
-          if [[ $GITHUB_REF == refs/tags/latest ]]; then
-            # Хук для тестнета
-            curl -X POST ${{ vars.TESTNET_WEBHOOK_URL }} \
-              -H 'Content-Type: application/json' \
-              -d '${{ env.DOCKER_TAG }}'
+          if [[ $GITHUB_REF == refs/tags/*alpha* ]]; then
+              # Хук для тестнета (alpha теги)
+              curl -X POST ${{ vars.TESTNET_WEBHOOK_URL }} \
+                -H 'Content-Type: application/json' \
+                -d '${{ env.DOCKER_TAG }}'
           elif [[ $GITHUB_REF == refs/tags/* ]]; then
-            # Хук для продакшена
-            curl -X POST ${{ vars.PRODUCTION_WEBHOOK_URL }} \
-              -H 'Content-Type: application/json' \
-              -d '${{ env.DOCKER_TAG }}'
-          else
-            # Хук для тестнета (обычная ветка)
-            curl -X POST ${{ vars.TESTNET_WEBHOOK_URL }} \
-              -H 'Content-Type: application/json' \
-              -d '${{ env.DOCKER_TAG }}'
+              # Хук для продакшена (остальные теги)
+              curl -X POST ${{ vars.PRODUCTION_WEBHOOK_URL }} \
+                -H 'Content-Type: application/json' \
+                -d '${{ env.DOCKER_TAG }}'
           fi
 
       # Уведомление в Telegram об успехе
       - name: Telegram notify success
         if: ${{ success() }}
         run: |
+          if [[ "${{ env.IS_PRODUCTION_TAG }}" == "true" ]]; then
+            ADDITIONAL_INFO=" (с тегом latest)"
+          else
+            ADDITIONAL_INFO=""
+          fi
+          
           curl -s -X POST https://api.telegram.org/bot${{ secrets.TELEGRAM_BOT_TOKEN }}/sendMessage \
             -d chat_id=${{ secrets.TELEGRAM_CHAT_ID }} \
-            -d text="✅ [GITHUB MONO] Успешная сборка контейнеров: $GITHUB_REPOSITORY ($GITHUB_REF) [${{ env.DOCKER_TAG }}]"
+            -d text="✅ [GITHUB MONO] Успешная сборка контейнеров: $GITHUB_REPOSITORY ($GITHUB_REF) [${{ env.DOCKER_TAG }}]$ADDITIONAL_INFO"
 
       # Уведомление в Telegram об ошибке
       - name: Telegram notify failure

.github/workflows/publish-docs.yaml

@@ -4,6 +4,9 @@ on:
   push:
     branches:
       - main
+      - testnet
+      - dev
+
 jobs:
   build-and-publish-docs:
     runs-on: ubuntu-latest
@@ -81,6 +84,18 @@ jobs:
           mkdocs build
         working-directory: ./components/docs
 
+      - name: Remove specific large file before publishing
+        run: |
+          # Удаляем конкретный большой файл sdk/typedoc.json
+          rm -f ./components/docs/site/sdk/typedoc.json
+          # Проверяем, что файл удален
+          if [ -f "./components/docs/site/sdk/typedoc.json" ]; then
+            echo "ERROR: typedoc.json still exists!"
+            exit 1
+          else
+            echo "SUCCESS: typedoc.json removed successfully"
+          fi
+
       - name: Publish to GitHub Pages
         run: npx gh-pages --nojekyll -d site --repo https://x-access-token:${GITHUB_TOKEN}@github.com/coopenomics/mono.git
         working-directory: ./components/docs
@@ -89,5 +104,4 @@ jobs:
           GIT_AUTHOR_EMAIL: github-actions@github.com
           GIT_COMMITTER_NAME: github-actions
           GIT_COMMITTER_EMAIL: github-actions@github.com
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/publish-packages.yaml

@@ -3,31 +3,29 @@ name: Publish Packages
 on:
   push:
     tags:
-      - '*'
+      - 'v*'
+
+permissions:
+  contents: read
 
 jobs:
   build-and-publish:
+    if: |
+      startsWith(github.ref, 'refs/tags/v') &&
+      !contains(github.ref, '-alpha')
     runs-on: ubuntu-latest
+
     steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
-      - name: Set up Node.js
-        uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
-          node-version: 20
-          registry-url: 'https://registry.npmjs.org'
+          node-version: 24
+          registry-url: https://registry.npmjs.org
 
-      - name: Install pnpm
-        run: npm install -g pnpm
-
-      - name: Install dependencies
-        run: pnpm install
-
-      - name: Build all packages
-        run: pnpm lerna run build
-
-      - name: Publish to npm
+      - run: npm install -g pnpm
+      - run: pnpm install
+      - run: pnpm lerna run build
+      - run: pnpm lerna publish from-package --yes
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: pnpm lerna publish from-package --yes --no-verify-access 

.prettierrc

@@ -0,0 +1,8 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "printWidth": 120,
+  "plugins": [
+    "prettier-plugin-sort-imports"
+  ]
+}

.vscode/settings.json

@@ -67,5 +67,8 @@
   
   // Оптимизация для больших монорепозиториев
   "typescript.disableAutomaticTypeAcquisition": true,
-  "typescript.surveys.enabled": false
+  "typescript.surveys.enabled": false,
+  "[typescript]": {
+    "editor.defaultFormatter": "vscode.typescript-language-features"
+  }
 }

CHANGELOG.md

@@ -1,3 +1,126 @@
+# v2025.12.28-8
+
+В этой версии представлен прототип трекера результатов интеллектуальной деятельности, реализован мост в 1С, обновлен интерфейс и существенно повышена стабильность системы.
+
+---
+
+### ✨ Новые функции
+- [#332](https://github.com/coopenomics/mono/issues/332): Прототип конструктора требований дополнительных документов при регистрации
+- [#330](https://github.com/coopenomics/mono/issues/330): Прототип моста в 1С:Бухгалтерию для передачи документов и проводок
+- [#329](https://github.com/coopenomics/mono/issues/329): Интеграция и тестирование LMS TUTOR для образовательных задач
+- [#328](https://github.com/coopenomics/mono/issues/328): Размещение прототипов мульти-лендингов на цифровой-кооператив.рф и coopenomics.world
+- [#326](https://github.com/coopenomics/mono/issues/326): Минимальный интерфейс трекера результатов интеллектуальной деятельности
+- [#324](https://github.com/coopenomics/mono/issues/324): Смарт-контракт генерации и капитализации результатов интеллектуальной деятельности ("Благорост")
+- [#322](https://github.com/coopenomics/mono/issues/322): Поставка обновлений ПО с нулевым даунтаймом по blue-green стратегии
+- [#321](https://github.com/coopenomics/mono/issues/321): Внедрение системы проводок по фондам для контрактов
+- [#319](https://github.com/coopenomics/mono/issues/319): Палитра команд и быстрый доступ к страницам рабочих столов (cmk+k)
+- [#316](https://github.com/coopenomics/mono/issues/316): Переход рабочего стола на GraphQL SDK
+- [#314](https://github.com/coopenomics/mono/issues/314): Развёртывание GlitchTip для мониторинга ошибок
+- [#306](https://github.com/coopenomics/mono/issues/306): Модуль запросов и мутаций для контракта капитализации
+
+### 🐛 Исправления ошибок
+- [#312](https://github.com/coopenomics/mono/issues/312): Исправление подписки на изменение статуса коммитов
+- [#309](https://github.com/coopenomics/mono/issues/309): Исправление отображения чужих билетов времени в трекере
+
+### 🔧 Улучшения
+- [#331](https://github.com/coopenomics/mono/issues/331): Настройка системы мониторинга сбоев и ошибок на базе GlitchTIP, Loki, Prometheus
+- [#327](https://github.com/coopenomics/mono/issues/327): Пользовательская документация по интерфейсам цифрового кооператива
+- [#325](https://github.com/coopenomics/mono/issues/325): Документирование смарт-контракта программы "Благорост"
+- [#308](https://github.com/coopenomics/mono/issues/308): Улучшение отображения рабочих столов в магазине приложений
+- [#307](https://github.com/coopenomics/mono/issues/307): Объединение настроек контракта с нативными настройками приложения
+- [#305](https://github.com/coopenomics/mono/issues/305): Объединение полей title и description в проекте
+- [#304](https://github.com/coopenomics/mono/issues/304): Доменная модель контракта капитализации на бэкенде
+- [#303](https://github.com/coopenomics/mono/issues/303): Пересмотр архитектуры парсера и формирования локальной истории
+- [#302](https://github.com/coopenomics/mono/issues/302): Рефакторинг архитектуры, внедрение двухконтурной шины данных и обработки микрофорков
+- [#301](https://github.com/coopenomics/mono/issues/301): Доработка и отладка контракта "Капитализация РИД" v0.2
+- [#222](https://github.com/coopenomics/mono/issues/222): Внедрение метода Водянова для распределения пула премий по программе "Благорост"
+- [#212](https://github.com/coopenomics/mono/issues/212): Снижение точности валютных значений до двух знаков после запятой в документах
+
+#releases
+
+---
+
+# v2025.12.28
+
+В этой версии представлен прототип трекера результатов интеллектуальной деятельности, реализован мост в 1С, обновлен интерфейс и существенно повышена стабильность системы.
+
+---
+
+### ✨ Новые функции
+- [#332](https://github.com/coopenomics/mono/issues/332): Прототип конструктора требований дополнительных документов при регистрации
+- [#330](https://github.com/coopenomics/mono/issues/330): Прототип моста в 1С:Бухгалтерию для передачи документов и проводок
+- [#329](https://github.com/coopenomics/mono/issues/329): Интеграция и тестирование LMS TUTOR для образовательных задач
+- [#328](https://github.com/coopenomics/mono/issues/328): Размещение прототипов мульти-лендингов на цифровой-кооператив.рф и coopenomics.world
+- [#326](https://github.com/coopenomics/mono/issues/326): Минимальный интерфейс трекера результатов интеллектуальной деятельности
+- [#324](https://github.com/coopenomics/mono/issues/324): Смарт-контракт генерации и капитализации результатов интеллектуальной деятельности ("Благорост")
+- [#322](https://github.com/coopenomics/mono/issues/322): Поставка обновлений ПО с нулевым даунтаймом по blue-green стратегии
+- [#321](https://github.com/coopenomics/mono/issues/321): Внедрение системы проводок по фондам для контрактов
+- [#319](https://github.com/coopenomics/mono/issues/319): Палитра команд и быстрый доступ к страницам рабочих столов (cmk+k)
+- [#316](https://github.com/coopenomics/mono/issues/316): Переход рабочего стола на GraphQL SDK
+- [#314](https://github.com/coopenomics/mono/issues/314): Развёртывание GlitchTip для мониторинга ошибок
+- [#306](https://github.com/coopenomics/mono/issues/306): Модуль запросов и мутаций для контракта капитализации
+
+### 🐛 Исправления ошибок
+- [#312](https://github.com/coopenomics/mono/issues/312): Исправление подписки на изменение статуса коммитов
+- [#309](https://github.com/coopenomics/mono/issues/309): Исправление отображения чужих билетов времени в трекере
+
+### 🔧 Улучшения
+- [#331](https://github.com/coopenomics/mono/issues/331): Настройка системы мониторинга сбоев и ошибок на базе GlitchTIP, Loki, Prometheus
+- [#327](https://github.com/coopenomics/mono/issues/327): Пользовательская документация по интерфейсам цифрового кооператива
+- [#325](https://github.com/coopenomics/mono/issues/325): Документирование смарт-контракта программы "Благорост"
+- [#308](https://github.com/coopenomics/mono/issues/308): Улучшение отображения рабочих столов в магазине приложений
+- [#307](https://github.com/coopenomics/mono/issues/307): Объединение настроек контракта с нативными настройками приложения
+- [#305](https://github.com/coopenomics/mono/issues/305): Объединение полей title и description в проекте
+- [#304](https://github.com/coopenomics/mono/issues/304): Доменная модель контракта капитализации на бэкенде
+- [#303](https://github.com/coopenomics/mono/issues/303): Пересмотр архитектуры парсера и формирования локальной истории
+- [#302](https://github.com/coopenomics/mono/issues/302): Рефакторинг архитектуры, внедрение двухконтурной шины данных и обработки микрофорков
+- [#301](https://github.com/coopenomics/mono/issues/301): Доработка и отладка контракта "Капитализация РИД" v0.2
+- [#222](https://github.com/coopenomics/mono/issues/222): Внедрение метода Водянова для распределения пула премий по программе "Благорост"
+- [#212](https://github.com/coopenomics/mono/issues/212): Снижение точности валютных значений до двух знаков после запятой в документах
+
+#releases
+
+---
+
+# v2025.12.28
+
+В этом релизе реализован смарт-контракт генерации и капитализации результатов интеллектуальной деятельности, завершена интеграция с учётными системами, улучшены интерфейсы и документация. Подробнее о контракте: https://coopenomics.world/contracts/group__public__capital.html
+
+✨ Новые функции
+- [#324](https://github.com/coopenomics/mono/issues/324): Реализован смарт-контракт генерации и капитализации результатов интеллектуальной деятельности ("Благорост")
+- [#301](https://github.com/coopenomics/mono/issues/301): Контракт "Капитализация РИД" v0.2
+- [#330](https://github.com/coopenomics/mono/issues/330): Прототип моста в 1С:Бухгалтерию: выгрузка документов и проводки по счетам
+- [#322](https://github.com/coopenomics/mono/issues/322): Обновления ПО с нулевым даунтаймом по blue-green стратегии
+- [#319](https://github.com/coopenomics/mono/issues/319): Палитра команд и быстрый доступ к страницам рабочих столов (cmk+k)
+- [#308](https://github.com/coopenomics/mono/issues/308): Магазин приложений с поддержкой подключения нескольких рабочих столов одним приложением
+- [#326](https://github.com/coopenomics/mono/issues/326): Минимальный интерфейс трекера результатов интеллектуальной деятельности по программе "Благорост"
+- [#332](https://github.com/coopenomics/mono/issues/332): Прототип конструктора требований дополнительных документов при регистрации
+
+🐛 Исправления ошибок
+- [#312](https://github.com/coopenomics/mono/issues/312): Исправлена ошибка со статусом коммитов — подписка теперь работает корректно
+- [#309](https://github.com/coopenomics/mono/issues/309): Исправлен баг с отображением чужих билетов времени в трекере
+
+🔧 Улучшения
+- [#325](https://github.com/coopenomics/mono/issues/325): Документирован смарт-контракт программы "Благорост"
+- [#327](https://github.com/coopenomics/mono/issues/327): Подготовлена пользовательская документация цифрового кооператива по интерфейсам
+- [#329](https://github.com/coopenomics/mono/issues/329): Интеграция и тестирование образовательной платформы LMS TUTOR на Wordpress
+- [#328](https://github.com/coopenomics/mono/issues/328): Размещены прототипы мульти-лендингов на цифровой-кооператив.рф и coopenomics.world
+- [#321](https://github.com/coopenomics/mono/issues/321): Встроена система проводок по фондам и интеграция с контрактами
+- [#318](https://github.com/coopenomics/mono/issues/318): Настроены Loki & Grafana для выгрузки логов из контейнеров
+- [#316](https://github.com/coopenomics/mono/issues/316): Завершён переход рабочего стола на GraphQL SDK
+- [#314](https://github.com/coopenomics/mono/issues/314): Развёрнут GlitchTip как альтернатива Sentry
+- [#307](https://github.com/coopenomics/mono/issues/307): Интеграция настроек контракта с нативными настройками приложения, поддержка импорта после конфигурации
+- [#306](https://github.com/coopenomics/mono/issues/306): Собран модуль запросов и мутаций контракта капитализации
+- [#305](https://github.com/coopenomics/mono/issues/305): Упрощена структура проекта — title & description объединены в одно поле
+- [#304](https://github.com/coopenomics/mono/issues/304): Реализована доменная модель контракта капитализации на бэкенде с поддержкой микрофорков
+- [#303](https://github.com/coopenomics/mono/issues/303): Пересмотрена архитектура парсера и формирования локальной истории
+- [#302](https://github.com/coopenomics/mono/issues/302): Рефакторинг архитектуры, реализована двухконтурная шина данных и обработка микрофорков
+- [#212](https://github.com/coopenomics/mono/issues/212): Уменьшена точность валютных значений в документах с четырёх до двух знаков
+
+#releases
+
+---
+
 # v2025.9.1
 
 В системе Кооперативной Экономики развернут смарт-контракт CAPITAL v0.2  для генерации и капитализации результатов интеллектуальной деятельности. Контракт описывает и обеспечивает:

Dockerfile

@@ -1,4 +1,4 @@
-FROM node:20-alpine AS builder
+FROM node:20-slim AS builder
 
 WORKDIR /app
 
@@ -12,23 +12,29 @@ RUN npm install -g pnpm lerna
 # Используем версию pnpm, совместимую с существующим lock-файлом
 RUN pnpm install
 
-# Установка системных зависимостей для WeasyPrint
-RUN apk add --no-cache \
+# Установка системных зависимостей для WeasyPrint и диагностических утилит (Debian/Ubuntu версии)
+RUN apt-get update && apt-get install -y \
     python3 \
-    py3-pip \
+    python3-pip \
+    python3-venv \
     gcc \
-    musl-dev \
-    python3-dev \
-    pango \
-    zlib-dev \
-    jpeg-dev \
-    openjpeg-dev \
     g++ \
+    python3-dev \
+    libpango-1.0-0 \
+    libpangoft2-1.0-0 \
+    libpangocairo-1.0-0 \
+    libcairo2 \
+    libcairo2-dev \
     libffi-dev \
-    harfbuzz-subset \
+    shared-mime-info \
+    zlib1g-dev \
+    libjpeg-dev \
+    libopenjp2-7-dev \
+    procps \
+    wget \
     && python3 -m venv /venv \
-    && /venv/bin/pip install WeasyPrint==62.3 \
-    && rm -rf /var/cache/*
+    && /venv/bin/pip install WeasyPrint==67 \
+    && rm -rf /var/lib/apt/lists/*
 
 # Сборка всех компонентов
 RUN lerna run build

README.md

@@ -1,4 +1,4 @@
-# MONO
+# Цифровой Кооператив
 
 Система управления взаимоотношениями в кооперативе. Включает в себя полный комплект программного обеспечения для подключения к платформе "Кооперативная Экономика" и управления взаимоотношениями с пайщиками в кооперативе и самим кооперативом на основе смарт-контрактов и простой электронной подписи.
 

components/boot/.env-example

@@ -8,3 +8,8 @@ SERVER_URL=http://127.0.0.1:2998
 MONGO_URI=mongodb://127.0.0.1:27017/cooperative-x
 SIMPLE_EXPLORER_API=http://localhost:4000
 SKIP_BLOCK_FETCH=TRUE
+POSTGRES_HOST=127.0.0.1
+POSTGRES_PORT=5432
+POSTGRES_USERNAME=postgres
+POSTGRES_PASSWORD=postgres
+POSTGRES_DATABASE=voskhod

components/boot/.vscode/settings.json

@@ -1,7 +1,7 @@
 {
   // Enable the ESlint flat config support
   "prettier.enable": false,
-  "editor.formatOnSave": true,
+  "editor.formatOnSave": false,
   // Auto fix
   "editor.codeActionsOnSave": {
     "source.fixAll.eslint": "explicit"

components/boot/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coopenomics/boot",
   "type": "module",
-  "version": "2025.10.16",
+  "version": "2026.2.22-alpha-4",
   "private": true,
   "packageManager": "pnpm@9.0.6",
   "description": "",
@@ -15,12 +15,18 @@
     "cleos": "esno src/index.ts cleos",
     "unlock": "esno src/index.ts unlock",
     "boot": "esno src/index.ts boot",
-    "clear": "esno src/index.ts clear",
+    "boot:clean": "esno src/index.ts boot:clean",
+    "boot:extra": "esno src/index.ts boot:extra",
+    "reboot:clean": "cd components/boot/scripts && bash clean_reboot.sh",
+    "reboot:extra": "cd components/boot/scripts && bash extra_reboot.sh",
+    "create-coop": "esno src/index.ts create-coop",
+    "clear": "./scripts/clear.sh",
     "start": "./scripts/restart.sh",
     "stop": "./scripts/stop.sh"
   },
   "dependencies": {
     "@coopenomics/factory": "workspace:*",
+    "@types/pg": "^8.16.0",
     "axios": "^1.6.8",
     "chai": "^5.1.2",
     "commander": "^12.1.0",
@@ -32,7 +38,8 @@
     "eosjs-ecc": "^4.0.7",
     "execa": "^9.5.2",
     "mocha": "^10.7.3",
-    "mongoose": "^8.10.0"
+    "mongoose": "^8.10.0",
+    "pg": "^8.16.3"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^2.18.0",

components/boot/scripts/clean_reboot.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+
+# Останавливаем и удаляем контейнеры вместе с volumes
+echo "Останавливаем и удаляем контейнеры с volumes..."
+docker compose down -v mongo postgres cooparser || true
+
+# Останавливаем blockchain контейнер перед удалением данных
+echo "Останавливаем blockchain контейнер..."
+docker compose stop node || true
+
+# Удаляем blockchain data
+echo "Удаляем blockchain data..."
+# sudo chmod -R 755 ../blockchain-data/ 2>/dev/null || true
+sudo rm -rf ../blockchain-data/
+
+# Пересоздаем и запускаем базы данных
+echo "Пересоздаем и запускаем базы данных..."
+docker compose up -d mongo postgres
+
+# Ждем готовности MongoDB
+echo "Ждем готовности MongoDB..."
+until docker exec mongo mongosh --eval "db.adminCommand('ping')" --quiet > /dev/null 2>&1; do
+  echo "MongoDB еще не готов, ждем..."
+  sleep 2
+done
+echo "MongoDB готов!"
+
+# Ждем готовности PostgreSQL
+echo "Ждем готовности PostgreSQL..."
+until docker exec postgres pg_isready -U postgres -d voskhod > /dev/null 2>&1; do
+  echo "PostgreSQL еще не готов, ждем..."
+  sleep 2
+done
+echo "PostgreSQL готов!"
+
+# Запускаем boot процесс
+echo "Запускаем boot процесс..."
+pnpm run boot:clean
+
+# Запускаем parser
+echo "Запускаем parser..."
+docker compose up -d cooparser
+
+echo "Запускаем контроллер..."
+docker compose restart coopback || true
+
+echo "Перезапуск завершен!"

components/boot/scripts/clear.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+
+# Останавливаем и удаляем контейнеры вместе с volumes
+echo "Останавливаем и удаляем контейнеры с volumes..."
+docker compose down -v mongo postgres cooparser || true
+
+# Останавливаем blockchain контейнер перед удалением данных
+echo "Останавливаем blockchain контейнер..."
+docker compose stop node || true
+
+# Удаляем blockchain data
+echo "Удаляем blockchain data..."
+# sudo chmod -R 755 ../blockchain-data/ 2>/dev/null || true
+sudo rm -rf ../blockchain-data/
+
+# Пересоздаем и запускаем базы данных
+echo "Пересоздаем и запускаем базы данных..."
+docker compose up -d mongo postgres
+
+# Ждем готовности MongoDB
+echo "Ждем готовности MongoDB..."
+until docker exec mongo mongosh --eval "db.adminCommand('ping')" --quiet > /dev/null 2>&1; do
+  echo "MongoDB еще не готов, ждем..."
+  sleep 2
+done
+echo "MongoDB готов!"
+
+# Ждем готовности PostgreSQL
+echo "Ждем готовности PostgreSQL..."
+until docker exec postgres pg_isready -U postgres -d voskhod > /dev/null 2>&1; do
+  echo "PostgreSQL еще не готов, ждем..."
+  sleep 2
+done
+echo "PostgreSQL готов!"

components/boot/scripts/extra_reboot.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+
+# Останавливаем контроллер перед очисткой данных
+echo "Останавливаем контроллер..."
+docker compose down coopback || true
+
+# Останавливаем и удаляем контейнеры вместе с volumes
+echo "Останавливаем и удаляем контейнеры с volumes..."
+docker compose down -v mongo postgres cooparser || true
+
+# Останавливаем blockchain контейнер перед удалением данных
+echo "Останавливаем blockchain контейнер..."
+docker compose stop node || true
+
+# Удаляем blockchain data
+echo "Удаляем blockchain data..."
+# sudo chmod -R 755 ../blockchain-data/ 2>/dev/null || true
+sudo rm -rf ../blockchain-data/
+
+# Пересоздаем и запускаем базы данных
+echo "Пересоздаем и запускаем базы данных..."
+docker compose up -d mongo postgres
+
+# Ждем готовности MongoDB
+echo "Ждем готовности MongoDB..."
+until docker exec mongo mongosh --eval "db.adminCommand('ping')" --quiet > /dev/null 2>&1; do
+  echo "MongoDB еще не готов, ждем..."
+  sleep 2
+done
+echo "MongoDB готов!"
+
+# Ждем готовности PostgreSQL
+echo "Ждем готовности PostgreSQL..."
+until docker exec postgres pg_isready -U postgres -d voskhod > /dev/null 2>&1; do
+  echo "PostgreSQL еще не готов, ждем..."
+  sleep 2
+done
+echo "PostgreSQL готов!"
+
+# Запускаем boot процесс
+echo "Запускаем boot процесс..."
+pnpm run boot:extra
+
+# Запускаем parser
+echo "Запускаем parser..."
+docker compose up -d cooparser
+
+echo "Запускаем контроллер..."
+docker compose up -d coopback
+
+echo "Перезапуск завершен!"

components/boot/src/blockchain/index.ts

@@ -44,8 +44,8 @@ export default class Blockchain {
     this.api = new Api({
       rpc,
       signatureProvider,
-      textDecoder: new TextDecoder(),
-      textEncoder: new TextEncoder(),
+      textDecoder: new TextDecoder() as any,
+      textEncoder: new TextEncoder() as any,
     })
     this.api.read = await EosApi({ httpEndpoint: res })
   }
@@ -637,6 +637,66 @@ export default class Blockchain {
     console.log('Новый пользователь: ', params)
   }
 
+  async addUser(
+    params: RegistratorContract.Actions.AddUser.IAddUser,
+  ) {
+    await this.update_pass_instance()
+    console.dir(params, { depth: null })
+    await this.api.transact(
+      {
+        actions: [
+          {
+            account: RegistratorContract.contractName.production,
+            name: RegistratorContract.Actions.AddUser.actionName,
+            authorization: [
+              {
+                actor: params.coopname,
+                permission: 'active',
+              },
+            ],
+            data: params,
+          },
+        ],
+      },
+      {
+        blocksBehind: 3,
+        expireSeconds: 30,
+      },
+    )
+
+    console.log('Добавлен пользователь: ', params.username)
+  }
+
+  async changeKey(
+    params: RegistratorContract.Actions.ChangeKey.IChangeKey,
+  ) {
+    await this.update_pass_instance()
+    console.dir(params, { depth: null })
+    await this.api.transact(
+      {
+        actions: [
+          {
+            account: RegistratorContract.contractName.production,
+            name: RegistratorContract.Actions.ChangeKey.actionName,
+            authorization: [
+              {
+                actor: params.coopname,
+                permission: 'active',
+              },
+            ],
+            data: params,
+          },
+        ],
+      },
+      {
+        blocksBehind: 3,
+        expireSeconds: 30,
+      },
+    )
+
+    console.log('Изменён ключ для пользователя: ', params.username)
+  }
+
   async transfer(params: TokenContract.Actions.Transfer.ITransfer) {
     await this.update_pass_instance()
     console.dir(params, { depth: null })
@@ -863,38 +923,6 @@ export default class Blockchain {
     console.log('Заявление на вступление отправлено в совет: ', params)
   }
 
-  async createBoard(
-    params: SovietContract.Actions.Boards.CreateBoard.ICreateboard,
-  ) {
-    await this.update_pass_instance()
-
-    await this.api.transact(
-      {
-        actions: [
-          {
-            account: SovietContract.contractName.production,
-            name: SovietContract.Actions.Boards.CreateBoard.actionName,
-            authorization: [
-              {
-                actor: params.coopname,
-                permission: 'active',
-              },
-            ],
-            data: {
-              ...params,
-            },
-          },
-        ],
-      },
-      {
-        blocksBehind: 3,
-        expireSeconds: 30,
-      },
-    )
-
-    console.log('Совет создан: ', params)
-  }
-
   async createDraft(params: DraftContract.Actions.CreateDraft.ICreateDraft) {
     await this.update_pass_instance()
 
@@ -989,6 +1017,37 @@ export default class Blockchain {
     console.log('Программа установлена: ', params)
   }
 
+  async createBoard(params: SovietContract.Actions.Boards.CreateBoard.ICreateboard) {
+    await this.update_pass_instance()
+    console.dir(params, { depth: null })
+    const result = await this.api.transact(
+      {
+        actions: [
+          {
+            account: SovietContract.contractName.production,
+            name: SovietContract.Actions.Boards.CreateBoard.actionName,
+            authorization: [
+              {
+                actor: params.coopname,
+                permission: 'active',
+              },
+            ],
+            data: {
+              ...params,
+            },
+          },
+        ],
+      },
+      {
+        blocksBehind: 3,
+        expireSeconds: 30,
+      },
+    )
+
+    console.log('Создан совет: ', params)
+    return result
+  }
+
   /**
    * Выполняет транзакцию и автоматически выводит консоль логи через consoleIt
    * @param actions - массив действий для транзакции

components/boot/src/configs/config.ini

@@ -10,7 +10,7 @@ enable-stale-production = true
 read-only-read-window-time-us = 120000
 
 net-threads = 2
-max-transaction-time=2000
+max-transaction-time=10000
 
 http-server-address = 0.0.0.0:8888
 p2p-listen-endpoint = 0.0.0.0:9876
@@ -26,8 +26,8 @@ max-body-size = 10485760
 abi-serializer-max-time-ms = 200000
 contracts-console = true
 
-max-block-cpu-usage-threshold-us = 5000
-max-block-net-usage-threshold-bytes = 1024
+max-block-cpu-usage-threshold-us = 200000
+max-block-net-usage-threshold-bytes = 800000
 
 verbose-http-errors = true
 chain-state-history = true

components/boot/src/configs/genesis.json

@@ -9,8 +9,8 @@
     "net_usage_leeway": 500,
     "context_free_discount_net_usage_num": 20,
     "context_free_discount_net_usage_den": 100,
-    "max_block_cpu_usage": 300000,
-    "target_block_cpu_usage_pct": 500,
+    "max_block_cpu_usage": 1000000,
+    "target_block_cpu_usage_pct": 1000,
     "max_transaction_cpu_usage": 290000,
     "min_transaction_cpu_usage": 100,
     "max_transaction_lifetime": 3600,

components/boot/src/configs/index.ts

@@ -53,7 +53,7 @@ export default {
   allocations: [
     {
       to: 'eosio',
-      quantity: `10000.0000 ${SYMBOL}`,
+      quantity: `100000.0000 ${SYMBOL}`,
     },
   ],
   accounts: [
@@ -135,9 +135,9 @@ export default {
       name: 'contributor',
       code_permissions_to: ['contributor'],
     },
-    {
-      name: provider_chairman,
-    },
+    // {
+    //   name: provider_chairman,
+    // },
     {
       name: provider,
       code_permissions_to: ['registrator'],

components/boot/src/docker/purge.ts

@@ -3,6 +3,7 @@ import * as path from 'node:path'
 import mongoose from 'mongoose'
 
 export async function clearDB(): Promise<void> {
+  // Очистка MongoDB
   // eslint-disable-next-line node/prefer-global/process
   await mongoose.connect(process.env.MONGO_URI as string)
 
@@ -37,6 +38,8 @@ export async function clearDB(): Promise<void> {
   catch (e) {
     console.error('Ошибка при удалении:', e)
   }
+
+  // PostgreSQL будет пересоздан полностью в скрипте extra_reboot.sh
 }
 
 export async function clearDirectory(dirPath: string): Promise<void> {

components/boot/src/index.ts

@@ -6,7 +6,8 @@ import { config } from 'dotenv'
 import { execCommand } from './docker/exec'
 import { stopContainerByName } from './docker/stop'
 import { runContainer } from './docker/run'
-import { boot } from './init/booter'
+import { boot, bootClean, bootExtra } from './init/booter'
+import { startCoop } from './init/cooperative'
 import { sleep } from './utils'
 import { checkHealth } from './docker/health'
 import { clearDB, clearDirectory, deleteFile } from './docker/purge'
@@ -126,7 +127,7 @@ program
       await checkHealth()
       await boot()
       console.log(`
-        
+
 Boot is
  .d8888b.   .d88888b.  888b     d888 8888888b.  888      8888888888 88888888888 8888888888
 d88P  Y88b d88P" "Y88b 8888b   d8888 888   Y88b 888      888            888     888
@@ -136,7 +137,7 @@ d88P  Y88b d88P" "Y88b 8888b   d8888 888   Y88b 888      888            888
 888    888 888     888 888  Y8P  888 888        888      888            888     888
 Y88b  d88P Y88b. .d88P 888   "   888 888        888      888            888     888
  "Y8888P"   "Y88888P"  888       888 888        88888888 8888888888     888     8888888888
- 
+
  `)
       process.exit(0)
     }
@@ -146,6 +147,111 @@ Y88b  d88P Y88b. .d88P 888   "   888 888        888      888            888
     }
   })
 
+// Команда для получения списка контейнеров
+program
+  .command('boot:clean')
+  .description('Boot infrastructure without initial data and cooperatives')
+  .action(async () => {
+    try {
+      await stopContainerByName('node')
+    }
+    catch (e) {
+      console.log('Нет контейнера для остановки. Стартуем новый..')
+    }
+
+    try {
+      await runContainer()
+
+      await sleep(5000)
+      await checkHealth()
+      await bootClean()
+      console.log(`
+
+Boot Clean is
+ .d8888b.   .d88888b.  888b     d888 8888888b.  888      8888888888 88888888888 8888888888
+d88P  Y88b d88P" "Y88b 8888b   d8888 888   Y88b 888      888            888     888
+888    888 888     888 88888b.d88888 888    888 888      888            888     888
+888        888     888 888Y88888P888 888   d88P 888      8888888        888     8888888
+888        888     888 888 Y888P 888 8888888P"  888      888            888     888
+888    888 888     888 888  Y8P  888 888        888      888            888     888
+Y88b  d88P Y88b. .d88P 888   "   888 888        888      888            888     888
+ "Y8888P"   "Y88888P"  888       888 888        88888888 8888888888     888     8888888888
+
+ `)
+      process.exit(0)
+    }
+    catch (error) {
+      console.error('Failed to boot clean:', error)
+      process.exit(1)
+    }
+  })
+
+// Команда для получения списка контейнеров
+program
+  .command('boot:extra')
+  .description('Boot infrastructure with extended initial data and additional shareholders')
+  .action(async () => {
+    try {
+      await stopContainerByName('node')
+    }
+    catch (e) {
+      console.log('Нет контейнера для остановки. Стартуем новый..')
+    }
+
+    try {
+      await runContainer()
+
+      await sleep(5000)
+      await checkHealth()
+      await bootExtra()
+      const councilMembers = [
+        { username: 'ant', fullName: 'Иванов Иван Иванович', email: 'ivanov@example.com' },
+        { username: 'petr', fullName: 'Сидоров Петр Сергеевич', email: 'sidorov@example.com' },
+        { username: 'anna', fullName: 'Петрова Анна Ивановна', email: 'petrova@example.com' },
+        { username: 'mikhail', fullName: 'Кузнецов Михаил Андреевич', email: 'kuznetsov@example.com' },
+        { username: 'olga', fullName: 'Соколова Ольга Викторовна', email: 'sokolova@example.com' },
+      ]
+
+      console.log('\nЧлены совета (логин / ФИО / email):')
+      for (const member of councilMembers)
+        console.log(` - ${member.username}: ${member.fullName} / ${member.email}`)
+      console.log(`
+
+Boot Extra is
+ .d8888b.   .d88888b.  888b     d888 8888888b.  888      8888888888 88888888888 8888888888
+d88P  Y88b d88P" "Y88b 8888b   d8888 888   Y88b 888      888            888     888
+888    888 888     888 88888b.d88888 888    888 888      888            888     888
+888        888     888 888Y88888P888 888   d88P 888      8888888        888     8888888
+888        888     888 888 Y888P 888 8888888P"  888      888            888     888
+888    888 888     888 888  Y8P  888 888        888      888            888     888
+Y88b  d88P Y88b. .d88P 888   "   888 888        888      888            888     888
+ "Y8888P"   "Y88888P"  888       888 888        88888888 8888888888     888     8888888888
+
+ `)
+      process.exit(0)
+    }
+    catch (error) {
+      console.error('Failed to boot extra:', error)
+      process.exit(1)
+    }
+  })
+
+// Команда для создания кооператива
+program
+  .command('create-coop')
+  .description('Create cooperative after clean boot')
+  .action(async () => {
+    try {
+      await startCoop()
+      console.log('Кооператив успешно создан')
+      process.exit(0)
+    }
+    catch (error) {
+      console.error('Failed to create cooperative:', error)
+      process.exit(1)
+    }
+  })
+
 // Команда для получения списка контейнеров
 program
   .command('clear')

components/boot/src/init/booter.ts

@@ -1,7 +1,35 @@
-import { startInfra } from './infra'
-import { startCoop } from './cooperative'
+import config from '../configs'
+import { initExtensionsInPostgres, initSystemStatus } from '../postgres-init'
+import { installExtraData, installInitialData, startInfra } from './infra'
+import { CooperativeClass, startCoop } from './cooperative'
 
 export async function boot() {
-  await startInfra()
+  const blockchain = await startInfra()
+  await installInitialData(blockchain, false) // Создать базовый совет
+
+  console.log('Инициализируем статус системы в PostgreSQL')
+  await initSystemStatus()
+
   await startCoop()
 }
+
+export async function bootClean() {
+  const blockchain = await startInfra()
+
+  console.log('Создаём программы (Благорост и маркетплейс)')
+
+  const cooperative = new CooperativeClass(blockchain)
+  await cooperative.createPrograms(config.provider)
+}
+
+export async function bootExtra() {
+  const blockchain = await startInfra()
+  await installInitialData(blockchain, true) // Создать расширенный совет (устанавливает статус 'active' в MongoDB)
+  await installExtraData(blockchain) // Добавить дополнительных пайщиков
+
+  console.log('Инициализируем статус системы в PostgreSQL')
+  await initSystemStatus() // Устанавливает статус 'active' в PostgreSQL
+
+  console.log('Инициализируем extensions в PostgreSQL')
+  await initExtensionsInPostgres() // Инициализирует таблицу extensions с данными capital
+}

components/boot/src/init/cooperative.ts

@@ -58,8 +58,8 @@ export class CooperativeClass {
     await this.blockchain.createProgram({
       coopname,
       username: coopname,
-      type: 'source',
-      title: 'Генерация',
+      type: 'generator',
+      title: 'Целевая потребительская программа "Генератор"',
       announce: '',
       description: '',
       preview: '',
@@ -74,8 +74,8 @@ export class CooperativeClass {
     await this.blockchain.createProgram({
       coopname,
       username: coopname,
-      type: 'capital',
-      title: 'Благосостояние',
+      type: 'blagorost',
+      title: 'Целевая потребительская программа "Благорост"',
       announce: '',
       description: '',
       preview: '',
@@ -202,18 +202,18 @@ export async function startCoop() {
   const blockchain = new Blockchain(config.network, config.private_keys)
   const cooperative = new CooperativeClass(blockchain)
 
-  await cooperative.createCooperative('cooperative1', {
-    // eslint-disable-next-line node/prefer-global/process
-    privateKey: process.env.EOSIO_PRV_KEY!,
-    // eslint-disable-next-line node/prefer-global/process
-    publicKey: process.env.EOSIO_PUB_KEY!,
-  })
+  // await cooperative.createCooperative('cooperative1', {
+  //   // eslint-disable-next-line node/prefer-global/process
+  //   privateKey: process.env.EOSIO_PRV_KEY!,
+  //   // eslint-disable-next-line node/prefer-global/process
+  //   publicKey: process.env.EOSIO_PUB_KEY!,
+  // })
 
-  await blockchain.preInit({
-    coopname: 'cooperative1',
-    username: config.provider,
-    status: 'active',
-  })
+  // await blockchain.preInit({
+  //   coopname: 'cooperative1',
+  //   username: config.provider,
+  //   status: 'active',
+  // })
 
   console.log('Кооператив предварительно подготовлен к установке совета.')
 }

components/boot/src/init/infra.ts

@@ -3,11 +3,12 @@ import axios from 'axios'
 import { Generator, Registry } from '@coopenomics/factory'
 import type { Cooperative } from 'cooptypes'
 import { DraftContract } from 'cooptypes'
-import mongoose from 'mongoose'
+import mongoose, { Types } from 'mongoose'
 import type { Account, Contract } from '../types'
 import config from '../configs'
 import Blockchain from '../blockchain'
 import { sleep } from '../utils'
+import { initUsersInPostgres, initVaultInPostgres } from '../postgres-init'
 import { CooperativeClass } from './cooperative'
 
 export async function startInfra() {
@@ -145,10 +146,32 @@ export async function startInfra() {
     })
   }
 
+  console.log(`Арендуем ресурсы провайдеру`)
+  await blockchain.powerup({
+    payer: 'eosio',
+    receiver: config.provider,
+    days: config.powerup.days,
+    payment: `10000.0000 ${config.token.symbol}`,
+    transfer: true,
+  })
+
+  await blockchain.transfer({
+    from: 'eosio',
+    to: config.provider,
+    quantity: `1000.0000 ${config.token.symbol}`,
+    memo: '',
+  })
+
+  console.log('Базовая инфраструктура установлена')
+
+  return blockchain
+}
+
+export async function installInitialData(blockchain: Blockchain, isExtended = false) {
   const organizationData: Cooperative.Users.IOrganizationData = {
     username: 'voskhod',
     type: 'coop',
-    short_name: '"ПК Восход"',
+    short_name: 'ПК "Восход"',
     full_name: 'Потребительский Кооператив "ВОСХОД"',
     represented_by: {
       first_name: 'Иван',
@@ -220,9 +243,9 @@ export async function startInfra() {
   // добавляем переменные кооператива
   const vars: Cooperative.Model.IVars = {
     coopname: 'voskhod',
-    full_abbr: 'потребительский кооператив',
-    full_abbr_genitive: 'потребительского кооператива',
-    full_abbr_dative: 'потребительскому кооперативу',
+    full_abbr: 'Потребительский Кооператив',
+    full_abbr_genitive: 'Потребительского Кооператива',
+    full_abbr_dative: 'Потребительскому Кооперативу',
     short_abbr: 'ПК',
     website: 'цифровой-кооператив.рф',
     name: 'Восход',
@@ -250,13 +273,55 @@ export async function startInfra() {
       protocol_number: '10-04-2024',
       protocol_day_month_year: '10 апреля 2024 г.',
     },
+    generator_program: {
+      protocol_number: '1',
+      protocol_day_month_year: '09.02.2026 10:24',
+    },
+    generation_contract_template: {
+      protocol_number: '2',
+      protocol_day_month_year: '09.02.2026 10:24',
+    },
+    blagorost_program: {
+      protocol_number: '3',
+      protocol_day_month_year: '09.02.2026 10:24',
+    },
+    generator_offer_template: {
+      protocol_number: '4',
+      protocol_day_month_year: '09.02.2026 10:27',
+    },
+    blagorost_offer_template: {
+      protocol_number: '5',
+      protocol_day_month_year: '09.02.2026 10:27',
+    },
+    deleted: false,
+    block_num: 1,
   }
 
-  await generator.save('vars', vars)
-
+  // Сохраняем vars с указанием конкретного _id и _created_at
   // eslint-disable-next-line node/prefer-global/process
   await mongoose.connect(process.env.MONGO_URI as string)
 
+  try {
+    await mongoose.connection.collection('vars').insertOne({
+      _id: new Types.ObjectId('69898c7d996550b4db4b1a36'),
+      _created_at: new Date('2026-02-08T13:29:12.423Z'),
+      ...vars,
+    })
+    console.log('Vars сохранены с указанным _id и _created_at')
+  }
+  catch (e) {
+    console.log('Vars уже существуют, обновляем...')
+    await mongoose.connection.collection('vars').updateOne(
+      { coopname: 'voskhod' },
+      {
+        $set: {
+          ...vars,
+          _created_at: new Date('2026-02-08T13:29:12.423Z'),
+        },
+      },
+    )
+  }
+
   try {
     await mongoose.connection.collection('sync').deleteMany({})
     console.log('Все документы удалены из коллекции sync')
@@ -281,17 +346,17 @@ export async function startInfra() {
     console.error('Ошибка при удалении:', e)
   }
 
-  // добавляем пользователя для подключений
-  try {
-    await mongoose.connection.collection('users').insertOne({
-      email: 'ivanov@example.com',
+  // Собираем пользователей для инициализации в PostgreSQL
+  const usersToInit = [
+    {
       username: 'ant',
-      type: 'individual',
+      email: 'ivanov@example.com',
+      type: 'individual' as const,
       role: 'chairman',
+      status: 'active',
       is_registered: true,
-    })
-  }
-  catch (e) { console.log('user is exist') }
+    },
+  ]
 
   // имитируем установку
   try {
@@ -312,27 +377,195 @@ export async function startInfra() {
     })
   }
   catch (e) { console.log('vault is exist') }
+
+  console.log('Добавляем пайщика ant')
+
+  await blockchain.addUser({
+    coopname: 'voskhod',
+    referer: '',
+    username: 'ant',
+    type: 'individual',
+    created_at: '2025-01-15T10:00:00',
+    initial: '100.0000 RUB',
+    minimum: '200.0000 RUB',
+    spread_initial: true,
+    meta: 'Основатель кооператива ВОСХОД',
+  })
+
+  console.log('Устанавливаем дефолтный публичный ключ для ant')
+
+  await blockchain.changeKey({
+    coopname: 'voskhod',
+    changer: 'voskhod',
+    username: 'ant',
+    public_key: config.default_public_key,
+  })
+
+  // Если расширенный режим, сначала добавляем дополнительных пайщиков
+  if (isExtended) {
+    console.log('Добавляем дополнительных пайщиков для расширенного совета')
+
+    const extraUsers = [
+      {
+        username: 'petr',
+        first_name: 'Петр',
+        last_name: 'Сидоров',
+        middle_name: 'Сергеевич',
+        email: 'sidorov@example.com',
+      },
+      {
+        username: 'anna',
+        first_name: 'Анна',
+        last_name: 'Петрова',
+        middle_name: 'Ивановна',
+        email: 'petrova@example.com',
+      },
+      {
+        username: 'mikhail',
+        first_name: 'Михаил',
+        last_name: 'Кузнецов',
+        middle_name: 'Андреевич',
+        email: 'kuznetsov@example.com',
+      },
+      {
+        username: 'olga',
+        first_name: 'Ольга',
+        last_name: 'Соколова',
+        middle_name: 'Викторовна',
+        email: 'sokolova@example.com',
+      },
+    ]
+
+    for (const user of extraUsers) {
+      // Добавляем в MongoDB
+      const userData: Cooperative.Users.IIndividualData = {
+        username: user.username,
+        first_name: user.first_name,
+        last_name: user.last_name,
+        middle_name: user.middle_name,
+        birthdate: '1990/04/01',
+        phone: '+71234567890',
+        email: user.email,
+        full_address: 'г. Москва, ул. Примерная д. 1',
+        passport: {
+          series: 7122,
+          number: Math.floor(Math.random() * 900000) + 100000,
+          issued_by: 'отделом УФМС по г. Москва',
+          issued_at: '2010/05/10',
+          code: '111-232',
+        },
+      }
+
+      await generator.save('individual', userData)
+
+      // Добавляем пользователя в список для PostgreSQL
+      usersToInit.push({
+        username: user.username,
+        email: user.email,
+        type: 'individual' as const,
+        role: 'member',
+        status: 'active',
+        is_registered: true,
+      })
+
+      console.log(`Добавляем пайщика ${user.username}`)
+
+      // Добавляем в блокчейн
+      await blockchain.addUser({
+        coopname: 'voskhod',
+        referer: user.username === 'petr' ? '' : 'petr',
+        username: user.username,
+        type: 'individual',
+        created_at: '2025-01-15T10:00:00',
+        initial: '100.0000 RUB',
+        minimum: '300.0000 RUB',
+        spread_initial: true,
+        meta: `Член совета кооператива ВОСХОД - ${user.first_name} ${user.middle_name} ${user.last_name}`,
+      })
+
+      console.log(`Устанавливаем дефолтный публичный ключ для ${user.username}`)
+
+      await blockchain.changeKey({
+        coopname: 'voskhod',
+        changer: 'voskhod',
+        username: user.username,
+        public_key: config.default_public_key,
+      })
+    }
+  }
+
+  console.log('Инициализируем пользователей в PostgreSQL')
+  await initUsersInPostgres(usersToInit)
+
+  console.log('Инициализируем vault в PostgreSQL')
+  await initVaultInPostgres()
+
+  console.log('Создаём совет')
+
+  const boardMembers: Array<{
+    username: string
+    is_voting: boolean
+    position_title: string
+    position: 'chairman' | 'member'
+  }> = [
+    {
+      username: 'ant',
+      is_voting: true,
+      position_title: 'Председатель совета',
+      position: 'chairman',
+    },
+  ]
+
+  // Если расширенный режим, добавляем дополнительных членов
+  if (isExtended) {
+    boardMembers.push(
+      {
+        username: 'petr',
+        is_voting: true,
+        position_title: 'Член совета',
+        position: 'member',
+      },
+      {
+        username: 'anna',
+        is_voting: true,
+        position_title: 'Член совета',
+        position: 'member',
+      },
+      {
+        username: 'mikhail',
+        is_voting: true,
+        position_title: 'Член совета',
+        position: 'member',
+      },
+      {
+        username: 'olga',
+        is_voting: true,
+        position_title: 'Член совета',
+        position: 'member',
+      },
+    )
+  }
+
+  await blockchain.createBoard({
+    coopname: 'voskhod',
+    username: 'ant',
+    type: 'soviet',
+    members: boardMembers,
+    name: 'Совет',
+    description: isExtended ? 'Совет кооператива ВОСХОД (расширенный состав)' : 'Совет кооператива ВОСХОД',
+  })
+
   console.log('Создаём программы и соглашения')
 
   const cooperative = new CooperativeClass(blockchain)
 
   await cooperative.createPrograms(config.provider)
 
-  console.log(`Арендуем ресурсы провайдеру`)
-  await blockchain.powerup({
-    payer: 'eosio',
-    receiver: config.provider,
-    days: config.powerup.days,
-    payment: `100.0000 ${config.token.symbol}`,
-    transfer: true,
-  })
-
-  await blockchain.transfer({
-    from: 'eosio',
-    to: config.provider,
-    quantity: `1000.0000 ${config.token.symbol}`,
-    memo: '',
-  })
-
-  console.log('Базовая установка завершена')
+  console.log('Начальные данные установлены')
+}
+
+export async function installExtraData(blockchain: Blockchain) {
+  // В расширенном режиме пайщики уже добавлены в installInitialData
+  // Здесь можно добавить дополнительную логику инициализации если потребуется
+  console.log('Дополнительная инициализация для расширенного режима выполнена')
 }

components/boot/src/postgres-init.ts

@@ -0,0 +1,294 @@
+/* eslint-disable node/prefer-global/process */
+import { Client } from 'pg'
+import type { Cooperative } from 'cooptypes'
+
+export async function initSystemStatus() {
+  console.log('Инициализация статуса системы для coopname: voskhod')
+
+  const client = new Client({
+    host: process.env.POSTGRES_HOST,
+    port: parseInt(process.env.POSTGRES_PORT || '5432'),
+    user: process.env.POSTGRES_USERNAME,
+    password: process.env.POSTGRES_PASSWORD,
+    database: process.env.POSTGRES_DATABASE,
+  })
+
+  try {
+    await client.connect()
+    console.log('Подключение к PostgreSQL установлено для initSystemStatus')
+
+    // Создаем enum тип для статуса системы
+    try {
+      await client.query(`
+        CREATE TYPE public.system_status_status_enum AS ENUM ('install', 'initialized', 'active', 'maintenance')
+      `)
+    }
+    catch (error) {
+      // Тип уже существует, продолжаем
+      console.log('Enum тип system_status_status_enum уже существует, пропускаем создание')
+    }
+
+    // Создаем таблицу system_status правильно, как в TypeORM entity
+    await client.query(`
+      CREATE TABLE IF NOT EXISTS public.system_status (
+        coopname varchar(12) NOT NULL,
+        install_code varchar(255) NULL,
+        install_code_expires_at timestamp NULL,
+        init_by_server bool NOT NULL DEFAULT false,
+        created_at timestamp NOT NULL DEFAULT now(),
+        updated_at timestamp NOT NULL DEFAULT now(),
+        status public.system_status_status_enum NOT NULL DEFAULT 'install'::system_status_status_enum,
+        CONSTRAINT system_status_pkey PRIMARY KEY (coopname)
+      )
+    `)
+
+    try {
+    // Устанавливаем начальный статус для voskhod (active - система готова к работе)
+      await client.query(`
+      INSERT INTO system_status (coopname, status)
+      VALUES ('voskhod', 'active')
+      ON CONFLICT (coopname) DO UPDATE SET
+        status = EXCLUDED.status,
+        updated_at = CURRENT_TIMESTAMP
+    `)
+
+      // Проверяем, что статус действительно установлен
+      const result = await client.query(`
+        SELECT status FROM system_status WHERE coopname = 'voskhod'
+      `)
+      console.log('Статус системы в PostgreSQL после установки:', result.rows[0]?.status)
+    }
+    catch (queryError) {
+      console.error('Ошибка при установке статуса системы в PostgreSQL:', queryError)
+      throw queryError
+    }
+
+    console.log('Статус системы инициализирован в PostgreSQL')
+  }
+  catch (error) {
+    console.error('Ошибка инициализации статуса системы в PostgreSQL:', error)
+    throw error
+  }
+  finally {
+    await client.end()
+  }
+}
+
+export async function initUsersInPostgres(
+  users: Array<{
+    username: string
+    email: string
+    type: 'individual' | 'entrepreneur' | 'organization'
+    role: string
+    status: string
+    is_registered: boolean
+  }>,
+) {
+  const client = new Client({
+    host: process.env.POSTGRES_HOST,
+    port: parseInt(process.env.POSTGRES_PORT || '5432'),
+    user: process.env.POSTGRES_USERNAME,
+    password: process.env.POSTGRES_PASSWORD,
+    database: process.env.POSTGRES_DATABASE,
+  })
+
+  try {
+    await client.connect()
+    console.log('Подключение к PostgreSQL установлено для инициализации пользователей')
+
+    // Создаем таблицу users, если она не существует
+    await client.query(`
+      CREATE TABLE IF NOT EXISTS "users" (
+        id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+        username VARCHAR(50) UNIQUE NOT NULL,
+        status VARCHAR(20) DEFAULT 'created',
+        message TEXT DEFAULT '',
+        is_registered BOOLEAN DEFAULT FALSE,
+        has_account BOOLEAN DEFAULT FALSE,
+        type VARCHAR(20) NOT NULL,
+        public_key TEXT DEFAULT '',
+        referer VARCHAR(100) DEFAULT '',
+        email VARCHAR(255),
+        role VARCHAR(20) DEFAULT 'user',
+        is_email_verified BOOLEAN DEFAULT FALSE,
+        subscriber_id VARCHAR(100) DEFAULT '',
+        subscriber_hash VARCHAR(255) DEFAULT '',
+        legacy_mongo_id VARCHAR(50),
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+      )
+    `)
+
+    // Создаем пользователей
+    for (const user of users) {
+      // Проверяем, что username не null и не пустой
+      if (!user.username || user.username.trim() === '') {
+        console.warn(`Пропускаем пользователя с пустым username:`, user)
+        continue
+      }
+
+      await client.query(`
+        INSERT INTO "users" (
+          username, email, type, role, status, is_registered,
+          has_account, is_email_verified, created_at, updated_at
+        )
+        VALUES ($1, $2, $3, $4, $5, $6, $7, $8, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
+        ON CONFLICT (username) DO NOTHING
+      `, [
+        user.username,
+        user.email,
+        user.type,
+        user.role,
+        user.status,
+        user.is_registered,
+        false, // has_account
+        true, // is_email_verified
+      ])
+    }
+
+    console.log(`Инициализировано ${users.length} пользователей в PostgreSQL`)
+  }
+  catch (error) {
+    console.error('Ошибка инициализации пользователей в PostgreSQL:', error)
+    throw error
+  }
+  finally {
+    await client.end()
+  }
+}
+
+export async function initVaultInPostgres() {
+  const client = new Client({
+    host: process.env.POSTGRES_HOST,
+    port: parseInt(process.env.POSTGRES_PORT || '5432'),
+    user: process.env.POSTGRES_USERNAME,
+    password: process.env.POSTGRES_PASSWORD,
+    database: process.env.POSTGRES_DATABASE,
+  })
+
+  try {
+    await client.connect()
+    console.log('Подключение к PostgreSQL установлено для инициализации vault')
+
+    // Создаем таблицу vaults, если она не существует
+    await client.query(`
+      CREATE TABLE IF NOT EXISTS "vaults" (
+        id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+        username VARCHAR(50) NOT NULL,
+        permission VARCHAR(20) DEFAULT 'active',
+        wif TEXT NOT NULL,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        UNIQUE(username, permission)
+      )
+    `)
+
+    // Создаем индексы
+    await client.query(`CREATE INDEX IF NOT EXISTS idx_vaults_username ON "vaults"(username)`)
+    await client.query(`CREATE INDEX IF NOT EXISTS idx_vaults_username_permission ON "vaults"(username, permission)`)
+
+    // Сохраняем зашифрованный ключ в vault
+    await client.query(`
+      INSERT INTO "vaults" (username, permission, wif, created_at, updated_at)
+      VALUES ($1, $2, $3, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
+      ON CONFLICT (username, permission) DO NOTHING
+    `, [
+      'voskhod',
+      'active',
+      '9d6479a9d77ead53fb0e5e54b3608a95:2046ee3c1577d48aecbee49e8f25c4c2df37ab02f15d73d0d1b6352f53a4b774cb9e71b6028fd7caf64568e195c7878dfbb5d2bf10a3766d90ba9e92ea724428',
+    ])
+
+    console.log('Vault инициализирован в PostgreSQL')
+  }
+  catch (error) {
+    console.error('Ошибка инициализации vault в PostgreSQL:', error)
+    throw error
+  }
+  finally {
+    await client.end()
+  }
+}
+
+export async function initExtensionsInPostgres() {
+  const client = new Client({
+    host: process.env.POSTGRES_HOST,
+    port: parseInt(process.env.POSTGRES_PORT || '5432'),
+    user: process.env.POSTGRES_USERNAME,
+    password: process.env.POSTGRES_PASSWORD,
+    database: process.env.POSTGRES_DATABASE,
+  })
+
+  try {
+    await client.connect()
+    console.log('Подключение к PostgreSQL установлено для инициализации extensions')
+
+    // Создаем таблицу extensions по аналогии с ExtensionEntity
+    await client.query(`
+      CREATE TABLE IF NOT EXISTS "extensions" (
+        name VARCHAR(12) PRIMARY KEY,
+        enabled BOOLEAN DEFAULT true,
+        config JSONB DEFAULT '{}',
+        schema_version INTEGER DEFAULT 1,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+      )
+    `)
+
+    // Создаем индексы
+    await client.query(`CREATE INDEX IF NOT EXISTS idx_extensions_name ON "extensions"(name)`)
+    await client.query(`CREATE INDEX IF NOT EXISTS idx_extensions_enabled ON "extensions"(enabled)`)
+
+    // Вставляем запись для capital extension
+    const capitalConfig = {
+      level_depth_base: 100000000,
+      github_repository: "coopenomics/results-test",
+      onboarding_init_at: "2026-02-09T07:16:18.380Z",
+      expense_pool_percent: 100,
+      onboarding_expire_at: "2026-03-11T07:16:18.380Z",
+      voting_period_in_days: 1,
+      authors_voting_percent: 62.8,
+      creators_voting_percent: 62.8,
+      energy_gain_coefficient: 1,
+      level_growth_coefficient: 1.5,
+      coordinator_bonus_percent: 5,
+      energy_decay_rate_per_day: 0.02,
+      coordinator_invite_validity_days: 30,
+      onboarding_blagorost_provision_done: true,
+      onboarding_blagorost_provision_hash: "CDE57D987E3C945E79E108920CE02A4A80CFA7980CAA912949BB6C2111B7027A",
+      onboarding_blagorost_offer_template_done: true,
+      onboarding_blagorost_offer_template_hash: "5CA88BBD303E5CCDA01E565FFE47E51855515176EC6C957F0FBDBCA4C53DBFD2",
+      onboarding_generator_offer_template_done: true,
+      onboarding_generator_offer_template_hash: "8DA31574E8CC764C3A1FCAE1172726656A3DCDB1BB82AB0E567E2732070C3A44",
+      onboarding_generator_program_template_done: true,
+      onboarding_generator_program_template_hash: "E55564D8946C55C93490B5277968FC890FDCB10A049DB5B2E0FE9F67FDA80896",
+      onboarding_generation_contract_template_done: true,
+      onboarding_generation_contract_template_hash: "A4BD579D6130CCE2D8C34337DFA591807C1F028A148DD53689881B12AC2627E2"
+    }
+
+    await client.query(`
+      INSERT INTO "extensions" (name, enabled, config, schema_version, created_at, updated_at)
+      VALUES ($1, $2, $3, $4, $5, $6)
+      ON CONFLICT (name) DO UPDATE SET
+        enabled = EXCLUDED.enabled,
+        config = EXCLUDED.config,
+        schema_version = EXCLUDED.schema_version,
+        updated_at = CURRENT_TIMESTAMP
+    `, [
+      'capital',
+      true,
+      JSON.stringify(capitalConfig),
+      1,
+      new Date('2026-02-09T02:13:06.620Z'),
+      new Date('2026-02-09T02:27:57.155Z')
+    ])
+
+    console.log('Extensions инициализированы в PostgreSQL')
+  }
+  catch (error) {
+    console.error('Ошибка инициализации extensions в PostgreSQL:', error)
+    throw error
+  }
+  finally {
+    await client.end()
+  }
+}

components/boot/src/tests/capital-import.test.ts

@@ -188,7 +188,7 @@ describe('тест контракта CAPITAL', () => {
         fixed_membership_contribution: '0.0000 RUB',
         membership_percent_fee: '0',
         meta: '',
-        type: 'source',
+        type: 'generator',
       }
 
       const result = await blockchain.api.transact(
@@ -234,7 +234,7 @@ describe('тест контракта CAPITAL', () => {
         fixed_membership_contribution: '0.0000 RUB',
         membership_percent_fee: '0',
         meta: '',
-        type: 'capital',
+        type: 'blagorost',
       }
 
       const result = await blockchain.api.transact(
@@ -346,6 +346,10 @@ describe('тест контракта CAPITAL', () => {
         voting_period_in_days: 7,
         authors_voting_percent: 38.2,
         creators_voting_percent: 38.2,
+        energy_decay_rate_per_day: 0.11,
+        level_depth_base: 1000,
+        level_growth_coefficient: 1.5,
+        energy_gain_coefficient: 0.01,
       },
     }
 

components/boot/src/tests/capital/commitToResult.ts

@@ -63,6 +63,8 @@ export async function commitToResult(
     project_hash: projectHash,
     commit_hash: commitHash,
     creator_hours: spendHours,
+    description: `Коммит ${commitHash}`,
+    meta: `{"hours": ${spendHours}, "creator": "${creator}"}`,
   }
 
   const createCommitResult = await blockchain.api.transact(

components/boot/src/tests/capital/consts.ts

@@ -2,6 +2,6 @@ export const sourceProgramId = 3
 export const capitalProgramId = 4
 export const walletProgramId = 1
 export const ratePerHour = '1000.0000 RUB'
-export const sourceProgramName = 'source'
-export const capitalProgramName = 'capital'
-export const circulationAccountId = 80
+export const sourceProgramName = 'generator'
+export const capitalProgramName = 'blagorost'
+export const circulationAccountId = 80

components/boot/src/tests/capital/investInProject.ts

@@ -4,9 +4,10 @@ import { getTotalRamUsage } from '../../utils/getTotalRamUsage'
 import { generateRandomSHA256 } from '../../utils/randomHash'
 import { getCoopProgramWallet, getUserProgramWallet } from '../wallet/walletUtils'
 import { processDecision } from '../soviet/processDecision'
+import { consoleIt } from '../shared'
 import { processApprove } from './processApprove'
 import { getSegment } from './getSegment'
-import { sourceProgramId } from './consts'
+import { capitalProgramId, walletProgramId } from './consts'
 
 export async function investInProject(
   blockchain: any,
@@ -30,14 +31,16 @@ export async function investInProject(
     'sha256',
   ))[0] || { invested: '0.0000 RUB', available: '0.0000 RUB' }
 
-  const prevUserWallet = await getUserProgramWallet(blockchain, coopname, investor, sourceProgramId) || { blocked: '0.0000 RUB' }
-  const prevProgramWallet = await getCoopProgramWallet(blockchain, coopname, sourceProgramId) || { blocked: '0.0000 RUB', share_contributions: '0.0000 RUB' }
+  const prevWalletWallet = await getUserProgramWallet(blockchain, coopname, investor, walletProgramId) || { blocked: '0.0000 RUB' }
+  const prevUserWallet = await getUserProgramWallet(blockchain, coopname, investor, capitalProgramId) || { blocked: '0.0000 RUB' }
+  const prevProgramWallet = await getCoopProgramWallet(blockchain, coopname, capitalProgramId) || { blocked: '0.0000 RUB', share_contributions: '0.0000 RUB' }
 
   console.log('📊 Балансы до инвестиции:')
   console.log('▶ Проект:', prevProject)
-  console.log('▶ Кошелек пользователя:', prevUserWallet)
-  console.log('▶ Кошелек программы:', prevProgramWallet)
-
+  console.log('▶ Главный кошелек пользователя:', prevWalletWallet)
+  console.log('▶ Кошелек пользователя (благорост):', prevUserWallet)
+  console.log('▶ Кошелек программы (благорост):', prevProgramWallet)
+  console.log('▶ Сумма инвестиции: ', investAmount)
   // Создание инвестиции
   const createInvestData: CapitalContract.Actions.CreateProjectInvest.ICreateInvest = {
     coopname,
@@ -65,28 +68,28 @@ export async function investInProject(
       expireSeconds: 30,
     },
   )
-
+  consoleIt(createInvestResult)
   getTotalRamUsage(createInvestResult)
   expect(createInvestResult.transaction_id).toBeDefined()
 
-  const blockchainInvest = (await blockchain.getTableRows(
-    CapitalContract.contractName.production,
-    coopname,
-    'invests',
-    1,
-    investHash,
-    investHash,
-    2,
-    'sha256',
-  ))[0]
+  // const blockchainInvest = (await blockchain.getTableRows(
+  //   CapitalContract.contractName.production,
+  //   coopname,
+  //   'invests',
+  //   1,
+  //   investHash,
+  //   investHash,
+  //   2,
+  //   'sha256',
+  // ))[0]
 
-  console.log('🔍 Инвестиция в блокчейне:', blockchainInvest)
-  expect(blockchainInvest).toBeDefined()
-  expect(blockchainInvest.status).toBe('created')
+  // console.log('🔍 Инвестиция в блокчейне:', blockchainInvest)
+  // expect(blockchainInvest).toBeDefined()
+  // expect(blockchainInvest.status).toBe('created')
 
   // Утверждение инвестиции
-  console.log(`\n✅ Подтверждение инвестиции ${investHash}`)
-  const approveInvestResult = await processApprove(blockchain, coopname, investHash)
+  // console.log(`\n✅ Подтверждение инвестиции ${investHash}`)
+  // const approveInvestResult = await processApprove(blockchain, coopname, investHash)
 
   // Проверка утвержденной инвестиции
   const blockchainEmptyInvest = (await blockchain.getTableRows(
@@ -114,8 +117,8 @@ export async function investInProject(
     'sha256',
   ))[0]
 
-  const finalUserWallet = await getUserProgramWallet(blockchain, coopname, investor, sourceProgramId)
-  const finalProgramWallet = await getCoopProgramWallet(blockchain, coopname, sourceProgramId)
+  const finalUserWallet = await getUserProgramWallet(blockchain, coopname, investor, capitalProgramId)
+  const finalProgramWallet = await getCoopProgramWallet(blockchain, coopname, capitalProgramId)
 
   // Получение сегмента инвестора для данного проекта
   const segment = await getSegment(blockchain, coopname, projectHash, investor)
@@ -123,8 +126,8 @@ export async function investInProject(
   console.log('\n📊 Балансы после инвестиции:')
   console.log('▶ Проект:', finalProject)
   console.log('▶ Сегмент:', segment)
-  console.log('▶ Кошелек пользователя:', finalUserWallet)
-  console.log('▶ Кошелек программы:', finalProgramWallet)
+  console.log('▶ Кошелек пользователя (благорост):', finalUserWallet)
+  console.log('▶ Кошелек программы (благорост):', finalProgramWallet)
 
   // Проверка изменения балансов
   expect(parseFloat(finalUserWallet.blocked)).toBeCloseTo(parseFloat(prevUserWallet.blocked) + parseFloat(investAmount), 1)
@@ -134,8 +137,8 @@ export async function investInProject(
 
   return {
     investHash,
-    invest: blockchainInvest,
-    transactionId: approveInvestResult.transaction_id,
+    // invest: blockchainInvest,
+    transactionId: createInvestResult.transaction_id,
     prevProject,
     project: finalProject,
     segment,

components/boot/src/tests/capital/processApprove.ts

@@ -8,6 +8,7 @@ export async function processApprove(blockchain: any, coopname: string, approval
 
   const data: SovietContract.Actions.Approves.ConfirmApprove.IConfirmApprove = {
     coopname,
+    username: 'ant',
     approval_hash: approvalHash,
     approved_document: fakeDocument,
   }

components/boot/src/tests/capital/processCompleteVoting.ts

@@ -68,8 +68,8 @@ export async function processCompleteVoting(
   console.log('▶ Голосов получено:', projectAfter.voting.votes_received)
   console.log('▶ Всего участников голосования:', projectAfter.voting.total_voters)
 
-  // Проверяем что статус изменился на completed
-  expect(projectAfter.status).toBe('completed')
+  // Проверяем что статус изменился на result
+  expect(projectAfter.status).toBe('result')
 
   console.log(`\n✅ Голосование для проекта ${project_hash} успешно завершено!`)
 

components/boot/src/tests/capital/processConvertSegment.ts

@@ -58,7 +58,6 @@ export async function processConvertSegment(
     convert_hash: convertHash,
     wallet_amount: walletAmount,
     capital_amount: capitalAmount,
-    project_amount: projectAmount,
     convert_statement: fakeDocument,
   }
 
@@ -121,22 +120,26 @@ export async function processConvertSegment(
   }
 
   // Проверяем глобальный кошелек программы капитализации (capital_amount)
+  // investor_base уже заблокирован в _capital_program при инвестировании (createinvest)
+  // В capitalAmount теперь передается только чистая дельта интеллектуального вклада
   if (capitalAmount !== '0.0000 RUB') {
     const capitalAmountValue = parseFloat(capitalAmount.split(' ')[0])
+    const actualCapitalIncrease = capitalAmountValue
     const beforeBlocked = capitalWalletBefore ? parseFloat(capitalWalletBefore.blocked.split(' ')[0]) : 0
     const afterBlocked = capitalWalletAfter ? parseFloat(capitalWalletAfter.blocked.split(' ')[0]) : 0
-    const expectedIncrease = beforeBlocked + capitalAmountValue
-    console.log(`✅ Глобальный кошелек программы капитализации: ${beforeBlocked} → ${afterBlocked} (+${capitalAmountValue})`)
+    const expectedIncrease = beforeBlocked + actualCapitalIncrease
+    console.log(`✅ Глобальный кошелек программы капитализации: ${beforeBlocked} → ${afterBlocked} (+${actualCapitalIncrease})`)
     expect(afterBlocked).toBeCloseTo(expectedIncrease, 1)
   }
 
   // Проверяем кошелек пользователя в программе капитализации (capital_amount)
   if (capitalAmount !== '0.0000 RUB') {
     const capitalAmountValue = parseFloat(capitalAmount.split(' ')[0])
+    const actualCapitalIncrease = capitalAmountValue
     const beforeBlocked = userCapitalWalletBefore ? parseFloat(userCapitalWalletBefore.blocked.split(' ')[0]) : 0
     const afterBlocked = userCapitalWalletAfter ? parseFloat(userCapitalWalletAfter.blocked.split(' ')[0]) : 0
-    const expectedIncrease = beforeBlocked + capitalAmountValue
-    console.log(`✅ Кошелек пользователя в программе капитализации: ${beforeBlocked} → ${afterBlocked} (+${capitalAmountValue})`)
+    const expectedIncrease = beforeBlocked + actualCapitalIncrease
+    console.log(`✅ Кошелек пользователя в программе капитализации: ${beforeBlocked} → ${afterBlocked} (+${actualCapitalIncrease})`)
     expect(afterBlocked).toBeCloseTo(expectedIncrease, 1)
   }
 

components/boot/src/tests/capital/processDebt.ts

@@ -95,13 +95,13 @@ export async function processDebt(
   // 2. Одобряем долг через processApprove (soviet контракт)
   console.log(`\n✅ Подтверждение долга ${debtHash} через soviet`)
   await processApprove(blockchain, coopname, debtHash)
-  console.log('✅ Долг одобрен советом')
+  console.log('✅ Долг одобрен председателем (создана agenda)')
 
-  // 3. Процессим решение совета
+  // 3. Процессим решение совета (agenda для авторизации долга)
   await processLastDecision(blockchain, coopname)
-  console.log('✅ Решение совета принято')
+  console.log('✅ Решение совета принято (долг авторизован, outcome создан)')
 
-  // 5. Подтверждаем завершение вывода (gateway сам вызовет callback на capital)
+  // 4. Подтверждаем завершение вывода (gateway сам вызовет callback на capital)
   const confirmOutcomeData: GatewayContract.Actions.CompleteOutcome.ICompleteOutcome = {
     coopname,
     outcome_hash: debtHash,

components/boot/src/tests/capital/processStartVoting.ts

@@ -20,7 +20,7 @@ export async function processStartVoting(
     3,
     'sha256',
   ))[0]
-
+  console.log('projectBefore: ', projectBefore)
   // 1) Запускаем голосование по проекту
   const txStart = await blockchain.api.transact(
     {
@@ -49,7 +49,7 @@ export async function processStartVoting(
     3,
     'sha256',
   ))[0]
-
+  console.log('projectAfter: ', projectAfter)
   return {
     projectHash: project_hash,
     txStartId: txStart.transaction_id,

components/boot/src/tests/capital/registerContributor.ts

@@ -10,6 +10,7 @@ export async function registerContributor(
   username: string,
   contributorHash: string,
   ratePerHour: string,
+  hoursPerDay: number = 8,
 ) {
   const contract = fakeDocument
   contract.signatures[0].signer = username
@@ -18,8 +19,12 @@ export async function registerContributor(
     username,
     contributor_hash: contributorHash,
     rate_per_hour: ratePerHour,
+    hours_per_day: hoursPerDay,
     is_external_contract: false,
     contract,
+    storage_agreement: fakeDocument,
+    generator_agreement: fakeDocument,
+    blagorost_agreement: fakeDocument,
   }
 
   const result = await blockchain.api.transact(

components/boot/src/tests/capital/signGenerationAgreement.ts

@@ -3,7 +3,7 @@ import { signAgreement } from '../soviet/signAgreement'
 import { getCoopProgramWallet, getUserProgramWallet } from '../wallet/walletUtils'
 import { sourceProgramId, sourceProgramName } from './consts'
 
-export async function signGenerationAgreement(
+export async function signGenerationContract(
   blockchain: any,
   coopname: string,
   username: string,

components/boot/src/tests/soviet/processLastDecision.ts

@@ -8,9 +8,11 @@ export async function processLastDecision(blockchain: Blockchain, coopname: stri
     SovietContract.contractName.production,
     coopname,
     SovietContract.Tables.Decisions.tableName,
-    1,
+    100, // берем больше, чтобы гарантированно получить все
   )
-  const lastDecision = decisions[0]
+  console.log('Активные вопросы на повестке: ', decisions)
+  // Берем ПОСЛЕДНИЙ элемент массива (самый свежий)
+  const lastDecision = decisions[decisions.length - 1]
 
   // 3. Голосуем за решение совета
   await processDecision(blockchain, lastDecision.id)

components/boot/src/utils/index.ts

@@ -16,3 +16,5 @@ export async function sendPostToCoopbackWithSecret(url: string, data: any) {
     },
   })
 }
+
+export * from './randomData'

components/boot/src/utils/randomData.ts

@@ -0,0 +1,180 @@
+import { randomBytes } from 'node:crypto'
+
+/**
+ * Генерирует случайное текстовое содержимое для проектов
+ * @param minLength минимальная длина текста (по умолчанию 500)
+ * @param maxLength максимальная длина текста (по умолчанию 2000)
+ * @returns строка с случайным текстовым содержимым
+ */
+export function generateRandomProjectData(minLength = 500, maxLength = 2000): string {
+  const templates = [
+    'Описание проекта',
+    'Цели и задачи',
+    'Ожидаемые результаты',
+    'Этапы реализации',
+    'Требования к участникам',
+    'Технические спецификации',
+    'План работ',
+    'Бюджет проекта',
+    'Риски и ограничения',
+    'Методология',
+  ]
+
+  const words = [
+    'разработка',
+    'система',
+    'модуль',
+    'компонент',
+    'интерфейс',
+    'база данных',
+    'архитектура',
+    'тестирование',
+    'оптимизация',
+    'интеграция',
+    'документация',
+    'анализ',
+    'проектирование',
+    'внедрение',
+    'поддержка',
+    'масштабирование',
+    'безопасность',
+    'производительность',
+    'надежность',
+    'мониторинг',
+    'отчетность',
+    'функциональность',
+    'пользователь',
+    'администратор',
+    'контент',
+    'данные',
+    'процесс',
+    'workflow',
+    'автоматизация',
+    'управление',
+    'контроль',
+  ]
+
+  const targetLength = Math.floor(Math.random() * (maxLength - minLength)) + minLength
+  let content = ''
+
+  // Добавляем секции
+  while (content.length < targetLength) {
+    const template = templates[Math.floor(Math.random() * templates.length)]
+    content += `\n\n## ${template}\n\n`
+
+    // Добавляем параграфы
+    const paragraphCount = Math.floor(Math.random() * 3) + 1
+    for (let i = 0; i < paragraphCount; i++) {
+      const sentenceCount = Math.floor(Math.random() * 5) + 3
+      for (let j = 0; j < sentenceCount; j++) {
+        const wordCount = Math.floor(Math.random() * 10) + 5
+        const sentence = []
+        for (let k = 0; k < wordCount; k++) {
+          sentence.push(words[Math.floor(Math.random() * words.length)])
+        }
+        content += `${sentence.join(' ')}. `
+      }
+      content += '\n\n'
+    }
+
+    // Добавляем случайные данные для разнообразия
+    if (Math.random() > 0.7) {
+      content += `\n### Дополнительная информация\n\n`
+      content += `ID: ${randomBytes(8).toString('hex')}\n`
+      content += `Timestamp: ${new Date().toISOString()}\n`
+      content += `Hash: ${randomBytes(16).toString('hex')}\n\n`
+    }
+  }
+
+  return content.substring(0, targetLength)
+}
+
+/**
+ * Генерирует расширенное описание проекта
+ */
+export function generateRandomDescription(): string {
+  const descriptions = [
+    'Инновационный проект по разработке современного решения для автоматизации бизнес-процессов',
+    'Комплексная система управления ресурсами предприятия с использованием передовых технологий',
+    'Платформа для координации работы распределенных команд и управления проектами',
+    'Решение для цифровой трансформации традиционных процессов с акцентом на эффективность',
+    'Система интеграции данных из различных источников с возможностью аналитики в реальном времени',
+  ]
+
+  const extras = [
+    'Включает модули отчетности, мониторинга и аналитики.',
+    'Поддерживает интеграцию с внешними системами через API.',
+    'Обеспечивает высокую производительность и масштабируемость.',
+    'Реализует современные подходы к безопасности данных.',
+    'Предоставляет интуитивный пользовательский интерфейс.',
+  ]
+
+  let result = descriptions[Math.floor(Math.random() * descriptions.length)]
+  result += ` ${extras[Math.floor(Math.random() * extras.length)]}`
+  result += ` ${extras[Math.floor(Math.random() * extras.length)]}`
+
+  return result
+}
+
+/**
+ * Генерирует метаданные проекта в виде JSON
+ */
+export function generateRandomMeta(): string {
+  const meta = {
+    version: `${Math.floor(Math.random() * 5) + 1}.${Math.floor(Math.random() * 10)}.${Math.floor(Math.random() * 100)}`,
+    category: ['development', 'infrastructure', 'analytics', 'automation'][Math.floor(Math.random() * 4)],
+    priority: ['low', 'medium', 'high', 'critical'][Math.floor(Math.random() * 4)],
+    tags: Array.from({ length: Math.floor(Math.random() * 5) + 3 }, () =>
+      ['backend', 'frontend', 'devops', 'testing', 'documentation', 'security', 'performance'][
+        Math.floor(Math.random() * 7)
+      ]),
+    created_by: 'system',
+    created_at: new Date().toISOString(),
+    last_modified: new Date().toISOString(),
+    complexity: Math.floor(Math.random() * 10) + 1,
+    estimated_duration_days: Math.floor(Math.random() * 180) + 30,
+  }
+
+  return JSON.stringify(meta)
+}
+
+/**
+ * Генерирует описание имущества
+ */
+export function generateRandomPropertyDescription(): string {
+  const types = [
+    'Серверное оборудование',
+    'Лицензии на программное обеспечение',
+    'Офисное оборудование',
+    'Интеллектуальная собственность',
+    'Доменные имена и хостинг',
+    'Техническая документация',
+    'Базы данных',
+    'Исследовательские материалы',
+  ]
+
+  const details = [
+    'включает все необходимые компоненты и документацию',
+    'с полным комплектом сопроводительных материалов',
+    'в отличном техническом состоянии',
+    'прошедшее полную проверку и тестирование',
+    'с гарантийным обслуживанием',
+    'соответствует всем требованиям и стандартам',
+  ]
+
+  const type = types[Math.floor(Math.random() * types.length)]
+  const detail = details[Math.floor(Math.random() * details.length)]
+  const additional = `ID: ${randomBytes(4).toString('hex').toUpperCase()}`
+
+  return `${type} - ${detail}. ${additional}. ${generateRandomDescription().slice(0, 100)}`
+}
+
+/**
+ * Генерирует случайную сумму взноса для контрибьютора
+ * @param min минимальная сумма (по умолчанию 500)
+ * @param max максимальная сумма (по умолчанию 5000)
+ */
+export function generateRandomContributionAmount(min = 500, max = 2000): string {
+  const amount = Math.floor(Math.random() * (max - min)) + min
+  return `${amount}.0000 RUB`
+}

components/boot/stress-test.sh

@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# Конфигурация
+TOTAL_RUNS=100
+LOG_FILE="stress-test-$(date +%Y%m%d-%H%M%S).log"
+FAILED=false
+SUCCESS_COUNT=0
+FAILED_COUNT=0
+START_TIME=$(date +%s)
+
+# Функция для отображения прогресса
+show_progress() {
+    local current=$1
+    local total=$2
+    local success=$3
+    local failed=$4
+
+    local percent=0
+    if [ $total -gt 0 ]; then
+        percent=$((current * 100 / total))
+    fi
+    local progress_bar=""
+    local bar_width=50
+    local filled=0
+    if [ $total -gt 0 ]; then
+        filled=$((current * bar_width / total))
+    fi
+
+    for ((j=1; j<=bar_width; j++)); do
+        if [ $j -le $filled ]; then
+            progress_bar="${progress_bar}█"
+        else
+            progress_bar="${progress_bar}░"
+        fi
+    done
+
+    echo "Прогресс: [${progress_bar}] ${percent}% (${current}/${total}) | ✅ ${success} | ❌ ${failed}"
+}
+
+echo "════════════════════════════════════════════════════" | tee -a "$LOG_FILE"
+echo "  СТРЕСС-ТЕСТИРОВАНИЕ CAPITAL CONTRACT" | tee -a "$LOG_FILE"
+echo "════════════════════════════════════════════════════" | tee -a "$LOG_FILE"
+echo "Запуск: $(date)" | tee -a "$LOG_FILE"
+echo "Количество прогонов: $TOTAL_RUNS" | tee -a "$LOG_FILE"
+echo "Лог-файл: $LOG_FILE" | tee -a "$LOG_FILE"
+echo "════════════════════════════════════════════════════" | tee -a "$LOG_FILE"
+echo "" | tee -a "$LOG_FILE"
+
+for ((i=1; i<=TOTAL_RUNS; i++)); do
+    RUN_START=$(date +%s)
+
+    echo "════════════════════════════════════════" | tee -a "$LOG_FILE"
+    echo "📊 Запуск #$i из $TOTAL_RUNS" | tee -a "$LOG_FILE"
+    echo "════════════════════════════════════════" | tee -a "$LOG_FILE"
+
+    # Запускаем тест и сохраняем вывод
+    npx vitest run capital.test --run --testTimeout=60000 2>&1 | tee -a "$LOG_FILE"
+    TEST_EXIT_CODE=${PIPESTATUS[0]}
+
+    if [ $TEST_EXIT_CODE -eq 0 ]; then
+        RUN_END=$(date +%s)
+        RUN_DURATION=$((RUN_END - RUN_START))
+        SUCCESS_COUNT=$((SUCCESS_COUNT + 1))
+        echo "✅ Запуск #$i успешен (время: ${RUN_DURATION}с)" | tee -a "$LOG_FILE"
+        echo "" | tee -a "$LOG_FILE"
+    else
+        RUN_END=$(date +%s)
+        RUN_DURATION=$((RUN_END - RUN_START))
+        FAILED_COUNT=$((FAILED_COUNT + 1))
+        echo "❌ ТЕСТ УПАЛ НА ЗАПУСКЕ #$i (время: ${RUN_DURATION}с)" | tee -a "$LOG_FILE"
+        echo "⚠️  Проверка на access violation или другие ошибки..." | tee -a "$LOG_FILE"
+        FAILED=true
+        break
+    fi
+
+    # Обновляем прогресс после каждого успешного теста
+    show_progress $((SUCCESS_COUNT + FAILED_COUNT)) $TOTAL_RUNS $SUCCESS_COUNT $FAILED_COUNT
+    echo "" | tee -a "$LOG_FILE"
+done
+
+END_TIME=$(date +%s)
+TOTAL_DURATION=$((END_TIME - START_TIME))
+AVG_DURATION=$((SUCCESS_COUNT > 0 ? TOTAL_DURATION / SUCCESS_COUNT : 0))
+
+# Финальный показ прогресса
+echo "" | tee -a "$LOG_FILE"
+show_progress $((SUCCESS_COUNT + FAILED_COUNT)) $TOTAL_RUNS $SUCCESS_COUNT $FAILED_COUNT
+echo "" | tee -a "$LOG_FILE"
+echo "════════════════════════════════════════════════════" | tee -a "$LOG_FILE"
+echo "  ИТОГОВАЯ СТАТИСТИКА" | tee -a "$LOG_FILE"
+echo "════════════════════════════════════════════════════" | tee -a "$LOG_FILE"
+echo "Завершено: $(date)" | tee -a "$LOG_FILE"
+echo "Успешных прогонов: $SUCCESS_COUNT" | tee -a "$LOG_FILE"
+echo "Проваленных прогонов: $FAILED_COUNT" | tee -a "$LOG_FILE"
+echo "Всего прогонов: $((SUCCESS_COUNT + FAILED_COUNT)) из $TOTAL_RUNS" | tee -a "$LOG_FILE"
+echo "Общее время: ${TOTAL_DURATION}с ($(($TOTAL_DURATION / 60))м)" | tee -a "$LOG_FILE"
+if [ $SUCCESS_COUNT -gt 0 ]; then
+    echo "Среднее время на прогон: ${AVG_DURATION}с" | tee -a "$LOG_FILE"
+fi
+
+if [ "$FAILED" = true ]; then
+    echo "Статус: ❌ ПРОВАЛЕН" | tee -a "$LOG_FILE"
+    echo "════════════════════════════════════════════════════" | tee -a "$LOG_FILE"
+    echo "" | tee -a "$LOG_FILE"
+    echo "⚠️  Тестирование прервано из-за ошибки на запуске #$i" | tee -a "$LOG_FILE"
+    echo "📋 Полный лог сохранен в: $LOG_FILE" | tee -a "$LOG_FILE"
+    exit 1
+else
+    echo "Статус: ✅ УСПЕШНО" | tee -a "$LOG_FILE"
+    echo "════════════════════════════════════════════════════" | tee -a "$LOG_FILE"
+    echo "" | tee -a "$LOG_FILE"
+    echo "🎉 Все $TOTAL_RUNS запусков успешны!" | tee -a "$LOG_FILE"
+    echo "📋 Полный лог сохранен в: $LOG_FILE" | tee -a "$LOG_FILE"
+    exit 0
+fi

components/cleos/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coopenomics/cleos",
-  "version": "2025.10.16",
+  "version": "2026.2.22-alpha-4",
   "private": true,
   "description": "",
   "scripts": {

components/context/.cursor/plans/конструктор_программ_регистрации_09abc252.plan.md

@@ -0,0 +1,537 @@
+---
+name: Конструктор программ регистрации
+overview: Создание гибкого конструктора программ регистрации с выбором дополнительных соглашений на основе типа аккаунта и кооператива. Для Восхода физики и ИП выбирают между программами "Генерация" и "Капитализация".
+todos:
+  - id: backend-interfaces
+    content: Создать новые интерфейсы для программ регистрации в agreement-config.interface.ts
+    status: completed
+  - id: backend-programs-config
+    content: Создать конфигурацию программ registration-programs.config.ts с программами для voskhod
+    status: completed
+  - id: backend-agreement-service
+    content: Обновить AgreementConfigurationService с методами работы с программами
+    status: completed
+  - id: backend-documents-service
+    content: Добавить поддержку program_key в RegistrationDocumentsService
+    status: completed
+  - id: backend-dto
+    content: Обновить DTO для добавления program_key и создать RegistrationConfigDTO
+    status: completed
+  - id: backend-resolver
+    content: Добавить query getRegistrationConfig в SystemResolver
+    status: completed
+  - id: frontend-store
+    content: Обновить Registrator store для хранения selectedProgramKey и добавить шаг SelectProgram
+    status: completed
+  - id: frontend-select-component
+    content: Создать компонент SelectProgram.vue для выбора программы
+    status: completed
+  - id: frontend-conditional-rendering
+    content: Добавить условный рендеринг шага SelectProgram в SignUp.vue
+    status: completed
+  - id: frontend-pass-program-key
+    content: Обновить вызов generateRegistrationDocuments для передачи program_key
+    status: completed
+  - id: sdk-update
+    content: Обновить SDK мутацию и добавить query getRegistrationConfig
+    status: completed
+  - id: add-generator-agreement
+    content: Добавить соглашение generator_offer в registration-agreements.config.ts
+    status: completed
+---
+
+# План реализации конструктора программ регистрации
+
+## Архитектура решения
+
+Система будет состоять из трёх уровней:
+
+```mermaid
+graph TD
+    A[Frontend: SelectProgram шаг] --> B[Backend: getRegistrationConfig query]
+    A --> C[Backend: generateRegistrationDocuments mutation]
+    B --> D[RegistrationProgramsConfig]
+    C --> D
+    D --> E[AgreementConfigurationService]
+    E --> F[Генерация документов]
+```
+
+## 1. Backend: Расширение конфигурации соглашений
+
+### 1.1 Новые интерфейсы конфигурации
+
+**Файл:** [`components/controller/src/domain/registration/config/agreement-config.interface.ts`](components/controller/src/domain/registration/config/agreement-config.interface.ts)
+
+Добавить новые интерфейсы для программ регистрации:
+
+```typescript
+/**
+ * Описание программы регистрации с её соглашениями
+ */
+export interface IRegistrationProgram {
+  /** Уникальный ключ программы (например, "generation", "capitalization") */
+  key: string;
+
+  /** Название программы для отображения */
+  title: string;
+
+  /** Описание программы */
+  description: string;
+
+  /** URL изображения (опционально) */
+  image_url?: string;
+
+  /** Минимальные требования для участия */
+  requirements?: string;
+
+  /** Для каких типов аккаунтов доступна эта программа */
+  applicable_account_types: AccountType[];
+
+  /** Список ID соглашений, которые требуются для этой программы */
+  agreement_ids: string[];
+
+  /** Порядок отображения */
+  order: number;
+}
+
+/**
+ * Конфигурация программ регистрации для кооператива
+ */
+export interface ICooperativeRegistrationPrograms {
+  /** Название кооператива */
+  coopname: string;
+
+  /** Доступные программы */
+  programs: IRegistrationProgram[];
+
+  /** Нужен ли выбор программы (если false - используется первая подходящая) */
+  requires_selection: boolean;
+}
+```
+
+### 1.2 Создание конфигурации программ
+
+**Файл:** `components/controller/src/domain/registration/config/registration-programs.config.ts` (новый)
+
+```typescript
+export const REGISTRATION_PROGRAMS_CONFIG: ICooperativeRegistrationPrograms[] = [
+  {
+    coopname: 'voskhod',
+    requires_selection: true,
+    programs: [
+      {
+        key: 'generation',
+        title: 'Программа Генерация',
+        description: 'Участвовать в производстве Кооперативной Экономики через вклад временем, имуществом или деньгами в конкретные проекты. Минимальный взнос 10 часов в месяц.',
+        applicable_account_types: [AccountType.individual, AccountType.entrepreneur],
+        agreement_ids: ['generator_offer'], // новое соглашение
+        order: 1,
+      },
+      {
+        key: 'capitalization',
+        title: 'Программа Капитализация',
+        description: 'Участвовать в производстве Кооперативной Экономики через вклад имуществом или денег в систему. Минимальный взнос 100 000 руб в течение 14 дней.',
+        applicable_account_types: [AccountType.individual, AccountType.entrepreneur],
+        agreement_ids: ['blagorost_offer'],
+        order: 2,
+      },
+    ],
+  },
+];
+```
+
+### 1.3 Добавление нового соглашения generator_offer
+
+**Файл:** [`components/controller/src/domain/registration/config/registration-agreements.config.ts`](components/controller/src/domain/registration/config/registration-agreements.config.ts)
+
+Добавить новое соглашение:
+
+```typescript
+{
+  id: 'generator_offer',
+  registry_id: Cooperative.Registry.GeneratorOffer.registry_id, // 996
+  agreement_type: 'generator',
+  title: 'Оферта по целевой потребительской программе "Генератор"',
+  checkbox_text: 'Я прочитал и принимаю',
+  link_text: 'оферту по целевой потребительской программе "Генератор"',
+  is_blockchain_agreement: true,
+  link_to_statement: true,
+  applicable_account_types: [], // не используется напрямую, только через программы
+  order: 6,
+}
+```
+
+### 1.4 Обновление AgreementConfigurationService
+
+**Файл:** [`components/controller/src/domain/registration/services/agreement-configuration.service.ts`](components/controller/src/domain/registration/services/agreement-configuration.service.ts)
+
+Добавить методы для работы с программами:
+
+```typescript
+/**
+ * Получить доступные программы регистрации для кооператива и типа аккаунта
+ */
+getAvailablePrograms(coopname: string, accountType: AccountType): IRegistrationProgram[] {
+  const config = REGISTRATION_PROGRAMS_CONFIG.find(c => c.coopname === coopname);
+  if (!config) return [];
+
+  return config.programs
+    .filter(p => p.applicable_account_types.includes(accountType))
+    .sort((a, b) => a.order - b.order);
+}
+
+/**
+ * Получить конфигурацию программ для кооператива
+ */
+getCooperativeProgramsConfig(coopname: string): ICooperativeRegistrationPrograms | null {
+  return REGISTRATION_PROGRAMS_CONFIG.find(c => c.coopname === coopname) || null;
+}
+
+/**
+ * Получить соглашения для программы
+ */
+getAgreementsForProgram(programKey: string, coopname: string): IAgreementConfigItem[] {
+  const config = REGISTRATION_PROGRAMS_CONFIG.find(c => c.coopname === coopname);
+  if (!config) return [];
+
+  const program = config.programs.find(p => p.key === programKey);
+  if (!program) return [];
+
+  return program.agreement_ids
+    .map(id => this.getAgreementById(id))
+    .filter((a): a is IAgreementConfigItem => a !== null);
+}
+```
+
+Обновить метод `getAgreementsForAccountType`:
+
+```typescript
+getAgreementsForAccountType(
+  accountType: AccountType,
+  coopname?: string,
+  programKey?: string
+): IAgreementConfigItem[] {
+  // Базовые соглашения (всегда включаются)
+  const baseAgreements = REGISTRATION_AGREEMENTS_CONFIG.agreements
+    .filter(a => a.applicable_account_types.includes(accountType))
+    .filter(a => a.id !== 'blagorost_offer' && a.id !== 'generator_offer');
+
+  // Если указана программа - добавляем её соглашения
+  if (programKey && coopname) {
+    const programAgreements = this.getAgreementsForProgram(programKey, coopname);
+    return [...baseAgreements, ...programAgreements].sort((a, b) => a.order - b.order);
+  }
+
+  // Старая логика для обратной совместимости (voskhod без program_key)
+  if (coopname === 'voskhod' && accountType === AccountType.individual) {
+    const capitalization = this.getAgreementById('blagorost_offer');
+    if (capitalization) {
+      return [...baseAgreements, capitalization].sort((a, b) => a.order - b.order);
+    }
+  }
+
+  return baseAgreements.sort((a, b) => a.order - b.order);
+}
+```
+
+### 1.5 Обновление RegistrationDocumentsService
+
+**Файл:** [`components/controller/src/domain/registration/services/registration-documents.service.ts`](components/controller/src/domain/registration/services/registration-documents.service.ts)
+
+Добавить `program_key` в интерфейс:
+
+```typescript
+// В интерфейсе IGenerateRegistrationDocumentsInput
+program_key?: string;
+```
+
+Обновить метод `generateRegistrationDocuments`:
+
+```typescript
+const agreementsConfig = this.agreementConfigService.getAgreementsForAccountType(
+  account_type,
+  coopname,
+  input.program_key
+);
+```
+
+### 1.6 Обновление DTO
+
+**Файл:** [`components/controller/src/application/user/dto/generate-registration-documents-input.dto.ts`](components/controller/src/application/user/dto/generate-registration-documents-input.dto.ts)
+
+```typescript
+@Field({ nullable: true, description: 'Ключ выбранной программы регистрации (опционально)' })
+@IsString()
+@IsOptional()
+program_key?: string;
+```
+
+### 1.7 Новый Query для получения конфигурации
+
+**Файл:** [`components/controller/src/application/system/resolvers/system.resolver.ts`](components/controller/src/application/system/resolvers/system.resolver.ts)
+
+Добавить новый query:
+
+```typescript
+@Query(() => RegistrationConfigDTO, {
+  name: 'getRegistrationConfig',
+  description: 'Получить конфигурацию программ регистрации для кооператива',
+})
+async getRegistrationConfig(
+  @Args('coopname') coopname: string,
+  @Args('account_type', { type: () => AccountType }) accountType: AccountType,
+): Promise<RegistrationConfigDTO> {
+  return this.systemService.getRegistrationConfig(coopname, accountType);
+}
+```
+
+**Файл:** `components/controller/src/application/system/dto/registration-config.dto.ts` (новый)
+
+```typescript
+@ObjectType('RegistrationProgram')
+export class RegistrationProgramDTO {
+  @Field() key!: string;
+  @Field() title!: string;
+  @Field() description!: string;
+  @Field({ nullable: true }) image_url?: string;
+  @Field({ nullable: true }) requirements?: string;
+  @Field(() => [AccountType]) applicable_account_types!: AccountType[];
+  @Field(() => Int) order!: number;
+}
+
+@ObjectType('RegistrationConfig')
+export class RegistrationConfigDTO {
+  @Field() requires_selection!: boolean;
+  @Field(() => [RegistrationProgramDTO]) programs!: RegistrationProgramDTO[];
+}
+```
+
+**Файл:** [`components/controller/src/application/system/services/system.service.ts`](components/controller/src/application/system/services/system.service.ts)
+
+```typescript
+async getRegistrationConfig(
+  coopname: string,
+  accountType: AccountType
+): Promise<RegistrationConfigDTO> {
+  const config = this.agreementConfigService.getCooperativeProgramsConfig(coopname);
+
+  if (!config) {
+    return new RegistrationConfigDTO({
+      requires_selection: false,
+      programs: [],
+    });
+  }
+
+  const programs = this.agreementConfigService.getAvailablePrograms(coopname, accountType);
+
+  return new RegistrationConfigDTO({
+    requires_selection: config.requires_selection && programs.length > 1,
+    programs,
+  });
+}
+```
+
+## 2. Frontend: Новый шаг выбора программы
+
+### 2.1 Обновление Registrator Store
+
+**Файл:** [`components/desktop/src/entities/Registrator/model/store.ts`](components/desktop/src/entities/Registrator/model/store.ts)
+
+Добавить в state:
+
+```typescript
+const state = reactive({
+  // ... существующие поля
+  selectedProgramKey: '', // выбранный ключ программы
+});
+```
+
+Добавить шаг `SelectProgram` в массив stepNames (между `SetUserData` и `GenerateAccount`).
+
+### 2.2 Создание компонента SelectProgram
+
+**Файл:** `components/desktop/src/pages/Registrator/SignUp/SelectProgram.vue` (новый)
+
+```vue
+<template lang="pug">
+div
+  q-step(
+    :name='registratorStore.steps.SelectProgram',
+    title='Выберите программу участия',
+    :done='registratorStore.isStepDone("SelectProgram")'
+  )
+    div(v-if='isLoading').full-width.text-center.q-mt-lg
+      Loader(text='Загружаем доступные программы...')
+
+    div(v-else-if='programs.length > 0')
+      p.text-body1 Выберите программу, в которой вы хотите участвовать:
+
+      q-list.q-mt-md
+        q-item(
+          v-for='program in programs',
+          :key='program.key',
+          clickable,
+          v-ripple,
+          :active='registratorStore.state.selectedProgramKey === program.key',
+          @click='selectProgram(program.key)'
+        )
+          q-item-section
+            q-item-label.text-h6 {{ program.title }}
+            q-item-label(caption).q-mt-sm {{ program.description }}
+            q-item-label(v-if='program.requirements', caption).q-mt-xs.text-weight-bold
+              | {{ program.requirements }}
+          q-item-section(side)
+            q-radio(
+              :model-value='registratorStore.state.selectedProgramKey',
+              :val='program.key',
+              @update:model-value='selectProgram(program.key)'
+            )
+
+    div.q-mt-lg
+      q-btn.col-md-6.col-xs-12(flat @click='registratorStore.prev()')
+        i.fa.fa-arrow-left
+        span.q-ml-md назад
+
+      q-btn.q-mt-lg.q-mb-lg(
+        color='primary',
+        label='Продолжить',
+        :disabled='!registratorStore.state.selectedProgramKey',
+        @click='registratorStore.next()'
+      )
+</template>
+
+<script lang="ts" setup>
+import { ref, onMounted } from 'vue';
+import { useRegistratorStore } from 'src/entities/Registrator';
+import { useSystemStore } from 'src/entities/System/model';
+import { Loader } from 'src/shared/ui/Loader';
+import { FailAlert } from 'src/shared/api';
+// TODO: добавить API метод для получения конфигурации
+
+const registratorStore = useRegistratorStore();
+const systemStore = useSystemStore();
+
+const isLoading = ref(false);
+const programs = ref<any[]>([]);
+
+const loadPrograms = async () => {
+  try {
+    isLoading.value = true;
+    // TODO: вызов API getRegistrationConfig
+    const config = await getRegistrationConfig(
+      systemStore.info.coopname,
+      registratorStore.state.userData.type
+    );
+    programs.value = config.programs;
+  } catch (e: any) {
+    FailAlert(e);
+  } finally {
+    isLoading.value = false;
+  }
+};
+
+const selectProgram = (key: string) => {
+  registratorStore.state.selectedProgramKey = key;
+};
+
+onMounted(() => {
+  if (registratorStore.state.step === registratorStore.steps.SelectProgram) {
+    loadPrograms();
+  }
+});
+</script>
+```
+
+### 2.3 Условный рендеринг шага
+
+**Файл:** [`components/desktop/src/pages/Registrator/SignUp/SignUp.vue`](components/desktop/src/pages/Registrator/SignUp/SignUp.vue)
+
+Добавить условный рендеринг:
+
+```pug
+SelectProgram(v-if='shouldShowProgramSelection')
+```
+
+Добавить computed для определения необходимости показа:
+
+```typescript
+const shouldShowProgramSelection = computed(() => {
+  // Показываем только если есть конфигурация программ для данного кооператива
+  // и тип аккаунта выбран
+  return (
+    registratorStore.state.userData.type &&
+    // TODO: проверка наличия программ из конфигурации
+  );
+});
+```
+
+### 2.4 Обновление вызова generateRegistrationDocuments
+
+**Файл:** `components/desktop/src/features/User/CreateUser` (или где происходит вызов)
+
+Передавать `program_key` при генерации документов:
+
+```typescript
+await generateAllRegistrationDocuments(
+  coopname,
+  username,
+  accountType,
+  registratorStore.state.selectedProgramKey // новый параметр
+);
+```
+
+## 3. SDK: Обновление мутации
+
+**Файл:** [`components/sdk/src/mutations/registration/generateRegistrationDocuments.ts`](components/sdk/src/mutations/registration/generateRegistrationDocuments.ts) (если существует, иначе найти где определена)
+
+Добавить опциональное поле `program_key` в input мутации.
+
+**Файл:** Где определен query `getRegistrationConfig` (создать новый)
+
+```typescript
+export const getRegistrationConfig = {
+  name: 'getRegistrationConfig',
+  query: (coopname: string, account_type: string) => ({
+    getRegistrationConfig: [
+      { coopname, account_type },
+      {
+        requires_selection: true,
+        programs: {
+          key: true,
+          title: true,
+          description: true,
+          image_url: true,
+          requirements: true,
+          order: true,
+        },
+      },
+    ],
+  }),
+};
+```
+
+## 4. Обновление логики перехода между шагами
+
+В [`components/desktop/src/pages/Registrator/SignUp/SetUserData.vue`](components/desktop/src/pages/Registrator/SignUp/SetUserData.vue) при клике "Продолжить" нужно:
+
+1. Проверить, нужен ли шаг SelectProgram
+2. Если да - перейти на него
+3. Если нет - перейти на GenerateAccount (как сейчас)
+
+## Итоговая последовательность шагов регистрации
+
+1. **EmailInput** - ввод email
+2. **SetUserData** - выбор типа аккаунта и заполнение данных
+3. **SelectProgram** *(условный)* - выбор программы (только для voskhod, физики/ИП)
+4. **GenerateAccount** - генерация аккаунта
+5. **SelectBranch** *(условный)* - выбор филиала
+6. **ReadStatement** - чтение и принятие соглашений (уже учитывают program_key)
+7. **SignStatement** - подпись
+8. **PayInitial** - оплата
+9. **WaitingRegistration** - ожидание
+
+## Миграция и обратная совместимость
+
+- Для всех кооперативов кроме voskhod ничего не меняется
+- Для voskhod: если не передан `program_key`, используется старая логика (blagorost_offer для физиков)
+- После развертывания можно убрать хардкод для voskhod из `AgreementConfigurationService`

components/context/.cursor/rules/always.mdc

@@ -0,0 +1,11 @@
+---
+description: Общие правила
+alwaysApply: true
+---
+Мы работаем в МОНО-репозитории pnpm, любая установка пакетов производится ЧЕРЕЗ ФИЛЬТР компонента в корне: pnpm add glob --filter <package>.
+
+НИКОГДА НЕ ЗАПУСКАЙ ПРИЛОЖЕНИЕ ИЛИ ЕГО СБОРКУ!!! Просто отчитайся что всё сделал.
+
+НИКОГДА НЕ ЗАПУСКАЙ ТЕСТЫ ИЛИ ПРОВЕРКУ ТИПОВ ИЛИ ЛИНТЕР!!!
+
+Никаких ANY типов! Строгая типизация всегда. 

components/context/.cursor/rules/controller.mdc

@@ -0,0 +1,53 @@
+---
+description: О правилах на бэкенде
+globs: **/controller/**/*.ts
+---
+ # NestJS Controller и Чистая архитектура
+
+## Основные принципы
+1. Чистая архитектура - главный архитектурный подход. Пиши код с комментариями.
+2. Типы IName, IChecksum256, ITimePointSec - это просто строки.
+3. Домен должен быть полностью изолирован от инфраструктурных деталей.
+4. Направление зависимостей - внутрь (к ядру, домену).
+5. Домен, инфраструктура и приложение связаны через App.module, НЕ НУЖНО импортировать их друг в друга, а достаточно просто импортировать домен на уровне приложения чтобы использовать все экспорты домена.
+
+## Структура проекта
+- `domain/` - доменный слой (бизнес-логика, независимая от инфраструктуры)
+- `infrastructure/` - инфраструктурный слой (адаптеры к внешним системам)
+- `modules/` - слой приложения (DTO, резолверы, сервисы)
+
+## Слои и их взаимодействие
+1. **Домен**:
+   - Содержит чистые доменные интерфейсы и реализованные на них сущности
+   - НЕ должен зависеть от `cooptypes` (инфраструктурный контракт)
+   - Использует собственные доменные типы (например, Date вместо строковых timestamp)
+   - Интерфейсы портов описывают взаимодействие с внешними системами
+
+2. **Инфраструктура**:
+   - Содержит адаптеры к внешним системам (блокчейн, БД и т.д.)
+   - Осуществляет преобразование между доменными и инфраструктурными типами
+   - Общая логика преобразования выносится в утилитарные классы (например, `DomainToBlockchainUtils`)
+
+3. **Модули (приложение)**:
+   - DTO имплементируют доменные интерфейсы напрямую
+   - Резолвер вызывает сервис, который принимает DTO
+   - Сервис передает объекты DTO в интерактор приложения (юз-кейс)
+
+## Правила
+
+Чистая фрактальная трехуровневая архитектура срезов домена (domain) и инфраструктуры (infrastructure), оркестрируемая приложением (application). Фрактал раскрывается в расширениях (extensions), каждое из которых также выстраивается по правилам чистой трехуровневой архитектуры срезов домена и инфраструктуры с окрестрацией на уровне своего приложения.
+
+Общая архитектура связей:
+- AppResolver -> AppService[DTO<->Domain] -> AppInteractor -> DomainService -> DomainPort <- InfraAdapter -> [при необходимости] AnyAppOrDomainService
+
+Все сервисы внедряются через инъекцию (DI) с указанием символа реализации. Импорты разрешены только вглубь - к домену. Из домена переход разрешен только в инфраструктуру через порт и его адаптер.
+
+Прямые импорты без DI запрещены. Импорты из соседних срезов того же архитектурного уровня запрещены. Направление зависимостей от приложения - к домену, от домена через порт в его инфраструктурный адаптер.
+
+Взаимодействие расширений с основным приложением осуществляется только через порты домена основного приложения.
+
+Глобальные модули запрещены. В редких случаях сложных циклических зависимостей на период рефакторинга разрешается обоснованно использовать forwardRef.
+
+Уровень приложения оркестрирует вызовы доменов через порты в инфраструктуру. Домены не обращаются друг к друга. Срезы уровня приложений не обращаются друг к другу, а только вызывают порты домена.
+
+```

components/context/.cursor/rules/desktop-sdk-queries-mutations.mdc

@@ -51,8 +51,8 @@ import { client } from 'src/shared/api/client';
 import { Mutations } from '@coopenomics/sdk';
 
 async function generateDocument(data: IGenerateDocumentInput): Promise<IGeneratedDocumentOutput> {
-  const { [Mutations.Capital.GenerateGenerationAgreement.name]: result } =
-    await client.Mutation(Mutations.Capital.GenerateGenerationAgreement.mutation, {
+  const { [Mutations.Capital.GenerateGenerationContract.name]: result } =
+    await client.Mutation(Mutations.Capital.GenerateGenerationContract.mutation, {
       variables: {
         data: {
           coopname: 'coopname',

components/context/.cursor/rules/desktop.mdc

@@ -1,4 +1,5 @@
 ---
+description: О правилах на фронтенде
 globs: **/desktop/**
 alwaysApply: false
 ---

components/context/.cursor/rules/docs.mdc

@@ -1,6 +1,5 @@
 ---
-description: 
-globs: 
+description: Правила работы с макросом main.py в компоненте docs
 alwaysApply: false
 ---
 Файл [main.py](mdc:monocoop/monocoop/monocoop/components/docs/main.py) автоматически генерит ссылки на документацию SDK и GraphQL, которые формируются и публикуются автоматически. При создании документации к методам всегда применяй ссылки на SDK и GraphQL по форме: 

components/context/.cursor/rules/document-aggregator.mdc

@@ -1,6 +1,6 @@
 ---
+description: Правила формирования агрегатов документов в controller
 alwaysApply: false
-globs: **/controller/**/*.resolver.ts
 ---
 ## 📋 Правила формирования агрегатов документов
 

components/context/.cursor/rules/draft.mdc

@@ -1,9 +1,7 @@
 ---
-description: 
-globs: 
+description: Правила контроля изменений документов в фабрике (factory)
 alwaysApply: false
 ---
-
 # Структура файлов шаблонов документов и алгоритм правки
 
 ## Основные директории и файлы
@@ -94,3 +92,4 @@ alwaysApply: false
 - Поддерживаются конструкции: `{% if %}`, `{% for %}`, `{% trans %}`
 - Переменные вставляются через `{{ variable }}`
 - Переводы через `{% trans 'KEY' %}`
+- Дополнительно поддерживается передача переменной в перевод через `{% trans 'KEY', some_var1, some_var2 %}`, при этом в самом переводе необходимо использовать порядковые ключи {0}, {1} для доступа к переданным переменным.

components/context/.cursor/rules/entities-names.mdc

@@ -0,0 +1,10 @@
+---
+description: Typeorm entity name. Выбрать имя для typeorm сущности.
+alwaysApply: false
+---
+Имя сущность typeorm должно быть в паттерне **/entities/*entity.ts
+
+'src/infrastructure/**/entities/*entity.{ts,js}',
+'src/extensions/**/entities/*entity.{ts,js}',
+'src/shared/**/entities/*entity.{ts,js}',
+

components/context/.cursor/rules/extensions.mdc

@@ -1,6 +1,5 @@
 ---
-description: 
-globs: **/controller/src/extensions/**
+description: Архитектура и правила расширений extensions в controller
 alwaysApply: false
 ---
 # Архитектура расширений в MonoCoop

components/context/.cursor/rules/factory-add-document.mdc

@@ -0,0 +1,50 @@
+---
+description: Добавить документ в фабрику документов. Создать шаблон документа.
+alwaysApply: false
+---
+
+## Создание шаблона
+
+В библиотеке реестра типов документов находятся шаблоны: cooptypes/src/cooperative/registry/1.WalletAgreement
+
+В каждом шаблоне определяется часть Action, которая отвечает за передаваемые извне параметры для модели документа. И Model, которая отвечает за общую модель документа, которая может включать в себя не только данные, которые передаются извне в действии по генерации документа, но и извлекаются самой фабрикой в процессе генерации. Meta данные при этом являются объединением обоих интерфейсов и на основе этих данных можно произвести полную регенерацию документа.
+
+Содержание каждого index файла включает в себя интерфейс Action для генерации. Model с теми данными которые могут быть предоставлены самой фабрикой документов. Title, description, context и translations и exampleData.
+
+Context включает в себя строковый шаблон jinja2, который использует данные из Action и Meta, а также translations для переводов на русский язык. Кроме того, каждый шаблон содержит стандартную css разметку для заголовка, места подписи, и т.д.
+
+exampleData мы прописываем как пример данных, которые программа-визуализатор может подставить и показать визуально-заполненный шаблон. Потому когда ты создаешь новый документ ты должен в точности соблюдать заполнение всех полей. Во-первых ты должен декомпозировать документ на элементы переводов, затем эти элементы переводов вставить в текст и разбавить использованием переменных. Местами ты можешь использовать вот такие конструкции шаблона для передачи переменных прямо в перевод: {% trans 'phone_and_email_notice', individual.phone, individual.email %}
+
+В объекте перевода:
+...phone_and_email_notice: 'номер телефона с активированной функцией получения sms: {0}, адрес электронной почты: {1}.',
+
+Но обычно достаточно просто использовать переменные из Action и Model напрямую.
+
+## Создание схемы
+
+После того, как шаблон создан и экспортирован, необходимо создать схему. Схема создается в factory/src/Templates
+
+Там реэкспортируются Action, Model как типы. И определяется схема ajv. Там есть стандартные, определенные части схемы, которые находятся в factory/src/Schema. Все части моделей Action и Model должны быть определены в одной схеме данных и затем экспортированы в реестр схем factory/src/Templates/registry.ts.
+
+## Создание станка
+
+Далее необходимо создать станок для обработки генерации документа в factory/src/Actions. Он дожен включать в себя интерфейс действия и всю подготовительную обработку данных для передачи информации в шаблон согласно схемы. В качестве ФИО/наименование пайщика используем factory/src/Schema/CommonUserSchema.ts.
+
+## Экспорт станка
+
+Станок необходимо экспортировать в src/index.ts через все реестры. Чтобы в итоге вызов метода генерации был делегирован корректному станку.
+
+
+## Создание теста
+
+В папке factory/src/tests создаем или используем существующий и подходящий по контексту файл теста для генерации. Используем метод для генерации
+
+it('генерируем соглашение о капитализации', async () => {
+    await testDocumentGeneration({
+      registry_id: 1000,
+      coopname: 'voskhod',
+      username: 'ant',
+      lang: 'ru',
+    })
+  })
+

components/context/.cursor/rules/factory-add-template.mdc

@@ -0,0 +1,7 @@
+---
+description: Создание шаблона документа без шапки из его основной версии в фабрике документов
+alwaysApply: false
+---
+Смотри, у меня есть проект документа оферты, @cooptypes/src/cooperative/registry/999.BlagorostOfferTemplate/index.ts мы его принимаем затем, чтобы получить данные для генерации @cooptypes/src/cooperative/registry/1000.BlagorostOffer/index.ts уже самой пользовательской оферты. Они в целом почти абсолютно идентичны за той лишь разницей, что  в проекте кругом прочерки остаются вместо переменных для заполнения, и нет шапки с надписью "УТВЕРЖДЕНО" протоколом решения № ___ и дата ___.  Т.е. мы как бы из первого в итоге получаем второе. Приняв первое - мы можем начать генерировать второе.
+
+Мне надо, чтобы ты сделал аналогично для указанного мной документа. Для этого нужно переменные по аналогии заполнить пробелами и убрать шапку. Т.е. в итоге мы должны получить шаблон документа, который можно распечатать и заполнить ручкой. Вот такой вот документ мне надо чтоб ты создал. Он должен обладать принадлежностью к конкретному кооперативу, т.е. vars и chairman мы используем, как и coop. Всё остальное по сути нужно заменить на прочерки. Создай этот шаблон документа, исследовав что нужно тебе для этого.

components/context/.cursor/rules/factory.mdc

@@ -1,6 +1,5 @@
 ---
-description: 
-globs: src/**/*.ts
+description: Правила работы с фабрикой документов кооперативов (factory)
 alwaysApply: false
 ---
 # Фабрика Документов Кооперативов
@@ -15,29 +14,8 @@ alwaysApply: false
 
 ## Структура Registry
 
-В корневой папке `registry/` находятся JSON файлы с номерными названиями, представляющие шаблоны документов:
+В корневой папке `registry/` находятся JSON файлы с номерными названиями, представляющие шаблоны документов.
 
-### Основные документы:
-- `1.walletProgramAgreement.json` — соглашение о кошельке
-- `2.regulationElectronicSignature.json` — регламент электронной подписи
-- `3.privacyPolicy.json` — политика конфиденциальности
-- `4.userAgreement.json` — пользовательское соглашение
-- `50.CoopenomicsAgreement.json` — соглашение с партнерами
-- `100.participantApplication.json` — заявление участника
-- `101.selectBranchStatement.json` — заявление о выборе филиала
-
-### Документы общих собраний (300-304):
-- `300.annualGeneralMeetingAgenda.json` — предложение повестки дня
-- `301.annualGeneralMeetingSovietDecision.json` — протокол заседания совета
-- `302.annualGeneralMeetingNotification.json` — уведомление о собрании
-- `303.annualGeneralMeetingVotingBallot.json` — бюллетень для голосования
-- `304.annualGeneralMeetingDecision.json` — протокол общего собрания
-
-### Инвестиционные документы (1000+):
-- `1000.investAgreement.json` — инвестиционное соглашение
-- `1001.investByResultStatement.json` — заявление о зачете по результатам
-- `1002.investByResultAct.json` — акт зачета по результатам
-- `1005.investByMoneyStatement.json` — заявление о зачете денежных средств
 
 ### Структура JSON-шаблона:
 ```json
@@ -133,89 +111,6 @@ export class Generator implements IGenerator {
 - `meet/` — общие собрания
 - `wallet/`, `capital/`, `fund/` — финансовые операции
 
-## База данных MongoDB
-
-### Основные коллекции:
-
-#### deltas — Состояние блокчейна
-```javascript
-{
-  block_num: number,
-  present: boolean,
-  code: string,    // название контракта
-  scope: string,   // область действия
-  table: string,   // имя таблицы
-  primary_key: string,
-  value: {...}     // данные записи
-}
-```
-
-#### actions — Действия блокчейна
-```javascript
-{
-  block_num: number,
-  account: string,
-  name: string,     // имя действия
-  receiver: string,
-  data: {...}       // данные действия
-}
-```
-
-#### documents — Сгенерированные документы
-```javascript
-{
-  hash: string,           // SHA-256 хеш
-  binary: Uint8Array,     // PDF данные
-  html: string,           // HTML исходник
-  meta: {                 // метаданные
-    title: string,
-    created_at: string,
-    lang: string
-  }
-}
-```
-
-### Таблицы данных:
-- `coops` — кооперативы
-- `meets` — собрания
-- `questions` — вопросы собраний
-- `decisions` — решения совета
-- `individuals` — физические лица
-- `organizations` — организации
-- `entrepreneurs` — ИП
-- `paymentMethods` — платежные методы
-- `vars` — переменные кооперативов
-
-## Генерация документов
-
-### Процесс генерации:
-1. **Вызов** `generator.generate(action, options)`
-2. **Поиск фабрики** по `registry_id`
-3. **Загрузка шаблона** (локально или из БД)
-4. **Сбор данных** из MongoDB по `coopname`, `username`, `block_num`
-5. **Создание модели** — объединение всех данных
-6. **Валидация** модели по JSON схеме
-7. **Рендеринг HTML** через Nunjucks
-8. **Генерация PDF** через WeasyPrint
-9. **Добавление метаданных** в PDF
-10. **Вычисление хеша** SHA-256
-11. **Сохранение** в MongoDB
-
-### Пример использования:
-```typescript
-const generator = new Generator()
-await generator.connect(mongoUri)
-
-const document = await generator.generate({
-  registry_id: '300',
-  coopname: 'voskhod',
-  username: 'ant',
-  block_num: 0,
-  meet: {...},
-  questions: [...]
-})
-```
-
 ## Особенности реализации
 
 ### Шаблонизация:

components/context/.cursor/rules/logger-rule.mdc

@@ -1,5 +1,5 @@
 ---
-globs: **/controller/**/*.ts
+description: Логирование и логгер на бэкенде (controller)
 alwaysApply: false
 ---
 # Logger Rule

components/context/.cursor/rules/sdk.mdc

@@ -1,9 +1,8 @@
 ---
-description: 
-globs: components/sdk/**
+description: Как добавлять селекторы, мутации и запросы в SDK
+globs: **/sdk/**
 alwaysApply: false
 ---
-
 # Руководство по работе с GraphQL Zeus в SDK
 
 ## Основной процесс

components/context/bmad/project-filters/bmad/config.yaml

@@ -0,0 +1,12 @@
+project_name: "Project Filters"
+project_type: "library"
+project_level: 1
+output_folder: "docs"
+language: "ru"
+bmm:
+  workflow_status_file: "docs/bmm-workflow-status.yaml"
+  sprint_status_file: "docs/sprint-status.yaml"
+paths:
+  docs: "docs"
+  stories: "docs/stories"
+  tests: "tests"

components/context/bmad/project-filters/docs/bmm-workflow-status.yaml

@@ -0,0 +1,37 @@
+version: "6.0"
+project_name: "Project Filters"
+project_type: "library"
+project_level: 1
+language: "ru"
+initialized_at: "2026-02-04T12:00:00.000Z"
+last_updated: "2026-02-04T12:30:00.000Z"
+
+workflow_phases:
+  phase1_product_brief:
+    status: "completed"
+    required: false
+    description: "Краткое описание продукта"
+    completed_at: "2026-02-04T12:00:00.000Z"
+    output_file: "docs/product-brief-project-filters-2026-02-04.md"
+
+  phase2_requirements:
+    status: "pending"
+    required: true
+    description: "Технические требования"
+    completed_at: null
+
+  phase3_architecture:
+    status: "pending"
+    required: false
+    description: "Архитектурное решение"
+    completed_at: null
+
+  phase4_implementation:
+    status: "completed"
+    required: true
+    description: "Реализация историй"
+    completed_at: "2026-02-04T12:00:00.000Z"
+    output_file: "Реализован диалог фильтров с кнопкой в интерфейсе"
+
+current_phase: "phase1_product_brief"
+next_recommended_action: "Создать краткое описание продукта (product brief)"

components/context/bmad/project-filters/docs/product-brief-project-filters-2026-02-04.md

@@ -0,0 +1,140 @@
+# Product Brief: Project Filters
+**Дата:** 2026-02-04
+**Проект:** Project Filters
+**Тип:** Библиотека / Фреймворк
+**Уровень:** 1 (Маленький проект)
+
+## Executive Summary
+
+Мы создаем систему диалоговой фильтрации проектов для кооперативной платформы, которая позволит пользователям эффективно фильтровать и находить нужные проекты и задачи. Система предназначена для участников кооперативов - разработчиков, менеджеров проектов и администраторов, которые ежедневно работают с большим количеством проектов и задач. Это важно, потому что без эффективной фильтрации пользователи тратят много времени на поиск нужной информации, что снижает продуктивность работы.
+
+## Problem Statement
+
+В текущей системе проекты отображаются в виде длинного списка без возможности гибкой фильтрации. Пользователи не могут быстро найти проекты по статусу задач, приоритетам, ответственным лицам или мастерам. Это приводит к тому, что:
+
+- Участники тратят много времени на ручной поиск нужных проектов
+- Сложно отслеживать проекты с определенными статусами (например, только завершенные или в работе)
+- Нет возможности фильтровать по ответственным лицам (создателям и мастерам проектов)
+- Отсутствует возможность комбинировать фильтры для точного поиска
+
+## Why Now
+
+С ростом количества проектов и участников в кооперативе становится критически важно иметь эффективные инструменты поиска и фильтрации. Текущая система уже достигла предела usability - пользователи жалуются на сложности с навигацией. Реализация фильтров сейчас позволит заложить фундамент для масштабирования платформы и улучшения пользовательского опыта.
+
+## Solution Overview
+
+Мы создадим диалоговое окно фильтров, которое заменит текущие горизонтальные кнопки фильтрации. Диалог будет содержать четыре типа фильтров:
+
+1. **Фильтр по статусам задач** - множественный выбор из: Все статусы, Бэклог, К выполнению, В работе, На проверке, Выполнено, Отменено
+2. **Фильтр по приоритетам** - множественный выбор из: Все приоритеты, Срочный, Высокий, Средний, Низкий
+3. **Фильтр по исполнителю** - выбор конкретного участника или опция "Я"
+4. **Фильтр по мастеру** - выбор конкретного мастера проекта или опция "Я"
+
+Диалог будет открываться по нажатию кнопки "Фильтры" в шапке страницы проектов.
+
+## Target Audience
+
+### Primary Users
+- **Разработчики** - ежедневно работают с задачами, нуждаются в фильтрации по статусам и приоритетам
+- **Менеджеры проектов** - отслеживают прогресс проектов, фильтруют по ответственным лицам
+- **Администраторы кооператива** - мониторят все проекты, используют комплексную фильтрацию
+
+### Secondary Users
+- **Новые участники** - изучают структуру проектов через фильтры
+- **Внешние консультанты** - временно работают с проектами кооператива
+
+Основные потребности:
+1. Быстрый поиск проектов по статусу задач
+2. Фильтрация по приоритетам для prioritization
+3. Поиск проектов по ответственным лицам
+4. Комбинирование фильтров для точного поиска
+
+## Business Objectives
+
+**Основные цели:**
+- Сократить время поиска проектов на 60%
+- Увеличить удовлетворенность пользователей работой с платформой
+- Улучшить прозрачность работы кооператива через эффективную навигацию
+
+**Метрики успеха:**
+- Время на поиск конкретного проекта: < 30 секунд
+- Количество жалоб на навигацию: уменьшить на 80%
+- Уровень использования фильтров: > 70% активных пользователей
+
+**Бизнес-ценность:**
+- Повышение продуктивности участников кооператива
+- Снижение операционных издержек на поддержку пользователей
+- Улучшение retention участников платформы
+
+## Scope
+
+### In Scope
+- Диалоговое окно с четырьмя типами фильтров
+- Интеграция с существующей системой фильтрации
+- Кнопка "Фильтры" в шапке страницы проектов
+- Сохранение состояния фильтров
+- Валидация и обработка ошибок
+
+### Out of Scope
+- Расширенные фильтры (по дате создания, бюджету и т.д.)
+- Сохранение персональных настроек фильтров
+- Экспорт отфильтрованных данных
+- Интеграция с мобильной версией
+
+### Future Considerations
+- Добавление фильтров по датам
+- Персональные шаблоны фильтров
+- Интеграция с системой уведомлений
+
+## Stakeholders
+
+- **Продуктовый менеджер** - определение требований и приоритетов
+- **UX/UI дизайнер** - проектирование интерфейса диалога
+- **Frontend разработчики** - реализация компонентов
+- **Backend разработчики** - поддержка API фильтрации
+- **QA инженеры** - тестирование функциональности
+- **Пользователи кооператива** - валидация решения
+
+## Constraints and Assumptions
+
+### Constraints
+- Должны использовать существующую архитектуру FSD
+- Интеграция только с текущими компонентами фильтрации
+- Ограничения по времени: 2 недели на реализацию
+
+### Assumptions
+- Пользователи знакомы с базовыми принципами фильтрации
+- Backend API поддерживает все необходимые параметры фильтрации
+- Текущая система компонентов (ContributorSelector, etc.) стабильна
+
+## Success Criteria
+
+- Диалог открывается и закрывается корректно
+- Все четыре типа фильтров работают правильно
+- Фильтры применяются мгновенно без перезагрузки страницы
+- Кнопка "Фильтры" интегрирована в шапку без конфликтов
+- Код соответствует архитектуре FSD и проходит все тесты
+
+## Timeline
+
+**Целевая дата запуска:** Через 2 недели после начала разработки
+
+**Ключевые этапы:**
+1. Проектирование интерфейса (3 дня)
+2. Реализация компонентов (5 дней)
+3. Интеграция и тестирование (4 дня)
+4. Финальное тестирование и развертывание (2 дня)
+
+## Risks
+
+- **Технический риск:** Конфликты с существующими компонентами фильтрации
+  - **Вероятность:** Средняя
+  - **МитIGATION:** Тщательное тестирование интеграции
+
+- **UX риск:** Пользователи не поймут новый интерфейс
+  - **Вероятность:** Низкая
+  - **МитIGATION:** Соблюдение существующих паттернов интерфейса
+
+- **Производительность:** Диалог замедлит загрузку страницы
+  - **Вероятность:** Низкая
+  - **МитIGATION:** Ленивая загрузка компонентов

components/context/bmad/project-participants-widget/bmad/config.yaml

@@ -0,0 +1,12 @@
+project_name: "Виджет участников проекта"
+project_type: "web-app"
+project_level: 1
+output_folder: "docs"
+language: "ru"
+bmm:
+  workflow_status_file: "docs/bmm-workflow-status.yaml"
+  sprint_status_file: "docs/sprint-status.yaml"
+paths:
+  docs: "docs"
+  stories: "docs/stories"
+  tests: "tests"

components/context/bmad/project-participants-widget/docs/bmm-workflow-status.yaml

@@ -0,0 +1,42 @@
+timestamp: "2026-02-04T14:30:00.000Z"
+project_name: "Виджет участников проекта"
+project_type: "web-app"
+project_level: 1
+language: "ru"
+
+workflow_phases:
+  phase_1_product_brief:
+    status: "completed"
+    required: "recommended"
+    completed: true
+    artifacts:
+      - "docs/product-brief-виджет-участников-проекта-2026-02-04.md"
+
+  phase_2_requirements:
+    status: "completed"
+    required: "required"
+    completed: true
+    artifacts:
+      - "docs/tech-spec-виджет-участников-проекта-2026-02-04.md"
+
+  phase_3_architecture:
+    status: "pending"
+    required: "optional"
+    completed: false
+    artifacts: []
+
+  phase_4_implementation:
+    status: "in_progress"
+    required: "required"
+    completed: false
+    artifacts:
+      - "docs/sprint-plan-виджет-участников-проекта-2026-02-04.md"
+      - "docs/sprint-status.yaml"
+
+current_phase: "phase_4_implementation"
+next_recommended_action: "Начать реализацию Sprint 1: STORY-001, STORY-002, STORY-003"
+
+metadata:
+  created_at: "2026-02-04T12:00:00.000Z"
+  updated_at: "2026-02-04T15:00:00.000Z"
+  version: "6.1"

components/context/bmad/project-participants-widget/docs/product-brief-виджет-участников-проекта-2026-02-04.md

@@ -0,0 +1,210 @@
+# Product Brief: Виджет участников проекта
+
+**Date:** 2026-02-04
+**Author:** AI Assistant
+**Version:** 1.1
+**Project Type:** web-app
+**Project Level:** 1
+
+---
+
+## Executive Summary
+
+Виджет для отображения информации об участниках проекта в графической форме. Показывает количество вкладов участников и информацию о том, как стать участником проекта. Это важно для понимания степени участия пользователей в проектах и их вклада в интеллектуальную собственность.
+
+---
+
+## Problem Statement
+
+### The Problem
+
+Пользователи не имеют полной информации о своем участии в проекте. Существует две критические проблемы:
+
+1. **Отсутствие информации о вкладах**: После регистрации в проекте участник получает долю авторского права, но эта информация не отображается в интерфейсе. Виджет показывает только текущую информацию об участии, но не исторические данные о вкладах.
+
+2. **Неправильная логика отображения участников**: Участники отображаются в виджете только после того, как сделали конкретный вклад в проект. Однако участники должны отображаться сразу после подачи заявления на участие и получения доступа к проекту. Это приводит к тому, что новые участники не видят себя в списке участников до тех пор, пока не внесут вклад.
+
+### Why Now?
+
+С ростом числа проектов и участников становится критически важно показывать прозрачную информацию об участии. Без этого пользователи не понимают ценность своего вклада и не могут оценить свою роль в проекте.
+
+### Impact if Unsolved
+
+Участники не будут понимать ценность своего участия, что приведет к снижению мотивации и вовлеченности. Новые участники не видят себя в списке участников проекта, что создает путаницу и неуверенность. Проекты потеряют прозрачность, что может привести к конфликтам и недоверию среди участников. Увеличивается риск потери потенциальных контрибьюторов, которые не понимают свой статус в проекте.
+
+---
+
+## Target Audience
+
+### Primary Users
+
+Участники проектов (ранние участники), которые приходят в проекты для получения доли в результате интеллектуальной деятельности. Они активно участвуют в проектах и используют виджет для отслеживания своего вклада.
+
+### Secondary Users
+
+Администраторы проектов, которые могут использовать виджет для оценки вклада участников.
+
+### User Needs
+
+- Видеть себя в списке участников сразу после получения доступа к проекту
+- Видеть количество своих вкладов в проект
+- Понимать, как стать участником проекта
+- Иметь прозрачную информацию об участии в графической форме
+- Отслеживать свой прогресс и ценность вклада
+- Видеть свою роль в проекте после назначения
+
+---
+
+## Solution Overview
+
+### Proposed Solution
+
+Комплексное улучшение виджета участников проекта:
+
+1. **Исправление логики отображения участников**: Участники должны отображаться сразу после получения доступа к проекту (после подачи заявления и подписания соглашения об участии), а не только после внесения вклада.
+
+2. **Добавление информации о вкладах**: Графическое отображение количества вкладов участника и информации о процессе становления участником проекта.
+
+### Key Features
+
+- **Исправление логики отображения**: Участники отображаются сразу после получения доступа к проекту
+- Графическое отображение количества вкладов участника
+- Информация о том, как стать участником проекта
+- Отображение ролей участников после их назначения
+- Интеграция с существующей системой учета вкладов
+- Адаптивный дизайн для различных устройств
+
+### Value Proposition
+
+Виджет обеспечивает прозрачность и мотивацию участников, показывая их реальный вклад в проект. Это помогает участникам лучше понимать ценность своего участия и стимулирует дальнейшую активность.
+
+---
+
+## Business Objectives
+
+### Goals
+
+- Увеличить прозрачность информации об участии в проектах
+- Повысить мотивацию участников через демонстрацию их вклада
+- Улучшить пользовательский опыт работы с проектами
+- Снизить количество вопросов о статусе участия
+
+### Success Metrics
+
+- Процент участников, просматривающих информацию о вкладах
+- Уровень удовлетворенности пользователей виджетом
+- Количество активных участников проектов
+
+### Business Value
+
+Повышение вовлеченности участников приводит к более качественной разработке проектов и лучшему распределению интеллектуальной собственности.
+
+---
+
+## Scope
+
+### In Scope
+
+- Исправление логики отображения участников (отображение сразу после получения доступа)
+- Добавление поля с количеством вкладов в графической форме
+- Интеграция с API для получения данных о вкладах и статусе участников
+- Добавление секции "Как стать участником"
+- Отображение ролей участников
+- Тестирование новой функциональности
+
+### Out of Scope
+
+- Изменение существующей логики учета вкладов
+- Переработка дизайна всего виджета
+- Добавление новых типов участников
+- Интеграция с внешними системами учета
+
+### Future Considerations
+
+- Добавление детальной истории вкладов
+- Персонализация отображения информации
+- Интеграция с системой уведомлений
+
+---
+
+## Key Stakeholders
+
+- **Разработчики проекта** - Высокий уровень влияния. Отвечают за реализацию функциональности
+- **Участники проектов** - Средний уровень влияния. Основные пользователи виджета
+- **Администраторы проектов** - Средний уровень влияния. Могут использовать виджет для оценки вклада
+
+---
+
+## Constraints and Assumptions
+
+### Constraints
+
+- Интеграция должна быть совместима с существующей архитектурой
+- Ограничения по времени на реализацию (короткий срок)
+- Необходимость поддерживать существующий дизайн-систем
+
+### Assumptions
+
+- API для получения данных о вкладах уже существует
+- Пользователи имеют базовый уровень технической подготовки
+- Существующая инфраструктура может обработать дополнительную нагрузку
+
+---
+
+## Success Criteria
+
+- Участники отображаются в виджете сразу после получения доступа к проекту (подписания соглашения об участии)
+- Виджет корректно отображает количество вкладов участников
+- Информация о вкладах представлена в понятной графической форме
+- Пользователи могут легко найти информацию о том, как стать участником
+- Роли участников корректно отображаются после назначения
+- Новая функциональность не нарушает работу существующего виджета
+- Положительная обратная связь от пользователей
+
+---
+
+## Timeline and Milestones
+
+### Target Launch
+
+Запуск новой версии виджета в течение 2 недель после начала разработки.
+
+### Key Milestones
+
+- Завершение анализа требований: 1 день
+- Разработка UI компонентов: 3 дня
+- Интеграция с API: 2 дня
+- Тестирование: 2 дня
+- Деплой и мониторинг: 1 день
+
+---
+
+## Risks and Mitigation
+
+### Risks
+
+- **Технические сложности интеграции с API**
+  - **Likelihood:** Средний
+  - **Mitigation:** Предварительное тестирование API и наличие плана отката
+
+- **Несовместимость с существующим дизайном**
+  - **Likelihood:** Низкий
+  - **Mitigation:** Использование существующей дизайн-системы
+
+- **Недостаточная производительность**
+  - **Likelihood:** Низкий
+  - **Mitigation:** Оптимизация запросов к API
+
+---
+
+## Next Steps
+
+1. Create Tech Spec - `/tech-spec`
+2. Conduct user research (optional) - `/research`
+3. Create UX design (if UI-heavy) - `/create-ux-design`
+
+---
+
+**This document was created using BMAD Method v6 - Phase 1 (Analysis)**
+
+*To continue: Run `/workflow-status` to see your progress and next recommended action.*

components/context/bmad/project-participants-widget/docs/sprint-plan-виджет-участников-проекта-2026-02-04.md

@@ -0,0 +1,251 @@
+# Sprint Plan: Виджет участников проекта
+
+**Date:** 2026-02-04
+**Scrum Master:** AI Assistant
+**Project Level:** 1
+**Total Stories:** 5
+**Total Points:** 12
+**Planned Sprints:** 2
+
+---
+
+## Executive Summary
+
+План спринта для улучшения виджета участников проекта включает исправление логики отображения участников и добавление информации о вкладах. Проект разделен на 2 спринта по 1 неделе каждый с общим объемом 12 story points.
+
+**Key Metrics:**
+- Total Stories: 5
+- Total Points: 12
+- Sprints: 2 (по 1 неделе)
+- Team Capacity: 8 points per sprint
+- Target Completion: 2026-02-18
+
+---
+
+## Story Inventory
+
+### STORY-001: Исправить логику создания участников
+
+**Priority:** Must Have
+
+**User Story:**
+As a: Пользователь кооператива
+I want to: Видеть себя в списке участников сразу после получения доступа к проекту
+So that: Я понимаю свой статус участия без необходимости делать вклад
+
+**Acceptance Criteria:**
+- [ ] Участник отображается в виджете сразу после подписания соглашения об участии
+- [ ] Не требуется делать вклад для отображения в списке участников
+- [ ] Логика создания Contributor изменена с "при первом вкладе" на "при подтверждении доступа"
+
+**Technical Notes:**
+Изменить условие создания Contributor entity в backend. Добавить проверку статуса appendix вместо проверки наличия вкладов.
+
+**Dependencies:**
+Нет
+
+**Points:** 2
+
+### STORY-002: Добавить расчет количества вкладов
+
+**Priority:** Must Have
+
+**User Story:**
+As a: Пользователь кооператива
+I want to: Видеть количество своих вкладов в проект
+So that: Я понимаю свой вклад в развитие проекта
+
+**Acceptance Criteria:**
+- [ ] Для каждого участника рассчитывается общее количество вкладов
+- [ ] Данные агрегируются из таблицы segments эффективно
+- [ ] Расчет не вызывает N+1 запросов к базе данных
+- [ ] Поле contributed_total добавлено в Contributor entity
+
+**Technical Notes:**
+Создать функцию агрегации данных из segments. Оптимизировать запросы с использованием индексов БД. Добавить поле в Contributor entity.
+
+**Dependencies:**
+STORY-001 (нужна правильная логика создания участников)
+
+**Points:** 3
+
+### STORY-003: Обновить GraphQL селектор
+
+**Priority:** Must Have
+
+**User Story:**
+As a: Frontend разработчик
+I want to: Получать данные о количестве вкладов через GraphQL API
+So that: Могу отображать информацию о вкладах в UI
+
+**Acceptance Criteria:**
+- [ ] GraphQL query capitalContributors возвращает поле totalContributions
+- [ ] Селектор ContributorSelector включает новое поле
+- [ ] API корректно агрегирует данные из backend
+- [ ] Типизация TypeScript обновлена
+
+**Technical Notes:**
+Добавить поле totalContributions в ContributorSelector. Обновить GraphQL schema и resolvers. Протестировать типизацию.
+
+**Dependencies:**
+STORY-002 (нужен расчет количества вкладов)
+
+**Points:** 2
+
+### STORY-004: Обновить UI компонент
+
+**Priority:** Must Have
+
+**User Story:**
+As a: Пользователь кооператива
+I want to: Видеть количество вкладов участников в графической форме
+So that: Визуально понимаю вклад каждого участника
+
+**Acceptance Criteria:**
+- [ ] ContributorsListWidget отображает количество вкладов
+- [ ] Информация представлена в понятной графической форме
+- [ ] Дизайн адаптивен для различных устройств
+- [ ] Роли участников корректно отображаются
+
+**Technical Notes:**
+Обновить ContributorsListWidget.vue для отображения поля totalContributions. Добавить графические элементы (иконки, бейджи). Протестировать адаптивность.
+
+**Dependencies:**
+STORY-003 (нужен GraphQL API)
+
+**Points:** 2
+
+### STORY-005: Тестирование новой функциональности
+
+**Priority:** Must Have
+
+**User Story:**
+As a: QA инженер
+I want to: Убедиться что новая функциональность работает корректно
+So that: Уверен в качестве релиза
+
+**Acceptance Criteria:**
+- [ ] Интеграционное тестирование всех изменений проведено
+- [ ] Существующие функции не нарушены
+- [ ] Время загрузки списка участников не превышает 2 секунды
+- [ ] Пагинация работает плавно при большом количестве участников
+- [ ] Все acceptance criteria из tech-spec выполнены
+
+**Technical Notes:**
+Создать интеграционные тесты. Провести ручное тестирование всех сценариев. Замерить производительность. Проверить кросс-браузерную совместимость.
+
+**Dependencies:**
+STORY-001, STORY-002, STORY-003, STORY-004 (все изменения должны быть готовы)
+
+**Points:** 3
+
+---
+
+## Sprint Allocation
+
+### Sprint 1 (Неделя 1) - 7/8 points
+
+**Goal:** Реализовать backend изменения для корректного отображения участников и их вкладов
+
+**Stories:**
+- STORY-001: Исправить логику создания участников (2 points) - Must Have
+- STORY-002: Добавить расчет количества вкладов (3 points) - Must Have
+- STORY-003: Обновить GraphQL селектор (2 points) - Must Have
+
+**Total:** 7 points / 8 capacity (88% utilization)
+
+**Risks:**
+- Сложности с изменением логики создания участников (mitigation: предварительный анализ кода)
+
+**Dependencies:**
+- Доступ к backend инфраструктуре
+
+---
+
+### Sprint 2 (Неделя 2) - 5/8 points
+
+**Goal:** Завершить frontend обновления и протестировать новую функциональность виджета
+
+**Stories:**
+- STORY-004: Обновить UI компонент (2 points) - Must Have
+- STORY-005: Тестирование новой функциональности (3 points) - Must Have
+
+**Total:** 5 points / 8 capacity (63% utilization)
+
+**Risks:**
+- Проблемы с производительностью при большом количестве участников (mitigation: оптимизация запросов)
+
+**Dependencies:**
+- Завершенные backend изменения из Sprint 1
+
+---
+
+## Epic Traceability
+
+| Epic ID | Epic Name | Stories | Total Points | Sprint |
+|---------|-----------|---------|--------------|--------|
+| EPIC-001 | Улучшение виджета участников проекта | STORY-001, 002, 003, 004, 005 | 12 points | Sprint 1-2 |
+
+---
+
+## Requirements Coverage
+
+| FR ID | FR Name | Story | Sprint |
+|-------|---------|-------|--------|
+| FR-001 | Исправление логики отображения участников | STORY-001 | 1 |
+| FR-002 | Добавление поля с количеством вкладов | STORY-002, 003, 004 | 1-2 |
+| FR-003 | Интеграция с API для данных о вкладах | STORY-003 | 1 |
+| FR-004 | Отображение ролей участников | STORY-004 | 2 |
+| FR-005 | Тестирование новой функциональности | STORY-005 | 2 |
+
+---
+
+## Risks and Mitigation
+
+**High:**
+- Технические сложности изменения логики создания участников
+  - **Likelihood:** Средний
+  - **Mitigation:** Предварительный анализ кода, создание плана отката
+
+**Medium:**
+- Проблемы с производительностью при расчете вкладов
+  - **Likelihood:** Средний
+  - **Mitigation:** Оптимизация запросов, использование индексов БД
+
+**Low:**
+- Несовместимость с существующей синхронизацией блокчейна
+  - **Likelihood:** Низкий
+  - **Mitigation:** Тщательное тестирование синхронизации данных
+
+---
+
+## Definition of Done
+
+For a story to be considered complete:
+- [ ] Code implemented and committed
+- [ ] Unit tests written and passing (≥80% coverage)
+- [ ] Integration tests passing
+- [ ] Code reviewed and approved
+- [ ] Documentation updated
+- [ ] Acceptance criteria validated
+- [ ] Non-functional requirements met (performance, security)
+
+---
+
+## Next Steps
+
+**Immediate:** Begin Sprint 1
+
+Run /create-story to create detailed story documents for Sprint 1 stories, or run /dev-story STORY-001 to implement a specific story.
+
+**Sprint cadence:**
+- Sprint length: 1 week
+- Sprint planning: Monday Week 1
+- Sprint review: Friday Week 1
+- Sprint retrospective: Friday Week 1
+
+**Recommended:** Start with /dev-story STORY-001 to begin backend changes
+
+---
+
+**This plan was created using BMAD Method v6 - Phase 4 (Implementation Planning)**

components/context/bmad/project-participants-widget/docs/sprint-status.yaml

@@ -0,0 +1,90 @@
+version: "6.0.0"
+project_name: "Виджет участников проекта"
+project_type: "web-app"
+project_level: 1
+sprint_plan_path: "docs/sprint-plan-виджет-участников-проекта-2026-02-04.md"
+current_sprint: 1
+sprint_length_weeks: 1
+
+sprints:
+  - sprint_number: 1
+    start_date: "2026-02-04"
+    end_date: "2026-02-11"
+    capacity_points: 8
+    committed_points: 7
+    completed_points: 0
+    status: "not_started"
+    goal: "Реализовать backend изменения для корректного отображения участников и их вкладов"
+    stories:
+      - story_id: "STORY-001"
+        title: "Исправить логику создания участников"
+        points: 2
+        status: "not_started"
+        assigned_to: null
+        acceptance_criteria:
+          - "Участник отображается в виджете сразу после подписания соглашения об участии"
+          - "Не требуется делать вклад для отображения в списке участников"
+          - "Логика создания Contributor изменена с 'при первом вкладе' на 'при подтверждении доступа'"
+      - story_id: "STORY-002"
+        title: "Добавить расчет количества вкладов"
+        points: 3
+        status: "not_started"
+        assigned_to: null
+        acceptance_criteria:
+          - "Для каждого участника рассчитывается общее количество вкладов"
+          - "Данные агрегируются из таблицы segments эффективно"
+          - "Расчет не вызывает N+1 запросов к базе данных"
+          - "Поле contributed_total добавлено в Contributor entity"
+      - story_id: "STORY-003"
+        title: "Обновить GraphQL селектор"
+        points: 2
+        status: "not_started"
+        assigned_to: null
+        acceptance_criteria:
+          - "GraphQL query capitalContributors возвращает поле totalContributions"
+          - "Селектор ContributorSelector включает новое поле"
+          - "API корректно агрегирует данные из backend"
+          - "Типизация TypeScript обновлена"
+
+  - sprint_number: 2
+    start_date: "2026-02-11"
+    end_date: "2026-02-18"
+    capacity_points: 8
+    committed_points: 5
+    completed_points: 0
+    status: "pending"
+    goal: "Завершить frontend обновления и протестировать новую функциональность виджета"
+    stories:
+      - story_id: "STORY-004"
+        title: "Обновить UI компонент"
+        points: 2
+        status: "pending"
+        assigned_to: null
+        acceptance_criteria:
+          - "ContributorsListWidget отображает количество вкладов"
+          - "Информация представлена в понятной графической форме"
+          - "Дизайн адаптивен для различных устройств"
+          - "Роли участников корректно отображаются"
+      - story_id: "STORY-005"
+        title: "Тестирование новой функциональности"
+        points: 3
+        status: "pending"
+        assigned_to: null
+        acceptance_criteria:
+          - "Интеграционное тестирование всех изменений проведено"
+          - "Существующие функции не нарушены"
+          - "Время загрузки списка участников не превышает 2 секунды"
+          - "Пагинация работает плавно при большом количестве участников"
+          - "Все acceptance criteria из tech-spec выполнены"
+
+velocity:
+  sprint_1: null  # Будет заполнено после завершения спринта
+  sprint_2: null
+  rolling_average: null
+
+team:
+  size: 1
+  sprint_length_weeks: 1
+  capacity_per_sprint: 8
+  developer_level: "mid"
+  productive_hours_per_day: 5

components/context/bmad/project-participants-widget/docs/tech-spec-виджет-участников-проекта-2026-02-04.md

@@ -0,0 +1,228 @@
+# Technical Specification: Виджет участников проекта
+
+**Date:** 2026-02-04
+**Author:** AI Assistant
+**Version:** 1.0
+**Project Type:** web-app
+**Project Level:** 1
+**Status:** Draft
+
+---
+
+## Document Overview
+
+This Technical Specification provides focused technical planning for Виджет участников проекта. It is designed for smaller projects (Level 0-1) that need clear requirements without heavyweight PRD overhead.
+
+**Related Documents:**
+- Product Brief: docs/product-brief-виджет-участников-проекта-2026-02-04.md
+
+---
+
+## Problem & Solution
+
+### Problem Statement
+
+Пользователи не имеют полной информации о своем участии в проекте. Существует две критические проблемы:
+
+1. **Отсутствие информации о вкладах**: После регистрации в проекте участник получает долю авторского права, но эта информация не отображается в интерфейсе. Виджет показывает только текущую информацию об участии, но не исторические данные о вкладах.
+
+2. **Неправильная логика отображения участников**: Участники отображаются в виджете только после того, как сделали конкретный вклад в проект. Однако участники должны отображаться сразу после подачи заявления на участие и получения доступа к проекту. Это приводит к тому, что новые участники не видят себя в списке участников до тех пор, пока не внесут вклад.
+
+### Proposed Solution
+
+Комплексное улучшение виджета участников проекта:
+
+1. **Исправление логики отображения участников**: Участники должны отображаться сразу после получения доступа к проекту (после подачи заявления и подписания соглашения об участии), а не только после внесения вклада.
+
+2. **Добавление информации о вкладах**: Графическое отображение количества вкладов участника и информации о процессе становления участником проекта.
+
+---
+
+## Requirements
+
+### What Needs to Be Built
+
+- Исправление логики отображения участников (отображение сразу после получения доступа)
+- Добавление поля с количеством вкладов в графической форме
+- Интеграция с API для получения данных о вкладах и статусе участников
+- Отображение ролей участников
+- Тестирование новой функциональности
+
+### What This Does NOT Include
+
+- Изменение существующей логики учета вкладов
+- Переработка дизайна всего виджета
+- Добавление новых типов участников
+- Интеграция с внешними системами учета
+
+---
+
+## Technical Approach
+
+### Technology Stack
+
+- **Frontend Framework:** Vue 3 + TypeScript + Vite
+- **UI Library:** Quasar Framework
+- **State Management:** Pinia
+- **API:** GraphQL (Zeus SDK)
+- **Backend:** NestJS + TypeORM + PostgreSQL
+- **Blockchain Integration:** CoopTypes contracts
+
+### Architecture Overview
+
+Проект использует FSD архитектуру с разделением на:
+- **Widgets Layer:** ContributorsListWidget - компонент отображения таблицы участников
+- **Entities Layer:** Contributor entity с store для управления данными
+- **Shared Layer:** Утилиты форматирования и API клиенты
+
+Данные участников хранятся в композитной сущности: часть в PostgreSQL БД, часть синхронизируется из блокчейна. Логика создания участников должна быть изменена с "при первом вкладе" на "при подтверждении доступа к проекту".
+
+### Data Model (if applicable)
+
+**Contributor Entity:**
+- id, username, coopname - базовые данные
+- contributor_hash - уникальный идентификатор в блокчейне
+- appendixes[] - массив хэшей проектов с доступом
+- contributed_as_* - поля с количеством вкладов по ролям
+- status - статус участника
+- created_at - дата создания
+
+**Segments Table:**
+- Связь между участниками и их вкладами
+- Используется для расчета contributed_as_* полей
+
+### API Design (if applicable)
+
+**GraphQL Queries:**
+- `capitalContributors(filter, options)` - получение списка участников с пагинацией
+- Фильтры: coopname, project_hash (опционально)
+- Пагинация: page, limit, sortBy, descending
+
+**Требуемые изменения:**
+- Модификация логики создания Contributor - создавать при подтверждении appendix вместо первого вклада
+- Добавление расчета количества вкладов для каждого участника
+- Обновление ContributorSelector для включения поля общего количества вкладов
+
+---
+
+## Implementation Plan
+
+### Stories
+
+1. **Исправить логику создания участников** - Изменить процесс создания Contributor с "при первом вкладе" на "при подтверждении доступа к проекту"
+2. **Добавить расчет количества вкладов** - Создать логику агрегации данных из segments для каждого участника
+3. **Обновить GraphQL селектор** - Добавить поле общего количества вкладов в ContributorSelector
+4. **Обновить UI компонент** - Добавить отображение количества вкладов в ContributorsListWidget
+5. **Тестирование новой функциональности** - Провести интеграционное тестирование всех изменений
+
+### Development Phases
+
+**Phase 1: Backend Changes (3 дня)**
+- Изменение логики создания участников
+- Добавление расчета количества вкладов
+- Обновление GraphQL селектора
+
+**Phase 2: Frontend Updates (2 дня)**
+- Обновление UI компонента
+- Тестирование отображения
+
+**Phase 3: Integration & Testing (2 дня)**
+- Интеграционное тестирование
+- Проверка существующих функций
+
+---
+
+## Acceptance Criteria
+
+How we'll know it's done:
+
+- Участники отображаются в виджете сразу после получения доступа к проекту (подписания соглашения об участии)
+- Виджет корректно отображает количество вкладов участников
+- Информация о вкладах представлена в понятной графической форме
+- Роли участников корректно отображаются после назначения
+- Новая функциональность не нарушает работу существующего виджета
+- Все acceptance criteria из Product Brief выполнены
+
+---
+
+## Non-Functional Requirements
+
+### Performance
+
+- Время загрузки списка участников не должно превышать 2 секунды
+- Расчет количества вкладов должен выполняться эффективно без дополнительных N+1 запросов
+- Пагинация должна работать плавно при большом количестве участников
+
+### Security
+
+- Доступ к данным участников только для авторизованных пользователей кооператива
+- Валидация всех входных данных на backend
+- Логирование операций с данными участников
+
+### Other
+
+- Адаптивный дизайн для различных устройств
+- Поддержка существующих браузеров (Chrome, Firefox, Safari)
+- Локализация на русский язык
+
+---
+
+## Dependencies
+
+- Доступ к существующей инфраструктуре PostgreSQL и блокчейна
+- Существующие API для работы с appendix и segments
+- Команда backend разработчиков для изменений в логике создания участников
+
+---
+
+## Risks & Mitigation
+
+- **Технические сложности изменения логики создания участников**
+  - **Likelihood:** Средний
+  - **Mitigation:** Предварительный анализ кода и создание плана отката
+
+- **Проблемы с производительностью при расчете вкладов**
+  - **Likelihood:** Средний
+  - **Mitigation:** Оптимизация запросов, использование индексов БД
+
+- **Несовместимость с существующей синхронизацией блокчейна**
+  - **Likelihood:** Низкий
+  - **Mitigation:** Тщательное тестирование синхронизации данных
+
+---
+
+## Timeline
+
+**Target Completion:** 2026-02-18 (2 недели после начала разработки)
+
+**Milestones:**
+- Завершение анализа требований: 2026-02-04 (1 день)
+- Разработка backend изменений: 2026-02-05 - 2026-02-07 (3 дня)
+- Frontend обновления: 2026-02-10 - 2026-02-11 (2 дня)
+- Интеграционное тестирование: 2026-02-12 - 2026-02-13 (2 дня)
+- Деплой и мониторинг: 2026-02-14 - 2026-02-18 (1 неделя)
+
+---
+
+## Approval
+
+**Reviewed By:**
+- [ ] AI Assistant (Author)
+- [ ] Technical Lead
+- [ ] Product Owner
+
+---
+
+## Next Steps
+
+### Phase 4: Implementation
+
+For Level 1 projects (1-10 stories):
+- Run `/sprint-planning` to plan your sprint
+- Then create and implement stories
+
+---
+
+**This document was created using BMAD Method v6 - Phase 2 (Planning)**
+
+*To continue: Run `/workflow-status` to see your progress and next recommended workflow.*

components/context/notes/BLAGOROST-CHAIRMAN-ONBOARDING.md

@@ -0,0 +1,346 @@
+# Руководство по добавлению документов в онбординг председателя кооператива (Благорост)
+
+## Обзор системы
+
+Онбординг председателя кооператива по программе "Благорост" представляет собой последовательность шагов, где каждый шаг - это утверждение определенного документа советом кооператива.
+
+### Как работает система:
+
+1. **Председатель** отправляет документ на рассмотрение совета через интерфейс онбординга
+2. **Система** создает проект свободного решения с вопросом в повестке заседания совета
+3. **Совет** голосует по вопросу и принимает решение
+4. **Система отслеживания решений** автоматически отмечает шаг онбординга как завершенный
+5. **Интерфейс** обновляется, показывая завершенный шаг
+
+### Архитектура:
+
+- **Frontend**: Vue.js компонент `CapitalOnboardingCard.vue` отображает список шагов
+- **Backend**: NestJS сервисы обрабатывают создание решений и отслеживание их принятия
+- **Database**: Конфигурация расширения `capital` хранит состояние онбординга
+- **Blockchain**: Решения совета записываются в блокчейн
+- **Factory**: Генерирует документы на основе шаблонов
+
+## Шаги добавления нового документа в онбординг
+
+### 1. Создание документа в Factory
+
+#### 1.1 Создать Action (src/Actions/{registry_id}.{DocumentName}.ts)
+```typescript
+import { DraftContract } from 'cooptypes'
+import { DocumentName } from '../Templates'
+import { DocFactory } from '../Factory'
+import type { IGeneratedDocument, IGenerationOptions, IMetaDocument, ITemplate } from '../Interfaces'
+import type { MongoDBConnector } from '../Services/Databazor'
+
+export { DocumentName as Template } from '../Templates'
+
+export class Factory extends DocFactory<DocumentName.Action> {
+  constructor(storage: MongoDBConnector) {
+    super(storage)
+  }
+
+  async generateDocument(data: DocumentName.Action, options?: IGenerationOptions): Promise<IGeneratedDocument> {
+    let template: ITemplate<DocumentName.Model>
+
+    if (process.env.SOURCE === 'local') {
+      template = DocumentName.Template
+    } else {
+      template = await this.getTemplate(DraftContract.contractName.production, DocumentName.registry_id, data.block_num)
+    }
+
+    const meta: IMetaDocument = await this.getMeta({ title: template.title, ...data })
+    const vars = await this.getVars(data.coopname)
+    const coop = await this.getCooperative(data.coopname)
+
+    const combinedData: DocumentName.Model = {
+      meta,
+      coop,
+      vars,
+    }
+
+    await this.validate(combinedData, template.model)
+
+    const translation = template.translations[meta.lang]
+    const document: IGeneratedDocument = await this.generatePDF('', template.context, combinedData, translation, meta, options?.skip_save)
+
+    return document
+  }
+}
+```
+
+#### 1.2 Создать Template (src/Templates/{registry_id}.{DocumentName}.ts)
+```typescript
+import type { JSONSchemaType } from 'ajv'
+import { Cooperative } from 'cooptypes'
+import type { ITemplate } from '../Interfaces'
+import { IMetaJSONSchema } from '../Schema/MetaSchema'
+import { CommonUserSchema, CooperativeSchema, VarsSchema } from '../Schema'
+
+export const registry_id = Cooperative.Registry.DocumentName.registry_id
+
+// Модель действия для генерации
+export type Action = Cooperative.Registry.DocumentName.Action
+
+// Модель данных
+export type Model = Cooperative.Registry.DocumentName.Model
+
+// Схема для сверки
+export const Schema: JSONSchemaType<Model> = {
+  type: 'object',
+  properties: {
+    meta: IMetaJSONSchema,
+    coop: CooperativeSchema,
+    vars: VarsSchema,
+  },
+  required: ['meta', 'coop', 'vars'],
+  additionalProperties: true,
+}
+
+export const Template: ITemplate<Model> = {
+  title: Cooperative.Registry.DocumentName.title,
+  description: Cooperative.Registry.DocumentName.description,
+  model: Schema,
+  context: Cooperative.Registry.DocumentName.context,
+  translations: Cooperative.Registry.DocumentName.translations,
+}
+```
+
+#### 1.3 Добавить экспорт в src/Actions/index.ts
+```typescript
+export * as DocumentName from './{registry_id}.DocumentName'
+```
+
+### 2. Создание документа в CoopTypes
+
+#### 2.1 Создать определение в cooperative/registry/{registry_id}.{DocumentName}/index.ts
+```typescript
+import type { IGenerate, IMetaDocument } from '../../document'
+import type { ICommonUser, ICooperativeData, IVars } from '../../model'
+
+export const registry_id = {registry_id}
+
+// Модель действия для генерации
+export interface Action extends IGenerate {
+  registry_id: number
+}
+
+export type Meta = IMetaDocument & Action
+
+// Модель данных документа
+export interface Model {
+  meta: IMetaDocument
+  coop: ICooperativeData
+  vars: IVars
+}
+
+export const title = 'Название документа'
+export const description = 'Описание документа'
+export const context = `<div class="digital-document"><!-- HTML контент --></div>`
+export const translations = {
+  ru: {
+    // переводы
+  },
+}
+```
+
+#### 2.2 Добавить в cooperative/registry/index.ts
+```typescript
+export * as DocumentName from './{registry_id}.DocumentName'
+```
+
+### 3. Обновление Frontend
+
+#### 3.1 Обновить composable.ts (desktop/extensions/capital/features/Onboarding/model/composable.ts)
+```typescript
+// Добавить в stepToRegistryId
+const stepToRegistryId: Record<string, number> = {
+  'document_name': {registry_id},
+  // ... остальные
+};
+
+// Добавить шаг в stepsConfig (в нужной позиции)
+{
+  id: 'document_name',
+  title: 'Название документа для отображения',
+  description: 'Описание что делает этот шаг',
+  question: 'Вопрос для повестки совета',
+  decision: '',
+  decisionPrefix: 'Утвердить документ:',
+  status: state?.document_name_done ? 'completed' :
+          state?.onboarding_document_name_hash ? 'in_progress' : 'pending',
+  hash: typeof state?.onboarding_document_name_hash === 'string' && state.onboarding_document_name_hash ? state.onboarding_document_name_hash : null,
+  // depends_on: ['other_step'] // если есть зависимости
+},
+```
+
+### 4. Обновление Backend DTO
+
+#### 4.1 Обновить enum в onboarding.dto.ts
+```typescript
+export enum CapitalOnboardingStepEnum {
+  document_name = 'document_name',
+  // ... остальные
+}
+```
+
+#### 4.2 Добавить поля в CapitalOnboardingStateDTO
+```typescript
+@Field(() => Boolean)
+document_name_done!: boolean;
+
+@Field(() => String, { nullable: true })
+onboarding_document_name_hash?: string | null;
+```
+
+### 5. Обновление Backend Service
+
+#### 5.1 Обновить типы в onboarding.service.ts
+```typescript
+type OnboardingFlagKey =
+  | 'onboarding_document_name_done'
+  | // ... остальные
+
+type OnboardingHashKey =
+  | 'onboarding_document_name_hash'
+  | // ... остальные
+```
+
+#### 5.2 Обновить методы маппинга
+```typescript
+private mapStepToFlag(step: CapitalOnboardingStepEnum): OnboardingFlagKey {
+  switch (step) {
+    case CapitalOnboardingStepEnum.document_name:
+      return 'onboarding_document_name_done';
+    // ... остальные
+  }
+}
+
+private mapStepToHash(step: CapitalOnboardingStepEnum): OnboardingHashKey {
+  switch (step) {
+    case CapitalOnboardingStepEnum.document_name:
+      return 'onboarding_document_name_hash';
+    // ... остальные
+  }
+}
+
+private mapStepToVarsField(step: CapitalOnboardingStepEnum): string {
+  switch (step) {
+    case CapitalOnboardingStepEnum.document_name:
+      return 'document_name';
+    // ... остальные
+  }
+}
+```
+
+#### 5.3 Обновить buildState метод
+```typescript
+private buildState(pluginConfig: IConfig & Record<string, any>): CapitalOnboardingStateDTO {
+  return {
+    document_name_done: !!pluginConfig.onboarding_document_name_done,
+    onboarding_document_name_hash: pluginConfig.onboarding_document_name_hash || null,
+    // ... остальные поля
+  };
+}
+```
+
+### 6. Обновление GraphQL Schema
+
+#### 6.1 Добавить шаг в enum CapitalOnboardingStep
+```graphql
+enum CapitalOnboardingStep {
+  document_name
+  # ... остальные
+}
+```
+
+#### 6.2 Добавить поля в type CapitalOnboardingState
+```graphql
+type CapitalOnboardingState {
+  document_name_done: Boolean!
+  onboarding_document_name_hash: String
+  # ... остальные поля
+}
+```
+
+### 7. Обновление SDK
+
+#### 7.1 Обновить selectors/capital/onboardingStateSelector.ts
+```typescript
+const onboardingStateFields = {
+  document_name_done: true,
+  onboarding_document_name_hash: true,
+  // ... остальные
+} as const
+```
+
+### 8. Обновление сервиса обработки событий
+
+#### 8.1 Обновить CapitalOnboardingEventsService
+```typescript
+private mapStepToFlag(step: string): keyof IConfig | null {
+  const mapping: Record<string, keyof IConfig> = {
+    document_name: 'onboarding_document_name_done',
+    // ... остальные
+  };
+
+  return mapping[step] || null;
+}
+```
+
+### 9. Обновление конфигурации расширения
+
+#### 9.1 Добавить поля в defaultConfig (capital-extension.module.ts)
+```typescript
+export const defaultConfig = {
+  // ... другие поля
+
+  // Онбординг флаги
+  onboarding_document_name_done: false,
+  // ... остальные onboarding флаги
+} as const;
+```
+
+#### 9.2 Добавить поля в Zod-схему (capital-extension.module.ts)
+```typescript
+// Онбординг флаги
+onboarding_document_name_done: z
+  .boolean()
+  .default(defaultConfig.onboarding_document_name_done)
+  .describe(describeField({ label: 'Описание шага онбординга', visible: false })),
+// ... остальные onboarding поля
+```
+
+**Примечание:** Hash поля (`onboarding_document_name_hash`) не нужно добавлять в конфигурацию, так как они используются опционально и инициализируются как `null` по умолчанию.
+
+## Проверка работы
+
+1. **Проверить отсутствие ошибок TypeScript** в файлах:
+   - `capital-extension.module.ts`
+   - `onboarding-events.service.ts`
+   - Других обновленных файлах
+
+2. Перезапустить сервер
+3. Открыть интерфейс онбординга
+4. Проверить что новый документ появился в списке
+5. Отправить документ на рассмотрение совета
+6. Проверить логи на наличие предупреждений о неизвестном шаге
+7. Принять решение советом
+8. Проверить что шаг отмечен как завершенный
+
+## Возможные проблемы
+
+1. **"Неизвестный шаг онбординга"** - проверить маппинг в CapitalOnboardingEventsService
+2. **Документ не генерируется** - проверить Action и Template в Factory
+3. **Шаг не отображается** - проверить composable.ts на фронтенде
+4. **GraphQL ошибки** - проверить схему и DTO
+
+## Полезные команды
+
+```bash
+# Проверить логи контроллера
+tail -f logs/controller.log
+
+# Перезапустить сервисы
+pnpm restart:controller
+pnpm restart:desktop
+```

components/context/notes/CAPITAL_REGISTRATION_FLOW.md

@@ -0,0 +1,106 @@
+# Система регистрации в CAPITAL: выбор пути
+
+## Обзор
+
+Система регистрации в CAPITAL поддерживает два пути регистрации участников кооператива: **Благорост** и **Генератор**. Каждый путь определяет набор документов, которые необходимо подписать участнику для завершения регистрации.
+
+## Архитектура потоков
+
+### 1. Первоначальный выбор программы (SignUp.vue)
+
+**Местоположение:** `desktop/src/pages/Registrator/SignUp/SignUp.vue`
+
+На этапе первичной регистрации пользователь выбирает одну из двух программ:
+- **Программа Благорост** - подписывается `BlagorostOffer` (офферта Благорост)
+- **Программа Генератор** - подписывается `GeneratorOffer` (офферта Генератор)
+
+Выбор сохраняется в поле `program_key` сущности `Contributor`:
+- `GENERATION` - для программы Генератор
+- `CAPITALIZATION` - для программы Благорост
+
+### 2. Завершение регистрации (CapitalRegistrationPage.vue)
+
+**Местоположение:** `desktop/extensions/capital/pages/CapitalRegistrationPage/ui/CapitalRegistrationPage.vue`
+
+После первоначального выбора на странице завершения регистрации генерируется разный набор документов:
+
+#### Путь Генератора (`program_key = GENERATION`)
+Генерируются и подписываются **3 документа**:
+1. `GenerationContract` (Договор УХД) - всегда
+2. `StorageAgreement` (Соглашение о хранении имущества) - всегда
+3. `BlagorostAgreement` (Соглашение Благорост) - только для этого пути
+
+#### Путь Благороста (`program_key = CAPITALIZATION`)
+Генерируются и подписываются **2 документа**:
+1. `GenerationContract` (Договор УХД) - всегда
+2. `StorageAgreement` (Соглашение о хранении имущества) - всегда
+3. `BlagorostAgreement` НЕ генерируется (уже подписано через оферту)
+
+## Сохранение данных
+
+### Contributor entity
+```typescript
+program_key?: string;                    // Ключ выбранной программы
+blagorost_offer_hash?: string;           // Хеш подписанной оферты Благорост
+generator_offer_hash?: string;           // Хеш подписанной оферты Генератор
+generation_contract_hash?: string;       // Хеш подписанного договора УХД
+storage_agreement_hash?: string;         // Хеш подписанного соглашения о хранении
+blagorost_agreement_hash?: string;       // Хеш подписанного соглашения Благорост
+```
+
+### Udata параметры документов
+Для каждого документа генерируются уникальные параметры:
+```typescript
+// Благорост
+blagorost_agreement_number: string;      // Номер соглашения
+blagorost_agreement_created_at: string;  // Дата создания
+
+// Генератор
+generator_agreement_number: string;      // Номер соглашения
+generator_agreement_created_at: string;  // Дата создания
+
+// Договор УХД
+generation_contract_number: string;      // Номер договора
+generation_contract_created_at: string;  // Дата создания
+
+// Соглашение о хранении
+storage_agreement_number: string;        // Номер соглашения
+storage_agreement_created_at: string;    // Дата создания
+```
+
+## Ключевые особенности
+
+1. **Условная генерация**: Набор документов зависит от первоначального выбора программы
+2. **Единая точка сохранения**: Один ключ `blagorost_agreement_number` используется для параметров соглашения Благорост, независимо от того, подписано ли оно через оферту или отдельно
+3. **Проверка завершения**: Регистрация считается завершенной при наличии `generation_contract_hash` и `storage_agreement_hash`
+4. **Блокчейн интеграция**: Все подписанные документы отправляются в блокчейн через действие `regcontrib`
+
+## API endpoints
+
+### Генерация документов
+```graphql
+mutation GenerateCapitalRegistrationDocuments($data: GenerateCapitalRegistrationDocumentsInputDTO!) {
+  generateCapitalRegistrationDocuments(data: $data) {
+    generation_contract { html, hash }
+    storage_agreement { html, hash }
+    blagorost_agreement { html, hash }  # опционально
+  }
+}
+```
+
+### Отправка в блокчейн
+```graphql
+mutation CompleteCapitalRegistration($data: CompleteCapitalRegistrationInputDTO!) {
+  completeCapitalRegistration(data: $data) {
+    transaction_id
+  }
+}
+```
+
+## Расширения и сервисы
+
+- **ParticipationManagementInteractor**: бизнес-логика регистрации
+- **UdataDocumentParametersService**: генерация параметров документов
+- **RegistrationDocumentsService**: генерация пакета документов
+- **useGenerateCapitalRegistrationDocuments**: фронтенд-композабл для генерации
+- **useCompleteCapitalRegistration**: фронтенд-композабл для отправки в блокчейн

components/context/notes/CIRCULAR_DEPS_QUICK_FIX.md

@@ -0,0 +1,147 @@
+# 🚨 Быстрое исправление циклических зависимостей
+
+## Увидел ошибку? Действуй!
+
+```
+Error: A circular dependency has been detected inside DocumentDomainModule
+```
+
+### Шаг 1: Запусти анализ (30 секунд)
+
+```bash
+pnpm analyze:modules
+```
+
+Откроются 2 файла:
+- `potential-circular-dependencies.md` - **НАЧНИ С ЭТОГО!**
+- `module-dependency-graph.md` - полный граф
+
+### Шаг 2: Найди проблему в отчёте
+
+Открой `potential-circular-dependencies.md` и ищи:
+
+#### A) Секция "CRITICAL: Global modules importing non-global"
+```md
+### ❌ BlockchainModule (@Global)
+**Problematic imports:**
+  - ❌ RegistrationDomainModule (not global)  👈 ВОТ ОНО!
+```
+
+**Решение:**
+```typescript
+// Вариант 1: Убери импорт
+@Global()
+@Module({
+  imports: [],  // Убрал RegistrationDomainModule
+})
+export class BlockchainModule {}
+
+// Вариант 2: Сделай импортируемый модуль тоже глобальным
+@Global()  // Добавил
+@Module({...})
+export class RegistrationDomainModule {}
+```
+
+#### B) Секция "Highly Coupled Modules"
+```md
+### DocumentDomainModule 📦
+⚠️ WARNING: Non-global module used by global module(s)!  👈 ПРОБЛЕМА!
+```
+
+**Решение:**
+```typescript
+// В глобальном модуле используй forwardRef
+@Global()
+@Module({
+  imports: [forwardRef(() => DocumentDomainModule)],
+})
+```
+
+### Шаг 3: Если анализ не помог - метод комментирования
+
+**В `app.module.ts`:**
+
+```typescript
+@Module({
+  imports: [
+    // Инфраструктура
+    DatabaseModule,
+    RedisModule,
+
+    // Domain - КОММЕНТИРУЙ ПО ОДНОМУ!
+    // AuthDomainModule,
+    // AccountDomainModule,
+    RegistrationDomainModule,  // 👈 Раскомментируй это
+    // DocumentDomainModule,     // 👈 Потом это
+    // ParticipantDomainModule,  // 👈 Потом это
+  ],
+})
+```
+
+**Алгоритм:**
+1. Закомментируй ВСЕ domain-модули
+2. Раскомментируй по одному
+3. После каждого раскомментирования запускай: `pnpm dev`
+4. Когда ошибка появится → ты нашёл виновника!
+
+### Шаг 4: Применяй стандартные решения
+
+#### Решение 1: forwardRef в imports
+```typescript
+@Module({
+  imports: [
+    forwardRef(() => AccountDomainModule),
+    forwardRef(() => DocumentDomainModule),
+  ],
+})
+export class ParticipantDomainModule {}
+```
+
+#### Решение 2: forwardRef в инжекции
+```typescript
+@Injectable()
+export class MyService {
+  constructor(
+    @Inject(forwardRef(() => SOME_SERVICE))
+    private readonly someService: SomeService
+  ) {}
+}
+```
+
+#### Решение 3: Убрать лишний модуль
+```typescript
+// ❌ БЫЛО два модуля
+// document/document.module.ts
+// document/document-validation.module.ts
+
+// ✅ СТАЛО один модуль
+@Module({
+  providers: [
+    DocumentService,
+    DocumentValidationService,  // Просто добавили сюда
+  ],
+})
+export class DocumentDomainModule {}
+```
+
+## 🎯 Чеклист: Что НЕ делать
+
+- ❌ Не меняй порядок импортов (не поможет!)
+- ❌ Не делай модуль глобальным без необходимости
+- ❌ Не создавай отдельный модуль для одного сервиса
+- ❌ Не импортируй не-глобальные модули в глобальные (без forwardRef)
+
+## 🎯 Чеклист: Что делать
+
+- ✅ Используй `pnpm analyze:modules` ПЕРВЫМ делом
+- ✅ Используй forwardRef для domain-модулей
+- ✅ Проверь, не является ли проблемный модуль глобальным
+- ✅ Используй метод комментирования для точной локализации
+
+## 📚 Подробности
+
+См. полное руководство: `CIRCULAR_DEPENDENCIES_GUIDE.md`
+
+---
+
+*Сохрани этот файл в закладки - он спасёт тебя часы отладки!*

components/context/notes/CONTRACTS-RULES.md

@@ -0,0 +1,44 @@
+Правило 0. Secondary index используется ровно один раз — для получения primary key. Любые чтения и все изменения состояния выполняются только по primary key.
+
+Запреты
+- ❌ Повторный get_*_by_hash() после emplace/modify
+- ❌ Передача hash в write-функции
+- ❌ Возврат row-объектов для дальнейшей мутации
+
+Разрешено
+✅ find(id) сколько угодно раз
+✅ modify(id) после любых изменений
+✅ Передача id между всеми слоями
+
+В прикладной форме
+- checksum256 / secondary_id — только вход
+- uint64_t (primary key) — вся внутренняя логика
+
+В одном action:
+- byhash.find() → получить id
+- дальше запрещены любые повторные lookup по secondary index
+
+Правило 1. Поиск по secondary_index'ам должен быть однократным. Запрещено в рамках одного действия повторно обращаться к поиску по secondary_index. 
+
+ПРАВИЛЬНО:
+auto project = get_project_or_fail(coopname, project_hash);
+uint64_t project_id = project.id;
+
+// дальше ВЕЗДЕ
+set_master(coopname, project_id, master);
+increment_total_authors(coopname, project_id);
+upsert_author_segment(coopname, project_id, master);
+
+
+НЕ ПРАВИЛЬНО:
+increment_total_authors(coopname, project_hash); // внутри снова lookup
+
+Правило 3. При работе с итераторами не используй перевод в объект
+segments_index segments(_capital, coopname.value);
+auto segment = segments.find(segment_id);
+
+auto amount = segment->debt_amount // ПРАВИЛЬНО
+
+auto segment_ = *segment  // НЕ ПРАВИЛЬНО
+auto amount = segment.amount
+  

components/context/notes/CONTROLLER_ARCH.md

@@ -0,0 +1,14 @@
+Чистая фрактальная трехуровневая архитектура срезов домена (domain) и инфраструктуры (infrastructure), оркестрируемая приложением (application). Фрактал раскрывается в расширениях (extensions), каждое из которых также выстраивается по правилам чистой трехуровневой архитектуры срезов домена и инфраструктуры с окрестрацией на уровне своего приложения.
+
+Общая архитектура связей:
+- AppResolver -> AppService[DTO<->Domain] -> AppInteractor -> DomainService -> DomainPort <- InfraAdapter -> [при необходимости] AnyAppOrDomainService
+
+Все сервисы внедряются через инъекцию (DI) с указанием символа реализации. Импорты разрешены только вглубь - к домену. Из домена переход разрешен только в инфраструктуру через порт и его адаптер.
+
+Прямые импорты без DI запрещены. Импорты из соседних срезов того же архитектурного уровня запрещены. Направление зависимостей от приложения - к домену, от домена через порт в его инфраструктурный адаптер.
+
+Взаимодействие расширений с основным приложением осуществляется только через порты домена основного приложения.
+
+Глобальные модули запрещены. В редких случаях сложных циклических зависимостей на период рефакторинга разрешается обоснованно использовать forwardRef.
+
+Уровень приложения оркестрирует вызовы доменов через порты в инфраструктуру. Домены не обращаются друг к друга. Срезы уровня приложений не обращаются друг к другу, а только вызывают порты домена.

components/context/notes/CONTROLLER_DECISIONS_TRACKING_FACTORY.md

@@ -0,0 +1,239 @@
+# Фабрика отслеживания решений (Decision Tracking Factory)
+
+## Назначение
+
+Фабрика отслеживания решений — это переиспользуемый сервис для автоматического обновления системных переменных (vars) при принятии решений советом или общим собранием пайщиков.
+
+## Архитектура
+
+Система построена согласно чистой архитектуре:
+
+```
+domain/decision-tracking/          # Домен
+├── interfaces/                    # Интерфейсы
+│   └── tracking-rule-domain.interface.ts
+├── ports/                         # Порты
+│   └── decision-tracking.port.ts
+├── events/                        # События
+│   └── decision-tracked.event.ts
+└── index.ts
+
+infrastructure/decision-tracking/  # Инфраструктура
+├── adapters/                      # Адаптеры
+│   └── decision-tracking.adapter.ts
+├── repositories/                  # Репозитории
+│   └── tracking-rule.repository.ts
+└── decision-tracking-infrastructure.module.ts
+```
+
+## Принцип работы
+
+### 1. Регистрация правила отслеживания
+
+Расширение регистрирует правило отслеживания при создании решения:
+
+```typescript
+await decisionTrackingPort.registerTrackingRule({
+  hash: documentHash,
+  event_type: DecisionEventType.SOVIET_DECISION, // или MEET_DECISION
+  vars_field: 'wallet_agreement',
+  metadata: {
+    onboarding_step: 'wallet_agreement',
+    custom_data: '...'
+  },
+  expires_at: new Date('2025-02-15')
+});
+```
+
+### 2. Автоматическое отслеживание
+
+Фабрика автоматически подписывается на события блокчейна:
+- `action::soviet::newresolved` - решения совета
+- `action::meet::newresolved` - решения общих собраний
+- `action::meet::restartmeet` - перезапуск общих собраний
+
+### 3. Обработка совпадений
+
+При получении события с подходящим hash фабрика:
+1. Находит соответствующее правило отслеживания
+2. Обновляет поле в vars (если указаны decision_id и decision_date)
+3. Деактивирует правило
+4. Эмитит событие `decision.tracked`
+
+### 4. Пост-обработка через события
+
+Расширения могут подписаться на событие `decision.tracked` для дополнительной обработки:
+
+```typescript
+@OnEvent(DecisionTrackedEvent.eventName)
+async handleDecisionTracked(event: DecisionTrackedEvent): Promise<void> {
+  const { result } = event;
+
+  // Выполнить дополнительные действия
+  if (result.metadata?.onboarding_step) {
+    await this.updateOnboardingProgress(result.metadata.onboarding_step);
+  }
+}
+```
+
+## Использование
+
+### В расширениях
+
+1. Импортировать модуль инфраструктуры:
+
+```typescript
+@Module({
+  imports: [
+    DecisionTrackingInfrastructureModule,
+    // ...
+  ],
+})
+export class MyExtensionModule {}
+```
+
+2. Инжектировать порт:
+
+```typescript
+constructor(
+  @Inject(DECISION_TRACKING_PORT)
+  private readonly decisionTrackingPort: DecisionTrackingPort
+) {}
+```
+
+3. Регистрировать правила при создании решений:
+
+```typescript
+await this.decisionTrackingPort.registerTrackingRule({
+  hash: documentHash,
+  event_type: DecisionEventType.SOVIET_DECISION,
+  vars_field: 'my_agreement',
+  metadata: { /* custom data */ }
+});
+```
+
+4. Подписаться на события отслеживания (опционально):
+
+```typescript
+@OnEvent(DecisionTrackedEvent.eventName)
+async handleTracked(event: DecisionTrackedEvent) {
+  // Пост-обработка
+}
+```
+
+## API
+
+### DecisionTrackingPort
+
+#### registerTrackingRule(input)
+Регистрирует новое правило отслеживания.
+
+**Параметры:**
+- `hash` - Hash документа для отслеживания
+- `event_type` - Тип события (SOVIET_DECISION или MEET_DECISION)
+- `vars_field` - Ключ в vars для обновления
+- `metadata` - Метаданные для пост-обработки
+- `expires_at` - Дата истечения правила (опционально)
+
+**Возвращает:** `TrackingRuleDomainInterface`
+
+#### updateTrackingRuleHash(oldHash, newHash)
+Обновляет hash в существующем правиле (используется при перезапуске общих собраний).
+
+#### getActiveRules()
+Получает все активные правила отслеживания.
+
+#### getRuleByHash(hash)
+Получает правило по hash документа.
+
+#### deactivateRule(id)
+Деактивирует правило отслеживания.
+
+#### deleteRule(id)
+Удаляет правило отслеживания.
+
+
+## События
+
+### DecisionTrackedEvent
+
+Эмитится при успешном отслеживании и обработке решения.
+
+**Данные события:**
+```typescript
+{
+  matched: true,
+  rule_id: 'uuid',
+  hash: 'document_hash',
+  event_type: DecisionEventType.SOVIET_DECISION,
+  vars_field: 'wallet_agreement',
+  decision_id: '123',
+  decision_date: '2025-01-17T12:00:00Z',
+  metadata: { /* custom data */ }
+}
+```
+
+## Особенности
+
+### Общие собрания
+Для общих собраний поддерживается автоматическое обновление hash при перезапуске через событие `restartmeet`.
+
+### Управление правилами
+Расширения сами управляют своими правилами отслеживания. Если нужно отключить отслеживание, расширение должно вызвать `deactivateRule()` или `deleteRule()`. Фабрика не имеет встроенной логики истечения правил.
+
+### TypeORM хранилище
+Используется TypeORM репозиторий с PostgreSQL для персистентного хранения правил отслеживания. Правила сохраняются в таблице `tracking_rules`.
+
+## Пример: Онбординг председателя
+
+```typescript
+// Регистрация отслеживания решения
+const document = await this.generateDecisionDocument(...);
+
+await this.decisionTrackingPort.registerTrackingRule({
+  hash: document.hash,
+  event_type: DecisionEventType.SOVIET_DECISION,
+  vars_field: 'wallet_agreement',
+  metadata: {
+    onboarding_step: 'wallet_agreement',
+  },
+  expires_at: onboardingExpireDate,
+});
+
+// Подписка на событие для обновления статуса онбординга
+@OnEvent(DecisionTrackedEvent.eventName)
+async handleDecisionTracked(event: DecisionTrackedEvent) {
+  if (event.result.metadata?.onboarding_step) {
+    await this.markOnboardingStepComplete(
+      event.result.metadata.onboarding_step
+    );
+  }
+}
+```
+
+## Миграции базы данных
+
+При первом запуске будет автоматически создана таблица `tracking_rules`:
+
+```sql
+CREATE TABLE tracking_rules (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  hash VARCHAR(64) NOT NULL UNIQUE,
+  event_type VARCHAR(20) NOT NULL,
+  vars_field VARCHAR(50) NOT NULL,
+  metadata JSONB,
+  active BOOLEAN DEFAULT TRUE,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  expires_at TIMESTAMP
+);
+
+CREATE INDEX idx_tracking_rules_hash ON tracking_rules(hash);
+```
+
+## Преимущества
+
+1. **Переиспользуемость** - Единая логика отслеживания для всех расширений
+2. **Разделение ответственности** - Фабрика отвечает только за отслеживание и обновление vars
+3. **Расширяемость** - Пост-обработка через события не нарушает DI
+4. **Автоматизация** - Отслеживание происходит автоматически без ручного вмешательства
+5. **Чистая архитектура** - Соблюдение принципов разделения на домен и инфраструктуру

components/context/notes/COOPSTORE_FUTURE_ARCH.md

@@ -0,0 +1,118 @@
+# Техническое задание: Архитектура маркетплейса приложений для распределенных бэкендов
+
+## Контекст проблемы
+
+Мы имеем распределенную систему из множества бэкендов, каждый из которых обладает собственным локальным магазином приложений. Требуется централизовать управление приложениями через единый маркетплейс, обеспечив контроль доступа и монетизацию.
+
+## Основные требования
+
+1. **Централизованный каталог** приложений с возможностью монетизации
+2. **Установка приложений на уровне бэкенда** (не пользователя)
+3. **Контроль доступа** к платным приложениям
+4. **Минимальная нагрузка** на систему валидации
+5. **Безопасность** без единой точки отказа
+
+## Предлагаемая архитектура
+
+### 1. Компоненты системы
+
+```
+┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
+│   Маркетплейс   │────│   Распределенные  │────│   Приложения    │
+│   (Central API) │    │     Бэкенды      │    │  (Developers)   │
+└─────────────────┘    └──────────────────┘    └─────────────────┘
+```
+
+### 2. Модель токенов
+
+**Backend Admin Token**
+- Долгоживущий (365 дней)
+- Права: установка/удаление приложений, управление лицензиями
+- Используется только в server-to-server коммуникации
+
+**Backend User Token**
+- Краткосрочный (1 час)
+- Права: чтение списка установленных приложений
+- Используется для загрузки каталога пользователями
+
+**User App Access Token**
+- Краткосрочный (30 минут)
+- Содержит: backend_id, user_id, app_id, permissions
+- Передается в IFrame приложений для валидации доступа
+
+### 3. Workflow установки приложений
+
+**Для администраторов бэкенда:**
+1. Админ запрашивает полный каталог через Backend Admin Token
+2. Маркетплейс возвращает все приложения со статусами лицензий
+3. Админ выбирает приложение для установки
+4. Система проверяет наличие активной лицензии
+5. При успехе - создается запись об установке
+6. Бэкенд скачивает файлы приложения с серверов разработчика
+
+**Для обычных пользователей:**
+1. Пользователь заходит на сайт бэкенда
+2. Система запрашивает список установленных приложений через Backend User Token
+3. Маркетплейс возвращает только доступные для данного бэкенда приложения
+4. Пользователь выбирает приложение
+5. Бэкенд генерирует User App Access Token
+6. Приложение загружается в IFrame с переданным токеном
+
+### 4. Механизм контроля доступа
+
+**Трехуровневая валидация:**
+
+1. **Предварительная проверка** - маркетплейс фильтрует доступные приложения
+2. **Валидация при загрузке** - приложение проверяет JWT токен локально
+3. **Периодическая ревалидация** - приложение проверяет токен каждые 5 минут
+
+**Техническая реализация валидации:**
+- Приложения кэшируют публичные ключи бэкендов (24 часа)
+- Валидация JWT происходит статически без запросов к API
+- Короткое время жизни токенов (30 мин) минимизирует риски
+
+### 5. Монетизация и лицензии
+
+**Модель лицензирования:**
+- Лицензия выдается на уровень бэкенда
+- Поддержка различных моделей оплаты (месячная, годовая, perpetual)
+- Trial-периоды для тестирования
+- Автоматическое отключение при неоплате
+
+**Схема данных лицензий:**
+```sql
+backend_licenses (backend_id, app_id, status, expires_at, payment_plan)
+installations (backend_id, app_id, installed_at, config)
+```
+
+### 6. Безопасность и производительность
+
+**Меры безопасности:**
+- Разделение прав через разные типы токенов
+- Короткое время жизни пользовательских токенов
+- Статическая валидация без зависимостей от API маркетплейса
+- Кэширование криптографических ключей
+
+**Оптимизация производительности:**
+- Локальная проверка JWT подписей (~1-5ms)
+- Кэширование публичных ключей (24 часа)
+- Минимальные запросы к центральному API
+- Предварительная фильтрация на стороне маркетплейса
+
+## Критические вопросы для дальнейшего исследования
+
+1. **Механизм отзыва доступа** - как оперативно блокировать приложения при неоплате?
+2. **Кэширование и инвалидация** - стратегии обновления публичных ключей
+3. **Мониторинг и аналитика** - отслеживание использования платных функций
+4. **Grace period** -如何处理 situations when payment is delayed?
+5. **Миграция с текущей системы** - план перехода с локальных магазинов
+
+## Expected Outcomes
+
+- Единая точка управления приложениями
+- Контроль доступа к платному контенту
+- Масштабируемая архитектура
+- Минимальное влияние на производительность
+- Гибкая система монетизации
+
+Требуется проработка каждого компонента с учетом конкретных технических ограничений и бизнес-требований.

components/context/notes/DESKTOP_CHAIRMAN_INFO.md

@@ -0,0 +1,10 @@
+## Подключение (frontend)
+
+Зачем: дать кооперативу пройти «подключение» на платформе, фиксируя шаги через документы/решения.
+
+Как работает:
+- Страница `ConnectPage` (маршрут `/chairman/connect`) выводит 6 шагов: 5 предложений повестки (кошелёк, ПЭП, privacy, ПС, заявления) + 1 шаг общего собрания.
+- Шаги 1–5: кнопка открывает диалог с автотекстом → фронт шлёт `completeChairmanAgendaStep`, бэк генерирует и сразу публикует проект решения в блокчейн, сохраняет hash документа и ждёт подтверждения решения (событие `newresolved`). До события шаг помечается «в процессе».
+- Шаг 6: используется стандартный поток `createMeetWithAgenda` (генерация + подпись повестки), фронт берёт hash повестки и передаёт в `completeChairmanGeneralMeetStep`; бэк ждёт `newresolved` с тем же hash.
+- Отображение статуса: флаги из `getChairmanOnboardingState`. Для шагов 1–5, если флага нет, но в `vars` уже есть шапка документа — считаем выполненным (приоритет: vars).
+- Таймер: показывается время до `onboarding_expire_at` (30 дней от старта, выдаёт бэк). После истечения шаги не принимаются автоматически (ждём обновлений с сервера).

components/context/notes/DESKTOP_CHATCOOP_README.md

@@ -0,0 +1,65 @@
+# ChatCoop Extension
+
+Расширение для интеграции Matrix чата в кооперативную систему.
+
+## Описание
+
+ChatCoop предоставляет встроенный Matrix чат для пользователей кооператива. Расширение:
+
+- Получает временный токен аутентификации через GraphQL API
+- Отображает Matrix клиент (Element Web) в iframe
+- Автоматически аутентифицирует пользователя с полученным токеном
+
+## Структура
+
+```
+chatcoop/
+├── install.ts                    # Конфигурация рабочего стола
+├── entities/
+│   └── ChatCoopChat/             # Entity для работы с Matrix токенами
+│       ├── api/                  # GraphQL запросы через SDK
+│       └── model/                # Store и типы данных из SDK
+├── pages/
+│   └── ChatCoopPage/             # Главная страница с iframe
+├── shared/                       # Общие компоненты
+└── widgets/                      # Виджеты
+```
+
+## SDK интеграция
+
+Расширение использует типизированные запросы из SDK:
+
+- **Query**: `Queries.ChatCoop.GetToken`
+- **Selector**: `chatcoopTokenSelector`
+- **Типы**: Автоматически генерируются из GraphQL схемы
+
+## Работа с iframe URL
+
+1. При загрузке страницы вызывается `chatcoopStore.loadToken()`
+2. Entity отправляет типизированный GraphQL запрос через SDK: `Queries.ChatCoop.GetToken`
+3. Бэкенд проверяет/создает Matrix пользователя и генерирует токен
+4. Бэкенд формирует полную iframe URL с токеном аутентификации
+5. Store сохраняет полученную ссылку в состоянии (типизировано через SDK)
+6. Страница загружает iframe с готовой ссылкой
+7. Пользователь автоматически входит в Matrix чат
+
+## Конфигурация
+
+- **MATRIX_CLIENT_URL**: URL Element Web клиента
+- **workspace**: 'chatcoop'
+- **defaultRoute**: 'chat'
+
+## Архитектура
+
+Расширение построено по принципам Feature-Sliced Design (FSD):
+
+- **Entities**: `ChatCoopChat` - бизнес-сущность для работы с Matrix токенами
+- **Pages**: `ChatCoopPage` - UI страница без бизнес-логики
+- **Store**: Pinia store для управления состоянием токена
+- **API**: Функции для GraphQL запросов
+
+## Зависимости
+
+- GraphQL API с resolver `getToken`
+- Matrix Synapse сервер
+- Element Web клиент

components/context/notes/DESKTOP_POWERUP_TEXTS_SUMMARY.md

@@ -0,0 +1,121 @@
+# Справка по обновленным текстам системы Powerup
+
+## Обзор изменений
+
+Все тексты интерфейса системы powerup переработаны для понятного объяснения работы системы пользователям-кооперативам без технического образования.
+
+## Основные концепции, раскрытые в текстах
+
+### 1. Система квот и ресурсов
+- **1 квота = 5 AXON** на 24 часа
+- Распределение: 50% RAM (~24.4 КБ), 25% CPU, 25% NET
+- Курс конвертации: **1 AXON = 10 RUB**
+- Курс RAM: **1 байт = 0.0001 AXON**
+
+### 2. Пакеты документов
+- Один пакет документов ≈ 10 КБ RAM
+- Одна квота позволяет хранить ~2 пакета документов одновременно
+- **Ключевой момент**: квоту можно использовать многократно в течение 24 часов после освобождения памяти
+- Квота ограничивает **одновременное** использование, а не общее количество операций за сутки
+
+### 3. Регистрация аккаунтов
+- **1 AXON за аккаунт** (единоразовая оплата за постоянное хранение)
+- Дополнительно требуются квоты для обработки регистрационных документов
+
+### 4. Автоматическое управление
+- При использовании >70% любого ресурса → автоматическая аренда квоты за 5 AXON
+- Ежедневное автоматическое пополнение в 00:00 на минимальную квоту (5 AXON)
+- Автоматическое продление аренды при возврате квот, если память используется
+
+### 5. Делегаты
+- Операторы серверов, предоставляющие вычислительные мощности
+- Получают AXON за предоставление ресурсов
+- Могут обменять AXON на RUB через паевой взнос у кооператива-оператора
+
+## Измененные файлы
+
+### 1. ResourceInfoWidget.vue
+**Основной информационный блок**
+- Обновлено краткое описание системы аренды
+- Полностью переработан диалог "Как это работает" с разделами:
+  - Что такое вычислительные ресурсы
+  - Система квот: аренда ресурсов
+  - Пакеты документов
+  - Многократное использование
+  - Возврат и продление аренды
+  - Кто предоставляет ресурсы (делегаты)
+  - Регистрация аккаунтов пайщиков
+  - Автоматическое управление
+
+**Добавлен FAQ с 7 вопросами:**
+1. Из чего складывается стоимость пакета документов?
+2. Сколько пакетов документов я могу обработать за день на одной квоте?
+3. Почему мне списали больше, чем минимальные 5 AXON в день?
+4. Что будет, если у меня закончатся AXON?
+5. Как узнать, сколько AXON мне нужно в месяц?
+6. Могу ли я вернуть неиспользованные AXON?
+
+### 2. CpuResourceWidget.vue
+Обновлена подсказка:
+- Старая: "CPU ресурсы восстанавливаются со временем. Текущее использование показывает нагрузку в данный момент."
+- Новая: "CPU используется для вычислений при обработке документов. Квота восстанавливается автоматически через несколько минут после использования."
+
+### 3. NetResourceWidget.vue
+Обновлена подсказка:
+- Старая: "Сетевые ресурсы восстанавливаются со временем. Показывают объем переданных данных в байтах."
+- Новая: "NET используется для передачи данных документов между узлами блокчейна. Квота восстанавливается автоматически через несколько минут."
+
+### 4. RamResourceWidget.vue
+Обновлена подсказка:
+- Старая: "RAM ресурсы приобретаются и освобождаются. Показывают объем занятой памяти в байтах."
+- Новая: "RAM используется для хранения данных пайщиков и документов в смарт-контрактах. Освобождается после завершения обработки документов."
+
+### 5. AxonWalletCard.vue
+Обновлена подсказка:
+- Старая: "AXON используется для оплаты пакетов документов. Минимально 5 AXON в день, по факту - от использования."
+- Новая: "AXON используется для аренды вычислительных ресурсов (минимум 5 AXON/день) и регистрации пайщиков (1 AXON/аккаунт). Курс: 1 AXON = 10 RUB."
+
+## Примеры расчетов для пользователей
+
+### Минимальный бюджет (1500 RUB / 150 AXON в месяц)
+- 30 дней × 5 AXON = 150 AXON
+- Покрывает только минимальные ежедневные квоты
+- Регистрация пайщиков требует дополнительных AXON
+
+### Средний кооператив (50 пайщиков, умеренная активность)
+- Базовые квоты: ~150 AXON
+- Дополнительные квоты при активности: ~30 AXON
+- Буфер безопасности: ~20 AXON
+- **Итого: ~200 AXON в месяц (2000 RUB)**
+
+### Регистрация пайщиков
+- **Последовательно**: 145 пайщиков за день на одной квоте (если быстро обрабатываются)
+- **Одновременно**: ~6 пайщиков (3 пакета по 2 пайщика) на одной квоте
+- **При массовой регистрации**: планировать дополнительные квоты
+
+## Ключевые сообщения для пользователей
+
+1. **Вы платите за реальное использование**, а не за абстрактные единицы
+2. **Квоты можно использовать многократно** в течение 24 часов
+3. **Стоимость прозрачна и предсказуема**: 1 AXON = 10 RUB
+4. **Система автоматическая**: не требует постоянного контроля
+5. **Делегаты получают справедливую оплату** за поддержку инфраструктуры
+6. **Рекомендуемый буфер**: 50-100 AXON для бесперебойной работы
+
+## Стиль подачи информации
+
+- ✅ Понятные аналогии (аренда вычислительных мощностей)
+- ✅ Конкретные примеры расчетов
+- ✅ Акцент на пакеты документов (знакомая концепция)
+- ✅ Объяснение динамической стоимости
+- ✅ Практические рекомендации
+- ❌ Без технического жаргона
+- ❌ Без лишнего пафоса
+- ❌ Без упрощения технических деталей (мс, КБ оставлены)
+
+## Примечания для дальнейшего развития
+
+1. FAQ будет дополняться на основе реальных вопросов пользователей
+2. Пороги автоматического пополнения сейчас в абсолютных величинах (конфиг), планируется переход на проценты
+3. Все расчеты основаны на текущем курсе: 1 AXON = 10 RUB, 1 байт = 0.0001 AXON
+

components/context/notes/DESKTOP_POWERUP_USER_GUIDE.md

@@ -0,0 +1,240 @@
+# Руководство по системе вычислительных ресурсов COOPOS
+
+## Для кого это руководство
+
+Это руководство предназначено для администраторов кооперативов, которые управляют бюджетом вычислительных ресурсов в системе COOPOS.
+
+---
+
+## Что нужно знать
+
+### 💰 Базовая экономика
+
+**1 AXON = 10 рублей**
+
+Это служебный токен для оплаты вычислительных ресурсов в блокчейне COOPOS.
+
+### 📦 Что такое квота
+
+**1 квота = 5 AXON = 50 рублей**
+
+Квота — это пакет вычислительных ресурсов на 24 часа:
+- 24.4 КБ оперативной памяти (RAM) для хранения данных документов
+- Процессорное время (CPU) для выполнения вычислений
+- Сетевой трафик (NET) для передачи данных
+
+### 📄 Пакеты документов
+
+Каждая операция в системе оформляется пакетом документов:
+- Регистрация пайщика → заявление + протокол совета + решение
+- Собрание → повестка + протокол + бюллетени
+- И так далее...
+
+**Один пакет документов ≈ 10 КБ памяти**
+
+Значит, одна квота позволяет одновременно обрабатывать 2 полных пакета документов.
+
+---
+
+## Как это работает
+
+### 🔄 Многократное использование
+
+**Важно!** Квоту можно использовать многократно в течение 24 часов.
+
+После того как документ обработан и память освободилась, вы можете использовать ту же квоту для следующих документов.
+
+**Пример:**
+- Утром зарегистрировали пайщика (10 КБ памяти)
+- Через час документы обработаны, память освободилась
+- Днём провели собрание (10 КБ памяти) на той же квоте
+- Вечером оформили паевой взнос — снова на той же квоте
+
+### ⏰ Срок действия квоты
+
+Квота арендуется на 24 часа и возвращается в тот же час, когда была получена.
+
+**Что происходит при возврате:**
+- Если память не используется → ресурсы возвращаются в общий пул
+- Если в памяти есть активные данные → система автоматически продлевает аренду при наличии средств
+
+### ⚙️ Автоматическое управление
+
+Система сама следит за ресурсами и арендует квоты, когда нужно:
+
+1. **Ежедневное пополнение** (00:00) → 5 AXON
+2. **При использовании >70%** любого ресурса → дополнительно 5 AXON
+3. **При возврате квот** с активными данными → продление аренды
+
+---
+
+## Что за что платится
+
+### 🆕 Регистрация аккаунта пайщика
+
+**1 AXON за аккаунт (единоразово)**
+
+Это оплата за постоянное хранение базовой информации об аккаунте в блокчейне.
+
+Плюс нужны квоты для обработки регистрационных документов.
+
+### 📋 Обработка документов
+
+**Стоимость зависит от:**
+- Объёма данных (паспорт, адрес, реквизиты)
+- Сложности проверок (подписи, валидация)
+- Времени хранения в памяти
+
+**В среднем:** один пакет документов при хранении весь день ≈ 2.5 AXON (половина квоты)
+
+Но если обработка быстрая (1-2 часа), та же квота используется повторно.
+
+### 🖥️ Кому идут деньги
+
+**90% → Делегатам сети**
+
+Делегаты — это операторы серверов, которые:
+- Инвестируют в оборудование (серверы, память, процессоры)
+- Поддерживают работу блокчейна 24/7
+- Предоставляют вычислительные мощности
+
+Полученные AXON делегаты могут обменять на рубли через кооператив-оператор.
+
+**10% → Системный фонд**
+
+Для покрытия операционных расходов и последующего распределения среди пайщиков.
+
+---
+
+## Сколько нужно AXON в месяц
+
+### Минимальный кооператив (без активности)
+
+**150 AXON = 1500 рублей**
+
+- 30 дней × 5 AXON = 150 AXON
+- Только минимальные ежедневные квоты
+- Без регистрации новых пайщиков
+
+### Средний кооператив (50 пайщиков, умеренная активность)
+
+**200 AXON = 2000 рублей**
+
+- Базовые квоты: 150 AXON
+- Дополнительные квоты при активности: 30 AXON
+- Буфер безопасности: 20 AXON
+
+### Активный кооператив (100+ пайщиков, регулярные собрания)
+
+**300-400 AXON = 3000-4000 рублей**
+
+- Базовые квоты: 150 AXON
+- Частые операции: 100-150 AXON
+- Регистрация новых пайщиков: 50-100 AXON
+
+---
+
+## Примеры расчётов
+
+### Регистрация 10 пайщиков за день
+
+**Последовательно (по одному):**
+- 10 × 1 AXON = 10 AXON (оплата аккаунтов)
+- 1 квота = 5 AXON (если быстро обрабатывается)
+- **Итого: 15 AXON**
+
+**Одновременно (пакетами по 3):**
+- 10 × 1 AXON = 10 AXON (оплата аккаунтов)
+- 2 квоты × 5 AXON = 10 AXON (для параллельной обработки)
+- **Итого: 20 AXON**
+
+### Проведение общего собрания (50 участников)
+
+- 1 квота (5 AXON) для подготовки повестки
+- 1-2 квоты (5-10 AXON) для обработки бюллетеней
+- 1 квота (5 AXON) для протокола
+- **Итого: 15-20 AXON**
+
+### Месяц стандартной работы
+
+- Минимальные ежедневные квоты: 150 AXON
+- 2 собрания: 40 AXON
+- 5 новых пайщиков: 10 AXON
+- Текущие операции: 20 AXON
+- **Итого: 220 AXON (2200 рублей)**
+
+---
+
+## Важные рекомендации
+
+### ✅ Что делать
+
+1. **Поддерживайте буфер 50-100 AXON** для бесперебойной работы
+2. **Регулярно проверяйте баланс** через панель мониторинга
+3. **Планируйте массовые операции** заранее (регистрация пайщиков, собрания)
+4. **Отслеживайте фактическое потребление** в логах расширения powerup
+
+### ❌ Чего не делать
+
+1. **Не допускайте нулевой баланс AXON** — это заблокирует все операции
+2. **Не паникуйте при дополнительных списаниях** — проверьте логи, это нормально при активной работе
+3. **Не покупайте AXON "впрок"** больше, чем нужно — планируйте на месяц
+
+---
+
+## Где пополнить AXON
+
+Пополнение баланса AXON происходит через личный кабинет кооператива-оператора:
+
+**https://лк.цифровой-кооператив.рф**
+
+Курс обмена: **1 AXON = 10 RUB**
+
+---
+
+## Часто задаваемые вопросы
+
+### Почему списалось больше, чем 5 AXON в день?
+
+Дополнительные списания происходят при:
+- Автоматическом пополнении (когда использование ресурсов >70%)
+- Регистрации новых аккаунтов (1 AXON за аккаунт)
+
+### Что будет, если закончатся AXON?
+
+- ❌ Система не сможет автоматически пополнить квоты
+- ❌ Когда текущая квота исчерпается, все операции заблокируются
+- ❌ Пайщики не смогут подавать заявления
+- ❌ Невозможно зарегистрировать новых пайщиков
+
+**Критично:** следите за балансом!
+
+### Можно ли вернуть неиспользованные AXON?
+
+Нет. AXON идут делегатам в качестве оплаты за предоставленные вычислительные мощности.
+
+Однако неиспользованные ресурсы в рамках квоты можно использовать повторно в течение 24 часов.
+
+### Сколько документов можно обработать на одной квоте?
+
+**Одновременно:** 2 полных пакета документов (~10 КБ каждый)
+
+**Последовательно за сутки:** от 24 до 48 пакетов (если обработка занимает 1-2 часа)
+
+### Как оптимизировать расходы?
+
+1. Планируйте регистрацию пайщиков последовательно, а не массово
+2. Проводите собрания в удобное время, когда ресурсов достаточно
+3. Отслеживайте пики потребления и корректируйте активность
+4. Используйте систему в рабочие часы для максимальной эффективности
+
+---
+
+## Техническая поддержка
+
+Если у вас возникли вопросы по работе системы вычислительных ресурсов, обращайтесь в техническую поддержку кооператива-оператора.
+
+---
+
+**Последнее обновление:** 21 ноября 2024
+

components/context/notes/DOCUMENT_SYSTEM_ARCHITECTURE.md

@@ -0,0 +1,375 @@
+# Архитектура Системы Документов
+
+## Общее описание
+
+Система документов кооператива построена на гибридной архитектуре, объединяющей блокчейн (распределённый реестр) и приватную базу данных MongoDB. Блокчейн хранит неизменяемые записи о подписанных документах с анонимизированными данными, а MongoDB содержит приватные данные для деанонимизации и полные тексты документов.
+
+## Источники данных
+
+### Блокчейн (Simple Explorer API)
+
+Блокчейн хранит действия (actions) смарт-контракта `soviet`, которые фиксируют факты работы с документами:
+
+| Действие | Описание |
+|----------|----------|
+| `newsubmitted` | Входящий пакет документов, ожидающий утверждения |
+| `newresolved` | Утверждённый пакет документов после завершения бизнес-логики |
+| `newdecision` | Протокол решения совета кооператива |
+| `newact` | Акт (например, акт приёма-передачи) |
+| `newagreement` | Связанное соглашение |
+| `newlink` | Связанный документ |
+
+#### Структура блокчейн-действия
+
+```typescript
+interface IAction {
+  block_num: number;
+  transaction_id: string;
+  account: string;           // 'soviet'
+  name: string;              // 'newsubmitted' | 'newresolved' | ...
+  receiver: string;          // имя кооператива
+  data: {
+    coopname: string;        // имя кооператива
+    username: string;        // имя пользователя
+    action: string;          // тип действия ('regcoop', 'joincoop', ...)
+    package: string;         // идентификатор пакета документов (SHA-256)
+    document: {
+      version: string;       // версия формата документа
+      hash: string;          // общий хеш
+      doc_hash: string;      // хеш содержимого документа
+      meta_hash: string;     // хеш метаданных
+      meta: string;          // JSON-строка метаданных
+      signatures: ISignature[];
+    }
+  }
+}
+```
+
+### MongoDB (Приватная база данных)
+
+MongoDB хранит:
+- Полные тексты документов (PDF, HTML)
+- Приватные данные пользователей (ФИО, паспортные данные, адреса)
+- Данные организаций и ИП
+
+Документы извлекаются по `doc_hash` из блокчейн-записи.
+
+## Жизненный цикл документа
+
+### 1. Подача заявления (newsubmitted)
+
+Когда пользователь подаёт заявление (регистрация в кооперативе, взнос, и т.д.):
+
+1. Документ генерируется и сохраняется в MongoDB
+2. Хеш документа и подпись фиксируются в блокчейне через действие `newsubmitted`
+3. Документ получает уникальный `package` идентификатор
+
+### 2. Принятие решения (newresolved)
+
+После прохождения бизнес-логики (решение совета, подписание актов):
+
+1. Действие `newresolved` фиксируется в блокчейне с тем же `package`
+2. Связанные действия (`newdecision`, `newact`) ссылаются на этот `package`
+3. Пакет документов считается полностью завершённым
+
+## Архитектура агрегации
+
+### Слои архитектуры
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    Application Layer                            │
+│  ┌──────────────────────┐  ┌─────────────────────────────────┐  │
+│  │  DocumentResolver    │  │  GetDocumentsInputDTO           │  │
+│  │  (GraphQL)           │  │  - username, filter, type       │  │
+│  └──────────────────────┘  │  - after_block, before_block    │  │
+│            │               │  - actions (фильтр по действиям)│  │
+│            ▼               └─────────────────────────────────┘  │
+│  ┌──────────────────────┐                                       │
+│  │  DocumentService     │                                       │
+│  └──────────────────────┘                                       │
+└─────────────────────────────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                    Domain Layer                                  │
+│  ┌──────────────────────┐                                       │
+│  │DocumentDomainInteract│ ◄── GetDocumentsInputDomainInterface  │
+│  └──────────────────────┘                                       │
+│            │                                                     │
+│            ▼                                                     │
+│  ┌──────────────────────┐  ┌─────────────────────────────────┐  │
+│  │DocumentDomainService │  │  DocumentPackageAggregator      │  │
+│  │                      │  │  ├── DocumentPackageV0Aggregator│  │
+│  │  - generateDocument  │  │  └── DocumentPackageV1Aggregator│  │
+│  │  - getImmutableSigned│  └─────────────────────────────────┘  │
+│  └──────────────────────┘                                       │
+│            │                         │                           │
+│            ▼                         ▼                           │
+│  ┌──────────────────────┐  ┌─────────────────────────────────┐  │
+│  │  Simple Explorer API │  │  DocumentAggregator             │  │
+│  │  (Блокчейн данные)   │  │  (Сборка агрегата документа)    │  │
+│  └──────────────────────┘  └─────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                 Infrastructure Layer                             │
+│  ┌──────────────────────┐  ┌─────────────────────────────────┐  │
+│  │  DocumentRepository  │  │  GeneratorInfrastructureService │  │
+│  │  (MongoDB)           │  │  (Генерация PDF)                │  │
+│  └──────────────────────┘  └─────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### Агрегат пакета документов (DocumentPackageAggregate)
+
+Пакет документов агрегирует все связанные документы:
+
+```typescript
+interface DocumentPackageAggregateDomainInterface {
+  statement: StatementDetailAggregateDomainInterface | null;  // Заявление
+  decision: DecisionDetailAggregateDomainInterface | null;    // Решение совета
+  acts: ActDetailAggregateDomainInterface[];                  // Акты
+  links: DocumentAggregateDomainInterface[];                  // Связанные документы
+}
+```
+
+### Детали заявления (StatementDetail)
+
+```typescript
+interface StatementDetailAggregateDomainInterface {
+  action: ExtendedBlockchainActionDomainInterface;  // Блокчейн-действие
+  documentAggregate: DocumentAggregateDomainInterface;  // Агрегат документа
+}
+```
+
+### Агрегат документа (DocumentAggregate)
+
+```typescript
+interface DocumentAggregateDomainInterface {
+  hash: string;
+  signedDocument: ExtendedSignedDocumentDomainInterface;  // Подписанный документ
+  fullDocument: DocumentDomainEntity;  // Полный документ из MongoDB
+}
+```
+
+## Процесс агрегации
+
+### 1. Запрос документов
+
+```typescript
+// GraphQL Query
+query {
+  getDocuments(data: {
+    username: "cooperative1"
+    type: "newsubmitted"
+    actions: ["regcoop", "joincoop"]
+    after_block: 100
+    before_block: 500
+  }) {
+    items { ... }
+    totalCount
+  }
+}
+```
+
+### 2. Формирование фильтра
+
+```typescript
+// DocumentDomainInteractor
+const blockFilters = {
+  receiver: username,
+  block_num: { $gte: after_block, $lte: before_block },
+  'data.action': { $in: actions }  // Фильтр по типам действий
+};
+```
+
+### 3. Запрос к блокчейну
+
+```typescript
+// getActions -> Simple Explorer API
+GET /get-actions?filter={
+  "account": "soviet",
+  "name": "newsubmitted",
+  "receiver": "cooperative1",
+  "data.action": { "$in": ["regcoop", "joincoop"] },
+  "block_num": { "$gte": 100, "$lte": 500 }
+}
+```
+
+### 4. Агрегация данных
+
+Для каждого блокчейн-действия:
+
+1. **Определение версии документа** (v0 или v1+)
+2. **Получение заявления (Statement)**:
+   - Извлечение документа из MongoDB по `doc_hash`
+   - Получение данных подписанта из приватной базы
+   - Создание сертификата пользователя
+3. **Получение решения (Decision)**:
+   - Поиск `newdecision` по `package`
+   - Извлечение документа решения
+4. **Получение актов (Acts)**:
+   - Поиск всех `newact` по `package`
+   - Извлечение документов актов
+5. **Получение связанных документов (Links)**:
+   - Поиск `newlink` и `newagreement`
+   - Обработка ссылок в метаданных документов
+
+## Типы действий (data.action)
+
+Типы действий определены в enum `DocumentAction`:
+
+```typescript
+export enum DocumentAction {
+  REGCOOP = 'regcoop',      // Регистрация кооператива
+  JOINCOOP = 'joincoop',    // Вступление в кооператив
+  CONTRIBUTE = 'contribute', // Взнос в кооператив
+  WITHDRAW = 'withdraw',    // Выход из кооператива
+  // Другие действия могут быть добавлены по мере необходимости
+}
+```
+
+| Действие | Описание |
+|----------|----------|
+| `REGCOOP` | Регистрация кооператива |
+| `JOINCOOP` | Вступление в кооператив |
+| `CONTRIBUTE` | Взнос в кооператив |
+| `WITHDRAW` | Выход из кооператива |
+
+## Версионирование документов
+
+### Версия 0 (Legacy)
+
+Старый формат без поля `version` в документе. Обрабатывается `DocumentPackageV0Aggregator`.
+
+### Версия 1+
+
+Новый формат с явным полем `version`. Обрабатывается `DocumentPackageV1Aggregator`.
+
+```typescript
+// Определение версии
+const docVersion = rawAction.data?.document?.version ?? '0';
+```
+
+## Хеширование и подписи
+
+### Типы хешей
+
+| Хеш | Описание |
+|-----|----------|
+| `hash` | Общий хеш документа |
+| `doc_hash` | Хеш содержимого документа (используется для извлечения из MongoDB) |
+| `meta_hash` | Хеш метаданных |
+
+### Структура подписи
+
+```typescript
+interface ISignature {
+  id: number;
+  signed_hash: string;
+  signer: string;          // username подписанта
+  public_key: string;
+  signature: string;
+  signed_at: string;
+  meta: string;
+}
+```
+
+## Фильтрация и пагинация
+
+### Доступные фильтры
+
+| Параметр | Тип | Описание |
+|----------|-----|----------|
+| `type` | `'newsubmitted' \| 'newresolved'` | Тип действия (входящие/утверждённые) |
+| `username` | `string` | Имя пользователя (receiver) |
+| `filter` | `Record<string, unknown>` | Произвольный MongoDB-фильтр |
+| `actions` | `DocumentAction[]` | Массив типов действий для фильтрации |
+| `after_block` | `number` | Блок начала диапазона |
+| `before_block` | `number` | Блок конца диапазона |
+| `page` | `number` | Номер страницы |
+| `limit` | `number` | Количество записей на странице |
+
+### Пример использования фильтра actions
+
+```typescript
+import { DocumentAction } from '~/domain/document/enums/document-action.enum';
+
+// В коде:
+const actions = [DocumentAction.REGCOOP, DocumentAction.JOINCOOP];
+```
+
+```graphql
+query {
+  getDocuments(data: {
+    username: "cooperative1"
+    type: "newsubmitted"
+    actions: ["regcoop"]  # Только документы регистрации кооператива
+    filter: {}
+  }) {
+    items {
+      statement {
+        action {
+          name
+          data
+        }
+        documentAggregate {
+          hash
+        }
+      }
+    }
+    totalCount
+  }
+}
+```
+
+## Деанонимизация данных
+
+Процесс деанонимизации происходит на этапе агрегации:
+
+1. **Извлечение username** из блокчейн-действия
+2. **Запрос приватных данных** из MongoDB через `AccountDomainService`
+3. **Создание сертификата** пользователя через `UserCertificateDomainService`
+4. **Прикрепление сертификата** к `ExtendedBlockchainActionDomainInterface`
+
+```typescript
+const account = await this.accountDomainService.getPrivateAccount(rawData.username);
+const actor_certificate = this.userCertificateService.createCertificateFromUserData(account);
+```
+
+## Связанные файлы
+
+### Application Layer
+- `src/application/document/dto/get-documents-input.dto.ts`
+- `src/application/document/services/document.service.ts`
+- `src/application/document/resolvers/document.resolver.ts`
+
+### Domain Layer
+- `src/domain/document/interactors/document.interactor.ts`
+- `src/domain/document/services/document-domain.service.ts`
+- `src/domain/document/aggregators/document-package.aggregator.ts`
+- `src/domain/document/aggregators/document-package-v1.aggregator.ts`
+- `src/domain/document/aggregators/document.aggregator.ts`
+
+### Enums
+- `src/domain/document/enums/document-action.enum.ts`
+
+### Interfaces
+- `src/domain/document/interfaces/document-package-aggregate-domain.interface.ts`
+- `src/domain/document/interfaces/statement-detail-aggregate-domain.interface.ts`
+- `src/domain/document/interfaces/decision-detail-aggregate-domain.interface.ts`
+- `src/domain/document/interfaces/get-documents-input-domain.interface.ts`
+
+## Известные особенности и TODO
+
+1. **Путаница hash/doc_hash**: В некоторых местах используется `hash`, в других `doc_hash`. Требуется унификация.
+
+2. **Версионирование агрегаторов**: Существуют V0 и V1 агрегаторы. V0 — legacy, требует миграции.
+
+3. **Производительность**: Агрегация делает множество последовательных запросов к API и MongoDB. Возможна оптимизация через batch-запросы.
+
+4. **Валидация подписей**: Подписи валидируются через `Classes.Document.validateSignature()`, но результат не всегда используется для бизнес-логики.
+
+5. **Миграция в PostgresQL**: предстоит миграция из MongoDB в postgres.

components/context/notes/EXTENSIONS_MIGRATION_GUIDE.md

@@ -0,0 +1,128 @@
+# Руководство по миграциям схем расширений
+
+## Обзор
+
+Система миграций расширений позволяет автоматически обновлять конфигурации расширений при изменении их схем. Миграции применяются на основе версий, хранимых в базе данных. Система миграции расширений является отдельной и независимой от основной системы миграций всего приложения.
+
+## Архитектура
+
+### Основные компоненты:
+- `ExtensionSchemaMigrationService` - сервис управления миграциями
+- `schema_version` - поле в таблице `extensions` для отслеживания версии схемы
+- Миграции в папке `src/extensions/[extension]/migrations/`
+
+### Процесс миграции:
+1. При запуске расширения проверяется текущая версия в БД
+2. Применяются все миграции с версией выше текущей
+3. Обновляется версия и конфигурация в БД
+
+## Создание миграции
+
+### 1. Создайте файл миграции
+```typescript
+// src/extensions/[extension]/migrations/[extension]-schema-v[N].migration.ts
+import { IExtensionSchemaMigration } from '~/domain/extension/services/extension-schema-migration.service';
+
+export const [extension]SchemaV[N]Migration: IExtensionSchemaMigration<
+  IOldConfig,
+  INewConfig
+> = {
+  extensionName: '[extension]',
+  version: N,
+
+  migrate(oldConfig: IOldConfig, defaultConfig: INewConfig): INewConfig {
+    // Логика преобразования старой конфигурации в новую
+    return { ...defaultConfig, ...transformedConfig };
+  },
+};
+```
+
+### 2. Зарегистрируйте миграцию
+```typescript
+// src/domain/extension/extension-domain.module.ts
+import { [extension]SchemaV[N]Migration } from '~/extensions/[extension]/migrations/[extension]-schema-v[N].migration';
+
+async onModuleInit() {
+  this.migrationService.registerMigration([extension]SchemaV[N]Migration);
+  // ...
+}
+```
+
+### 3. Обновите defaultConfig
+Убедитесь, что `defaultConfig` в плагине соответствует новой схеме.
+
+### 4. Добавьте pluginClass в реестр
+```typescript
+// src/extensions/extensions.registry.ts
+[extension]: {
+  // ...
+  pluginClass: [Extension]Plugin,
+  // ...
+}
+```
+
+## Логи миграций
+
+### Успешная миграция:
+```
+Миграция powerup: v1 → v2
+Конфигурация до: {...}
+Конфигурация после: {...}
+Миграция powerup завершена: v1 → v2
+```
+
+### Нет миграций:
+Расширение работает с текущей версией без логов.
+
+## Примеры
+
+### Пример 1: Удаление поля
+```typescript
+migrate(oldConfig: any, defaultConfig: any) {
+  const { removedField, ...rest } = oldConfig;
+  return { ...defaultConfig, ...rest };
+}
+```
+
+### Пример 2: Переименование поля
+```typescript
+migrate(oldConfig: any, defaultConfig: any) {
+  return {
+    ...defaultConfig,
+    ...oldConfig,
+    newFieldName: oldConfig.oldFieldName,
+    oldFieldName: undefined, // удаляем старое поле
+  };
+}
+```
+
+### Пример 3: Преобразование значений
+```typescript
+migrate(oldConfig: any, defaultConfig: any) {
+  return {
+    ...defaultConfig,
+    ...oldConfig,
+    thresholds: oldConfig.absoluteValues ?
+      { cpu: 70, net: 70, ram: 70 } : // дефолтные проценты
+      oldConfig.thresholds
+  };
+}
+```
+
+## Запуск миграций
+
+Миграции запускаются автоматически при старте приложения для каждого включенного расширения. Ручной запуск не требуется.
+
+## Отладка
+
+Если миграция не применяется:
+1. Проверьте логи запуска приложения
+2. Убедитесь, что расширение включено (`enabled: true`)
+3. Проверьте наличие `pluginClass` в реестре
+4. Проверьте корректность `defaultConfig` в плагине
+
+## Безопасность
+
+- Миграции применяются только вперед (от низшей версии к высшей)
+- Исходная конфигурация сохраняется до успешного применения миграции
+- При ошибке в миграции расширение не запускается

components/context/notes/EXTENSIONS_SCHEMA_SYSTEM.md

@@ -0,0 +1,361 @@
+# Система генерации форм из Zod-схем для расширений
+
+## Обзор
+
+Система автоматически генерирует формы настроек для расширений на основе Zod-схем. Это позволяет разработчикам описывать конфигурацию расширения декларативно, а интерфейс автоматически создает соответствующие поля ввода.
+
+## Архитектура потока данных
+
+### 1. Определение схемы (Backend - Controller)
+
+Разработчик расширения определяет Zod-схему в модуле расширения:
+
+```typescript
+// src/extensions/powerup/powerup-extension.module.ts
+export const Schema = z.object({
+  dailyPackageSize: z
+    .number()
+    .default(5)
+    .describe(
+      describeField({
+        label: 'Сумма автоматической ежедневной аренды',
+        note: 'Пополняет автоматически каждый день',
+        rules: ['val >= 5'],
+        prepend: 'AXON',
+      })
+    ),
+  thresholds: z.object({
+    cpu: z.number().default(5000).describe(...),
+    // ...
+  }).describe(
+    describeField({
+      label: 'Минимальные пороги ресурсов',
+      note: 'Настройки для автоматического пополнения',
+    })
+  ),
+});
+```
+
+**Ключевые моменты:**
+- Функция `describeField()` сериализует объект `DeserializedDescriptionOfExtension` в JSON-строку
+- Эта строка передается в метод `.describe()` Zod-схемы
+- Библиотека `zod-to-json-schema` автоматически сохраняет поле `description` в JSON Schema
+
+### 2. Сериализация описания
+
+```typescript
+// src/extensions/powerup/powerup-extension.module.ts
+function describeField(description: DeserializedDescriptionOfExtension): string {
+  return JSON.stringify(description);
+}
+```
+
+**Тип `DeserializedDescriptionOfExtension`:**
+- Определен в `src/types/shared/extension.types.ts`
+- Содержит метаданные для отображения поля: `label`, `note`, `visible`, `rules`, `mask`, и т.д.
+- Копируется в SDK через скрипт `generate-client` в `package.json`
+
+### 3. Преобразование Zod → JSON Schema
+
+```typescript
+// src/domain/extension/services/extension-listing-domain.service.ts
+import zodToJsonSchema from 'zod-to-json-schema';
+
+private async extractRegistryData(): Promise<Record<string, IRegistryExtension>> {
+  const map: Record<string, IRegistryExtension> = {};
+
+  for (const [key, ext] of Object.entries(AppRegistry)) {
+    const { schema, ...rest } = ext;
+    map[key] = {
+      ...rest,
+      schema: zodToJsonSchema(schema), // Zod → JSON Schema
+    };
+  }
+
+  return map;
+}
+```
+
+**Что происходит:**
+- `zodToJsonSchema` преобразует Zod-схему в стандартный JSON Schema
+- Поле `description` из Zod сохраняется как строка в JSON Schema
+- Результат попадает в GraphQL через `ExtensionDTO`
+
+### 4. Передача через GraphQL
+
+```typescript
+// src/application/appstore/dto/extension-graphql.dto.ts
+@ObjectType('Extension')
+export class ExtensionDTO<TConfig = any> {
+  @Field(() => GraphQLJSON, { nullable: true })
+  schema: any; // JSON Schema с сериализованными description
+}
+```
+
+**GraphQL схема:**
+```graphql
+type Extension {
+  schema: JSON  # JSON Schema с description как JSON-строки
+}
+```
+
+### 5. Десериализация на фронтенде
+
+```typescript
+// desktop/src/entities/Extension/model/store.ts
+const parseDescriptionsRecursively = (obj: any): any => {
+  if (typeof obj !== 'object' || obj === null) {
+    return obj;
+  }
+
+  return Object.fromEntries(
+    Object.entries(obj).map(([key, value]) => {
+      if (key === 'description' && typeof value === 'string') {
+        try {
+          return [key, JSON.parse(value)]; // Десериализация JSON-строки
+        } catch (error) {
+          return [key, value];
+        }
+      } else if (typeof value === 'object') {
+        return [key, parseDescriptionsRecursively(value)]; // Рекурсивная обработка
+      } else {
+        return [key, value];
+      }
+    })
+  );
+};
+```
+
+**Что происходит:**
+- При загрузке расширений из GraphQL, все поля `description` (которые являются JSON-строками) парсятся обратно в объекты
+- Рекурсивная обработка позволяет десериализовать вложенные объекты
+
+### 6. Рендеринг формы
+
+```vue
+<!-- desktop/src/shared/ui/ZodForm/ZodForm.vue -->
+<template>
+  <div class="settings-form">
+    <div
+      v-for="item in visibleProperties"
+      :key="item.propertyName"
+      class="setting-item"
+    >
+      <div class="setting-header">
+        <div class="setting-title">
+          {{ getLabel(item.property, item.propertyName) }}
+        </div>
+        <div class="setting-hint" v-if="getHint(item.property)">
+          {{ getHint(item.property) }}
+        </div>
+      </div>
+
+      <component
+        :is="getComponentType(item.property)"
+        v-bind="getComponentProps(item.property, item.propertyName)"
+      />
+    </div>
+  </div>
+</template>
+```
+
+**Логика компонента:**
+- `getLabel()` извлекает `label` из `property.description` или использует имя свойства
+- `getHint()` извлекает `note` из `property.description`
+- Для объектов типа `object` используется рекурсивный вызов `DynamicForm` (самого себя)
+- Тип компонента определяется по типу свойства: `string` → `QInput`, `number` → `QInput`, `boolean` → `QCheckbox`, `object` → `DynamicForm`
+
+## Типы данных
+
+### Backend (Controller)
+
+```typescript
+// src/types/shared/extension.types.ts
+export interface DeserializedDescriptionOfExtension {
+  label: string;           // Название поля (обязательное)
+  note?: string;           // Подсказка/описание
+  visible?: boolean;       // Видимость (по умолчанию true)
+  rules?: string[];        // Правила валидации ['val >= 5']
+  mask?: string;           // Маска ввода
+  fillMask?: boolean;      // Автозаполнение маски
+  minLength?: number;      // Минимальная длина
+  maxLength?: number;      // Максимальная длина
+  maxRows?: number;        // Количество строк для textarea
+  append?: string;         // Текст после значения
+  prepend?: string;        // Текст перед значением
+}
+```
+
+### Frontend (Desktop)
+
+```typescript
+// desktop/src/entities/Extension/model/types.ts
+export type ISchemaProperty = {
+  type?: ISchemaType;
+  description?: Types.Controller.DeserializedDescriptionOfExtension;
+  default?: any;
+  properties?: ISchemaProperty;  // Для вложенных объектов
+  // ...
+};
+```
+
+**Связь типов:**
+- Типы из `controller/src/types/shared/` копируются в SDK через скрипт `generate-client`
+- Frontend использует типы из SDK: `Types.Controller.DeserializedDescriptionOfExtension`
+
+## Поддержка вложенных объектов
+
+### Проблема
+
+Для вложенных объектов (например, `thresholds: { cpu, net, ram }`) не было возможности задать заголовок и описание группы полей.
+
+### Решение
+
+1. **Добавление описания для объекта в Zod-схеме:**
+
+```typescript
+thresholds: z.object({
+  cpu: z.number().default(5000).describe(...),
+  net: z.number().default(1024).describe(...),
+  ram: z.number().default(10240).describe(...),
+}).describe(
+  describeField({
+    label: 'Минимальные пороги ресурсов',
+    note: 'Настройки для автоматического пополнения при достижении порогов',
+  })
+)
+```
+
+2. **Обновление ZodForm для отображения описания объектов:**
+
+Компонент `ZodForm` уже поддерживает `description` для объектов через функции `getLabel()` и `getHint()`, которые используются в шаблоне для отображения заголовка и подсказки группы.
+
+## Примеры использования
+
+### Простое поле
+
+```typescript
+dailyPackageSize: z
+  .number()
+  .default(5)
+  .describe(
+    describeField({
+      label: 'Ежедневная сумма',
+      note: 'Автоматическое пополнение каждый день',
+      rules: ['val >= 5'],
+      prepend: 'AXON',
+    })
+  )
+```
+
+### Скрытое поле
+
+```typescript
+lastDailyReplenishmentDate: z
+  .string()
+  .default('')
+  .describe(
+    describeField({
+      label: 'Дата последнего пополнения',
+      visible: false,  // Поле скрыто в форме
+    })
+  )
+```
+
+### Вложенный объект
+
+```typescript
+thresholds: z.object({
+  cpu: z.number().default(5000).describe(...),
+  net: z.number().default(1024).describe(...),
+  ram: z.number().default(10240).describe(...),
+}).describe(
+  describeField({
+    label: 'Пороги ресурсов',
+    note: 'Минимальные значения для автоматического пополнения',
+  })
+)
+```
+
+### Поле с валидацией
+
+```typescript
+topUpAmount: z
+  .number()
+  .default(5)
+  .describe(
+    describeField({
+      label: 'Сумма экстренного пополнения',
+      rules: ['val > 0'],  // Валидация на фронтенде
+      prepend: 'AXON',
+    })
+  )
+```
+
+## Поток данных (схема)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 1. Backend: Определение Zod-схемы                             │
+│    Schema = z.object({...}).describe(describeField({...}))   │
+└──────────────────────┬──────────────────────────────────────┘
+                       │
+                       ▼
+┌─────────────────────────────────────────────────────────────┐
+│ 2. Backend: Сериализация description                         │
+│    describeField() → JSON.stringify()                        │
+└──────────────────────┬──────────────────────────────────────┘
+                       │
+                       ▼
+┌─────────────────────────────────────────────────────────────┐
+│ 3. Backend: Zod → JSON Schema                                │
+│    zodToJsonSchema(schema)                                   │
+│    description сохраняется как JSON-строка                   │
+└──────────────────────┬──────────────────────────────────────┘
+                       │
+                       ▼
+┌─────────────────────────────────────────────────────────────┐
+│ 4. GraphQL: Передача через API                               │
+│    ExtensionDTO.schema (JSON Schema)                         │
+└──────────────────────┬──────────────────────────────────────┘
+                       │
+                       ▼
+┌─────────────────────────────────────────────────────────────┐
+│ 5. Frontend: Десериализация                                  │
+│    parseDescriptionsRecursively()                            │
+│    JSON.parse(description) → объект                          │
+└──────────────────────┬──────────────────────────────────────┘
+                       │
+                       ▼
+┌─────────────────────────────────────────────────────────────┐
+│ 6. Frontend: Рендеринг формы                                 │
+│    ZodForm.vue использует description.label и description.note│
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Важные замечания
+
+1. **Типизация:** Zod-схема автоматически создает тип TypeScript через `z.infer<typeof Schema>`, но этот тип не передается на фронтенд. На фронтенде используется JSON Schema, который не имеет строгой типизации.
+
+2. **Валидация:** Правила валидации (`rules`) выполняются на фронтенде через динамическое создание функций из строковых выражений. Backend валидация происходит через `schema.safeParse()`.
+
+3. **Рекурсивность:** Система поддерживает вложенные объекты любой глубины через рекурсивный вызов `DynamicForm` и рекурсивную десериализацию `parseDescriptionsRecursively`.
+
+4. **Совместимость:** JSON Schema является стандартом, что позволяет использовать схему в других системах или инструментах.
+
+## Связанные файлы
+
+- **Backend:**
+  - `src/extensions/*/powerup-extension.module.ts` - определение схем
+  - `src/types/shared/extension.types.ts` - тип описания
+  - `src/domain/extension/services/extension-listing-domain.service.ts` - преобразование Zod → JSON Schema
+  - `src/application/appstore/dto/extension-graphql.dto.ts` - GraphQL DTO
+
+- **Frontend:**
+  - `desktop/src/shared/ui/ZodForm/ZodForm.vue` - компонент формы
+  - `desktop/src/entities/Extension/model/store.ts` - десериализация
+  - `desktop/src/entities/Extension/model/types.ts` - типы схемы
+
+- **SDK:**
+  - `sdk/src/types/controller/extension.types.ts` - копия типов из controller
+