@ozdao/martyrs 0.2.518 → 0.2.520

package/src/modules/inventory/components/forms/AdjustmentForm.vue

@@ -67,13 +67,6 @@
           <span>{{ reason.label }}</span>
         </div>
       </div>
-      
-      <Field
-        v-if="selectedReason === 'custom'"
-        v-model:field="customReasonText"
-        placeholder="Enter custom reason"
-        class="w-100 bg-light radius-small pd-medium"
-      />
     </div>
     
     <Field
@@ -85,19 +78,23 @@
     />
     
     <div class="flex-nowrap flex gap-small">
-      <button 
-        @click="$emit('close')" 
+      <Button
+        :submit="() => $emit('close')"
+        :showLoader="false"
+        :showSucces="false"
         class="pd-small radius-small flex-center flex w-max cursor-pointer t-transp"
       >
         Cancel
-      </button>
+      </Button>
       
-      <button 
-        @click="saveAdjustment" 
+      <Button
+        :submit="saveAdjustment"
+        :showLoader="true"
+        :showSucces="true"
         class="pd-small radius-small flex-center flex w-100 cursor-pointer bg-main t-black"
       >
         Save Adjustment
-      </button>
+      </Button>
     </div>
   </div>
 </template>
@@ -107,9 +104,11 @@ import { ref, computed, onMounted } from 'vue'
 import { useRoute } from 'vue-router'
 import Field from '@martyrs/src/components/Field/Field.vue'
 import Select from '@martyrs/src/components/Select/Select.vue'
+import Button from '@martyrs/src/components/Button/Button.vue'
 import * as auth from '@martyrs/src/modules/auth/views/store/auth.js'
 import * as spots from '@martyrs/src/modules/spots/store/spots.js'
 import variants from '@martyrs/src/modules/products/store/variants.store.js'
+import * as inventory from '@martyrs/src/modules/inventory/store/inventory.store.js'
 
 const route = useRoute()
 
@@ -128,12 +127,11 @@ const props = defineProps({
   }
 })
 
-const emit = defineEmits(['save', 'close'])
+const emit = defineEmits(['close', 'adjustment-created'])
 
 // Form state
 const quantity = ref(0)
-const selectedReason = ref('custom')
-const customReasonText = ref('')
+const selectedReason = ref('restock')
 const note = ref('')
 const selectedStorage = ref(null)
 const selectedVariant = ref(null)
@@ -147,7 +145,7 @@ const adjustmentReasons = [
   { label: 'Return', value: 'return', icon: IconMisplacement },
   { label: 'Damage', value: 'damage', icon: IconThief },
   { label: 'Transfer', value: 'transfer', icon: IconStocktake },
-  { label: 'Custom', value: 'custom', icon: IconCustom },
+  { label: 'Other', value: 'custom', icon: IconCustom },
 ]
 
 function formatPrice(price) {
@@ -193,33 +191,52 @@ onMounted(async () => {
   }
 })
 
