feat: add endpoints desc

src/application/commands/create_crypto_transfer_completed_command.py

@@ -3,7 +3,7 @@ from decimal import Decimal
 from src.application.abstractions import IUnitOfWork
 from src.application.contracts import ILogger,IReceipt
 from src.application.domain.enums import PaymentStatus
-from src.application.domain.exceptions import ApplicationException
+from src.application.domain.exceptions import ApplicationException,NotFoundException,PaymentMetadataException,ReceiptDataException
 from src.infrastructure.database.decorators import transactional
 
 
@@ -17,19 +17,19 @@ class CreateCryptoTransferCompletedCommand:
     @transactional
     async def __call__(self, *, order_id: str, user_id: str, web3_transaction_hash: str | None = None) -> None:
         if not order_id:
-            raise ApplicationException(status_code=400, message='Crypto transfer completed message missing order_id')
+            raise PaymentMetadataException(message='Crypto transfer completed message missing order_id')
         if not user_id:
-            raise ApplicationException(status_code=400, message='Crypto transfer completed message missing user_id')
+            raise PaymentMetadataException(message='Crypto transfer completed message missing user_id')
         await self._unit_of_work.payment_repository.update_crypto_transfer_completed(
             order_id=order_id,
             web3_transaction_hash=web3_transaction_hash,
         )
         user = await self._unit_of_work.user_repository.get(user_id)
         if user is None:
-            raise ApplicationException(status_code=404, message='User not found')
+            raise NotFoundException(message='User not found')
         email = str(user.email or '').strip()
         if not email:
-            raise ApplicationException(status_code=400, message='User email missing')
+            raise ReceiptDataException(message='User email missing')
         customer_info = ' '.join(
             part
             for part in (
@@ -40,28 +40,28 @@ class CreateCryptoTransferCompletedCommand:
             if part
         )
         if not customer_info:
-            raise ApplicationException(status_code=400, message='User full name missing')
+            raise ReceiptDataException(message='User full name missing')
         customer_inn = str(user.inn or '').strip()
         if not customer_inn:
-            raise ApplicationException(status_code=400, message='User inn missing')
+            raise ReceiptDataException(message='User inn missing')
         if user.birth_date is None:
-            raise ApplicationException(status_code=400, message='User birth date missing')
+            raise ReceiptDataException(message='User birth date missing')
         customer_birthday = f'{user.birth_date.isoformat()}T12:00:00.000Z'
 
         order = await self._unit_of_work.order_repository.get_by_id(order_id)
         if order is None:
-            raise ApplicationException(status_code=404, message='Order not found')
+            raise NotFoundException(message='Order not found')
         if order.total_price is None:
-            raise ApplicationException(status_code=400, message='Order total price missing for receipt')
+            raise ReceiptDataException(message='Order total price missing for receipt')
         if order.service_fee is None:
-            raise ApplicationException(status_code=400, message='Order service fee missing for receipt')
+            raise ReceiptDataException(message='Order service fee missing for receipt')
 
         total_amount = Decimal(str(order.total_price)).quantize(Decimal('0.01'))
         service_fee = Decimal(str(order.service_fee)).quantize(Decimal('0.01'))
         principal_amount = (total_amount - service_fee).quantize(Decimal('0.01'))
 
         if principal_amount < 0:
-            raise ApplicationException(status_code=400, message='Invalid receipt amounts: principal negative')
+            raise ReceiptDataException(message='Invalid receipt amounts: principal negative')
 
         try:
             receipt_response = await self._receipt.create_receipt(

src/application/commands/create_order_command.py

@@ -7,7 +7,7 @@ from src.application.contracts import ILogger
 from src.application.contracts import IItPayService
 from src.application.domain.entities.order import OrderEntity
 from src.application.domain.enums import OrderStatus
-from src.application.domain.exceptions import ApplicationException
+from src.application.domain.exceptions import PriceChangedException
 from src.application.services import PaymentQuoteService
 from src.infrastructure.database.decorators import transactional
 from src.presentation.schemas.order import CreateOrder
@@ -40,7 +40,7 @@ class CreateOrderCommand:
         actual_total_price = quote.total_price
         if actual_total_price > payment_data.total_price * Decimal('1.01'):
             self._logger.error('Price has changed, please refresh and try again')
-            raise ApplicationException(status_code=409, message='Price has changed, please refresh and try again')
+            raise PriceChangedException()
 
         order = OrderEntity(
             user_id=user_id,

src/application/commands/create_payment_command.py

@@ -3,7 +3,7 @@ from ulid import ULID
 from src.application.abstractions import IUnitOfWork
 from src.application.contracts import ILogger,IQueueMessanger
 from src.application.domain.enums import PaymentStatus
-from src.application.domain.exceptions import ApplicationException
+from src.application.domain.exceptions import PaymentMetadataException
 from src.infrastructure.config import settings
 from src.infrastructure.database.decorators import transactional
 from src.presentation.schemas.itpay_payment_models import ItpayPaymentData
@@ -25,9 +25,9 @@ class CreatePaymentCommand:
         trace_id = str(metadata.get('trace_id') or self._logger.get_trace_id())
         self._logger.set_trace_id(trace_id)
         if not order_id:
-            raise ApplicationException(status_code=400, message='Itpay webhook metadata missing order_id')
+            raise PaymentMetadataException(message='Itpay webhook metadata missing order_id')
         if not user_id:
-            raise ApplicationException(status_code=400, message='Itpay webhook metadata missing user_id')
+            raise PaymentMetadataException(message='Itpay webhook metadata missing user_id')
         payment_created = await self._unit_of_work.payment_repository.create_completed(
             user_id=user_id,
             order_id=order_id,