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-api/src/modules/contracts/contracts.controller.ts

@@ -166,11 +166,8 @@ export class ContractsController {
   @Get('clearance/queue')
   @BookingStaff(FREIGHT_PERMS.contracts.clearanceReview)
   @ApiOperation({ summary: 'GL ET queue: contracts awaiting pre-booking document review' })
-  clearanceQueue(
-    @Query() filter: FilterContractDto,
-    @Query('region') region?: string,
-  ) {
-    return this.clearanceService.queue(filter, region);
+  clearanceQueue(@Query() filter: FilterContractDto) {
+    return this.clearanceService.queue(filter);
   }
 
   @Get(':id')
@@ -485,6 +482,15 @@ export class ContractsController {
     );
   }
 
+  @Get(':id/capacity')
+  @ApiOperation({
+    summary: 'Remaining bookable quantity per cargo line (GENERAL draw-down cap)',
+  })
+  async capacity(@Param('id', ParseUUIDPipe) id: string) {
+    const contract = await this.contractsService.findById(id);
+    return this.contractBookingService.computeCapacity(contract);
+  }
+
   // ── Clearance milestones (doc §11.3, §12.2) ────────────────────────────────
 
   @Get(':id/milestones')