using Asp.Versioning; using NTP.Api.Authorization; using NTP.Application.Access; using Microsoft.AspNetCore.Authorization; using Microsoft.AspNetCore.Mvc; using NTP.Application.Common; using NTP.Application.Grains.Registry; namespace NTP.Api.Controllers.V1.Grains; /// /// Grains registry slice: trucks, trailers, drivers, blacklist (+ weighbridge exceptions, location counts, permit-screen lookups). /// Port of services\Grains\cfc\register.cfc and the registry parts of grains.cfc. Thin controller: authorization of the individual actions /// (legacy isActAuthorized ids, company scoping) is done in the services. /// [ApiController] [ApiVersion(1.0)] [Route("api/v{version:apiVersion}/grains/registry")] [Produces("application/json")] public sealed class RegistryController( ITruckRegistryService trucks, ITrailerRegistryService trailers, IDriverRegistryService drivers, IBlacklistService blacklist, IRegistryOpsService ops, IRegistryLookupService lookups, IRegistryAttachmentService attachments, IRegistryQueuePermitService queuePermits) : ControllerBase { // ------------------------------------------------------------------------------------------ permissions + lookups /// What the caller may do on the registry screens (legacy isActAuthorized buttons). [HttpGet("permissions")] public Task Permissions(CancellationToken ct) => lookups.PermissionsAsync(ct); /// NTP_TENDERS_COMPANIES (ACTIVE): the company select of the truck/trailer forms and filters. [HttpGet("lookups/companies")] [RequirePermission(PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers, PermissionKeys.RegistryBlacklist)] public Task> Companies(CancellationToken ct) => lookups.CompaniesAsync(ct); /// TRUCKKINDS by code (S, T for trucks; HTR, TR for trailers): the axial loads select. [HttpGet("lookups/truck-kinds")] [RequirePermission(PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers)] public Task> TruckKinds([FromQuery] string kinds, CancellationToken ct) => lookups.TruckKindsAsync((kinds ?? string.Empty).Split(',', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries), ct); /// Destination locations grouped as on the truck form (packed / bulk / bulk-gallab). [HttpGet("lookups/destinations")] [RequirePermission(PermissionKeys.RegistryTrucks)] public Task Destinations(CancellationToken ct) => lookups.DestinationsAsync(ct); [HttpGet("lookups/driver-nationalities")] [RequirePermission(PermissionKeys.RegistryDrivers)] public Task> DriverNationalities(CancellationToken ct) => lookups.DriverNationalitiesAsync(ct); [HttpGet("lookups/weighbridge-locations")] [RequirePermission(PermissionKeys.RegistryWeighbridge)] public Task> WeighbridgeLocations(CancellationToken ct) => lookups.WeighbridgeLocationsAsync(ct); // ------------------------------------------------------------------------------------------ trucks (truckGrid.cfm, registerGrainsTruck.cfm) /// getTruckGrid. searchType TN (trucks, default) or TRN (searches the trailers table, rows carry tnId). [HttpGet("trucks")] [RequirePermission(PermissionKeys.RegistryTrucks)] public Task> SearchTrucks( [FromQuery] string? searchType, [FromQuery] string? tn, [FromQuery] string? chasesNumber, [FromQuery] string? statusCode, [FromQuery] string? headType, [FromQuery] long? tcscac, [FromQuery] int page = 1, [FromQuery] int pageSize = 15, CancellationToken ct = default) => trucks.SearchAsync(new TruckListQuery(searchType, tn, chasesNumber, statusCode, headType, tcscac), new PageRequest(page, pageSize), ct); /// getTruckInfo (+ connected trailer, destinations, attachments). [HttpGet("trucks/{id:long}")] [RequirePermission(PermissionKeys.RegistryTrucks)] public Task GetTruck(long id, CancellationToken ct) => trucks.GetAsync(id, ct); /// getAllTrnOnthisTn: trailers connected to the truck. [HttpGet("trucks/{id:long}/trailers")] [RequirePermission(PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers)] public Task> TrailersOfTruck(long id, CancellationToken ct) => trucks.TrailersAsync(id, null, ct); /// saveTrucksDetails. [HttpPost("trucks")] [RequirePermission(PermissionKeys.RegistryTrucksCreate)] public Task CreateTruck(SaveTruckRequest request, CancellationToken ct) => trucks.CreateAsync(request, ct); /// editTrucksDetails. [HttpPut("trucks/{id:long}")] [RequirePermission(PermissionKeys.RegistryTrucksEdit)] public Task UpdateTruck(long id, SaveTruckRequest request, CancellationToken ct) => trucks.UpdateAsync(id, request, ct); /// acceptTruck (-> ACCPT). [HttpPost("trucks/{id:long}/accept")] [RequirePermission(PermissionKeys.RegistryTrucks)] public Task AcceptTruck(long id, CancellationToken ct) => trucks.AcceptAsync(id, ct); /// revokeTruck (-> RVKD, cascades to trailers, destinations and open permits). [HttpPost("trucks/{id:long}/revoke")] [RequirePermission(PermissionKeys.RegistryTrucks)] public Task RevokeTruck(long id, CancellationToken ct) => trucks.RevokeAsync(id, ct); // ------------------------------------------------------------------------------------------ trailers (trailerGrid.cfm, registerGrainsTrailer.cfm) [HttpGet("trailers")] [RequirePermission(PermissionKeys.RegistryTrailers)] public Task> SearchTrailers( [FromQuery] string? tn, [FromQuery] string? chasesNumber, [FromQuery] string? statusCode, [FromQuery] long? tcscac, [FromQuery] int page = 1, [FromQuery] int pageSize = 15, CancellationToken ct = default) => trailers.SearchAsync(new TrailerListQuery(tn, chasesNumber, statusCode, tcscac), new PageRequest(page, pageSize), ct); [HttpGet("trailers/{id:long}")] [RequirePermission(PermissionKeys.RegistryTrailers)] public Task GetTrailer(long id, CancellationToken ct) => trailers.GetAsync(id, ct); /// saveTrailerDetails. [HttpPost("trailers")] [RequirePermission(PermissionKeys.RegistryTrailersCreate)] public Task CreateTrailer(SaveTrailerRequest request, CancellationToken ct) => trailers.CreateAsync(request, ct); /// editTrailerDetails. [HttpPut("trailers/{id:long}")] [RequirePermission(PermissionKeys.RegistryTrailersEdit)] public Task UpdateTrailer(long id, SaveTrailerRequest request, CancellationToken ct) => trailers.UpdateAsync(id, request, ct); [HttpPost("trailers/{id:long}/accept")] [RequirePermission(PermissionKeys.RegistryTrailers)] public Task AcceptTrailer(long id, CancellationToken ct) => trailers.AcceptAsync(id, ct); [HttpPost("trailers/{id:long}/revoke")] [RequirePermission(PermissionKeys.RegistryTrailers)] public Task RevokeTrailer(long id, [FromQuery] long? truckId, CancellationToken ct) => trailers.RevokeAsync(id, truckId, ct); // ------------------------------------------------------------------------------------------ drivers (driverGrid.cfm, regesterDriver.cfm) [HttpGet("drivers")] [RequirePermission(PermissionKeys.RegistryDrivers)] public Task> SearchDrivers( [FromQuery] string? nnpn, [FromQuery] string? name, [FromQuery] string? statusCode, [FromQuery] int page = 1, [FromQuery] int pageSize = 15, CancellationToken ct = default) => drivers.SearchAsync(new DriverListQuery(nnpn, name, statusCode), new PageRequest(page, pageSize), ct); [HttpGet("drivers/{id:long}")] [RequirePermission(PermissionKeys.RegistryDrivers)] public Task GetDriver(long id, CancellationToken ct) => drivers.GetAsync(id, ct); /// saveDriverDetails. [HttpPost("drivers")] [RequirePermission(PermissionKeys.RegistryDriversCreate)] public Task CreateDriver(SaveDriverRequest request, CancellationToken ct) => drivers.CreateAsync(request, ct); [HttpPost("drivers/{id:long}/accept")] [RequirePermission(PermissionKeys.RegistryDrivers)] public Task AcceptDriver(long id, CancellationToken ct) => drivers.AcceptAsync(id, ct); [HttpPost("drivers/{id:long}/revoke")] [RequirePermission(PermissionKeys.RegistryDrivers)] public Task RevokeDriver(long id, CancellationToken ct) => drivers.RevokeAsync(id, ct); // ------------------------------------------------------------------------------------------ blacklist (blackListGrid.cfm, createBlacklist.cfm, confirmDeleteBL.cfm) /// getBlackListGrid. entityId = permit number. [HttpGet("blacklist")] [RequirePermission(PermissionKeys.RegistryBlacklist)] public Task> SearchBlacklist( [FromQuery] string? entityId, [FromQuery] string? category, [FromQuery] string? statusCode, [FromQuery] int page = 1, [FromQuery] int pageSize = 15, CancellationToken ct = default) => blacklist.SearchAsync(new BlacklistQuery(entityId, category, statusCode), new PageRequest(page, pageSize), ct); /// BL_addToBlacklist. [HttpPost("blacklist")] [RequirePermission(PermissionKeys.RegistryBlacklist)] public Task AddToBlacklist(AddBlacklistRequest request, CancellationToken ct) => blacklist.AddAsync(request, ct); /// deleteFromBlackList (roles GNSU, GNCO, GTO). [HttpPost("blacklist/{id:long}/cancel")] [RequirePermission(PermissionKeys.RegistryBlacklist)] public Task CancelBlacklist(long id, CancelBlacklistRequest request, CancellationToken ct) => blacklist.CancelAsync(id, request, ct); // ------------------------------------------------------------------------------------------ weighbridge exceptions, weights, counts, fleet /// saveWeighbridgesControlInfo (WeighbridgesControl.cfm). [HttpPost("weighbridge-control")] [RequirePermission(PermissionKeys.RegistryWeighbridge)] public Task SaveWeighbridgeControl(SaveWeighbridgeControlRequest request, CancellationToken ct) => ops.SaveWeighbridgeControlAsync(request, ct); /// saveGrainsWeights. [HttpPost("permit-weights")] [RequirePermission(PermissionKeys.OrdersWeights)] public Task SaveGrainsWeights(SaveGrainsWeightsRequest request, CancellationToken ct) => ops.SaveGrainsWeightsAsync(request, ct); /// getlocTruckNum (locTruckNumGrid.cfm, refreshed every 5 minutes by the screen). [HttpGet("location-truck-counts")] [RequirePermission(PermissionKeys.RegistryLocationCounts)] public Task> LocationTruckCounts(CancellationToken ct) => ops.LocationTruckCountsAsync(ct); /// checkTrucks: every company must use its whole fleet before reusing a truck. [HttpPost("fleet-check")] [RequirePermission(PermissionKeys.RegistryTrucks, PermissionKeys.PermitsCreate)] public Task FleetCheck(FleetCheckRequest request, CancellationToken ct) => ops.CheckTrucksAsync(request, ct); /// validateNtpTrucks. [HttpGet("validate-truck")] [RequirePermission(PermissionKeys.PermitsList, PermissionKeys.PermitsCreate, PermissionKeys.PermitsTruckOrder, PermissionKeys.PermitsClose, PermissionKeys.PermitsManualEntry, PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers)] public async Task ValidateTruck([FromQuery] string tn, CancellationToken ct) => new { validTn = await ops.ValidateNtpTruckAsync(tn ?? string.Empty, ct) }; // ------------------------------------------------------------------------------------------ permit-screen lookups (grains.cfc) /// grains.cfc getDriverInfo: latest permit of the driver (active status). [HttpGet("permit-lookups/driver")] [RequirePermission(PermissionKeys.PermitsList, PermissionKeys.PermitsCreate, PermissionKeys.PermitsTruckOrder, PermissionKeys.PermitsClose, PermissionKeys.PermitsManualEntry, PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers)] public Task DriverFromPermits([FromQuery] string nnpn, CancellationToken ct) => lookups.DriverFromPermitsAsync(nnpn ?? string.Empty, ct); /// grains.cfc getTruckInfo: latest finished permit of the truck. [HttpGet("permit-lookups/truck")] [RequirePermission(PermissionKeys.PermitsList, PermissionKeys.PermitsCreate, PermissionKeys.PermitsTruckOrder, PermissionKeys.PermitsClose, PermissionKeys.PermitsManualEntry, PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers)] public Task TruckFromPermits([FromQuery] string tn, CancellationToken ct) => lookups.TruckFromPermitsAsync(tn ?? string.Empty, ct); /// grains.cfc isTrailerInUse. [HttpGet("permit-lookups/trailer-in-use")] [RequirePermission(PermissionKeys.PermitsList, PermissionKeys.PermitsCreate, PermissionKeys.PermitsTruckOrder, PermissionKeys.PermitsClose, PermissionKeys.PermitsManualEntry, PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers)] public Task> TrailerInUse([FromQuery] string trn, [FromQuery] long? permitId, CancellationToken ct) => lookups.TrailerInUseAsync(trn ?? string.Empty, permitId, ct); /// grains.cfc getTruckInfoFromTN. [HttpGet("permit-lookups/permit-by-truck")] [RequirePermission(PermissionKeys.PermitsList, PermissionKeys.PermitsCreate, PermissionKeys.PermitsTruckOrder, PermissionKeys.PermitsClose, PermissionKeys.PermitsManualEntry, PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers)] public Task PermitByTruck([FromQuery] string tn, [FromQuery] string status, CancellationToken ct) => lookups.PermitByTruckAsync(tn ?? string.Empty, status ?? string.Empty, ct); /// grains.cfc getTrailerNumber: the trailer of a truck. [HttpGet("permit-lookups/truck-trailer")] [RequirePermission(PermissionKeys.PermitsList, PermissionKeys.PermitsCreate, PermissionKeys.PermitsTruckOrder, PermissionKeys.PermitsClose, PermissionKeys.PermitsManualEntry, PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers)] public Task TruckTrailer([FromQuery] string tn, CancellationToken ct) => lookups.TrailerNumberOfTruckAsync(tn ?? string.Empty, ct); /// grains.cfc getTNinfo (validate = ownership + MOT checks). [HttpGet("permit-lookups/truck-info")] [RequirePermission(PermissionKeys.PermitsList, PermissionKeys.PermitsCreate, PermissionKeys.PermitsTruckOrder, PermissionKeys.PermitsClose, PermissionKeys.PermitsManualEntry, PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers)] public Task TruckInfo([FromQuery] string tn, [FromQuery] bool validate = true, CancellationToken ct = default) => lookups.TruckInfoAsync(tn ?? string.Empty, validate, ct); /// grains.cfc getTRNinfo. [HttpGet("permit-lookups/trailer-info")] [RequirePermission(PermissionKeys.PermitsList, PermissionKeys.PermitsCreate, PermissionKeys.PermitsTruckOrder, PermissionKeys.PermitsClose, PermissionKeys.PermitsManualEntry, PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers)] public Task TrailerInfo([FromQuery] string trn, CancellationToken ct) => lookups.TrailerInfoAsync(trn ?? string.Empty, ct); /// grains.cfc getDRVRinfo. [HttpGet("permit-lookups/driver-info")] [RequirePermission(PermissionKeys.PermitsList, PermissionKeys.PermitsCreate, PermissionKeys.PermitsTruckOrder, PermissionKeys.PermitsClose, PermissionKeys.PermitsManualEntry, PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers)] public Task DriverInfo([FromQuery] string nnpn, CancellationToken ct) => lookups.DriverInfoAsync(nnpn ?? string.Empty, ct); // ------------------------------------------------------------------------------------------ MOT (register.cfc validate*) /// validateTNMOT: result '' (ok), 'not_registered' or 'wrongCT'. [HttpGet("mot/truck")] [RequirePermission(PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers)] public async Task MotTruck([FromQuery] string tn, [FromQuery] long scac, [FromQuery] string? truckType, CancellationToken ct) => new { result = await lookups.ValidateTruckMotAsync(tn ?? string.Empty, scac, truckType, ct) }; /// validateTRNMOT: result '' (ok) or 'not_registered'. [HttpGet("mot/trailer")] [RequirePermission(PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers)] public async Task MotTrailer([FromQuery] string trn, [FromQuery] long scac, CancellationToken ct) => new { result = await lookups.ValidateTrailerMotAsync(trn ?? string.Empty, scac, ct) }; /// validateOwnerTN: message '' (ok) or the legacy Arabic error. [HttpGet("mot/owner")] [RequirePermission(PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers)] public async Task MotOwner([FromQuery] string tn, [FromQuery] long scac, CancellationToken ct) => new { message = await lookups.ValidateOwnerAsync(scac, tn ?? string.Empty, ct) }; // ------------------------------------------------------------------------------------------ attachments /// Temp upload: returns { id, name, size }; the id goes into attachmentIds of a save request. [HttpPost("files/temp")] [RequestSizeLimit(20_000_000)] [RequirePermission(PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers)] public async Task UploadTemp(IFormFile file, CancellationToken ct) { await using var stream = file.OpenReadStream(); return await attachments.UploadTempAsync(stream, file.FileName, file.Length, ct); } /// Downloads a stored attachment (kind: truck | trailer | driver). [HttpGet("files/{kind}/{fileName}")] [RequirePermission(PermissionKeys.RegistryTrucks, PermissionKeys.RegistryTrailers, PermissionKeys.RegistryDrivers)] public async Task Download(string kind, string fileName, CancellationToken ct) { var download = await attachments.OpenAsync(kind, fileName, ct); Response.Headers.ContentDisposition = $"inline; filename*=UTF-8''{Uri.EscapeDataString(download.FileName)}"; return File(download.Content, download.ContentType); } // ------------------------------------------------------------------------------------------ scheduled jobs (call from the scheduler with a token) /// jobs\changeBlacklistStatus.cfm: OPEN entries past their expiry date become EXPIRED. [HttpPost("jobs/expire-blacklist")] [Authorize(Roles = "SU")] public async Task ExpireBlacklist(CancellationToken ct) => new { expired = await blacklist.ExpireDueAsync(ct) }; /// jobs\RegisterGrainsQueueForNewTrucks.cfm: PCKD + BULK queue permits for 327 trucks that have none. [HttpPost("jobs/register-queue-new-trucks")] [Authorize(Roles = "SU")] public async Task RegisterQueueForNewTrucks(CancellationToken ct) => new { trucks = await queuePermits.RegisterQueueForNewTrucksAsync(ct) }; }