feat: setup db context with initial models

src/Directory.Packages.props

@@ -1,10 +1,13 @@
 <Project>
-
   <PropertyGroup>
     <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
   </PropertyGroup>
-
   <ItemGroup>
     <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="10.0.1" />
+    <PackageVersion Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.2">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageVersion>
+    <PackageVersion Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.2" />
   </ItemGroup>
-</Project>
+</Project>

src/FiscalOS.API/Data/AppDbContext.cs

@@ -0,0 +1,38 @@
+namespace FiscalOS.API.Data;
+
+internal sealed class AppDbContext(IOptions<AppDbContextOptions> ctxOptions) : DbContext
+{
+  private const string DataSourceKey = "Data Source=";
+  private readonly AppDbContextOptions _ctxOptions = ctxOptions.Value;
+
+  public DbSet<User> Users => Set<User>();
+  public DbSet<RefreshToken> RefreshTokens => Set<RefreshToken>();
+
+  protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+  {
+    var dbPath = _ctxOptions.GetFullyQualifiedDatabasePath();
+    var dbDirectory = Path.GetDirectoryName(dbPath) ?? throw new InvalidOperationException("Database directory path could not be determined.");
+
+    if (Directory.Exists(dbDirectory) is false)
+    {
+      Directory.CreateDirectory(dbDirectory);
+    }
+
+    var connectionString = $"{DataSourceKey}{dbPath}";
+
+    optionsBuilder.UseSqlite(connectionString);
+  }
+
+  protected override void OnModelCreating(ModelBuilder modelBuilder)
+  {
+    base.OnModelCreating(modelBuilder);
+
+    modelBuilder.Entity<User>()
+      .Property(static u => u.Id)
+      .ValueGeneratedOnAdd();
+
+    modelBuilder.Entity<RefreshToken>()
+      .Property(static t => t.Id)
+      .ValueGeneratedOnAdd();
+  }
+}

src/FiscalOS.API/Data/AppDbContextOptions.cs

@@ -0,0 +1,26 @@
+namespace FiscalOS.API.Data;
+
+internal sealed record AppDbContextOptions
+{
+  public string DatabaseFilePath { get; init; } = string.Empty;
+  public string GetFullyQualifiedDatabasePath()
+  {
+    return Path.GetFullPath(DatabaseFilePath, AppContext.BaseDirectory);
+  }
+}
+
+internal sealed record AppDbContextOptionsSetup : IConfigureOptions<AppDbContextOptions>
+{
+  private const string SectionName = nameof(AppDbContextOptions);
+  private readonly IConfiguration _configuration;
+
+  public AppDbContextOptionsSetup(IConfiguration configuration)
+  {
+    _configuration = configuration;
+  }
+
+  public void Configure(AppDbContextOptions options)
+  {
+    _configuration.GetSection(SectionName).Bind(options);
+  }
+}

src/FiscalOS.API/Data/MigrationService.cs

@@ -0,0 +1,25 @@
+namespace FiscalOS.API.Data;
+
+internal sealed class MigrationService(
+  IServiceProvider serviceProvider,
+  ILogger<MigrationService> logger
+) : IHostedService
+{
+  private readonly IServiceProvider _serviceProvider = serviceProvider;
+
+  public async Task StartAsync(CancellationToken cancellationToken)
+  {
+    logger.LogInformation("Applying database migrations...");
+
+    using var scope = _serviceProvider.CreateScope();
+    var context = scope.ServiceProvider.GetRequiredService<AppDbContext>();
+    await context.Database.MigrateAsync(cancellationToken);
+
+    logger.LogInformation("Database migrations applied.");
+  }
+
+  public Task StopAsync(CancellationToken cancellationToken)
+  {
+    return Task.CompletedTask;
+  }
+}

src/FiscalOS.API/FiscalOS.API.csproj

@@ -2,6 +2,11 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.AspNetCore.OpenApi" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" />
   </ItemGroup>
 
 </Project>

src/FiscalOS.API/Identity/RefreshToken.cs

@@ -0,0 +1,6 @@
+namespace FiscalOS.API.Identity;
+
+internal sealed class RefreshToken
+{
+  public Guid Id { get; init; }
+}

src/FiscalOS.API/Identity/User.cs

@@ -0,0 +1,6 @@
+namespace FiscalOS.API.Identity;
+
+internal sealed class User
+{
+  public Guid Id { get; init; }
+}

