Feature/11 api postgres

README.md

@@ -1,2 +1,12 @@
 # moisson-project
 Windows desktop application for accurate donation valuation and tax receipt generation for Moisson Montréal (Montréal, QC).
+## Running tests
+
+```bash
+dotnet test                                   # all tests (Docker must be running)
+dotnet test --filter "Category!=Integration"  # unit tests only, no Docker needed
+```
+
+Integration tests use Testcontainers to start a disposable PostgreSQL 17 container, so Docker Desktop (or Docker Engine) must be running.
+
+

src/MoissonMontreal.Api/Data/MoissonDbContext.cs

@@ -0,0 +1,8 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace MoissonMontreal.Api.Data;
+
+public class MoissonDbContext(DbContextOptions<MoissonDbContext> options) : DbContext(options)
+{
+    // Les tables (DbSet<Don>, DbSet<Recu>, ...) seront ajoutées avec l'issue du schéma.
+}

src/MoissonMontreal.Api/MoissonMontreal.Api.csproj

@@ -1,9 +1,10 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
+<Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
     <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
+    <UserSecretsId>61115b38-e487-4411-983f-5d85d34daf9f</UserSecretsId>
   </PropertyGroup>
 
   <ItemGroup>
@@ -12,6 +13,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
       <PrivateAssets>all</PrivateAssets>
     </PackageReference>
+    <PackageReference Include="Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore" Version="10.0.13" />
     <PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="10.0.3" />
   </ItemGroup>
 

src/MoissonMontreal.Api/MoissonMontreal.Api.http

@@ -1,6 +1,4 @@
 @MoissonMontreal.Api_HostAddress = http://localhost:5297
 
-GET {{MoissonMontreal.Api_HostAddress}}/weatherforecast/
-Accept: application/json
-
+GET {{MoissonMontreal.Api_HostAddress}}/health
 ###

src/MoissonMontreal.Api/Program.cs

@@ -1,6 +1,20 @@
+using Microsoft.EntityFrameworkCore;
+using MoissonMontreal.Api.Data;
+
+
 var builder = WebApplication.CreateBuilder(args);
 
+var connectionString = builder.Configuration.GetConnectionString("Moisson")
+    ?? throw new InvalidOperationException(
+        "La chaîne de connexion 'Moisson' est absente. Définissez ConnectionStrings__Moisson " +
+        "ou utilisez 'dotnet user-secrets'.");
+
+
 // Add services to the container.
+builder.Services.AddDbContext<MoissonDbContext>(options => options.UseNpgsql(connectionString));
+
+builder.Services.AddHealthChecks()
+    .AddDbContextCheck<MoissonDbContext>("database");
 
 builder.Services.AddControllers();
 // Learn more about configuring OpenAPI at https://aka.ms/aspnet/openapi
@@ -14,10 +28,15 @@
     app.MapOpenApi();
 }
 
-app.UseHttpsRedirection();
+// Health probes call /health over plain HTTP, so it must not be redirected.
+app.UseWhen(
+    context => !context.Request.Path.StartsWithSegments("/health"),
+    branch => branch.UseHttpsRedirection());
 
 app.UseAuthorization();
 
 app.MapControllers();
 
+app.MapHealthChecks("/health");
+
 app.Run();

src/MoissonMontreal.Api/appsettings.Development.json

@@ -1,4 +1,7 @@
 {
+  "ConnectionStrings": {
+    "Moisson": "Host=localhost;Port=5432;Database=moisson_dev;Username=moisson;Password=moisson"
+  },
   "Logging": {
     "LogLevel": {
       "Default": "Information",

tests/MoissonMontreal.Tests/Api/HealthEndpointTests.cs

@@ -0,0 +1,40 @@
+using System.Net;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.AspNetCore.Mvc.Testing;
+using MoissonMontreal.Tests.Fixtures;
+
+namespace MoissonMontreal.Tests.Api;
+
+[Trait("Category", "Integration")]
+public class HealthEndpointTests(PostgresFixture postgres) : IClassFixture<PostgresFixture>
+{
+    [Fact]
+    public async Task Health_ReturnsHealthy_WhenDatabaseIsReachable()
+    {
+        await using var factory = CreateFactory(postgres.ConnectionString);
+        using var client = factory.CreateClient();
+
+        var response = await client.GetAsync("/health");
+
+        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
+        Assert.Equal("Healthy", await response.Content.ReadAsStringAsync());
+    }
+
+    [Fact]
+    public async Task Health_ReturnsUnhealthy_WhenDatabaseIsUnreachable()
+    {
+        // Nothing listens on port 1, so the connection is refused immediately.
+        await using var factory = CreateFactory("Host=127.0.0.1;Port=1;Database=unreachable;Username=test;Timeout=2");
+        using var client = factory.CreateClient();
+
+        var response = await client.GetAsync("/health");
+
+        Assert.Equal(HttpStatusCode.ServiceUnavailable, response.StatusCode);
+        Assert.Equal("Unhealthy", await response.Content.ReadAsStringAsync());
+    }
+
+    private static WebApplicationFactory<Program> CreateFactory(string connectionString) =>
+        new WebApplicationFactory<Program>().WithWebHostBuilder(builder => builder
+            .UseEnvironment("Testing")
+            .UseSetting("ConnectionStrings:Moisson", connectionString));
+}

tests/MoissonMontreal.Tests/Fixtures/PostgresFixture.cs

@@ -0,0 +1,17 @@
+using Testcontainers.PostgreSql;
+
+namespace MoissonMontreal.Tests.Fixtures;
+
+/// <summary>
+/// Starts a single PostgreSQL container shared by every test of a class.
+/// </summary>
+public class PostgresFixture : IAsyncLifetime
+{
+    private readonly PostgreSqlContainer _container = new PostgreSqlBuilder("postgres:17").Build();
+
+    public string ConnectionString => _container.GetConnectionString();
+
+    public Task InitializeAsync() => _container.StartAsync();
+
+    public Task DisposeAsync() => _container.DisposeAsync().AsTask();
+}

tests/MoissonMontreal.Tests/MoissonMontreal.Tests.csproj

@@ -9,7 +9,9 @@
 
   <ItemGroup>
     <PackageReference Include="coverlet.collector" Version="6.0.4" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" Version="10.0.13" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.1" />
+    <PackageReference Include="Testcontainers.PostgreSql" Version="4.16.0" />
     <PackageReference Include="xunit" Version="2.9.3" />
     <PackageReference Include="xunit.runner.visualstudio" Version="3.1.4" />
   </ItemGroup>