refactor: restructure purchase receipts module and related workflows

- Removed old DTOs for creating and updating purchase receipts.
- Updated purchase receipts controller and service to use new DTOs and workflows.
- Introduced transaction helper for managing database transactions.
- Added new workflows for handling purchase receipt payments and supplier ledgers.
- Implemented new logic for managing purchase receipt items and payments.
- Enhanced error handling for payment processing in workflows.
- Updated supplier ledger management to reflect changes in purchase receipts.

prisma/triggers/dump_triggers.sql

@@ -1,34 +1,19 @@
 -- AUTO-GENERATED MYSQL TRIGGER DUMP
--- Generated at: 2026-01-04T09:46:30.365Z
+-- Generated at: 2026-01-04T17:29:18.092Z
 
 -- ------------------------------------------
 -- index: 1
--- Trigger: trg_bank_account_transaction_after_insert
--- Event: INSERT
--- Table: Bank_Account_Transactions
--- ------------------------------------------
-DROP TRIGGER IF EXISTS `trg_bank_account_transaction_after_insert`;
-CREATE DEFINER=`pos`@`%` TRIGGER `trg_bank_account_transaction_after_insert` AFTER INSERT ON `Bank_Account_Transactions` FOR EACH ROW BEGIN
-  IF NEW.type = 'DEPOSIT' THEN
-    UPDATE Bank_Account_Balance SET balance = balance + NEW.amount WHERE bankAccountId = NEW.bankAccountId;
-  ELSEIF NEW.type = 'WITHDRAWAL' THEN
-    UPDATE Bank_Account_Balance SET balance = balance - NEW.amount WHERE bankAccountId = NEW.bankAccountId;
-  END IF;
-END;
-
--- ------------------------------------------
--- index: 2
 -- Trigger: trg_bank_account_transaction_after_delete
 -- Event: DELETE
 -- Table: Bank_Account_Transactions
 -- ------------------------------------------
 DROP TRIGGER IF EXISTS `trg_bank_account_transaction_after_delete`;
 CREATE DEFINER=`pos`@`%` TRIGGER `trg_bank_account_transaction_after_delete` AFTER DELETE ON `Bank_Account_Transactions` FOR EACH ROW BEGIN
-  UPDATE Bank_Accounts SET balance = balance - OLD.amount;
+  UPDATE `Bank_Account_Balance` SET balance = balance - OLD.amount WHERE `bankAccountId` = OLD.bankAccountId;
 END;
 
 -- ------------------------------------------
--- index: 3
+-- index: 2
 -- Trigger: trg_transfer_item_after_insert
 -- Event: INSERT
 -- Table: Inventory_Transfer_Items
@@ -66,7 +51,7 @@ DECLARE fromInv INT;
 end;
 
 -- ------------------------------------------
--- index: 4
+-- index: 3
 -- Trigger: trg_order_item_after_insert
 -- Event: INSERT
 -- Table: Order_Items
@@ -78,7 +63,7 @@ CREATE DEFINER=`pos`@`%` TRIGGER `trg_order_item_after_insert` AFTER INSERT ON `
 END;
 
 -- ------------------------------------------
--- index: 5
+-- index: 4
 -- Trigger: trg_order_item_after_update
 -- Event: UPDATE
 -- Table: Order_Items
@@ -91,7 +76,7 @@ CREATE DEFINER=`pos`@`%` TRIGGER `trg_order_item_after_update` AFTER UPDATE ON `
 END;
 
 -- ------------------------------------------
--- index: 6
+-- index: 5
 -- Trigger: trg_order_item_after_delete
 -- Event: DELETE
 -- Table: Order_Items
@@ -104,7 +89,7 @@ CREATE DEFINER=`pos`@`%` TRIGGER `trg_order_item_after_delete` AFTER DELETE ON `
 END;
 
 -- ------------------------------------------
--- index: 7
+-- index: 6
 -- Trigger: trg_order_after_cancel
 -- Event: UPDATE
 -- Table: Orders
@@ -118,7 +103,7 @@ CREATE DEFINER=`pos`@`%` TRIGGER `trg_order_after_cancel` AFTER UPDATE ON `Order
 END;
 
 -- ------------------------------------------
--- index: 8
+-- index: 7
 -- Trigger: trg_purchase_receipt_item_after_insert
 -- Event: INSERT
 -- Table: Purchase_Receipt_Items
