Fase 1: Creación del backend API con .NET, Dapper y endpoints CRUD para Titulares

.gitignore

@@ -1,16 +1,17 @@
-# Backend
+# Ignore Visual Studio Code settings
-backend/bin/
+.vscode/
-backend/obj/
-backend/[Bb]in/
-backend/[Oo]bj/
-backend/appsettings.Development.json
 
-# Frontend
+# Ignore common OS-generated files
+.DS_Store
+*.swp
+
+# Ignore Frontend dependencies and build output
 frontend/node_modules/
 frontend/dist/
 frontend/.env.local
-frontend/.DS_Store
 
-# IDEs
+# Ignore .NET build artifacts and user-specific files
-.vscode/
+**/[Bb]in/
-.idea/
+**/[Oo]bj/
+*.user
+*.suo

TitularesApp.sln

@@ -0,0 +1,32 @@
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.5.2.0
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "backend", "backend", "{1AE8ACA6-933B-BF2A-3671-3E2EAC007D16}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{0F9113EE-888A-26D2-68B0-4A7D0A2A8745}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Titulares.Api", "backend\src\Titulares.Api\Titulares.Api.csproj", "{5F7CE525-ABE6-287E-9D86-8E30836C37A7}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{5F7CE525-ABE6-287E-9D86-8E30836C37A7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{5F7CE525-ABE6-287E-9D86-8E30836C37A7}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{5F7CE525-ABE6-287E-9D86-8E30836C37A7}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{5F7CE525-ABE6-287E-9D86-8E30836C37A7}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{0F9113EE-888A-26D2-68B0-4A7D0A2A8745} = {1AE8ACA6-933B-BF2A-3671-3E2EAC007D16}
+		{5F7CE525-ABE6-287E-9D86-8E30836C37A7} = {0F9113EE-888A-26D2-68B0-4A7D0A2A8745}
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {5B89267C-BBAA-48DE-B03A-C2E83EC18490}
+	EndGlobalSection
+EndGlobal

backend/src/Titulares.Api/Controllers/TitularesController.cs

@@ -0,0 +1,66 @@
+// backend/src/Titulares.Api/Controllers/TitularesController.cs
+
+using Microsoft.AspNetCore.Mvc;
+using Titulares.Api.Data;
+using Titulares.Api.Models;
+
+namespace Titulares.Api.Controllers;
+
+[ApiController]
+[Route("api/[controller]")]
+public class TitularesController : ControllerBase
+{
+  private readonly TitularRepositorio _repositorio;
+
+  public TitularesController(TitularRepositorio repositorio)
+  {
+    _repositorio = repositorio;
+  }
+
+  [HttpGet]
+  public async Task<IActionResult> ObtenerTodos()
+  {
+    var titulares = await _repositorio.ObtenerTodosAsync();
+    return Ok(titulares);
+  }
+
+  [HttpPost]
+  public async Task<IActionResult> CrearManual([FromBody] CrearTitularDto titularDto)
+  {
+    if (!ModelState.IsValid)
+    {
+      return BadRequest(ModelState);
+    }
+    var nuevoId = await _repositorio.CrearManualAsync(titularDto);
+    return CreatedAtAction(nameof(ObtenerTodos), new { id = nuevoId }, null);
+  }
+
+  [HttpPut("{id}")]
+  public async Task<IActionResult> Actualizar(int id, [FromBody] ActualizarTitularDto titularDto)
+  {
+    if (!ModelState.IsValid)
+    {
+      return BadRequest(ModelState);
+    }
+    var resultado = await _repositorio.ActualizarTextoAsync(id, titularDto);
+    return resultado ? NoContent() : NotFound();
+  }
+
+  [HttpPut("reordenar")]
+  public async Task<IActionResult> Reordenar([FromBody] List<ReordenarTitularDto> ordenes)
+  {
+    if (ordenes == null || !ordenes.Any())
+    {
+      return BadRequest("La lista de órdenes no puede estar vacía.");
+    }
+    var resultado = await _repositorio.ActualizarOrdenAsync(ordenes);
+    return resultado ? Ok() : StatusCode(500, "Error al actualizar el orden.");
+  }
+
+  [HttpDelete("{id}")]
+  public async Task<IActionResult> Eliminar(int id)
+  {
+    var resultado = await _repositorio.EliminarAsync(id);
+    return resultado ? NoContent() : NotFound();
+  }
+}

