@coopenomics/desktop 2025.7.3 → 2025.11.8-alpha-2

package/WIDGET_README.md

@@ -0,0 +1,368 @@
+# MonoCoop Widget System
+
+Система безопасного встраивания MonoCoop приложения как виджета через iframe.
+
+## Обзор
+
+Widget система позволяет встраивать части MonoCoop приложения на внешние сайты через iframe с безопасной двусторонней коммуникацией через postMessage API.
+
+## Архитектура
+
+### Компоненты системы
+
+1. **Widget Mode** - специальный режим работы приложения для iframe
+2. **PostMessage Bridge** - безопасная коммуникация между iframe и родительским окном
+3. **JavaScript SDK** - библиотека для встраивания виджетов
+4. **Widget Layout** - специальный layout без лишних элементов UI
+
+### Безопасность
+
+- ✅ Проверка origin отправителя
+- ✅ Валидация входящих данных
+- ✅ Ограничение доступных API методов
+- ✅ Sandbox атрибуты для iframe
+- ✅ CSP заголовки (рекомендуется)
+
+## Использование
+
+### 1. Подключение SDK
+
+```html
+<!-- Подключаем SDK -->
+<script src="https://your-domain.com/monocoop-widget-sdk.js"></script>
+```
+
+### 2. Создание виджета
+
+```javascript
+// Создание виджета
+const widget = MonoCoopWidget.create({
+  baseUrl: 'https://your-monocoop-app.com',
+  containerId: 'widget-container', // или container: document.getElementById('container')
+  page: '/signup', // необязательно, начальная страница
+  theme: 'light', // 'light' или 'dark'
+  width: '100%',
+  height: '500px',
+  hideHeader: true,
+  hideFooter: true,
+  autoResize: true,
+  allowedOrigins: ['https://your-site.com'], // ВАЖНО: указывайте конкретные домены
+
+  // Начальные данные
+  initialData: {
+    userId: 123,
+    theme: 'light',
+    locale: 'ru',
+  },
+});
+
+// Подписка на события
+widget
+  .on('ready', (data) => {
+    console.log('Widget готов!', data);
+  })
+  .on('dataChange', (data) => {
+    console.log('Данные изменились:', data);
+  })
+  .on('error', (error) => {
+    console.error('Ошибка виджета:', error);
+  })
+  .on('navigate', (data) => {
+    console.log('Навигация:', data);
+  })
+  .on('resize', (dimensions) => {
+    console.log('Размер изменился:', dimensions);
+  });
+
+// Монтирование виджета
+widget.mount();
+```
+
+### 3. Взаимодействие с виджетом
+
+```javascript
+// Отправка данных в виджет
+widget.setData({
+  userId: 456,
+  settings: { theme: 'dark' },
+});
+
+// Получение данных из виджета
+const data = await widget.getData();
+console.log('Данные из виджета:', data);
+
+// Навигация внутри виджета
+widget.navigateTo('/profile');
+
+// Обновление конфигурации
+widget.updateConfig({
+  theme: 'dark',
+  hideHeader: false,
+});
+
+// Уничтожение виджета
+widget.destroy();
+```
+
+## Конфигурация
+
+### Основные параметры
+
+| Параметр            | Тип               | Обязательный | Описание                              |
+| ------------------- | ----------------- | ------------ | ------------------------------------- |
+| `baseUrl`           | string            | ✅           | URL MonoCoop приложения               |
+| `containerId`       | string            | ✅\*         | ID контейнера для виджета             |
+| `container`         | HTMLElement       | ✅\*         | DOM элемент контейнера                |
+| `page`              | string            | ❌           | Начальная страница                    |
+| `theme`             | 'light' \| 'dark' | ❌           | Тема оформления                       |
+| `width`             | string            | ❌           | Ширина виджета (по умолчанию '100%')  |
+| `height`            | string            | ❌           | Высота виджета (по умолчанию '400px') |
+| `hideHeader`        | boolean           | ❌           | Скрыть заголовок (по умолчанию true)  |
+| `hideFooter`        | boolean           | ❌           | Скрыть футер (по умолчанию true)      |
+| `disableNavigation` | boolean           | ❌           | Отключить навигацию                   |
+| `autoResize`        | boolean           | ❌           | Автоматическое изменение размера      |
+| `allowedOrigins`    | string[]          | ❌           | Разрешенные домены                    |
+| `initialData`       | any               | ❌           | Начальные данные                      |
+| `loadingText`       | string            | ❌           | Текст загрузки                        |
+| `errorText`         | string            | ❌           | Текст ошибки                          |
+| `timeout`           | number            | ❌           | Таймаут загрузки в мс                 |
+
+\*Один из параметров `containerId` или `container` обязателен.
+
+### Sandbox атрибуты
+
+По умолчанию используются следующие sandbox атрибуты:
+
+- `allow-scripts` - разрешить выполнение скриптов
+- `allow-same-origin` - разрешить доступ к origin
+- `allow-forms` - разрешить отправку форм
+- `allow-popups` - разрешить всплывающие окна
+
+## События
+
+### Исходящие события (из виджета)
+
+| Событие      | Описание                 | Данные                    |
+| ------------ | ------------------------ | ------------------------- |
+| `ready`      | Виджет готов к работе    | `{ config, timestamp }`   |
+| `dataChange` | Данные изменились        | `any`                     |
+| `error`      | Произошла ошибка         | `{ message, stack, ... }` |
+| `navigate`   | Навигация внутри виджета | `{ path }`                |
+| `resize`     | Изменился размер виджета | `{ width, height }`       |
+
+### Входящие события (в виджет)
+
+| Событие        | Описание              | Данные                   |
+| -------------- | --------------------- | ------------------------ |
+| `setData`      | Установить данные     | `any`                    |
+| `getData`      | Получить данные       | -                        |
+| `navigateTo`   | Перейти на страницу   | `string`                 |
+| `updateConfig` | Обновить конфигурацию | `Partial<IWidgetConfig>` |
+| `destroy`      | Уничтожить виджет     | -                        |
+
+## Примеры использования
+
+### Простой виджет
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Simple Widget</title>
+  </head>
+  <body>
+    <div id="widget"></div>
+
+    <script src="monocoop-widget-sdk.js"></script>
+    <script>
+      MonoCoopWidget.mount({
+        baseUrl: 'https://your-app.com',
+        containerId: 'widget',
+        page: '/signup',
+        allowedOrigins: ['https://your-site.com'],
+      });
+    </script>
+  </body>
+</html>
+```
+
+### Виджет с взаимодействием
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Interactive Widget</title>
+  </head>
+  <body>
+    <div id="widget"></div>
+    <button onclick="sendUserData()">Send User Data</button>
+    <button onclick="getUserData()">Get User Data</button>
+
+    <script src="monocoop-widget-sdk.js"></script>
+    <script>
+      const widget = MonoCoopWidget.create({
+        baseUrl: 'https://your-app.com',
+        containerId: 'widget',
+        allowedOrigins: ['https://your-site.com'],
+      });
+
+      widget.on('ready', () => {
+        console.log('Widget is ready!');
+      });
+
+      widget.on('dataChange', (data) => {
+        console.log('New data:', data);
+      });
+
+      widget.mount();
+
+      function sendUserData() {
+        widget.setData({
+          userId: 123,
+          name: 'John Doe',
+          email: 'john@example.com',
+        });
+      }
+
+      async function getUserData() {
+        const data = await widget.getData();
+        console.log('User data:', data);
+      }
+    </script>
+  </body>
+</html>
+```
+
+## Безопасность
+
+### Рекомендации
+
+1. **Всегда указывайте конкретные домены в `allowedOrigins`**:
+
+   ```javascript
+   allowedOrigins: ['https://your-site.com', 'https://subdomain.your-site.com'];
+   ```
+
+2. **Используйте HTTPS для всех коммуникаций**
+
+3. **Валидируйте данные на сервере**
+
+4. **Настройте CSP заголовки**:
+
+   ```
+   Content-Security-Policy: frame-ancestors 'self' https://trusted-site.com
+   ```
+
+5. **Ограничьте доступные страницы виджета**
+
+### Потенциальные уязвимости
+
+- ❌ Использование `allowedOrigins: ['*']` в production
+- ❌ Передача конфиденциальных данных через postMessage
+- ❌ Отсутствие валидации входящих данных
+- ❌ Использование HTTP вместо HTTPS
+
+## Отладка
+
+### Логи
+
+SDK автоматически выводит логи в console с префиксом `[Widget]`:
+
+```javascript
+// Включить детальные логи
+MonoCoopWidget.create({
+  // ...
+  debug: true,
+});
+```
+
+### Проверка состояния
+
+```javascript
+// Проверить готовность виджета
+console.log('Widget ready:', widget.isReady);
+
+// Получить конфигурацию
+console.log('Config:', widget.config);
+
+// Получить историю событий
+console.log('Events:', widget.getEventHistory());
+```
+
+## Troubleshooting
+
+### Частые проблемы
+
+1. **Виджет не загружается**
+   - Проверьте правильность `baseUrl`
+   - Убедитесь, что сервер доступен
+   - Проверьте CORS настройки
+
+2. **Ошибка "Blocked message from unauthorized origin"**
+   - Добавьте домен в `allowedOrigins`
+   - Проверьте правильность URL
+
+3. **Виджет не отвечает на сообщения**
+   - Проверьте, что виджет в состоянии `ready`
+   - Убедитесь, что данные корректно сериализуются
+
+4. **Проблемы с размером**
+   - Включите `autoResize: true`
+   - Проверьте CSS стили контейнера
+
+## Интеграция с MonoCoop приложением
+
+### Использование в компонентах
+
+```vue
+<template>
+  <div class="widget-component">
+    <div v-if="isWidget">
+      <!-- Специальный контент для widget режима -->
+      <simplified-interface />
+    </div>
+    <div v-else>
+      <!-- Обычный контент -->
+      <full-interface />
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { useWidgetBridge } from '@/shared/lib/widget/use-widget-bridge';
+
+const { isWidget, widgetData, sendData } = useWidgetBridge();
+
+// Отправка данных родительскому окну
+function handleDataChange(data) {
+  if (isWidget.value) {
+    sendData(data);
+  }
+}
+</script>
+```
+
+### Обработка событий
+
+```javascript
+// В main.js или boot файле
+import { useWidgetEvents } from '@/shared/lib/widget/widget-events';
+
+const {} = useWidgetEvents({
+  onReady: (data) => {
+    console.log('Widget готов:', data);
+  },
+  onDataChange: (data) => {
+    // Обработка входящих данных
+    store.dispatch('updateWidgetData', data);
+  },
+  onError: (error) => {
+    console.error('Ошибка виджета:', error);
+  },
+});
+```
+
+## Лицензия
+
+MIT License - см. файл LICENSE для подробностей.