@@ -181,222 +166,7 @@ DECLARE invId INT;
 END;
 
 -- ------------------------------------------
--- index: 9
--- Trigger: trg_pr_payment_before_insert
--- Event: INSERT
--- Table: Purchase_Receipt_Payments
--- ------------------------------------------
-DROP TRIGGER IF EXISTS `trg_pr_payment_before_insert`;
-CREATE DEFINER=`pos`@`%` TRIGGER `trg_pr_payment_before_insert` BEFORE INSERT ON `Purchase_Receipt_Payments` FOR EACH ROW BEGIN
-
-
-  DECLARE receiptTotal DECIMAL(14,2);
-  DECLARE paid DECIMAL(14,2);
-
-
-  SELECT totalAmount, paidAmount
-  INTO receiptTotal, paid
-  FROM Purchase_Receipts
-  WHERE id = NEW.receiptId
-  FOR UPDATE;
-
-  IF NEW.type = 'PAYMENT' AND paid + NEW.amount > receiptTotal THEN
-    SIGNAL SQLSTATE '45000'
-      SET MESSAGE_TEXT = 'مجموع مبلغ پرداختی بیشتر از مبلغ فاکتور است.';
-  END IF;
-END;
-
--- ------------------------------------------
--- index: 10
--- Trigger: trg_purchase_payment_update_receipt
--- Event: INSERT
--- Table: Purchase_Receipt_Payments
--- ------------------------------------------
-DROP TRIGGER IF EXISTS `trg_purchase_payment_update_receipt`;
-CREATE DEFINER=`pos`@`%` TRIGGER `trg_purchase_payment_update_receipt` AFTER INSERT ON `Purchase_Receipt_Payments` FOR EACH ROW BEGIN
-  DECLARE paid DECIMAL(15,2);
-  DECLARE total DECIMAL(15,2);
-
-  SELECT
-    COALESCE(SUM(
-      CASE WHEN type = 'PAYMENT' THEN amount ELSE -amount END
-    ),0)
-  INTO paid
-  FROM Purchase_Receipt_Payments
-  WHERE receiptId = NEW.receiptId;
-
-  SELECT totalAmount INTO total
-  FROM Purchase_Receipts
-  WHERE id = NEW.receiptId;
-
-  UPDATE Purchase_Receipts
-  SET
-    paidAmount = paid,
-    status = CASE
-      WHEN paid = 0 THEN 'UNPAID'
-      WHEN paid < total THEN 'PARTIALLY_PAID'
-      ELSE 'PAID'
-    END
-  WHERE id = NEW.receiptId;
-END;
-
--- ------------------------------------------
--- index: 11
--- Trigger: trg_purchase_payment_after_insert
--- Event: INSERT
--- Table: Purchase_Receipt_Payments
--- ------------------------------------------
-DROP TRIGGER IF EXISTS `trg_purchase_payment_after_insert`;
-CREATE DEFINER=`pos`@`%` TRIGGER `trg_purchase_payment_after_insert` AFTER INSERT ON `Purchase_Receipt_Payments` FOR EACH ROW BEGIN
-
-DECLARE currentBalance DECIMAL(15, 2);
-
-
-SELECT balance INTO currentBalance
-FROM Bank_Account_Balance
-WHERE
-    bankAccountId = NEW.bankAccountId FOR
-UPDATE;
-
-
-IF currentBalance IS NULL THEN SET currentBalance = 0;
-
-
-INSERT INTO
-    Bank_Account_Balance (bankAccountId, balance, updatedAt)
-VALUES (NEW.bankAccountId, 0, NOW());
-
-END IF;
-
-IF NEW.type = 'PAYMENT' THEN
-SET
-    currentBalance = currentBalance - NEW.amount;
-
-INSERT INTO
-    Bank_Account_Transactions (
-        bankAccountId,
-        type,
-        amount,
-        balanceAfter,
-        referenceType,
-        referenceId
-    )
-VALUES (
-        NEW.bankAccountId,
-        'WITHDRAWAL',
-        NEW.amount,
-        currentBalance,
-        'PURCHASE_PAYMENT',
-        NEW.id
-    );
-
-ELSE SET currentBalance = currentBalance + NEW.amount;
-
-INSERT INTO
-    Bank_Account_Transactions (
-        bankAccountId,
-        type,
-        amount,
-        balanceAfter,
-        referenceType,
-        referenceId
-    )
-VALUES (
-        NEW.bankAccountId,
-        'DEPOSIT',
-        NEW.amount,
-        currentBalance,
-        'PURCHASE_REFUND',
-        NEW.id
-    );
-
-END IF;
-
-UPDATE Bank_Account_Balance
-SET
-    balance = currentBalance
-WHERE
-    bankAccountId = NEW.bankAccountId;
-
-END;
-
--- ------------------------------------------
--- index: 12
--- Trigger: trg_pr_payment_after_insert
--- Event: INSERT
--- Table: Purchase_Receipt_Payments
--- ------------------------------------------
-DROP TRIGGER IF EXISTS `trg_pr_payment_after_insert`;
-CREATE DEFINER=`pos`@`%` TRIGGER `trg_pr_payment_after_insert` AFTER INSERT ON `Purchase_Receipt_Payments` FOR EACH ROW BEGIN
-  DECLARE receiptTotal DECIMAL(14,2) Default 0;
-  DECLARE newPaid DECIMAL(14,2) Default 0;
-  DECLARE _supplierId INT;
-  DECLARE lastBalance DECIMAL(14,2) Default 0;
-
-
-  -- Lock receipt row
-SELECT COALESCE(totalAmount, 0), COALESCE(paidAmount, 0), supplierId
-  INTO receiptTotal, newPaid, _supplierId
-  FROM Purchase_Receipts
-  WHERE id = NEW.receiptId
-  FOR UPDATE;
-
-  -- Apply payment or refund
-  IF NEW.type = 'PAYMENT' THEN
-    SET newPaid = newPaid + NEW.amount;
-  ELSE
-    SET newPaid = newPaid - NEW.amount;
-  END IF;
-
-  -- Update receipt
-  UPDATE Purchase_Receipts
-  SET
-    paidAmount = newPaid,
-    status =
-      CASE
-        WHEN newPaid = 0 THEN 'UNPAID'
-        WHEN newPaid < receiptTotal THEN 'PARTIALLY_PAID'
-        ELSE 'PAID'
-      END
-  WHERE id = NEW.receiptId;
-
-  -- Get last supplier balance
-  SELECT IFNULL(balance, 0)
-  INTO lastBalance
-  FROM Supplier_Ledger
-  WHERE supplierId = _supplierId
-  ORDER BY id DESC
-  LIMIT 1;
-
-
-
-  -- Insert supplier ledger
-  INSERT INTO Supplier_Ledger
-  (
-    supplierId,
-    debit,
-    credit,
-    balance,
-    sourceType,
-    sourceId,
-    createdAt
-  )
-  VALUES
-  (
-    _supplierId,
-    IF(NEW.type = 'REFUND', NEW.amount, 0),
-    IF(NEW.type = 'PAYMENT', NEW.amount, 0),
-    lastBalance
-      + IF(NEW.type = 'PAYMENT', NEW.amount, 0)
-      - IF(NEW.type = 'REFUND', NEW.amount, 0),
-    'PAYMENT',
-    NEW.id,
-    NOW()
-  );
-END;
-
--- ------------------------------------------
--- index: 13
+-- index: 8
 -- Trigger: trg_pr_payment_after_delete
 -- Event: DELETE
 -- Table: Purchase_Receipt_Payments
