feat: setup db context with initial models

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;
+  }
+}