docs(factory): зафиксировать паттерн параллелизации resolveParallel в CLAUDE.md

Конвенция для Actions/*: независимые от data чтения — в resolveParallel, зависимые (getMeta/getDecision/getMeetQuestions) — после батча; ловушка TDZ; системный шрифт вместо base64. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
fix(factory): arial.ttf как binary — controller/.gitattributes нормализовал EOL
2026-06-05 19:01:46 +00:00 · 2026-06-05 18:45:23 +00:00 · 2026-06-05 18:43:04 +00:00 · 2026-06-05 17:15:50 +00:00 · 2026-06-05 15:10:11 +00:00 · 2026-06-05 15:06:47 +00:00
785 changed files with 31731 additions and 30954 deletions
@@ -5,8 +5,12 @@ name: Release
 # Порядок (через jobs.needs):
 #   1) release             — контракты + контейнеры + webhook деплоя (атомарно)
 #   2) publish-packages    — npm publish через lerna (если не -alpha)
-#   3) publish-docs        — mkdocs + standards-site → gh-pages (если не -alpha + ветка main)
-#   4) trigger-coopenomics — repository_dispatch в coopenomics/coopenomics (тот же гейт, что docs)
+#   3) trigger-coopenomics — workflow_dispatch сборки сайта C9S/coopenomics на
+#                            Gitea (если не -alpha + ветка main); он сам тянет
+#                            mono и пересобирает доки.
+#
+# publish-docs (gh-pages на github.com) удалён 2026-05-25 — после переезда на
+# Gitea Pages-публикация невалидна; доки деплоятся через C9S/coopenomics.
 #
 # Зачем последовательно: пакеты/доки/внешний триггер не должны уезжать,
 # если релиз контрактов или контейнеров провалился. Раньше четыре workflow'а
@@ -34,16 +38,7 @@ permissions:
  contents: write

 jobs:
-  # Гейт TS-типов перед сборкой образов. Reusable workflow `typecheck.yaml`
-  # запускает vue-tsc на desktop и tsc --noEmit на controller. Нужно потому,
-  # что `lerna run build` в корневом Dockerfile НЕ ловит TS-ошибки:
-  # quasar build идёт через esbuild с выключенным vueTsc, а у controller'а
-  # build-скрипта вообще нет (ts-node в рантайме).
-  typecheck:
-    uses: ./.github/workflows/typecheck.yaml
-
  release:
-    needs: typecheck
    runs-on: ubuntu-latest
    outputs:
      tag_name: ${{ steps.resolve.outputs.tag_name }}
@@ -127,14 +122,41 @@ jobs:
          password: ${{ secrets.DOCKERHUB_TOKEN }}

      # === Этап 1: контракты ===
+      # CDT ставим из .deb (C9S/cdt v4.2.0) прямо в окружение job'а и
+      # компилируем напрямую — БЕЗ вложенного docker. Почему не build-all.sh:
+      # тот монтирует $(pwd):/project в sibling-контейнер, а под Gitea
+      # act_runner сам job исполняется в контейнере → хостовый демон не видит
+      # этот путь, /project пуст, cmake падает "no CMakeLists.txt".
+      # build-all.sh остаётся для локальной сборки (оборачивает тот же
+      # build_contracts_cdt.sh в docker).
+      # CMakeLists хардкодит toolchain /cdt/build/...; .deb кладёт CDT в
+      # /usr/opt/cdt/4.2.0, а сам CDTWasmToolchain.cmake указывает на /usr
+      # абсолютно — поэтому симлинк /cdt/build → /usr/opt/cdt/4.2.0 сводит пути
+      # без правки CMakeLists.

-      - name: Pull CDT toolchain image
-        run: docker pull dicoop/blockchain_v5.1.1:dev
+      - name: Install CDT 4.2.0 toolchain (.deb)
+        run: |
+          SUDO=""; [ "$(id -u)" -ne 0 ] && SUDO="sudo"
+          $SUDO apt-get update
+          # build-essential — для host-компилятора (project() в CMakeLists);
+          # libz3-4/libtinfo6/libxml2/zlib1g — рантайм бинарей CDT (clang-9,
+          # ld.lld и т.д.). Пакет cdt объявляет только libcurl4-gnutls-dev,
+          # поэтому остальные .so ставим явно — в образе dicoop/blockchain они
+          # были из сборки исходников, из .deb не тянутся.
+          $SUDO apt-get install -y --no-install-recommends \
+            curl ca-certificates cmake make build-essential \
+            libz3-4 libtinfo6 libxml2 zlib1g
+          curl -fsSL -o /tmp/cdt.deb \
+            https://git.coopenomics.world/C9S/cdt/releases/download/v4.2.0/cdt_4.2.0-1_amd64.deb
+          $SUDO apt-get install -y /tmp/cdt.deb
+          $SUDO mkdir -p /cdt
+          $SUDO ln -sfn /usr/opt/cdt/4.2.0 /cdt/build
+          cdt-cpp --version || true

      - name: Compile contracts
        working-directory: components/contracts
        run: |
-          ./build-all.sh "$BUILD_MODE"
+          ./build_contracts_cdt.sh "$BUILD_MODE"
          echo "--- build/contracts ---"
          ls -la build/contracts/

@@ -215,6 +237,17 @@ jobs:
      - name: Build and push contracts image
        working-directory: components/contracts
        run: |
+          # Ретрай push'а: резолвинг registry-1.docker.io на runner'е изредка
+          # моргает (DNS-таймаут к 127.0.0.53) — 3 попытки с паузой.
+          dpush() {
+            local ref="$1" n=1
+            until docker push "$ref"; do
+              [ "$n" -ge 3 ] && { echo "::error::docker push $ref не удался после $n попыток"; return 1; }
+              echo "::warning::docker push $ref упал (попытка $n/3) — повтор через 10с"
+              n=$((n+1)); sleep 10
+            done
+          }
+
          IMAGE="dicoop/contracts"
          SHORT_SHA="${SHA::7}"
          docker build \
@@ -223,14 +256,14 @@ jobs:
            --label "build.mode=$BUILD_MODE" \
            -t "$IMAGE:$CONTRACTS_TAG" \
            ./docker/.context
-          docker push "$IMAGE:$CONTRACTS_TAG"
+          dpush "$IMAGE:$CONTRACTS_TAG"

          docker tag "$IMAGE:$CONTRACTS_TAG" "$IMAGE:$CONTRACTS_TAG-$SHORT_SHA"
-          docker push "$IMAGE:$CONTRACTS_TAG-$SHORT_SHA"
+          dpush "$IMAGE:$CONTRACTS_TAG-$SHORT_SHA"

          if [ -n "$CONTRACTS_EXTRA" ]; then
            docker tag "$IMAGE:$CONTRACTS_TAG" "$IMAGE:$CONTRACTS_EXTRA"
-            docker push "$IMAGE:$CONTRACTS_EXTRA"
+            dpush "$IMAGE:$CONTRACTS_EXTRA"
          fi

      - name: Verify pushed contracts image
@@ -243,15 +276,31 @@ jobs:

      - name: Build and push base image
        run: |
+          dpush() {
+            local ref="$1" n=1
+            until docker push "$ref"; do
+              [ "$n" -ge 3 ] && { echo "::error::docker push $ref не удался после $n попыток"; return 1; }
+              echo "::warning::docker push $ref упал (попытка $n/3) — повтор через 10с"
+              n=$((n+1)); sleep 10
+            done
+          }
          docker build --target runtime -t "dicoop/mono-base:$TAG_NAME" .
-          docker push "dicoop/mono-base:$TAG_NAME"
+          dpush "dicoop/mono-base:$TAG_NAME"
          if [ "$IS_PROD" = "true" ]; then
            docker tag "dicoop/mono-base:$TAG_NAME" dicoop/mono-base:latest
-            docker push dicoop/mono-base:latest
+            dpush dicoop/mono-base:latest
          fi

      - name: Build and push service images
        run: |
+          dpush() {
+            local ref="$1" n=1
+            until docker push "$ref"; do
+              [ "$n" -ge 3 ] && { echo "::error::docker push $ref не удался после $n попыток"; return 1; }
+              echo "::warning::docker push $ref упал (попытка $n/3) — повтор через 10с"
+              n=$((n+1)); sleep 10
+            done
+          }
          build_service() {
            local SVC="$1" PKG="$2" CMD="$3"
            local DOCKERFILE="Dockerfile.$SVC"
@@ -260,10 +309,10 @@ jobs:
              echo "CMD [\"pnpm\", \"-F\", \"$PKG\", \"run\", \"$CMD\"]"
            } > "$DOCKERFILE"
            docker build -t "dicoop/$SVC:$TAG_NAME" -f "$DOCKERFILE" .
-            docker push "dicoop/$SVC:$TAG_NAME"
+            dpush "dicoop/$SVC:$TAG_NAME"
            if [ "$IS_PROD" = "true" ]; then
              docker tag "dicoop/$SVC:$TAG_NAME" "dicoop/$SVC:latest"
-              docker push "dicoop/$SVC:latest"
+              dpush "dicoop/$SVC:latest"
            fi
          }

@@ -314,149 +363,44 @@ jobs:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

  # ============================================================================
-  # publish-docs — mkdocs + standards-site → gh-pages (бывший publish-docs.yaml).
+  # trigger-coopenomics-docs — пересборка сайта C9S/coopenomics.
  # Гейт: не-alpha + ветка main.
-  # ВНИМАНИЕ: gh-pages step пушит на github.com/coopenomics/mono — это GitHub
-  # Pages. При переезде на Gitea Actions нужно будет либо подложить PAT для
-  # внешнего push'а в GitHub, либо переключить публикацию на Gitea Pages.
-  # ============================================================================
-  publish-docs:
-    needs: release
-    if: ${{ !contains(github.ref, '-alpha') && needs.release.outputs.branch == 'main' }}
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      # Версия pnpm берётся из `packageManager` корневого package.json,
-      # синхронно с publish-packages job'ом и Dockerfile'ами.
-      - name: Set up pnpm
-        uses: pnpm/action-setup@v4
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: pnpm
-
-      - name: Set up Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: '3.10'
-
-      - name: Install Python requirements
-        run: |
-          python -m venv venv
-          source venv/bin/activate
-          pip install mkdocs-material mkdocs-macros-plugin mkdocs-section-index pymdown-extensions
-        working-directory: ./components/docs
-
-      - name: Install Node.js dependencies
-        run: pnpm install
-        working-directory: ./components/docs
-
-      - name: Patch spectaql-config.yml for CI
-        run: |
-          sed -i.bak "0,/url:.*/s|url:.*|url: 'https://testnet.coopenomics.world/backend/v1/graphql'|" spectaql-config.yml
-        working-directory: ./components/controller
-
-      - name: Show patched spectaql-config.yml
-        run: cat spectaql-config.yml
-        working-directory: ./components/controller
-
-      - name: Build cooptypes
-        run: pnpm run build
-        working-directory: ./components/cooptypes
-
-      - name: Generate controller docs
-        run: pnpm run docs
-        working-directory: ./components/controller
-
-      - name: Copy controller docs
-        run: |
-          mkdir -p ./components/docs/docs/graphql
-          cp -r ./components/controller/docs/* ./components/docs/docs/graphql/
-
-      - name: Generate sdk docs
-        run: pnpm run docs
-        working-directory: ./components/sdk
-
-      - name: Copy sdk docs
-        run: |
-          mkdir -p ./components/docs/docs/sdk
-          cp -r ./components/sdk/docs/* ./components/docs/docs/sdk/
-
-      - name: Generate cooptypes docs
-        run: pnpm run docs
-        working-directory: ./components/cooptypes
-
-      - name: Copy cooptypes docs
-        run: |
-          mkdir -p ./components/docs/docs/cooptypes
-          cp -r ./components/cooptypes/docs/* ./components/docs/docs/cooptypes/
-
-      # ── standards-site → /standards/ на docs.цифровой-кооператив.рф ──
-      # Отдельный Vue-сайт с BPMN-графом кооперативных стандартов,
-      # публикуется как поддиректория на том же домене. Vite собирает
-      # с base='/standards/' (см. vite.config.ts), относительные пути
-      # внутри dist/ и hash-router работают корректно.
-      # dist кладём в docs/standards/ ДО mkdocs build — так же, как
-      # graphql/sdk/cooptypes; mkdocs сам включит его в итоговый site/.
-      - name: Build standards-site
-        run: pnpm run build
-        working-directory: ./components/contracts/standards-site
-
-      - name: Copy standards-site into docs/standards
-        run: |
-          mkdir -p ./components/docs/docs/standards
-          cp -r ./components/contracts/standards-site/dist/* ./components/docs/docs/standards/
-
-      - name: Build docs (mkdocs)
-        run: |
-          source venv/bin/activate
-          mkdocs build
-        working-directory: ./components/docs
-
-      - name: Remove specific large file before publishing
-        run: |
-          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
-        env:
-          GIT_AUTHOR_NAME: github-actions
-          GIT_AUTHOR_EMAIL: github-actions@github.com
-          GIT_COMMITTER_NAME: github-actions
-          GIT_COMMITTER_EMAIL: github-actions@github.com
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Trigger docs deployment webhook
-        if: ${{ success() }}
-        run: |
-          curl -X POST "${{ vars.DOCS_DEPLOY_WEBHOOK_URL }}" \
-            -H 'Content-Type: application/json' \
-            -d '{"ref":"${{ github.ref }}","sha":"${{ github.sha }}","branch":"${{ github.ref_name }}"}'
-
-  # ============================================================================
-  # trigger-coopenomics-docs — repository_dispatch в coopenomics/coopenomics
-  # (бывший build-contracts-docs.yaml). Гейт идентичен publish-docs.
+  #
+  # coopenomics переехал на Gitea (C9S/coopenomics); его publish-docs.yaml
+  # клонирует mono и пересобирает сайт. Gitea НЕ имеет API для
+  # repository_dispatch — только workflow_dispatch, поэтому дёргаем целевой
+  # workflow через Gitea API с PAT (secret DOCS_DISPATCH_TOKEN — префикс GITEA_
+  # у секретов зарезервирован Gitea, нельзя; права write на C9S/coopenomics).
+  # Целевой workflow слушает workflow_dispatch с входами
+  # mono_sha/mono_ref.
  # ============================================================================
  trigger-coopenomics-docs:
    needs: release
    if: ${{ !contains(github.ref, '-alpha') && needs.release.outputs.branch == 'main' }}
    runs-on: ubuntu-latest
    steps:
-      - name: Trigger Coopenomics deployment
-        uses: peter-evans/repository-dispatch@v2
-        with:
-          token: ${{ secrets.COOPENOMICS_PAT }}
-          repository: coopenomics/coopenomics
-          event-type: deploy_from_mono
-          client-payload: '{"repository": "${{ github.repository }}", "sha": "${{ github.sha }}", "ref": "${{ github.ref }}", "actor": "${{ github.actor }}"}'
+      - name: Trigger coopenomics website rebuild (Gitea workflow_dispatch)
+        run: |
+          curl -fsSL -X POST \
+            -H "Authorization: token ${{ secrets.DOCS_DISPATCH_TOKEN }}" \
+            -H "Content-Type: application/json" \
+            -d '{"ref":"master","inputs":{"mono_sha":"${{ github.sha }}","mono_ref":"${{ github.ref }}"}}' \
+            "${{ github.server_url }}/api/v1/repos/C9S/coopenomics/actions/workflows/publish-docs.yaml/dispatches"
+
+  # ============================================================================
+  # trigger-mono-docs — деплой ВТОРОЙ документации (сайт доков mono) через
+  # webhook DOCS_DEPLOY_WEBHOOK_URL. Отдельная от coopenomics публикация —
+  # обе доки уезжают синхронно по релизу. Извлечён из бывшего publish-docs:
+  # gh-pages на github.com выпилен как мёртвый, остался реальный deploy-webhook
+  # (приёмник деплоит доки на своей стороне). Гейт: не-alpha + ветка main.
+  # ============================================================================
+  trigger-mono-docs:
+    needs: release
+    if: ${{ !contains(github.ref, '-alpha') && needs.release.outputs.branch == 'main' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger docs deployment webhook
+        run: |
+          curl -fsSL -X POST "${{ vars.DOCS_DEPLOY_WEBHOOK_URL }}" \
+            -H 'Content-Type: application/json' \
+            -d '{"ref":"${{ github.ref }}","sha":"${{ github.sha }}","branch":"${{ github.ref_name }}"}'
@@ -13,17 +13,25 @@ name: Typecheck
 #
 # Триггеры:
 #  - pull_request на dev — гейт перед мерджем в основную ветку;
-#  - workflow_call — переиспользуется из release.yaml как `needs:` у release-job,
-#    чтобы битый тэг не уехал в DockerHub.
+#  - workflow_call — оставлен для переиспользования, но release.yaml его
+#    больше НЕ вызывает (гейт из релиза убран как избыточный — типы
+#    проверяются на PR в dev до того, как код доедет до тэга).
 #
-# Push в dev/testnet/main НЕ триггерит — намеренно (PR-гейт достаточен,
-# а тэги покрывает workflow_call из release.yaml).
+# Push в dev/testnet/main НЕ триггерит — намеренно (PR-гейт на dev достаточен).

 on:
  pull_request:
    branches: [dev]
  workflow_call:

+# Новый push в PR-ветку отменяет ещё бегущий typecheck по той же ветке —
+# иначе 30-минутные прогоны копятся очередью. Группа по head_ref (исходная
+# ветка PR), для workflow_call fallback на ref. Отмена только своих же
+# прежних прогонов, разные PR друг друга не трогают.
+concurrency:
+  group: typecheck-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
 jobs:
  desktop:
    runs-on: ubuntu-latest
@@ -1,4 +1,5 @@
 node_modules/
+node_modules
 lerna-debug.log
 components/controller/graph.png
 blockchain-data/
@@ -22,3 +23,5 @@ components/contracts/cpp/ledger2/scripts/out/

 .env.testnet
 .pnpm-store
+schema.gql
+.claude
@@ -184,6 +184,35 @@ await sendPOST('/v1/graphql', { query: QUERY, variables });

 Канон — `features/Branch/CreateBranch/{api,model}/index.ts`: тип в model `export type IXxxInput = Mutations.X.Y.IInput['data']`; функция в api `function (data: IXxxInput) { ... variables: { data } }`. Не делать `as` cast'ов.

+## ⚠️ ДИЗАЙН-КАНОН desktop — ОБЯЗАТЕЛЕН К ИСПОЛЬЗОВАНИЮ
+
+**ПРИ ЛЮБОЙ ВЁРСТКЕ В `components/desktop/` НЕ ВЫДУМЫВАТЬ СТИЛИ.** Всегда сначала свериться с каноном. Не строй гипотез о цветах/радиусах/типографике/паттернах из памяти — иди и читай.
+
+**Полная спецификация канона — в skill `/mono-desktop-canon`** (правила обёрток, цвета/токены, иконки, структура страницы, stop-signals). Здесь — короткая выжимка; при расхождении побеждает skill.
+
+**Источник истины — в самом репозитории** (НЕ внешние HTML/прототипы):
+
+| Что | Путь |
+|---|---|
+| Токены палитры/типографики/spacing/radii (`--p-*`) | `components/desktop/src/css/mono-platform/tokens.css` |
+| Прототип-классы компонентов + typography-утилиты `.t-*` | `components/desktop/src/css/mono-platform/components.css` |
+| Оверрайды Quasar под канон | `components/desktop/src/css/mono-platform/quasar-canon.css` |
+| Минимальная SCSS-палитра Quasar (`$primary`/`$dark`) | `components/desktop/src/css/quasar.variables.scss` |
+| Обёртки / доменные блоки / layout | `components/desktop/src/shared/ui/{base,domain,layout}/` |
+| **Живой эталон** (`/_dev/ui` в dev-сборке) | `components/desktop/src/pages/_dev/ui/index.vue` |
+
+**При сомнении — открыть `tokens.css` и `_dev/ui/index.vue`, смотреть как сделано там.** Внешний `shared/MONO Design System.html` и `auth-prototype/` каноном НЕ являются — это устаревшие прототипы.
+
+**Запреты:**
+- Экран собирается из готовых компонентов: `shared/ui/base` (вместо сырых `q-input`/`q-btn`/`q-card`/`q-table`/`q-chip`/`q-dialog`/`q-select`), `shared/ui/domain` (WalletCard, DataRow, DocumentRow, IdentityPanel…), `shared/ui/layout` (PageHead, PageTabs, AppHeader/AppDrawer). Голый Quasar — только где обёртки нет (`q-icon`, `q-toggle`, `q-list`, `q-menu`, `q-tooltip`, `q-tabs`, `q-separator`, `q-spinner`, `q-inner-loading`…). Props обёрток не угадывать — читать `*.types.ts` рядом.
+- Цвет — только токены `var(--p-*)` (поверхности `--p-surface*`, текст `--p-ink*`, линии `--p-line*`, акцент `--p-primary`, статусы `--p-pos/neg/warn/info`) либо utility-классы/color-props. Никаких сырых hex/rgb. Темы light/dark переключаются через `[data-theme]` на `<html>` — токены следуют сами.
+- Spacing/радиусы/типографика — токены `--p-1..--p-10` (4px…72px), `--p-r-sm/md/lg/xl`, `--p-fs-*`/`--p-lh-*` либо классы `.t-*`. Без хардкод-px.
+- Иконки — `q-icon(name='…')` именами Material Icons. **FontAwesome (`fa-*`) запрещён** — заменять на Material-эквивалент попутно.
+- Запрещённые/удаляемые токены: `--mp-*` (старый `marketplace-tokens.scss`), `--tr-*`, `--ds-*`. Легитимны только `--p-*`, `--q-*` (Quasar автоген), `--prog-*`.
+- Никаких локальных переопределений `.q-btn`/`.q-card`/`.q-notification` в feature-файлах — Quasar-overrides централизованы в `quasar-canon.css`.
+
+**Кейс 2026-05-28:** при сомнении в каноне пошёл искать его во внешнем HTML/auth-prototype вместо репозитория — перевёрстал не туда, переделывал. SoT — репо (`tokens.css` + `_dev/ui`) и skill `/mono-desktop-canon`, не внешние файлы.
+
 ## Frontend desktop — English имена

 В `components/desktop/` и любом Vue/TS frontend коде **все имена идентификаторов — английские**:
@@ -1,6 +1,6 @@
 {
  "name": "@coopenomics/blago-cli",
-  "version": "2026.5.23-4",
+  "version": "2026.6.5-2",
  "description": "CLI синхронизации артефактов Благорост с бэкендом через @coopenomics/sdk",
  "type": "module",
  "private": true,
@@ -362,9 +362,9 @@ export async function runCli(argv: string[]): Promise<void> {
    )
    .action(async (paths: string[]) => {
      const root = requireRoot()
-      const { stagedPaths, skippedUnchanged, skippedIgnored, skippedPullOnlyArtifacts } = await runAdd(root, paths)
+      const { stagedPaths, skippedUnchanged, skippedIgnored, skippedPullOnlyArtifacts, skippedNonEntity } = await runAdd(root, paths)
      success(
-        `Staging обновлён: в списке ${stagedPaths.length} путь(ей). Пропущено без изменений относительно индекса: ${skippedUnchanged}; по .blagoignore: ${skippedIgnored}; артефакты только pull (messages/ и meetings/): ${skippedPullOnlyArtifacts}.`,
+        `Staging обновлён: в списке ${stagedPaths.length} путь(ей). Пропущено без изменений относительно индекса: ${skippedUnchanged}; по .blagoignore: ${skippedIgnored}; артефакты только pull (messages/ и meetings/): ${skippedPullOnlyArtifacts}; не blago-сущности (нет type=project/issue/story во frontmatter): ${skippedNonEntity}.`,
      )
    })

@@ -38,6 +38,22 @@ export function parseBlagoMarkdown(raw: string): ParsedBlagoFile {
  }
 }

+/** Не бросает: возвращает тип сущности blago, если файл — корректный project/issue/story; иначе undefined. */
+export function peekBlagoEntityType(raw: string): EntityFrontmatterType | undefined {
+  let file: ReturnType<typeof matter>
+  try {
+    file = matter(raw)
+  }
+  catch {
+    return undefined
+  }
+  const t = file.data?.type
+  if (t === 'project' || t === 'issue' || t === 'story') {
+    return t
+  }
+  return undefined
+}
+
 export function serializeBlagoMarkdown(data: Record<string, unknown>, body: string): string {
  const trimmed = body.endsWith('\n') ? body : `${body}\n`
  // matter.stringify(string, data) сначала парсит string как frontmatter — body, начинающийся
@@ -3,6 +3,7 @@
 import * as fs from 'node:fs/promises'
 import * as path from 'node:path'

+import { peekBlagoEntityType } from '../format/index.js'
 import { sha256Hex } from '../lib/hash.js'
 import { expandBlagoUserTargetsToRelativePaths } from './capital-target-expand.js'
 import { isBlagoSyncExcludedDirName, isIgnoredRelativePath, loadBlagoIgnoreRules } from './ignore.js'
@@ -28,19 +29,39 @@ async function collectMarkdownFiles(absDir: string): Promise<string[]> {
  return out
 }

-/** true — файл стоит поставить в staging: нет в индексе или SHA256 на диске ≠ content_etag_local. */
-async function isDirtyVsIndex(root: string, rel: string, index: Awaited<ReturnType<typeof loadIndex>>): Promise<boolean> {
-  const entry = findByRelativePath(index, rel)
-  if (!entry) {
-    return true
-  }
+type FileCheck =
+  | { kind: 'unreadable' }
+  | { kind: 'non-entity' }
+  | { kind: 'clean' }
+  | { kind: 'dirty' }
+
+/**
+ * Решение по одному файлу для staging:
+ * — нечитаемый → dirty (push сам сообщит вменяемую ошибку),
+ * — без корректного frontmatter type → non-entity (README/notes/CLAUDE/AGENTS и пр. не отправляем),
+ * — есть в индексе и sha256 совпал → clean,
+ * — иначе dirty.
+ */
+async function classifyFileForAdd(
+  root: string,
+  rel: string,
+  index: Awaited<ReturnType<typeof loadIndex>>,
+): Promise<FileCheck> {
+  let raw: string
  try {
-    const raw = await fs.readFile(path.join(root, rel), 'utf8')
-    return sha256Hex(raw) !== entry.content_etag_local
+    raw = await fs.readFile(path.join(root, rel), 'utf8')
  }
  catch {
-    return true
+    return { kind: 'unreadable' }
  }
+  if (peekBlagoEntityType(raw) === undefined) {
+    return { kind: 'non-entity' }
+  }
+  const entry = findByRelativePath(index, rel)
+  if (!entry) {
+    return { kind: 'dirty' }
+  }
+  return sha256Hex(raw) === entry.content_etag_local ? { kind: 'clean' } : { kind: 'dirty' }
 }

 export interface RunAddResult {
@@ -50,6 +71,8 @@ export interface RunAddResult {
  skippedIgnored: number
  /** messages/ и meetings/ — только синхронизация с сервера, в push не идут */
  skippedPullOnlyArtifacts: number
+  /** Файлы без корректного blago-frontmatter (README, notes, CLAUDE/AGENTS и пр.) — в staging не попадают */
+  skippedNonEntity: number
 }

 export async function runAdd(root: string, targets: string[]): Promise<RunAddResult> {
@@ -65,6 +88,7 @@ export async function runAdd(root: string, targets: string[]): Promise<RunAddRes
  let skippedUnchanged = 0
  let skippedIgnored = 0
  let skippedPullOnlyArtifacts = 0
+  let skippedNonEntity = 0

  for (const t of expanded) {
    const abs = path.resolve(root, t)
@@ -86,7 +110,12 @@ export async function runAdd(root: string, targets: string[]): Promise<RunAddRes
        skippedPullOnlyArtifacts += 1
        continue
      }
-      if (!(await isDirtyVsIndex(root, rel, index))) {
+      const check = await classifyFileForAdd(root, rel, index)
+      if (check.kind === 'non-entity') {
+        skippedNonEntity += 1
+        continue
+      }
+      if (check.kind === 'clean') {
        skippedUnchanged += 1
        continue
      }
@@ -96,5 +125,5 @@ export async function runAdd(root: string, targets: string[]): Promise<RunAddRes

  const stagedPaths = [...set].sort()
  await saveStaging(root, { paths: stagedPaths })
-  return { stagedPaths, skippedUnchanged, skippedIgnored, skippedPullOnlyArtifacts }
+  return { stagedPaths, skippedUnchanged, skippedIgnored, skippedPullOnlyArtifacts, skippedNonEntity }
 }
@@ -9,12 +9,15 @@ export interface CommunicationCursorsFile {
  messageLastTsByRoom: Record<string, number>
  /** project_hash → ISO instant: транскрипции с endedAt ≤ этого момента уже выгружены */
  transcriptionLastEndedExclusiveByProject: Record<string, string>
+  /** matrixRoomId → ISO instant: транскрипции непроектной комнаты с endedAt ≤ этого момента уже выгружены */
+  transcriptionLastEndedExclusiveByRoom: Record<string, string>
 }

 function empty(): CommunicationCursorsFile {
  return {
    messageLastTsByRoom: {},
    transcriptionLastEndedExclusiveByProject: {},
+    transcriptionLastEndedExclusiveByRoom: {},
  }
 }

@@ -32,6 +35,11 @@ export async function loadCommunicationCursors(root: string): Promise<Communicat
        && typeof parsed.transcriptionLastEndedExclusiveByProject === 'object'
          ? { ...parsed.transcriptionLastEndedExclusiveByProject }
          : {},
+      transcriptionLastEndedExclusiveByRoom:
+        parsed.transcriptionLastEndedExclusiveByRoom !== undefined
+        && typeof parsed.transcriptionLastEndedExclusiveByRoom === 'object'
+          ? { ...parsed.transcriptionLastEndedExclusiveByRoom }
+          : {},
    }
  }
  catch {
@@ -43,7 +43,6 @@ export function projectCommunicationDayToMarkdown(
 }

 export interface TranscriptionHeaderModel {
-  matrixRoomId: string
  roomId: string
  startedAt: Date | string
  endedAt: Date | string | null | undefined
@@ -71,7 +70,6 @@ export function renderCallTranscriptionMarkdown(
  const header = [
    `# Транскрипция звонка`,
    ``,
-    `- Matrix room: \`${transcription.matrixRoomId}\``,
    `- LiveKit room: \`${transcription.roomId}\``,
    `- Начало: ${start.toISOString()}`,
    `- Окончание: ${end ? end.toISOString() : '—'}`,
@@ -25,7 +25,7 @@ import {
  transcriptionMeetingFileStemUtc,
  type CommunicationDayLine,
 } from './communication-markdown.js'
-import { workspaceBasePath, type ProjectPathModel } from './layout.js'
+import { generateSlug, workspaceBasePath, type ProjectPathModel } from './layout.js'
 import { syncEntityFile } from './sync-entity-file.js'

 interface ProjectRowLite {
@@ -183,6 +183,19 @@ async function listRooms(ctx: AuthenticatedContext, projectHash: string) {
  return q[Queries.ChatCoop.ListProjectCommunicationRooms.name] ?? []
 }

+/** Стабильная папка непроектной комнаты в `rooms/`. Системные — фиксированные, комнаты секретаря — slug + хвост id (уникальность). */
+function nonProjectRoomFolder(kind: string, matrixRoomId: string, displayLabel: string): string {
+  if (kind === 'MEMBERS') {
+    return 'komnata-paishchikov'
+  }
+  if (kind === 'COUNCIL') {
+    return 'komnata-soveta'
+  }
+  const slug = generateSlug(displayLabel) || 'komnata'
+  const shortId = createHash('sha256').update(matrixRoomId, 'utf8').digest('hex').slice(0, 6)
+  return `${slug}-${shortId}`
+}
+
 export async function pullProjectCommunicationArtifacts(
  ctx: AuthenticatedContext,
  index: IndexFile,
@@ -198,6 +211,7 @@ export async function pullProjectCommunicationArtifacts(
    cursors = {
      messageLastTsByRoom: {},
      transcriptionLastEndedExclusiveByProject: {},
+      transcriptionLastEndedExclusiveByRoom: {},
    }
  }

@@ -356,7 +370,6 @@ export async function pullProjectCommunicationArtifacts(
          = dateFromUnknown(tr.endedAt) ?? (tr.endedAt as Date | string | null | undefined)
        const md = renderCallTranscriptionMarkdown(
          {
-            matrixRoomId: String(tr.matrixRoomId),
            roomId: String(tr.roomId),
            startedAt,
            endedAt: endedAtTr,
@@ -422,3 +435,207 @@ export async function pullProjectCommunicationArtifacts(
    warn(`Не удалось сохранить курсоры переписки: ${formatThrownValue(e)}`)
  }
 }
+
+/**
+ * Pull переписки и транскрипций из комнат ВНЕ проектов Capital (пайщики, совет, комнаты секретаря).
+ * Раскладка — отдельная верхняя папка `rooms/<folder>/{messages,meetings}/`, чтобы не смешивать с
+ * проектными `meetings/`. Логика идентична проектной, но bucket = одна комната, курсор транскрипций — по matrixRoomId.
+ */
+export async function pullNonProjectCommunicationArtifacts(
+  ctx: AuthenticatedContext,
+  index: IndexFile,
+): Promise<void> {
+  let rooms: { matrixRoomId: string, displayLabel: string, kind: string }[]
+  try {
+    const q = await ctx.client.Query(Queries.ChatCoop.ListNonProjectCommunicationRooms.query, {})
+    rooms = (q[Queries.ChatCoop.ListNonProjectCommunicationRooms.name] ?? []) as typeof rooms
+  }
+  catch (e) {
+    warn(`Список непроектных комнат (chatcoopListNonProjectCommunicationRooms): ${formatThrownValue(e)}`)
+    return
+  }
+  if (rooms.length === 0) {
+    return
+  }
+
+  let cursors: CommunicationCursorsFile
+  try {
+    cursors = await loadCommunicationCursors(ctx.root)
+  }
+  catch (e) {
+    warn(`Курсоры переписки (комнаты): не удалось прочитать, начинаем с пустых: ${formatThrownValue(e)}`)
+    cursors = {
+      messageLastTsByRoom: {},
+      transcriptionLastEndedExclusiveByProject: {},
+      transcriptionLastEndedExclusiveByRoom: {},
+    }
+  }
+
+  for (const room of rooms) {
+    const folder = nonProjectRoomFolder(room.kind, room.matrixRoomId, room.displayLabel)
+    const basePath = `rooms/${folder}`
+    const roomTitle = room.displayLabel || room.matrixRoomId
+
+    // Сообщения комнаты — по календарным суткам UTC новее курсора.
+    try {
+      const last = cursors.messageLastTsByRoom[room.matrixRoomId]
+      const afterTs = last ?? 0
+      const datesQ = await ctx.client.Query(Queries.ChatCoop.ListUtcDatesWithNewRoomMessages.query, {
+        variables: { data: { matrixRoomId: room.matrixRoomId, afterOriginServerTsExclusive: afterTs } },
+      })
+      const dates = (datesQ[Queries.ChatCoop.ListUtcDatesWithNewRoomMessages.name] ?? []).sort()
+      for (const utcDate of dates) {
+        const mq = await ctx.client.Query(Queries.ChatCoop.GetRoomMessagesForUtcDate.query, {
+          variables: { data: { matrixRoomId: room.matrixRoomId, utcDate } },
+        })
+        const linesRaw = mq[Queries.ChatCoop.GetRoomMessagesForUtcDate.name] ?? []
+        const lines: CommunicationDayLine[] = linesRaw.map(m => ({
+          originServerTs: m.originServerTs,
+          authorLabel: m.authorLabel,
+          coopUsername: m.coopUsername,
+          kind: String(m.kind),
+          bodyText: m.bodyText,
+        }))
+        if (lines.length === 0) {
+          continue
+        }
+        const content = projectCommunicationDayToMarkdown(roomTitle, room.matrixRoomId, utcDate, [
+          { displayLabel: room.displayLabel, matrixRoomId: room.matrixRoomId, lines },
+        ])
+        const rel = `${basePath}/messages/${utcDate}.md`
+        const entityHash = messageDayEntityHash(room.matrixRoomId, utcDate)
+        await syncEntityFile({
+          root: ctx.root,
+          index,
+          entityType: 'room_message_day',
+          entityHash,
+          relativePath: rel,
+          content,
+          remoteUpdatedAt: `${utcDate}T23:59:59.999Z`,
+          label: `переписка ${utcDate} (${room.matrixRoomId})`,
+        })
+      }
+
+      const maxQ = await ctx.client.Query(Queries.ChatCoop.GetMaxOriginServerTsForRoom.query, {
+        variables: { data: { matrixRoomId: room.matrixRoomId } },
+      })
+      const maxTs = maxQ[Queries.ChatCoop.GetMaxOriginServerTsForRoom.name] as number | null | undefined
+      if (maxTs !== undefined && maxTs !== null && Number.isFinite(maxTs)) {
+        cursors.messageLastTsByRoom[room.matrixRoomId] = maxTs
+      }
+    }
+    catch (e) {
+      warn(`Переписка Matrix, комната ${room.matrixRoomId} (${roomTitle}): ${formatThrownValue(e)}`)
+    }
+
+    // Транскрипции звонков комнаты + sibling memo.
+    try {
+      const tExIso = cursors.transcriptionLastEndedExclusiveByRoom[room.matrixRoomId]
+      const lowerBoundExclusive = tExIso === undefined ? new Date(0) : new Date(tExIso)
+
+      interface TranscriptionCandidate {
+        id: string
+        endedAt: Date
+        memo: string
+        updatedAt: Date | undefined
+      }
+      const byId = new Map<string, TranscriptionCandidate>()
+      const tq = await ctx.client.Query(Queries.ChatCoop.GetTranscriptions.query, {
+        variables: { data: { matrixRoomId: room.matrixRoomId, limit: CHATCOOP_TRANSCRIPTIONS_QUERY_LIMIT, offset: 0 } },
+      })
+      const list = tq[Queries.ChatCoop.GetTranscriptions.name] ?? []
+      for (const t of list) {
+        const end = dateFromUnknown(t.endedAt)
+        if (t.status !== Zeus.TranscriptionStatus.COMPLETED || !end) {
+          continue
+        }
+        const prev = byId.get(t.id)
+        if (!prev || end > prev.endedAt) {
+          byId.set(t.id, {
+            id: t.id,
+            endedAt: end,
+            memo: typeof t.memo === 'string' ? t.memo : '',
+            updatedAt: dateFromUnknown(t.updatedAt),
+          })
+        }
+      }
+      const allCompleted = [...byId.values()].sort((a, b) => a.endedAt.getTime() - b.endedAt.getTime())
+
+      const newMeetings = allCompleted.filter(c => c.endedAt.getTime() > lowerBoundExclusive.getTime())
+      let maxEnded: Date | null = null
+      for (const c of newMeetings) {
+        const packQ = await ctx.client.Query(Queries.ChatCoop.GetTranscription.query, {
+          variables: { data: { id: c.id } },
+        })
+        const pack = packQ[Queries.ChatCoop.GetTranscription.name]
+        if (!pack?.transcription || pack.transcription.status !== Zeus.TranscriptionStatus.COMPLETED) {
+          continue
+        }
+        const tr = pack.transcription
+        const startedAt: Date | string = dateFromUnknown(tr.startedAt) ?? (tr.startedAt as Date | string)
+        const endedAtTr: Date | string | null | undefined
+          = dateFromUnknown(tr.endedAt) ?? (tr.endedAt as Date | string | null | undefined)
+        const md = renderCallTranscriptionMarkdown(
+          {
+            roomId: String(tr.roomId),
+            startedAt,
+            endedAt: endedAtTr,
+          },
+          pack.segments.map(s => ({
+            speakerName: s.speakerName,
+            text: s.text,
+            startOffset: s.startOffset,
+            endOffset: s.endOffset,
+          })),
+        )
+        const stem = transcriptionMeetingFileStemUtc(c.endedAt)
+        const rel = `${basePath}/meetings/${stem}.md`
+        const entityHash = c.id.toLowerCase()
+        await syncEntityFile({
+          root: ctx.root,
+          index,
+          entityType: 'call_transcription',
+          entityHash,
+          relativePath: rel,
+          content: md,
+          remoteUpdatedAt: toUpdatedIso(c.endedAt),
+          label: `транскрипция ${c.id}`,
+        })
+        if (!maxEnded || c.endedAt > maxEnded) {
+          maxEnded = c.endedAt
+        }
+      }
+
+      for (const c of allCompleted) {
+        const stem = transcriptionMeetingFileStemUtc(c.endedAt)
+        const memoRel = `${basePath}/meetings/${stem}.memo.md`
+        const memoRemoteUpdatedAt = toUpdatedIso(c.updatedAt ?? c.endedAt)
+        await syncTranscriptionMemoFile({
+          root: ctx.root,
+          index,
+          transcriptionId: c.id,
+          relativePath: memoRel,
+          serverMemo: c.memo,
+          remoteUpdatedAtIso: memoRemoteUpdatedAt,
+        })
+      }
+
+      if (maxEnded) {
+        cursors.transcriptionLastEndedExclusiveByRoom[room.matrixRoomId] = maxEnded.toISOString()
+      }
+      else if (tExIso === undefined) {
+        cursors.transcriptionLastEndedExclusiveByRoom[room.matrixRoomId] = new Date().toISOString()
+      }
+    }
+    catch (e) {
+      warn(`Транскрипции звонков, комната ${room.matrixRoomId}: ${formatThrownValue(e)}`)
+    }
+  }
+
+  try {
+    await saveCommunicationCursors(ctx.root, cursors)
+  }
+  catch (e) {
+    warn(`Не удалось сохранить курсоры переписки (комнаты): ${formatThrownValue(e)}`)
+  }
+}
@@ -28,7 +28,7 @@ import {
  storyFileRelativePath,
  workspaceBasePath,
 } from './layout.js'
-import { pullProjectCommunicationArtifacts } from './pull-communication.js'
+import { pullNonProjectCommunicationArtifacts, pullProjectCommunicationArtifacts } from './pull-communication.js'
 import { scaffoldBmadWorkspacesAfterPull } from './scaffold-bmad-workspace.js'
 import { syncEntityFile } from './sync-entity-file.js'
 import { writeWorkspaceIndexMarkdown } from './workspace-index.js'
@@ -329,6 +329,8 @@ export async function runPull(ctx: AuthenticatedContext, options: RunPullOptions

  await pullProjectCommunicationArtifacts(ctx, index, allProjects, projectByHash)

+  await pullNonProjectCommunicationArtifacts(ctx, index)
+
  await scaffoldBmadWorkspacesAfterPull(ctx, allProjects, projectByHash)

  await saveIndex(ctx.root, index)
@@ -6,7 +6,7 @@ import * as fs from 'node:fs/promises'
 import * as path from 'node:path'

 import { Mutations, Queries } from '@coopenomics/sdk'
-import { parseBlagoMarkdown } from '../format/index.js'
+import { parseBlagoMarkdown, peekBlagoEntityType } from '../format/index.js'
 import { sha256Hex } from '../lib/hash.js'
 import { effectiveParentHash } from '../lib/parent-hash.js'
 import { warn } from '../ui/output.js'
@@ -58,6 +58,30 @@ export async function runPush(ctx: AuthenticatedContext): Promise<void> {
    }
    staging = await loadStaging(ctx.root)
  }
+  // Не-сущности (README/notes/CLAUDE/AGENTS и пр., в .md без type=project|issue|story) тоже не должны валить весь push.
+  // Чистим их автоматически — иначе одна забытая заметка блокирует отправку реальных правок.
+  const stagingAbs = (p: string): string => path.join(ctx.root, normalizeRelativePath(p))
+  const nonEntityInStaging: string[] = []
+  for (const p of staging.paths) {
+    try {
+      const raw = await fs.readFile(stagingAbs(p), 'utf8')
+      if (peekBlagoEntityType(raw) === undefined) {
+        nonEntityInStaging.push(normalizeRelativePath(p))
+      }
+    }
+    catch {
+      // нечитаемый файл — пусть основной цикл бросит понятную ошибку с путём
+    }
+  }
+  if (nonEntityInStaging.length > 0) {
+    const drop = new Set(nonEntityInStaging)
+    const kept = staging.paths.filter(p => !drop.has(normalizeRelativePath(p)))
+    await saveStaging(ctx.root, { paths: [...new Set(kept.map(p => normalizeRelativePath(p)))].sort() })
+    for (const p of nonEntityInStaging) {
+      warn(`Убрано из staging (нет blago-frontmatter type=project|issue|story): ${p}`)
+    }
+    staging = await loadStaging(ctx.root)
+  }
  if (staging.paths.length === 0) {
    throw new Error('Нечего отправлять. Добавьте файлы: blago add <путь | id проекта | projectId-issueId>')
  }
@@ -75,8 +99,24 @@ export async function runPush(ctx: AuthenticatedContext): Promise<void> {
    }
    const abs = path.join(ctx.root, n)
    const raw = await fs.readFile(abs, 'utf8')
-    const parsed = parseBlagoMarkdown(raw)
-    const { type, hash } = validateParsedForPush(parsed)
+    let parsed: ReturnType<typeof parseBlagoMarkdown>
+    try {
+      parsed = parseBlagoMarkdown(raw)
+    }
+    catch (err) {
+      // Без префикса путём из staging вылезает «type: undefined» без указания файла.
+      const msg = err instanceof Error ? err.message : String(err)
+      throw new Error(`Файл «${n}»: ${msg}`)
+    }
+    let type: ReturnType<typeof validateParsedForPush>['type']
+    let hash: string
+    try {
+      ({ type, hash } = validateParsedForPush(parsed))
+    }
+    catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      throw new Error(`Файл «${n}»: ${msg}`)
+    }
    const entry = findByHash(index, type, hash)
    const pKind = pendingKindForEntityType(type)
    const pending = pKind ? await findPendingForParsed(ctx.root, pKind, hash) : undefined
@@ -367,7 +367,6 @@ export async function runRestore(ctx: AuthenticatedContext, userPath: string): P
  if (entry.entity_type === 'call_transcription') {
    interface TranscriptionRestorePack {
      transcription: {
-        matrixRoomId: string
        roomId: string
        startedAt: Date | string
        endedAt: Date | string | null | undefined
@@ -394,7 +393,6 @@ export async function runRestore(ctx: AuthenticatedContext, userPath: string): P
    }
    const content = renderCallTranscriptionMarkdown(
      {
-        matrixRoomId: tr.matrixRoomId,
        roomId: tr.roomId,
        startedAt: tr.startedAt,
        endedAt: tr.endedAt,
@@ -1,7 +1,7 @@
 {
  "name": "@coopenomics/boot",
  "type": "module",
-  "version": "2026.5.23-4",
+  "version": "2026.6.5-2",
  "private": true,
  "packageManager": "pnpm@9.0.6",
  "description": "CLI-утилита инициализации блокчейна и кооператива",
@@ -1,6 +1,7 @@
 #!/bin/bash

-# Загружаем per-instance конфиг из корня репо.
+# Загружаем per-instance конфиг из корня репо (для CHAIN_URL/MONGODB_URL/API_URL,
+# которые читают TS-код boot и шелл-скрипты networks.sh/preactivate.sh).
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
 if [ -f "$ROOT_DIR/.env" ]; then
  set -a
@@ -9,26 +10,34 @@ if [ -f "$ROOT_DIR/.env" ]; then
  set +a
 fi

-# Останавливаем и удаляем контейнеры вместе с volumes
-echo "Останавливаем и удаляем контейнеры с volumes..."
-docker compose down -v mongo postgres cooparser || true
+# Останавливаем и удаляем контейнеры (сеть НЕ трогаем — к ней может быть
+# подключён внешний контейнер вроде provider-backend; down её снёс бы с ошибкой).
+echo "Останавливаем и удаляем контейнеры..."
+docker compose rm -fsv mongo postgres monoredis cooparser coopback || true

 # Останавливаем blockchain контейнер перед удалением данных
 echo "Останавливаем blockchain контейнер..."
 docker compose stop node || true

-# Удаляем blockchain data
+# Удаляем тома баз данных для чистого старта (named volumes rm -v не чистит)
+echo "Удаляем тома баз данных..."
+PROJECT="${COMPOSE_PROJECT_NAME:-$(basename "$ROOT_DIR")}"
+docker volume rm "${PROJECT}_postgres_data" "${PROJECT}_mongo_data" 2>/dev/null || true
+
+# Удаляем blockchain data через контейнер (alpine под root стирает данные
+# независимо от владельца — без sudo на любой ноде; на проде nodeos пишет под root).
 echo "Удаляем blockchain data..."
-# sudo chmod -R 755 ../blockchain-data/ 2>/dev/null || true
-sudo rm -rf ../blockchain-data/
+docker run --rm -v "$(cd .. && pwd)/blockchain-data:/d" alpine sh -c 'rm -rf /d/* /d/.[!.]* 2>/dev/null || true'

-# Пересоздаем и запускаем базы данных
+# Пересоздаем и запускаем базы данных + Redis (monoredis).
+# monoredis ОБЯЗАТЕЛЕН: без него coopback падает на старте с
+# `getaddrinfo EAI_AGAIN monoredis` → MaxRetriesPerRequestError → nodemon crash.
 echo "Пересоздаем и запускаем базы данных..."
-docker compose up -d mongo postgres
+docker compose up -d mongo postgres monoredis

-# Ждем готовности MongoDB
+# Ждем готовности MongoDB (standalone, ping вместо ожидания PRIMARY).
 echo "Ждем готовности MongoDB..."
-until docker compose exec -T mongo mongosh --eval "db.adminCommand('ping')" --quiet > /dev/null 2>&1; do
+until docker compose exec -T mongo mongosh --quiet --eval "db.adminCommand({ping:1}).ok" > /dev/null 2>&1; do
  echo "MongoDB еще не готов, ждем..."
  sleep 2
 done
@@ -42,7 +51,7 @@ until docker compose exec -T postgres pg_isready -U postgres -d voskhod > /dev/n
 done
 echo "PostgreSQL готов!"

-# Запускаем boot процесс
+# Запускаем boot процесс (clean: только программы Благорост/маркетплейс)
 echo "Запускаем boot процесс..."
 pnpm run boot:clean

@@ -51,6 +60,6 @@ echo "Запускаем parser..."
 docker compose up -d cooparser

 echo "Запускаем контроллер..."
-docker compose restart coopback || true
+docker compose up -d --force-recreate coopback || true

 echo "Перезапуск завершен!"
@@ -1,6 +1,7 @@
 #!/bin/bash

-# Загружаем per-instance конфиг из корня репо.
+# Загружаем per-instance конфиг из корня репо (для CHAIN_URL/MONGODB_URL/API_URL,
+# которые читают TS-код boot и шелл-скрипты networks.sh/preactivate.sh).
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
 if [ -f "$ROOT_DIR/.env" ]; then
  set -a
@@ -9,30 +10,32 @@ if [ -f "$ROOT_DIR/.env" ]; then
  set +a
 fi

-# Останавливаем контроллер перед очисткой данных
-echo "Останавливаем контроллер..."
-docker compose down coopback || true
-
 # Останавливаем и удаляем контейнеры вместе с volumes
 echo "Останавливаем и удаляем контейнеры с volumes..."
-docker compose down -v mongo postgres cooparser || true
+docker compose down -v mongo postgres monoredis cooparser coopback || true

 # Останавливаем blockchain контейнер перед удалением данных
 echo "Останавливаем blockchain контейнер..."
 docker compose stop node || true

-# Удаляем blockchain data
+# Удаляем blockchain data.
+# Контейнерный wipe (alpine под root) стирает данные независимо от их владельца —
+# без sudo на любой ноде (на Pi нет passwordless sudo; на проде nodeos пишет
+# данные под root). Единый способ с reboot.sh / clean_reboot.sh.
 echo "Удаляем blockchain data..."
 # sudo chmod -R 755 ../blockchain-data/ 2>/dev/null || true
-sudo rm -rf ../blockchain-data/
+docker run --rm -v "$(cd .. && pwd)/blockchain-data:/d" alpine sh -c 'rm -rf /d/* /d/.[!.]* 2>/dev/null || true'

-# Пересоздаем и запускаем базы данных
+# Пересоздаем и запускаем базы данных + Redis (monoredis).
+# monoredis ОБЯЗАТЕЛЕН: без него coopback падает на старте с
+# `getaddrinfo EAI_AGAIN monoredis` → MaxRetriesPerRequestError → nodemon crash,
+# и провайдер не может взять org-данные partner1 (PROVIDER_URL=coopback:2998).
 echo "Пересоздаем и запускаем базы данных..."
-docker compose up -d mongo postgres
+docker compose up -d mongo postgres monoredis

-# Ждем готовности MongoDB
+# Ждем готовности MongoDB (standalone, ping вместо ожидания PRIMARY).
 echo "Ждем готовности MongoDB..."
-until docker compose exec -T mongo mongosh --eval "db.adminCommand('ping')" --quiet > /dev/null 2>&1; do
+until docker compose exec -T mongo mongosh --quiet --eval "db.adminCommand({ping:1}).ok" > /dev/null 2>&1; do
  echo "MongoDB еще не готов, ждем..."
  sleep 2
 done
@@ -46,7 +49,7 @@ until docker compose exec -T postgres pg_isready -U postgres -d voskhod > /dev/n
 done
 echo "PostgreSQL готов!"

-# Запускаем boot процесс
+# Запускаем boot процесс (расширенный: совет + пайщики; partner1 — при EXTRA_RENT=1)
 echo "Запускаем boot процесс..."
 pnpm run boot:extra

@@ -55,6 +58,6 @@ echo "Запускаем parser..."
 docker compose up -d cooparser

 echo "Запускаем контроллер..."
-docker compose up -d coopback
+docker compose up -d --force-recreate coopback || true

 echo "Перезапуск завершен!"
@@ -291,31 +291,46 @@ export default class Blockchain {
  async activateFeature(feature: Feature) {
    await this.update_pass_instance()

-    await this.api.transact(
-      {
-        actions: [
-          {
-            account: 'eosio',
-            name: 'activate',
-            authorization: [
-              {
-                actor: 'eosio',
-                permission: 'active',
+    try {
+      await this.api.transact(
+        {
+          actions: [
+            {
+              account: 'eosio',
+              name: 'activate',
+              authorization: [
+                {
+                  actor: 'eosio',
+                  permission: 'active',
+                },
+              ],
+              data: {
+                feature_digest: feature.hash,
              },
-            ],
-            data: {
-              feature_digest: feature.hash,
            },
-          },
-        ],
-      },
-      {
-        blocksBehind: 3,
-        expireSeconds: 30,
-      },
-    )
+          ],
+        },
+        {
+          blocksBehind: 3,
+          expireSeconds: 30,
+        },
+      )

-    console.log('Фича активирована: ', feature.name)
+      console.log('Фича активирована: ', feature.name)
+    }
+    catch (e: any) {
+      // На уже забутстрапленном (не обнулённом) чейне протокол-фича уже активна —
+      // nodeos отдаёт protocol_feature_exception (code 3250000). Это не повод
+      // ронять весь boot: фича на месте, нужный результат достигнут, продолжаем.
+      const errName = e?.json?.error?.name
+      const errCode = e?.json?.error?.code
+      const msg = e instanceof Error ? e.message : String(e)
+      if (errName === 'protocol_feature_exception' || errCode === 3250000 || /already activated/i.test(msg)) {
+        console.warn(`Фича уже активирована, пропускаю: ${feature.name}`)
+        return
+      }
+      throw e
+    }
  }

  async createToken(params: TokenContract.Interfaces.ICreate) {
@@ -0,0 +1,11 @@
+{
+  "protocol_feature_type": "builtin",
+  "dependencies": [],
+  "description_digest": "2ad6b7aabba8edbc87b46f3340df4d0db0e4b65474db3e1cd5db33fb685a506b",
+  "subjective_restrictions": {
+    "earliest_allowed_activation_time": "1970-01-01T00:00:00.000",
+    "preactivation_required": true,
+    "enabled": true
+  },
+  "builtin_feature_codename": "ASSERT_RECOVER_KEY_ACCOUNT"
+}
@@ -1,7 +1,6 @@
-import config from '../configs'
 import { initExtensionsInPostgres, initSystemStatus } from '../postgres-init'
 import { installExtraData, installInitialData, startInfra } from './infra'
-import { CooperativeClass, startCoop } from './cooperative'
+import { startCoop } from './cooperative'

 export async function boot() {
  const blockchain = await startInfra()
@@ -14,18 +13,29 @@ export async function boot() {
 }

 export async function bootClean() {
-  const blockchain = await startInfra()
-
-  console.log('Создаём программы (Благорост и маркетплейс)')
-
-  const cooperative = new CooperativeClass(blockchain)
-  await cooperative.createPrograms(config.provider)
+  // Только инфраструктура: контракты, фичи, токен, системные параметры.
+  // Ни совета, ни программ — программы (createPrograms) требуют существующий
+  // совет и создаются в boot/bootExtra внутри installInitialData. В clean их
+  // не делаем (иначе soviet::createprog падает с «Совет не найден»).
+  await startInfra()
 }

 export async function bootExtra() {
  const blockchain = await startInfra()
  await installInitialData(blockchain, true) // Создать расширенный совет (устанавливает статус 'active' в MongoDB)
-  await installExtraData(blockchain) // Добавить дополнительных пайщиков
+
+  // installExtraData регистрирует partner1 как coop с auto-approve от провайдера —
+  // это и есть программная on-chain активация, которая триггерит аренду VM в
+  // провайдере (PENDING→RENT). boot:extra используется НЕ только для аренды
+  // сервера (например, просто пересев совета/чейна для других задач), поэтому
+  // провижининг partner1 включается ТОЛЬКО под флагом EXTRA_RENT=1.
+  if (process.env.EXTRA_RENT === '1') {
+    console.log('EXTRA_RENT=1 → installExtraData: провижининг partner1 (триггер аренды)')
+    await installExtraData(blockchain) // Регистрируем partner1 как coop (active)
+  }
+  else {
+    console.log('EXTRA_RENT не задан → пропускаем провижининг partner1 (аренда не запускается)')
+  }

  console.log('Инициализируем статус системы в PostgreSQL')
  await initSystemStatus() // Устанавливает статус 'active' в PostgreSQL
@@ -15,6 +15,9 @@ import { sleep } from '../utils'
 import { generateRandomSHA256 } from '../utils/randomHash'
 import { initUsersInPostgres, initVaultInPostgres } from '../postgres-init'
 import { CooperativeClass } from './cooperative'
+import { signProgramAgreement } from './sign-program-agreement'
+import { fakeDocument } from '../tests/shared/fakeDocument'
+import { walletDraftId, walletProgramId } from '../tests/capital/consts'

 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
@@ -674,10 +677,17 @@ export async function installExtraData(blockchain: Blockchain) {
    status: 'active',
  })

-  // Ресурсы для партнёра: powerup CPU/NET. transfer токенов пропускаем —
-  // eosio.token::transfer падает на проверке membership в wallet program,
-  // которая для partner1 не настроена. Для provider sync + Hostkey-flow
-  // токены не нужны: tx от имени partner1 пойдут от soviet/admin.
+  // Записываем partner1 в ЦПП Кошелька оператора (voskhod, program_id=1).
+  // БЕЗ этого провайдерский performInitialTransfers (150 AXON на partner1 ДО
+  // перехода в ACTIVE, см. provider CLAUDE.md §13) падает ассертом
+  // eosio.token::is_can_transfer «Получатель не является участником целевой
+  // потребительской программы кошелька» — и инстанс навсегда застревает в
+  // INSTALL. wallet::signagree (auth voskhod@active) делает partner1 членом
+  // ЦПП Кошелька. Та же механика, что для обычных пайщиков в participant.ts.
+  console.log('Подписываем wallet-соглашение за partner1 (членство в ЦПП Кошелька)')
+  await signProgramAgreement(blockchain, config.provider, account.username, walletProgramId, walletDraftId, fakeDocument)
+
+  // Ресурсы для партнёра: powerup CPU/NET.
  await blockchain.powerup({
    payer: 'eosio',
    receiver: account.username,
@@ -1,6 +1,6 @@
 {
  "name": "@coopenomics/cleos",
-  "version": "2026.5.23-4",
+  "version": "2026.6.5-2",
  "private": true,
  "description": "Обёртка над кошельком cleos для EOSIO блокчейна",
  "scripts": {
@@ -1,15 +1,13 @@
 #!/usr/bin/env bash
+# Локальная сборка всех контрактов: оборачивает build_contracts_cdt.sh в
+# CDT-образ. Сам cmake/make живёт в build_contracts_cdt.sh — он же
+# используется в CI (там CDT ставится из .deb, без docker), поэтому
+# флаги сборки в одном месте и не разъезжаются.

 mode="${1:-prod}"

-if [ "$mode" = "test" ]; then
-  is_testnet="ON"
-else
-  is_testnet="OFF"
-fi
-
 docker run --rm --name cdt \
  --volume "$(pwd):/project" \
  -w /project \
  dicoop/blockchain:latest \
-  /bin/bash -c "mkdir -p build && cd build && cmake -DBUILD_TARGET= -DTEST_TARGET= -DVERBOSE=ON -DBUILD_TESTS=OFF -DIS_TESTNET=$is_testnet .. && make"
+  /bin/bash -c "./build_contracts_cdt.sh $mode"
@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# Компиляция всех контрактов кооперативной экономики через CDT.
+#
+# ВАЖНО: скрипт запускается УЖЕ внутри окружения с установленным CDT —
+# тулчейн ожидается по пути /cdt/build/lib/cmake/cdt/CDTWasmToolchain.cmake
+# (он захардкожен в CMakeLists.txt). Здесь НЕТ docker — только cmake/make.
+#
+# Два способа подготовить это окружение:
+#   - локально:  build-all.sh оборачивает скрипт в `docker run dicoop/blockchain:latest`
+#                (в образе CDT уже лежит в /cdt/build);
+#   - в CI:      CDT ставится из .deb (C9S/cdt), а /cdt/build симлинкуется на
+#                /usr/opt/cdt/<ver> (см. .github/workflows/release.yaml).
+#
+# Один источник cmake-флагов для обоих путей — чтобы локальная и CI-сборка
+# не разъезжались.
+set -euo pipefail
+
+mode="${1:-prod}"
+if [ "$mode" = "test" ]; then
+  is_testnet="ON"
+else
+  is_testnet="OFF"
+fi
+
+mkdir -p build
+cd build
+cmake -DBUILD_TARGET= -DTEST_TARGET= -DVERBOSE=ON -DBUILD_TESTS=OFF -DIS_TESTNET="$is_testnet" ..
+make
@@ -72,8 +72,8 @@ void capital::importcontrib(eosio::name coopname, eosio::name username, checksum
    auto idx = user_wallets.get_index<"byuserwallet"_n>();
    auto preimp_it = idx.find(combine_ids(ledger2_wallets::PREIMP_FUND.value, username.value));
    if (preimp_it != idx.end() && preimp_it->available.amount > 0) {
-      eosio::check(preimp_it->blocked.amount == 0,
-                   "preimp.blocked > 0 не поддерживается при импорте — обратиться в поддержку");
+      // Поле blocked упразднено (2026-05-24): резерв/блокировка на кошельках
+      // больше не используется, проверка preimp.blocked == 0 излишня.
      Ledger2::apply(
        _capital, coopname, operations::capital::DROP_PREIMP,
        preimp_it->available, username, contributor_hash,
@@ -9,23 +9,26 @@ namespace Capital::Core {
   * @brief Совокупный баланс программы Благорост на уровне кооператива.
   *
   * Источник — ledger2 L2 (`wallets[BLAGOROST_FUND]`), агрегированный по всем
-   * пайщикам. Σ L3.{available, blocked}[w.cap.blago] == L2.{available, blocked}
-   * (Эпик 3 invariant), поэтому L2 — авторитетная сумма для CRPS-знаменателя.
-   * Если кошелёк ещё не создан (никто не инвестировал) — нулевой баланс.
+   * пайщикам. Σ L3.available[w.cap.blago] == L2.available (Эпик 3 invariant),
+   * поэтому L2 — авторитетная сумма для CRPS-знаменателя. Если кошелёк ещё не
+   * создан (никто не инвестировал) — нулевой баланс.
+   *
+   * Поле blocked упразднено (2026-05-24): субсчёт «заблокировано» больше не
+   * используется, баланс кошелька = available.
   */
  eosio::asset get_capital_program_share_balance(eosio::name coopname) {
    wallets2_index wallets(_ledger2, coopname.value);
    auto it = wallets.find(ledger2_wallets::BLAGOROST_FUND.value);
    if (it == wallets.end()) return eosio::asset(0, _root_govern_symbol);
-    return it->available + it->blocked;
+    return it->available;
  }

  /**
-   * @brief Доля пайщика в Благоросте (available + blocked) из ledger2 L3.
+   * @brief Доля пайщика в Благоросте (available) из ledger2 L3.
   *
   * Источник — `userwallets[(w.cap.blago, username)]`. Запись существует
-   * только пока available + blocked > 0 (Эпик 3 §6: auto-delete на нуле),
-   * поэтому отсутствие = нулевой баланс.
+   * только пока available > 0 (Эпик 3 §6: auto-delete на нуле), поэтому
+   * отсутствие = нулевой баланс. Поле blocked упразднено (2026-05-24).
   */
  eosio::asset get_capital_program_user_share_balance(eosio::name coopname, eosio::name username) {
    userwallets_index user_wallets(_ledger2, coopname.value);
@@ -33,6 +36,6 @@ namespace Capital::Core {
    auto key = combine_ids(ledger2_wallets::BLAGOROST_FUND.value, username.value);
    auto it = idx.find(key);
    if (it == idx.end()) return eosio::asset(0, _root_govern_symbol);
-    return it->available + it->blocked;
+    return it->available;
  }
 }
@@ -67,12 +67,12 @@ void ledger2::revert(eosio::name coopname,
  eosio::check(original_operation_id != 0, "revert: original_operation_id обязателен");

  // -------- validate mirror_wallet_op --------
-  eosio::check(mirror_wallet_op <= 5, "revert: неизвестный mirror_wallet_op");
-  // Не позволяем откатывать через BLOCK/UNBLOCK — они асимметричны и нет
-  // адекватного зеркала в одной операции (BLOCK + UNBLOCK — обратные сами по себе).
-  eosio::check(mirror_wallet_op != static_cast<uint8_t>(WalletOp::BLOCK) &&
-               mirror_wallet_op != static_cast<uint8_t>(WalletOp::UNBLOCK),
-               "revert: BLOCK/UNBLOCK не подлежат откату через revert (они симметричны сами себе)");
+  // Зеркало revert — только TRANSFER (обмен wallet_from/wallet_to) либо BURN
+  // (зеркало ISSUE: изъятие с wallet_from). Бывшие BLOCK/UNBLOCK упразднены
+  // (2026-05-24); ISSUE/NONE как зеркало смысла не имеют.
+  eosio::check(mirror_wallet_op == static_cast<uint8_t>(WalletOp::TRANSFER) ||
+               mirror_wallet_op == static_cast<uint8_t>(WalletOp::BURN),
+               "revert: mirror_wallet_op должен быть TRANSFER или BURN");

  // -------- validate mirror wallets/accounts --------
  if (mirror_wallet_from.value != 0) {
@@ -1,5 +1,5 @@
 /**
- * @brief Атомарная операция по кошельку (issue/transfer/block/unblock/burn/burn_blocked).
+ * @brief Атомарная операция по кошельку (issue/transfer/burn).
 *
 * Внутренний action ledger2 — вызывается только через inline из apply().
 * Auth: только сам ledger2 (require_auth(get_self())).
@@ -53,13 +53,15 @@ void ledger2::walletop(eosio::name coopname,
  eosio::check(amount.symbol == _root_govern_symbol,
               "walletop: некорректный символ валюты");
  eosio::check(memo.size() < 256, "walletop: memo > 255");
-  // op_code = 5 (NONE) намеренно не допускается: NONE-операции — это только
-  // бухпроводка без кошелькового движения, apply.cpp не диспатчит для них walletop.
-  // Прямой вызов с op_code=5 был бы no-op и сбил бы инвариант parity.
-  // Допустимы 0..4 (ISSUE/TRANSFER/BLOCK/UNBLOCK/BURN) и 6 (BURN_BLOCKED).
-  eosio::check(op_code <= static_cast<uint8_t>(WalletOp::BURN_BLOCKED) &&
-               op_code != static_cast<uint8_t>(WalletOp::NONE),
-               "walletop: неизвестный op_code");
+  // Допустимы только ISSUE(0), TRANSFER(1), BURN(4). NONE(5) — это только
+  // бухпроводка без кошелькового движения, apply.cpp для неё walletop не диспатчит;
+  // прямой вызов был бы no-op и сбил бы parity. Бывшие BLOCK(2)/UNBLOCK(3)/
+  // BURN_BLOCKED(6) упразднены (2026-05-24): резерв возврата теперь TRANSFER на
+  // w.wal.wpend, их op_code больше не валиден.
+  eosio::check(op_code == static_cast<uint8_t>(WalletOp::ISSUE) ||
+               op_code == static_cast<uint8_t>(WalletOp::TRANSFER) ||
+               op_code == static_cast<uint8_t>(WalletOp::BURN),
+               "walletop: недопустимый op_code");

  wallets2_index   wallets(get_self(), coopname.value);
  userwallets_index user_wallets(get_self(), coopname.value);
@@ -172,7 +174,7 @@ void ledger2::walletop(eosio::name coopname,
  // миграций 048/049.
  //
  // walletop по построению применяет одно и то же `amount` к L2 и L3 (см.
-  // ниже case'ы ISSUE/TRANSFER/BLOCK/UNBLOCK/BURN/BURN_BLOCKED), а sender-guard на
+  // ниже case'ы ISSUE/TRANSFER/BURN), а sender-guard на
  // строке 46-47 запрещает обход. Поэтому инвариант сохраняется по
  // конструкции; полную сверку выполняет бэкенд («стол бухгалтера»),
  // вне транзакционного hot path.
@@ -227,60 +229,6 @@ void ledger2::walletop(eosio::name coopname,
      cleanup_l3_if_empty(wallet_from);
      break;
    }
-    case WalletOp::BLOCK: {
-      eosio::check(wallet_from.value != 0, "walletop BLOCK: требуется wallet_from");
-      eosio::check(wallet_to.value == 0, "walletop BLOCK: wallet_to должен быть пустым");
-
-      auto it = wallets.find(wallet_from.value);
-      eosio::check(it != wallets.end() && it->available >= amount,
-                   std::string{"walletop BLOCK: недостаточно available на кошельке "} +
-                     wallet_from.to_string());
-      wallets.modify(it, payer, [&](auto& w) {
-        w.available -= amount;
-        w.blocked   += amount;
-      });
-
-      if (is_user_shared_l3(wallet_from)) {
-        auto uw = find_l3(wallet_from);
-        eosio::check(uw != user_wallets.get_index<"byuserwallet"_n>().end() &&
-                     uw->available >= amount,
-                     std::string{"walletop BLOCK: недостаточно L3-available у пайщика "} +
-                       username.to_string() + " на " + wallet_from.to_string());
-        auto uw_pri = user_wallets.find(uw->id);
-        user_wallets.modify(uw_pri, payer, [&](auto& r) {
-          r.available -= amount;
-          r.blocked   += amount;
-        });
-      }
-      break;
-    }
-    case WalletOp::UNBLOCK: {
-      eosio::check(wallet_from.value != 0, "walletop UNBLOCK: требуется wallet_from");
-      eosio::check(wallet_to.value == 0, "walletop UNBLOCK: wallet_to должен быть пустым");
-
-      auto it = wallets.find(wallet_from.value);
-      eosio::check(it != wallets.end() && it->blocked >= amount,
-                   std::string{"walletop UNBLOCK: недостаточно blocked на кошельке "} +
-                     wallet_from.to_string());
-      wallets.modify(it, payer, [&](auto& w) {
-        w.blocked   -= amount;
-        w.available += amount;
-      });
-
-      if (is_user_shared_l3(wallet_from)) {
-        auto uw = find_l3(wallet_from);
-        eosio::check(uw != user_wallets.get_index<"byuserwallet"_n>().end() &&
-                     uw->blocked >= amount,
-                     std::string{"walletop UNBLOCK: недостаточно L3-blocked у пайщика "} +
-                       username.to_string() + " на " + wallet_from.to_string());
-        auto uw_pri = user_wallets.find(uw->id);
-        user_wallets.modify(uw_pri, payer, [&](auto& r) {
-          r.blocked   -= amount;
-          r.available += amount;
-        });
-      }
-      break;
-    }
    case WalletOp::BURN: {
      eosio::check(wallet_from.value != 0, "walletop BURN: требуется wallet_from");
      eosio::check(wallet_to.value == 0, "walletop BURN: wallet_to должен быть пустым");
@@ -311,30 +259,6 @@ void ledger2::walletop(eosio::name coopname,
      eosio::check(false, "walletop NONE: запрещённый op_code");
      break;
    }
-    case WalletOp::BURN_BLOCKED: {
-      eosio::check(wallet_from.value != 0, "walletop BURN_BLOCKED: требуется wallet_from");
-      eosio::check(wallet_to.value == 0, "walletop BURN_BLOCKED: wallet_to должен быть пустым");
-
-      auto it = wallets.find(wallet_from.value);
-      eosio::check(it != wallets.end() && it->blocked >= amount,
-                   std::string{"walletop BURN_BLOCKED: недостаточно blocked на кошельке "} +
-                     wallet_from.to_string());
-      wallets.modify(it, payer, [&](auto& w) { w.blocked -= amount; });
-
-      if (is_user_shared_l3(wallet_from)) {
-        auto uw = find_l3(wallet_from);
-        eosio::check(uw != user_wallets.get_index<"byuserwallet"_n>().end() &&
-                     uw->blocked >= amount,
-                     std::string{"walletop BURN_BLOCKED: недостаточно L3-blocked у пайщика "} +
-                       username.to_string() + " на " + wallet_from.to_string());
-        auto uw_pri = user_wallets.find(uw->id);
-        user_wallets.modify(uw_pri, payer, [&](auto& r) { r.blocked -= amount; });
-      }
-
-      cleanup_l2_if_empty(wallet_from);
-      cleanup_l3_if_empty(wallet_from);
-      break;
-    }
  }

  // Post-mutation Σ L3 == L2: см. блок выше (строки 163-175). Снято
@@ -1,4 +1,4 @@
-#include <vector>
+#include <array>

 /**
 * @brief Универсальное миграционное действие контракта ledger2 — точка
@@ -9,23 +9,33 @@
 * после её прогона на проде тело очищается до пустого `require_auth(get_self())`
 * (как в `capital::migrate`).
 *
- * Текущая задача (2026-05-21): чистка осиротевших L3-записей `w.cap.gen`
- * на voskhod после смены WalletKind GENERATOR_FUND с USER_SHARED на
- * COOPERATIVE (см. `lib/core/ledger2/wallets.hpp`).
+ * Текущая задача (2026-05-24): свёртка `blocked → available` по ВСЕМ коопам.
 *
- * Контекст: на voskhod `convertsegm` падал «недостаточно L3-средств у
- * пайщика» в проектах, где CRPS перераспределял доли между сегментами.
- * w.cap.gen был USER_SHARED, а CRPS в approvecmmt не делал per-user
- * компенсирующих TRANSFER между сегментами: `Σ COMMIT_RID == Σ ACCEPT_RID`
- * соблюдался только на проекте, не на пайщике.
+ * Контекст: механика «заблокированного» баланса упразднена (см.
+ * `lib/core/ledger2/operations.hpp` — удалены WalletOp BLOCK/UNBLOCK/BURN_BLOCKED;
+ * резерв возврата паевого теперь выражается переводом на кошелёк-резерв
+ * `w.wal.wpend`). Поле `blocked` остаётся в таблицах `wallets2`/`userwallets`
+ * как deprecated (физическое удаление поля = небезопасная смена layout таблицы
+ * на живых коопах, выносится в отдельный cleanup-деплой). Перед тем как поле
+ * перестанет поддерживаться кодом, накопленные `blocked`-остатки нужно вернуть
+ * в `available`, чтобы средства не «зависли» на упразднённом субсчёте.
 *
- * Архитектурный фикс: w.cap.gen — COOPERATIVE-пул без L3. Чтобы UI/бэкенд
- * не врали остатками по «личным» w.cap.gen, удаляем осиротевшие L3-записи
- * прямым `userwallets.erase`. L2-баланс `wallets2[w.cap.gen]` уже верен
- * (синхронен с Σ старых userwallets), его не трогаем.
+ * Действие: пройти всех кооперативов (cooperatives2 в scope registrator) и для
+ * каждого свернуть `blocked → available` на уровнях L2 (`wallets2`) и L3
+ * (`userwallets`): `available += blocked; blocked = 0`. Сумма средств на кошельке
+ * не меняется — только субсчёт.
 *
- * Идемпотентно: повторный вызов на чистой БД — no-op (lower_bound пуст).
- * Только voskhod: на остальных кооперативах w.cap.gen не использовался.
+ * Идемпотентно: после свёртки `blocked == 0`, повторный прогон — no-op.
+ *
+ * Сигнатура без аргументов — действие вызывается автоматически при деплое
+ * контракта (как и прочие задачи migrate); проходит по всем кооперативам сам.
+ *
+ * ПРЕДУСЛОВИЕ (операционное): на момент прогона не должно быть заявок на возврат
+ * «в полёте» (статусы pending/authorized в `wallet::withdraws`) — их `blocked`
+ * относится к старой механике и при свёртке в `available` вернётся пайщику как
+ * свободные средства, а последующий `completewthd` (BURN с `w.wal.wpend`) не
+ * найдёт резерва. Незавершённые заявки нужно довести (complete/decline) ДО
+ * деплоя с этой миграцией.
 *
 * @ingroup public_ledger2_actions
 *
@@ -34,24 +44,101 @@
 void ledger2::migrate() {
  require_auth(get_self());

-  const eosio::name target_coop = "voskhod"_n;
+  cooperatives2_index coops(_registrator, _registrator.value);

-  userwallets_index user_wallets(get_self(), target_coop.value);
-  auto idx = user_wallets.get_index<"bywallet"_n>();
+  for (auto c = coops.begin(); c != coops.end(); ++c) {
+    const eosio::name coopname = c->username;

-  // Собираем primary id записей до erase (модификация контейнера при
-  // итерации через secondary index — небезопасна).
-  std::vector<uint64_t> ids_to_erase;
-  for (auto it = idx.lower_bound(ledger2_wallets::GENERATOR_FUND.value);
-       it != idx.end() && it->wallet_name == ledger2_wallets::GENERATOR_FUND;
-       ++it) {
-    ids_to_erase.push_back(it->id);
+    // --- L3: userwallets[coopname] ---
+    // Модифицируем только не-ключевые поля (available/blocked) — итерация по
+    // первичному индексу с modify безопасна (порядок строк не меняется).
+    userwallets_index user_wallets(get_self(), coopname.value);
+    for (auto it = user_wallets.begin(); it != user_wallets.end(); ++it) {
+      if (it->blocked.amount <= 0) continue;
+      user_wallets.modify(it, get_self(), [&](auto& r) {
+        r.available += r.blocked;
+        r.blocked    = eosio::asset(0, r.blocked.symbol);
+      });
+    }
+
+    // --- L2: wallets2[coopname] ---
+    wallets2_index wallets(get_self(), coopname.value);
+    for (auto it = wallets.begin(); it != wallets.end(); ++it) {
+      if (it->blocked.amount <= 0) continue;
+      wallets.modify(it, get_self(), [&](auto& w) {
+        w.available += w.blocked;
+        w.blocked    = eosio::asset(0, w.blocked.symbol);
+      });
+    }
  }

-  for (uint64_t id : ids_to_erase) {
-    auto pri = user_wallets.find(id);
-    if (pri != user_wallets.end()) {
-      user_wallets.erase(pri);
+  // ──────────────────────────────────────────────────────────────────────────
+  // Разовая коррекция СЧЕТОВ под удаление фантомных пайщиков fgrtejiwnynn
+  // (инцидент 2026-06-04). Каждый из 6 дублей-аккаунтов при регистрации внёс
+  // минимальный паевой 300 RUB (o.reg.putmin: Dr 51 / Cr 80, ISSUE w.reg.minshr).
+  // Эти суммы — фантомные (нет реального пайщика), их нужно убрать из паевого
+  // фонда и с расчётного счёта. Снимаем L3-доли фантомов на w.reg.minshr,
+  // суммируем фактически снятое и ровно на эту сумму уменьшаем L2-кошелёк и
+  // бухсчета 80 (Cr) и 51 (Dr). Реальные пайщики (их доли на том же w.reg.minshr
+  // и счетах) не затрагиваются — трогаем только перечисленные username.
+  //
+  // Список синхронизирован с registrator::migrate и soviet::migrate.
+  // Идемпотентно: после первого прогона L3-строк фантомов нет → removed == 0 →
+  // L2/бухсчета не трогаются (вся коррекция в одной atomic-tx).
+  {
+    const eosio::name PHANTOM_COOP = "fgrtejiwnynn"_n;
+    const std::array<eosio::name, 6> PHANTOMS = {
+      "bbsezpgufvmm"_n, "errwcgjwverm"_n, "hcfsluqsfehw"_n,
+      "kgkzdadfpzki"_n, "nzuyijobapsv"_n, "tplwfwbujugq"_n,
+    };
+    const eosio::name MINSHR = ledger2_wallets::MIN_SHARE_FUND; // w.reg.minshr
+
+    eosio::asset removed(0, _root_govern_symbol);
+
+    // 1) Снимаем L3-доли фантомов на w.reg.minshr, суммируем снятое.
+    userwallets_index uw(get_self(), PHANTOM_COOP.value);
+    auto uw_byuser = uw.get_index<"byuser"_n>();
+    for (const auto& u : PHANTOMS) {
+      auto it = uw_byuser.lower_bound(u.value);
+      while (it != uw_byuser.end() && it->username == u) {
+        if (it->wallet_name == MINSHR) {
+          removed += it->available + it->blocked;
+          it = uw_byuser.erase(it);
+        } else {
+          ++it;
+        }
+      }
+    }
+
+    if (removed.amount > 0) {
+      // 2) L2 w.reg.minshr: available -= removed; удалить кошелёк, если опустел.
+      wallets2_index w2(get_self(), PHANTOM_COOP.value);
+      auto wit = w2.find(MINSHR.value);
+      if (wit != w2.end()) {
+        w2.modify(wit, get_self(), [&](auto& w) { w.available -= removed; });
+        if (wit->is_empty()) w2.erase(wit);
+      }
+
+      // 3) Бухсчета (scope=coopname): Cr 80 (паевой фонд) -= removed,
+      //    Dr 51 (расчётный счёт) -= removed; пересчёт сальдо по типу счёта.
+      //    Инвариант Σ Dr == Σ Cr сохраняется (обе стороны уменьшены на removed).
+      accounts2_index acc(get_self(), PHANTOM_COOP.value);
+
+      auto a80 = acc.find(ledger2_accounts::SHARE_FUND);
+      if (a80 != acc.end()) {
+        acc.modify(a80, get_self(), [&](auto& a) {
+          a.credit_balance -= removed;
+          a.balance = account2::compute_balance(a.account_type, a.debit_balance, a.credit_balance);
+        });
+      }
+
+      auto a51 = acc.find(ledger2_accounts::BANK_ACCOUNT);
+      if (a51 != acc.end()) {
+        acc.modify(a51, get_self(), [&](auto& a) {
+          a.debit_balance -= removed;
+          a.balance = account2::compute_balance(a.account_type, a.debit_balance, a.credit_balance);
+        });
+      }
    }
  }
 }
@@ -239,7 +239,7 @@ static constexpr uint64_t _capital_program_id = 4;
 #ifdef IS_TESTNET
    static constexpr uint64_t MIN_SOVIET_MEMBERS_COUNT = 1; /*!< минимальное количество членов совета (тест) */
 #else
-    static constexpr uint64_t MIN_SOVIET_MEMBERS_COUNT = 5; /*!< минимальное количество членов совета (прод) */
+    static constexpr uint64_t MIN_SOVIET_MEMBERS_COUNT = 3; /*!< минимальное количество членов совета (прод) */
 #endif

 /**
@@ -31,9 +31,9 @@
 *   - `WalletOp::WALLET_ONLY` удалён (ADR-003): «без бухпроводок» определяется
 *     парой `(debit_account_id == 0, credit_account_id == 0)` на уровне записи.
 *     Для `o.cap.invest` теперь TRANSFER без проводок (оба account_id == 0).
- *   - Добавлен `WalletOp::BURN` (ADR-003): `available -= amount` на `wallet_from`,
- *     без `wallet_to`. На текущем этапе в `OPERATION_REGISTRY` не используется —
- *     зарезервирован под будущие операции штатного сжигания.
+ *   - `WalletOp::BURN` (ADR-003): `available -= amount` на `wallet_from`,
+ *     без `wallet_to`. Используется в `o.wal.wthcpl` (сжигание резерва возврата
+ *     с `w.wal.wpend`), `o.cap.drppre` и как зеркало ISSUE в `revert`.
 *   - Единые программные кошельки: `BLAGOROST_FUND` (`w.cap.blago`) и
 *     `GENERATOR_FUND` (`w.cap.gen`) — заменили ранее декомпозированные
 *     `bginv/bgprop/bgrid/bgmem` и `gncom/gnmem` (ADR-009).
@@ -61,9 +61,9 @@ namespace operations {
  // wallet
  namespace wallet {
    inline constexpr eosio::name COMPLETE_DEPOSIT  = "o.wal.depcpl"_n;  ///< Завершение внесения паевого взноса (Dr 51 / Cr 80, ISSUE SHARE_FUND_PAY).
-    inline constexpr eosio::name COMPLETE_WITHDRAW = "o.wal.wthcpl"_n;  ///< Завершение возврата паевого взноса (Dr 80 / Cr 51, BURN_BLOCKED SHARE_FUND_PAY — деньги уходят из системы, без wallet_to).
-    inline constexpr eosio::name REQUEST_WITHDRAW  = "o.wal.wthreq"_n;  ///< Запрос на возврат паевого: BLOCK на SHARE_FUND_PAY (без Dr/Cr).
-    inline constexpr eosio::name DECLINE_WITHDRAW  = "o.wal.wthdec"_n;  ///< Отклонение запроса на возврат: UNBLOCK на SHARE_FUND_PAY (без Dr/Cr).
+    inline constexpr eosio::name COMPLETE_WITHDRAW = "o.wal.wthcpl"_n;  ///< Завершение возврата паевого взноса (Dr 80 / Cr 51, BURN с WITHDRAW_PENDING — деньги уходят из системы, без wallet_to).
+    inline constexpr eosio::name REQUEST_WITHDRAW  = "o.wal.wthreq"_n;  ///< Запрос на возврат паевого: TRANSFER SHARE_FUND_PAY → WITHDRAW_PENDING (резерв, без Dr/Cr).
+    inline constexpr eosio::name DECLINE_WITHDRAW  = "o.wal.wthdec"_n;  ///< Отклонение запроса на возврат: TRANSFER WITHDRAW_PENDING → SHARE_FUND_PAY (снятие резерва, без Dr/Cr).
  }

  // capital
@@ -129,14 +129,23 @@ namespace operations {
 * `(debit_account_id == 0, credit_account_id == 0)` на уровне записи реестра.
 * Compile-time правило `(debit==0) ⇔ (credit==0)` ловит смешанные пары.
 */
+//
+// Удаление BLOCK/UNBLOCK/BURN_BLOCKED (2026-05-24): механика «заблокированного»
+// баланса упразднена. Резерв средств под заявку на возврат паевого теперь
+// выражается переводом на отдельный кошелёк-резерв `w.wal.wpend` (TRANSFER),
+// возврат резерва — обратным TRANSFER, завершение — BURN с резерва. Поле
+// `blocked` в таблицах wallets2/userwallets оставлено deprecated (всегда 0
+// после ledger2::migrate-свёртки) — физическое удаление поля = небезопасная
+// смена layout таблицы на живых коопах, выносится в отдельный cleanup-деплой.
+//
+// Числовые значения ISSUE/TRANSFER/BURN/NONE СОХРАНЕНЫ (не перенумерованы),
+// чтобы исторические op_code в blockchain_actions читались бэкендом без сдвига
+// смысла (2 и 3 — бывшие BLOCK/UNBLOCK — больше не выдаются и невалидны на входе).
 enum class WalletOp : uint8_t {
  ISSUE        = 0, ///< первичный вход средств на кошелёк wallet_to (wallet_from = empty)
  TRANSFER     = 1, ///< перемещение wallet_from → wallet_to (с Dr/Cr ИЛИ без — по парам account_id)
-  BLOCK        = 2, ///< available-=amount, blocked+=amount на wallet_from
-  UNBLOCK      = 3, ///< blocked-=amount, available+=amount на wallet_from
  BURN         = 4, ///< изъятие amount с wallet_from->available, без wallet_to. Покрывает оба кейса: (a) штатное сжигание как бизнес-операция в OPERATION_REGISTRY; (b) зеркало ISSUE при `ledger2::revert` (различие — через operation_code: `o.adj.rev` для adjustment-mirror).
  NONE         = 5, ///< только бухпроводка без перемещения средств (wallet_from = empty, wallet_to = empty, debit ≠ 0, credit ≠ 0). Покрывает кейсы внутрибалансовых проводок типа Dr 04 / Cr 08 (приём РИД в НМА), когда кошелёк уже на нужном программном фонде.
-  BURN_BLOCKED = 6, ///< изъятие amount из wallet_from->blocked, без wallet_to. Используется при завершении возврата паевого (`o.wal.wthcpl`): средства предварительно заблокированы через BLOCK (REQUEST_WITHDRAW), на завершении сжигаются — выходят из системы (получателя на цепи нет). На L3 синхронно: from_uw->blocked -= amount.
 };

 /**
@@ -145,7 +154,7 @@ enum class WalletOp : uint8_t {
 * Семантика полей по `wallet_op`:
 *   - ISSUE:   wallet_from = eosio::name{}, wallet_to = required.
 *   - TRANSFER: wallet_from = required, wallet_to = required (≠ from).
- *   - BLOCK / UNBLOCK / BURN / BURN_BLOCKED: wallet_from = required, wallet_to = eosio::name{}.
+ *   - BURN: wallet_from = required, wallet_to = eosio::name{}.
 *
 * Семантика бух.проводки:
 *   - Без проводок: debit_account_id == 0 И credit_account_id == 0.
@@ -157,7 +166,7 @@ struct OperationRegistryEntry {
  eosio::name    process_type;       ///< тип процесса с префиксом `p.<contract>.<noun>`
  WalletOp       wallet_op;
  eosio::name    wallet_from;        ///< пустое имя для ISSUE
-  eosio::name    wallet_to;          ///< пустое имя для BLOCK/UNBLOCK/BURN/BURN_BLOCKED
+  eosio::name    wallet_to;          ///< пустое имя для BURN
  uint64_t       debit_account_id;   ///< 0 если без бухпроводки (тогда credit_account_id тоже == 0)
  uint64_t       credit_account_id;  ///< 0 если без бухпроводки (тогда debit_account_id тоже == 0)
  const char*    human_name;
@@ -184,12 +193,12 @@ static constexpr OperationRegistryEntry OPERATION_REGISTRY[] = {
    ledger2_accounts::BANK_ACCOUNT, ledger2_accounts::SHARE_FUND,
    "Внесение пайщиком паевого взноса" },

-  // 4. Возврат паевого взноса: Dr 80 / Cr 51, BURN_BLOCKED SHARE_FUND_PAY.
-  // Сжигание из заблокированной суммы пайщика (BLOCK был на REQUEST_WITHDRAW):
+  // 4. Возврат паевого взноса: Dr 80 / Cr 51, BURN WITHDRAW_PENDING.
+  // Сжигание из кошелька-резерва (TRANSFER в резерв был на REQUEST_WITHDRAW):
  // деньги уходят из системы (банковский перевод пайщику), получателя на цепи нет.
  // Бухгалтерия: паевой фонд уменьшается (Дт 80), расчётный счёт уменьшается (Кт 51).
-  { operations::wallet::COMPLETE_WITHDRAW, processes::wallet::WITHDRAW, WalletOp::BURN_BLOCKED,
-    ledger2_wallets::SHARE_FUND_PAY, eosio::name{},
+  { operations::wallet::COMPLETE_WITHDRAW, processes::wallet::WITHDRAW, WalletOp::BURN,
+    ledger2_wallets::WITHDRAW_PENDING, eosio::name{},
    ledger2_accounts::SHARE_FUND, ledger2_accounts::BANK_ACCOUNT,
    "Возврат паевого взноса пайщику" },

@@ -273,17 +282,19 @@ static constexpr OperationRegistryEntry OPERATION_REGISTRY[] = {
    ledger2_accounts::SHARE_FUND, ledger2_accounts::TARGET_RECEIPTS,
    "Трансляция паевого взноса из ЦПП «Цифровой Кошелёк» в членский взнос за пользование инфраструктурой" },

-  // 15. Запрос на возврат паевого: BLOCK SHARE_FUND_PAY (без Dr/Cr — внутри одного бухсчёта 80).
-  { operations::wallet::REQUEST_WITHDRAW, processes::wallet::WITHDRAW, WalletOp::BLOCK,
-    ledger2_wallets::SHARE_FUND_PAY, eosio::name{},
+  // 15. Запрос на возврат паевого: TRANSFER SHARE_FUND_PAY → WITHDRAW_PENDING
+  // (без Dr/Cr — оба кошелька на счёте 80; резерв средств на время рассмотрения).
+  { operations::wallet::REQUEST_WITHDRAW, processes::wallet::WITHDRAW, WalletOp::TRANSFER,
+    ledger2_wallets::SHARE_FUND_PAY, ledger2_wallets::WITHDRAW_PENDING,
    0, 0,
-    "Блокировка паевого под запрос на возврат" },
+    "Резервирование паевого под запрос на возврат" },

-  // 16. Отклонение запроса на возврат: UNBLOCK SHARE_FUND_PAY (без Dr/Cr — зеркало REQUEST_WITHDRAW).
-  { operations::wallet::DECLINE_WITHDRAW, processes::wallet::WITHDRAW, WalletOp::UNBLOCK,
-    ledger2_wallets::SHARE_FUND_PAY, eosio::name{},
+  // 16. Отклонение запроса на возврат: TRANSFER WITHDRAW_PENDING → SHARE_FUND_PAY
+  // (без Dr/Cr — зеркало REQUEST_WITHDRAW; возврат резерва пайщику).
+  { operations::wallet::DECLINE_WITHDRAW, processes::wallet::WITHDRAW, WalletOp::TRANSFER,
+    ledger2_wallets::WITHDRAW_PENDING, ledger2_wallets::SHARE_FUND_PAY,
    0, 0,
-    "Разблокировка паевого после отклонения запроса на возврат" },
+    "Снятие резерва паевого после отклонения запроса на возврат" },

  // 17. Возврат из ЦПП «Благорост» в Цифровой Кошелёк: TRANSFER BLAGOROST_FUND → SHARE_FUND_PAY (без Dr/Cr — оба счёта 80, зеркало INVEST).
  { operations::capital::WITHDRAW_FROM_CAPITAL, processes::capital::WTHCAP, WalletOp::TRANSFER,
@@ -340,7 +351,7 @@ static constexpr size_t OPERATION_REGISTRY_SIZE = sizeof(OPERATION_REGISTRY) / s
 //     оба существуют в `LEDGER2_ACCOUNT_MAP`.
 //  4. Для TRANSFER: `wallet_from` ≠ `wallet_to`, оба ≠ 0.
 //  5. Для ISSUE: `wallet_from` == 0 и `wallet_to` ≠ 0.
-//  6. Для BLOCK / UNBLOCK / BURN / BURN_BLOCKED: `wallet_from` ≠ 0, `wallet_to` == 0.
+//  6. Для BURN: `wallet_from` ≠ 0, `wallet_to` == 0.
 //  7. Все id кошельков из записей существуют в `LEDGER2_WALLET_REGISTRY`.
 namespace ledger2_registry_detail {
  constexpr bool operation_codes_unique() {
@@ -384,11 +395,11 @@ namespace ledger2_registry_detail {
    return true;
  }

-  // Правило 6: BURN / BURN_BLOCKED — wallet_from required, wallet_to == 0 (ADR-003).
+  // Правило 6: BURN — wallet_from required, wallet_to == 0 (ADR-003).
  constexpr bool burn_pattern_correct() {
    for (size_t i = 0; i < OPERATION_REGISTRY_SIZE; ++i) {
      const auto& e = OPERATION_REGISTRY[i];
-      if (e.wallet_op != WalletOp::BURN && e.wallet_op != WalletOp::BURN_BLOCKED) continue;
+      if (e.wallet_op != WalletOp::BURN) continue;
      if (e.wallet_from.value == 0) return false;
      if (e.wallet_to.value != 0)   return false;
    }
@@ -440,7 +451,7 @@ static_assert(ledger2_registry_detail::dr_ne_cr_when_posting(),
 static_assert(ledger2_registry_detail::transfer_wallet_from_ne_to(),
              "OPERATION_REGISTRY: TRANSFER с wallet_from == wallet_to или одним из них == 0");
 static_assert(ledger2_registry_detail::burn_pattern_correct(),
-              "OPERATION_REGISTRY: BURN / BURN_BLOCKED требует wallet_from ≠ 0 и wallet_to == 0");
+              "OPERATION_REGISTRY: BURN требует wallet_from ≠ 0 и wallet_to == 0");
 static_assert(ledger2_registry_detail::none_pattern_correct(),
              "OPERATION_REGISTRY: NONE требует wallet_from == 0, wallet_to == 0 и обе проводки заполненными");
 static_assert(ledger2_registry_detail::accounts_exist_in_map(),
@@ -27,7 +27,7 @@
 *   w.mkt.* — Маркетплейс (выплаты поставщикам)
 *
 * Sentinel `eosio::name{}` (пустое имя, value=0) — «кошелёк вне системы»
- * для ISSUE (нет wallet_from) и для BURN/BLOCK/UNBLOCK (нет wallet_to).
+ * для ISSUE (нет wallet_from) и для BURN (нет wallet_to).
 *
 * При первом ISSUE/TRANSFER кошелёк создаётся автоматически по записи
 * из WALLET_REGISTRY. При обнулении available+blocked запись удаляется.
@@ -46,7 +46,8 @@ struct ledger2_wallets {
  // wallet — паевой фонд + возвраты + ЦК
  static constexpr eosio::name SHARE_FUND_PAY       = "w.wal.share"_n;   ///< Паевой взнос пайщика (USER_SHARED)
  static constexpr eosio::name CK_MEMBER            = "w.wal.member"_n;  ///< ЦК — членская часть пайщика (USER_SHARED)
-  static constexpr eosio::name WITHDRAWALS_SINK     = "w.wal.wthdrw"_n;  ///< DEPRECATED 2026-05-21: после переключения o.wal.wthcpl с TRANSFER на BURN_BLOCKED кошелёк больше не получает новых средств. Оставлен в реестре для исторических L2-балансов (накопленные возвраты до перехода). Не использовать в новых операциях.
+  static constexpr eosio::name WITHDRAWALS_SINK     = "w.wal.wthdrw"_n;  ///< DEPRECATED 2026-05-21: исторический sink возвратов. Оставлен в реестре для исторических L2-балансов (накопленные возвраты до перехода). Не использовать в новых операциях.
+  static constexpr eosio::name WITHDRAW_PENDING     = "w.wal.wpend"_n;   ///< Резерв паевого под заявку на возврат (COOPERATIVE-пул). o.wal.wthreq переводит сюда с w.wal.share, o.wal.wthdec возвращает обратно, o.wal.wthcpl сжигает отсюда. Заменил механику blocked/BLOCK/UNBLOCK 2026-05-24.

  // registrator — минимальный паевой + вступительные
  static constexpr eosio::name MIN_SHARE_FUND       = "w.reg.minshr"_n;  ///< Минимальный паевой взнос пайщика (USER_SHARED, без сверки соглашений)
@@ -94,7 +95,7 @@ struct Ledger2WalletMeta {
  WalletKind       kind;
 };

-inline constexpr std::array<Ledger2WalletMeta, 14> LEDGER2_WALLET_REGISTRY = {{
+inline constexpr std::array<Ledger2WalletMeta, 15> LEDGER2_WALLET_REGISTRY = {{
  // USER_SHARED (5) — L3-разрез по пайщику
  { ledger2_wallets::MIN_SHARE_FUND,    "Минимальный паевой взнос",                                 WalletKind::USER_SHARED },
  { ledger2_wallets::SHARE_FUND_PAY,    "Паевой взнос пайщика",                                     WalletKind::USER_SHARED },
@@ -102,7 +103,7 @@ inline constexpr std::array<Ledger2WalletMeta, 14> LEDGER2_WALLET_REGISTRY = {{
  { ledger2_wallets::BLAGOROST_FUND,    "ЦПП «Благорост» — единый кошелёк программы у пайщика",     WalletKind::USER_SHARED },
  { ledger2_wallets::PREIMP_FUND,       "Первичный учёт РИД-взносов до перехода на электронный учёт", WalletKind::USER_SHARED },

-  // COOPERATIVE (9) — единый кооперативный баланс, без L3
+  // COOPERATIVE (10) — единый кооперативный баланс, без L3
  // GENERATOR_FUND переведён сюда из USER_SHARED (см. wallets.hpp:64) —
  // CRPS-распределение между сегментами проекта не поддерживает per-user
  // компенсирующие TRANSFER на approvecmmt, поэтому L3-проверка walletop
@@ -110,6 +111,7 @@ inline constexpr std::array<Ledger2WalletMeta, 14> LEDGER2_WALLET_REGISTRY = {{
  { ledger2_wallets::GENERATOR_FUND,    "ЦПП «Генератор» — единый кошелёк программы",               WalletKind::COOPERATIVE },
  { ledger2_wallets::ENTRANCE_FEES,     "Вступительные взносы",                                     WalletKind::COOPERATIVE },
  { ledger2_wallets::WITHDRAWALS_SINK,  "Возвраты паевых взносов пайщикам (deprecated, не используется в новых операциях)", WalletKind::COOPERATIVE },
+  { ledger2_wallets::WITHDRAW_PENDING,  "Резерв паевого под заявку на возврат",                     WalletKind::COOPERATIVE },
  { ledger2_wallets::INFRA_FEES,        "Членские взносы за инфраструктуру кооп. платформы",        WalletKind::COOPERATIVE },
  { ledger2_wallets::DELEGATE_FEES,     "Делегатские членские взносы",                              WalletKind::COOPERATIVE },
  { ledger2_wallets::SOV_EXPENSES,      "Хозяйственные расходы из числа целевого финансирования",   WalletKind::COOPERATIVE },
@@ -19,6 +19,12 @@ using createapprv_interface = void(CREATEAPPRV_SIGNATURE);
 #define DECLINE_CALLBACK_SIGNATURE name coopname, checksum256 hash, std::string reason
 using decline_callback_interface = void(DECLINE_CALLBACK_SIGNATURE);

+// Общая ветка отказа решения совета: отправка коллбэка отклонения инициатору
+// (если решение пришло из внешнего процесса) + удаление решения из таблицы.
+// Используется при просрочке (cancelexprd) и при достижении отрицательного
+// консенсуса голосов «против» (voteagainst). Определение — cancelexprd.cpp.
+void decline_and_erase_decision(eosio::name coopname, uint64_t decision_id, const std::string &reason);
+
 #define AUTHORIZE_CALLBACK_SIGNATURE name coopname, checksum256 hash, document2 authorization
 using authorize_callback_interface = void(AUTHORIZE_CALLBACK_SIGNATURE);

@@ -1,3 +1,5 @@
+#include <array>
+
 /**
 * @brief Миграция данных контракта.
 * Обновляет счетчики активных пайщиков для всех кооперативов
@@ -40,4 +42,56 @@
      coop.active_participants_count = active_count;
    });
  }
+
+  // ──────────────────────────────────────────────────────────────────────────
+  // Разовая очистка ФАНТОМНЫХ пайщиков кооператива fgrtejiwnynn (инцидент
+  // 2026-06-04). Причина: install.interactor прогнан 3× (2 провала + успех);
+  // каждый прогон минтил на цепи новые аккаунты совета (adduser) со случайным
+  // username, а откат в catch чистил только off-chain. На цепи осели 6 дублей-
+  // аккаунтов одних и тех же 3 учредителей (см. ~/gorozhane-dup-install-cleanup.md
+  // и ~/fixes.md). Удаляем записи registrator::accounts и пересчитываем счётчик
+  // активных пайщиков из soviet::participants (источник истины).
+  //
+  // Список username — единственный авторитет (дедуп off-chain по ФИО невозможен
+  // on-chain — личных данных в registrator::accounts нет). ОДИН И ТОТ ЖЕ список
+  // продублирован в soviet::migrate и ledger2::migrate — править синхронно.
+  // Идемпотентно: повторный прогон не находит записей → no-op.
+  {
+    const eosio::name PHANTOM_COOP = "fgrtejiwnynn"_n;
+    const std::array<eosio::name, 6> PHANTOMS = {
+      "bbsezpgufvmm"_n, "errwcgjwverm"_n, "hcfsluqsfehw"_n,
+      "kgkzdadfpzki"_n, "nzuyijobapsv"_n, "tplwfwbujugq"_n,
+    };
+
+    auto pcoop = coops2.find(PHANTOM_COOP.value);
+    if (pcoop != coops2.end() && pcoop->is_cooperative) {
+      accounts_index accounts(_registrator, _registrator.value);
+
+      for (const auto& u : PHANTOMS) {
+        auto acc = accounts.find(u.value);
+        if (acc == accounts.end()) continue;            // уже удалён / отсутствует
+        // Дедуп-гард: трогаем только аккаунты, зарегистрированные ЭТИМ коопом.
+        if (acc->registrator != PHANTOM_COOP) continue;
+        accounts.erase(acc);
+      }
+
+      // Пересчитываем счётчик активных пайщиков из реестра soviet::participants
+      // (источник истины), ИСКЛЮЧАЯ фантомов явно — счётчик сходится к верному
+      // значению за ОДИН деплой независимо от порядка выполнения migrate
+      // (registrator::migrate vs soviet::migrate). Если бы считали всех has_vote,
+      // а soviet ещё не удалил фантомов — счётчик временно завысился бы.
+      participants_index pparts(_soviet, PHANTOM_COOP.value);
+      uint64_t active = 0;
+      for (auto p = pparts.begin(); p != pparts.end(); ++p) {
+        bool is_phantom = false;
+        for (const auto& ph : PHANTOMS) {
+          if (ph == p->username) { is_phantom = true; break; }
+        }
+        if (!is_phantom && p->has_vote) active++;
+      }
+      coops2.modify(pcoop, _registrator, [&](auto& coop) {
+        coop.active_participants_count = active;
+      });
+    }
+  }
 }
@@ -5,7 +5,7 @@
 # получить от совета согласие на выполнение действия. Поток:
 #
 #   контракт-инициатор → newpackage / create_agenda → soviet::decisions
-#       ↓ голосование (votefor / voteagainst / cancelvote)
+#       ↓ голосование (votefor / voteagainst)
 #   approved=true → authorize (председатель)
 #       ↓
 #   authorized=true → exec → callback в исходный контракт (confirmreg /
@@ -19,8 +19,8 @@
 #
 # Источники в коде:
 #   • cpp/soviet/src/doc/newpackage.cpp
-#   • cpp/soviet/src/vote/{votefor,voteagainst,cancelvote}.cpp
-#   • cpp/soviet/src/decision/{authorize,cancelexprd,exec}.cpp
+#   • cpp/soviet/src/vote/{votefor,voteagainst}.cpp
+#   • cpp/soviet/src/decision/{authorize,cancelexprd,declinedec,exec}.cpp
 # ─────────────────────────────────────────────────────────────────────────────

 process_type: sov.authpkg
@@ -74,17 +74,9 @@ actions:
    actor: Член совета
    role: reject
    purpose: >
-      Член совета голосует «против». При достижении консенсуса по отказу
-      решение помечается как rejected и при exec в исходный контракт
-      уйдёт decline-callback.
-
-  - name: soviet::cancelvote
-    human: Отозвать голос
-    actor: Член совета
-    role: progress
-    purpose: >
-      Член совета отзывает ранее поданный голос до перехода решения
-      в финальный статус.
+      Член совета голосует «против». Голос фиксируется; решение само не
+      закрывается. Когда против высказалось больше половины состава совета,
+      председатель снимает решение явным действием (см. «Отклонить решение»).

  - name: soviet::authorize
    human: Утвердить протокол
@@ -107,11 +99,22 @@ actions:

  - name: soviet::cancelexprd
    human: Отменить просроченное
-    actor: Председатель
+    actor: Кооператив
    role: reject
    purpose: >
      Если решение не было утверждено в срок, оно отменяется как
-      просроченное, в исходный контракт callback не уходит.
+      просроченное: в исходный процесс уходит уведомление об отказе,
+      решение закрывается. Снятие просроченных решений происходит
+      автоматически по истечении срока.
+
+  - name: soviet::declinedec
+    human: Отклонить решение
+    actor: Председатель
+    role: reject
+    purpose: >
+      Если против решения проголосовало больше половины состава совета,
+      председатель явно отклоняет его, не дожидаясь истечения срока: в
+      исходный процесс уходит уведомление об отказе, решение закрывается.

 # ── Секция 3. Граф состояний ────────────────────────────────────────────────
 entity: soviet::decision
@@ -150,9 +153,9 @@ states:
  - name: rejected
    human: Отклонено
    description: >
-      Совет проголосовал «против» либо решение отменено как просроченное.
-      В исходный контракт уходит decline-callback (или callback
-      не вызывается, если просрочка).
+      Председатель отклонил решение по большинству «против» (declinedec) либо
+      решение отменено как просроченное (cancelexprd, автоматически по сроку).
+      В обоих случаях в исходный контракт уходит decline-callback.
    kind: virtual
    virtual: true

@@ -174,15 +177,15 @@ transitions:

  - from: pending
    to: rejected
-    action: soviet::voteagainst
-    actor: Член совета
+    action: soviet::declinedec
+    actor: Председатель
    guards:
      - Большинство голосов «против».

  - from: pending
    to: rejected
    action: soviet::cancelexprd
-    actor: Председатель
+    actor: Кооператив
    guards:
      - Истёк срок принятия решения.

@@ -223,8 +226,8 @@ scenario:
      actor: Член совета
      action: soviet::votefor
      description: >
-        Члены совета голосуют по решению (votefor / voteagainst /
-        cancelvote). При достижении большинства «за» — approved=true.
+        Члены совета голосуют по решению (votefor / voteagainst).
+        При достижении большинства «за» — approved=true.
      pre:
        - Решение в `pending`.
      post:
@@ -259,18 +262,21 @@ scenario:
  alternatives:
    - branch: Отказ совета
      at_step: 2
-      action: soviet::voteagainst
-      actor: Член совета
+      action: soviet::declinedec
+      actor: Председатель
      description: >
-        Большинство «против» — при exec в исходный контракт уйдёт
-        decline-callback (например, registrator::declinereg).
+        Когда против высказалось больше половины состава совета, голос «против»
+        лишь фиксируется. Председатель явно отклоняет решение (declinedec), не
+        дожидаясь срока: в исходный контракт уходит decline-callback (например,
+        registrator::declinereg), запись решения удаляется.

    - branch: Просрочка
      at_step: 2
      action: soviet::cancelexprd
-      actor: Председатель
+      actor: Кооператив
      description: >
-        Решение не принято в срок, отменяется без вызова callback.
+        Решение не принято в срок — автоматически отменяется по истечении
+        срока: в исходный контракт уходит decline-callback, запись удаляется.

 # ── Секция 5. Документы и подписи ───────────────────────────────────────────
 # Документ повестки приходит из исходного процесса — конкретный registry_id
@@ -9,10 +9,10 @@
 #   • cpp/soviet/src/decision/freedecision.cpp
 #   • cpp/soviet/src/vote/votefor.cpp
 #   • cpp/soviet/src/vote/voteagainst.cpp
-#   • cpp/soviet/src/vote/cancelvote.cpp
 #   • cpp/soviet/src/decision/authorize.cpp
 #   • cpp/soviet/src/decision/exec.cpp
 #   • cpp/soviet/src/decision/cancelexprd.cpp
+#   • cpp/soviet/src/decision/declinedec.cpp (внутри cancelexprd.cpp)
 # ─────────────────────────────────────────────────────────────────────────────

 process_type: sov.decision
@@ -63,17 +63,9 @@ actions:
    actor: Член совета
    role: reject
    purpose: >
-      Член совета голосует «против». При достижении консенсуса по отказу
-      решение переходит в статус rejected; протокол не оформляется,
-      исполнения не происходит.
-
-  - name: soviet::cancelvote
-    human: Отозвать голос
-    actor: Член совета
-    role: progress
-    purpose: >
-      Член совета отзывает ранее поданный голос (за или против) до того,
-      как решение перешло в финальный статус.
+      Член совета голосует «против». Голос фиксируется; решение само не
+      закрывается. Когда против высказалось больше половины состава совета,
+      председатель снимает решение явным действием (см. «Отклонить решение»).

  - name: soviet::authorize
    human: Утвердить протокол
@@ -96,11 +88,21 @@ actions:

  - name: soviet::cancelexprd
    human: Отменить просроченное
-    actor: Член совета
+    actor: Кооператив
    role: reject
    purpose: >
-      Если решение не было утверждено в срок, оно может быть отменено
-      как просроченное. Запись удаляется без исполнения.
+      Если решение не было утверждено в срок, оно отменяется как
+      просроченное. Запись удаляется без исполнения. Снятие просроченных
+      решений происходит автоматически по истечении срока.
+
+  - name: soviet::declinedec
+    human: Отклонить решение
+    actor: Председатель
+    role: reject
+    purpose: >
+      Если против решения проголосовало больше половины состава совета,
+      председатель явно отклоняет его, не дожидаясь истечения срока.
+      Запись удаляется без исполнения.

 # ── Секция 3. Граф состояний ────────────────────────────────────────────────
 entity: soviet::decision
@@ -165,15 +167,15 @@ transitions:

  - from: created
    to: rejected
-    action: soviet::voteagainst
-    actor: Член совета
+    action: soviet::declinedec
+    actor: Председатель
    guards:
      - Большинство голосов «против».

  - from: created
    to: rejected
    action: soviet::cancelexprd
-    actor: Член совета
+    actor: Кооператив
    guards:
      - Истёк срок принятия решения.

@@ -214,7 +216,7 @@ scenario:
      actor: Член совета
      action: soviet::votefor
      description: >
-        Члены совета поочерёдно голосуют (votefor / voteagainst / cancelvote).
+        Члены совета поочерёдно голосуют (votefor / voteagainst).
        При достижении большинства «за» решение помечается как approved.
      pre:
        - Решение ещё не закрыто (created).
@@ -248,21 +250,22 @@ scenario:
        - События newresolved/newdecision разосланы.

  alternatives:
-    - branch: Отклонение голосованием
+    - branch: Отклонение советом
      at_step: 2
-      action: soviet::voteagainst
-      actor: Член совета
+      action: soviet::declinedec
+      actor: Председатель
      description: >
-        Большинство голосов «против» — решение помечается как rejected
-        и не утверждается председателем.
+        Когда против высказалось большинство состава совета, голос «против»
+        лишь фиксируется. Председатель явно отклоняет решение (declinedec) —
+        запись удаляется, протокол не оформляется.

    - branch: Просрочка
      at_step: 2
      action: soviet::cancelexprd
-      actor: Член совета
+      actor: Кооператив
      description: >
-        Если решение не было принято в срок, любой член совета может
-        вызвать cancelexprd — запись удаляется как просроченная.
+        Если решение не было принято в срок, оно автоматически отменяется
+        по истечении срока — запись удаляется как просроченная.

 # ── Секция 5. Документы и подписи ───────────────────────────────────────────
 documents:
@@ -201,6 +201,7 @@ public:
  //decisions
  [[eosio::action]] void withdraw(eosio::name coopname, eosio::name username, uint64_t withdraw_id, document2 statement);
  [[eosio::action]] void cancelexprd(eosio::name coopname, uint64_t decision_id);
+  [[eosio::action]] void declinedec(eosio::name coopname, uint64_t decision_id);

  void withdraw_effect(eosio::name executer, eosio::name coopname, uint64_t decision_id, uint64_t batch_id);
  
@@ -9,10 +9,14 @@
 * @ingroup public_actions
 * @ingroup public_soviet_actions

- * @note Авторизация требуется от аккаунта: @p chairman
+ * @note Авторизация требуется от аккаунта: @p coopname
 */
-void soviet::authorize(eosio::name coopname, eosio::name chairman, uint64_t decision_id, document2 document) { 
-  require_auth(chairman);
+void soviet::authorize(eosio::name coopname, eosio::name chairman, uint64_t decision_id, document2 document) {
+  // Авторизует кооператив (действие проводится через бэкенд ключом кооператива).
+  // Согласие председателя при этом не теряется: оно подтверждается криптографически
+  // его личной подписью на документе (verify_document_or_fail ниже) и проверкой
+  // is_valid_chairman — без валидного подписанного председателем документа авторизация невозможна.
+  require_auth(coopname);

  boards_index boards(_soviet, coopname.value);
  autosigner_index autosigner(_soviet, coopname.value);
@@ -27,7 +31,9 @@ void soviet::authorize(eosio::name coopname, eosio::name chairman, uint64_t deci

  verify_document_or_fail(document);

-  decisions.modify(decision, chairman, [&](auto &d){
+  // RAM-плательщик — кооператив: транзакцию авторизует coopname (require_auth выше),
+  // поэтому увеличивать RAM аккаунта председателя нельзя (он tx не подписывал).
+  decisions.modify(decision, coopname, [&](auto &d){
    d.authorized_by = chairman;
    d.authorized = !decision -> authorized;
    d.authorization = document;
@@ -9,30 +9,23 @@

 * @note Авторизация требуется от аккаунта: @p coopname
 */
-void soviet::cancelexprd(eosio::name coopname, uint64_t decision_id) { 
-  require_auth(coopname);
-
+// Общая ветка отказа решения: при наличии полей коллбэка отправляет инициатору
+// коллбэк отклонения, затем удаляет решение из оперативной таблицы. Вызывается
+// из cancelexprd (просрочка) и voteagainst (отрицательный консенсус).
+void decline_and_erase_decision(eosio::name coopname, uint64_t decision_id, const std::string &reason) {
  decisions_index decisions(_soviet, coopname.value);
  auto decision = decisions.find(decision_id);
  eosio::check(decision != decisions.end(), "Решение не найдено");
-  
-  // Проверка истечения срока
-  bool expired = true;
-  if ( decision -> expired_at.has_value() ) {
-    expired = (eosio::time_point_sec(eosio::current_time_point()) > decision->expired_at.value());
-  }
-  
-  eosio::check(expired, "Срок действия решения ещё не истёк");
-  
+
  // Проверка наличия всех необходимых полей для отправки коллбэка
-  if (decision->callback_contract.has_value() && 
-      decision->decline_callback.has_value() && 
-      decision->hash.has_value() && 
-      decision->callback_contract.value() != ""_n && 
-      decision->confirm_callback.value() != ""_n && 
+  if (decision->callback_contract.has_value() &&
+      decision->decline_callback.has_value() &&
+      decision->hash.has_value() &&
+      decision->callback_contract.value() != ""_n &&
+      decision->confirm_callback.value() != ""_n &&
      decision->decline_callback.value() != ""_n
    ) {
-    
+
    // Отправка коллбэка отклонения
    Action::send<decline_callback_interface>(
      decision->callback_contract.value(),
@@ -41,10 +34,61 @@ void soviet::cancelexprd(eosio::name coopname, uint64_t decision_id) {
      _soviet,
      coopname,
      decision->hash.value(),
-      std::string("Отклонение по истечению срока")
+      reason
    );
  }
-  
+
  // Удаление решения
  decisions.erase(decision);
+}
+
+void soviet::cancelexprd(eosio::name coopname, uint64_t decision_id) {
+  require_auth(coopname);
+
+  decisions_index decisions(_soviet, coopname.value);
+  auto decision = decisions.find(decision_id);
+  eosio::check(decision != decisions.end(), "Решение не найдено");
+
+  // Проверка истечения срока
+  bool expired = true;
+  if ( decision -> expired_at.has_value() ) {
+    expired = (eosio::time_point_sec(eosio::current_time_point()) > decision->expired_at.value());
+  }
+
+  eosio::check(expired, "Срок действия решения ещё не истёк");
+
+  decline_and_erase_decision(coopname, decision_id, std::string("Отклонение по истечению срока"));
+}
+
+/**
+ * @brief Явное отклонение решения советом по отрицательному консенсусу
+ * Проводится председателем (ключом кооператива), когда против решения
+ * проголосовало большинство состава совета, до истечения срока. Развязано с
+ * cancelexprd: просрочка гасится автоматически по сроку, а отрицательно принятое
+ * решение снимается с повестки только этим явным действием.
+ * @param coopname Наименование кооператива
+ * @param decision_id Идентификатор решения для отклонения
+ * @ingroup public_actions
+ * @ingroup public_soviet_actions
+
+ * @note Авторизация требуется от аккаунта: @p coopname
+ */
+void soviet::declinedec(eosio::name coopname, uint64_t decision_id) {
+  require_auth(coopname);
+
+  decisions_index decisions(_soviet, coopname.value);
+  auto decision = decisions.find(decision_id);
+  eosio::check(decision != decisions.end(), "Решение не найдено");
+
+  // Отрицательный консенсус: против должно высказаться больше половины состава
+  // совета (порог зеркален votefor — 50%, строгое «больше»).
+  auto board = get_board_by_type_or_fail(coopname, "soviet"_n);
+  auto [votes_for_count, votes_against_count] = decision->get_votes_count();
+  uint64_t total_members = board.get_members_count();
+  uint64_t consensus_percent = 50;
+
+  eosio::check(votes_against_count * 100 > total_members * consensus_percent,
+    "Решение не отклонено советом: нет большинства голосов против");
+
+  decline_and_erase_decision(coopname, decision_id, std::string("Отклонено советом: большинство голосов против"));
 }
@@ -10,11 +10,14 @@
 * @param coopname Имя кооператива
 * @param decision_id Идентификатор решения для исполнения
 * 
-* @note Авторизация требуется от аккаунта: @p executer
+* @note Авторизация требуется от аккаунта: @p coopname
 */
-void soviet::exec(eosio::name executer, eosio::name coopname, uint64_t decision_id) { 
-  require_auth(executer);
-  
+void soviet::exec(eosio::name executer, eosio::name coopname, uint64_t decision_id) {
+  // Исполнение проводится через бэкенд ключом кооператива. Параметр executer остаётся
+  // в payload как аудит-метка (кто инициировал исполнение) и не используется для авторизации
+  // inline-эффектов — те выполняются под собственными правами контракта (_soviet/_gateway/_fund).
+  require_auth(coopname);
+
  decisions_index decisions(_soviet, coopname.value);
  auto decision = decisions.find(decision_id);
  
@@ -124,7 +124,7 @@ void soviet::make_base_coagreements( eosio::name coopname, eosio::symbol govern_
      row.type = "user"_n;
      row.coopname = coopname;
      row.program_id = 0;
-      row.draft_id = 3;
+      row.draft_id = 4;
    });
    
    //создаём соглашение для шаблона политики конфиденциальности
@@ -132,7 +132,7 @@ void soviet::make_base_coagreements( eosio::name coopname, eosio::symbol govern_
      row.type = "privacy"_n;
      row.coopname = coopname;
      row.program_id = 0;
-      row.draft_id = 4;
+      row.draft_id = 3;
    });
    
 }
@@ -1,3 +1,5 @@
+#include <array>
+
 /**
 * @brief Миграция данных системы
 * Выполняет миграцию данных системы при обновлении контракта.
@@ -20,6 +22,46 @@ void soviet::migrate() {
        });
    }

+    // ────────────────────────────────────────────────────────────────────────
+    // Разовая очистка ФАНТОМНЫХ участников кооператива fgrtejiwnynn (инцидент
+    // 2026-06-04). Удаляем строки soviet::participants для 6 дублей-аккаунтов,
+    // оставшихся на цепи после 3-кратного прогона install.interactor (см.
+    // ~/gorozhane-dup-install-cleanup.md). Эти участники не голосовали и не
+    // входят в совет (createboard для них не выполнялся).
+    //
+    // Список username синхронизирован с registrator::migrate и ledger2::migrate.
+    // Дедуп-гард: удаляем фантомов ТОЛЬКО если в коопе остаётся хотя бы один
+    // НЕ-фантомный участник (никогда не опустошаем реестр). Идемпотентно.
+    {
+        const eosio::name PHANTOM_COOP = "fgrtejiwnynn"_n;
+        const std::array<eosio::name, 6> PHANTOMS = {
+            "bbsezpgufvmm"_n, "errwcgjwverm"_n, "hcfsluqsfehw"_n,
+            "kgkzdadfpzki"_n, "nzuyijobapsv"_n, "tplwfwbujugq"_n,
+        };
+
+        auto is_phantom = [&](eosio::name u) {
+            for (const auto& p : PHANTOMS) if (p == u) return true;
+            return false;
+        };
+
+        participants_index participants(_soviet, PHANTOM_COOP.value);
+
+        // Гарантируем, что после удаления останется ≥1 реальный участник.
+        uint64_t real_participants = 0;
+        for (auto it = participants.begin(); it != participants.end(); ++it) {
+            if (!is_phantom(it->username)) real_participants++;
+        }
+
+        if (real_participants > 0) {
+            for (const auto& u : PHANTOMS) {
+                auto it = participants.find(u.value);
+                if (it != participants.end()) {
+                    participants.erase(it);
+                }
+            }
+        }
+    }
+

    // Старый код миграции (закомментирован)
    // cooperatives2_index coops(_registrator, _registrator.value);
@@ -60,8 +60,12 @@ void soviet::voteagainst(
  auto board = get_board_by_type_or_fail(coopname, "soviet"_n);
  eosio::check(board.is_voting_member(username), "У вас нет права голоса");
  
-  decision -> check_for_any_vote_exist(username); 
+  decision -> check_for_any_vote_exist(username);

+  // Голос «против» только фиксируется. Отрицательный консенсус НЕ затирает
+  // решение автоматически: отказ при достигнутом большинстве «против» проводит
+  // председатель явным действием declinedec (развязано с авто-отменой по сроку
+  // cancelexprd). Так принятое отрицательно решение не исчезает само из повестки.
  add_vote_against(coopname, username, decision->id);
 };

@@ -3,10 +3,11 @@
 # программу «Цифровой Кошелёк» (SHARE_FUND_PAY).
 #
 # Четырёхактовый процесс с одной авторизацией советом. Запись заявки живёт в
-# таблице `withdraws` от создания до выплаты или отказа. На закрывающем
-# действии completewthd срабатывает одна операция o.wal.wthcpl — сжигание
-# заблокированной суммы (BURN_BLOCKED w.wal.share): деньги уходят из системы
-# пайщику банковским переводом, получателя на цепи нет.
+# таблице `withdraws` от создания до выплаты или отказа. На подаче заявки сумма
+# переводится в кошелёк-резерв (WITHDRAW_PENDING, w.wal.wpend). На закрывающем
+# действии completewthd срабатывает операция o.wal.wthcpl — сжигание суммы из
+# резерва (BURN w.wal.wpend): деньги уходят из системы пайщику банковским
+# переводом, получателя на цепи нет.
 #
 # Источники правды в коде:
 #   • cpp/wallet/wallet.hpp                                 — actions
@@ -43,8 +44,8 @@ actions:
    actor: contributor
    role: opener
    purpose: >
-      Пайщик создаёт заявку на возврат паевого взноса. Контракт блокирует
-      сумму на кошельке SHARE_FUND_PAY (статус available → blocked) и
+      Пайщик создаёт заявку на возврат паевого взноса. Контракт переводит
+      сумму с кошелька SHARE_FUND_PAY в кошелёк-резерв WITHDRAW_PENDING и
      создаёт повестку в совете о возврате с callback'ом авторизации.
  - name: wallet::authwthd
    human: Авторизовать выплату
@@ -60,16 +61,17 @@ actions:
    role: closer
    purpose: >
      Gateway подтвердил списание средств в пользу пайщика. Это закрывающее
-      действие: применяется операция o.wal.wthcpl (BURN_BLOCKED w.wal.share)
-      — заблокированная сумма сжигается, в бухгалтерии проходит обратная
+      действие: применяется операция o.wal.wthcpl (BURN w.wal.wpend)
+      — сумма из резерва сжигается, в бухгалтерии проходит обратная
      проводка Дт 80 / Кт 51. Запись заявки удаляется.
  - name: wallet::declinewthd
    human: Отклонить
    actor: soviet
    role: reject
    purpose: >
-      Отказ на любом из этапов до выплаты. Сумма разблокируется на кошельке
-      пайщика (UNBLOCK через o.wal.wthdec), запись заявки удаляется.
+      Отказ на любом из этапов до выплаты. Сумма возвращается из резерва на
+      кошелёк пайщика (o.wal.wthdec: WITHDRAW_PENDING → SHARE_FUND_PAY),
+      запись заявки удаляется.

 # ── Секция 3. Граф состояний ────────────────────────────────────────────────
 entity: wallet::withdraw
@@ -80,8 +82,8 @@ states:
  - name: pending
    human: Ожидает решения совета
    description: >
-      Заявка создана, сумма заблокирована на кошельке пайщика (available → blocked),
-      повестка отправлена в совет.
+      Заявка создана, сумма переведена в кошелёк-резерв (SHARE_FUND_PAY →
+      WITHDRAW_PENDING), повестка отправлена в совет.
    kind: normal
  - name: authorized
    human: Выплата отправлена
@@ -92,15 +94,15 @@ states:
  - name: completed
    human: Возврат выплачен
    description: >
-      Gateway подтвердил списание, заблокированная сумма сжигается на кошельке
-      пайщика (BURN_BLOCKED w.wal.share). В бухгалтерии прошла обратная
+      Gateway подтвердил списание, сумма из резерва сжигается
+      (BURN w.wal.wpend). В бухгалтерии прошла обратная
      проводка Дт 80 / Кт 51. Запись заявки удалена.
    kind: final
  - name: removed
    human: Отклонено
    description: >
-      Возврат не состоялся: сумма разблокирована (UNBLOCK через o.wal.wthdec),
-      запись удалена.
+      Возврат не состоялся: сумма возвращена из резерва на кошелёк пайщика
+      (o.wal.wthdec: WITHDRAW_PENDING → SHARE_FUND_PAY), запись удалена.
    kind: virtual
    virtual: true

@@ -172,7 +174,7 @@ scenario:
        - Сумма возврата ≤ доступного остатка.
      post:
        - В таблице withdraws создана запись со статусом `pending`.
-        - На кошельке пайщика сумма переведена available → blocked.
+        - Сумма переведена с SHARE_FUND_PAY в кошелёк-резерв WITHDRAW_PENDING.
        - Совет получил повестку о возврате.

    - step: 2
@@ -197,13 +199,13 @@ scenario:
      action: wallet::completewthd
      description: >
        Gateway подтверждает списание средств в пользу пайщика. Контракт
-        применяет ledger2-операцию o.wal.wthcpl (BURN_BLOCKED w.wal.share с
+        применяет ledger2-операцию o.wal.wthcpl (BURN w.wal.wpend с
        обратной проводкой Дт 80 / Кт 51) и удаляет запись заявки.
      pre:
        - Заявка в статусе `authorized`.
        - Gateway подтвердил списание.
      post:
-        - Заблокированная сумма сожжена с SHARE_FUND_PAY (w.wal.share).
+        - Сумма из резерва сожжена (WITHDRAW_PENDING, w.wal.wpend).
        - В ledger2 применена операция o.wal.wthcpl.
        - Запись заявки удалена.

@@ -214,8 +216,8 @@ scenario:
      actor: soviet
      description: >
        Совет принял отрицательное решение либо Gateway отклонил платёж.
-        Сумма разблокирована на кошельке пайщика (UNBLOCK через o.wal.wthdec),
-        запись удалена.
+        Сумма возвращена из резерва на кошелёк пайщика (o.wal.wthdec:
+        WITHDRAW_PENDING → SHARE_FUND_PAY), запись удалена.

 # ── Секция 5. Документы и подписи ───────────────────────────────────────────
 documents:
@@ -234,45 +236,45 @@ documents:
 # ── Секция 6. Операции ──────────────────────────────────────────────────────
 operations:
  - ledger_code: o.wal.wthreq
-    human_name: Блокировка паевого под запрос на возврат
-    wallet_op: BLOCK
+    human_name: Резервирование паевого под запрос на возврат
+    wallet_op: TRANSFER
    wallet_from: w.wal.share
-    wallet_to: ~
+    wallet_to: w.wal.wpend
    debit: ~
    credit: ~
    amount_ref: withdraw.quantity
    triggered_by: wallet::createwthd
    description: >
-      На создании заявки контракт блокирует сумму на кошельке пайщика
-      (SHARE_FUND_PAY): available → blocked. Бухгалтерская проводка не
-      создаётся — движение внутри одного бухсчёта 80.
+      На создании заявки контракт переводит сумму с кошелька пайщика
+      (SHARE_FUND_PAY) в кошелёк-резерв (WITHDRAW_PENDING). Бухгалтерская
+      проводка не создаётся — движение внутри одного бухсчёта 80.

  - ledger_code: o.wal.wthdec
-    human_name: Разблокировка паевого после отклонения запроса на возврат
-    wallet_op: UNBLOCK
-    wallet_from: w.wal.share
-    wallet_to: ~
+    human_name: Снятие резерва паевого после отклонения запроса на возврат
+    wallet_op: TRANSFER
+    wallet_from: w.wal.wpend
+    wallet_to: w.wal.share
    debit: ~
    credit: ~
    amount_ref: withdraw.quantity
    triggered_by: wallet::declinewthd
    description: >
-      Зеркало REQUEST_WITHDRAW: blocked → available на кошельке пайщика.
-      Бухгалтерская проводка не создаётся.
+      Зеркало REQUEST_WITHDRAW: сумма возвращается из резерва (WITHDRAW_PENDING)
+      на кошелёк пайщика (SHARE_FUND_PAY). Бухгалтерская проводка не создаётся.

  - ledger_code: o.wal.wthcpl
    human_name: Возврат паевого взноса пайщику
-    wallet_op: BURN_BLOCKED
-    wallet_from: w.wal.share          # ЦПП «Цифровой Кошелёк» — паевые взносы деньгами
+    wallet_op: BURN
+    wallet_from: w.wal.wpend           # кошелёк-резерв возвратов
    wallet_to: ~                       # деньги уходят из системы, получателя на цепи нет
    debit: 80                  # Паевой фонд (складочный капитал)
    credit: 51                 # Расчётный счёт
    amount_ref: withdraw.quantity
    triggered_by: wallet::completewthd
    description: >
-      Обратная операция к o.wal.depcpl: заблокированная сумма сжигается с
-      кошелька пайщика «ЦПП Цифровой Кошелёк» (w.wal.share) — деньги уходят
-      из системы банковским переводом пайщику. На цепи получателя нет.
+      Обратная операция к o.wal.depcpl: зарезервированная сумма сжигается с
+      кошелька-резерва (w.wal.wpend) — деньги уходят из системы банковским
+      переводом пайщику. На цепи получателя нет.
      В бухгалтерии прошла проводка Дт 80 / Кт 51 — паевой фонд уменьшился,
      деньги ушли с расчётного счёта пайщику.

@@ -1,6 +1,6 @@
 {
  "name": "@coopenomics/contracts",
-  "version": "2026.5.23-4",
+  "version": "2026.6.5-2",
  "private": true,
  "type": "module",
  "scripts": {
@@ -71,12 +71,6 @@ SENTRY_DSN=
 GITHUB_TOKEN=


-# OpenSearch (поисковая система документов, опционально)
-OPENSEARCH_NODE=https://opensearch:9200
-OPENSEARCH_ENABLED=false
-OPENSEARCH_USERNAME=admin
-OPENSEARCH_PASSWORD=
-
 LIVEKIT_URL=
 LIVEKIT_API_KEY=
 LIVEKIT_API_SECRET=
@@ -1,3 +1,9 @@
 # Convert text file line endings to lf
 * text eol=lf
 *.js text
+
+# Бинарные шрифты — без EOL-нормализации (перекрывает "* text eol=lf")
+*.ttf binary
+*.otf binary
+*.woff binary
+*.woff2 binary
@@ -472,7 +472,7 @@ BaseExtModule
  - `ChairmanBlockchainAdapter` — взаимодействие с контрактом `soviet`
 - **Резолверы**: `ApprovalResolver`, `ChairmanOnboardingResolver`
 - **Крон**: Проверка решений каждые N минут (`checkInterval`)
- **Конфигурация**: `checkInterval`, `cancelApprovedDecisions`, `onboarding_*` — флаги прохождения мастера настройки
+- **Конфигурация**: `checkInterval`, `onboarding_*` — флаги прохождения мастера настройки

 ### `capital` — Благорост (целевая программа)
 - **Структура**: `domain/`, `infrastructure/`, `application/` — самое крупное расширение
@@ -27,11 +27,19 @@ RUN apt-get update && apt-get install -y \
    libharfbuzz-dev \
    libcairo2 \
    libpango1.0-dev \
+    fontconfig \
    && rm -rf /var/lib/apt/lists/* \
    && python3 -m venv /venv \
    && /venv/bin/pip install WeasyPrint==67 \
    && rm -rf /root/.cache/pip

+# Шрифт Arial устанавливаем СИСТЕМНО (а не встраиваем base64 в каждый html).
+# Иначе weasyprint парсил бы ~270 КБ TTF на каждый рендер (≈1.3 сек/документ).
+# Системный шрифт fontconfig парсит один раз и кеширует. Файл тот же —
+# глифы/вёрстка идентичны прежним.
+COPY assets/fonts/arial.ttf /usr/share/fonts/truetype/arial/arial.ttf
+RUN fc-cache -f && fc-match Arial
+
 # Установка пути к виртуальному окружению в PATH
 ENV PATH="/venv/bin:$PATH"

@@ -1,4 +1,6 @@
 {
  "watch": ["./src"],
-  "ext": "ts"
+  "ext": "ts",
+  "delay": 2000,
+  "signal": "SIGTERM"
 }
@@ -1,12 +1,12 @@
 {
  "name": "create-nodejs-express-app",
-  "version": "2026.5.23-4",
+  "version": "2026.6.5-2",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "create-nodejs-express-app",
-      "version": "2026.5.23-4",
+      "version": "2026.6.5-2",
      "license": "MIT",
      "dependencies": {
        "@a2seven/yoo-checkout": "^1.1.4",
@@ -1,6 +1,6 @@
 {
  "name": "@coopenomics/controller",
-  "version": "2026.5.23-4",
+  "version": "2026.6.5-2",
  "description": "Бэкенд GraphQL API кооператива на NestJS",
  "private": true,
  "bin": "bin/createNodejsApp.js",
@@ -99,7 +99,6 @@
    "@nestjs/typeorm": "^10.0.2",
    "@novu/api": "^1.4.0",
    "@octokit/rest": "^22.0.1",
-    "@opensearch-project/opensearch": "^3.5.1",
    "@sentry/nestjs": "^10.32.1",
    "@sentry/node": "^10.32.1",
    "@types/jest": "^29.5.12",
@@ -193,12 +192,12 @@
    "@antfu/eslint-config": "^2.24.1",
    "@graphql-codegen/cli": "^5.0.3",
    "@graphql-codegen/typescript": "^4.1.1",
-    "@swc-node/register": "^1.11.1",
-    "@swc/core": "^1.15.33",
    "@graphql-codegen/typescript-apollo-client-helpers": "^3.0.0",
    "@graphql-codegen/typescript-operations": "^4.3.1",
    "@nestjs/testing": "^11.1.19",
    "@redocly/cli": "^1.18.0",
+    "@swc-node/register": "^1.11.1",
+    "@swc/core": "^1.15.33",
    "@types/express": "^4.17.21",
    "@types/node": "^20.11.26",
    "@typescript-eslint/eslint-plugin": "^5.10.0",
@@ -15,7 +15,6 @@ import { NovuModule } from './infrastructure/novu/novu.module';
 import { EventsInfrastructureModule } from './infrastructure/events/events.module';
 import { FreeDecisionInfrastructureModule } from './infrastructure/free-decision/free-decision-infrastructure.module';
 import { DecisionTrackingInfrastructureModule } from './infrastructure/decision-tracking/decision-tracking-infrastructure.module';
-import { SearchInfrastructureModule } from './infrastructure/search/search-infrastructure.module';
 import { FileStorageInfrastructureModule } from './infrastructure/file-storage';

 // Domain modules
@@ -58,6 +57,7 @@ import { QueueModule } from './application/queue/queue-app.module';
 import { DocumentModule } from './application/document/document.module';
 import { RedisAppModule } from './application/redis/redis-app.module';
 import { DecisionModule } from './application/free-decision/decision.module';
+import { DecisionAuthorizeModule } from './application/decision/decision.module';
 import { AgreementModule } from './application/agreement/agreement.module';
 import { ParticipantModule } from './application/participant/participant.module';
 import { AgendaModule } from './application/agenda/agenda.module';
@@ -78,6 +78,7 @@ import { SettingsApplicationModule } from './application/settings/settings.modul
 import { RegistrationModule } from './application/registration/registration.module';
 import { OnboardingApplicationModule } from './application/onboarding/onboarding-application.module';
 import { SearchModule } from './application/search/search.module';
+import { SignedDocumentsModule } from './application/signed-documents/signed-documents.module';
 import { MutationLoggingInterceptor } from './application/common/interceptors/mutation-logging.interceptor';

@Module({
@@ -99,7 +100,6 @@ import { MutationLoggingInterceptor } from './application/common/interceptors/mu
    GeneratorInfrastructureModule,
    RedisModule,
    NovuModule,
-    SearchInfrastructureModule,
    EventsInfrastructureModule,
    FreeDecisionInfrastructureModule,
    DecisionTrackingInfrastructureModule,
@@ -142,6 +142,7 @@ import { MutationLoggingInterceptor } from './application/common/interceptors/mu
    AccountModule,
    AgreementModule,
    AgendaModule,
+    DecisionAuthorizeModule,
    AppStoreModule,
    AuthModule,
    DesktopModule,
@@ -170,6 +171,7 @@ import { MutationLoggingInterceptor } from './application/common/interceptors/mu
    RegistrationModule,
    OnboardingApplicationModule,
    SearchModule,
+    SignedDocumentsModule,
  ],
  providers: [
    {
@@ -7,6 +7,7 @@ import { MonoAccountDTO } from './mono-account.dto';
 import { UserAccountDTO } from '~/application/account/dto/base-user-account.dto';
 import { ParticipantAccountDTO } from './participant-account.dto';
 import { PrivateAccountDTO } from './private-account.dto';
+import { RegistrationPaymentDTO } from './registration-payment.dto';

@ObjectType('Account')
 export class AccountDTO {
@@ -58,6 +59,15 @@ export class AccountDTO {
  @Type(() => PrivateAccountDTO)
  public readonly private_account!: PrivateAccountDTO | null;

+  @Field(() => RegistrationPaymentDTO, {
+    description:
+      'сводка по вступительному (регистрационному) платежу пайщика. Позволяет восстановить шаг регистрации (ожидание решения совета или отклонение платежа) после перезагрузки страницы и в любой вкладке.',
+    nullable: true,
+  })
+  @ValidateNested()
+  @Type(() => RegistrationPaymentDTO)
+  public readonly registration_payment!: RegistrationPaymentDTO | null;
+
  constructor(entity: AccountDomainEntity) {
    this.username = entity.username;
    this.blockchain_account = entity.blockchain_account || null;
@@ -65,5 +75,8 @@ export class AccountDTO {
    this.user_account = entity.user_account ? new UserAccountDTO(entity.user_account) : null;
    this.participant_account = entity.participant_account ? new ParticipantAccountDTO(entity.participant_account) : null;
    this.private_account = entity.private_account ? new PrivateAccountDTO(entity.private_account) : null;
+    this.registration_payment = entity.registration_payment
+      ? new RegistrationPaymentDTO(entity.registration_payment)
+      : null;
  }
 }
@@ -0,0 +1,32 @@
+import { ObjectType, Field } from '@nestjs/graphql';
+import { PaymentStatusEnum } from '~/domain/gateway/enums/payment-status.enum';
+import type { RegistrationPaymentDomainInterface } from '~/domain/account/interfaces/registration-payment-domain.interface';
+
+@ObjectType('RegistrationPayment')
+export class RegistrationPaymentDTO {
+  @Field(() => PaymentStatusEnum, { description: 'Статус вступительного платежа' })
+  public readonly status: PaymentStatusEnum;
+
+  @Field(() => String, {
+    description: 'Причина изменения статуса. При отклонении платежа — причина отказа, которую видит пайщик.',
+    nullable: true,
+  })
+  public readonly message?: string | null;
+
+  @Field(() => String, { description: 'Хэш платежа' })
+  public readonly hash: string;
+
+  @Field(() => Number, { description: 'Сумма вступительного платежа' })
+  public readonly quantity: number;
+
+  @Field(() => String, { description: 'Символ валюты платежа' })
+  public readonly symbol: string;
+
+  constructor(entity: RegistrationPaymentDomainInterface) {
+    this.status = entity.status;
+    this.message = entity.message ?? null;
+    this.hash = entity.hash;
+    this.quantity = entity.quantity;
+    this.symbol = entity.symbol;
+  }
+}
@@ -37,8 +37,11 @@ import { EntrepreneurDomainEntity } from '~/domain/branch/entities/entrepreneur-
 import { ACCOUNT_BLOCKCHAIN_PORT, AccountBlockchainPort } from '~/domain/account/interfaces/account-blockchain.port';
 import { CANDIDATE_REPOSITORY, CandidateRepository } from '~/domain/account/repository/candidate.repository';
 import { userStatus } from '~/types/user.types';
+import { PAYMENT_REPOSITORY, PaymentRepository } from '~/domain/gateway/repositories/payment.repository';
+import { PaymentTypeEnum } from '~/domain/gateway/enums/payment-type.enum';
 import { CandidateStatus } from '~/domain/registration/enum';
 import { sha256 } from '~/utils/sha256';
+import { registrationProfileFingerprint } from '~/utils/registration-profile-fingerprint';
 import { normalizeUserEmail } from '~/utils/normalize-user-email';
 import type {
  SearchPrivateAccountsInputDomainInterface,
@@ -61,7 +64,8 @@ export class AccountInteractor {
    @Inject(GENERATOR_PORT) private readonly generatorPort: GeneratorPort,
    private readonly tokenApplicationService: TokenApplicationService,
    @Inject(USER_REPOSITORY) private readonly userRepository: UserRepository,
-    @Inject(USER_DOMAIN_SERVICE) private readonly userDomainService: UserDomainService
+    @Inject(USER_DOMAIN_SERVICE) private readonly userDomainService: UserDomainService,
+    @Inject(PAYMENT_REPOSITORY) private readonly paymentRepository: PaymentRepository
  ) {}

  private readonly logger = new Logger(AccountInteractor.name);
@@ -268,7 +272,28 @@ export class AccountInteractor {
  }

  async getAccount(username: string): Promise<AccountDomainEntity> {
-    return await this.accountDomainService.getAccount(username);
+    const account = await this.accountDomainService.getAccount(username);
+
+    // Прокидываем сводку по вступительному платежу, чтобы фронт восстановил шаг
+    // регистрации (ожидание/отклонение платежа) после перезагрузки и в любой вкладке.
+    // Актуально только пока пайщик ещё не принят (нет participant_account).
+    if (!account.participant_account) {
+      const payment = await this.paymentRepository.findLatestByUsernameAndType(
+        username,
+        PaymentTypeEnum.REGISTRATION
+      );
+      if (payment) {
+        account.registration_payment = {
+          status: payment.status,
+          message: payment.message ?? null,
+          hash: payment.hash,
+          quantity: payment.quantity,
+          symbol: payment.symbol,
+        };
+      }
+    }
+
+    return account;
  }

  async getAccounts(
@@ -305,6 +330,29 @@ export class AccountInteractor {
      throw new HttpApiError(HttpStatus.NOT_FOUND, `Кандидат с именем ${username} не найден`);
    }

+    // Гард A (замок профиля): на цепь не должны уйти данные, отличные от
+    // подписанных в заявлении. Если в meta кандидата зафиксирован отпечаток
+    // (заявление подписано после внедрения гарда) — сверяем с текущим
+    // профилем. Кандидаты без отпечатка (регистрация шла до внедрения)
+    // пропускаются, чтобы не сломать уже идущие регистрации.
+    let candidateMeta: Record<string, any> = {};
+    try {
+      candidateMeta = candidate.meta ? JSON.parse(candidate.meta) : {};
+    } catch {
+      candidateMeta = {};
+    }
+    const lockedFingerprint = candidateMeta?.registration_profile_fingerprint;
+    if (lockedFingerprint) {
+      const account = await this.accountDomainService.getAccount(username);
+      const currentFingerprint = registrationProfileFingerprint(account?.private_account);
+      if (currentFingerprint && currentFingerprint !== lockedFingerprint) {
+        throw new HttpApiError(
+          HttpStatus.BAD_REQUEST,
+          'Данные пайщика изменены после подписания заявления. Пожалуйста, переподпишите заявление перед регистрацией.'
+        );
+      }
+    }
+
    try {
      // Вызываем порт для регистрации в блокчейне, передавая объект кандидата целиком
      await this.accountBlockchainPort.registerBlockchainAccount(candidate);
@@ -18,6 +18,6 @@ import { DocumentDomainModule } from '~/domain/document/document.module';
  ],
  controllers: [],
  providers: [AgendaInteractor, AgendaResolver, AgendaService],
-  exports: [],
+  exports: [AgendaService],
 })
 export class AgendaModule {}
@@ -26,9 +26,16 @@ export class AgendaWithDocumentsDTO implements AgendaWithDocumentsDomainInterfac
    data: AgendaWithDocumentsDomainInterface,
    usernameCertificate?: UserCertificateDomainInterface | null,
    votesForCertificates?: UserCertificateDomainInterface[],
-    votesAgainstCertificates?: UserCertificateDomainInterface[]
+    votesAgainstCertificates?: UserCertificateDomainInterface[],
+    councilMembersCount = 0
  ) {
-    this.table = new BlockchainDecisionDTO(data.table, usernameCertificate, votesForCertificates, votesAgainstCertificates);
+    this.table = new BlockchainDecisionDTO(
+      data.table,
+      usernameCertificate,
+      votesForCertificates,
+      votesAgainstCertificates,
+      councilMembersCount
+    );
    this.action = new BlockchainActionDTO(data.action);
    this.documents = new DocumentPackageAggregateDTO(data.documents);
  }
@@ -88,16 +88,25 @@ export class BlockchainDecisionDTO implements SovietContract.Tables.Decisions.ID
  @Field(() => String, { nullable: true })
  hash!: string;

+  @Field(() => Number, {
+    description:
+      'Текущее число членов совета (всего, как считает контракт). Нужно фронту для вычисления порога принятия/отклонения: за/против * 100 > council_members_count * 50',
+  })
+  council_members_count!: number;
+
  constructor(
    data?: any,
    usernameCertificate?: UserCertificateDomainInterface | null,
    votesForCertificates?: UserCertificateDomainInterface[],
-    votesAgainstCertificates?: UserCertificateDomainInterface[]
+    votesAgainstCertificates?: UserCertificateDomainInterface[],
+    councilMembersCount = 0
  ) {
    if (data) {
      Object.assign(this, data);
    }

+    this.council_members_count = councilMembersCount;
+
    // Вспомогательная функция для создания сертификата DTO
    const createCertificateDTO = (
      certificate: UserCertificateDomainInterface | null
@@ -80,4 +80,47 @@ export class AgendaInteractor {
    }
    return agenda;
  }
+
+  /**
+   * Собирает ОДИН пункт повестки по хэшу документа-заявления. Нужен сразу после
+   * публикации свободного решения: возвращаем только что созданный вопрос фронту
+   * немедленно, без ожидания общего поллинга. Возвращает null, пока парсер ещё не
+   * проиндексировал действие newsubmitted или документ-заявление — тогда
+   * вызывающая сторона повторит попытку через паузу.
+   */
+  async getAgendaItemByHash(coopname: string, hash: string): Promise<AgendaWithDocumentsDomainInterface | null> {
+    const target = String(hash).toUpperCase();
+
+    // decision появляется на чейне почти мгновенно после публикации.
+    const decisions = (await this.blockchainPort.getAllRows(
+      SovietContract.contractName.production,
+      coopname,
+      'decisions'
+    )) as SovietContract.Tables.Decisions.IDecision[];
+
+    const decision = decisions.find((d) => String(d.hash).toUpperCase() === target);
+    if (!decision) return null;
+
+    // action newsubmitted индексируется парсером с лагом (~2 c) — пока его нет,
+    // вернём null, и вызывающая сторона повторит тик.
+    const actionResponse = await getActions(`${process.env.SIMPLE_EXPLORER_API}/get-actions`, {
+      filter: JSON.stringify({
+        account: SovietContract.contractName.production,
+        name: SovietContract.Actions.Registry.NewSubmitted.actionName,
+        receiver: process.env.COOPNAME,
+        'data.package': target,
+      }),
+      page: 1,
+      limit: 1,
+    });
+
+    const action = actionResponse?.results?.[0];
+    if (!action) return null;
+
+    const documents = await this.documentPackageAggregator.buildDocumentPackageAggregate(action);
+    // Тот же фильтр, что в getAgenda: без агрегата заявления пункт не отображается.
+    if (!documents.statement?.documentAggregate) return null;
+
+    return { table: decision, action, documents };
+  }
 }
@@ -3,17 +3,25 @@ import { AgendaWithDocumentsDTO } from '../dto/agenda-with-documents.dto';
 import { AgendaInteractor } from '../interactors/agenda.interactor';
 import { UserCertificateDomainPort, USER_CERTIFICATE_DOMAIN_PORT } from '~/domain/user/ports/user-certificate-domain.port';
 import type { UserCertificateDomainInterface } from '~/domain/user/interfaces/user-certificate-domain.interface';
+import { SOVIET_BLOCKCHAIN_PORT, SovietBlockchainPort } from '~/domain/common/ports/soviet-blockchain.port';
+import config from '~/config/config';

@Injectable()
 export class AgendaService {
  constructor(
    private readonly agendaInteractor: AgendaInteractor,
-    @Inject(USER_CERTIFICATE_DOMAIN_PORT) private readonly userCertificateDomainPort: UserCertificateDomainPort
+    @Inject(USER_CERTIFICATE_DOMAIN_PORT) private readonly userCertificateDomainPort: UserCertificateDomainPort,
+    @Inject(SOVIET_BLOCKCHAIN_PORT) private readonly sovietBlockchainPort: SovietBlockchainPort
  ) {}

  public async getAgenda(): Promise<AgendaWithDocumentsDTO[]> {
    const agenda = await this.agendaInteractor.getAgenda();

+    // Состав совета (`soviet`) дёргаем один раз — фронту нужен порог консенсуса.
+    // Считаем всех членов совета (как контрактный get_members_count = members.size()).
+    const boards = await this.sovietBlockchainPort.getBoards(config.coopname);
+    const councilMembersCount = boards.find((b) => b.type === 'soviet')?.members.length ?? 0;
+
    // Обрабатываем каждый элемент повестки дня
    const processedAgenda = await Promise.all(
      agenda.map(async (item) => {
@@ -38,10 +46,34 @@ export class AgendaService {
          }
        }

-        return new AgendaWithDocumentsDTO(item, usernameCertificate, votesForCertificates, votesAgainstCertificates);
+        return new AgendaWithDocumentsDTO(
+          item,
+          usernameCertificate,
+          votesForCertificates,
+          votesAgainstCertificates,
+          councilMembersCount
+        );
      })
    );

    return processedAgenda;
  }
+
+  /**
+   * Возвращает ОДИН пункт повестки по хэшу документа-заявления (или null, если он
+   * ещё не проиндексирован парсером). Используется сразу после публикации
+   * свободного решения, чтобы фронт показал созданный вопрос немедленно.
+   */
+  public async getAgendaItemByHash(hash: string): Promise<AgendaWithDocumentsDTO | null> {
+    const item = await this.agendaInteractor.getAgendaItemByHash(config.coopname, hash);
+    if (!item) return null;
+
+    const boards = await this.sovietBlockchainPort.getBoards(config.coopname);
+    const councilMembersCount = boards.find((b) => b.type === 'soviet')?.members.length ?? 0;
+
+    const usernameCertificate = await this.userCertificateDomainPort.getCertificateByUsername(item.table.username);
+
+    // Только что созданный вопрос ещё без голосов — сертификаты голосовавших пусты.
+    return new AgendaWithDocumentsDTO(item, usernameCertificate, [], [], councilMembersCount);
+  }
 }
@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { DecisionResolver } from './resolvers/decision.resolver';
+import { DecisionService } from './services/decision.service';
+import { DecisionInteractor } from './use-cases/decision.interactor';
+
+@Module({
+  providers: [DecisionResolver, DecisionService, DecisionInteractor],
+})
+export class DecisionAuthorizeModule {}
@@ -0,0 +1,24 @@
+import { Field, InputType, Int } from '@nestjs/graphql';
+import { IsNumber, IsString, ValidateNested } from 'class-validator';
+import { Type } from 'class-transformer';
+import { SignedDigitalDocumentInputDTO } from '~/application/document/dto/signed-digital-document-input.dto';
+
+@InputType('AuthorizeDecisionInput')
+export class AuthorizeDecisionInputDTO {
+  @Field(() => String, { description: 'Имя аккаунта кооператива' })
+  @IsString()
+  coopname!: string;
+
+  @Field(() => String, { description: 'Имя аккаунта председателя совета' })
+  @IsString()
+  chairman!: string;
+
+  @Field(() => Int, { description: 'Идентификатор решения' })
+  @IsNumber()
+  decision_id!: number;
+
+  @Field(() => SignedDigitalDocumentInputDTO, { description: 'Подписанный председателем документ утверждения решения' })
+  @ValidateNested()
+  @Type(() => SignedDigitalDocumentInputDTO)
+  document!: SignedDigitalDocumentInputDTO;
+}
@@ -0,0 +1,13 @@
+import { Field, InputType, Int } from '@nestjs/graphql';
+import { IsNumber, IsString } from 'class-validator';
+
+@InputType('DeclineDecisionInput')
+export class DeclineDecisionInputDTO {
+  @Field(() => String, { description: 'Имя аккаунта кооператива' })
+  @IsString()
+  coopname!: string;
+
+  @Field(() => Int, { description: 'Идентификатор решения' })
+  @IsNumber()
+  decision_id!: number;
+}
@@ -0,0 +1,41 @@
+import { Resolver, Mutation, Args } from '@nestjs/graphql';
+import { UseGuards } from '@nestjs/common';
+import { Throttle } from '@nestjs/throttler';
+import { GqlJwtAuthGuard } from '~/application/auth/guards/graphql-jwt-auth.guard';
+import { RolesGuard } from '~/application/auth/guards/roles.guard';
+import { AuthRoles } from '~/application/auth/decorators/auth.decorator';
+import { TransactionDTO } from '~/application/common/dto/transaction-result-response.dto';
+import { DecisionService } from '../services/decision.service';
+import { AuthorizeDecisionInputDTO } from '../dto/authorize-decision-input.dto';
+import { DeclineDecisionInputDTO } from '../dto/decline-decision-input.dto';
+
+@Resolver()
+export class DecisionResolver {
+  constructor(private readonly decisionService: DecisionService) {}
+
+  @Mutation(() => TransactionDTO, {
+    name: 'authorizeDecision',
+    description: 'Утвердить и исполнить решение совета',
+  })
+  @Throttle({ default: { limit: 10, ttl: 60000 } })
+  @UseGuards(GqlJwtAuthGuard, RolesGuard)
+  @AuthRoles(['chairman'])
+  async authorizeDecision(
+    @Args('data', { type: () => AuthorizeDecisionInputDTO }) data: AuthorizeDecisionInputDTO
+  ): Promise<TransactionDTO> {
+    return this.decisionService.authorizeDecision(data);
+  }
+
+  @Mutation(() => TransactionDTO, {
+    name: 'declineDecision',
+    description: 'Отклонить решение совета по отрицательному консенсусу (большинство голосов против)',
+  })
+  @Throttle({ default: { limit: 10, ttl: 60000 } })
+  @UseGuards(GqlJwtAuthGuard, RolesGuard)
+  @AuthRoles(['chairman'])
+  async declineDecision(
+    @Args('data', { type: () => DeclineDecisionInputDTO }) data: DeclineDecisionInputDTO
+  ): Promise<TransactionDTO> {
+    return this.decisionService.declineDecision(data);
+  }
+}
@@ -0,0 +1,20 @@
+import { Injectable } from '@nestjs/common';
+import { DecisionInteractor } from '../use-cases/decision.interactor';
+import { AuthorizeDecisionInputDTO } from '../dto/authorize-decision-input.dto';
+import { DeclineDecisionInputDTO } from '../dto/decline-decision-input.dto';
+import { TransactionDTO } from '~/application/common/dto/transaction-result-response.dto';
+
+@Injectable()
+export class DecisionService {
+  constructor(private readonly decisionInteractor: DecisionInteractor) {}
+
+  public async authorizeDecision(data: AuthorizeDecisionInputDTO): Promise<TransactionDTO> {
+    const result = await this.decisionInteractor.authorizeDecision(data);
+    return result as TransactionDTO;
+  }
+
+  public async declineDecision(data: DeclineDecisionInputDTO): Promise<TransactionDTO> {
+    const result = await this.decisionInteractor.declineDecision(data);
+    return result as TransactionDTO;
+  }
+}
@@ -0,0 +1,42 @@
+import { Injectable, Inject } from '@nestjs/common';
+import { SOVIET_BLOCKCHAIN_PORT, SovietBlockchainPort } from '~/domain/common/ports/soviet-blockchain.port';
+import { DomainToBlockchainUtils } from '~/shared/utils/domain-to-blockchain.utils';
+import { SovietContract } from 'cooptypes';
+import type { TransactResult } from '@wharfkit/session';
+import { AuthorizeDecisionInputDTO } from '../dto/authorize-decision-input.dto';
+import { DeclineDecisionInputDTO } from '../dto/decline-decision-input.dto';
+
+@Injectable()
+export class DecisionInteractor {
+  constructor(
+    @Inject(SOVIET_BLOCKCHAIN_PORT) private readonly sovietBlockchainPort: SovietBlockchainPort,
+    private readonly domainToBlockchainUtils: DomainToBlockchainUtils
+  ) {}
+
+  async authorizeDecision(data: AuthorizeDecisionInputDTO): Promise<TransactResult> {
+    const authorizeData: SovietContract.Actions.Decisions.Authorize.IAuthorize = {
+      coopname: data.coopname,
+      chairman: data.chairman,
+      decision_id: data.decision_id,
+      document: this.domainToBlockchainUtils.convertSignedDocumentToBlockchainFormat(data.document),
+    };
+
+    const execData: SovietContract.Actions.Decisions.Exec.IExec = {
+      // executer — аудит-метка инициатора; авторизация транзакции идёт ключом кооператива.
+      executer: data.chairman,
+      coopname: data.coopname,
+      decision_id: data.decision_id,
+    };
+
+    return await this.sovietBlockchainPort.authorizeDecision(authorizeData, execData);
+  }
+
+  async declineDecision(data: DeclineDecisionInputDTO): Promise<TransactResult> {
+    const declineData: SovietContract.Actions.Decisions.Declinedec.IDeclineDecision = {
+      coopname: data.coopname,
+      decision_id: data.decision_id,
+    };
+
+    return await this.sovietBlockchainPort.declineDecision(declineData);
+  }
+}
@@ -9,6 +9,12 @@ import { DocumentPackageAggregator } from '~/domain/document/aggregators/documen
 import { DocumentAggregator } from '~/domain/document/aggregators/document.aggregator';
 import type { DocumentAggregateDomainInterface } from '~/domain/document/interfaces/document-domain-aggregate.interface';
 import type { ISignedDocumentDomainInterface } from '~/domain/document/interfaces/signed-document-domain.interface';
+import {
+  SIGNED_DOCUMENT_REPOSITORY,
+  type SignedDocumentRepository,
+} from '~/domain/document/repository/signed-document.repository';
+import { SignedDocumentStatus } from '~/domain/document/enums/signed-document-status.enum';
+import config from '~/config/config';

@Injectable()
 export class DocumentInteractor {
@@ -16,7 +22,8 @@ export class DocumentInteractor {
    @Inject(forwardRef(() => DocumentDomainService)) private readonly documentDomainService: DocumentDomainService,
    @Inject(forwardRef(() => DocumentPackageAggregator))
    private readonly documentPackageAggregator: DocumentPackageAggregator,
-    @Inject(forwardRef(() => DocumentAggregator)) private readonly documentAggregator: DocumentAggregator
+    @Inject(forwardRef(() => DocumentAggregator)) private readonly documentAggregator: DocumentAggregator,
+    @Inject(SIGNED_DOCUMENT_REPOSITORY) private readonly signedDocumentRepository: SignedDocumentRepository
  ) {}

  public async generateDocument(data: GenerateDocumentDomainInterfaceWithOptions): Promise<DocumentDomainEntity> {
@@ -26,52 +33,56 @@ export class DocumentInteractor {
  public async getDocumentsAggregate(
    data: GetDocumentsInputDomainInterface
  ): Promise<PaginationResultDomainInterface<DocumentPackageAggregateDomainInterface>> {
-    const { type = 'newsubmitted', page = 1, limit = 100, query, after_block, before_block, actions } = data;
+    const { type, page = 1, limit = 100, query = {}, after_block, before_block, actions } = data;

-    // Добавляем фильтры по блокам в query
-    const blockFilters: Record<string, unknown> = { ...query };
-    if (after_block !== undefined || before_block !== undefined) {
-      const blockFilter: Record<string, unknown> = {};
-
-      if (after_block !== undefined) {
-        blockFilter.$gte = after_block;
-      }
-      if (before_block !== undefined) {
-        blockFilter.$lte = before_block;
-      }
-
-      blockFilters.block_num = blockFilter;
-    }
-
-    // Добавляем фильтр по массиву действий (data.action)
-    // DocumentAction enum значения автоматически преобразуются в строки
-    if (actions && actions.length > 0) {
-      blockFilters['data.action'] = { $in: actions };
-    }
-
-    const signedDocuments = await this.documentDomainService.getImmutableSignedDocuments({
-      type,
+    // Read-path из PG-реестра подписанных документов (C28-21): отдаём ГОТОВЫЙ агрегат,
+    // собранный на этапе ingestion/backfill — без обращений к explorer/Mongo и без сборки на лету.
+    const result = await this.signedDocumentRepository.findAggregates({
+      coopname: config.coopname,
+      status: this.mapTypeToStatus(type),
+      actions: actions && actions.length > 0 ? (actions as unknown as string[]) : undefined,
+      username: this.extractReceiverScope(query),
+      hash: this.extractHashFilter(query),
+      afterBlock: after_block,
+      beforeBlock: before_block,
      page,
      limit,
-      query: blockFilters,
    });

-    const response: PaginationResultDomainInterface<DocumentPackageAggregateDomainInterface> = {
-      items: [],
-      totalCount: signedDocuments.total,
-      totalPages: Math.ceil(signedDocuments.total / limit),
+    return {
+      items: result.items,
+      totalCount: result.total,
+      totalPages: Math.ceil(result.total / limit) || 0,
      currentPage: page,
    };
+  }

-    for (const raw_action_document of signedDocuments.results) {
-      const documentPackageAggregate = await this.documentPackageAggregator.buildDocumentPackageAggregate(
-        raw_action_document
-      );
+  // Прежний фильтр был по ИМЕНИ действия, не по статусу-партиции:
+  //   «Все входящие» (newsubmitted) — у каждого пакета есть submitted-действие, поэтому это ВСЕ
+  //     документы кооператива (решённые/аннулированные тоже входят) → статус НЕ ограничиваем;
+  //   «Только утверждённые» (newresolved) — лишь решённые → status=Resolved.
+  // (Партиция по статусу скрыла бы решённые документы из вкладки «Все входящие» — регрессия.)
+  private mapTypeToStatus(type?: 'newsubmitted' | 'newresolved'): SignedDocumentStatus | undefined {
+    return type === 'newresolved' ? SignedDocumentStatus.Resolved : undefined;
+  }

-      response.items.push(documentPackageAggregate);
+  // Скоуп выборки повторяет прежний explorer-фильтр `receiver: username` из DocumentService.
+  // Документ soviet через require_recipient уведомляет И кооператив, И пайщика-субъекта, поэтому:
+  //   receiver === coopname → весь кооператив (фильтр только по coopname — как и было);
+  //   receiver === <пайщик> → его документы (колонка username = субъект заявления).
+  private extractReceiverScope(query: Record<string, unknown>): string | undefined {
+    const receiver = query['receiver'];
+    if (typeof receiver === 'string' && receiver.length > 0 && receiver !== config.coopname) {
+      return receiver;
    }
+    return undefined;
+  }

-    return response;
+  // Фильтр по конкретному документу: Union-страница шлёт filter.document.hash (upper-case).
+  private extractHashFilter(query: Record<string, unknown>): string | undefined {
+    const document = query['document'] as Record<string, unknown> | undefined;
+    const hash = (document?.['hash'] ?? query['hash']) as unknown;
+    return typeof hash === 'string' && hash.length > 0 ? hash : undefined;
  }

  /**
@@ -7,6 +7,7 @@ import { DocumentDomainModule } from '~/domain/document/document.module';
 import { GeneratorInfrastructureModule } from '~/infrastructure/generator/generator.module';
 import { UserDomainModule } from '~/domain/user/user-domain.module';
 import { FreeDecisionInteractor } from './interactors/free-decision.interactor';
+import { AgendaModule } from '../agenda/agenda.module';

@Module({
  imports: [
@@ -15,6 +16,7 @@ import { FreeDecisionInteractor } from './interactors/free-decision.interactor';
    DocumentDomainModule,
    GeneratorInfrastructureModule,
    forwardRef(() => UserDomainModule),
+    AgendaModule,
  ],
  controllers: [],
  providers: [FreeDecisionResolver, FreeDecisionService, FreeDecisionInteractor],
@@ -12,6 +12,7 @@ import { CreateProjectFreeDecisionInputDTO } from '../dto/create-project-free-de
 import { FreeDecisionGenerateDocumentInputDTO } from '../../document/documents-dto/free-decision-document.dto';
 import { FreeDecisionService } from '../services/free-decision.service';
 import { GeneratedDocumentDTO } from '~/application/document/dto/generated-document.dto';
+import { AgendaWithDocumentsDTO } from '~/application/agenda/dto/agenda-with-documents.dto';

@Resolver()
 export class FreeDecisionResolver {
@@ -49,16 +50,18 @@ export class FreeDecisionResolver {
    return this.freeDecisionService.generateFreeDecision(data, options);
  }

-  @Mutation(() => Boolean, {
+  @Mutation(() => AgendaWithDocumentsDTO, {
    name: 'publishProjectOfFreeDecision',
-    description: 'Опубликовать предложенную повестку и проект решения для дальнейшего голосования совета по нему',
+    nullable: true,
+    description:
+      'Опубликовать предложенную повестку и проект решения для голосования совета. Возвращает созданный пункт повестки (или null, если он ещё не проиндексирован) для немедленного отображения на фронте.',
  })
  @UseGuards(GqlJwtAuthGuard, RolesGuard)
  @AuthRoles(['chairman', 'member'])
  async publishProjectOfFreeDecision(
    @Args('data', { type: () => PublishProjectFreeDecisionInputDTO })
    data: PublishProjectFreeDecisionInputDTO
-  ): Promise<boolean> {
+  ): Promise<AgendaWithDocumentsDTO | null> {
    return this.freeDecisionService.publishProjectOfFreeDecision(data);
  }

@@ -8,10 +8,25 @@ import type { FreeDecisionGenerateDocumentInputDTO } from '../../document/docume
 import { FreeDecisionInteractor } from '~/application/free-decision/interactors/free-decision.interactor';
 import type { ProjectFreeDecisionGenerateDocumentInputDTO } from '~/application/document/documents-dto/project-free-decision-document.dto';
 import type { GeneratedDocumentDTO } from '~/application/document/dto/generated-document.dto';
+import { AgendaService } from '~/application/agenda/services/agenda.service';
+import type { AgendaWithDocumentsDTO } from '~/application/agenda/dto/agenda-with-documents.dto';
+
+// Повестка собирается join'ом таблицы decisions из блокчейна (доступна сразу)
+// с проиндексированными парсером действием newsubmitted и документом-заявлением.
+// Решение появляется на чейне мгновенно, но индексация парсером action'а занимает
+// ~2 c — поэтому опрашиваем повестку короткими тиками, пока вопрос не соберётся,
+// и возвращаем его фронту немедленно (без ожидания общего поллинга страницы).
+const PUBLISH_FETCH_DELAY_MS = 400;
+const PUBLISH_FETCH_ATTEMPTS = 13; // ~5 c суммарно — запас над типичными ~2 c
+
+const sleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));

@Injectable()
 export class FreeDecisionService {
-  constructor(private readonly freeDecisionInteractor: FreeDecisionInteractor) {}
+  constructor(
+    private readonly freeDecisionInteractor: FreeDecisionInteractor,
+    private readonly agendaService: AgendaService
+  ) {}

  public async generateProjectOfFreeDecision(
    data: ProjectFreeDecisionGenerateDocumentInputDTO,
@@ -31,9 +46,26 @@ export class FreeDecisionService {
    return document as unknown as GeneratedDocumentDTO;
  }

-  public async publishProjectOfFreeDecision(data: PublishProjectFreeDecisionInputDTO): Promise<boolean> {
-    const selected = await this.freeDecisionInteractor.publishProjectOfFreeDecision(data);
-    return selected;
+  public async publishProjectOfFreeDecision(
+    data: PublishProjectFreeDecisionInputDTO
+  ): Promise<AgendaWithDocumentsDTO | null> {
+    await this.freeDecisionInteractor.publishProjectOfFreeDecision(data);
+
+    // decision.hash в блокчейне == «общий хэш» подписанного заявления (hash =
+    // doc_hash + meta_hash), НЕ doc_hash (хэш только содержимого) — их легко
+    // перепутать, и матч по doc_hash молча никогда не сработает.
+    const hash = data.document.hash;
+
+    let item: AgendaWithDocumentsDTO | null = null;
+    for (let attempt = 0; attempt < PUBLISH_FETCH_ATTEMPTS; attempt++) {
+      item = await this.agendaService.getAgendaItemByHash(hash);
+      if (item) break;
+      await sleep(PUBLISH_FETCH_DELAY_MS);
+    }
+
+    // null допустим: если парсер не успел проиндексировать — фронт покажет вопрос
+    // на ближайшем тике поллинга (деградация, не ошибка).
+    return item;
  }

  public async createProjectOfFreeDecision(data: CreateProjectFreeDecisionInputDTO): Promise<CreatedProjectFreeDecisionDTO> {
@@ -8,4 +8,10 @@ export class SetPaymentStatusInputDTO {

  @Field(() => PaymentStatusEnum, { description: 'Новый статус платежа' })
  status!: PaymentStatusEnum;
+
+  @Field(() => String, {
+    description: 'Причина изменения статуса. При отклонении платежа показывается пайщику как причина отказа.',
+    nullable: true,
+  })
+  message?: string;
 }
@@ -113,6 +113,15 @@ export class GatewayInteractor {
        throw new NotFoundException(`Не удалось найти платеж с ID ${data.id}`);
      }

+      // Сохраняем причину изменения статуса (например, причину отклонения платежа),
+      // чтобы пайщик увидел её на странице регистрации даже после перезагрузки/в другой вкладке.
+      if (data.message !== undefined && result.id) {
+        const updated = await this.paymentRepository.update(result.id, { message: data.message });
+        if (updated) {
+          result.message = updated.message;
+        }
+      }
+
      // Обрабатываем платеж при статусе PAID
      if (statusEnum === PaymentStatusEnum.PAID) {
        if (result.direction === PaymentDirectionEnum.INCOMING) {
@@ -17,7 +17,4 @@ export class Ledger2WalletDTO {

  @Field(() => String, { description: 'Доступный баланс' })
  available!: string;
-
-  @Field(() => String, { description: 'Заблокированный баланс' })
-  blocked!: string;
 }
@@ -15,6 +15,7 @@ import { userStatus } from '~/types/user.types';
 import { HttpApiError } from '~/utils/httpApiError';
 import { normalizeUserEmail } from '~/utils/normalize-user-email';
 import { sha256 } from '~/utils/sha256';
+import { registrationProfileFingerprint } from '~/utils/registration-profile-fingerprint';
 import http from 'http-status';
 import { PublicKey, Signature } from '@wharfkit/antelope';
 import { ISignedDocumentDomainInterface } from '~/domain/document/interfaces/signed-document-domain.interface';
@@ -224,9 +225,27 @@ export class ParticipantInteractor {
      }
    }

+    // Гард A (замок профиля): фиксируем каноничный отпечаток удостоверяющих
+    // данных, под которыми подписано заявление. Перед регистрацией в блокчейне
+    // он сверяется — если профиль изменят после подписи и не переподпишут
+    // заявление, на цепь данные не уйдут. См. registerBlockchainAccount.
+    const signedAccount = await this.accountDomainService.getAccount(data.username);
+    const profileFingerprint = registrationProfileFingerprint(signedAccount?.private_account);
+
+    let candidateMeta: Record<string, any> = {};
+    try {
+      candidateMeta = candidate.meta ? JSON.parse(candidate.meta) : {};
+    } catch {
+      candidateMeta = {};
+    }
+    if (profileFingerprint) {
+      candidateMeta.registration_profile_fingerprint = profileFingerprint;
+    }
+
    await this.candidateRepository.update(data.username, {
      braname: data.braname,
      program_key: data.program_key,
+      meta: JSON.stringify(candidateMeta),
    });

    // Обновляем статус пользователя
@@ -11,9 +11,4 @@ export class BankAccountDetailsInputDTO {
  @IsNotEmpty({ message: 'Корр. счет обязателен' })
  @IsString()
  corr!: string;
-
-  @Field(() => String, { description: 'КПП банка' })
-  @IsNotEmpty({ message: 'КПП обязателен' })
-  @IsString()
-  kpp!: string;
 }
@@ -12,14 +12,8 @@ export class BankAccountDetailsDTO {
  @IsString()
  corr: string;

-  @Field(() => String, { description: 'КПП банка' })
-  @IsNotEmpty({ message: 'КПП обязателен' })
-  @IsString()
-  kpp: string;
-
-  constructor(details: { bik: string; corr: string; kpp: string }) {
+  constructor(details: { bik: string; corr: string }) {
    this.bik = details.bik;
    this.corr = details.corr;
-    this.kpp = details.kpp;
  }
 }
@@ -11,6 +11,9 @@ export class SearchResultDTO {
  @Field(() => String, { description: 'Имя пользователя' })
  username!: string;

+  @Field(() => String, { description: 'ФИО подписанта документа' })
+  signer!: string;
+
  @Field(() => String, { description: 'Кооператив' })
  coopname!: string;

@@ -1,24 +1,50 @@
 import { Resolver, Query, Args } from '@nestjs/graphql';
-import { UseGuards } from '@nestjs/common';
+import { Inject, UseGuards } from '@nestjs/common';
 import { SearchResultDTO } from '../dto/search-result.dto';
 import { SearchDocumentsInputDTO } from '../dto/search-input.dto';
-import { DocumentSearchService } from '~/infrastructure/search/opensearch.service';
+import {
+  SIGNED_DOCUMENT_REPOSITORY,
+  type SignedDocumentRepository,
+} from '~/domain/document/repository/signed-document.repository';
 import { GqlJwtAuthGuard } from '~/application/auth/guards/graphql-jwt-auth.guard';
+import { CurrentUser } from '~/application/auth/decorators/current-user.decorator';
+import type { MonoAccountDomainInterface } from '~/domain/account/interfaces/mono-account-domain.interface';
 import config from '~/config/config';

+// Роли членов совета — им доступен поиск по всему документообороту кооператива.
+const COUNCIL_ROLES = ['chairman', 'member'];
+
@Resolver()
 export class SearchResolver {
-  constructor(private readonly documentSearch: DocumentSearchService) {}
+  constructor(
+    @Inject(SIGNED_DOCUMENT_REPOSITORY) private readonly signedDocuments: SignedDocumentRepository
+  ) {}

+  // Поиск по документам кооператива. Член совета (chairman/member) ищет по всему кооперативу;
+  // обычный пайщик — ТОЛЬКО по своим документам (скоуп по username), чтобы не видеть чужие.
  @Query(() => [SearchResultDTO], { description: 'Полнотекстовый поиск по документам кооператива' })
  @UseGuards(GqlJwtAuthGuard)
  async searchDocuments(
    @Args('data') input: SearchDocumentsInputDTO,
+    @CurrentUser() user: MonoAccountDomainInterface
  ): Promise<SearchResultDTO[]> {
-    if (!this.documentSearch.isAvailable()) {
-      return [];
-    }
+    const isCouncil = COUNCIL_ROLES.includes(user?.role);
+    const hits = await this.signedDocuments.search({
+      coopname: config.coopname,
+      query: input.query,
+      limit: input.limit || 20,
+      username: isCouncil ? undefined : user.username,
+    });

-    return this.documentSearch.search(input.query, config.coopname, input.limit || 20);
+    return hits.map((hit) => ({
+      hash: hit.hash,
+      full_title: hit.full_title,
+      username: hit.username,
+      signer: hit.signer,
+      coopname: hit.coopname,
+      registry_id: hit.registry_id,
+      created_at: hit.created_at ?? undefined,
+      highlights: hit.highlights,
+    }));
  }
 }
@@ -1,10 +1,12 @@
 import { Module } from '@nestjs/common';
 import { SearchResolver } from './resolvers/search.resolver';
-import { SearchEventService } from './services/search-event.service';
-import { DocumentModule } from '~/application/document/document.module';

+/**
+ * Поиск по документам кооператива (C28-21).
+ * searchDocuments читает PG-реестр подписанных документов через SIGNED_DOCUMENT_REPOSITORY
+ * (глобальный TypeOrmModule). OpenSearch и его индексатор удалены.
+ */
@Module({
-  imports: [DocumentModule],
-  providers: [SearchResolver, SearchEventService],
+  providers: [SearchResolver],
 })
 export class SearchModule {}
@@ -1,131 +0,0 @@
-import { Injectable, Logger, OnModuleInit } from '@nestjs/common';
-import { OnEvent } from '@nestjs/event-emitter';
-import { SovietContract } from 'cooptypes';
-import { DocumentSearchService } from '~/infrastructure/search/opensearch.service';
-import { GeneratorInfrastructureService } from '~/infrastructure/generator/generator.service';
-import { DocumentInteractor } from '~/application/document/interactors/document.interactor';
-import type { IAction } from '~/types/common';
-
-/**
- * Сервис индексации документов по событию blockchain.
- * Слушает action::soviet::newsubmitted — подписанные и принятые документы.
- */
-@Injectable()
-export class SearchEventService implements OnModuleInit {
-  private readonly logger = new Logger(SearchEventService.name);
-
-  constructor(
-    private readonly documentSearch: DocumentSearchService,
-    private readonly generatorService: GeneratorInfrastructureService,
-    private readonly documentInteractor: DocumentInteractor,
-  ) {}
-
-  async onModuleInit() {
-    if (this.documentSearch.isAvailable()) {
-      // Запускаем асинхронную ре-индексацию при старте
-      this.reindexAllDocuments().catch((err) => {
-        this.logger.error(`Ошибка при фоновой ре-индексации: ${err.message}`);
-      });
-    }
-  }
-
-  /**
-   * Метод полной ре-индексации только документов типа newsubmitted из блокчейна.
-   * Собирает агрегаты для получения полного содержимого документа.
-   */
-  async reindexAllDocuments(): Promise<void> {
-    this.logger.log('Начало полной ре-индексации документов (newsubmitted)...');
-    let totalIndexed = 0;
-    let currentPage = 1;
-    const limit = 100;
-
-    try {
-      while (true) {
-        const result = await this.documentInteractor.getDocumentsAggregate({
-          type: 'newsubmitted',
-          page: currentPage,
-          limit,
-          query: {}, // Обязательное поле согласно GetDocumentsInputDomainInterface
-        });
-
-        if (!result.items || result.items.length === 0) {
-          break;
-        }
-
-        for (const packageAggregate of result.items) {
-          // В пакете может быть заявление, решение и акты. Индексируем всё, что есть.
-          const aggregatesToindex = [
-            packageAggregate.statement?.documentAggregate,
-            packageAggregate.decision?.documentAggregate,
-            ...packageAggregate.acts.map(act => act.documentAggregate),
-            ...packageAggregate.links
-          ].filter(Boolean);
-
-          for (const aggregate of aggregatesToindex) {
-            const doc = aggregate?.rawDocument;
-            const signedDoc = aggregate?.document;
-
-            if (!doc || !signedDoc) continue;
-
-            try {
-              await this.documentSearch.indexDocument({
-                hash: doc.hash,
-                full_title: doc.full_title || '',
-                html: doc.html || '',
-                username: doc.meta?.username || signedDoc.meta?.username || '',
-                coopname: doc.meta?.coopname || signedDoc.meta?.coopname || '',
-                registry_id: doc.meta?.registry_id || signedDoc.meta?.registry_id || 0,
-                created_at: doc.meta?.created_at || signedDoc.meta?.created_at || '',
-              });
-              totalIndexed++;
-            } catch (docError: any) {
-              this.logger.warn(`Ошибка индексации документа ${doc.hash}: ${docError.message}`);
-            }
-          }
-        }
-
-        if (currentPage >= result.totalPages) {
-          break;
-        }
-        currentPage++;
-      }
-
-      this.logger.log(`Ре-индексация завершена. Проиндексировано документов: ${totalIndexed}`);
-    } catch (error: any) {
-      this.logger.error(`Ошибка при ре-индексации документов: ${error.message}`);
-    }
-  }
-
-  @OnEvent(`action::${SovietContract.contractName.production}::${SovietContract.Actions.Registry.NewSubmitted.actionName}`)
-  async onDocumentSubmitted(action: IAction): Promise<void> {
-    if (!this.documentSearch.isAvailable()) return;
-
-    try {
-      const docHash = action.data?.document?.hash;
-      if (!docHash) {
-        this.logger.debug('Событие newsubmitted без хеша документа, пропускаем');
-        return;
-      }
-
-      const document = await this.generatorService.getDocument({ hash: docHash });
-      if (!document) {
-        this.logger.debug(`Документ ${docHash.substring(0, 8)} не найден в MongoDB`);
-        return;
-      }
-
-      await this.documentSearch.indexDocument({
-        hash: document.hash,
-        full_title: document.full_title || '',
-        html: document.html || '',
-        username: document.meta?.username || action.data?.username || '',
-        coopname: document.meta?.coopname || action.data?.coopname || '',
-        registry_id: document.meta?.registry_id || 0,
-        created_at: document.meta?.created_at || '',
-      });
-
-      this.logger.log(`Документ проиндексирован: ${document.full_title?.substring(0, 50)}`);
-    } catch (error: any) {
-      this.logger.warn(`Ошибка индексации документа по событию newsubmitted: ${error?.message}`);
-    }
-  }
-}
@@ -0,0 +1,125 @@
+import { Inject, Injectable, Logger, OnApplicationBootstrap } from '@nestjs/common';
+import { DocumentDomainService } from '~/domain/document/services/document-domain.service';
+import {
+  SIGNED_DOCUMENT_REPOSITORY,
+  type SignedDocumentRepository,
+} from '~/domain/document/repository/signed-document.repository';
+import { SignedDocumentStatus } from '~/domain/document/enums/signed-document-status.enum';
+import { SignedDocumentIngestionService } from './signed-document-ingestion.service';
+import config from '~/config/config';
+import type { IAction } from '~/types/common';
+
+export interface BackfillStats {
+  scanned: number;
+  created: number;
+  updated: number;
+  skipped: number;
+}
+
+interface BackfillPass {
+  type: string;
+  status: SignedDocumentStatus;
+}
+
+// Порядок важен: сперва базовые записи (submitted/resolved), затем смена статусов поверх.
+const PASSES: BackfillPass[] = [
+  { type: 'newsubmitted', status: SignedDocumentStatus.Submitted },
+  { type: 'newresolved', status: SignedDocumentStatus.Resolved },
+  // newdeclined пока не приходит как registry-action (см. C28-21); пройдёт пустым — это безопасно.
+  { type: 'newdeclined', status: SignedDocumentStatus.Declined },
+];
+
+const PAGE_LIMIT = 100;
+
+/**
+ * Разовый backfill реестра подписанных документов (C28-21).
+ *
+ * Сканирует все действия soviet (newsubmitted/newresolved/newdeclined) через explorer-источник,
+ * для каждого достаёт документ из factory-Mongo и складывает в Postgres-проекцию.
+ * Идемпотентен по (coopname, doc_hash) — повторный прогон безопасен (package НЕ уникален:
+ * в одном процессе несколько разных документов, поэтому ключ записи — doc_hash).
+ *
+ * Запуск автоматически ОДИН РАЗ при первом старте с этой фичей: если реестр по кооперативу пуст —
+ * затягиваем всю историю. Принудительный повторный прогон — флагом `SIGNED_DOCS_BACKFILL_ON_BOOT=true`.
+ * Выполняется детачем в onApplicationBootstrap (после инициализации всех модулей — генератор уже
+ * подключён к Mongo), чтобы не блокировать старт. Метод `run()` пригоден и для отдельного CLI.
+ */
+@Injectable()
+export class SignedDocumentBackfillService implements OnApplicationBootstrap {
+  private readonly logger = new Logger(SignedDocumentBackfillService.name);
+
+  constructor(
+    private readonly documentDomainService: DocumentDomainService,
+    private readonly ingestion: SignedDocumentIngestionService,
+    @Inject(SIGNED_DOCUMENT_REPOSITORY) private readonly repository: SignedDocumentRepository
+  ) {}
+
+  onApplicationBootstrap(): void {
+    // Детачем: не блокируем старт приложения долгим сканом истории.
+    this.maybeRunOnBoot().catch((error) => {
+      this.logger.error(`Ошибка фонового backfill реестра: ${error?.message}`);
+    });
+  }
+
+  private async maybeRunOnBoot(): Promise<void> {
+    const forced = process.env.SIGNED_DOCS_BACKFILL_ON_BOOT === 'true';
+    if (!forced) {
+      const existing = await this.repository.count(config.coopname);
+      if (existing > 0) {
+        this.logger.log(`Реестр подписанных документов не пуст (${existing}) — авто-backfill пропущен.`);
+        return;
+      }
+    }
+    await this.run();
+  }
+
+  async run(): Promise<BackfillStats> {
+    const stats: BackfillStats = { scanned: 0, created: 0, updated: 0, skipped: 0 };
+    this.logger.log('Старт backfill реестра подписанных документов...');
+
+    for (const pass of PASSES) {
+      await this.runPass(pass, stats);
+    }
+
+    this.logger.log(
+      `Backfill завершён. scanned=${stats.scanned} created=${stats.created} updated=${stats.updated} skipped=${stats.skipped}`
+    );
+    return stats;
+  }
+
+  private async runPass(pass: BackfillPass, stats: BackfillStats): Promise<void> {
+    let page = 1;
+
+    while (true) {
+      // Скоуп ровно как у прежнего chairman-пути getDocuments: {name: type, receiver: coopname}.
+      // Без receiver explorer вернул бы все трейсы каждого действия (receiver=soviet/пайщик) и,
+      // возможно, другие кооперативы — лишняя обработка и чужие данные. receiver=coopname даёт
+      // один трейс на документ и только наш кооператив (coopname — всегда получатель soviet-документа).
+      const response = await this.documentDomainService.getImmutableSignedDocuments({
+        type: pass.type,
+        query: { receiver: config.coopname },
+        page,
+        limit: PAGE_LIMIT,
+      });
+
+      const results = (response?.results ?? []) as unknown as IAction[];
+      if (results.length === 0) break;
+
+      for (const action of results) {
+        stats.scanned++;
+        try {
+          const result = await this.ingestion.ingestAction(action, pass.status);
+          stats[result === 'created' ? 'created' : result === 'updated' ? 'updated' : 'skipped']++;
+        } catch (error: any) {
+          // Одна битая запись (напр. не-парсибельная дата у legacy-документа) не должна ронять
+          // весь прогон backfill — логируем и идём дальше.
+          stats.skipped++;
+          this.logger.warn(`Пропущен документ при backfill (${pass.type}): ${error?.message}`);
+        }
+      }
+
+      if (results.length < PAGE_LIMIT) break;
+      page++;
+    }
+  }
+}
@@ -0,0 +1,291 @@
+import { Inject, Injectable, Logger } from '@nestjs/common';
+import { OnEvent } from '@nestjs/event-emitter';
+import { Cooperative, SovietContract } from 'cooptypes';
+import { DocumentPackageAggregator } from '~/domain/document/aggregators/document-package.aggregator';
+import {
+  SIGNED_DOCUMENT_REPOSITORY,
+  type SignedDocumentPackageRow,
+  type SignedDocumentRepository,
+} from '~/domain/document/repository/signed-document.repository';
+import { SignedDocumentStatus } from '~/domain/document/enums/signed-document-status.enum';
+import type { DocumentPackageAggregateDomainInterface } from '~/domain/document/interfaces/document-package-aggregate-domain.interface';
+import config from '~/config/config';
+import type { IAction } from '~/types/common';
+import moment from 'moment-timezone';
+
+const SOVIET = SovietContract.contractName.production;
+const Registry = SovietContract.Actions.Registry;
+
+export type IngestResult = 'created' | 'updated' | 'skipped';
+
+/**
+ * Наполнение реестра подписанных документов (Postgres-проекция, C28-21).
+ *
+ * Источник — внутренняя событийная шина (EventEmitter2): парсер ретранслирует blockchain-события
+ * контракта soviet как `action::soviet::*`. На каждое релевантное событие собирается ГОТОВЫЙ агрегат
+ * пакета (DocumentPackageAggregator) и кладётся в PG целиком — чтобы getDocuments/поиск работали
+ * из Postgres без сборки на лету. Парсер не трогаем (parser1→parser2 прозрачно для подписчика).
+ *
+ * - newsubmitted/newresolved/newdeclined — несут заявление: пересобираем агрегат + ставим статус;
+ * - newdecision/newact/newlink — досборка: пересобираем агрегат по сохранённому действию-носителю,
+ *   статус не меняем.
+ */
+@Injectable()
+export class SignedDocumentIngestionService {
+  private readonly logger = new Logger(SignedDocumentIngestionService.name);
+
+  constructor(
+    @Inject(SIGNED_DOCUMENT_REPOSITORY) private readonly repository: SignedDocumentRepository,
+    private readonly aggregator: DocumentPackageAggregator
+  ) {}
+
+  @OnEvent(`action::${SOVIET}::${Registry.NewSubmitted.actionName}`)
+  async onNewSubmitted(action: IAction): Promise<void> {
+    await this.safeStatusEvent(action, SignedDocumentStatus.Submitted, Registry.NewSubmitted.actionName);
+  }
+
+  @OnEvent(`action::${SOVIET}::${Registry.NewResolved.actionName}`)
+  async onNewResolved(action: IAction): Promise<void> {
+    await this.safeStatusEvent(action, SignedDocumentStatus.Resolved, Registry.NewResolved.actionName);
+  }
+
+  @OnEvent(`action::${SOVIET}::${Registry.NewDeclined.actionName}`)
+  async onNewDeclined(action: IAction): Promise<void> {
+    await this.safeStatusEvent(action, SignedDocumentStatus.Declined, Registry.NewDeclined.actionName);
+  }
+
+  @OnEvent(`action::${SOVIET}::${Registry.NewDecision.actionName}`)
+  async onNewDecision(action: IAction): Promise<void> {
+    await this.safeReassemble(action, Registry.NewDecision.actionName);
+  }
+
+  @OnEvent(`action::${SOVIET}::${Registry.NewAct.actionName}`)
+  async onNewAct(action: IAction): Promise<void> {
+    await this.safeReassemble(action, Registry.NewAct.actionName);
+  }
+
+  @OnEvent(`action::${SOVIET}::${Registry.NewLink.actionName}`)
+  async onNewLink(action: IAction): Promise<void> {
+    await this.safeReassemble(action, Registry.NewLink.actionName);
+  }
+
+  /**
+   * Идемпотентно записывает действие-носитель заявления в реестр.
+   * Используется и листенерами шины, и backfill'ом.
+   */
+  async ingestAction(action: IAction, status: SignedDocumentStatus): Promise<IngestResult> {
+    const data = (action?.data ?? {}) as Record<string, any>;
+    // Ключ записи — doc_hash (идентичность документа). hash включает подписи, поэтому у одного
+    // документа бывает несколько hash (версии по мере накопления подписей — напр. акт приёма-передачи:
+    // первая/вторая подпись дают разные hash при одном doc_hash). Держим КРАЙНЮЮ версию по номеру блока,
+    // иначе документ задвоился бы в списке. package НЕ ключ: в одном процессе бывает несколько разных
+    // документов с разными подписантами (обмен в marketplace).
+    const docHash: string | undefined = data.document?.doc_hash;
+    if (!docHash) return 'skipped';
+    const hash: string = data.document?.hash || '';
+    const packageHash: string = data.package || '';
+    const coopname: string = data.coopname || config.coopname;
+    const incomingBlock = this.toBlockNum(action?.block_num);
+
+    const existing = await this.repository.getState(coopname, docHash);
+    if (existing) {
+      // Не понижаем статус: submitted не перетирает resolved/declined.
+      if (status === SignedDocumentStatus.Submitted && existing.status !== SignedDocumentStatus.Submitted) {
+        return 'skipped';
+      }
+      // Не откатываем на более старую версию подписи (меньший номер блока).
+      if (incomingBlock !== null && existing.blockNum !== null && incomingBlock < existing.blockNum) {
+        return 'skipped';
+      }
+      // Идемпотентность: тот же статус и не новее по блоку — обновлять нечего (повторный backfill безопасен).
+      if (
+        existing.status === status &&
+        (incomingBlock === null || existing.blockNum === null || incomingBlock <= existing.blockNum)
+      ) {
+        return 'skipped';
+      }
+    }
+
+    await this.assembleAndUpsert(action, status, coopname, docHash, hash, packageHash);
+    return existing ? 'updated' : 'created';
+  }
+
+  private toBlockNum(value: unknown): number | null {
+    if (value === undefined || value === null) return null;
+    const n = Number(value);
+    return Number.isFinite(n) ? n : null;
+  }
+
+  private async safeStatusEvent(action: IAction, status: SignedDocumentStatus, label: string): Promise<void> {
+    try {
+      const result = await this.ingestAction(action, status);
+      if (result !== 'skipped') {
+        this.logger.log(`[${label}] запись реестра ${result}: package=${this.shortPackage(action)}`);
+      }
+    } catch (error: any) {
+      this.logger.warn(`Ошибка ingestion события ${label}: ${error?.message}`);
+    }
+  }
+
+  private async safeReassemble(action: IAction, label: string): Promise<void> {
+    try {
+      const data = (action?.data ?? {}) as Record<string, any>;
+      const packageHash: string | undefined = data.package;
+      if (!packageHash) return;
+
+      const coopname: string = data.coopname || config.coopname;
+      // decision/act/link относятся к процессу (package), а не к конкретному заявлению.
+      // Пересобираем агрегаты ВСЕХ заявлений пакета (их может быть несколько с разными
+      // подписантами), сохраняя статус каждого.
+      const rows = await this.repository.findByPackage(coopname, packageHash);
+      if (rows.length === 0) return; // заявлений по пакету ещё нет — нечего дособирать
+
+      let rebuilt = 0;
+      for (const row of rows) {
+        if (await this.reassembleRow(row, coopname)) rebuilt++;
+      }
+      if (rebuilt > 0) {
+        this.logger.log(`[${label}] пересобрано агрегатов: ${rebuilt}, package=${this.shortPackage(action)}`);
+      }
+    } catch (error: any) {
+      this.logger.warn(`Ошибка пересборки агрегата по событию ${label}: ${error?.message}`);
+    }
+  }
+
+  /**
+   * Пересобирает агрегат ОДНОЙ записи пакета по её сохранённому действию-носителю и обновляет
+   * ТОЛЬКО агрегат-производные колонки. Статус/версию/source НЕ трогаем — ими владеют статус-события
+   * (иначе пересборка, конкурентная с newresolved, откатила бы resolved→submitted). Если агрегат не
+   * собрался (null) — запись не портим, оставляем прежний агрегат.
+   */
+  private async reassembleRow(row: SignedDocumentPackageRow, coopname: string): Promise<boolean> {
+    if (!row.sourceActionData) return false;
+    const aggregate = await this.buildAggregateSafe(row.sourceActionData as unknown as IAction);
+    if (!aggregate) return false;
+    const rawDoc = aggregate.statement?.documentAggregate?.rawDocument;
+    await this.repository.updateAggregate(coopname, row.doc_hash, {
+      document_aggregate: aggregate,
+      full_title: rawDoc?.full_title || '',
+      content_text: this.stripHtml(rawDoc?.html || ''),
+      signers_text: this.collectSignersText(aggregate),
+    });
+    return true;
+  }
+
+  private async assembleAndUpsert(
+    sourceAction: IAction,
+    status: SignedDocumentStatus,
+    coopname: string,
+    docHash: string,
+    hash: string,
+    packageHash: string
+  ): Promise<void> {
+    const aggregate = await this.buildAggregateSafe(sourceAction);
+    const data = (sourceAction?.data ?? {}) as Record<string, any>;
+    const statement = aggregate?.statement;
+    const rawDoc = statement?.documentAggregate?.rawDocument;
+    const meta = (rawDoc?.meta ?? {}) as Record<string, any>;
+
+    await this.repository.upsert({
+      coopname,
+      packageHash,
+      doc_hash: docHash,
+      hash,
+      username: meta.username || data.username || '',
+      status,
+      action: data.action || '',
+      registry_id: typeof meta.registry_id === 'number' ? meta.registry_id : 0,
+      full_title: rawDoc?.full_title || '',
+      content_text: this.stripHtml(rawDoc?.html || ''),
+      signers_text: this.collectSignersText(aggregate),
+      block_num: this.resolveBlockNum(sourceAction?.block_num, meta.block_num),
+      document_created_at: this.parseDocumentDate(meta.created_at, meta.timezone),
+      document_aggregate: aggregate,
+      source_action_data: sourceAction as unknown as Record<string, unknown>,
+    });
+  }
+
+  private async buildAggregateSafe(action: IAction): Promise<DocumentPackageAggregateDomainInterface | null> {
+    try {
+      return await this.aggregator.buildDocumentPackageAggregate(action as unknown as Cooperative.Blockchain.IAction);
+    } catch (error: any) {
+      this.logger.debug(`Не удалось собрать агрегат пакета: ${error?.message}`);
+      return null;
+    }
+  }
+
+  /**
+   * Собирает ФИО/наименования всех подписантов пакета из signer_certificate всех частей агрегата
+   * (заявление/решение/акты/связанные). Это и есть основной индекс поиска по подписанту —
+   * соподписанты (председатель/совет) подписывают решение и акты, а не тело заявления,
+   * поэтому content_text их не покрывает. Username добавляется тоже (редкий поиск по нему).
+   */
+  private collectSignersText(aggregate: DocumentPackageAggregateDomainInterface | null): string {
+    if (!aggregate) return '';
+
+    const docAggregates = [
+      aggregate.statement?.documentAggregate,
+      aggregate.decision?.documentAggregate,
+      ...aggregate.acts.map((act) => act?.documentAggregate),
+      ...aggregate.links,
+    ];
+
+    const parts = new Set<string>();
+    for (const da of docAggregates) {
+      const signatures = da?.document?.signatures ?? [];
+      for (const sig of signatures) {
+        if (sig?.signer) parts.add(String(sig.signer));
+        const cert = sig?.signer_certificate as Record<string, any> | null | undefined;
+        if (!cert) continue;
+        for (const key of ['last_name', 'first_name', 'middle_name', 'short_name']) {
+          if (cert[key]) parts.add(String(cert[key]));
+        }
+      }
+    }
+
+    return Array.from(parts).join(' ');
+  }
+
+  private shortPackage(action: IAction): string {
+    const pkg = (action?.data as Record<string, any>)?.package;
+    return typeof pkg === 'string' ? pkg.substring(0, 8) : '?';
+  }
+
+  /**
+   * Номер блока для колонки block_num — ось упорядочивания ВЕРСИЙ подписи одного doc_hash.
+   * Это блок ON-CHAIN ДЕЙСТВИЯ (action.block_num), а НЕ блок генерации документа (meta.block_num):
+   * guard'ы в ingestAction сравнивают пришедший action.block_num с хранимым block_num, поэтому обе
+   * стороны должны мерить одну величину. Иначе (meta.block_num — блок генерации, всегда ≤ блока
+   * подачи в цепь) защита от отката на старую версию и идемпотентность по блоку не срабатывают.
+   * meta.block_num — только запасной вариант, если у действия нет block_num.
+   */
+  private resolveBlockNum(actionBlockNum: unknown, metaBlockNum: unknown): string | null {
+    if (actionBlockNum !== undefined && actionBlockNum !== null) return String(actionBlockNum);
+    if (metaBlockNum !== undefined && metaBlockNum !== null) return String(metaBlockNum);
+    return null;
+  }
+
+  /**
+   * Парсит meta.created_at в Date для колонки timestamptz. Документы хранят дату в
+   * ЛОКАЛИЗОВАННОМ формате `DD.MM.YYYY HH:mm` + отдельное поле meta.timezone — именно так её
+   * пишет фабрика @coopenomics/factory (Generator.updateMetadata через moment.tz). Нативный
+   * `new Date(meta.created_at)` этот формат НЕ понимает и даёт Invalid Date → pg-драйвер пишет
+   * в timestamptz "0NaN-NaN-NaN…" и вся вставка падает. Парсим тем же moment.tz, что и фабрика;
+   * timezone берём из меты, иначе — из конфига кооператива. Невалидное/пустое значение → null
+   * (одна битая дата не должна ронять запись и весь backfill).
+   */
+  private parseDocumentDate(createdAt: unknown, timezone: unknown): Date | null {
+    if (!createdAt || typeof createdAt !== 'string') return null;
+    const tz = typeof timezone === 'string' && timezone ? timezone : config.timezone;
+    const parsed = moment.tz(createdAt, 'DD.MM.YYYY HH:mm', tz);
+    return parsed.isValid() ? parsed.toDate() : null;
+  }
+
+  private stripHtml(html: string): string {
+    return html
+      .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '')
+      .replace(/<[^>]+>/g, ' ')
+      .replace(/\s+/g, ' ')
+      .trim();
+  }
+}
@@ -0,0 +1,20 @@
+import { Module } from '@nestjs/common';
+import { DocumentDomainModule } from '~/domain/document/document.module';
+import { SignedDocumentIngestionService } from './services/signed-document-ingestion.service';
+import { SignedDocumentBackfillService } from './services/signed-document-backfill.service';
+
+/**
+ * Реестр подписанных документов в Postgres (C28-21).
+ *
+ * Ingestion-листенер ловит blockchain-события soviet с внутренней шины и наполняет PG-проекцию;
+ * backfill — разовый перенос истории. Репозиторий (SIGNED_DOCUMENT_REPOSITORY) и генератор
+ * предоставляются глобальными модулями (TypeOrmModule / GeneratorInfrastructureModule).
+ *
+ * Это единый источник для getDocuments (read-path) и searchDocuments — OpenSearch удалён.
+ */
+@Module({
+  imports: [DocumentDomainModule],
+  providers: [SignedDocumentIngestionService, SignedDocumentBackfillService],
+  exports: [SignedDocumentIngestionService, SignedDocumentBackfillService],
+})
+export class SignedDocumentsModule {}
@@ -133,11 +133,30 @@ export class InstallInteractor {

    if (!coop) throw new BadRequestException('Информация о кооперативе не обнаружена');

+    // ВНИМАНИЕ про лок установки: статус НЕ трогаем здесь, до цикла. Раньше тут
+    // стоял setStatus(maintenance), но 'maintenance' на фронте включает
+    // полноэкранную заглушку «Техническое обслуживание» (watch-desktop-health),
+    // которая накрыла бы саму страницу установки во время нормального прогона.
+    // Поэтому статус остаётся 'initialized' на всё время установки (фронт
+    // показывает страницу install, как и прежде), а в 'maintenance' переводим
+    // ТОЛЬКО в catch при падении ПОСЛЕ записи в цепь — это блокирует повторный
+    // запуск install (guard выше требует 'initialized') и корректно сигналит,
+    // что коопа в полу-установленном состоянии и требует ручного разбора.
+    // Так на gorozhane (fgrtejiwnynn) образовались дубли: install падал после
+    // adduser, статус оставался 'initialized', повторный запуск проходил guard
+    // и заново минтил аккаунты совета (инцидент 2026-06-04).
+
    const users = [] as UserDomainEntity[];
    const members = [] as any;
    const sovietExt = [] as any;
    const soviet = data.soviet;

+    // Флаг необратимого следа: стал true после первой успешной on-chain
+    // регистрации (adduser). On-chain операции откатить нельзя, поэтому при
+    // ошибке ПОСЛЕ этого момента off-chain rollback НЕ делаем — иначе теряется
+    // привязка личность↔username, нужная для последующей сверки/очистки.
+    let chainWriteHappened = false;
+
    try {
      for (const member of soviet) {
        const username = generateUsername();
@@ -157,6 +176,8 @@ export class InstallInteractor {
        };

        await this.blockchainPort.addUser(addUser);
+        // С этого момента на цепи есть необратимый аккаунт + оплаченный паевой.
+        chainWriteHappened = true;

        const createUser: CreateUserInputDomainInterface = {
          email: member.individual_data.email,
@@ -242,11 +263,32 @@ export class InstallInteractor {
        await this.novuWorkflowAdapter.triggerWorkflow(triggerData);
      }
    } catch (e: any) {
-      // Откат изменений в случае ошибки
+      if (chainWriteHappened) {
+        // На цепи уже созданы аккаунты пайщиков (откату не подлежат). НЕ удаляем
+        // off-chain записи — сохраняем привязку личность↔username для ручной
+        // сверки/очистки. Переводим систему в 'maintenance': повторный запуск
+        // install заблокирован (guard требует 'initialized'), фронт показывает
+        // заглушку техобслуживания (коопа в полу-установленном состоянии);
+        // сначала нужно вручную доустановить или вычистить частично созданное.
+        await this.monoStatusRepository.setStatus(SystemStatus.maintenance);
+        logger.error(
+          `Установка прервана ПОСЛЕ on-chain регистрации (${users.length} аккаунтов уже на цепи): ${e.message}. ` +
+            `Система переведена в '${SystemStatus.maintenance}'. Off-chain данные сохранены для ручного разбора. ` +
+            `Повторный install заблокирован до очистки/доустановки.`,
+          e.stack
+        );
+        throw new BadRequestException(
+          `Установка прервана после создания аккаунтов на цепи: ${e.message}. Требуется ручной разбор (статус '${SystemStatus.maintenance}').`
+        );
+      }
+
+      // On-chain след отсутствует — безопасно откатываем off-chain и
+      // возвращаем 'initialized', чтобы установку можно было повторить чисто.
      for (const user of users) {
        await this.userDomainService.deleteUserByUsername(user.username);
        await this.generatorPort.del('individual', { username: user.username });
      }
+      await this.monoStatusRepository.setStatus(SystemStatus.initialized);
      throw new BadRequestException(e.message);
    }

@@ -234,7 +234,8 @@ export class SystemInteractor {
      union_link: config.union.link,
      board_members,
      features: {
-        search: process.env.OPENSEARCH_ENABLED === 'true',
+        // Поиск по документам теперь на PG-реестре подписанных документов (C28-21) — доступен всегда.
+        search: true,
      },
    });
  }
@@ -28,9 +28,6 @@ export class ProgramWalletDTO {
  @Field(() => String, { description: 'Доступный баланс (формат: "100.0000 RUB")' })
  available!: string;

-  @Field(() => String, { description: 'Заблокированный баланс (формат: "100.0000 RUB")' })
-  blocked!: string;
-
  @Field(() => String, { description: 'Паевой взнос (формат: "100.0000 RUB")' })
  membership_contribution!: string;

@@ -49,7 +46,6 @@ export class ProgramWalletDTO {
    dto.agreement_id = entity.agreement_id;
    dto.username = entity.username;
    dto.available = entity.available;
-    dto.blocked = entity.blocked;
    dto.membership_contribution = entity.membership_contribution;
    dto.blockNum = entity.blockNum;
    return dto;
@@ -26,22 +26,29 @@ const logger = winston.createLogger({
    })
  ),
  transports: [
-    new DailyRotateFile({
-      filename: 'logs/application-%DATE%.log',
-      datePattern: 'YYYY-MM-DD',
-      zippedArchive: true,
-      maxSize: '20m',
-      maxFiles: '30d',
-      level: 'info',
-    }),
-    new DailyRotateFile({
-      filename: 'logs/error-%DATE%.log',
-      datePattern: 'YYYY-MM-DD',
-      zippedArchive: true,
-      maxSize: '20m',
-      maxFiles: '30d',
-      level: 'error',
-    }),
+    // При генерации схемы (build-time codegen) файловые транспорты не подключаем:
+    // процесс запускается из-под пользователя рядом с работающим контейнером, чей logs/
+    // принадлежит root, — запись туда падает с EACCES. На рантайм не влияет (флаг ставится только в codegen).
+    ...(process.env.CONTROLLER_SCHEMA_GEN
+      ? []
+      : [
+          new DailyRotateFile({
+            filename: 'logs/application-%DATE%.log',
+            datePattern: 'YYYY-MM-DD',
+            zippedArchive: true,
+            maxSize: '20m',
+            maxFiles: '30d',
+            level: 'info',
+          }),
+          new DailyRotateFile({
+            filename: 'logs/error-%DATE%.log',
+            datePattern: 'YYYY-MM-DD',
+            zippedArchive: true,
+            maxSize: '20m',
+            maxFiles: '30d',
+            level: 'error',
+          }),
+        ]),
    new winston.transports.Console({
      stderrLevels: ['error'],
      level: config.env === 'development' ? 'debug' : 'info',
@@ -2,6 +2,7 @@ import { RegistratorContract, type SovietContract } from 'cooptypes';
 import type { BlockchainAccountInterface } from '~/types/shared';
 import type { MonoAccountDomainInterface } from '../interfaces/mono-account-domain.interface';
 import type { PrivateAccountDomainInterface } from '../interfaces/private-account-domain.interface';
+import type { RegistrationPaymentDomainInterface } from '../interfaces/registration-payment-domain.interface';

 export class AccountDomainEntity {
  public readonly username!: string;
@@ -10,6 +11,7 @@ export class AccountDomainEntity {
  public provider_account!: MonoAccountDomainInterface | null;
  public participant_account!: SovietContract.Tables.Participants.IParticipants | null;
  public private_account!: PrivateAccountDomainInterface | null;
+  public registration_payment?: RegistrationPaymentDomainInterface | null;

  constructor(data: AccountDomainEntity) {
    Object.assign(this, data);
@@ -0,0 +1,15 @@
+import type { PaymentStatusEnum } from '~/domain/gateway/enums/payment-status.enum';
+
+/**
+ * Сводка по регистрационному (вступительному) платежу пайщика.
+ * Прокидывается в аккаунт, чтобы фронт восстанавливал шаг регистрации
+ * (ожидание/отклонение платежа) после перезагрузки и в любой вкладке.
+ */
+export interface RegistrationPaymentDomainInterface {
+  status: PaymentStatusEnum;
+  /** Причина изменения статуса (например, причина отклонения платежа) */
+  message?: string | null;
+  hash: string;
+  quantity: number;
+  symbol: string;
+}
@@ -6,6 +6,5 @@ export interface BankAccountDomainInterface {
  details: {
    bik: string;
    corr: string;
-    kpp: string;
  };
 }
@@ -5,6 +5,10 @@ export interface SovietBlockchainPort {
  getDecisions(coopname: string): Promise<SovietContract.Tables.Decisions.IDecision[]>;
  getDecision(coopname: string, decision_id: string): Promise<SovietContract.Tables.Decisions.IDecision | null>;

+  // Все советы кооператива (`soviet::boards`). Нужен состав совета (`soviet`) для
+  // вычисления порога отрицательного консенсуса на стороне фронта.
+  getBoards(coopname: string): Promise<SovietContract.Tables.Boards.IBoards[]>;
+
  // Конфиг соглашения кооператива (program_id, draft_id) по типу.
  getCoagreement(coopname: string, agreement_type: string): Promise<SovietContract.Tables.CoopAgreements.ICoopAgreement | null>;

@@ -20,11 +24,23 @@ export interface SovietBlockchainPort {

  cancelExpiredDecision(data: SovietContract.Actions.Decisions.Cancelexprd.ICancelExpired): Promise<TransactResult>;

+  // Явное отклонение решения советом по отрицательному консенсусу (до истечения
+  // срока). Проводится ключом кооператива; контракт проверяет большинство «против».
+  declineDecision(data: SovietContract.Actions.Decisions.Declinedec.IDeclineDecision): Promise<TransactResult>;
+
  sendAgreement(data: SovietContract.Actions.Agreements.SendAgreement.ISendAgreement): Promise<TransactResult>;

  confirmAgreement(data: SovietContract.Actions.Agreements.ConfirmAgreement.IConfirmAgreement): Promise<TransactResult>;

  declineAgreement(data: SovietContract.Actions.Agreements.DeclineAgreement.IDeclineAgreement): Promise<TransactResult>;
+
+  // Утверждение + исполнение решения совета одной транзакцией ключом кооператива
+  // (soviet::authorize + soviet::exec). Согласие председателя — в подписанном им
+  // документе внутри authorizeData.document.
+  authorizeDecision(
+    authorizeData: SovietContract.Actions.Decisions.Authorize.IAuthorize,
+    execData: SovietContract.Actions.Decisions.Exec.IExec
+  ): Promise<TransactResult>;
 }

 export const SOVIET_BLOCKCHAIN_PORT = Symbol('SovietBlockchainPort');
@@ -0,0 +1,18 @@
+/**
+ * Статус подписанного документа в реестре подписанных документов (Postgres-проекция).
+ *
+ * Жизненный цикл документа фиксируется блокчейн-событиями контракта soviet:
+ * - newsubmitted → Submitted
+ * - newresolved  → Resolved
+ * - newdeclined  → Declined
+ *
+ * Resolved — основной статус (на нём построено отображение реестра).
+ * Submitted — отправлен/подписан, но ещё не утверждён (сценарий доп. утверждения;
+ * сейчас фактически не используется — кандидат на вырезание, см. задачу C28-21).
+ * Declined — отклонён/аннулирован.
+ */
+export enum SignedDocumentStatus {
+  Submitted = 'submitted',
+  Resolved = 'resolved',
+  Declined = 'declined',
+}
@@ -0,0 +1,145 @@
+import type { SignedDocumentStatus } from '../enums/signed-document-status.enum';
+import type { DocumentPackageAggregateDomainInterface } from '../interfaces/document-package-aggregate-domain.interface';
+
+/**
+ * Данные для записи/обновления одной записи реестра подписанных документов.
+ * Одна запись = ОДИН документ (ключ — `doc_hash`, идентичность содержимого без подписей).
+ * `hash` — крайняя подписанная версия (накопленные подписи), `packageHash` — идентификатор процесса,
+ * общий для нескольких заявлений пакета (submitted↔resolved↔declined трекаются по `doc_hash`).
+ */
+export interface SignedDocumentUpsertInput {
+  coopname: string;
+  /** checksum256 процесса (`package` в blockchain-action; НЕ уникален — группирует документы) */
+  packageHash: string;
+  /** checksum256 содержимого документа — УНИКАЛЬНЫЙ ключ записи (без учёта подписей) */
+  doc_hash: string;
+  /** checksum256 подписанной версии (включает подписи) — крайняя версия документа */
+  hash: string;
+  username: string;
+  status: SignedDocumentStatus;
+  /** под-действие soviet (`data.action`) — для фильтрации списка по типам документов */
+  action: string;
+  registry_id: number;
+  full_title: string;
+  /** html заявления без тегов — для ILIKE-поиска */
+  content_text: string;
+  /** ФИО/наименования всех подписантов пакета + их username — для поиска по подписанту */
+  signers_text: string;
+  /** bigint из блокчейна приходит строкой */
+  block_num: string | null;
+  document_created_at: Date | null;
+  /** готовый агрегат пакета (statement/decision/acts/links) — отдаётся getDocuments как есть */
+  document_aggregate: DocumentPackageAggregateDomainInterface | null;
+  /** data действия-носителя заявления — для пересборки агрегата при доприходе decision/act/link */
+  source_action_data: Record<string, unknown> | null;
+}
+
+export interface SignedDocumentSearchParams {
+  coopname: string;
+  query: string;
+  limit: number;
+  /** ограничить поиск документами этого пайщика (для не-членов совета); undefined — весь кооператив */
+  username?: string;
+}
+
+/**
+ * Результат поиска — повторяет контракт SearchResultDTO (GraphQL `searchDocuments`).
+ */
+export interface SignedDocumentSearchHit {
+  hash: string;
+  /** Чистое наименование документа (meta.title), без служебного хвоста ` - - дата.pdf`. */
+  full_title: string;
+  username: string;
+  /** ФИО подписанта-субъекта («Иванов Иван Иванович») для отображения вместо username. */
+  signer: string;
+  coopname: string;
+  registry_id: number;
+  created_at: string | null;
+  highlights: string[];
+}
+
+/** Параметры выборки готовых агрегатов для списка документов (read-path getDocuments). */
+export interface SignedDocumentListParams {
+  coopname: string;
+  status?: SignedDocumentStatus;
+  /** фильтр по под-действиям (data.action) */
+  actions?: string[];
+  /** фильтр по пайщику */
+  username?: string;
+  /** фильтр по хэшу конкретного документа-заявления */
+  hash?: string;
+  afterBlock?: number;
+  beforeBlock?: number;
+  page: number;
+  limit: number;
+}
+
+export interface SignedDocumentListResult {
+  items: DocumentPackageAggregateDomainInterface[];
+  total: number;
+}
+
+/**
+ * Частичное обновление записи при ПЕРЕСБОРКЕ агрегата (доприход decision/act/link).
+ * Затрагивает ТОЛЬКО агрегат-производные колонки. Поля жизненного цикла (status, block_num,
+ * source_action_data, document_created_at) сюда НЕ входят: ими владеют статус-события
+ * (newsubmitted/newresolved/newdeclined). Иначе пересборка, читающая старый row.status, откатила бы
+ * параллельно проставленный resolved обратно в submitted (гонка freedecision: newresolved+newdecision
+ * по одному package приходят одновременно).
+ */
+export interface SignedDocumentAggregateUpdate {
+  document_aggregate: DocumentPackageAggregateDomainInterface | null;
+  full_title: string;
+  content_text: string;
+  signers_text: string;
+}
+
+/** Состояние записи для guard'ов ingestion (не понижать статус / не откатывать версию подписи). */
+export interface SignedDocumentState {
+  status: SignedDocumentStatus;
+  /** номер блока крайней версии (для сравнения «новее ли пришедшая версия») */
+  blockNum: number | null;
+}
+
+/** Строка реестра для пересборки агрегата: документ пакета + его действие-носитель. */
+export interface SignedDocumentPackageRow {
+  doc_hash: string;
+  hash: string;
+  status: SignedDocumentStatus;
+  sourceActionData: Record<string, unknown> | null;
+}
+
+/**
+ * Репозиторий реестра подписанных документов (Postgres-проекция).
+ * Единый источник для отображения (getDocuments) и поиска (searchDocuments) — задача C28-21.
+ * Запись = один документ (ключ `doc_hash`); `package` группирует заявления одного процесса.
+ */
+export interface SignedDocumentRepository {
+  /** Вставить или обновить запись по (coopname, doc_hash). */
+  upsert(input: SignedDocumentUpsertInput): Promise<void>;
+
+  /** Частично обновить ТОЛЬКО агрегат-производные колонки записи (по coopname, doc_hash).
+   *  Используется пересборкой при доприходе decision/act/link — status/block_num/source НЕ трогаются
+   *  (см. SignedDocumentAggregateUpdate: защита от отката resolved→submitted в гонке). */
+  updateAggregate(coopname: string, docHash: string, fields: SignedDocumentAggregateUpdate): Promise<void>;
+
+  /** Статус + номер блока крайней версии документа по его doc_hash (для guard'ов ingestion);
+   *  null, если записи нет. */
+  getState(coopname: string, docHash: string): Promise<SignedDocumentState | null>;
+
+  /** Кол-во записей реестра по кооперативу (для авто-триггера backfill на пустой базе). */
+  count(coopname: string): Promise<number>;
+
+  /** Все заявления одного процесса (package) — для пересборки агрегатов при доприходе
+   *  decision/act/link (на пакет может приходиться несколько заявлений с разными подписантами). */
+  findByPackage(coopname: string, packageHash: string): Promise<SignedDocumentPackageRow[]>;
+
+  /** Поиск по реестру (ILIKE по signers_text/full_title/content_text/username). */
+  search(params: SignedDocumentSearchParams): Promise<SignedDocumentSearchHit[]>;
+
+  /** Список готовых агрегатов с пагинацией и фильтрами (read-path getDocuments). */
+  findAggregates(params: SignedDocumentListParams): Promise<SignedDocumentListResult>;
+}
+
+/** Токен для инъекции зависимости репозитория реестра подписанных документов. */
+export const SIGNED_DOCUMENT_REPOSITORY = Symbol('SignedDocumentRepository');
@@ -3,4 +3,6 @@ import type { PaymentStatusEnum } from '../enums/payment-status.enum';
 export interface SetPaymentStatusInputDomainInterface {
  id: string;
  status: PaymentStatusEnum;
+  /** Причина изменения статуса (например, причина отклонения платежа), сохраняется в payment.message */
+  message?: string;
 }
@@ -45,6 +45,14 @@ export interface PaymentRepository {
    quantity: number,
    symbol: string
  ): Promise<PaymentDomainInterface | null>;
+
+  /**
+   * Найти последний платеж заданного типа для пользователя (любой статус)
+   * @param username имя пользователя
+   * @param type тип платежа
+   * @returns последний по дате создания платеж или null
+   */
+  findLatestByUsernameAndType(username: string, type: PaymentTypeEnum): Promise<PaymentDomainInterface | null>;
 }

 export const PAYMENT_REPOSITORY = Symbol('PaymentRepository');
@@ -11,6 +11,5 @@ export interface BankTransferDataDomainInterface {
  details: {
    bik: string;
    corr: string;
-    kpp: string;
  };
 }
@@ -1,6 +1,5 @@
 # Установка расширения "Стол Председателя"

 1. Настройте интервал проверки решений (рекомендуемое значение: 15 минут)
-2. Настройте отмену истекших, но принятых решений (`true` - отмена, `false` - не отмена).

 После установки расширение автоматически начнет проверять истекшие решения согласно установленному интервалу.
--- a/Show More
+++ b/Show More