@@ -431,46 +201,7 @@ CREATE DEFINER=`pos`@`%` TRIGGER `trg_pr_payment_after_delete` AFTER DELETE ON `
 END;
 
 -- ------------------------------------------
--- index: 14
--- Trigger: trg_purchase_receipt_after_insert
--- Event: INSERT
--- Table: Purchase_Receipts
--- ------------------------------------------
-DROP TRIGGER IF EXISTS `trg_purchase_receipt_after_insert`;
-CREATE DEFINER=`pos`@`%` TRIGGER `trg_purchase_receipt_after_insert` AFTER INSERT ON `Purchase_Receipts` FOR EACH ROW BEGIN
-  DECLARE lastBalance DECIMAL(14,2) DEFAULT 0;
-
-  SELECT COALESCE(balance, 0)
-  INTO lastBalance
-  FROM Supplier_Ledger
-  WHERE supplierId = NEW.supplierId
-  ORDER BY id DESC
-  LIMIT 1;
-
-  INSERT INTO Supplier_Ledger
-  (
-    supplierId,
-    debit,
-    credit,
-    balance,
-    sourceType,
-    sourceId,
-    createdAt
-  )
-  VALUES
-  (
-    NEW.supplierId,
-    NEW.totalAmount,
-    0,
-    lastBalance - NEW.totalAmount,
-    'PURCHASE',
-    NEW.id,
-    NOW()
-  );
-END;
-
--- ------------------------------------------
--- index: 15
+-- index: 9
 -- Trigger: trg_sales_invoice_items_before_insert
 -- Event: INSERT
 -- Table: Sales_Invoice_Items
@@ -503,7 +234,7 @@ CREATE DEFINER=`pos`@`%` TRIGGER `trg_sales_invoice_items_before_insert` BEFORE
 end;
 
 -- ------------------------------------------
--- index: 16
+-- index: 10
 -- Trigger: trg_sales_invoice_items_after_insert
 -- Event: INSERT
 -- Table: Sales_Invoice_Items
@@ -576,7 +307,43 @@ DECLARE pos_id INT;
 END;
 
 -- ------------------------------------------
--- index: 17
+-- index: 11
+-- Trigger: trg_pos_account_payment_after_insert
+-- Event: INSERT
+-- Table: Sales_Invoice_Payments
+-- ------------------------------------------
+DROP TRIGGER IF EXISTS `trg_pos_account_payment_after_insert`;
+CREATE DEFINER=`pos`@`%` TRIGGER `trg_pos_account_payment_after_insert` AFTER INSERT ON `Sales_Invoice_Payments` FOR EACH ROW BEGIN
+  
+  DECLARE _bankAccountId INT;
+  
+  IF(NEW.paymentMethod != 'CASH') THEN
+    SELECT cashBankAccountId INTO _bankAccountId
+    FROM Pos_Accounts pa
+    INNER JOIN Sales_Invoices si ON pa.id = si.posAccountId
+    WHERE si.id = NEW.invoiceId;
+  End IF;
+
+  INSERT INTO Bank_Account_Transactions (
+    bankAccountId,
+    type,
+    amount,
+    balanceAfter,
+    referenceType,
+    referenceId
+  )
+  VALUES(
+    _bankAccountId,
+    'DEPOSIT',
+    NEW.amount,
+    0,
+    'POS_SALE',
+    NEW.id
+  );
+END;
+
+-- ------------------------------------------
+-- index: 12
 -- Trigger: trg_sales_invoice_payment_after_insert
 -- Event: INSERT
 -- Table: Sales_Invoice_Payments
@@ -615,43 +382,77 @@ CREATE DEFINER=`pos`@`%` TRIGGER `trg_sales_invoice_payment_after_insert` AFTER
 END;
 
 -- ------------------------------------------
--- index: 18
--- Trigger: trg_pos_account_payment_after_insert
+-- index: 13
+-- Trigger: trg_stock_sale_insert
 -- Event: INSERT
--- Table: Sales_Invoice_Payments
+-- Table: Stock_Movements
 -- ------------------------------------------
-DROP TRIGGER IF EXISTS `trg_pos_account_payment_after_insert`;
-CREATE DEFINER=`pos`@`%` TRIGGER `trg_pos_account_payment_after_insert` AFTER INSERT ON `Sales_Invoice_Payments` FOR EACH ROW BEGIN
-  
-  DECLARE _bankAccountId INT;
-  
-  IF(NEW.paymentMethod != 'CASH') THEN
-    SELECT cashBankAccountId INTO _bankAccountId
-    FROM Pos_Accounts pa
-    INNER JOIN Sales_Invoices si ON pa.id = si.posAccountId
-    WHERE si.id = NEW.invoiceId;
-  End IF;
+DROP TRIGGER IF EXISTS `trg_stock_sale_insert`;
+CREATE DEFINER=`pos`@`%` TRIGGER `trg_stock_sale_insert` AFTER INSERT ON `Stock_Movements` FOR EACH ROW BEGIN IF NEW.referenceType = 'SALES' THEN
+
+INSERT INTO
+    Stock_Balance (
+        productId,
+        quantity,
+        avgCost,
+        totalCost,
+        inventoryId,
+        updatedAt
+    )
+VALUES (
+        NEW.productId,
+        NEW.quantity,
+        NEW.unitPrice,
+        NEW.totalCost,
+        NEW.inventoryId,
+        NOW()
+    )
+ON DUPLICATE KEY UPDATE
+    quantity = quantity - NEW.quantity,
+    totalCost = totalCost - NEW.totalCost,
+    avgCost = totalCost / quantity;
+
+END IF;
 
-  INSERT INTO Bank_Account_Transactions (
-    bankAccountId,
-    type,
-    amount,
-    balanceAfter,
-    referenceType,
-    referenceId
-  )
-  VALUES(
-    _bankAccountId,
-    'DEPOSIT',
-    NEW.amount,
-    0,
-    'POS_SALE',
-    NEW.id
-  );
 END;
 
 -- ------------------------------------------
--- index: 19
+-- index: 14
+-- Trigger: trg_stock_purchase_insert
+-- Event: INSERT
+-- Table: Stock_Movements
+-- ------------------------------------------
+DROP TRIGGER IF EXISTS `trg_stock_purchase_insert`;
+CREATE DEFINER=`pos`@`%` TRIGGER `trg_stock_purchase_insert` AFTER INSERT ON `Stock_Movements` FOR EACH ROW BEGIN IF NEW.referenceType = 'PURCHASE' THEN
+
+INSERT INTO
+    Stock_Balance (
+        productId,
+        quantity,
+        avgCost,
+        totalCost,
+        inventoryId,
+        updatedAt
+    )
+VALUES (
+        NEW.productId,
+        NEW.quantity,
+        NEW.unitPrice,
+        NEW.totalCost,
+        NEW.inventoryId,
+        NOW()
+    )
+ON DUPLICATE KEY UPDATE
+    quantity = quantity + NEW.quantity,
+    totalCost = totalCost + NEW.totalCost,
+    avgCost = totalCost / quantity;
+
+END IF;
+
+END;
+
+-- ------------------------------------------
+-- index: 15
 -- Trigger: trg_stock_transfer
 -- Event: INSERT
 -- Table: Stock_Movements
@@ -733,73 +534,3 @@ END IF;
 
 END;
 
--- ------------------------------------------
--- index: 20
--- Trigger: trg_stock_purchase_insert
--- Event: INSERT
--- Table: Stock_Movements
--- ------------------------------------------
-DROP TRIGGER IF EXISTS `trg_stock_purchase_insert`;
-CREATE DEFINER=`pos`@`%` TRIGGER `trg_stock_purchase_insert` AFTER INSERT ON `Stock_Movements` FOR EACH ROW BEGIN IF NEW.referenceType = 'PURCHASE' THEN
-
-INSERT INTO
-    Stock_Balance (
-        productId,
-        quantity,
-        avgCost,
-        totalCost,
-        inventoryId,
-        updatedAt
-    )
-VALUES (
-        NEW.productId,
-        NEW.quantity,
-        NEW.unitPrice,
-        NEW.totalCost,
-        NEW.inventoryId,
-        NOW()
-    )
-ON DUPLICATE KEY UPDATE
-    quantity = quantity + NEW.quantity,
-    totalCost = totalCost + NEW.totalCost,
-    avgCost = totalCost / quantity;
-
-END IF;
-
-END;
-
--- ------------------------------------------
--- index: 21
--- Trigger: trg_stock_sale_insert
--- Event: INSERT
--- Table: Stock_Movements
--- ------------------------------------------
-DROP TRIGGER IF EXISTS `trg_stock_sale_insert`;
-CREATE DEFINER=`pos`@`%` TRIGGER `trg_stock_sale_insert` AFTER INSERT ON `Stock_Movements` FOR EACH ROW BEGIN IF NEW.referenceType = 'SALES' THEN
-
-INSERT INTO
-    Stock_Balance (
-        productId,
-        quantity,
-        avgCost,
-        totalCost,
-        inventoryId,
-        updatedAt
-    )
-VALUES (
-        NEW.productId,
-        NEW.quantity,
-        NEW.unitPrice,
-        NEW.totalCost,
-        NEW.inventoryId,
-        NOW()
-    )
-ON DUPLICATE KEY UPDATE
-    quantity = quantity - NEW.quantity,
-    totalCost = totalCost - NEW.totalCost,
-    avgCost = totalCost / quantity;
-
-END IF;
-
-END;
-