feat: implement SitemapController for lightweight ID retrieval for sitemap generation

Marechai.Server/Controllers/SitemapController.cs

@@ -0,0 +1,195 @@
+/******************************************************************************
+// MARECHAI: Master repository of computing history artifacts information
+// ----------------------------------------------------------------------------
+//
+// Author(s)      : Natalia Portillo <claunia@claunia.com>
+//
+// --[ License ] --------------------------------------------------------------
+//
+//     This program is free software: you can redistribute it and/or modify
+//     it under the terms of the GNU General Public License as
+//     published by the Free Software Foundation, either version 3 of the
+//     License, or (at your option) any later version.
+//
+//     This program is distributed in the hope that it will be useful,
+//     but WITHOUT ANY WARRANTY; without even the implied warranty of
+//     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+//     GNU General Public License for more details.
+//
+//     You should have received a copy of the GNU General Public License
+//     along with this program.  If not, see <http://www.gnu.org/licenses/>.
+//
+// ----------------------------------------------------------------------------
+// Copyright © 2003-2026 Natalia Portillo
+*******************************************************************************/
+
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Marechai.Database.Models;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.EntityFrameworkCore;
+
+namespace Marechai.Server.Controllers;
+
+/// <summary>
+///     Lightweight endpoint that returns only entity IDs for sitemap generation.
+///     Avoids the overhead of full DTO projections, joins, and serialization.
+/// </summary>
+[Route("/sitemap")]
+[ApiController]
+public class SitemapController(MarechaiContext context) : ControllerBase
+{
+    [HttpGet("machines/ids")]
+    [AllowAnonymous]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    public Task<List<int>> GetMachineIdsAsync([FromQuery] int? skip = null,
+                                              [FromQuery] int? take = null,
+                                              CancellationToken ct  = default)
+    {
+        IQueryable<int> query = context.Machines.AsNoTracking().Select(m => m.Id).OrderBy(id => id);
+
+        if(skip.HasValue) query = query.Skip(skip.Value);
+        if(take.HasValue) query = query.Take(take.Value);
+
+        return query.ToListAsync(ct);
+    }
+
+    [HttpGet("companies/ids")]
+    [AllowAnonymous]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    public Task<List<int>> GetCompanyIdsAsync([FromQuery] int? skip = null,
+                                              [FromQuery] int? take = null,
+                                              CancellationToken ct  = default)
+    {
+        IQueryable<int> query = context.Companies.AsNoTracking().Select(c => c.Id).OrderBy(id => id);
+
+        if(skip.HasValue) query = query.Skip(skip.Value);
+        if(take.HasValue) query = query.Take(take.Value);
+
+        return query.ToListAsync(ct);
+    }
+
+    [HttpGet("software/ids")]
+    [AllowAnonymous]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    public Task<List<ulong>> GetSoftwareIdsAsync([FromQuery] int? skip = null,
+                                                  [FromQuery] int? take = null,
+                                                  CancellationToken ct  = default)
+    {
+        IQueryable<ulong> query = context.Softwares.AsNoTracking().Select(s => s.Id).OrderBy(id => id);
+
+        if(skip.HasValue) query = query.Skip(skip.Value);
+        if(take.HasValue) query = query.Take(take.Value);
+
+        return query.ToListAsync(ct);
+    }
+
+    [HttpGet("books/ids")]
+    [AllowAnonymous]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    public Task<List<long>> GetBookIdsAsync([FromQuery] int? skip = null,
+                                            [FromQuery] int? take = null,
+                                            CancellationToken ct  = default)
+    {
+        IQueryable<long> query = context.Books.AsNoTracking().Select(b => b.Id).OrderBy(id => id);
+
+        if(skip.HasValue) query = query.Skip(skip.Value);
+        if(take.HasValue) query = query.Take(take.Value);
+
+        return query.ToListAsync(ct);
+    }
+
+    [HttpGet("documents/ids")]
+    [AllowAnonymous]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    public Task<List<long>> GetDocumentIdsAsync([FromQuery] int? skip = null,
+                                                [FromQuery] int? take = null,
+                                                CancellationToken ct  = default)
+    {
+        IQueryable<long> query = context.Documents.AsNoTracking().Select(d => d.Id).OrderBy(id => id);
+
+        if(skip.HasValue) query = query.Skip(skip.Value);
+        if(take.HasValue) query = query.Take(take.Value);
+
+        return query.ToListAsync(ct);
+    }
+
+    [HttpGet("magazines/ids")]
+    [AllowAnonymous]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    public Task<List<long>> GetMagazineIdsAsync([FromQuery] int? skip = null,
+                                                [FromQuery] int? take = null,
+                                                CancellationToken ct  = default)
+    {
+        IQueryable<long> query = context.Magazines.AsNoTracking().Select(m => m.Id).OrderBy(id => id);
+
+        if(skip.HasValue) query = query.Skip(skip.Value);
+        if(take.HasValue) query = query.Take(take.Value);
+
+        return query.ToListAsync(ct);
+    }
+
+    [HttpGet("gpus/ids")]
+    [AllowAnonymous]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    public Task<List<int>> GetGpuIdsAsync([FromQuery] int? skip = null,
+                                           [FromQuery] int? take = null,
+                                           CancellationToken ct  = default)
+    {
+        IQueryable<int> query = context.Gpus.AsNoTracking().Select(g => g.Id).OrderBy(id => id);
+
+        if(skip.HasValue) query = query.Skip(skip.Value);
+        if(take.HasValue) query = query.Take(take.Value);
+
+        return query.ToListAsync(ct);
+    }
+
+    [HttpGet("sound-synths/ids")]
+    [AllowAnonymous]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    public Task<List<int>> GetSoundSynthIdsAsync([FromQuery] int? skip = null,
+                                                  [FromQuery] int? take = null,
+                                                  CancellationToken ct  = default)
+    {
+        IQueryable<int> query = context.SoundSynths.AsNoTracking().Select(s => s.Id).OrderBy(id => id);
+
+        if(skip.HasValue) query = query.Skip(skip.Value);
+        if(take.HasValue) query = query.Take(take.Value);
+
+        return query.ToListAsync(ct);
+    }
+
+    [HttpGet("processors/ids")]
+    [AllowAnonymous]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    public Task<List<int>> GetProcessorIdsAsync([FromQuery] int? skip = null,
+                                                [FromQuery] int? take = null,
+                                                CancellationToken ct  = default)
+    {
+        IQueryable<int> query = context.Processors.AsNoTracking().Select(p => p.Id).OrderBy(id => id);
+
+        if(skip.HasValue) query = query.Skip(skip.Value);
+        if(take.HasValue) query = query.Take(take.Value);
+
+        return query.ToListAsync(ct);
+    }
+
+    [HttpGet("people/ids")]
+    [AllowAnonymous]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    public Task<List<int>> GetPersonIdsAsync([FromQuery] int? skip = null,
+                                              [FromQuery] int? take = null,
+                                              CancellationToken ct  = default)
+    {
+        IQueryable<int> query = context.People.AsNoTracking().Select(p => p.Id).OrderBy(id => id);
+
+        if(skip.HasValue) query = query.Skip(skip.Value);
+        if(take.HasValue) query = query.Take(take.Value);
+
+        return query.ToListAsync(ct);
+    }
+}

