SparePartInventoryServiceTest.php 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477
  1. <?php
  2. namespace Tests\Unit\Services;
  3. use App\Models\Reclamation;
  4. use App\Models\Reservation;
  5. use App\Models\Shortage;
  6. use App\Models\SparePart;
  7. use App\Models\SparePartOrder;
  8. use App\Services\ShortageService;
  9. use App\Services\SparePartInventoryService;
  10. use App\Services\SparePartReservationService;
  11. use Illuminate\Foundation\Testing\RefreshDatabase;
  12. use Tests\TestCase;
  13. class SparePartInventoryServiceTest extends TestCase
  14. {
  15. use RefreshDatabase;
  16. protected $seed = true;
  17. private SparePartInventoryService $service;
  18. protected function setUp(): void
  19. {
  20. parent::setUp();
  21. $shortageService = new ShortageService();
  22. $reservationService = new SparePartReservationService($shortageService);
  23. $this->service = new SparePartInventoryService($reservationService, $shortageService);
  24. }
  25. // ==================== getCriticalShortages ====================
  26. public function test_get_critical_shortages_returns_spare_parts_with_open_shortages(): void
  27. {
  28. // Arrange
  29. $sparePart1 = SparePart::factory()->create();
  30. $sparePart2 = SparePart::factory()->create();
  31. $reclamation = Reclamation::factory()->create();
  32. Shortage::factory()
  33. ->open()
  34. ->withQuantities(5, 0)
  35. ->forSparePart($sparePart1)
  36. ->forReclamation($reclamation)
  37. ->create();
  38. Shortage::factory()
  39. ->closed()
  40. ->forSparePart($sparePart2)
  41. ->forReclamation($reclamation)
  42. ->create();
  43. // Act
  44. $criticalShortages = $this->service->getCriticalShortages();
  45. // Assert - returns SparePart objects, not Shortages
  46. $this->assertCount(1, $criticalShortages);
  47. $this->assertEquals($sparePart1->id, $criticalShortages->first()->id);
  48. }
  49. public function test_get_critical_shortages_returns_empty_when_no_shortages(): void
  50. {
  51. // Act
  52. $criticalShortages = $this->service->getCriticalShortages();
  53. // Assert
  54. $this->assertTrue($criticalShortages->isEmpty());
  55. }
  56. // ==================== getBelowMinStock ====================
  57. public function test_get_below_min_stock_returns_parts_below_minimum(): void
  58. {
  59. // Arrange
  60. $sparePart1 = SparePart::factory()->create(['min_stock' => 10]);
  61. $sparePart2 = SparePart::factory()->create(['min_stock' => 5]);
  62. // Create stock for sparePart1 - 3 items (below min 10)
  63. SparePartOrder::factory()
  64. ->inStock()
  65. ->withQuantity(3)
  66. ->forSparePart($sparePart1)
  67. ->create();
  68. // Create stock for sparePart2 - 10 items (above min 5)
  69. SparePartOrder::factory()
  70. ->inStock()
  71. ->withQuantity(10)
  72. ->forSparePart($sparePart2)
  73. ->create();
  74. // Act
  75. $belowMin = $this->service->getBelowMinStock();
  76. // Assert
  77. $this->assertTrue($belowMin->contains('id', $sparePart1->id));
  78. $this->assertFalse($belowMin->contains('id', $sparePart2->id));
  79. }
  80. public function test_get_below_min_stock_considers_reservations(): void
  81. {
  82. // Arrange
  83. $sparePart = SparePart::factory()->create(['min_stock' => 5]);
  84. $reclamation = Reclamation::factory()->create();
  85. $order = SparePartOrder::factory()
  86. ->inStock()
  87. ->withQuantity(10)
  88. ->forSparePart($sparePart)
  89. ->create();
  90. // Reserve 7 items - leaves only 3 free (below min 5)
  91. Reservation::factory()
  92. ->active()
  93. ->withQuantity(7)
  94. ->fromOrder($order)
  95. ->forReclamation($reclamation)
  96. ->create();
  97. // Act
  98. $belowMin = $this->service->getBelowMinStock();
  99. // Assert
  100. $this->assertTrue($belowMin->contains('id', $sparePart->id));
  101. }
  102. // ==================== calculateOrderQuantity ====================
  103. public function test_calculate_order_quantity_returns_missing_from_shortages(): void
  104. {
  105. // Arrange
  106. $sparePart = SparePart::factory()->create();
  107. $reclamation1 = Reclamation::factory()->create();
  108. $reclamation2 = Reclamation::factory()->create();
  109. // Create two shortages without documents
  110. Shortage::factory()
  111. ->open()
  112. ->withQuantities(5, 2) // missing 3
  113. ->forSparePart($sparePart)
  114. ->forReclamation($reclamation1)
  115. ->withDocuments(false)
  116. ->create();
  117. Shortage::factory()
  118. ->open()
  119. ->withQuantities(4, 1) // missing 3
  120. ->forSparePart($sparePart)
  121. ->forReclamation($reclamation2)
  122. ->withDocuments(false)
  123. ->create();
  124. // Act
  125. $orderQty = $this->service->calculateOrderQuantity($sparePart, false);
  126. // Assert
  127. $this->assertEquals(6, $orderQty); // 3 + 3
  128. }
  129. public function test_calculate_order_quantity_respects_with_documents_flag(): void
  130. {
  131. // Arrange
  132. $sparePart = SparePart::factory()->create();
  133. $reclamation = Reclamation::factory()->create();
  134. Shortage::factory()
  135. ->open()
  136. ->withQuantities(5, 0) // missing 5 WITHOUT docs
  137. ->forSparePart($sparePart)
  138. ->forReclamation($reclamation)
  139. ->withDocuments(false)
  140. ->create();
  141. Shortage::factory()
  142. ->open()
  143. ->withQuantities(3, 0) // missing 3 WITH docs
  144. ->forSparePart($sparePart)
  145. ->forReclamation($reclamation)
  146. ->withDocuments(true)
  147. ->create();
  148. // Act
  149. $orderQtyWithDocs = $this->service->calculateOrderQuantity($sparePart, true);
  150. $orderQtyWithoutDocs = $this->service->calculateOrderQuantity($sparePart, false);
  151. // Assert
  152. $this->assertEquals(3, $orderQtyWithDocs);
  153. $this->assertEquals(5, $orderQtyWithoutDocs);
  154. }
  155. // ==================== calculateMinStockOrderQuantity ====================
  156. public function test_calculate_min_stock_order_quantity_returns_difference_to_min(): void
  157. {
  158. // Arrange
  159. $sparePart = SparePart::factory()->create(['min_stock' => 15]);
  160. SparePartOrder::factory()
  161. ->inStock()
  162. ->withQuantity(10)
  163. ->forSparePart($sparePart)
  164. ->create();
  165. // Act
  166. $orderQty = $this->service->calculateMinStockOrderQuantity($sparePart);
  167. // Assert
  168. $this->assertEquals(5, $orderQty); // 15 - 10 = 5
  169. }
  170. public function test_calculate_min_stock_order_quantity_returns_zero_when_above_min(): void
  171. {
  172. // Arrange
  173. $sparePart = SparePart::factory()->create(['min_stock' => 5]);
  174. SparePartOrder::factory()
  175. ->inStock()
  176. ->withQuantity(10)
  177. ->forSparePart($sparePart)
  178. ->create();
  179. // Act
  180. $orderQty = $this->service->calculateMinStockOrderQuantity($sparePart);
  181. // Assert
  182. $this->assertEquals(0, $orderQty);
  183. }
  184. public function test_calculate_min_stock_order_quantity_considers_reservations(): void
  185. {
  186. // Arrange
  187. $sparePart = SparePart::factory()->create(['min_stock' => 10]);
  188. $reclamation = Reclamation::factory()->create();
  189. $order = SparePartOrder::factory()
  190. ->inStock()
  191. ->withQuantity(15)
  192. ->forSparePart($sparePart)
  193. ->create();
  194. // Reserve 8 items - leaves 7 free
  195. Reservation::factory()
  196. ->active()
  197. ->withQuantity(8)
  198. ->fromOrder($order)
  199. ->forReclamation($reclamation)
  200. ->create();
  201. // Act
  202. $orderQty = $this->service->calculateMinStockOrderQuantity($sparePart);
  203. // Assert
  204. $this->assertEquals(3, $orderQty); // 10 - 7 = 3
  205. }
  206. // ==================== getStockInfo ====================
  207. public function test_get_stock_info_returns_complete_information(): void
  208. {
  209. // Arrange
  210. $sparePart = SparePart::factory()->create(['min_stock' => 10]);
  211. $reclamation = Reclamation::factory()->create();
  212. $orderWithDocs = SparePartOrder::factory()
  213. ->inStock()
  214. ->withDocuments(true)
  215. ->withQuantity(20)
  216. ->forSparePart($sparePart)
  217. ->create();
  218. $orderWithoutDocs = SparePartOrder::factory()
  219. ->inStock()
  220. ->withDocuments(false)
  221. ->withQuantity(15)
  222. ->forSparePart($sparePart)
  223. ->create();
  224. // Reserve some items
  225. Reservation::factory()
  226. ->active()
  227. ->withQuantity(5)
  228. ->withDocuments(true)
  229. ->fromOrder($orderWithDocs)
  230. ->forReclamation($reclamation)
  231. ->create();
  232. // Act
  233. $info = $this->service->getStockInfo($sparePart->fresh());
  234. // Assert
  235. $this->assertEquals($sparePart->id, $info['spare_part_id']);
  236. $this->assertEquals($sparePart->article, $info['article']);
  237. // Physical: 20 with docs + 15 without = 35 total
  238. $this->assertEquals(15, $info['physical_without_docs']);
  239. $this->assertEquals(20, $info['physical_with_docs']);
  240. $this->assertEquals(35, $info['physical_total']);
  241. // Reserved: 5 with docs
  242. $this->assertEquals(0, $info['reserved_without_docs']);
  243. $this->assertEquals(5, $info['reserved_with_docs']);
  244. $this->assertEquals(5, $info['reserved_total']);
  245. // Free: 35 - 5 = 30
  246. $this->assertEquals(15, $info['free_without_docs']);
  247. $this->assertEquals(15, $info['free_with_docs']); // 20 - 5
  248. $this->assertEquals(30, $info['free_total']);
  249. $this->assertEquals(10, $info['min_stock']);
  250. $this->assertFalse($info['below_min_stock']); // 30 > 10
  251. }
  252. // ==================== getInventorySummary ====================
  253. public function test_get_inventory_summary_returns_aggregated_data(): void
  254. {
  255. // Arrange
  256. $sparePart1 = SparePart::factory()->create(['min_stock' => 100]); // will be below min
  257. $sparePart2 = SparePart::factory()->create(['min_stock' => 5]);
  258. $reclamation = Reclamation::factory()->create();
  259. SparePartOrder::factory()
  260. ->inStock()
  261. ->withQuantity(10)
  262. ->forSparePart($sparePart1)
  263. ->create();
  264. $order2 = SparePartOrder::factory()
  265. ->inStock()
  266. ->withQuantity(20)
  267. ->forSparePart($sparePart2)
  268. ->create();
  269. // Create shortage for sparePart1
  270. Shortage::factory()
  271. ->open()
  272. ->withQuantities(5, 0)
  273. ->forSparePart($sparePart1)
  274. ->forReclamation($reclamation)
  275. ->create();
  276. // Create reservation for sparePart2
  277. Reservation::factory()
  278. ->active()
  279. ->withQuantity(3)
  280. ->fromOrder($order2)
  281. ->forReclamation($reclamation)
  282. ->create();
  283. // Act
  284. $summary = $this->service->getInventorySummary();
  285. // Assert
  286. $this->assertEquals(2, $summary['total_spare_parts']);
  287. $this->assertEquals(1, $summary['critical_shortages_count']);
  288. $this->assertEquals(1, $summary['below_min_stock_count']);
  289. $this->assertEquals(30, $summary['total_physical_stock']); // 10 + 20
  290. $this->assertEquals(3, $summary['total_reserved']);
  291. $this->assertEquals(27, $summary['total_free']); // 30 - 3
  292. }
  293. // ==================== getReservationsForReclamation ====================
  294. public function test_get_reservations_for_reclamation_returns_active_reservations(): void
  295. {
  296. // Arrange
  297. $sparePart = SparePart::factory()->create();
  298. $reclamation = Reclamation::factory()->create();
  299. $order = SparePartOrder::factory()
  300. ->inStock()
  301. ->forSparePart($sparePart)
  302. ->create();
  303. Reservation::factory()
  304. ->active()
  305. ->withQuantity(5)
  306. ->fromOrder($order)
  307. ->forReclamation($reclamation)
  308. ->create();
  309. Reservation::factory()
  310. ->cancelled()
  311. ->fromOrder($order)
  312. ->forReclamation($reclamation)
  313. ->create();
  314. // Act
  315. $reservations = $this->service->getReservationsForReclamation($reclamation->id);
  316. // Assert
  317. $this->assertCount(1, $reservations);
  318. $this->assertEquals(5, $reservations->first()->reserved_qty);
  319. }
  320. // ==================== getShortagesForReclamation ====================
  321. public function test_get_shortages_for_reclamation_returns_all_shortages(): void
  322. {
  323. // Arrange
  324. $sparePart1 = SparePart::factory()->create();
  325. $sparePart2 = SparePart::factory()->create();
  326. $reclamation = Reclamation::factory()->create();
  327. $otherReclamation = Reclamation::factory()->create();
  328. Shortage::factory()
  329. ->open()
  330. ->forSparePart($sparePart1)
  331. ->forReclamation($reclamation)
  332. ->create();
  333. Shortage::factory()
  334. ->closed()
  335. ->forSparePart($sparePart2)
  336. ->forReclamation($reclamation)
  337. ->create();
  338. Shortage::factory()
  339. ->open()
  340. ->forSparePart($sparePart1)
  341. ->forReclamation($otherReclamation)
  342. ->create();
  343. // Act
  344. $shortages = $this->service->getShortagesForReclamation($reclamation->id);
  345. // Assert
  346. $this->assertCount(2, $shortages);
  347. }
  348. // ==================== Deprecated methods ====================
  349. public function test_reserve_for_reclamation_delegates_to_reservation_service(): void
  350. {
  351. // Arrange
  352. $sparePart = SparePart::factory()->create(['article' => 'TEST-001']);
  353. $reclamation = Reclamation::factory()->create();
  354. SparePartOrder::factory()
  355. ->inStock()
  356. ->withDocuments(false)
  357. ->withQuantity(10)
  358. ->forSparePart($sparePart)
  359. ->create();
  360. // Act
  361. $result = $this->service->reserveForReclamation(
  362. 'TEST-001',
  363. 5,
  364. false,
  365. $reclamation->id
  366. );
  367. // Assert
  368. $this->assertEquals(5, $result->reserved);
  369. $this->assertEquals(0, $result->missing);
  370. }
  371. public function test_reserve_for_reclamation_returns_zero_for_unknown_article(): void
  372. {
  373. // Arrange
  374. $reclamation = Reclamation::factory()->create();
  375. // Act
  376. $result = $this->service->reserveForReclamation(
  377. 'UNKNOWN-ARTICLE',
  378. 5,
  379. false,
  380. $reclamation->id
  381. );
  382. // Assert
  383. $this->assertEquals(0, $result->reserved);
  384. $this->assertEquals(5, $result->missing);
  385. }
  386. }