backend/src/Titulares.Api/Data/TitularRepositorio.cs

@@ -0,0 +1,85 @@
+// backend/src/Titulares.Api/Data/TitularRepositorio.cs
+
+using Dapper;
+using Microsoft.Data.SqlClient;
+using Titulares.Api.Models;
+
+namespace Titulares.Api.Data;
+
+public class TitularRepositorio
+{
+  private readonly string _connectionString;
+
+  public TitularRepositorio(IConfiguration configuration)
+  {
+    _connectionString = configuration.GetConnectionString("DefaultConnection")!;
+  }
+
+  private SqlConnection CreateConnection() => new SqlConnection(_connectionString);
+
+  public async Task<IEnumerable<Titular>> ObtenerTodosAsync()
+  {
+    using var connection = CreateConnection();
+    // Siempre los obtenemos en el orden correcto
+    return await connection.QueryAsync<Titular>("SELECT * FROM Titulares ORDER BY OrdenVisual");
+  }
+
+  public async Task<int> CrearManualAsync(CrearTitularDto titularDto)
+  {
+    using var connection = CreateConnection();
+    // Obtenemos el OrdenVisual más bajo (el primero) y restamos 1 para ponerlo al inicio.
+    var minOrdenVisual = await connection.ExecuteScalarAsync<int?>("SELECT MIN(OrdenVisual) FROM Titulares") ?? 1;
+    var nuevoOrden = minOrdenVisual - 1;
+
+    var sql = @"
+            INSERT INTO Titulares (Texto, ModificadoPorUsuario, EsEntradaManual, OrdenVisual, Tipo, Fuente)
+            VALUES (@Texto, 0, 1, @OrdenVisual, 'Manual', 'Usuario');
+            SELECT CAST(SCOPE_IDENTITY() as int);
+        ";
+    return await connection.ExecuteScalarAsync<int>(sql, new { titularDto.Texto, OrdenVisual = nuevoOrden });
+  }
+
+  public async Task<bool> ActualizarTextoAsync(int id, ActualizarTitularDto titularDto)
+  {
+    using var connection = CreateConnection();
+    var sql = @"
+            UPDATE Titulares
+            SET Texto = @Texto, ModificadoPorUsuario = 1, Tipo = 'Edited'
+            WHERE Id = @Id;
+        ";
+    var affectedRows = await connection.ExecuteAsync(sql, new { titularDto.Texto, Id = id });
+    return affectedRows > 0;
+  }
+
+  public async Task<bool> EliminarAsync(int id)
+  {
+    using var connection = CreateConnection();
+    var affectedRows = await connection.ExecuteAsync("DELETE FROM Titulares WHERE Id = @Id", new { Id = id });
+    return affectedRows > 0;
+  }
+
+  public async Task<bool> ActualizarOrdenAsync(List<ReordenarTitularDto> ordenes)
+  {
+    using var connection = CreateConnection();
+    await connection.OpenAsync();
+    using var transaction = connection.BeginTransaction();
+
+    try
+    {
+      foreach (var item in ordenes)
+      {
+        await connection.ExecuteAsync(
+            "UPDATE Titulares SET OrdenVisual = @NuevoOrden WHERE Id = @Id",
+            item,
+            transaction: transaction);
+      }
+      transaction.Commit();
+      return true;
+    }
+    catch
+    {
+      transaction.Rollback();
+      return false;
+    }
+  }
+}

backend/src/Titulares.Api/Models/Titular.cs

