@coopenomics/desktop 2025.7.3 → 2025.11.8-alpha-2

package/.browserslistrc

@@ -0,0 +1,4 @@
+> 1%
+last 2 versions
+not dead
+not ie 11

package/.cursor/rules/confirm-dialog.mdc

@@ -0,0 +1,90 @@
+---
+description: Правило реализации диалогов подтверждения для действий
+alwaysApply: false
+---
+## Правило реализации диалогов подтверждения
+
+### Принцип
+Диалоги подтверждения должны реализовываться в UI компонентах кнопок, а не в composables функций моделей. Composable отвечает только за бизнес-логику выполнения действия.
+
+### Структура реализации
+
+```vue
+<template lang="pug">
+q-btn(
+  @click='showDialog = true',
+  :loading='isSubmitting'
+)
+  // иконка действия
+
+  q-dialog(v-model='showDialog', @hide='close')
+    ModalBase(title='Заголовок действия')
+      Form.q-pa-sm(
+        :handler-submit='handleAction',
+        :is-submitting='isSubmitting',
+        :button-cancel-txt='"Отменить"',
+        :button-submit-txt='"Выполнить"',
+        @cancel='close'
+      )
+        div(style='max-width: 400px')
+          p Подтверждающее сообщение
+          // дополнительные поля ввода если нужны
+</template>
+
+<script lang="ts" setup>
+// Импорты
+import { FailAlert, SuccessAlert } from 'src/shared/api';
+import { useModelFunction } from '../model';
+import { ref } from 'vue';
+import { ModalBase } from 'src/shared/ui/ModalBase';
+import { Form } from 'src/shared/ui/Form';
+
+// Props, emits
+const emit = defineEmits(['actionCompleted', 'close']);
+
+// Состояние
+const { actionFunction } = useModelFunction();
+const isSubmitting = ref(false);
+const showDialog = ref(false);
+
+// Важно: composable useModelFunction НЕ содержит try-catch!
+// Он просто выполняет действие и возвращает результат.
+// Вся обработка ошибок происходит здесь, в UI компоненте.
+
+// Функции
+const close = () => {
+  showDialog.value = false;
+  emit('close');
+};
+
+const handleAction = async () => {
+  isSubmitting.value = true;
+  try {
+    await actionFunction(params);
+    SuccessAlert('Действие выполнено');
+    emit('actionCompleted');
+    close();
+  } catch (e: any) {
+    FailAlert(`Возникла ошибка: ${e.message}`);
+    close();
+  } finally {
+    isSubmitting.value = false;
+  }
+};
+</script>
+```
+
+### Ключевые моменты
+- **Диалог в компоненте**: Не в composable, а в UI компоненте
+- **Состояние в компоненте**: `showDialog`, `isSubmitting` управляются локально
+- **Эмиссия событий**: Для внешней обработки результатов действия
+- **Composable без try-catch**: Функции модели НЕ содержат обработку ошибок, только выполнение действия
+- **Уведомления**: Использовать `FailAlert`/`SuccessAlert` вместо прямых вызовов Notify
+- **Валидация**: Проверять данные перед отправкой в composable
+- **Очистка состояния**: Сбрасывать поля при закрытии диалога
+- **Нет window.location.reload()**: Обновление данных через store или emits
+
+### Примеры применения
+- Удаление объектов (DeleteStoryButton.vue)
+- Подтверждение действий (ConfirmApprovalButton.vue)
+- Отклонение с причиной (DeclineApprovalButton.vue)

package/.cursor/rules/entities.mdc

