[598][@ant] fix+docs: разблокировка marketplace UI + e2e обзор Стола председателя

Зафиксированы 2 блокера фронта, мешавшие снять marketplace-документацию, плюс 23 скриншота и 2 инструкции (`dashboard.md`, `market-tour.md`). ## Фиксы desktop 1. `ProcessesPage.vue` — убраны TS non-null assertion `!.` из pug-template v-for. Они проникали в скомпилированный render-функцию и приводили к runtime `SyntaxError: missing ) after argument list` на import-time всех extensions, что блокировало init-app целиком. 2. `Environment.ts` — раскомментирован fallback на `/config.default.js`, когда SSR middleware не запущен и `/config.js` отдаёт SPA-fallback HTML. Без этого фронт получал пустой BACKEND_URL и зависал на loadSystemInfo. 3. `config.default.js` — обновлён под реальный локальный стек (BACKEND_URL=127.0.0.1:2998, CHAIN_ID соответствует blockchain-data). 4. `watch-branch-overlay/index.ts` — добавлен harness escape hatch `localStorage.harness:noBranchOverlay` для снятия скриншотов разделов без процедуры выбора КУ. В prod localStorage пуст, поведение не меняется. ## Документация - `new/marketplace/chairman/dashboard.md` (11 шотов) — обзорная инструкция по разделам Стола председателя: онбординг, запросы одобрений, магазин приложений, члены совета, ПВЗ, регистрационные взносы, ключ кооператива, провайдер платежей, контакты. - `new/marketplace/chairman/market-tour.md` (12 шотов) — экскурсия по всем маршрутам Стола заказов (`/market/*` и `/market-pvz/*`): каталог, создание предложения, мои заказы, готовые к выдаче, возвраты, списания скоропорта, склад, реестр экосистемы, ПВЗ-разделы. - `mkdocs.yml` — добавлены 2 пункта в nav. ## Harness - `dashboard-overview.mjs` — переписан под кликовый обход меню (без goto, чтоб не триггерить branch-overlay в navigation guard). - `market-tour.mjs` (новый) — 12-шаговая экскурсия по marketplace-маршрутам с harness-bypass. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-20 23:01:16 +00:00
parent 6a523db8b1
commit 5c333f8fa1
32 changed files with 386 additions and 51 deletions
@@ -128,7 +128,7 @@ div.page-shell
                        .text-body2(v-if='!processDetails.get(props.row.processHash)?.actions?.length') Нет событий
                        q-list(v-else dense)
                          q-item(
-                            v-for='a in processDetails.get(props.row.processHash)!.actions'
+                            v-for='a in (processDetails.get(props.row.processHash)?.actions ?? [])'
                            :key='a.global_sequence'
                          )
                            q-item-section
@@ -142,7 +142,7 @@ div.page-shell
                        .text-body2(v-if='!processDetails.get(props.row.processHash)?.documents?.length') Документы не приложены
                        q-list(v-else dense)
                          q-item(
-                            v-for='d in processDetails.get(props.row.processHash)!.documents'
+                            v-for='d in (processDetails.get(props.row.processHash)?.documents ?? [])'
                            :key='d.source.code + "::" + d.source.table + "::" + d.source.primary_key + "-" + d.hash'
                          )
                            q-item-section