package/example_contributors.csv

@@ -0,0 +1,6 @@
+username,contribution_amount,contributor_hash,memo
+user1,1000.00,hash123456789,Первый участник
+user2,2500.50,hash987654321,Второй участник с большим взносом
+user3,750.25,hash111222333,Третий участник
+user4,500.00,hash444555666,Четвертый участник
+user5,3000.75,hash777888999,Пятый участник с максимальным взносом

package/extensions/capital/app/extensions.ts

@@ -0,0 +1,34 @@
+import { decisionFactory } from 'src/shared/lib/decision-factory';
+import { useGenerateResultContributionDecision } from '../features/Result/GenerateResultContributionDecision/model';
+import { CreateResultDecisionInfoWidget } from '../widgets/CreateResultDecisionInfoWidget';
+
+/**
+ * Регистрация обработчиков решений для расширения capital
+ * Этот файл содержит регистрацию обработчиков решений для расширения capital
+ */
+export function registerCapitalDecisionHandlers() {
+  // Обработчик для createresult (решение о приросте капитализации из задания)
+  decisionFactory.registerHandler('createresult', {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    generateHandler: async ({ decision_id, username, row }) => {
+      if (!row.table?.statement?.meta) {
+        throw new Error(
+          'Отсутствуют метаданные заявления для решения createresult',
+        );
+      }
+
+      // const parsedDocumentMeta = JSON.parse(row.table.statement.meta) as {
+      //   result_hash: string;
+      // };
+
+      const { generateResultContributionDecision } =
+        useGenerateResultContributionDecision();
+
+      return await generateResultContributionDecision({
+        username,
+      });
+    },
+    // Компонент для отображения дополнительной информации
+    infoComponent: CreateResultDecisionInfoWidget,
+  });
+}

