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/stored_procedures.sql

@@ -1,26 +1,31 @@
 -- Stored Procedures equivalent to triggers
 
-DELIMITER //
+DELIMITER / /
 
 -- Procedure for trg_bank_account_transaction_after_insert
 CREATE PROCEDURE update_bank_balance(IN p_bankAccountId INT, IN p_type VARCHAR(20), IN p_amount DECIMAL(15,2))
 BEGIN
+  START TRANSACTION;
   IF p_type = 'DEPOSIT' THEN
     UPDATE Bank_Account_Balance SET balance = balance + p_amount WHERE bankAccountId = p_bankAccountId;
   ELSEIF p_type = 'WITHDRAWAL' THEN
     UPDATE Bank_Account_Balance SET balance = balance - p_amount WHERE bankAccountId = p_bankAccountId;
   END IF;
+  COMMIT;
 END //
 
 -- Procedure for trg_bank_account_transaction_after_delete
 CREATE PROCEDURE update_bank_balance_on_delete(IN p_bankAccountId INT, IN p_amount DECIMAL(15,2))
 BEGIN
+  START TRANSACTION;
   UPDATE Bank_Accounts SET balance = balance - p_amount WHERE id = p_bankAccountId;
+  COMMIT;
 END //
 
 -- Procedure for trg_transfer_item_after_insert
 CREATE PROCEDURE process_transfer_item(IN p_transferId INT, IN p_productId INT, IN p_count DECIMAL(10,2))
 BEGIN
+  START TRANSACTION;
   DECLARE fromInv INT;
   DECLARE toInv INT;
   DECLARE _avgCost DECIMAL(10,2);
@@ -47,42 +52,52 @@ BEGIN
   (type, quantity, unitPrice, totalCost, avgCost, referenceType, referenceId, productId, inventoryId, counterInventoryId, createdAt, remainedInStock)
   VALUES
       ('IN', p_count, _avgCost, _avgCost*p_count, _avgCost, 'INVENTORY_TRANSFER', p_transferId, p_productId, toInv, fromInv, NOW(), latestQuantityInOrigin-p_count);
+  COMMIT;
 END //
 
 -- Procedure for trg_order_item_after_insert
 CREATE PROCEDURE update_stock_reservation_insert(IN p_orderId INT, IN p_productId INT, IN p_quantity DECIMAL(10,2))
 BEGIN
+  START TRANSACTION;
   UPDATE Stock_Reservations SET quantity = quantity + p_quantity
   WHERE orderId = p_orderId AND productId = p_productId;
+  COMMIT;
 END //
 
 -- Procedure for trg_order_item_after_update
 CREATE PROCEDURE update_stock_reservation_update(IN p_orderId INT, IN p_productId INT, IN p_old_quantity DECIMAL(10,2), IN p_new_quantity DECIMAL(10,2))
 BEGIN
+  START TRANSACTION;
   UPDATE Stock_Reservations
   SET quantity = quantity - p_old_quantity + p_new_quantity
   WHERE orderId = p_orderId AND productId = p_productId;
+  COMMIT;
 END //
 
 -- Procedure for trg_order_item_after_delete
 CREATE PROCEDURE update_stock_reservation_delete(IN p_orderId INT, IN p_productId INT, IN p_quantity DECIMAL(10,2))
 BEGIN
+  START TRANSACTION;
   UPDATE Stock_Reservations SET quantity = quantity - p_quantity
   WHERE orderId = p_orderId AND productId = p_productId;
+  COMMIT;
 END //
 
 -- Procedure for trg_order_after_cancel
 CREATE PROCEDURE cancel_order_stock(IN p_orderId INT, IN p_status VARCHAR(20))
 BEGIN
+  START TRANSACTION;
   IF p_status = 'CANCELED' OR p_status = 'REJECTED' OR p_status = 'DONE' THEN
     UPDATE Stock_Reservations sr SET quantity = 0
     WHERE sr.orderId = p_orderId;
   END IF;