@@ -0,0 +1,36 @@
+// backend/src/Titulares.Api/Models/Titular.cs
+
+namespace Titulares.Api.Models;
+
+public class Titular
+{
+  public int Id { get; set; }
+  public required string Texto { get; set; }
+  public string? UrlFuente { get; set; }
+  public bool ModificadoPorUsuario { get; set; }
+  public bool EsEntradaManual { get; set; }
+  public int OrdenVisual { get; set; }
+  public DateTime FechaCreacion { get; set; }
+  public string? Encabezado { get; set; }
+  public string? Tipo { get; set; }
+  public string? Fuente { get; set; }
+}
+
+// DTO (Data Transfer Object) para la creación de un titular manual
+public class CrearTitularDto
+{
+  public required string Texto { get; set; }
+}
+
+// DTO para la actualización de un titular
+public class ActualizarTitularDto
+{
+  public required string Texto { get; set; }
+}
+
+// DTO para el reordenamiento
+public class ReordenarTitularDto
+{
+  public int Id { get; set; }
+  public int NuevoOrden { get; set; }
+}

backend/src/Titulares.Api/Program.cs

@@ -0,0 +1,57 @@
+// backend/src/Titulares.Api/Program.cs
+using Titulares.Api.Data;
+
+var builder = WebApplication.CreateBuilder(args);
+
+// 1. Añadir servicios al contenedor.
+// ===================================
+
+// Añadimos los servicios para los controladores API
+builder.Services.AddControllers();
+
+builder.Services.AddEndpointsApiExplorer();
+builder.Services.AddSwaggerGen();
+
+// Añadimos nuestro repositorio personalizado
+builder.Services.AddSingleton<TitularRepositorio>();
+
+// Añadimos los servicios de autorización (necesario para app.UseAuthorization)
+builder.Services.AddAuthorization();
+
+// Añadimos la política de CORS
+builder.Services.AddCors(options =>
+{
+    options.AddPolicy("AllowReactApp", builder =>
+    {
+        builder.WithOrigins("http://localhost:5173")
+               .AllowAnyHeader()
+               .AllowAnyMethod()
+               .AllowCredentials();
+    });
+});
+
+// 2. Construir la aplicación.
+// ==========================
+var app = builder.Build();
+
+// 3. Configurar el pipeline de peticiones HTTP.
+// ============================================
+
+if (app.Environment.IsDevelopment())
+{
+    app.UseSwagger();
+    app.UseSwaggerUI();
+}
+
+app.UseHttpsRedirection();
+
+// Usamos la política de CORS que definimos
+app.UseCors("AllowReactApp");
+
+// Usamos la autorización
+app.UseAuthorization();
+
+// Mapeamos los controladores para que la API responda a las rutas
+app.MapControllers();
+
+app.Run();

backend/src/Titulares.Api/Properties/launchSettings.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json.schemastore.org/launchsettings.json",
+  "profiles": {
+    "http": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": false,
+      "applicationUrl": "http://localhost:5173",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "https": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": false,
+      "applicationUrl": "https://localhost:7000;http://localhost:5173",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    }
+  }
+}

backend/src/Titulares.Api/Titulares.Api.csproj

@@ -0,0 +1,18 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net9.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="CsvHelper" Version="33.1.0" />
+    <PackageReference Include="Dapper" Version="2.1.66" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.12.4" />
+    <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.5" />
+    <PackageReference Include="Microsoft.Data.SqlClient" Version="6.1.2" />
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="9.0.6" />
+  </ItemGroup>
+
+</Project>

backend/src/Titulares.Api/Titulares.Api.http

@@ -0,0 +1,6 @@
+@Titulares.Api_HostAddress = http://localhost:5098
+
+GET {{Titulares.Api_HostAddress}}/weatherforecast/
+Accept: application/json
+
+###

backend/src/Titulares.Api/appsettings.Development.json

@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}

backend/src/Titulares.Api/appsettings.json

@@ -0,0 +1,12 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*",
+  "ConnectionStrings": {
+    "DefaultConnection": "Server=TECNICA3;Database=TitularesDB;User Id=titularesApi;Password=PTP847Titulares;Trusted_Connection=True;TrustServerCertificate=True;"
+  }
+}