package/extensions/capital/entities/Commit/api/index.ts

@@ -0,0 +1,37 @@
+import { client } from 'src/shared/api/client';
+import { Queries } from '@coopenomics/sdk';
+import type {
+  IGetCommitsInput,
+  ICommitsPagination,
+  IGetCommitInput,
+  IGetCommitOutput,
+} from '../model/types';
+
+async function loadCommits(
+  data: IGetCommitsInput,
+): Promise<ICommitsPagination> {
+  const { [Queries.Capital.GetCommits.name]: output } = await client.Query(
+    Queries.Capital.GetCommits.query,
+    {
+      variables: data,
+    },
+  );
+  return output;
+}
+
+async function loadCommit(data: IGetCommitInput): Promise<IGetCommitOutput> {
+  const { [Queries.Capital.GetCommit.name]: output } = await client.Query(
+    Queries.Capital.GetCommit.query,
+    {
+      variables: {
+        data,
+      },
+    },
+  );
+  return output;
+}
+
+export const api = {
+  loadCommits,
+  loadCommit,
+};

package/extensions/capital/entities/Commit/index.ts

@@ -0,0 +1,2 @@
+export * as CommitModel from './model';
+export * from './api';

package/extensions/capital/entities/Commit/model/index.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './store';

package/extensions/capital/entities/Commit/model/store.ts