@@ -1,30 +1,32 @@
-// Резервная конфигурация для PWA режима
-// Используется когда SSR middleware недоступен
-// Этот файл должен быть заменен на config.js при деплое
+// Резервная конфигурация для SPA-dev режима (когда SSR middleware
+// `generateConfig.ts` не запущен и /config.js отдаёт SPA fallback).
+// Адреса соответствуют локальному стеку из docker-compose.yml: backend
+// на :2998, EOSIO chain на :8888, mongo на :27047, postgres на :5532.
+// В CI/prod этот файл переопределяется реальным /config.js, который
+// генерирует SSR.

 console.warn(
-  'Используется резервная конфигурация! Убедитесь, что config.js генерируется SSR middleware',
+  'Используется резервная конфигурация config.default.js! Убедитесь, что config.js генерируется SSR middleware в production.',
 );

 window.__APP_CONFIG__ = {
  NODE_ENV: 'development',
-  BACKEND_URL: 'http://localhost:3000',
-  CHAIN_URL: 'http://localhost:8888',
-  CHAIN_ID: 'cae86058a6d8698833afb474ab8a5ad8599c6cf54f9ebcf275dbac7055c16fe1',
+  BACKEND_URL: 'http://127.0.0.1:2998',
+  CHAIN_URL: 'http://127.0.0.1:8888',
+  CHAIN_ID: 'db79c8409645082749ca50640d6f4ee511575acf26c4e2c8e4748e6bf6a01ed4',
  CURRENCY: 'RUB',
-  COOP_SHORT_NAME: 'Цифровой Кооператив',
+  COOP_SHORT_NAME: 'DEV Кооператив',
  SITE_DESCRIPTION: 'кооперативная экономика для сообществ и бизнеса',
  SITE_IMAGE: 'https://ia.media-imdb.com/images/rock.jpg',
-  STORAGE_URL: 'http://localhost:3000/storage',
-  UPLOAD_URL: 'http://localhost:3000/upload',
+  STORAGE_URL: 'http://127.0.0.1:2998/storage',
+  UPLOAD_URL: 'http://127.0.0.1:2998/upload',
  TIMEZONE: 'Europe/Moscow',
  VUE_ROUTER_MODE: 'hash',
  VUE_ROUTER_BASE: '/',
-  NOVU_APP_ID: '',
+  NOVU_APP_ID: 'BTaPV0bRL0dz',
  NOVU_BACKEND_URL: 'https://novu.coopenomics.world/api',
-  NOVU_SOCKET_URL: 'https://novu.coopenomics.world/ws',
-  VAPID_PUBLIC_KEY: '',
+  NOVU_SOCKET_URL: 'https://novu.coopenomics.world',
+  VAPID_PUBLIC_KEY: 'BLomcBkzOF0jGYU_kfZ07-dhl6_euyZKGoZb-yKcP6vzNXvb49DQgce_7EyXhL4PPwS0MklVYQbq_mzJhFiLHaw',
  SENTRY_DSN: '',
+  OPENREPLAY_PROJECT_KEY: '',
 };
