@ozdao/martyrs 0.2.518 → 0.2.520

package/src/modules/globals/controllers/classes/globals.observer.js

@@ -2,17 +2,19 @@ class Observer {
   constructor() {
     this.listeners = {};
   }
+
   subscribe(eventType, callback, once = false) {
     if (!this.listeners[eventType]) {
       this.listeners[eventType] = new Map();
     }
     this.listeners[eventType].set(callback, { once });
   }
+
   async notify(eventType, data) {
     if (this.listeners[eventType]) {
       const promises = [];
       const callbacksToRemove = [];
-      // Create a list of promises for all callbacks
+      
       for (const [callback, { once }] of this.listeners[eventType]) {
         const promise = Promise.resolve()
           .then(() => callback(data))
@@ -20,13 +22,14 @@ class Observer {
             console.error('Error executing callback:', error);
           });
         promises.push(promise);
+        
         if (once) {
           callbacksToRemove.push(callback);
         }
       }
-      // Wait for all promises to settle
+      
       await Promise.all(promises);
-      // Remove callbacks that are set to run only once
+      
       for (const callback of callbacksToRemove) {
         this.listeners[eventType].delete(callback);
         if (this.listeners[eventType].size === 0) {
@@ -35,6 +38,7 @@ class Observer {
       }
     }
   }
+
   remove(eventType, callback) {
     if (this.listeners[eventType]?.has(callback)) {
       this.listeners[eventType].delete(callback);
@@ -43,5 +47,51 @@ class Observer {
       }
     }
   }
+
+  removeAll(eventType) {
+    if (eventType) {
+      delete this.listeners[eventType];
+    } else {
+      this.listeners = {};
+    }
+  }
 }
-export default Observer;
+
+// Хранилище экземпляров по namespace
+const instances = new Map();
+
+// Экспортируем конструктор с поддержкой namespace
+export default class ObserverNamespaced {
+  constructor(namespace = 'global') {
+    // Если экземпляр для namespace уже существует, возвращаем его
+    if (instances.has(namespace)) {
+      return instances.get(namespace);
+    }
+
+    // Создаем новый экземпляр для namespace
+    const instance = new Observer();
+    instances.set(namespace, instance);
+    
+    return instance;
+  }
+
+  // Статический метод для получения всех namespace'ов
+  static getNamespaces() {
+    return Array.from(instances.keys());
+  }
+
+  // Статический метод для очистки подписок в namespace
+  static clearNamespace(namespace) {
+    if (instances.has(namespace)) {
+      instances.get(namespace).removeAll();
+    }
+  }
+
+  // Статический метод для удаления namespace (полностью)
+  static removeNamespace(namespace) {
+    if (instances.has(namespace)) {
+      instances.get(namespace).removeAll();
+      instances.delete(namespace);
+    }
+  }
+}

package/src/modules/globals/views/components/partials/Header.vue

@@ -82,7 +82,7 @@
 		<button  
 			aria-label="menu"
 			@click="() => globals.state.isOpenSidebar = !globals.state.isOpenSidebar" 
-			class="cursor-pointer menu-btn"
+			class="cursor-pointer mobile-only menu-btn"
 			:class="{
 				'menu-btn_active': globals.state.isOpenSidebar
 			}"

package/src/modules/globals/views/components/partials/Sidebar.vue

@@ -1,8 +1,7 @@
 <script setup>
 import { ref, watch } from 'vue'
-import { useRouter } from 'vue-router'
+import { useRouter, useRoute } from 'vue-router'
 import { useGlobalMixins } from "@martyrs/src/modules/globals/views/mixins/mixins.js"