@@ -0,0 +1,49 @@
+import { defineStore } from 'pinia';
+import { ref, Ref } from 'vue';
+import { api } from '../api';
+import type { ICommitsPagination, IGetCommitsInput, ICommit } from './types';
+
+const namespace = 'commitStore';
+
+interface ICommitStore {
+  commits: Ref<ICommitsPagination | null>;
+  loadCommits: (data: IGetCommitsInput) => Promise<void>;
+  updateCommitInList: (commitData: ICommit) => void;
+}
+
+export const useCommitStore = defineStore(namespace, (): ICommitStore => {
+  const commits = ref<ICommitsPagination | null>(null);
+
+  const loadCommits = async (data: IGetCommitsInput): Promise<void> => {
+    const loadedData = await api.loadCommits(data);
+    commits.value = loadedData;
+  };
+
+  const updateCommitInList = (commitData: ICommit) => {
+    if (!commits.value) return;
+
+    // Ищем существующий коммит по commit_hash
+    const existingIndex = commits.value.items.findIndex(
+      (commit) => commit.commit_hash === commitData.commit_hash,
+    );
+
+    if (existingIndex !== -1) {
+      // Заменяем существующий коммит
+      commits.value.items[existingIndex] = commitData as any;
+    } else {
+      // Добавляем новый коммит в начало списка
+      commits.value.items = [
+        commitData as any,
+        ...commits.value.items,
+      ];
+      // Увеличиваем общее количество
+      commits.value.totalCount += 1;
+    }
+  };
+
+  return {
+    commits,
+    loadCommits,
+    updateCommitInList,
+  };
+});

package/extensions/capital/entities/Commit/model/types.ts