+  COMMIT;
 END //
 
 -- Procedure for trg_purchase_receipt_item_after_insert
 CREATE PROCEDURE process_purchase_item(IN p_receiptId INT, IN p_productId INT, IN p_count DECIMAL(10,2), IN p_unitPrice DECIMAL(15,2), IN p_totalAmount DECIMAL(15,2))
 BEGIN
+  START TRANSACTION;
   DECLARE latestQuantity DECIMAL(10, 2) DEFAULT 0;
   DECLARE invId INT;
   DECLARE suppId INT;
@@ -133,11 +148,13 @@ BEGIN
       latestQuantity + p_count,
       NOW()
   );
+  COMMIT;
 END //
 
 -- Procedure for trg_pr_payment_before_insert
 CREATE PROCEDURE validate_payment_before_insert(IN p_receiptId INT, IN p_type VARCHAR(20), IN p_amount DECIMAL(15,2))
 BEGIN
+  START TRANSACTION;
   DECLARE receiptTotal DECIMAL(14,2);
   DECLARE paid DECIMAL(14,2);
 
@@ -151,11 +168,13 @@ BEGIN
     SIGNAL SQLSTATE '45000'
       SET MESSAGE_TEXT = 'مجموع مبلغ پرداختی بیشتر از مبلغ فاکتور است.';
   END IF;
+  COMMIT;
 END //
 
 -- Procedure for trg_purchase_payment_update_receipt
 CREATE PROCEDURE update_receipt_payment(IN p_receiptId INT)
 BEGIN
+  START TRANSACTION;
   DECLARE paid DECIMAL(15,2);
   DECLARE total DECIMAL(15,2);
 
@@ -180,11 +199,13 @@ BEGIN
       ELSE 'PAID'
     END
   WHERE id = p_receiptId;
+  COMMIT;
 END //
 
 -- Procedure for trg_purchase_payment_after_insert
 CREATE PROCEDURE process_purchase_payment(IN p_bankAccountId INT, IN p_type VARCHAR(20), IN p_amount DECIMAL(15,2), IN p_id INT)
 BEGIN
+  START TRANSACTION;
   DECLARE currentBalance DECIMAL(15, 2);
 
   SELECT balance INTO currentBalance
@@ -214,7 +235,7 @@ BEGIN
         'PURCHASE_PAYMENT',
         p_id
     );
-  ELSE 
+  ELSE
     SET currentBalance = currentBalance + p_amount;
     INSERT INTO Bank_Account_Transactions (
         bankAccountId,
@@ -237,11 +258,13 @@ BEGIN
   UPDATE Bank_Account_Balance
   SET balance = currentBalance
   WHERE bankAccountId = p_bankAccountId;
+  COMMIT;
 END //
 
 -- Procedure for trg_pr_payment_after_insert
 CREATE PROCEDURE update_supplier_ledger(IN p_receiptId INT, IN p_type VARCHAR(20), IN p_amount DECIMAL(15,2), IN p_id INT)
 BEGIN
+  START TRANSACTION;
   DECLARE receiptTotal DECIMAL(14,2) DEFAULT 0;
   DECLARE newPaid DECIMAL(14,2) DEFAULT 0;
   DECLARE _supplierId INT;
@@ -304,6 +327,7 @@ BEGIN
     p_id,
     NOW()
   );
+  COMMIT;
 END //
 
 -- Procedure for trg_pr_payment_after_delete
@@ -486,7 +510,7 @@ END //
 CREATE PROCEDURE process_pos_payment(IN p_invoiceId INT, IN p_paymentMethod VARCHAR(20), IN p_amount DECIMAL(15,2), IN p_id INT)
 BEGIN
   DECLARE _bankAccountId INT;
-  
+
   IF(p_paymentMethod != 'CASH') THEN
     SELECT cashBankAccountId INTO _bankAccountId
     FROM Pos_Accounts pa
@@ -545,7 +569,7 @@ BEGIN
       updatedAt = NOW();
   END IF;
 
-  IF p_type = 'OUT' THEN 
+  IF p_type = 'OUT' THEN
     IF EXISTS (
       SELECT 1
       FROM Stock_Balance sb
@@ -630,4 +654,4 @@ BEGIN
     avgCost = totalCost / quantity;
 END //
 
-DELIMITER ;
+DELIMITER;