src/FiscalOS.API/Migrations/20260201115839_AddUsersAndRefreshTokens.Designer.cs

@@ -0,0 +1,47 @@
+// <auto-generated />
+using System;
+using FiscalOS.API.Data;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+#nullable disable
+
+namespace FiscalOS.API.Migrations
+{
+    [DbContext(typeof(AppDbContext))]
+    [Migration("20260201115839_AddUsersAndRefreshTokens")]
+    partial class AddUsersAndRefreshTokens
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder.HasAnnotation("ProductVersion", "10.0.2");
+
+            modelBuilder.Entity("FiscalOS.API.Identity.RefreshToken", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("RefreshTokens");
+                });
+
+            modelBuilder.Entity("FiscalOS.API.Identity.User", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Users");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

src/FiscalOS.API/Migrations/20260201115839_AddUsersAndRefreshTokens.cs

@@ -0,0 +1,47 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace FiscalOS.API.Migrations
+{
+  /// <inheritdoc />
+  public partial class AddUsersAndRefreshTokens : Migration
+  {
+    /// <inheritdoc />
+    protected override void Up(MigrationBuilder migrationBuilder)
+    {
+      migrationBuilder.CreateTable(
+          name: "RefreshTokens",
+          columns: table => new
+          {
+            Id = table.Column<Guid>(type: "TEXT", nullable: false)
+          },
+          constraints: table =>
+          {
+            table.PrimaryKey("PK_RefreshTokens", x => x.Id);
+          });
+
+      migrationBuilder.CreateTable(
+          name: "Users",
+          columns: table => new
+          {
+            Id = table.Column<Guid>(type: "TEXT", nullable: false)
+          },
+          constraints: table =>
+          {
+            table.PrimaryKey("PK_Users", x => x.Id);
+          });
+    }
+
+    /// <inheritdoc />
+    protected override void Down(MigrationBuilder migrationBuilder)
+    {
+      migrationBuilder.DropTable(
+          name: "RefreshTokens");
+
+      migrationBuilder.DropTable(
+          name: "Users");
+    }
+  }
+}

src/FiscalOS.API/Migrations/AppDbContextModelSnapshot.cs

@@ -0,0 +1,44 @@
+// <auto-generated />
+using System;
+using FiscalOS.API.Data;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+#nullable disable
+
+namespace FiscalOS.API.Migrations
+{
+    [DbContext(typeof(AppDbContext))]
+    partial class AppDbContextModelSnapshot : ModelSnapshot
+    {
+        protected override void BuildModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder.HasAnnotation("ProductVersion", "10.0.2");
+
+            modelBuilder.Entity("FiscalOS.API.Identity.RefreshToken", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("RefreshTokens");
+                });
+
+            modelBuilder.Entity("FiscalOS.API.Identity.User", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Users");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

src/FiscalOS.API/Program.cs

@@ -1,8 +1,14 @@
+using FiscalOS.API.Data;
+
 var builder = WebApplication.CreateBuilder(args);
 
 builder.Services.AddValidation();
 builder.Services.AddOpenApi();
 
+builder.Services.ConfigureOptions<AppDbContextOptionsSetup>();
+builder.Services.AddDbContext<AppDbContext>();
+builder.Services.AddHostedService<MigrationService>();
+
 var app = builder.Build();
 
 if (app.Environment.IsDevelopment())

src/FiscalOS.API/Usings.cs

@@ -1,5 +1,8 @@
 global using System.ComponentModel.DataAnnotations;
 
+global using FiscalOS.API.Identity;
 global using FiscalOS.API.Login;
 
 global using Microsoft.AspNetCore.Mvc;
+global using Microsoft.EntityFrameworkCore;
+global using Microsoft.Extensions.Options;

tests/FiscalOS.API.Tests/Usings.cs

@@ -1,5 +1,11 @@
+global using System.Net;
+global using System.Net.Http.Json;
+
 global using FiscalOS.API.Tests.Infra;
 
 global using Microsoft.AspNetCore.Hosting;
+global using Microsoft.AspNetCore.Mvc;
 global using Microsoft.AspNetCore.Mvc.Testing;
-global using Microsoft.Extensions.Logging;
+global using Microsoft.Extensions.Logging;
+
+global using Xunit.Sdk;