@@ -0,0 +1,15 @@
+import type { Queries, Mutations, Zeus } from '@coopenomics/sdk';
+
+export type ICommitsPagination =
+  Queries.Capital.GetCommits.IOutput[typeof Queries.Capital.GetCommits.name];
+
+export type ICommit = Zeus.ModelTypes['CapitalCommit'];
+
+export type IGetCommitsInput = Queries.Capital.GetCommits.IInput;
+export type IGetCommitsFilter = IGetCommitsInput['filter'];
+export type IGetCommitInput = Queries.Capital.GetCommit.IInput['data'];
+export type IGetCommitOutput =
+  Queries.Capital.GetCommit.IOutput[typeof Queries.Capital.GetCommit.name];
+export type ICreateCommitInput = Mutations.Capital.CreateCommit.IInput['data'];
+export type ICreateCommitOutput =
+  Mutations.Capital.CreateCommit.IOutput[typeof Mutations.Capital.CreateCommit.name];

package/extensions/capital/entities/Config/api/index.ts

@@ -0,0 +1,19 @@
+import { client } from 'src/shared/api/client';
+import { Queries } from '@coopenomics/sdk';
+import type { IGetStateInput, IState } from '../model';
+
+async function loadState(data: IGetStateInput): Promise<IState> {
+  const { [Queries.Capital.GetState.name]: output } = await client.Query(
+    Queries.Capital.GetState.query,
+    {
+      variables: {
+        data,
+      },
+    },
+  );
+  return output;
+}
+
+export const api = {
+  loadState,
+};

package/extensions/capital/entities/Config/index.ts

@@ -0,0 +1,2 @@
+export * as ConfigModel from './model';
+export * from './api';

package/extensions/capital/entities/Config/model/index.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './store';

package/extensions/capital/entities/Config/model/store.ts

@@ -0,0 +1,25 @@
+import { defineStore } from 'pinia';
+import { ref, Ref } from 'vue';
+import { api } from '../api';
+import type { IState, IGetStateInput } from './types';
+
+const namespace = 'configStore';
+
+interface IConfigStore {
+  state: Ref<IState | null>;
+  loadState: (data: IGetStateInput) => Promise<void>;
+}
+
+export const useConfigStore = defineStore(namespace, (): IConfigStore => {
+  const state = ref<IState | null>(null);
+
+  const loadState = async (data: IGetStateInput): Promise<void> => {
+    const loadedData = await api.loadState(data);
+    state.value = loadedData;
+  };
+
+  return {
+    state,
+    loadState,
+  };
+});

package/extensions/capital/entities/Config/model/types.ts

@@ -0,0 +1,9 @@
+import type { Queries, Mutations } from '@coopenomics/sdk';
+
+export type IState =
+  Queries.Capital.GetState.IOutput[typeof Queries.Capital.GetState.name];
+
+export type IGetStateInput = Queries.Capital.GetState.IInput['data'];
+export type ISetConfigInput = Mutations.Capital.SetConfig.IInput['data'];
+export type ISetConfigOutput =
+  Mutations.Capital.SetConfig.IOutput[typeof Mutations.Capital.SetConfig.name];

package/extensions/capital/entities/Contributor/api/index.ts

@@ -0,0 +1,40 @@
+import { client } from 'src/shared/api/client';
+import { Queries } from '@coopenomics/sdk';
+import type {
+  IContributor,
+  IContributorsPagination,
+  IGetContributorInput,
+  IGetContributorsInput,
+} from '../model';
+
+async function loadContributors(
+  data: IGetContributorsInput,
+): Promise<IContributorsPagination> {
+
+  const { [Queries.Capital.GetContributors.name]: output } = await client.Query(
+    Queries.Capital.GetContributors.query,
+    {
+      variables: data,
+    },
+  );
+  return output;
+}
+
+async function loadContributor(
+  data: IGetContributorInput,
+): Promise<IContributor> {
+  const { [Queries.Capital.GetContributor.name]: output } = await client.Query(
+    Queries.Capital.GetContributor.query,
+    {
+      variables: {
+        data,
+      },
+    },
+  );
+  return output;
+}
+
+export const api = {
+  loadContributors,
+  loadContributor,
+};

package/extensions/capital/entities/Contributor/index.ts

@@ -0,0 +1,3 @@
+export * as ContributorModel from './model';
+export * from './api';
+export * from './ui';

package/extensions/capital/entities/Contributor/model/index.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './store';