-
-console.log('Резервная конфигурация загружена');
@@ -11,6 +11,14 @@ export function useBranchOverlayProcess() {
  const { isVisible } = useSelectBranch()

  const checkConditions = () => {
+    // Harness/docs escape hatch: позволяет снимать скриншоты разделов
+    // без прохождения процедуры выбора кооп. участка. Включается через
+    // `localStorage.setItem('harness:noBranchOverlay', '1')` перед навигацией.
+    if (typeof window !== 'undefined' && window.localStorage?.getItem('harness:noBranchOverlay') === '1') {
+      isVisible.value = false
+      return
+    }
+
    const branched = system.info?.cooperator_account?.is_branched
    const participant = account?.account?.participant_account
    const noBraname = participant?.braname === ''
@@ -66,25 +66,26 @@ function loadConfigSync(): boolean {

  }

-  // // Пробуем загрузить резервную конфигурацию
-  // try {
-  //   console.log('DEBUG: Загружаем резервную конфигурацию синхронно');
+  // Пробуем резервный config.default.js (для SPA-dev режима, где SSR middleware
+  // не запущен и нет /config.js — без этого фронт получает пустой BACKEND_URL).
+  try {
+    const xhr = new XMLHttpRequest();
+    xhr.open('GET', `/config.default.js?t=${Date.now()}`, false);
+    xhr.send();

-  //   const xhr = new XMLHttpRequest();
-  //   xhr.open('GET', '/config.default.js', false);
-  //   xhr.send();
-
-  //   if (xhr.status === 200) {
-  //     eval(xhr.responseText);
-
-  //     if (window.__APP_CONFIG__) {
-  //       console.log('DEBUG: config.default.js загружен синхронно');
-  //       return true;
-  //     }
-  //   }
-  // } catch (error) {
-  //   console.warn('DEBUG: Ошибка загрузки резервной конфигурации:', error);
-  // }
+    if (xhr.status === 200) {
+      const ct = (xhr.getResponseHeader('content-type') || '').toLowerCase();
+      if (!ct.includes('javascript')) {
+        return false;
+      }
+      eval(xhr.responseText);
+      if (window.__APP_CONFIG__) {
+        return true;
+      }
+    }
+  } catch {
+    // молча — следующая ветка вернёт false
+  }

  return false;
 }
@@ -16,17 +16,26 @@ export const meta = {
  role: 'chairman',
 };

-const ROUTES = [
-  { name: '01-marketplace-main', path: '/marketplace', caption: 'Главная marketplace' },
-  { name: '02-marketplace-catalog', path: '/marketplace/catalog', caption: 'Каталог витрины' },
-  { name: '03-marketplace-orders', path: '/marketplace/orders', caption: 'Мои заказы' },
-  { name: '04-chairman', path: '/chairman', caption: 'Стол председателя' },
-  { name: '05-chairman-approvals', path: '/chairman/approval-requests', caption: 'Запросы одобрений' },
+// Маршруты Стола председателя (и встроенные роуты marketplace под /chairman/extensions)
+const CHAIRMAN_MENU = [
+  { name: '01-onboarding',         text: 'Онбординг',           caption: 'Онбординг: подписание соглашений и активация кооператива' },
+  { name: '02-approvals',          text: 'Запросы одобрений',   caption: 'Запросы одобрений: входящие действия пайщиков, ждущие подписи председателя' },
+  { name: '03-extensions',         text: 'Магазин приложений',  caption: 'Магазин приложений: установка расширений (Стол заказов, бухгалтерия и т. п.)' },
+  { name: '04-system-settings',    text: 'Стартовые страницы',  caption: 'Стартовые страницы: настройка маршрутов после входа для ролей' },
+  { name: '05-members',            text: 'Члены совета',        caption: 'Члены совета: реестр и роли совета кооператива' },
+  { name: '06-branches',           text: 'Кооперативные Участки', caption: 'Кооперативные Участки: реестр ПВЗ (Красногорск / Одинцово / Мытищи)' },
+  { name: '07-register-payments',  text: 'Регистрационные взносы', caption: 'Регистрационные взносы: тарифы вступления и членства' },
+  { name: '08-cooperative-key',    text: 'Ключ кооператива',    caption: 'Ключ кооператива: ротация active-ключа председательской подписи' },
+  { name: '09-payment-provider',   text: 'Провайдер платежей',  caption: 'Провайдер платежей: настройка интеграции для приёма платежей' },
+  { name: '10-contacts',           text: 'Контакты кооператива', caption: 'Контакты кооператива: реквизиты для писем и счетов' },
 ];

 export default async ({ page, shot, context }) => {
-  // --- Login (без ожидания редиректа — фронт не редиректит на этом стенде)
-  await page.goto(`${env.BASE_URL}/${env.COOPNAME}/auth/signin`, { waitUntil: 'domcontentloaded', timeout: 60000 });
+  // --- Login (hash router: URL вида #/<coopname>/...)
+  await page.goto(`${env.BASE_URL}/#/${env.COOPNAME}/auth/signin`, { waitUntil: 'domcontentloaded', timeout: 60000 });
+  // Harness escape hatch: отключаем branch-overlay чтобы можно было снять скриншоты
+  // всех разделов Стола председателя без процедуры выбора КУ.
+  await page.evaluate(() => localStorage.setItem('harness:noBranchOverlay', '1'));
  await page.waitForSelector('button:has-text("Войти")', { timeout: 60000 });
  await cleanViteOverlays(page);
  await page.locator('label:has-text("электронную почту")').locator('input').fill(env.CHAIRMAN_EMAIL);
@@ -34,16 +43,22 @@ export default async ({ page, shot, context }) => {
  await cleanViteOverlays(page);
  await page.locator('button:has-text("Войти")').click();

-  // Подождать сохранения токенов в IndexedDB (login API + globalStore.setTokens)
+  // Дожидаемся редиректа на онбординг председателя
+  await page.waitForURL(/chairman/, { timeout: 30000 });
  await page.waitForTimeout(4000);
-  await shot(page, '00-after-login', 'Состояние сразу после клика «Войти» (фронт ещё не редиректит автоматически — баг с реактивностью info.coopname).');
+  await cleanViteOverlays(page);
+  await shot(page, '00-after-login', 'Сразу после клика «Войти» — председатель попадает на онбординг Стола председателя. Слева — меню всех разделов (Онбординг, Запросы одобрений, Магазин приложений и др.).');

-  // --- Обзорная экскурсия по marketplace маршрутам
-  for (const route of ROUTES) {
-    const url = `${env.BASE_URL}/${env.COOPNAME}${route.path}`;
-    await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 });
-    await page.waitForTimeout(5000);
+  // --- Обход меню председателя кликом по пункту, чтобы не триггерить branch-overlay
+  for (const item of CHAIRMAN_MENU) {
+    const link = page.locator(`a:has-text("${item.text}"), .q-item:has-text("${item.text}")`).first();
+    if (!(await link.isVisible().catch(() => false))) {
+      console.warn(`  skip "${item.text}" — не нашли пункт меню`);
+      continue;
+    }
+    await link.click({ trial: false }).catch(() => {});
+    await page.waitForTimeout(4500);
    await cleanViteOverlays(page);
-    await shot(page, route.name, `${route.caption}: ${url.replace(env.BASE_URL, '')}`);
+    await shot(page, item.name, item.caption);
  }
 };
@@ -0,0 +1,50 @@
+// Сценарий: Стол председателя → экскурсия по разделам «Стола заказов» (marketplace).
+// Авторизуется как chairman (ant) и перебирает все маршруты /market/* и /market-pvz/*,
+// используя harness:noBranchOverlay чтобы обойти выбор кооп. участка.
+
+import { cleanViteOverlays, env } from '../../../lib/harness.mjs';
+
+export const meta = {
+  title: 'Стол председателя: разделы Стола заказов',
+  docPath: 'new/marketplace/chairman/market-tour.md',
+  assetsDir: 'assets/new/marketplace/chairman/market-tour',
+  role: 'chairman',
+};
+
+const ROUTES = [
+  { name: '01-catalog',          path: '/market/catalog',           caption: 'Каталог Стола заказов: список предложений товаров и услуг' },
+  { name: '02-create-offer',     path: '/market/create-offer',      caption: 'Форма «Создать предложение» — добавление товара/услуги в каталог' },
+  { name: '03-my-orders',        path: '/market/my-orders',         caption: 'Мои заказы: лента заказов председателя как заказчика' },
+  { name: '04-ready-to-receive', path: '/market/ready-to-receive',  caption: 'Готовые к выдаче: заказы со статусом READY_TO_RECEIVE на пункте выдачи' },
+  { name: '05-returns',          path: '/market/returns',           caption: 'Возвраты: заявки на возврат товара от заказчиков' },
+  { name: '06-writeoffs',        path: '/market/writeoffs',         caption: 'Списания: запросы на списание со склада, ждущие одобрения совета' },
+  { name: '07-warehouse-summary',path: '/market/warehouse-summary', caption: 'Склад кооператива: сводный остаток товаров по всем ПВЗ' },
+  { name: '08-ecosystem',        path: '/market/ecosystem',         caption: 'Реестр экосистемы: участники marketplace (заказчики, поставщики, операторы)' },
+  { name: '09-pvz-list',         path: '/market-pvz/list',          caption: 'Пункты выдачи: список ПВЗ кооператива' },
+  { name: '10-pvz-issuance',     path: '/market-pvz/issuance',      caption: 'Выдача заказов на ПВЗ: реестр товаров, ждущих выдачи заказчику' },
+  { name: '11-pvz-returns',      path: '/market-pvz/returns',       caption: 'Возвраты на ПВЗ: обработка возвратов оператором' },
+  { name: '12-pvz-warehouse',    path: '/market-pvz/warehouse',     caption: 'Склад ПВЗ: текущий остаток у конкретного пункта выдачи' },
+];
+
+export default async ({ page, shot, context }) => {
+  // Login
+  await page.goto(`${env.BASE_URL}/#/${env.COOPNAME}/auth/signin`, { waitUntil: 'domcontentloaded', timeout: 60000 });
+  await page.evaluate(() => localStorage.setItem('harness:noBranchOverlay', '1'));
+  await page.waitForSelector('button:has-text("Войти")', { timeout: 60000 });
+  await cleanViteOverlays(page);
+  await page.locator('label:has-text("электронную почту")').locator('input').fill(env.CHAIRMAN_EMAIL);
+  await page.locator('label:has-text("ключ доступа")').locator('input').fill(env.CHAIRMAN_WIF);
+  await cleanViteOverlays(page);
+  await page.locator('button:has-text("Войти")').click();
+  await page.waitForURL(/chairman/, { timeout: 30000 });
+  await page.waitForTimeout(4000);
+
+  // Tour по marketplace разделам
+  for (const route of ROUTES) {
+    const url = `${env.BASE_URL}/#/${env.COOPNAME}${route.path}`;
+    await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 });
+    await page.waitForTimeout(4500);
+    await cleanViteOverlays(page);
+    await shot(page, route.name, `${route.caption} (URL: \`#/${env.COOPNAME}${route.path}\`)`);
+  }
+};
@@ -0,0 +1,132 @@
+---
+title: Стол председателя ПК — обзор разделов
+generated_by: docs-harness
+scenario: marketplace/chairman/dashboard-overview
+---
+
+# Стол председателя ПК — обзор разделов
+
+Председатель ПК входит на платформу со своим e-mail и приватным ключом. Сразу после входа открывается **Стол председателя** — рабочее место, через которое председатель управляет кооперативом: подписывает решения, добавляет ПВЗ и членов совета, настраивает программу платежей и интеграции.
+
+!!!info "Кому подойдёт эта инструкция"
+    Председателю потребительского кооператива, который входит в платформу впервые или хочет освежить в памяти, где какой раздел.
+
+## Шаг 1. Главный экран — онбординг
+
+![Стол председателя сразу после входа: меню слева, чек-лист онбординга справа](/assets/new/marketplace/chairman/dashboard/00-after-login.png)
+
+Сразу после клика «Войти» председатель попадает на экран **«Адаптируйте кооператив к работе на платформе»**. Это пошаговый чек-лист первичной настройки:
+
+1. Утверждение соглашения о ЦПП «Цифровой Кошелёк»
+2. Утверждение положения о простой электронной подписи
+3. Утверждение политики конфиденциальности
+4. Утверждение пользовательского соглашения
+5. Утверждение форм заявлений на вступление
+6. О вступлении в ПК «Восход»
+7. Импорт пайщиков (загрузка CSV-файла)
+8. Объявить общее собрание
+
+Каждый шаг можно открыть, заполнить и подписать. Сверху виден таймер до конца льготного периода адаптации.
+
+Слева — постоянная навигация по разделам Стола председателя: Онбординг, Запросы одобрений, Магазин приложений, Стартовые страницы, Члены совета, Кооперативные Участки, Регистрационные взносы, Ключ кооператива, Провайдер платежей, Контакты кооператива. Внизу — карточка председателя с балансом «0,00 RUB» и кнопкой «Выйти».
+
+## Шаг 2. Онбординг (повторно)
+
+![Тот же экран онбординга — отдельный раздел меню](/assets/new/marketplace/chairman/dashboard/01-onboarding.png)
+
+Раздел «Онбординг» — стартовая страница Стола председателя. Сюда фронт перенаправляет сразу после входа, пока чек-лист не пройден до конца. Когда все 8 шагов отмечены — раздел переходит в режим «выполнено», и можно убрать пункт из меню через раздел «Стартовые страницы» (см. шаг 5).
+
+## Шаг 3. Запросы одобрений
+
+![Лента входящих действий, ожидающих подписи председателя](/assets/new/marketplace/chairman/dashboard/02-approvals.png)
+
+В разделе **«Запросы одобрений»** собираются действия пайщиков, для которых регламент требует предварительной подписи председателя:
+- передача доли,
+- открытие проекта на капитализацию,
+- выпуск регистрационного билета,
+- и другие действия из контракта `soviet`.
+
+Колонки таблицы: «Пользователь», «Действие», «Статус», «Дата создания», «Действия». Сверху — фильтр «Статус: Ожидает». Если очередь пуста — фронт показывает плашку «У председателя нет запросов предварительных одобрений».
+
+## Шаг 4. Магазин приложений
+
+![Карточки доступных расширений: Стол Совета, Благорост, Стол Председателя, Стол Уполномоченного, Стол Пайщика и т. д.](/assets/new/marketplace/chairman/dashboard/03-extensions.png)
+
+**«Магазин приложений»** — витрина расширений, которые можно установить в кооператив:
+- **Стол Совета** — управление решениями и собраниями совета.
+- **Благорост** — программа капитализации РИД.
+- **Стол Председателя** — функции, доступные только председателю кооператива.
+- **Стол Уполномоченного** — рабочее место уполномоченного председателя ПВЗ.
+- **Стол Пайщика** — личный кабинет пайщика.
+- **Стол вычислительных ресурсов** — биллинг ресурсов кооператива.
+- **YOOKASSA**, **SBERKASSA** — провайдеры платежей.
+
+Клик по карточке открывает страницу расширения с инструкцией по установке и настройкой прав. После установки расширения у соответствующих ролей появляются новые пункты меню.
+
+!!!note "Стол заказов входит в стандартный пакет"
+    Расширение «Стол заказов» (marketplace) — отдельный модуль; см. инструкцию [«Разделы Стола заказов»](./market-tour.md).
+
+## Шаг 5. Стартовые страницы
+
+![Настройка маршрутов после входа для каждой роли](/assets/new/marketplace/chairman/dashboard/04-system-settings.png)
+
+Раздел **«Стартовые страницы»** позволяет назначить каждой роли — председателю, члену совета, оператору ПВЗ, пайщику — свой первый экран после входа. По умолчанию для председателя — «Онбординг», для пайщика — «Кошелёк», для оператора ПВЗ — «Выдача заказов».
+
+Здесь же можно скрыть «Онбординг» из меню, когда чек-лист пройден.
+
+## Шаг 6. Члены совета
+
+![Реестр членов совета](/assets/new/marketplace/chairman/dashboard/05-members.png)
+
+Раздел **«Члены совета»** содержит список действующих членов совета кооператива и их роли. Председатель может добавить или удалить члена совета, а также инициировать ротацию подписей.
+
+## Шаг 7. Кооперативные участки (ПВЗ)
+
+![Реестр ПВЗ кооператива](/assets/new/marketplace/chairman/dashboard/06-branches.png)
+
+В разделе **«Кооперативные Участки»** председатель видит реестр ПВЗ — юридически оформленных подразделений кооператива, в которых работают свои председатели участков и доверенные лица.
+
+Заголовок страницы:
+
+> Создание кооперативных участков сейчас происходит за пределами цифровой системы. Здесь добавляются уже созданные и юридически оформленные участки с их председателями.
+>
+> При добавлении трёх участков кооператив автоматически переходит на мажоритарную систему управления. Действующим пайщикам будет предложено выбрать участок и делегировать голос его председателю. Новые пайщики делают выбор при регистрации.
+
+Колонки таблицы: «Название», «Председатель». Кнопка «**+ Добавить участок**» открывает форму создания. Если таблица пуста — отображается значок «Нет данных».
+
+!!!warning "Связь с MVP «Стол заказов»"
+    Без хотя бы одного ПВЗ Стол заказов работать не будет: каждый заказ должен быть привязан к пункту выдачи.
+
+## Шаг 8. Регистрационные взносы
+
+![Настройка тарифов вступления и членских взносов](/assets/new/marketplace/chairman/dashboard/07-register-payments.png)
+
+Раздел **«Регистрационные взносы»** — здесь председатель задаёт размеры вступительного и минимального членского взносов, ставит частоту списания минимального и привязывает их к программам (Кошелёк, Marketplace, Благорост). Поля синхронизируются с контрактом `soviet`.
+
+## Шаг 9. Ключ кооператива
+
+![Управление ключом active@coopname](/assets/new/marketplace/chairman/dashboard/08-cooperative-key.png)
+
+В разделе **«Ключ кооператива»** председатель управляет ключом `active@<coopname>` — это ключ, которым подписываются все системные действия кооператива (приём пайщиков, утверждение решений, выплаты). Здесь же показывается публичный ключ и время последней ротации.
+
+!!!danger "Ротируйте ключ при компрометации"
+    Ключ кооператива — это master-credential, его утрата делает весь кооператив уязвимым. Меняйте его регулярно и храните в безопасном месте.
+
+## Шаг 10. Провайдер платежей
+
+![Настройка провайдера приёма платежей (YooKassa, СберКасса и др.)](/assets/new/marketplace/chairman/dashboard/09-payment-provider.png)
+
+Раздел **«Провайдер платежей»** позволяет привязать к кооперативу платёжный шлюз — YooKassa, СберКасса или другой провайдер из магазина приложений. Поля: API-ключ, secret, webhook URL, валюта.
+
+## Шаг 11. Контакты кооператива
+
+![Юридические реквизиты и контакты для писем](/assets/new/marketplace/chairman/dashboard/10-contacts.png)
+
+Раздел **«Контакты кооператива»** содержит юридические реквизиты для писем, счетов, регистрации заявлений: полное и краткое наименование, ИНН/ОГРН, почтовый и фактический адрес, телефон, e-mail, банковские реквизиты. Эти поля попадают в шапки PDF-документов, которые подписывает председатель.
+
+---
+
+!!!note "Что дальше"
+    - Если предстоит работа со Столом заказов — см. инструкцию [«Разделы Стола заказов»](./market-tour.md).
+    - Если предстоит подписание решений совета — см. инструкцию по [Запросам одобрений](../../user/approval/).
+    - Если хотите освежить регламент работы председателя — см. [Положения ЦПП и Регламент ОАП](../../reference/regulations/).
@@ -0,0 +1,125 @@
+---
+title: Разделы Стола заказов — экскурсия для председателя
+generated_by: docs-harness
+scenario: marketplace/chairman/market-tour
+---
+
+# Разделы Стола заказов — экскурсия для председателя
+
+Эта инструкция — обзорная карта **Стола заказов** (marketplace) с точки зрения председателя кооператива. Здесь не описаны бизнес-сценарии (создание заказа, выдача товара, возврат) — для них есть отдельные роль-ориентированные инструкции. Цель раздела — показать, где какая страница находится и за что отвечает.
+
+!!!info "URL-конвенция"
+    Все маршруты Стола заказов находятся под `#/<coopname>/market/*` для общих разделов и `#/<coopname>/market-pvz/*` для разделов оператора ПВЗ. В наших скриншотах `<coopname>=voskhod`.
+
+## 1. Каталог Стола заказов
+
+![Главная страница каталога с фильтрами и сортировкой](/assets/new/marketplace/chairman/market-tour/01-catalog.png)
+
+**Каталог** — витрина активных предложений товаров и услуг кооператива. Сверху — переключатель «Все 0» (бэйдж считает число активных предложений), справа — сортировка («Свежие сначала»). На пустом каталоге фронт показывает «Ничего не найдено. В каталоге пока нет активных предложений».
+
+Сюда заказчики приходят, чтобы выбрать и оформить заказ. Каждое предложение — карточка с фото, ценой, доступным количеством и кнопкой «Заказать».
+
+## 2. Создать предложение
+
+![Форма «Новое предложение» с полями товара и параметрами цикла](/assets/new/marketplace/chairman/market-tour/02-create-offer.png)
+
+Раздел **«Создать предложение»** — форма, которой пользуется поставщик (председатель ПВЗ, доверенное лицо или сам кооператив). Поля:
+
+- **Название товара** (обязательно)
+- **Описание**
+- **Категория** (обязательно) — выбирается из справочника
+- **Цена за единицу** (обязательно, до 4 знаков после запятой)
+- **Единица** — шт., кг, м и т. п.
+- **Доступное количество** или переключатель «Без ограничения по количеству»
+- **Гарантия (дней)**
+- **Тип отсечки заказов**:
+    - **По расписанию** (`time_based`) — поставка по истечении цикла
+    - **По объёму** (`volume_based`)
+    - **Открытая подписка** (`open_subscription`)
+    - **Индивидуально** (`individual`)
+- **Длительность цикла (дней)**
+- **Минимальный порог объёма** (опциональный, для `volume_based`)
+
+После заполнения предложение уходит в каталог и становится видно всем пайщикам кооператива.
+
+## 3. Мои заказы
+
+![Лента заказов председателя как заказчика](/assets/new/marketplace/chairman/market-tour/03-my-orders.png)
+
+**«Мои заказы»** — лента всех заказов, которые председатель оформил как заказчик. Здесь видно статус каждого заказа: ожидает оплаты, в работе у поставщика, готов к выдаче, выдан, возвращён.
+
+## 4. Готовые к выдаче
+
+![Список заказов, доставленных в ПВЗ и ждущих получения](/assets/new/marketplace/chairman/market-tour/04-ready-to-receive.png)
+
+Раздел **«Готовые к выдаче»** показывает заказы со статусом `READY_TO_RECEIVE` — товар уже на ПВЗ и ждёт, пока заказчик его заберёт. Эта страница — визуальное продолжение push-уведомления `marketplace-order-ready`.
+
+## 5. Возвраты
+
+![Заявки на возврат товара от заказчиков](/assets/new/marketplace/chairman/market-tour/05-returns.png)
+
+Раздел **«Возвраты»** — лента заявок на возврат, которые заказчики оформили после получения товара. Председатель видит причину возврата и может одобрить/отклонить заявку (или передать обработку оператору ПВЗ).
+
+## 6. Списания скоропорта
+
+![Управление черновиками списания: проект → совет → атомарное списание](/assets/new/marketplace/chairman/market-tour/06-writeoffs.png)
+
+**«Списания скоропорта»** — раздел для управления списанием товаров с истёкшим сроком годности или повреждённых при хранении.
+
+Описание процесса (из текста на странице):
+
+> Сначала собирается черновик списания (вручную или автоматически крон-сервисом). Затем председатель подписывает Заявление 1106 и отправляет проект в совет. Совет голосует через свою повестку и подписывает Протокол 1105 — backend сам атомарно списывает позиции через пары `o.mkt.wroff` + `o.mkt.wroff2`.
+
+Структура:
+- **«В работе совета»** — карточка с числом проектов и их общей суммой.
+- **Лента активных проектов** (плейсхолдер «Нет проектов на повестке. Откройте новый черновик или дождитесь, пока крон-сервис подберёт скоропорт»).
+- **Архив** — закрытые проекты (плейсхолдер «Архив пуст»).
+- Кнопка **«+ Новый черновик»** в правом верхнем углу запускает форму ручного создания списания.
+
+## 7. Склад: сводка
+
+![Сводный остаток товаров по всем ПВЗ](/assets/new/marketplace/chairman/market-tour/07-warehouse-summary.png)
+
+**«Склад: сводка»** — агрегированный остаток товаров по всем ПВЗ кооператива. Председатель видит, где какой товар лежит и в каком количестве. Этот раздел используется для планирования логистики между ПВЗ.
+
+## 8. Реестр экосистемы
+
+![Текущий кооператив и список других кооперативов с расширением «Стол заказов»](/assets/new/marketplace/chairman/market-tour/08-ecosystem.png)
+
+Раздел **«Реестр экосистемы»** показывает:
+
+- **Текущий кооператив** (карточка `voskhod установил расширение «Стол заказов»`).
+- **Другие кооперативы** с тем же расширением — для будущей межкооперативной торговли.
+
+Сейчас работает только локально внутри одного кооператива (плашка «**Межкооперативная торговля включится позже.**»).
+
+## 9. Пункты выдачи
+
+![Список ПВЗ кооператива](/assets/new/marketplace/chairman/market-tour/09-pvz-list.png)
+
+**«Пункты выдачи»** (`/market-pvz/list`) — список всех ПВЗ с их названиями, адресами и операторами. Тот же реестр виден в Столе председателя в разделе «Кооперативные Участки», но здесь — с маркетплейсной точки зрения (с фокусом на работу с заказами, а не на юр-управление).
+
+## 10. Выдача заказов на ПВЗ
+
+![Реестр товаров на пункте выдачи, готовых к передаче заказчику](/assets/new/marketplace/chairman/market-tour/10-pvz-issuance.png)
+
+Раздел **«Выдача заказов»** — рабочее место оператора ПВЗ: список товаров, ждущих передачи заказчику. Каждая строка — заказ с пометкой статуса, ФИО заказчика и кнопкой «Выдать» (с подтверждением подписи).
+
+## 11. Возвраты на ПВЗ
+
+![Обработка возвратов оператором пункта выдачи](/assets/new/marketplace/chairman/market-tour/11-pvz-returns.png)
+
+**«Возвраты на ПВЗ»** — обратная сторона раздела «Возвраты» (шаг 5): здесь оператор ПВЗ принимает товар обратно, ставит причину, фотографирует упаковку и закрывает заявку.
+
+## 12. Склад ПВЗ
+
+![Остаток товаров у конкретного пункта выдачи](/assets/new/marketplace/chairman/market-tour/12-pvz-warehouse.png)
+
+**«Склад ПВЗ»** — остаток товаров у конкретного пункта выдачи. По сравнению с «Складом: сводка» (шаг 7) — здесь только свой ПВЗ. Оператор использует этот экран, чтобы провести инвентаризацию.
+
+---
+
+!!!note "Что дальше"
+    - Если предстоит работа с конкретной ролью (оператор ПВЗ, председатель ПВЗ, заказчик, поставщик) — см. соответствующую инструкцию в разделе [Marketplace](../../marketplace/).
+    - Если предстоит первоначальная настройка Стола председателя — см. [Стол председателя ПК — обзор разделов](./dashboard.md).
+    - Регламент работы маркетплейса описан в [Положении о Целевой Программе «Стол заказов»](../../reference/marketplace-program/).
@@ -206,6 +206,8 @@ nav:
      - Заказы участка: new/marketplace/branch-chairman/branch-orders.md
      - Обработка возвратов: new/marketplace/branch-chairman/return-approve.md
    - Стол председателя кооператива (Marketplace):
+      - Обзор Стола председателя: new/marketplace/chairman/dashboard.md
+      - Экскурсия по разделам Стола заказов: new/marketplace/chairman/market-tour.md
      - Модерация предложений: new/marketplace/chairman/offer-moderation.md
      - Категории ЦПП: new/marketplace/chairman/category-whitelist.md
      - Сеть ПВЗ: new/marketplace/chairman/branches.md