sky121113
a05acd96dc
1. 新增 API Rate Limiting (每分鐘 60 次) 2. 實作 ProductServiceInterface 與 findOrCreateWarehouseByName 解決跨模組耦合問題 3. 強化 OrderSync API 驗證 (price 欄位限制最小 0、payment_method 加上允許白名單) 4. 實作 OrderSync API 冪等性處理，重複訂單直接回傳現有資訊 5. 修正 ProductSync API 同步邏輯，每次同步皆會更新產品分類與單位 6. 完善 integration API 對接手冊內容與 UI 排版
142 lines
3.6 KiB
PHP
142 lines
3.6 KiB
PHP
<?php
|
|
|
|
namespace App\Modules\Inventory\Contracts;
|
|
|
|
interface InventoryServiceInterface
|
|
{
|
|
/**
|
|
* Check if a product has sufficient stock in a specific warehouse.
|
|
*
|
|
* @param int $productId
|
|
* @param int $warehouseId
|
|
* @param float $quantity
|
|
* @return bool
|
|
*/
|
|
public function checkStock(int $productId, int $warehouseId, float $quantity): bool;
|
|
|
|
/**
|
|
* @param int $productId
|
|
* @param int $warehouseId
|
|
* @param float $quantity
|
|
* @param string|null $reason
|
|
* @param bool $force
|
|
* @param string|null $slot
|
|
* @return void
|
|
*/
|
|
public function decreaseStock(int $productId, int $warehouseId, float $quantity, ?string $reason = null, bool $force = false, ?string $slot = null): void;
|
|
|
|
/**
|
|
* Get all active warehouses.
|
|
*
|
|
* @return \Illuminate\Support\Collection
|
|
*/
|
|
public function getAllWarehouses();
|
|
|
|
/**
|
|
* Get multiple products by their IDs.
|
|
*
|
|
* @param array $ids
|
|
* @return \Illuminate\Support\Collection
|
|
*/
|
|
public function getProductsByIds(array $ids);
|
|
|
|
/**
|
|
* Search products by name.
|
|
*
|
|
* @param string $name
|
|
* @return \Illuminate\Support\Collection
|
|
*/
|
|
public function getProductsByName(string $name);
|
|
|
|
/**
|
|
* Get a specific product by ID.
|
|
*
|
|
* @param int $id
|
|
* @return object|null
|
|
*/
|
|
public function getProduct(int $id);
|
|
|
|
/**
|
|
* Get a specific warehouse by ID.
|
|
*
|
|
* @param int $id
|
|
* @return object|null
|
|
*/
|
|
public function getWarehouse(int $id);
|
|
|
|
/**
|
|
* Get all available inventories in a specific warehouse.
|
|
*
|
|
* @param int $warehouseId
|
|
* @return \Illuminate\Support\Collection
|
|
*/
|
|
public function getInventoriesByWarehouse(int $warehouseId);
|
|
|
|
/**
|
|
* Get all products.
|
|
*
|
|
* @return \Illuminate\Support\Collection
|
|
*/
|
|
public function getAllProducts();
|
|
|
|
/**
|
|
* Get all units.
|
|
*
|
|
* @return \Illuminate\Support\Collection
|
|
*/
|
|
public function getUnits();
|
|
|
|
/**
|
|
* Create a new inventory record (e.g., for finished goods).
|
|
*
|
|
* @param array $data
|
|
* @return object
|
|
*/
|
|
public function createInventoryRecord(array $data);
|
|
|
|
/**
|
|
* Decrease quantity of a specific inventory record.
|
|
*
|
|
* @param int $inventoryId
|
|
* @param float $quantity
|
|
* @param string|null $reason
|
|
* @param string|null $referenceType
|
|
* @param int|string|null $referenceId
|
|
* @return void
|
|
*/
|
|
public function decreaseInventoryQuantity(int $inventoryId, float $quantity, ?string $reason = null, ?string $referenceType = null, $referenceId = null);
|
|
|
|
/**
|
|
* Find a specific inventory record by warehouse, product and batch.
|
|
*
|
|
* @param int $warehouseId
|
|
* @param int $productId
|
|
* @param string|null $batchNumber
|
|
* @return object|null
|
|
*/
|
|
public function findInventoryByBatch(int $warehouseId, int $productId, ?string $batchNumber);
|
|
|
|
/**
|
|
* 取得即時庫存查詢資料（含統計卡片 + 分頁明細）。
|
|
*
|
|
* @param array $filters 篩選條件
|
|
* @param int $perPage 每頁筆數
|
|
* @return array
|
|
*/
|
|
public function getStockQueryData(array $filters = [], int $perPage = 10): array;
|
|
|
|
/**
|
|
* Get statistics for the dashboard.
|
|
*
|
|
* @return array
|
|
*/
|
|
public function getDashboardStats(): array;
|
|
|
|
/**
|
|
* 依倉庫名稱查找或建立倉庫（供外部整合用）。
|
|
*
|
|
* @param string $warehouseName
|
|
* @return object
|
|
*/
|
|
public function findOrCreateWarehouseByName(string $warehouseName);
|
|
} |