-
 import * as globals from '@martyrs/src/modules/globals/views/store/globals.js'
 
 const props = defineProps({
@@ -29,19 +28,30 @@ const emits = defineEmits([
 ])
 
 const { isPhone, isTablet } = useGlobalMixins()
-
 const router = useRouter()
+const route = useRoute()
 
 const toggleSidebar = () => {
   emits('closeSidebar')
 }
 
+const handleMouseEnter = () => {
+  if (route.meta?.sidebar_hover && !isPhone() && !isTablet()) {
+    globals.state.isOpenSidebar = true
+  }
+}
+
+const handleMouseLeave = () => {
+  if (route.meta?.sidebar_hover && !isPhone() && !isTablet()) {
+    globals.state.isOpenSidebar = false
+  }
+}
+
 router.beforeEach((to, from) => {
    if (isPhone() || isTablet()) {
     emits('closeSidebar')
   }
 })
-
 </script>
 
 <template>
@@ -56,11 +66,11 @@ router.beforeEach((to, from) => {
       ? 't-black bg-white br-light'
       : 't-white bg-black br-dark'
     ]"
+    @mouseenter="handleMouseEnter"
+    @mouseleave="handleMouseLeave"
   >
-
     <!-- Slot for navigation content -->
     <slot></slot>
-
     <div v-if="MOBILE_APP" @click="() => toggleSidebar()"  class="pos-relative">
       <div class="bg-light radius-medium pd-medium">
         <p  class="t-medium t-black-transp-60">
@@ -68,7 +78,6 @@ router.beforeEach((to, from) => {
         </p>
       </div>
     </div>
-
     <div 
       class="br-solid w-100 br-t"
       :class="{ 
@@ -106,27 +115,22 @@ router.beforeEach((to, from) => {
   width: 0;
   display: none;
 }
-
 .visible {
   opacity: 1;
   display: block;
 }
-
 /* Scrollbar styles */
 ::-webkit-scrollbar {
   width: 6px;
 }
-
 ::-webkit-scrollbar-track {
   background: transparent;
 }
-
 ::-webkit-scrollbar-thumb {
   background-color: var(--grey-micro);
   border-radius: 3px;
 }
-
 ::-webkit-scrollbar-thumb:hover {
   background-color: var(--grey-small);
 }
-</style>  
+</style>

package/src/modules/globals/views/mixins/mixins.js

@@ -1,7 +1,13 @@
 import * as globals from '@martyrs/src/modules/globals/views/store/globals.js';
+import { inject } from 'vue';
 
 // useGlobalMixins.js
 export function useGlobalMixins() {
+  const isModuleInstalled = (moduleName) => {
+    const store = inject('store');
+    if (!store || !store.modules) return false;
+    return store.modules.includes(moduleName);
+  };
   const isAdmin = roles => {
     if (roles) {
       const isAdmin = roles.includes('ROLE_ADMIN') ? roles.includes('ROLE_ADMIN') : false;
@@ -287,6 +293,7 @@ export function useGlobalMixins() {
   const isXXLDesktop = () => isMediaMin('--xxl-desktop-min');
 
   return {
+    isModuleInstalled,
     isAdmin,
     hasAccess,
     returnCurrency,

package/src/modules/inventory/CLAUDE.md

@@ -0,0 +1,330 @@
+# Техническая документация: Модуль Inventory
+
+## 1. Назначение модуля
+
+Модуль `inventory` управляет складскими операциями в системе martyrs. Основные функции:
+- **Учёт остатков и доступности** (stock availability) товаров с учётом ингредиентов
+- **Корректировки остатков** (stock adjustments) с историей изменений  
+- **Инвентаризация** (stock audits) с пакетным обновлением остатков
+- **Алерты** по критическим остаткам
+- **Автоматический пересчёт** доступности через Change Streams
+
+## 2. Общая архитектура (клиент ⇄ сервер)
+
+### Инициализация модуля
+
+**Клиентская сторона** (`inventory.client.js`):
+```
+Vue App → initializeInventory() → Router + Components
+                ↓
+    addRoutes() для backoffice/organization контекстов
+```
+
+**Серверная сторона** (`inventory.server.js`):
+```
+Express App → initializeInventory() → Models + Routes + Policies
+                ↓
+    Регистрация моделей в db + настройка API endpoints
+```
+
+### Архитектура взаимодействий
+
+```
+Vue Components (UI)
+      ↓ HTTP requests
+Vue Store (inventory.store.js) 
+      ↓ axios calls
+Express Routes (inventory.routes.js)
+      ↓ middleware chain
+[JWT] → [Verifier] → [ABAC] → [Service]
+      ↓ business logic
+Services (adjustment/availability/audit.service.js)
+      ↓ shared helpers
+Helpers (inventory.helpers.js)
+      ↓ database operations  
+MongoDB Models + Cache + Observer + Change Streams
+```
+
+## 3. Потоки данных и точки входа
+
+### Основные API endpoints:
+
+```
+GET  /api/inventory/adjustments     - История корректировок
+POST /api/inventory/adjustments/create - Создание корректировки
+
+GET  /api/inventory/availability    - Доступность и остатки товаров
+
+GET  /api/inventory/audits          - Список инвентаризаций
+POST /api/inventory/audits/create   - Создание инвентаризации
+POST /api/inventory/audits/complete - Завершение инвентаризации
+```
+
+### Клиентские маршруты:
+
+```
+/inventory/        → InventoryList   (Inventory.vue)
+/inventory/audit   → InventoryAudit  (InventoryEdit.vue)
+```
+
+Поддерживает два контекста:
+- **backoffice**: `BackofficeInventoryList`, `BackofficeInventoryAudit`  
+- **organization**: `OrganizationInventoryList`, `OrganizationInventoryAudit`
+
+## 4. Аутентификация и авторизация (пошагово)
+
+### Middleware цепочка:
+
+1. **JWT верификация** (`jwtFactory`):
+   ```js
+   jwt.verifyToken()      // обязательная аутентификация
+   jwt.verifyToken(true)  // опциональная аутентификация
+   ```
+
+2. **Валидация входных данных** (`verifierFactory`):
+   ```js
+   verifier.verifyAdjustmentQuery    // GET параметры
+   verifier.verifyAdjustmentBody     // POST тело запроса
+   verifier.verifyBalanceQuery       // фильтры остатков
+   verifier.verifyInventoryBody      // данные инвентаризации
+   ```
+
+3. **ABAC авторизация** (`globalsabac`):
+   ```js
+   abac.middleware('stockAdjustment', 'create')  // для создания корректировок
+   abac.middleware('stockAudit', 'create')       // для создания инвентаризации  
+   abac.middleware('stockAudit', 'edit')         // для завершения инвентаризации
+   ```
+
+### Политики безопасности:
+
+В `inventory.policies.js` **закомментированы** стандартные политики:
+- Создание корректировки: роли `warehouse`, `admin`, `moderator`
+- Завершение инвентаризации: только создатель или `admin`
+
+**Примечание**: Политики отключены - требуется настройка в зависимости от бизнес-требований.
+
+## 5. Структура файлов и их связи
+
+```
+inventory/
+├── inventory.client.js           # Точка входа клиента
+├── inventory.server.js           # Точка входа сервера
+├── router/
+│   └── inventory.router.js       # Клиентские маршруты
+├── routes/
+│   ├── inventory.routes.js       # API endpoints
+│   └── stock.alerts.routes.js    # API для алертов
+├── services/
+│   ├── adjustment.service.js     # Сервис корректировок
+│   ├── availability.service.js   # Сервис доступности
+│   ├── audit.service.js          # Сервис инвентаризаций
+│   └── inventory.helpers.js      # Общие функции и хелперы
+├── middlewares/
+│   ├── inventory.verifier.js     # Валидация запросов
+│   └── stock.alerts.verifier.js  # Валидация алертов
+├── models/
+│   ├── stock.adjustment.model.js # История корректировок
+│   ├── stock.availability.model.js # Остатки и доступность
+│   ├── stock.audit.model.js      # Инвентаризации
+│   └── stock.alerts.model.js     # Алерты по остаткам
+├── store/
+│   ├──  inventory.store.js       # Vue состояние
+│   └── stock.alerts.store.js     # Состояние алертов
+├── components/
+│   ├── pages/
+│   │   ├── Inventory.vue         # Список товаров с остатками
+│   │   └── InventoryEdit.vue     # Создание инвентаризации
+│   └── forms/
+│       ├── AdjustmentForm.vue    # Форма корректировки
+│       ├── HistoryView.vue       # История движений
+│       ├── ColumnSettingsMenu.vue # Настройки колонок
+│       └── StockAlertsForm.vue   # Настройка алертов
+├── policies/
+│   └── inventory.policies.js     # ABAC политики (отключены)
+└── workers/
+    └── inventory.availability.worker.js # Фоновый пересчёт
+```
+
+### Ключевые зависимости:
+
+- **Глобальные модули**: `@martyrs/src/modules/globals/*` (cache, logger, validator, abac)
+- **Аутентификация**: `@martyrs/src/modules/auth/controllers/middlewares/authJwt.js`
+- **Vue компоненты**: Vue 3 Composition API + реактивное состояние
+- **MongoDB Change Streams**: Автоматический пересчёт при изменении ингредиентов
+
+## 6. Как интегрировать модуль в проект
+
+### Серверная интеграция:
+
+```js
+import { initialize as initInventory } from './modules/inventory/inventory.server.js';
+
+// В основном server.js
+initInventory(app, db, origins, publicPath);
+```
+
+При инициализации автоматически запускаются Change Streams для отслеживания изменений в ингредиентах товаров.
+
+### Клиентская интеграция:
+
+```js
+import inventoryModule from './modules/inventory/inventory.client.js';
+
+// В Vue приложении
+inventoryModule.initialize(app, store, router, {
+  routeBackoffice: 'Backoffice Root',
+  routeOrganizations: 'OrganizationRoot',
+  withBackoffice: false,        // включить backoffice роуты
+  withOrganizationRoutes: false // включить organization роуты
+});
+```
+
+### Экспорт компонентов:
+
+```js
+import { 
+  Inventory, 
+  InventoryEdit,
+  AdjustmentForm, 
+  HistoryView,
+  ColumnSettingsMenu,
+  StockAlertsForm 
+} from './modules/inventory/inventory.client.js';
+```
+
+## 7. Расширение модуля
+
+### Добавление новой причины корректировки:
+
+1. **Модель** (`stock.adjustment.model.js`):
+   ```js
+   reason: { 
+     enum: ['restock', 'sale', 'return', 'damage', 'transfer', 'custom', 'new_reason']
+   }
+   ```
+
+2. **Валидатор** (`middlewares/inventory.verifier.js`):
+   ```js
+   validator: Validator.schema().string().oneOf([..., 'new_reason'])
+   ```
+
+### Добавление нового типа инвентаризации:
+
+1. **Расширить схему** `stock.audit.model.js`
+2. **Добавить валидацию** в `middlewares/inventory.verifier.js`  
+3. **Обновить бизнес-логику** в `services/audit.service.js`
+4. **Создать UI компонент** в `components/forms/`
+
+### Добавление кастомных политик ABAC:
+
+```js
+// В inventory.policies.js
+abac.registerResourcePolicy('stockAdjustment', async context => {
+  const { user, action, data } = context;
+  
+  // Ваша логика авторизации
+  if (action === 'create' && data.reason === 'damage') {
+    // Только менеджеры могут списывать по браку
+    return await checkManagerRole(user);
+  }
+  
+  return { allow: true };
+});
+```
+
+## 8. Безопасность
+
+### Аутентификация:
+- **JWT токены** через `authJwt.js` middleware
+- **Опциональная аутентификация** для публичных endpoints (`availability`)
+
+### Валидация данных:
+- **Joi-схемы** через `globals.validator.js`
+- **Строгая типизация** параметров и тела запросов
+- **Санитизация** входных данных
+
+### Авторизация:
+- **ABAC система** через `globals.abac.js`
+- **Контекстная авторизация** (resource + action)
+- **Роли и права доступа** настраиваются через политики
+
+### Защита API:
+- **CORS** настройки через `origins`
+- **Rate limiting** на уровне Express
+- **Логирование** всех операций через `globals.logger.js`
+
+### Транзакции:
+- **MongoDB сессии** для атомарных операций
+- **Rollback** при ошибках через `session.abortTransaction()`
+
+## 9. Ключевые сценарии использования
+
+### Сценарий 1: Корректировка остатков
+
+```
+1. Пользователь заходит в Inventory.vue
+2. Нажимает "создать корректировку" 
+3. Заполняет AdjustmentForm.vue (товар, склад, количество, причина)
+4. POST /api/inventory/adjustments/create
+   ├── JWT проверка токена
+   ├── Валидация данных
+   ├── ABAC проверка прав ('stockAdjustment', 'create')  
+   ├── Создание StockAdjustment записи
+   ├── Обновление StockAvailability (+quantity)
+   ├── Пересчёт StockAvailability.доступности для затронутых вариантов
+   ├── Проверка алертов по критическим остаткам
+   └── Инвалидация кеша
+5. Обновление UI через reactive store
+```
+
+### Сценарий 2: Инвентаризация склада
+
+```
+1. Переход в InventoryEdit.vue
+2. Выбор склада и добавление позиций
+3. POST /api/inventory/audits/create (status: 'draft' | 'published')
+4. Если status = 'published':
+   ├── Создание StockAdjustment для каждой позиции
+   ├── Batch update StockAvailability через bulkWrite
+   ├── Пересчёт availability для всех затронутых товаров
+   └── Уведомления через Observer pattern
+5. Если status = 'draft' - сохранение без применения
+6. POST /api/inventory/audits/complete для применения draft инвентаризации
+```
+
+### Сценарий 3: Мониторинг доступности товаров
+
+```
+1. GET /api/inventory/availability?storage=X&details=true
+2. Агрегация из Products с join к StockAvailability
+3. Расчёт итоговой доступности:
+   ├── Прямые остатки (quantity в StockAvailability)
+   ├── On-demand производство (через ингредиенты)
+   └── Ограничения по ингредиентам
+4. Кеширование результата на 5 минут
+5. Real-time обновления через change streams на коллекции variants
+```
+
+### Сценарий 4: Автоматические алерты
+
+```
+1. При любом изменении остатков (adjustment/inventory)
+2. Поиск активных алертов для товара/склада
+3. Проверка threshold vs текущий остаток
+4. Если остаток < порога:
+   ├── HTTP запрос в /api/notifications
+   ├── Метаданные: alertId, productId, currentStock, threshold
+   └── Уведомление создателю алерта
+5. Логирование ошибок, но не прерывание основной операции
+```
+
+---
+
+**Заключение**: Модуль inventory реализует полноценную систему складского учёта с поддержкой сложных сценариев (on-demand производство, пакетные операции, real-time уведомления). Архитектура построена на принципах разделения ответственности, транзакционности и масштабируемости.
+
+Основные особенности архитектуры:
+- **Модульность**: сервисы разделены по бизнес-функциям (adjustment, availability, audit)
+- **Единая модель StockAvailability**: хранит и остатки (quantity) и доступность (available)
+- **Change Streams**: автоматический пересчёт при изменении ингредиентов
+- **Общие хелперы**: переиспользуемые функции вынесены в inventory.helpers.js

package/src/modules/inventory/PROMT.md

@@ -0,0 +1,25 @@
+Перепиши документацию по модулю inventory, но сделай это как полноценную техническую документацию, ориентированную на разработчиков.
+
+❗️Не делай сжатый конспект — структура и стиль должны соответствовать документации настоящих продакшн-модулей.
+
+Требования к результату:
+Разделы: Общее описание, Архитектура, Компоненты и связи, Бизнес-логика, API спецификация, Права доступа, Точки расширения, Обработка ошибок, Примеры сценариев, Встраивание модуля, Безопасность и 
+ограничения
+
+Объясни зачем нужны ключевые сущности (balance, availability, audit и т.д.), а не просто их перечисление
+
+Распиши типовые сценарии в деталях, с шагами, примерами и последствиями
+
+Покажи, как устроена клиент-серверная связка через конкретные примеры запросов и изменений данных
+
+Отдельно опиши, как работают middleware, кеш, фоновые задачи
+
+Запрещается:
+Просто переписывать имена файлов и маршрутов
+
+Ограничиваться поверхностным описанием
+
+Пропускать связи между слоями (UI ⇄ Store ⇄ API ⇄ DB)
+
+Если ты не можешь объяснить назначение и логику каждой части, значит ты не понял модуль — вернись и пересмотри код.
+Делай, как если бы ты сам писал модуль через месяц по этой документации. Сначала составь план переделок для утверждения. Делай на русском.