Marechai/Services/SitemapService.cs

@@ -250,18 +250,18 @@ public sealed class SitemapService(IHttpClientFactory httpClientFactory, IMemory
 
             int skip = (page - 1) * UrlsPerSitemap;
 
-            var entities = await client.GetFromJsonAsync<List<SitemapEntity>>(
+            var ids = await client.GetFromJsonAsync<List<long>>(
-                $"/{apiEndpoint}?skip={skip}&take={UrlsPerSitemap}");
+                $"/sitemap/{apiEndpoint}/ids?skip={skip}&take={UrlsPerSitemap}");
 
-            if(entities is not null)
+            if(ids is not null)
             {
-                foreach(SitemapEntity entity in entities)
+                foreach(long id in ids)
-                    urls.Add($"{urlPrefix}{entity.Id}");
+                    urls.Add($"{urlPrefix}{id}");
             }
         }
         catch(Exception ex)
         {
-            logger.LogWarning(ex, "Failed to fetch entities from /{Endpoint} page {Page} for sitemap",
+            logger.LogWarning(ex, "Failed to fetch IDs from /sitemap/{Endpoint}/ids page {Page} for sitemap",
                               apiEndpoint, page);
         }
 
@@ -332,7 +332,4 @@ public sealed class SitemapService(IHttpClientFactory httpClientFactory, IMemory
         Indent      = true,
         OmitXmlDeclaration = false
     };
-
-    /// <summary>Minimal DTO for deserializing only the <c>id</c> field from the API response.</summary>
-    sealed record SitemapEntity(long Id);
 }