chore(release): 1.0.0 [skip ci]

# 1.0.0 (2026-03-16)

### Bug Fixes

* configurar repositoryUrl para git push en semantic-release ([d7d7b4b](d7d7b4b5cd))

### Features

* agregar clima extremo SuperScorching ([7d56333](7d563331e3))
* agregar docker-compose.yml apuntado a Gitea ([6cfeeb7](6cfeeb7142))
* agregar endpoint v2 con ciudad. Closes [#7](#7) ([5284d27](5284d27ae2))
* agregar soporte docker y publicar en gitea packages. Closes [#11](#11) ([3b6f717](3b6f7175f8))
* configurar sistema de lanzamientos automáticos con IA local ([73bb85f](73bb85f71c))
* configurar swagger con soporte para multiples versiones v1 y v2 ([62a10af](62a10af833))
* correccion de red y configuracion de lanzamientos ([78eced7](78eced728b))
* forzar indexacion de commits de gitea ([489b86f](489b86f821))
* implementar script de rescate para pull requests y corregir entorno ([3c7251f](3c7251f49f))
* implementar versionado de API por URL v1. Closes [#3](#3) ([6ff01a8](6ff01a803c))
* inicializar proyecto base web api. Cierra [#1](#1) ([0643210](06432100b2))
* migrar pipeline a semantic release con IA ([fb0082a](fb0082a45b))
* traducir climas al español ([27c5af2](27c5af2f27))
* usar token personal para evitar error 500 en gitea api ([fc1c381](fc1c381284))

.dockerignore

@@ -0,0 +1,10 @@
+**/.dockerignore
+**/.env
+**/bin
+**/obj
+**/.vs
+**/.vscode
+**/ignore
+.git
+.gitignore
+Dockerfile

.gitea/workflows/semantic-release.yaml

@@ -0,0 +1,129 @@
+name: CI/CD Semantic Release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout del código
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Preparar entorno Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Instalar Semantic Release y Plugins
+        run: npm install -D semantic-release @saithodev/semantic-release-gitea @semantic-release/changelog @semantic-release/git @semantic-release/exec
+
+      - name: Generar configuración de Release
+        env:
+          # Inyectamos el token aquí para poder construir la URL de Git
+          GITEA_TOKEN: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+        run: |
+          # Construimos la URL de Git con el token incrustado
+          REPO_URL_WITH_TOKEN="https://gitea_actions:${GITEA_TOKEN}@repo.eldiaservicios.com/${{ github.repository }}.git"
+
+          cat << EOF > .releaserc.json
+          {
+            "branches": ["main"],
+            "repositoryUrl": "${REPO_URL_WITH_TOKEN}",
+            "plugins":[
+              "@semantic-release/commit-analyzer",
+              "@semantic-release/release-notes-generator",
+              "@semantic-release/changelog",
+              [
+                "@semantic-release/git",
+                {
+                  "assets": ["CHANGELOG.md"],
+                  "message": "chore(release): \${nextRelease.version} [skip ci]\n\n\${nextRelease.notes}"
+                }
+              ],
+              [
+                "@saithodev/semantic-release-gitea",
+                {
+                  "giteaUrl": "https://repo.eldiaservicios.com"
+                }
+              ],
+              [
+                "@semantic-release/exec",
+                {
+                  "successCmd": "echo 'RELEASE_CREATED=true' >> \$GITHUB_ENV && echo 'TAG_NAME=\${nextRelease.gitTag}' >> \$GITHUB_ENV"
+                }
+              ]
+            ]
+          }
+          EOF
+
+      - name: Ejecutar Semantic Release
+        env:
+          # Este GITEA_TOKEN es para el plugin de Gitea (crear el release)
+          GITEA_TOKEN: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+        run: npx semantic-release
+
+      - name: 🤖 Generar notas con IA Local (Ollama)
+        if: env.RELEASE_CREATED == 'true'
+        env:
+          GITEA_TOKEN: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+          REPO: ${{ github.repository }}
+          TAG_NAME: ${{ env.TAG_NAME }}
+        run: |
+          node -e '
+            async function run() {
+              const giteaUrl = "https://repo.eldiaservicios.com/api/v1";
+              const ollamaUrl = "http://192.168.10.78:11434/api/generate";
+              
+              console.log(`Obteniendo la release ${process.env.TAG_NAME} de Gitea...`);
+              const relRes = await fetch(`${giteaUrl}/repos/${process.env.REPO}/releases/tags/${process.env.TAG_NAME}`, {
+                headers: { "Authorization": `token ${process.env.GITEA_TOKEN}` }
+              });
+              const relData = await relRes.json();
+              const rawNotes = relData.body;
+
+              const prompt = `Eres un redactor experto de notas de lanzamiento (release notes). 
+              Tu misión es transformar una lista técnica de commits en un anuncio acotado, profesional y descriptivo.
+              
+              Instrucciones:
+              - Usa Markdown elegante.
+              - Usa emojis que tengan sentido.
+              - Agrupa por secciones (Ej: 🚀 Novedades, 🛠️ Mejoras Técnicas).
+              - El tono debe ser entusiasta pero profesional.
+              - Escribe exclusivamente en español.
+
+              Lista de cambios original:
+              ${rawNotes}`;
+
+              console.log("Conectando con Ollama en tu PC para generar notas...");
+              const aiRes = await fetch(ollamaUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                  model: "llama3.1",
+                  prompt: prompt,
+                  stream: false
+                })
+              });
+              const aiData = await aiRes.json();
+              const aiNotes = aiData.response;
+
+              console.log("Actualizando la Release en Gitea...");
+              await fetch(`${giteaUrl}/repos/${process.env.REPO}/releases/${relData.id}`, {
+                method: "PATCH",
+                headers: { 
+                  "Authorization": `token ${process.env.GITEA_TOKEN}`,
+                  "Content-Type": "application/json"
+                },
+                body: JSON.stringify({ body: aiNotes })
+              });
+              
+              console.log("¡Release Notes actualizadas por la IA!");
+            }
+            run().catch(err => { console.error(err); process.exit(1); });
+          '

ApiVersioningDemo.Api/ApiVersioningDemo.Api.csproj

@@ -7,7 +7,10 @@
   </PropertyGroup>
 
   <ItemGroup>
+    <PackageReference Include="Asp.Versioning.Http" Version="8.1.1" />
+    <PackageReference Include="Asp.Versioning.Mvc.ApiExplorer" Version="8.1.1" />
     <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="10.0.3" />
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="10.1.4" />
   </ItemGroup>
 
 </Project>

ApiVersioningDemo.Api/ConfigureSwaggerOptions.cs

@@ -0,0 +1,42 @@
+using Asp.Versioning.ApiExplorer;
+using Microsoft.Extensions.Options;
+using Microsoft.OpenApi;
+using Swashbuckle.AspNetCore.SwaggerGen;
+
+namespace ApiVersioningDemo.Api;
+
+public class ConfigureSwaggerOptions : IConfigureOptions<SwaggerGenOptions>
+{
+    private readonly IApiVersionDescriptionProvider _provider;
+
+    public ConfigureSwaggerOptions(IApiVersionDescriptionProvider provider)
+    {
+        _provider = provider;
+    }
+
+    public void Configure(SwaggerGenOptions options)
+    {
+        // Por cada versión de API detectada, crea un documento Swagger
+        foreach (var description in _provider.ApiVersionDescriptions)
+        {
+            options.SwaggerDoc(description.GroupName, CreateInfoForApiVersion(description));
+        }
+    }
+
+    private static OpenApiInfo CreateInfoForApiVersion(ApiVersionDescription description)
+    {
+        var info = new OpenApiInfo()
+        {
+            Title = "Mi API Versionada",
+            Version = description.ApiVersion.ToString(),
+            Description = "Ejemplo de API REST con versionado en .NET"
+        };
+
+        if (description.IsDeprecated)
+        {
+            info.Description += " (Esta versión está obsoleta)";
+        }
+
+        return info;
+    }
+}

ApiVersioningDemo.Api/Controllers/WeatherForecastController.cs

@@ -1,14 +1,16 @@
+// ApiVersioningDemo.Api/Controllers/WeatherForecastController.cs
+using Asp.Versioning;
 using Microsoft.AspNetCore.Mvc;
 
 namespace ApiVersioningDemo.Api.Controllers;
 
 [ApiController]
-[Route("[controller]")]
+[ApiVersion("1.0")] // 1. Le decimos explícitamente que este es el controlador de la v1
+[Route("api/v{version:apiVersion}/[controller]")] // 2. Modificamos la ruta para obligar a usar "api/v1/..."
 public class WeatherForecastController : ControllerBase
 {
-    private static readonly string[] Summaries =
+    private static readonly string[] Summaries = [
-    [
+        "Helado", "Frío", "Fresco", "Templado", "Cálido", "Caluroso", "Sofocante", "SuperScorching"
-        "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
     ];
 
     [HttpGet(Name = "GetWeatherForecast")]

ApiVersioningDemo.Api/Controllers/WeatherForecastV2Controller.cs

@@ -0,0 +1,35 @@
+// ApiVersioningDemo.Api/Controllers/WeatherForecastV2Controller.cs
+using Asp.Versioning;
+using Microsoft.AspNetCore.Mvc;
+
+namespace ApiVersioningDemo.Api.Controllers;
+
+[ApiController]
+[ApiVersion("2.0")] // 1. ¡Esta es la clave! Le decimos que es la versión 2.
+[Route("api/v{version:apiVersion}/WeatherForecast")] // 2. Forzamos la ruta para que responda a la v2
+public class WeatherForecastV2Controller : ControllerBase
+{
+  private static readonly string[] Summaries = [
+       "Helado", "Frío", "Fresco", "Templado", "Cálido", "Caluroso", "Sofocante", "SuperScorching"
+   ];
+
+  [HttpGet(Name = "GetWeatherForecastV2")]
+  // CAMBIO 1: Cambiamos IActionResult por ActionResult<TipoConcreto>
+  public ActionResult<WeatherForecastResponseV2> Get()
+  {
+    var forecast = Enumerable.Range(1, 5).Select(index => new WeatherForecast
+    {
+      Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
+      TemperatureC = Random.Shared.Next(-20, 55),
+      Summary = Summaries[Random.Shared.Next(Summaries.Length)]
+    }).ToArray();
+
+    // CAMBIO 2: Devolvemos el record tipado en lugar del anónimo
+    var response = new WeatherForecastResponseV2("Buenos Aires", forecast);
+
+    return Ok(response);
+  }
+}
+
+// Definición fuerte de la respuesta para que Swagger la entienda
+public record WeatherForecastResponseV2(string Ciudad, IEnumerable<WeatherForecast> Pronosticos);

ApiVersioningDemo.Api/Program.cs

@@ -1,23 +1,52 @@
+using ApiVersioningDemo.Api;
+using Asp.Versioning;
+
 var builder = WebApplication.CreateBuilder(args);
 
-// Add services to the container.
+// 1. Configuración de Versionado (YA LO TENÍAS)
+builder.Services.AddApiVersioning(options =>
+{
+    options.DefaultApiVersion = new ApiVersion(1, 0);
+    options.AssumeDefaultVersionWhenUnspecified = true;
+    options.ReportApiVersions = true;
+})
+.AddMvc()
+.AddApiExplorer(options =>
+{
+    // IMPORTANTE: El formato "'v'VVV" hace que la versión se llame "v1", "v2", etc.
+    options.GroupNameFormat = "'v'VVV"; 
+    options.SubstituteApiVersionInUrl = true;
+});
+
+// 2. Configuración de Swagger
+builder.Services.AddEndpointsApiExplorer();
+builder.Services.AddSwaggerGen();
+
+// Esta lógica crea un documento Swagger por cada versión descubierta automáticamente
+builder.Services.ConfigureOptions<ConfigureSwaggerOptions>(); 
 
 builder.Services.AddControllers();
-// Learn more about configuring OpenAPI at https://aka.ms/aspnet/openapi
-builder.Services.AddOpenApi();
 
 var app = builder.Build();
 
-// Configure the HTTP request pipeline.
+// 3. Activar la Interfaz Gráfica
 if (app.Environment.IsDevelopment())
 {
-    app.MapOpenApi();
+    app.UseSwagger();
+    app.UseSwaggerUI(options =>
+    {
+        // Genera un endpoint JSON por cada versión que exista en la API
+        var descriptions = app.DescribeApiVersions();
+        foreach (var description in descriptions)
+        {
+            var url = $"/swagger/{description.GroupName}/swagger.json";
+            var name = description.GroupName.ToUpperInvariant();
+            options.SwaggerEndpoint(url, name);
+        }
+    });
 }
 
 app.UseHttpsRedirection();
-
 app.UseAuthorization();
-
 app.MapControllers();
-
+app.Run();
-app.Run();

CHANGELOG.md

@@ -0,0 +1,24 @@
+# 1.0.0 (2026-03-16)
+
+
+### Bug Fixes
+
+* configurar repositoryUrl para git push en semantic-release ([d7d7b4b](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/d7d7b4b5cd2717c788bb81d77d2c4852774c2db9))
+
+
+### Features
+
+* agregar clima extremo SuperScorching ([7d56333](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/7d563331e3c8e8ed986aa742b09ba9c3f89cfbbd))
+* agregar docker-compose.yml apuntado a Gitea ([6cfeeb7](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/6cfeeb714271a03c652e59291d2122bb151ca2f7))
+* agregar endpoint v2 con ciudad. Closes [#7](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/issues/7) ([5284d27](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/5284d27ae291776442667bec594f20b64d9269ef))
+* agregar soporte docker y publicar en gitea packages. Closes [#11](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/issues/11) ([3b6f717](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/3b6f7175f8793378c3d19039abe987045e7fc9a7))
+* configurar sistema de lanzamientos automáticos con IA local ([73bb85f](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/73bb85f71cabdacaf5cd1fd25f1549bd60df9c2c))
+* configurar swagger con soporte para multiples versiones v1 y v2 ([62a10af](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/62a10af8330cf59c8d33fac094ccc3d0735aa7e3))
+* correccion de red y configuracion de lanzamientos ([78eced7](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/78eced728b038fa1f4f5578f60f9a1edee62fda1))
+* forzar indexacion de commits de gitea ([489b86f](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/489b86f8218ff8cd3d5ef857ffd4673a5ed8c733))
+* implementar script de rescate para pull requests y corregir entorno ([3c7251f](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/3c7251f49f79a1fc2d74144a1873ad8429991b20))
+* implementar versionado de API por URL v1. Closes [#3](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/issues/3) ([6ff01a8](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/6ff01a803c26e1dd3d47eb718ed22dd6538deb89))
+* inicializar proyecto base web api. Cierra [#1](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/issues/1) ([0643210](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/06432100b2b36477375d98044c47fb8bda99115c))
+* migrar pipeline a semantic release con IA ([fb0082a](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/fb0082a45b175dd6b157dcee381101e8bf56c43d))
+* traducir climas al español ([27c5af2](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/27c5af2f27cbf8097e3a0c1f2cc7832542801caa))
+* usar token personal para evitar error 500 en gitea api ([fc1c381](https://repo.eldiaservicios.com/dmolinari/ApiVersioningDemo/commit/fc1c3812840cb568a34755fa49c125810a7ad07a))

Dockerfile

@@ -0,0 +1,32 @@
+# ETAPA 1: BUILD
+# Usamos la imagen del SDK para compilar el código
+FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
+ARG BUILD_CONFIGURATION=Release
+WORKDIR /src
+
+# Copiamos primero los archivos de proyecto para aprovechar la caché de Docker
+COPY ["ApiVersioningDemo.Api/ApiVersioningDemo.Api.csproj", "ApiVersioningDemo.Api/"]
+RUN dotnet restore "ApiVersioningDemo.Api/ApiVersioningDemo.Api.csproj"
+
+# Copiamos todo el resto del código
+COPY . .
+WORKDIR "/src/ApiVersioningDemo.Api"
+RUN dotnet build "ApiVersioningDemo.Api.csproj" -c $BUILD_CONFIGURATION -o /app/build
+
+# Publicamos la aplicación (genera los .dll finales)
+FROM build AS publish
+ARG BUILD_CONFIGURATION=Release
+RUN dotnet publish "ApiVersioningDemo.Api.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false
+
+# ETAPA 2: RUNTIME
+# Usamos la imagen ligera de ASP.NET Core solo para ejecutar
+FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS final
+WORKDIR /app
+EXPOSE 8080
+EXPOSE 8081
+
+# Copiamos los archivos compilados de la etapa anterior
+COPY --from=publish /app/publish .
+
+# Definimos el punto de entrada
+ENTRYPOINT ["dotnet", "ApiVersioningDemo.Api.dll"]

docker-compose.yml

@@ -0,0 +1,11 @@
+services:
+  api-versionada:
+    # Apuntamos a la imagen de Gitea Packages
+    image: repo.eldiaservicios.com/dmolinari/apiversioningdemo:v1
+    container_name: mi-api-demo
+    ports:
+      - "8080:8080"
+    environment:
+      # Forzamos el entorno de desarrollo para poder ver Swagger
+      - ASPNETCORE_ENVIRONMENT=Development
+    restart: unless-stopped