@@ -0,0 +1,253 @@
+---
+globs: ["**/entities/**/*.ts", "**/entities/**/*.vue"]
+alwaysApply: false
+---
+## Архитектура сущностей (Entities Layer)
+
+### Общее устройство
+
+Слой сущностей содержит бизнес-сущности приложения и их модели данных. Каждая сущность имеет строгую структуру и отвечает только за хранение и управление данными.
+
+**Запрещено**: Размещать методы действий (мутаций) в сущностях. Действия должны быть в фичах (features).
+
+### Структура папок сущности
+
+```
+entities/
+  EntityName/
+    index.ts           # Экспорт модели и API
+    api/
+      index.ts         # Функции для работы с GraphQL API
+    model/
+      index.ts         # Экспорт типов и store
+      types.ts         # Типы сущностей на основе SDK
+      store.ts         # Pinia store для реактивного состояния
+```
+
+### Организация типов (model/types.ts)
+
+#### Импорты
+```typescript
+import type { Queries, Mutations, Zeus } from '@coopenomics/sdk';
+```
+
+#### Паттерны типизации
+
+**Для простых сущностей:**
+```typescript
+// Тип пагинированного списка
+export type IEntitiesPagination =
+  Queries.Extension.GetEntities.IOutput[typeof Queries.Extension.GetEntities.name];
+
+// Тип одной сущности
+export type IEntity = IEntitiesPagination['items'][0];
+
+// Типы входных параметров
+export type IGetEntitiesInput = Queries.Extension.GetEntities.IInput;
+export type IGetEntityInput = Queries.Extension.GetEntity.IInput['data'];
+
+// Типы выходных данных мутаций
+export type ICreateEntityInput = Mutations.Extension.CreateEntity.IInput['data'];
+export type ICreateEntityOutput =
+  Mutations.Extension.CreateEntity.IOutput[typeof Mutations.Extension.CreateEntity.name];
+```
+
+**Для сложных сущностей с отношениями:**
+```typescript
+// Базовый тип из Zeus
+export type IEntity = Zeus.ModelTypes['ExtensionEntity'];
+
+// Тип с отношениями
+export type IEntityWithRelations =
+  Queries.Extension.GetEntityWithRelations.IOutput[typeof Queries.Extension.GetEntityWithRelations.name];
+```
+
+#### Правила именования типов
+- `IEntityName` - основная сущность
+- `IEntityNames` - массив сущностей
+- `IEntityNamePagination` - пагинированный ответ
+- `IGetEntityNameInput` - входные параметры для получения
+- `ICreateEntityNameInput/Output` - вход/выход для создания
+- `IUpdateEntityNameInput/Output` - вход/выход для обновления
+- `IDeleteEntityNameInput/Output` - вход/выход для удаления
+
+### Организация Store (model/store.ts)
+
+#### Структура store
+```typescript
+import { defineStore } from 'pinia';
+import { ref, Ref } from 'vue';
+import { api } from '../api';
+import type { IEntity, IEntitiesPagination, IGetEntityInput } from './types';
+
+const namespace = 'entityStore';
+
+interface IEntityStore {
+  // Реактивные состояния
+  entities: Ref<IEntitiesPagination | null>;
+  entity: Ref<IEntity | null>;
+
+  // Методы загрузки данных (только запросы!)
+  loadEntities: (data: IGetEntitiesInput) => Promise<void>;
+  loadEntity: (data: IGetEntityInput) => Promise<IEntity>;
+}
+
+export const useEntityStore = defineStore(namespace, (): IEntityStore => {
+  // Реактивные ref'ы
+  const entities = ref<IEntitiesPagination | null>(null);
+  const entity = ref<IEntity | null>(null);
+
+  // Методы загрузки (только чтение!)
+  const loadEntities = async (data: IGetEntitiesInput): Promise<void> => {
+    const loadedData = await api.loadEntities(data);
+    entities.value = loadedData;
+  };
+
+  const loadEntity = async (data: IGetEntityInput): Promise<IEntity> => {
+    const loadedData = await api.loadEntity(data);
+    entity.value = loadedData;
+    return loadedData;
+  };
+
+  return {
+    entities,
+    entity,
+    loadEntities,
+    loadEntity,
+  };
+});
+```
+
+#### Правила для store
+- **Только запросы**: Store содержит только методы чтения данных
+- **Реактивное состояние**: Все данные хранятся в ref'ах
+- **Интерфейс типизации**: Обязателен для типизации store
+- **Namespace**: Уникальное имя для каждого store
+- **Методы обновления списка**: Для поддержания консистентности данных
+
+#### Методы управления списком
+```typescript
+const addEntityToList = (entityData: IEntity) => {
+  if (entities.value) {
+    const existingIndex = entities.value.items.findIndex(
+      (item) => item._id === entityData._id,
+    );
+
+    if (existingIndex !== -1) {
+      // Заменяем существующую
+      entities.value.items[existingIndex] = entityData;
+    } else {
+      // Добавляем новую в начало
+      entities.value.items = [entityData, ...entities.value.items];
+      entities.value.totalCount += 1;
+    }
+  }
+};
+
+const updateEntityInList = (entityData: IEntity) => {
+  if (entities.value) {
+    const existingIndex = entities.value.items.findIndex(
+      (item) => item._id === entityData._id,
+    );
+
+    if (existingIndex !== -1) {
+      // Обновляем существующую на месте
+      entities.value.items[existingIndex] = entityData;
+    }
+  }
+};
+
+const removeEntityFromList = (entityId: string) => {
+  if (entities.value) {
+    const index = entities.value.items.findIndex(
+      (item) => item._id === entityId,
+    );
+
+    if (index !== -1) {
+      entities.value.items.splice(index, 1);
+      entities.value.totalCount -= 1;
+    }
+  }
+};
+```
+
+
+### Организация API (api/index.ts)
+
+#### Структура API функций
+```typescript
+import { client } from 'src/shared/api/client';
+import { Queries } from '@coopenomics/sdk';
+import type { IEntity, IGetEntityInput } from '../model';
+
+async function loadEntities(data: IGetEntitiesInput): Promise<IEntitiesPagination> {
+  const { [Queries.Extension.GetEntities.name]: output } = await client.Query(
+    Queries.Extension.GetEntities.query,
+    {
+      variables: data,
+    },
+  );
+  return output;
+}
+
+async function loadEntity(data: IGetEntityInput): Promise<IEntity> {
+  const { [Queries.Extension.GetEntity.name]: output } = await client.Query(
+    Queries.Extension.GetEntity.query,
+    {
+      variables: {
+        data,
+      },
+    },
+  );
+  return output;
+}
+
+export const api = {
+  loadEntities,
+  loadEntity,
+};
+```
+
+#### Правила для API
+- **Только функции-запросы**: Никаких мутаций в API сущностей
+- **Строгая типизация**: Все параметры и возвраты типизированы
+- **Использование SDK**: Все запросы через GraphQL Zeus SDK
+- **Единый экспорт**: Все функции экспортируются через объект `api`
+
+### Экспорты и индексные файлы
+
+#### Сущность (entities/EntityName/index.ts)
+```typescript
+export * as EntityNameModel from './model';
+export * from './api';
+```
+
+#### Слой сущностей (entities/index.ts)
+```typescript
+export * as EntityName from './EntityName';
+export * as AnotherEntity from './AnotherEntity';
+```
+
+#### Расширение (extensions/extension-name/index.ts)
+```typescript
+export * from './entities';
+export * from './features';
+export * from './widgets';
+```
+
+### Важные принципы
+
+#### Типизация
+- Все типы из SDK GraphQL Zeus
+- Строгая типизация всех входов/выходов
+- Интерфейсы для store объектов
+
+#### Реактивность
+- Все данные в Pinia stores
+- Использование Vue ref/computed
+- Автоматические обновления UI
+
+#### Запреты
+- ❌ Мутации в сущностях
+- ❌ Прямые запросы к API в компонентах
+- ❌ Неиспользуемые переменные/импорты

