add quantity cap for GENERAL contracts and implement capacity tracking

- Updated ContractClearanceService and ContractsController to remove region parameter from queue method.
- Enhanced ContractsRepository to attach contract files for download and added attachContractFiles method.
- Modified ContractsService to persist cargo scope with quantity cap based on contract kind.
- Introduced quantityCap field in CreateContractCargoScopeDto and ContractCargoScope entity.
- Implemented capacity tracking in the frontend with ContractCapacityNotice component to display remaining bookable quantities.
- Updated various components and services to support new capacity features, including hooks and API calls.
- Added migration to include quantity_cap column in contract_cargo_scope table.

apps/edr-freight-web/backoffice/src/components/contracts/GlCreateBookingForm.tsx

@@ -2,6 +2,8 @@ import { useMemo, useState } from "react";
 import { useNavigate, useParams } from "react-router-dom";
 import {
   ActionIcon,
+  Alert,
+  Badge,
   Box,
   Button,
   Center,
@@ -29,9 +31,11 @@ import { PageContainer } from "@/components/page";
 import { PageHeader } from "@/components/page/PageHeader";
 import { SectionCard } from "@/components/bookings/detail/SectionCard";
 import {
+  useContractCapacity,
   useContractDetail,
   useContractMutations,
 } from "@/hooks/contracts/useContracts";
+import { Boxes } from "lucide-react";
 
 interface UnitDraft {
   containerNumber: string;
@@ -61,6 +65,7 @@ export default function GlCreateBookingForm() {
   const { id } = useParams<{ id: string }>();
   const navigate = useNavigate();
   const { data: contract, isLoading } = useContractDetail(id);
+  const { data: capacity = [] } = useContractCapacity(id);
   const mutations = useContractMutations(id ?? "");
 
   const [scheduledDate, setScheduledDate] = useState("");
@@ -221,6 +226,28 @@ export default function GlCreateBookingForm() {
       />
 
       <Stack gap="lg">
+        {capacity.length > 0 && (
+          <Alert
+            color={capacity.every((c) => c.remaining === 0) ? "red" : "blue"}
+            variant="light"
+            radius="md"
+            icon={<Boxes size={16} />}
+            title="Contract draw-down capacity"
+          >
+            <Group gap={8} wrap="wrap">
+              {capacity.map((c, i) => (
+                <Badge
+                  key={i}
+                  color={c.remaining === 0 ? "red" : "blue"}
+                  variant="light"
+                  radius="sm"
+                >
+                  {c.containerSize ?? "Bulk"}: {c.remaining} of {c.cap} left
+                </Badge>
+              ))}
+            </Group>
+          </Alert>
+        )}
         <SectionCard icon={FileText} title="Schedule">
           <Grid gap="md">
             <Grid.Col span={{ base: 12, sm: 6 }}>