Refactor and enhance CRUD operations for Seal, Trailer, Transporter, Vehicle, and Customs Broker modules

- Updated SealService to support tenant and company filtering with pagination and enhanced CRUD methods.
- Refactored TrailerService to include tenant and company support, added filtering capabilities, and improved CRUD methods.
- Introduced TenantCRUDRoutes for Trailer and Transporter routes to streamline API endpoint creation and management.
- Enhanced TransporterService with tenant and company filtering, pagination, and improved CRUD operations.
- Added Customs Broker module with DTOs, models, services, and routes for managing customs broker data.
- Implemented CRUD operations for Customs Broker, including personnel and VU management.
- Improved data validation and descriptions in DTOs for better API documentation.

backend/api/v1/common/dto_mixins.py

@@ -1,17 +1,17 @@
 from decimal import Decimal
 from typing import Optional
 
-from pydantic import BaseModel, Field
+from pydantic import Field
 
 
-class CurrencyMixin(BaseModel):
+class CurrencyMixin:
     """Mixin for currency-related fields"""
 
     currency: Optional[str] = Field(None, max_length=3, description="Currency")
     currency_factor: Optional[Decimal] = Field(None, description="Currency factor")
 
 
-class AffectValueMixin(BaseModel):
+class AffectValueMixin:
     """Mixin for value affect flags"""
 
     not_affect_usd_value: Optional[int] = Field(
@@ -22,7 +22,7 @@ class AffectValueMixin(BaseModel):
     )
 
 
-class UpdateFlagsMixin(BaseModel):
+class UpdateFlagsMixin:
     """Mixin for update flags"""
 
     update_vat: Optional[int] = Field(None, description="Update VAT")

backend/api/v1/common/tenant_crud_routes.py

@@ -1,4 +1,4 @@
-from typing import Any, Callable, Dict, Generic, Optional, Type, TypeVar
+from typing import Any, Callable, Dict, Generic, Optional, Type, TypeVar, Union
 
 from core.database import get_core_db
 from core.security import get_current_user, validate_access_to_resource
@@ -49,6 +49,20 @@ class TenantCRUDRoutes(
             parent_id_name="pedimento_id",
             enable_list=False,
         ).router
+
+    3. Parent resource with string ID (e.g., /vehicles with vehicle_key):
+        router = TenantCRUDRoutes(
+            service=VehicleService,
+            create_schema=VehicleCreate,
+            update_schema=VehicleUpdate,
+            response_schema=VehicleResponse,
+            prefix="/vehicles",
+            tags=["Vehicles"],
+            resource_name="Vehicle",
+            id_name="vehicle_key",
+            id_type=str,  # Specify string type for vehicle_key
+            enable_list=True,
+        ).router
     """
 
     def __init__(
@@ -61,6 +75,7 @@ class TenantCRUDRoutes(
         tags: list[str],
         resource_name: str = "Resource",
         id_name: Optional[str] = None,  # For parent resources (e.g., "pedimento_id")
+        id_type: Type = int,  # Type of the ID (int, str, etc.)
         parent_id_name: Optional[
             str
         ] = None,  # For child resources (e.g., "pedimento_id")
@@ -78,6 +93,7 @@ class TenantCRUDRoutes(
         self.response_schema = response_schema
         self.resource_name = resource_name
         self.id_name = id_name or parent_id_name or "id"
+        self.id_type = id_type
         self.parent_id_name = parent_id_name
         self.db_dependency = db_dependency
         self.auth_dependency = auth_dependency
@@ -210,7 +226,7 @@ class TenantCRUDRoutes(
                 f"/{{{self.id_name}}}", response_model=self.response_schema
             )
             async def get_resource_by_id(
-                resource_id: int = Path(..., alias=self.id_name),
+                resource_id: Union[int, str] = Path(..., alias=self.id_name),
                 company_id: int = Query(..., description="Company ID"),
                 db: Session = Depends(self.db_dependency),
                 current_user: Dict[str, Any] = Depends(self.auth_dependency),
@@ -287,7 +303,7 @@ class TenantCRUDRoutes(
             )
             async def update_resource_by_id(
                 data: UpdateSchemaType,
-                resource_id: int = Path(..., alias=self.id_name),
+                resource_id: Union[int, str] = Path(..., alias=self.id_name),
                 company_id: int = Query(..., description="Company ID"),
                 db: Session = Depends(self.db_dependency),
                 current_user: Dict[str, Any] = Depends(self.auth_dependency),
@@ -333,7 +349,7 @@ class TenantCRUDRoutes(
             # Parent resource
             @self.router.delete(f"/{{{self.id_name}}}", status_code=204)
             async def delete_resource_by_id(
-                resource_id: int = Path(..., alias=self.id_name),
+                resource_id: Union[int, str] = Path(..., alias=self.id_name),
                 company_id: int = Query(..., description="Company ID"),
                 db: Session = Depends(self.db_dependency),
                 current_user: Dict[str, Any] = Depends(self.auth_dependency),