-function saveAdjustment() {
+async function saveAdjustment() {
   if (!selectedVariant.value) {
     alert('Please select a variant')
-    return
+    throw new Error('Please select a variant')
   }
   if (!selectedStorage.value) {
     alert('Please select a storage')
-    return
+    throw new Error('Please select a storage')
   }
 
-  const adjustmentData = {
-    product: props.product._id,
-    variant: selectedVariant.value,
-    storage: selectedStorage.value,
-    source: {
-      type: 'User',
-      target: auth.state.user._id
-    },
-    quantity: parseInt(quantity.value || 0),
-    reason: selectedReason.value === 'custom' ? customReasonText.value : selectedReason.value,
-    comment: note.value || '',
-    creator: {
-      type: 'user',
-      target: auth.state.user._id
+  try {
+    const adjustmentData = {
+      product: props.product._id,
+      variant: selectedVariant.value,
+      storage: selectedStorage.value,
+      source: {
+        type: 'User',
+        target: auth.state.user._id
+      },
+      quantity: parseInt(quantity.value || 0),
+      reason: selectedReason.value,
+      comment: note.value || '',
+      owner: {
+        type: 'organization',
+        target: route.params._id
+      },
+      creator: {
+        type: 'user',
+        target: auth.state.user._id
+      }
     }
+    
+    const createdAdjustment = await inventory.actions.createAdjustment(adjustmentData)
+    
+    // Emit the adjustment data for parent component to update the product
+    emit('adjustment-created', {
+      product: props.product._id,
+      storage: selectedStorage.value,
+      quantity: parseInt(quantity.value || 0),
+      storageName: storageOptions.value.find(s => s._id === selectedStorage.value)?.name
+    })
+    
+    emit('close')
+  } catch (err) {
+    console.error(err)
+    throw err
   }
-  
-  emit('save', adjustmentData)
 }
 </script>

package/src/modules/inventory/components/forms/ColumnSettingsMenu.vue

@@ -22,19 +22,23 @@
     </div>
 
     <div class="flex-nowrap flex gap-small">
-      <button
-        @click="$emit('close')"
+      <Button
+        :submit="() => $emit('close')"
+        :showLoader="false"
+        :showSucces="false"
         class="pd-small radius-small flex-center flex w-max cursor-pointer t-transp"
       >
         Cancel
-      </button>
+      </Button>
 
-      <button
-        @click="saveSettings"
+      <Button
+        :submit="saveSettings"
+        :showLoader="false"
+        :showSucces="false"
         class="pd-small radius-small flex-center flex w-100 cursor-pointer bg-main t-black"
       >
         Save Settings
-      </button>
+      </Button>
     </div>
   </div>
 </template>
@@ -42,6 +46,7 @@
 <script setup>
 import { ref, watch } from 'vue'
 import Checkbox from '@martyrs/src/components/Checkbox/Checkbox.vue'
+import Button from '@martyrs/src/components/Button/Button.vue'
 
 const props = defineProps({
   columns: {

package/src/modules/inventory/components/forms/HistoryView.vue

@@ -15,7 +15,7 @@
         
         <div>
           <h3 class="mn-b-nano">{{ product.name }}</h3>
-          <p class="t-small t-transp">SKU: {{ product.sku }}</p>
+          <!-- <p class="t-small t-transp">SKU: {{ product.sku }}</p> -->
         </div>
       </div>
     </div>
@@ -71,20 +71,23 @@
       </table>
     </div>
     
-    <button 
-      @click="$emit('close')" 
+    <Button
+      :submit="() => $emit('close')"
+      :showLoader="false"
+      :showSucces="false"
       class="pd-small radius-small flex-center flex w-max cursor-pointer bg-main t-black"
     >
       Close
-    </button>
+    </Button>
   </div>
 </template>
 
 <script setup>
 import { ref, onMounted } from 'vue'
 import PlaceholderImage from '@martyrs/src/modules/icons/placeholders/PlaceholderImage.vue'
-// Import inventory API functions
-const API_BASE = '/api/inventory'
+import Button from '@martyrs/src/components/Button/Button.vue'
+
+import * as inventory from '@martyrs/src/modules/inventory/store/inventory.store.js'
 
 const props = defineProps({
   product: {
@@ -104,14 +107,21 @@ onMounted(async () => {
 })
 
 async function loadHistory() {
+  loading.value = true
   try {
     // Fetch adjustments for this product
-    const response = await fetch(`${API_BASE}/adjustments?product=${props.product._id}&limit=50&sort=createdAt&order=desc`)
-    const data = await response.json()
+    const data = await inventory.actions.fetchAdjustments({
+      product: props.product._id,
+      limit: 50,
+      sortParam: 'createdAt',
+      sortOrder: 'desc',
+      lookup: ['creator', 'source', 'storage']
+    })
     
     history.value = data || []
   } catch (error) {
     console.error('Error loading history:', error)
+    history.value = []
   } finally {
     loading.value = false
   }
@@ -122,7 +132,9 @@ function formatDate(dateString) {
   return date.toLocaleDateString('en-US', { 
     day: 'numeric', 
     month: 'short', 
-    year: 'numeric' 
+    year: 'numeric',
+    hour: '2-digit',
+    minute: '2-digit'
   })
 }
 </script>

package/src/modules/inventory/components/forms/StockAlertsForm.vue

@@ -43,19 +43,23 @@
     
     <!-- Actions -->
     <div class="flex-nowrap flex gap-small">
-      <button 
-        @click="$emit('close')" 
+      <Button
+        :submit="() => $emit('close')"
+        :showLoader="false"
+        :showSucces="false"
         class="pd-small radius-small flex-center flex w-max cursor-pointer t-transp"
       >
         Cancel
-      </button>
+      </Button>
       
-      <button 
-        @click="saveAlert" 
+      <Button
+        :submit="saveAlert"
+        :showLoader="true"
+        :showSucces="true"
         class="pd-small radius-small flex-center flex w-100 cursor-pointer bg-main t-black"
       >
         Save Alert
-      </button>
+      </Button>
     </div>
   </div>
 </template>
@@ -65,6 +69,7 @@ import { ref, computed, onMounted } from 'vue'
 import { useRoute } from 'vue-router'
 import Field from '@martyrs/src/components/Field/Field.vue'
 import Select from '@martyrs/src/components/Select/Select.vue'
+import Button from '@martyrs/src/components/Button/Button.vue'
 import * as auth from '@martyrs/src/modules/auth/views/store/auth.js'
 import * as spots from '@martyrs/src/modules/spots/store/spots.js'
 import variants from '@martyrs/src/modules/products/store/variants.store.js'
@@ -79,7 +84,7 @@ const props = defineProps({
   }
 })
 
-const emit = defineEmits(['save', 'close'])
+const emit = defineEmits(['close'])
 
 // Form state
 const selectedVariant = ref(null)
@@ -160,22 +165,28 @@ onMounted(async () => {
 })
 
 async function saveAlert() {
-  const alertData = {
-    product: props.product._id,
-    variant: selectedVariant.value,
-    storage: selectedStorage.value,
-    threshold: parseInt(threshold.value || 0),
-    enabled: true,
-    owner: {
-      type: 'organization',
-      target: route.params._id
-    },
-    creator: {
-      type: 'user',
-      target: auth.state.user._id
+  try {
+    const alertData = {
+      product: props.product._id,
+      variant: selectedVariant.value,
+      storage: selectedStorage.value,
+      threshold: parseInt(threshold.value || 0),
+      enabled: true,
+      owner: {
+        type: 'organization',
+        target: route.params._id
+      },
+      creator: {
+        type: 'user',
+        target: auth.state.user._id
+      }
     }
+    
+    await stockAlerts.create(alertData)
+    emit('close')
+  } catch (err) {
+    console.error(err)
+    throw err
   }
-  
-  emit('save', alertData)
 }
 </script>

package/src/modules/inventory/components/pages/Inventory.vue

@@ -4,16 +4,9 @@
     <header class="mn-b-medium flex-v-center flex-nowrap flex">
       <h2>Inventory</h2>
       <button
-        v-if="route.meta.context === 'backoffice'"
-        @click="router.push({ name: 'BackofficeInventoryAudit' })"
-        class="mn-l-small radius-100 i-big hover-scale-1 cursor-pointer t-white bg-second"
-        v-html="'+'"
-      />
-      <button
-        v-if="route.meta.context === 'organization'"
-        @click="router.push({ name: 'OrganizationInventoryAudit', params: { _id: route.params._id } })"
-        class="mn-l-small radius-100 i-big hover-scale-1 cursor-pointer t-white bg-second"
-        v-html="'+'"
+        @click="route.meta.context === 'backoffice' ? router.push({ name: 'BackofficeInventoryAudit' }) : router.push({ name: 'OrganizationInventoryAudit', params: { _id: route.params._id } })"
+        class="mn-l-auto radius-small button t-white bg-second"
+        v-html="'+ New Audit'"
       />
     </header>
 
@@ -22,6 +15,7 @@
       <Feed
         :search="true"
         v-model:sort="sort"
+        v-model:items="items"
         :store="{
           read: (options) => products.actions.read(options),
           state: products.state
@@ -41,7 +35,6 @@
           sortParam: sort.param,
           sortOrder: sort.order
         }"
-        v-slot="{ items }"
       >
         <Table
           :columns="columns.filter(col => col.visible)"
@@ -159,7 +152,7 @@
       <AdjustmentForm
         :product="selectedProduct"
         @close="showAuditModal = false"
-        @save="handleAuditSave"
+        @adjustment-created="handleAdjustmentCreated"
       />
     </Popup>
 
@@ -172,7 +165,6 @@
       <StockAlertsForm
         :product="selectedProduct"
         @close="showReorderModal = false"
-        @save="handleAlertSave"
       />
     </Popup>
 
@@ -228,7 +220,7 @@ import HistoryView from '../forms/HistoryView.vue'
 import ColumnSettingsMenu from '../forms/ColumnSettingsMenu.vue'
 
 // Stores
-import * as inventory from '@martyrs/src/modules/inventory/store/ inventory.store.js'
+import * as inventory from '@martyrs/src/modules/inventory/store/inventory.store.js'
 import * as products from '@martyrs/src/modules/products/store/products.js'
 import * as auth from '@martyrs/src/modules/auth/views/store/auth.js'
 import stockAlerts from '@martyrs/src/modules/inventory/store/stock.alerts.store.js'
@@ -238,6 +230,9 @@ const route = useRoute()
 const router = useRouter()
 const { formatPrice } = useGlobalMixins()
 
+// Products items state
+const items = ref([])
+
 // Feed controls
 const sort = ref({
   param: 'available',
@@ -290,6 +285,37 @@ function openStockAudit(row) {
   selectedProduct.value = row
   showAuditModal.value = true
 }
+
+// Update product after adjustment
+function handleAdjustmentCreated(adjustment) {
+  // Find the product in items array
+  const productIndex = items.value.findIndex(item => item._id === adjustment.product)
+  
+  if (productIndex !== -1) {
+    // Update the available quantity
+    items.value[productIndex].available += adjustment.quantity
+    
+    // Update availabilityDetails if present
+    if (items.value[productIndex].availabilityDetails) {
+      const storageDetail = items.value[productIndex].availabilityDetails.find(
+        detail => detail.storage === adjustment.storage
+      )
+      
+      if (storageDetail) {
+        storageDetail.available += adjustment.quantity
+      } else {
+        // Add new storage detail if not found
+        items.value[productIndex].availabilityDetails.push({
+          storage: adjustment.storage,
+          available: adjustment.quantity,
+          storageName: adjustment.storageName || adjustment.storage
+        })
+      }
+    }
+  }
+  
+  showAuditModal.value = false
+}
 function openReorderSettings(row = null) {
   selectedProduct.value = row
   showReorderModal.value = true
@@ -301,32 +327,6 @@ function openStockHistory(row) {
 function openViewSettings() {
   showSettingsModal.value = true
 }
-async function handleAuditSave(adjustmentData) {
-  try {
-    await inventory.actions.createAdjustment({
-      ...adjustmentData,
-      owner: {
-        type: 'organization',
-        target: route.params._id
-      },
-      creator: {
-        type: 'user',
-        target: auth.state.user._id
-      }
-    })
-    showAuditModal.value = false
-  } catch (err) {
-    console.error(err)
-  }
-}
-async function handleAlertSave(alertData) {
-  try {
-    await stockAlerts.create(alertData)
-    showReorderModal.value = false
-  } catch (err) {
-    console.error('Error saving alert:', err)
-  }
-}
 function handleColumnsUpdate(updated) {
   // Update column visibility
   columns.forEach(col => {

package/src/modules/inventory/components/pages/InventoryEdit.vue

@@ -254,7 +254,7 @@
  
   import * as globals from '@martyrs/src/modules/globals/views/store/globals.js';
   import * as auth from '@martyrs/src/modules/auth/views/store/auth.js';
-  import * as inventory from '@martyrs/src/modules/inventory/store/ inventory.store.js';
+  import * as inventory from '@martyrs/src/modules/inventory/store/inventory.store.js';
   import * as products from '@martyrs/src/modules/products/store/products.js';
   import * as spots from '@martyrs/src/modules/spots/store/spots.js';
   import variants from '@martyrs/src/modules/products/store/variants.store.js';

package/src/modules/inventory/docs/01-intro.md

@@ -0,0 +1,126 @@
+## 1. Общее описание модуля
+
+### Назначение и область применения
+
+Модуль **Inventory** представляет собой комплексную систему управления складскими запасами, предназначенную для решения задач многоскладской логистики в условиях сложной продуктовой структуры. Система обеспечивает точный учет товарных остатков, автоматический расчет доступности для продажи и проактивное управление пополнением запасов.
+
+Модуль разработан для работы в мультитенантной среде, где различные организации ведут независимый учет своих товарных запасов на множественных складских площадках.
+
+### Ключевые сущности и их роль в системе
+
+#### StockAvailability - Остатки и доступность для продажи
+
+**Назначение**: Хранит фактические количества товаров на складах и вычисляемую доступность для продажи с учетом резервирований и ограничений по ингредиентам.
+
+```javascript
+{
+  product: ObjectId,
+  variant: ObjectId, 
+  storage: ObjectId,
+  quantity: Number,        // Физический остаток
+  available: Number,       // Доступно для продажи
+  reservations: Number,    // Зарезервировано (пока не используется)
+  constraints: [{          // Ограничения по ингредиентам
+    ingredient: ObjectId,  // ID ингредиента
+    stock: Number,         // Остаток ингредиента на складе
+    required: Number,      // Требуется на единицу товара
+    available: Number      // Сколько единиц товара можно собрать
+  }]
+}
+```
+
+**Почему это критично**: Система поддерживает концепцию "on-demand" сборки товаров из ингредиентов. Например, пицца может быть собрана из теста, соуса и начинки. Даже если готовой пиццы нет на складе (`quantity: 0`), она может быть доступна для заказа, если есть все необходимые ингредиенты.
+
+**Алгоритм расчета доступности**:
+1. Если есть прямой остаток товара → `available = quantity`
+2. Если прямого остатка нет, но есть ингредиенты → рассчитывается минимальное количество, которое можно собрать
+3. Финальная доступность = min(прямой остаток, количество сборок из ингредиентов)
+
+#### StockAdjustment - Журнал движений товаров
+
+**Назначение**: Immutable лог всех изменений остатков товаров с полной атрибуцией и аудитом.
+
+```javascript
+{
+  product: ObjectId,
+  variant: ObjectId,
+  storage: ObjectId,
+  source: {                    // Источник изменения
+    type: ['User', 'Order', 'Inventory'],
+    target: ObjectId           // ID пользователя, заказа или инвентаризации
+  },
+  reason: ['restock', 'sale', 'return', 'damage', 'transfer', 'custom'],
+  quantity: Number,            // Изменение (+/-)
+  cost: Number,               // Стоимость (для учета затрат)
+  comment: String
+}
+```
+
+**Почему необходим отдельный журнал**: StockAvailability показывает только текущее состояние, но не объясняет, как оно возникло. StockAdjustment обеспечивает:
+- **Полный аудит**: каждое изменение записывается с временной меткой и автором
+- **Различение источников**: продажа vs возврат vs порча имеют разную бизнес-логику
+- **Финансовый учет**: поле `cost` позволяет вести учет себестоимости товарных операций
+- **Compliance**: соответствие требованиям аудита и налогового законодательства
+
+#### StockAudit - Инвентаризация
+
+**Назначение**: Batch-операция для проведения инвентаризации и массовой корректировки остатков.
+
+```javascript
+{
+  storage: ObjectId,           // Склад, на котором проводится инвентаризация
+  status: ['draft', 'published', 'cancelled'],
+  positions: [{               // Массив товарных позиций
+    product: ObjectId,
+    variant: ObjectId,
+    quantity: Number,         // Фактически насчитанное количество
+    reason: String,           // Причина расхождения
+    comment: String,
+    cost: Number
+  }],
+  comment: String             // Общий комментарий к инвентаризации
+}
+```
+
+**Зачем нужна batch-обработка**: Инвентаризация может затрагивать сотни товарных позиций. Создание отдельного StockAdjustment для каждой позиции привело бы к:
+- Избыточности в UI (сотни форм)
+- Проблемам с атомарностью (часть корректировок может не пройти)
+- Сложности отката операции
+
+StockAudit решает это через двухфазный commit:
+1. **Draft фаза**: данные сохраняются, но не влияют на остатки
+2. **Published фаза**: автоматически создаются соответствующие StockAdjustment и обновляются остатки в StockAvailability
+
+#### StockAlert - Уведомления о низких остатках
+
+**Назначение**: Конфигурация пороговых значений для автоматических уведомлений о необходимости пополнения товаров.
+
+```javascript
+{
+  product: ObjectId,
+  variant: ObjectId,          // null = для всех вариантов товара
+  storage: ObjectId,          // null = для всех складов
+  threshold: Number,          // Пороговое значение
+  enabled: Boolean
+}
+```
+
+**Гибкость настройки**: Система поддерживает различные уровни детализации алертов:
+- **Глобальные** (`variant: null, storage: null`): для товара на всех складах
+- **По складам** (`variant: null, storage: specific`): для товара на конкретном складе
+- **По вариантам** (`variant: specific, storage: null`): для конкретного варианта на всех складах
+- **Точечные** (`variant: specific, storage: specific`): максимальная детализация
+
+**Проактивность**: Алерты срабатывают автоматически в момент изменения остатков, а не по расписанию, что обеспечивает оперативное реагирование на критические ситуации.
+
+### Бизнес-проблемы, решаемые модулем
+
+1. **Предотвращение овесселлинга**: Точный расчет доступности не позволяет продать больше товара, чем физически возможно произвести или отгрузить.
+
+2. **Оптимизация складских запасов**: Автоматические алерты предотвращают затоваривание и дефицит.
+
+3. **Сложная продуктовая логика**: Поддержка товаров, собираемых из ингредиентов, расширяет возможности для ресторанов, производств, кастомизации.
+
+4. **Мультилокационность**: Управление запасами на множественных складах с централизованным контролем.
+
+5. **Аудитируемость**: Полная история движений обеспечивает соответствие нормативным требованиям и внутреннему контролю.