hvp-shared 6.21.0 → 6.23.0

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './types';
 export * from './constants';
 export * from './contracts';
 export * from './validation';
+export * from './inventory-analysis';
 export { debugLog } from './utils/debug-logger';
 export * from './utils/sync-field.helpers';
 export * from './utils/qvet-catalog.helpers';

package/dist/index.js

@@ -23,6 +23,7 @@ __exportStar(require("./types"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./contracts"), exports);
 __exportStar(require("./validation"), exports);
+__exportStar(require("./inventory-analysis"), exports);
 var debug_logger_1 = require("./utils/debug-logger");
 Object.defineProperty(exports, "debugLog", { enumerable: true, get: function () { return debug_logger_1.debugLog; } });
 __exportStar(require("./utils/sync-field.helpers"), exports);

package/dist/inventory-analysis/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Inventory Analysis Module
+ *
+ * API contracts for inventory analysis endpoints.
+ * Calculation logic lives in hvp-backend domain layer.
+ */
+export * from './types';

package/dist/inventory-analysis/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Inventory Analysis Module
+ *
+ * API contracts for inventory analysis endpoints.
+ * Calculation logic lives in hvp-backend domain layer.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);

package/dist/inventory-analysis/types.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Inventory Analysis Types
+ *
+ * Type definitions for inventory analysis calculations.
+ * Used by StockProposalService, ConsumptionAnalysisService, etc.
+ */
+import { UsageType } from '../constants/catalog-item.constants';
+/**
+ * TrendType - Classification of consumption trend
+ *
+ * Based on Q/Y ratio (quarterly vs yearly consumption).
+ */
+export declare enum TrendType {
+    /** Growing: Q/Y ratio > GROWTH_THRESHOLD (recent consumption higher than average) */
+    GROWING = "growing",
+    /** Stable: ratio between DECLINE_THRESHOLD and GROWTH_THRESHOLD */
+    STABLE = "stable",
+    /** Declining: Q/Y ratio < DECLINE_THRESHOLD (recent consumption lower than average) */
+    DECLINING = "declining",
+    /** New: Only recent data exists (no historical baseline) */
+    NEW = "new",
+    /** No Q4: Has historical data but no recent activity */
+    NO_RECENT_ACTIVITY = "noRecentActivity",
+    /** No Activity: No consumption data at all */
+    NO_ACTIVITY = "noActivity"
+}
+/**
+ * Stock days configuration by usage type
+ */
+export interface StockDaysConfig {
+    /** Days of stock for minimum level */
+    minDays: number;
+    /** Days of stock for optimal level */
+    optimalDays: number;
+}
+/**
+ * Consumption data for a product
+ */
+export interface ConsumptionData {
+    /** Average daily consumption (full period) */
+    dailyConsumption: number;
+    /** Average daily consumption (recent period, e.g., Q4) */
+    dailyConsumptionRecent: number;
+    /** Q/Y ratio (recent / full period) */
+    qyRatio: number;
+    /** Calculated trend type */
+    trend: TrendType;
+    /** Reference consumption for stock calculation */
+    referenceConsumption: number;
+}
+/**
+ * Stock proposal for a single product
+ */
+export interface StockProposal {
+    /** Proposed minimum stock level */
+    minStock: number;
+    /** Proposed optimal stock level */
+    optimalStock: number;
+    /** Days of coverage used for min */
+    minDays: number;
+    /** Days of coverage used for optimal */
+    optimalDays: number;
+    /** Rounding increment used */
+    roundingIncrement: number;
+    /** Raw (unrounded) min value */
+    rawMinStock: number;
+    /** Raw (unrounded) optimal value */
+    rawOptimalStock: number;
+}
+/**
+ * Complete analysis result for a product
+ */
+export interface ProductAnalysis {
+    /** QVET product code */
+    qvetCode: number;
+    /** Product description */
+    description: string;
+    /** Product section */
+    section: string;
+    /** Usage type classification */
+    usageType: UsageType;
+    /** Unit cost (for rounding calculations) */
+    unitCost: number;
+    /** Sales unit (%, ML, TABLETA, etc.) */
+    salesUnit: string;
+    /** Consumption analysis */
+    consumption: ConsumptionData;
+    /** Stock proposal */
+    proposal: StockProposal;
+}
+/**
+ * Request for stock proposal calculation
+ */
+export interface StockProposalRequest {
+    /** Start date for consumption analysis (ISO 8601) */
+    fromDate: string;
+    /** End date for consumption analysis (ISO 8601) */
+    toDate: string;
+    /** Start date for recent period (e.g., Q4 start) - ISO 8601 */
+    recentPeriodStart?: string;
+    /** Filter by branch */
+    branch?: string;
+    /** Filter by section */
+    section?: string;
+    /** Filter by specific product codes */
+    qvetCodes?: number[];
+    /** Output format */
+    format?: 'json' | 'excel';
+}
+/**
+ * Response for stock proposal calculation
+ */
+export interface StockProposalResponse {
+    /** Metadata about the calculation */
+    metadata: {
+        /** Analysis date range */
+        dateRange: {
+            from: string;
+            to: string;
+        };
+        /** Recent period date range */
+        recentPeriod: {
+            from: string;
+            to: string;
+        };
+        /** Total products analyzed */
+        totalProducts: number;
+        /** Timestamp of calculation */
+        calculatedAt: string;
+    };
+    /** Product analysis results */
+    products: ProductAnalysisResponse[];
+    /** Summary statistics */
+    summary: {
+        /** Count by trend type */
+        byTrend: Record<TrendType, number>;
+        /** Count by usage type */
+        byUsageType: Record<UsageType, number>;
+    };
+}
+/**
+ * Product analysis for API response (flattened)
+ */
+export interface ProductAnalysisResponse {
+    qvetCode: number;
+    description: string;
+    section: string;
+    usageType: UsageType;
+    dailyConsumption: number;
+    dailyConsumptionRecent: number;
+    monthlyConsumption: number;
+    qyRatio: number;
+    trend: TrendType;
+    referenceConsumption: number;
+    currentStock: {
+        warehouse: string;
+        stock: number;
+    }[];
+    totalStock: number;
+    minStock: number;
+    optimalStock: number;
+    minDays: number;
+    optimalDays: number;
+    roundingIncrement: number;
+    unitCost: number;
+    proposedMinValue: number;
+    proposedOptValue: number;
+}
+/**
+ * Stock flow data for a product
+ */
+export interface StockFlow {
+    /** Initial stock at period start */
+    initialStock: number;
+    /** Purchases during period */
+    purchases: number;
+    /** Transfers in (received) */
+    transfersIn: number;
+    /** Transfers out (sent) */
+    transfersOut: number;
+    /** Available = initial + purchases + transfersIn - transfersOut */
+    available: number;
+    /** Units sold */
+    sold: number;
+    /** Theoretical stock = available - sold */
+    theoreticalStock: number;
+    /** Actual stock at period end */
+    actualStock: number;
+    /** Shrinkage (merma) = theoretical - actual */
+    shrinkage: number;
+    /** Shrinkage value = shrinkage * unitCost */
+    shrinkageValue: number;
+}

package/dist/inventory-analysis/types.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Inventory Analysis Types
+ *
+ * Type definitions for inventory analysis calculations.
+ * Used by StockProposalService, ConsumptionAnalysisService, etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrendType = void 0;
+// ============================================================================
+// Trend Types
+// ============================================================================
+/**
+ * TrendType - Classification of consumption trend
+ *
+ * Based on Q/Y ratio (quarterly vs yearly consumption).
+ */
+var TrendType;
+(function (TrendType) {
+    /** Growing: Q/Y ratio > GROWTH_THRESHOLD (recent consumption higher than average) */
+    TrendType["GROWING"] = "growing";
+    /** Stable: ratio between DECLINE_THRESHOLD and GROWTH_THRESHOLD */
+    TrendType["STABLE"] = "stable";
+    /** Declining: Q/Y ratio < DECLINE_THRESHOLD (recent consumption lower than average) */
+    TrendType["DECLINING"] = "declining";
+    /** New: Only recent data exists (no historical baseline) */
+    TrendType["NEW"] = "new";
+    /** No Q4: Has historical data but no recent activity */
+    TrendType["NO_RECENT_ACTIVITY"] = "noRecentActivity";
+    /** No Activity: No consumption data at all */
+    TrendType["NO_ACTIVITY"] = "noActivity";
+})(TrendType || (exports.TrendType = TrendType = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvp-shared",
-  "version": "6.21.0",
+  "version": "6.23.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",