package/.cursor/rules/extensions-architecture.mdc

@@ -0,0 +1,130 @@
+---
+globs: ["**/desktop/extensions/**/*"]
+alwaysApply: false
+---
+## Расширения (Extensions)
+
+### Общее устройство
+
+Расширения - это изолированные модули приложения, каждый из которых реализует отдельный функционал. Расширения максимально независимы и следуют принципам Feature Sliced Design.
+
+### Структура расширения
+
+```
+extension-name/
+  entities/        # Сущности расширения
+  features/        # Фичи расширения
+  widgets/         # Виджеты расширения
+  pages/           # Страницы расширения
+  index.ts         # export * from './entities' etc.
+  install.ts       # IWorkspaceConfig с маршрутами и меню
+```
+
+### Файл install.ts
+
+#### Роль и назначение
+Файл `install.ts` отвечает за интеграцию расширения в систему рабочих столов. Он:
+- Определяет маршруты расширения
+- Настраивает меню рабочего стола
+- Управляет видимостью в левом дровере
+- Задает роли доступа к разделам
+
+#### Структура конфигурации
+```typescript
+import { markRaw } from 'vue';
+import type { IWorkspaceConfig } from 'src/shared/lib/types/workspace';
+
+export default async function (): Promise<IWorkspaceConfig> {
+  return {
+    workspace: 'extension-name',     // Уникальный идентификатор рабочего стола
+    title: 'Название рабочего стола', // Отображаемое название
+    defaultRoute: 'default-route',    // Маршрут по умолчанию
+    routes: [
+      {
+        meta: {
+          title: 'Название раздела',
+          icon: 'fa-solid fa-icon',
+          roles: ['chairman', 'member', 'user'], // Роли с доступом: chairman, member, user. Пустой массив [] - доступ у всех
+        },
+        path: '/:coopname/extension-name',
+        name: 'extension-name',
+        component: markRaw(MainComponent),
+        children: [
+          // Вложенные маршруты
+        ],
+      },
+    ],
+  };
+}
+```
+
+#### Уровни видимости в меню
+
+##### Первый уровень: Рабочий стол
+- Расширение появляется в меню рабочих столов
+- Задается в корневом маршруте с `path: '/:coopname/extension-name'`
+
+##### Второй уровень: Левый дровер
+- Кнопки разделов внутри рабочего стола
+- Управляется свойством `hidden: true/false` в meta роута
+- Если `hidden: true` - раздел не отображается в левом дровере
+
+#### Пример с видимостью
+```typescript
+{
+  path: 'projects/:project_hash/tasks/:issue_hash',
+  name: 'project-issue',
+  component: markRaw(IssuePage),
+  meta: {
+    title: 'Задача',
+    icon: 'fa-solid fa-task',
+    roles: [],
+    agreements: agreementsBase,
+    requiresAuth: true,
+    hidden: true, // Не показывать в левом дровере
+  },
+}
+```
+
+### Экспорты расширения
+
+#### index.ts расширения
+```typescript
+export * from './entities';
+export * from './features';
+export * from './widgets';
+export * from './pages';
+```
+
+#### Регистрация в системе
+Расширения регистрируются через систему расширений и становятся доступны в магазине расширений для установки.
+
+### Правила изоляции
+
+#### Запреты
+- ❌ Импорты между расширениями запрещены
+- ❌ Совместное использование сущностей между расширениями
+- ❌ Прямые зависимости между расширениями
+
+#### Разрешения
+- ✅ Импорт из `src/shared` (общие компоненты)
+- ✅ Исключения: `FailAlert`, `SuccessAlert` (глобальные уведомления)
+
+### Важные принципы
+
+#### Разделение ответственности
+- **Entities**: Только данные и их загрузка
+- **Features**: Бизнес-логика и действия
+- **Widgets**: Комплексные UI компоненты
+- **Pages**: Корневые страницы расширения
+
+#### Конфигурация меню
+- Роли доступа: `chairman`, `member`, `user`
+- Пустой массив `roles: []` означает доступ у всех ролей
+- Видимость управляется через `hidden` свойство
+- Иконки и названия должны быть информативными
+
+#### Разработка расширений
+- Расширения разрабатываются независимо
+- Каждый расширение - отдельный функциональный модуль
+- Возможность отключения/включения расширений