feat(notification): add admin rest management and deletion

Add revision-safe service and template APIs, channel mapping, and validated admin controls. Ref: IT-1601
feat(templates): add service language template management
2026-10-17 22:51:01 +03:00 · 2026-10-17 22:02:43 +03:00 · 2026-10-03 15:19:39 +03:00 · 2026-10-03 15:18:03 +03:00 · 2026-10-03 00:59:44 +03:00 · 2026-10-03 00:56:28 +03:00
239 changed files with 11643 additions and 1144 deletions
@@ -1,9 +1,10 @@
-**/.git
-**/.vs
-**/.idea
-**/bin
-**/obj
-**/*.user
-**/*.suo
-**/TestResults
-NuGet.Config
+**/.git
+**/.vs
+**/.idea
+**/bin
+**/obj
+**/*.user
+**/*.suo
+**/TestResults
+NuGet.Config
+docker/kubernetes/
@@ -480,3 +480,6 @@ $RECYCLE.BIN/

 # Vim temporary swap files
 *.swp
+
+# Local Docker Compose secrets and ports
+docker/environments/.env.local
@@ -0,0 +1,27 @@
+# HrynCo Notification Service Agent Rules
+
+## Git workflow
+
+- Treat `main` as the only default and integration branch for this repository.
+- Start every task branch from the latest `origin/main`.
+- Before creating a task branch, fetch the remote, switch to `main`, and fast-forward it from `origin/main`.
+- Create the task branch only after confirming that local `main` matches `origin/main`.
+- Open pull requests from the task branch into `main`.
+- Do not use `development` as the base or pull-request target for new work in this repository.
+- Do not commit, push, publish, deploy, or merge unless the repository owner explicitly requests that step.
+
+Recommended branch preparation:
+
+```text
+git fetch origin
+git switch main
+git pull --ff-only origin main
+git switch -c <task-branch>
+```
+
+## Delivery
+
+- Keep changes focused and preserve backward compatibility where practical.
+- Update the matching repository documentation when behavior, contracts, configuration, routing, or workflows change.
+- Run the solution build and relevant tests before handoff.
+- Use Conventional Commit messages with a lowercase subject and finish the commit body with `Ref: <issue-id>` when an issue exists.
@@ -1,5 +1 @@
-<Project>
-    <PropertyGroup>
-        <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
-    </PropertyGroup>
-</Project>
+<Project />
@@ -1,44 +1,44 @@
 <Project>
-
-    <ItemGroup>
-        <!-- Entity Framework Core -->
-        <PackageVersion Include="Microsoft.EntityFrameworkCore" Version="9.0.5" />
-        <PackageVersion Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.5" />
-        <PackageVersion Include="Microsoft.EntityFrameworkCore.Relational" Version="9.0.5" />
-        <PackageVersion Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="9.0.4" />
-
-        <!-- MediatR -->
-        <PackageVersion Include="MediatR" Version="12.4.1" />
-        <PackageVersion Include="MediatR.Extensions.Microsoft.DependencyInjection" Version="11.1.0" />
-
-        <!-- Microsoft.Extensions -->
-        <PackageVersion Include="Microsoft.Extensions.Hosting" Version="10.0.6" />
-        <PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.6" />
-        <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="10.0.6" />
-        <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.6" />
-        <PackageVersion Include="Scalar.AspNetCore" Version="2.14.9" />
-        <PackageVersion Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="10.0.6" />
-        <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="10.0.6" />
-
-        <!-- Serilog -->
-        <PackageVersion Include="Serilog" Version="4.2.0" />
-        <PackageVersion Include="Serilog.AspNetCore" Version="9.0.0" />
-        <PackageVersion Include="Serilog.Extensions.Hosting" Version="9.0.0" />
-        <PackageVersion Include="Serilog.Settings.Configuration" Version="9.0.0" />
-        <PackageVersion Include="Serilog.Sinks.Console" Version="6.0.0" />
-        <PackageVersion Include="Serilog.Sinks.Seq" Version="9.0.0" />
-
-        <!-- HrynCo shared packages -->
-        <PackageVersion Include="HrynCo.Common" Version="1.0.0" />
-        <PackageVersion Include="HrynCo.RabbitMq" Version="1.0.14" />
-
-        <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.14.1" />
-        <PackageVersion Include="coverlet.collector" Version="6.0.4" />
-        <PackageVersion Include="xunit" Version="2.9.3" />
-        <PackageVersion Include="xunit.runner.visualstudio" Version="3.1.4" />
-        <PackageVersion Include="NSubstitute" Version="5.3.0" />
-        <PackageVersion Include="Testcontainers.PostgreSql" Version="4.6.0" />
-        <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="9.0.5" />
-    </ItemGroup>
-
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+  </PropertyGroup>
+  <ItemGroup>
+    <!-- Entity Framework Core -->
+    <PackageVersion Include="HrynCo.DAL.Abstract" Version="1.0.11" />
+    <PackageVersion Include="HrynCo.DAL.EF" Version="1.0.11" />
+    <PackageVersion Include="Microsoft.EntityFrameworkCore" Version="10.0.7" />
+    <PackageVersion Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.7" />
+    <PackageVersion Include="Microsoft.EntityFrameworkCore.Relational" Version="10.0.7" />
+    <PackageVersion Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="10.0.1" />
+    <!-- MediatR -->
+    <PackageVersion Include="MediatR" Version="12.4.1" />
+    <PackageVersion Include="MediatR.Extensions.Microsoft.DependencyInjection" Version="11.1.0" />
+    <!-- Microsoft.Extensions -->
+    <PackageVersion Include="Microsoft.Extensions.Hosting" Version="10.0.6" />
+    <PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.6" />
+    <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="10.0.6" />
+    <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.6" />
+    <PackageVersion Include="Scalar.AspNetCore" Version="2.14.9" />
+    <PackageVersion Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="10.0.6" />
+    <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="10.0.6" />
+    <!-- Serilog -->
+    <PackageVersion Include="Serilog" Version="4.2.0" />
+    <PackageVersion Include="Serilog.AspNetCore" Version="9.0.0" />
+    <PackageVersion Include="Serilog.Extensions.Hosting" Version="9.0.0" />
+    <PackageVersion Include="Serilog.Settings.Configuration" Version="9.0.0" />
+    <PackageVersion Include="Serilog.Sinks.Console" Version="6.0.0" />
+    <PackageVersion Include="Serilog.Sinks.Seq" Version="9.0.0" />
+    <!-- HrynCo shared packages -->
+    <PackageVersion Include="HrynCo.Common" Version="1.0.11" />
+    <PackageVersion Include="HrynCo.RabbitMq" Version="1.0.17" />
+    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.14.1" />
+    <PackageVersion Include="coverlet.collector" Version="6.0.4" />
+    <PackageVersion Include="xunit" Version="2.9.3" />
+    <PackageVersion Include="xunit.runner.visualstudio" Version="3.1.4" />
+    <PackageVersion Include="NSubstitute" Version="5.3.0" />
+    <!-- Patched test-only dependency pulled by Testcontainers. -->
+    <PackageVersion Include="SSH.NET" Version="2026.0.0" />
+    <PackageVersion Include="Testcontainers.PostgreSql" Version="4.6.0" />
+    <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="10.0.6" />
+  </ItemGroup>
 </Project>
@@ -4,6 +4,12 @@
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
+    <PackageId>HrynCo.NotificationService.Contracts</PackageId>
+    <Authors>HrynCo</Authors>
+    <Description>RabbitMQ message contracts for HrynCo.NotificationService.</Description>
+    <PackageTags>hrynco notification email rabbitmq contracts</PackageTags>
+    <RepositoryType>git</RepositoryType>
+    <RepositoryUrl>https://gitea.hrynco.com/hrynco/hrynco-notification-service.git</RepositoryUrl>
  </PropertyGroup>

  <ItemGroup>
@@ -1,17 +0,0 @@
-namespace HrynCo.NotificationService.DAL.Abstract.Entities;
-
-public abstract class Entity<TId> : IEntity<TId> where TId : struct
-{
-    public TId Id { get; set; }
-    public DateTimeOffset Created { get; set; }
-    public DateTimeOffset? Updated { get; set; }
-}
-
-public abstract class Entity : Entity<Guid>
-{
-    protected Entity()
-    {
-        Id = Guid.NewGuid();
-        Created = DateTimeOffset.UtcNow;
-    }
-}
@@ -1,8 +0,0 @@
-namespace HrynCo.NotificationService.DAL.Abstract.Entities;
-
-public interface IEntity<TId> where TId : struct
-{
-    TId Id { get; set; }
-    DateTimeOffset Created { get; set; }
-    DateTimeOffset? Updated { get; set; }
-}
@@ -6,4 +6,8 @@
    <Nullable>enable</Nullable>
  </PropertyGroup>

+  <ItemGroup>
+    <PackageReference Include="HrynCo.DAL.Abstract" />
+  </ItemGroup>
+
 </Project>
@@ -1,7 +0,0 @@
-namespace HrynCo.NotificationService.DAL.Abstract;
-
-public interface ITransaction : IAsyncDisposable
-{
-    Task CommitAsync(CancellationToken cancellationToken = default);
-    Task RollbackAsync(CancellationToken cancellationToken = default);
-}
@@ -1,11 +0,0 @@
-namespace HrynCo.NotificationService.DAL.Abstract;
-
-public interface IUnitOfWork
-{
-    Task SaveChangesAsync(CancellationToken cancellationToken = default);
-    Task<ITransaction> BeginTransactionAsync(CancellationToken cancellationToken = default);
-    ITransaction? GetCurrentTransaction();
-
-    Task ExecuteInTransactionAsync(Func<Task> action);
-    Task<TResult> ExecuteInTransactionAsync<TResult>(Func<Task<TResult>> action);
-}
@@ -1,4 +1,4 @@
-using HrynCo.NotificationService.DAL.Abstract.Entities;
+using HrynCo.DAL.Abstract.Entities;

 namespace HrynCo.NotificationService.DAL.Abstract.Providers;

@@ -12,4 +12,4 @@ public class EmailChannel : Entity
    public int? MonthlyLimit { get; set; }
    public int WarnThresholdPercent { get; set; } = 90;
    public bool IsActive { get; set; } = true;
-}
+}
@@ -1,13 +1,14 @@
-using HrynCo.NotificationService.DAL.Abstract.Entities;
-
 namespace HrynCo.NotificationService.DAL.Abstract.Providers;

 /// <summary>
 /// Tracks email send counts per EmailChannel per calendar day.
 /// Monthly counts are derived by summing daily records within a month.
 /// </summary>
-public class EmailChannelUsage : Entity
+public class EmailChannelUsage
 {
+    public Guid Id { get; set; }
+    public DateTimeOffset Created { get; set; }
+    public DateTimeOffset? Updated { get; set; }
    public Guid ProviderId { get; set; }
    public DateOnly Date { get; set; }
    public int SentCount { get; set; }
@@ -0,0 +1,14 @@
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+
+namespace HrynCo.NotificationService.DAL.Abstract.Repositories;
+
+public interface IEmailTemplateDefinitionRepository
+{
+    Task<IReadOnlyList<EmailTemplateDefinition>> GetDefinitionsAsync(string? serviceName = null, string? key = null, CancellationToken ct = default);
+    Task<EmailTemplateDefinition?> GetDefinitionAsync(string serviceName, string key, CancellationToken ct = default);
+    Task<EmailTemplateDefinition?> GetDefinitionAsync(Guid serviceId, string key, CancellationToken ct = default);
+    Task<EmailTemplateDefinition?> UpsertDefinitionAsync(EmailTemplateDefinitionPatch patch, CancellationToken ct = default);
+    Task<IReadOnlyList<EmailTemplateDefinition>> GetDefinitionsAsync(Guid serviceId, CancellationToken ct = default);
+    Task<bool> DeleteDefinitionAsync(Guid serviceId, string key, Guid revision, CancellationToken ct = default);
+    Task SaveDefinitionAsync(EmailTemplateDefinition definition, bool isNew, CancellationToken ct = default);
+}
@@ -4,10 +4,10 @@ namespace HrynCo.NotificationService.DAL.Abstract.Repositories;

 public interface IEmailTemplateRepository
 {
-    Task<IReadOnlyList<EmailTemplate>> GetAllAsync(CancellationToken ct = default);
+    Task<IReadOnlyList<EmailTemplate>> GetAllAsync(string? serviceName = null, string? key = null, CancellationToken ct = default);
    Task<IReadOnlyList<EmailTemplate>> GetByServiceAsync(string serviceName, CancellationToken ct = default);
    Task<EmailTemplate?> GetAsync(string serviceName, string key, string languageCode, CancellationToken ct = default);
    Task AddAsync(EmailTemplate template, CancellationToken ct = default);
    Task UpdateAsync(EmailTemplate template, CancellationToken ct = default);
    Task DeleteAsync(EmailTemplate template, CancellationToken ct = default);
-}
+}
@@ -0,0 +1,13 @@
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+
+namespace HrynCo.NotificationService.DAL.Abstract.Repositories;
+
+public interface INotificationServiceRepository
+{
+    Task<IReadOnlyList<NotificationServiceInfo>> GetAllAsync(CancellationToken ct = default);
+    Task<NotificationServiceInfo?> GetAsync(Guid id, CancellationToken ct = default);
+    Task<NotificationServiceInfo?> GetByNameAsync(string name, CancellationToken ct = default);
+    Task<bool> DeleteAsync(Guid id, Guid revision, CancellationToken ct = default);
+    Task SaveAsync(NotificationServiceInfo service, bool isNew, CancellationToken ct = default);
+    Task RemoveLanguageAsync(Guid serviceId, Guid languageId, int expectedVersionCount, Guid expectedRevision, CancellationToken ct = default);
+}
@@ -1,4 +1,4 @@
-using HrynCo.NotificationService.DAL.Abstract.Entities;
+using HrynCo.DAL.Abstract.Entities;

 namespace HrynCo.NotificationService.DAL.Abstract.Templates;

@@ -0,0 +1,13 @@
+using HrynCo.DAL.Abstract.Entities;
+
+namespace HrynCo.NotificationService.DAL.Abstract.Templates;
+
+public sealed class EmailTemplateDefinition : Entity
+{
+    public Guid ServiceId { get; set; }
+    public required string ServiceName { get; set; }
+    public required string Key { get; set; }
+    public Guid Revision { get; set; }
+    public IReadOnlyList<EmailTemplateVariable> Variables { get; set; } = [];
+    public IReadOnlyList<EmailTemplate> Languages { get; set; } = [];
+}
@@ -0,0 +1,11 @@
+namespace HrynCo.NotificationService.DAL.Abstract.Templates;
+
+public sealed class EmailTemplateDefinitionPatch
+{
+    public Guid ServiceId { get; init; }
+    public required string Key { get; init; }
+    public Guid? Revision { get; init; }
+    public required IReadOnlyList<EmailTemplateVariable> Variables { get; init; }
+    public required IReadOnlyList<EmailTemplate> Translations { get; init; }
+    public IReadOnlyList<string> RemoveLanguageCodes { get; init; } = [];
+}
@@ -0,0 +1,76 @@
+using System.Text.Json;
+
+namespace HrynCo.NotificationService.DAL.Abstract.Templates;
+
+public static class EmailTemplateValidation
+{
+    private static readonly JsonSerializerOptions JsonOptions = new(JsonSerializerDefaults.Web)
+    {
+        PropertyNameCaseInsensitive = false,
+        UnmappedMemberHandling = System.Text.Json.Serialization.JsonUnmappedMemberHandling.Disallow
+    };
+
+    public static IReadOnlyList<EmailTemplateVariable> ParseVariables(string json)
+    {
+        using var document = JsonDocument.Parse(json);
+        if (document.RootElement.ValueKind == JsonValueKind.Null)
+            throw new EmailTemplateWriteException("Variables must be a JSON array.", false);
+        if (document.RootElement.ValueKind != JsonValueKind.Array)
+            throw new JsonException("Variables must be an array.");
+        foreach (var item in document.RootElement.EnumerateArray())
+            ValidateVariableShape(item);
+        var variables = JsonSerializer.Deserialize<List<EmailTemplateVariable>>(json, JsonOptions);
+        ValidateVariables(variables);
+        return variables!;
+    }
+
+    private static void ValidateVariableShape(JsonElement item)
+    {
+        if (item.ValueKind != JsonValueKind.Object)
+            throw new JsonException("Each variable must be an object.");
+        if (!item.TryGetProperty("name", out var name) || name.ValueKind != JsonValueKind.String)
+            throw new JsonException("Every variable needs a name string.");
+        if (!item.TryGetProperty("required", out var required) || required.ValueKind is not (JsonValueKind.True or JsonValueKind.False))
+            throw new JsonException("Every variable needs a required boolean.");
+    }
+
+    public static void ValidateVariables(IReadOnlyList<EmailTemplateVariable>? variables)
+    {
+        if (variables is null)
+            throw new EmailTemplateWriteException("Variables must be a JSON array.", false);
+        if (variables.Any(v => v is null || string.IsNullOrWhiteSpace(v.Name)))
+            throw new EmailTemplateWriteException("Every variable needs a non-empty name.", false);
+        if (variables.Select(v => v.Name).Distinct(StringComparer.Ordinal).Count() != variables.Count)
+            throw new EmailTemplateWriteException("Variable names must be unique.", false);
+    }
+
+    public static bool ContractsEqual(IReadOnlyList<EmailTemplateVariable> left, IReadOnlyList<EmailTemplateVariable> right) =>
+        left.OrderBy(v => v.Name, StringComparer.Ordinal).SequenceEqual(right.OrderBy(v => v.Name, StringComparer.Ordinal));
+
+    public static void ValidateIdentity(string serviceName, string key)
+    {
+        if (string.IsNullOrWhiteSpace(serviceName) || serviceName.Length > 100)
+            throw new EmailTemplateWriteException("Service name is required and must be at most 100 characters.", false);
+        if (string.IsNullOrWhiteSpace(key) || key.Length > 100)
+            throw new EmailTemplateWriteException("Key is required and must be at most 100 characters.", false);
+    }
+
+    public static void ValidateLanguage(EmailTemplate template)
+    {
+        if (string.IsNullOrWhiteSpace(template.LanguageCode) || template.LanguageCode.Length > 10)
+            throw new EmailTemplateWriteException("Language code is required and must be at most 10 characters.", false);
+        if (string.IsNullOrWhiteSpace(template.Subject) || string.IsNullOrWhiteSpace(template.HtmlBody) || string.IsNullOrWhiteSpace(template.TextBody))
+            throw new EmailTemplateWriteException("Every language needs a subject, HTML body, and text body.", false);
+    }
+
+    public static void ValidateDefinition(EmailTemplateDefinition definition)
+    {
+        ValidateIdentity(definition.ServiceName, definition.Key);
+        ValidateVariables(definition.Variables);
+        foreach (var language in definition.Languages)
+            ValidateLanguage(language);
+        var codes = definition.Languages.Select(t => t.LanguageCode);
+        if (codes.Distinct(StringComparer.Ordinal).Count() != definition.Languages.Count)
+            throw new EmailTemplateWriteException("Language codes must be unique within a template.", false);
+    }
+}
@@ -0,0 +1,6 @@
+namespace HrynCo.NotificationService.DAL.Abstract.Templates;
+
+public sealed class EmailTemplateWriteException(string message, bool isConflict = true) : Exception(message)
+{
+    public bool IsConflict { get; } = isConflict;
+}
@@ -0,0 +1,9 @@
+namespace HrynCo.NotificationService.DAL.Abstract.Templates;
+
+public sealed class NotificationServiceInfo
+{
+    public Guid Id { get; set; }
+    public required string Name { get; set; }
+    public Guid Revision { get; set; }
+    public IReadOnlyList<ServiceLanguageInfo> Languages { get; set; } = [];
+}
@@ -0,0 +1,8 @@
+namespace HrynCo.NotificationService.DAL.Abstract.Templates;
+
+public sealed class ServiceLanguageInfo
+{
+    public Guid Id { get; set; }
+    public required string Code { get; set; }
+    public int VersionCount { get; set; }
+}
@@ -0,0 +1,29 @@
+using HrynCo.NotificationService.DAL.EF.Entities;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+
+namespace HrynCo.NotificationService.DAL.EF.Configurations;
+
+internal sealed class EmailTemplateDefinitionEntityConfiguration : IEntityTypeConfiguration<EmailTemplateDefinitionEntity>
+{
+    public void Configure(EntityTypeBuilder<EmailTemplateDefinitionEntity> builder)
+    {
+        builder.ToTable("email_template_definitions");
+        builder.HasKey(x => x.Id);
+        builder.Property(x => x.Id).HasColumnName("id");
+        builder.Property(x => x.ServiceId).HasColumnName("service_id");
+        builder.Property(x => x.Key).HasColumnName("key").HasMaxLength(100).IsRequired();
+        builder.Property(x => x.Revision).HasColumnName("revision").IsConcurrencyToken();
+        builder.HasIndex(x => new { x.ServiceId, x.Key }).IsUnique();
+        builder.HasAlternateKey(x => new { x.Id, x.ServiceId });
+        builder.HasOne(x => x.Service).WithMany().HasForeignKey(x => x.ServiceId).OnDelete(DeleteBehavior.Restrict);
+        builder.Property(x => x.Created).HasColumnName("created");
+        builder.Property(x => x.Updated).HasColumnName("updated");
+        builder.OwnsMany(x => x.Variables, v =>
+        {
+            v.ToJson("variables");
+            v.Property(x => x.Name).HasJsonPropertyName("name");
+            v.Property(x => x.Required).HasJsonPropertyName("required");
+        });
+    }
+}
@@ -4,53 +4,27 @@ using Microsoft.EntityFrameworkCore.Metadata.Builders;

 namespace HrynCo.NotificationService.DAL.EF.Configurations;

-internal class EmailTemplateEntityConfiguration : IEntityTypeConfiguration<EmailTemplateEntity>
+internal sealed class EmailTemplateEntityConfiguration : IEntityTypeConfiguration<EmailTemplateEntity>
 {
    public void Configure(EntityTypeBuilder<EmailTemplateEntity> builder)
    {
        builder.ToTable("email_templates");
-
        builder.HasKey(x => x.Id);
        builder.Property(x => x.Id).HasColumnName("id");
-
-        builder.Property(x => x.ServiceName)
-            .HasColumnName("service_name")
-            .IsRequired()
-            .HasMaxLength(100);
-
-        builder.Property(x => x.Key)
-            .HasColumnName("key")
-            .IsRequired()
-            .HasMaxLength(100);
-
-        builder.Property(x => x.LanguageCode)
-            .HasColumnName("language_code")
-            .IsRequired()
-            .HasMaxLength(10);
-
-        builder.HasIndex(x => new { x.ServiceName, x.Key, x.LanguageCode })
-            .IsUnique();
-
-        builder.Property(x => x.Subject)
-            .HasColumnName("subject")
-            .IsRequired();
-
-        builder.Property(x => x.HtmlBody)
-            .HasColumnName("html_body")
-            .IsRequired();
-
-        builder.Property(x => x.TextBody)
-            .HasColumnName("text_body")
-            .IsRequired();
-
+        builder.Property(x => x.DefinitionId).HasColumnName("definition_id");
+        builder.Property(x => x.ServiceId).HasColumnName("service_id");
+        builder.Property(x => x.ServiceLanguageId).HasColumnName("service_language_id");
+        builder.HasIndex(x => new { x.DefinitionId, x.ServiceLanguageId }).IsUnique();
+        builder.HasOne(x => x.Definition).WithMany(x => x.Languages)
+            .HasForeignKey(x => new { x.DefinitionId, x.ServiceId })
+            .HasPrincipalKey(x => new { x.Id, x.ServiceId }).OnDelete(DeleteBehavior.Cascade);
+        builder.HasOne(x => x.ServiceLanguage).WithMany()
+            .HasForeignKey(x => new { x.ServiceLanguageId, x.ServiceId })
+            .HasPrincipalKey(x => new { x.Id, x.ServiceId }).OnDelete(DeleteBehavior.Restrict);
+        builder.Property(x => x.Subject).HasColumnName("subject").IsRequired();
+        builder.Property(x => x.HtmlBody).HasColumnName("html_body").IsRequired();
+        builder.Property(x => x.TextBody).HasColumnName("text_body").IsRequired();
        builder.Property(x => x.Created).HasColumnName("created");
        builder.Property(x => x.Updated).HasColumnName("updated");
-
-        builder.OwnsMany(x => x.Variables, v =>
-        {
-            v.ToJson("variables");
-            v.Property(x => x.Name).HasJsonPropertyName("name");
-            v.Property(x => x.Required).HasJsonPropertyName("required");
-        });
    }
 }
@@ -0,0 +1,20 @@
+using HrynCo.NotificationService.DAL.EF.Entities;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+
+namespace HrynCo.NotificationService.DAL.EF.Configurations;
+
+internal sealed class ServiceEntityConfiguration : IEntityTypeConfiguration<ServiceEntity>
+{
+    public void Configure(EntityTypeBuilder<ServiceEntity> builder)
+    {
+        builder.ToTable("services");
+        builder.HasKey(x => x.Id);
+        builder.Property(x => x.Id).HasColumnName("id");
+        builder.Property(x => x.Name).HasColumnName("name").HasMaxLength(100).IsRequired();
+        builder.HasIndex(x => x.Name).IsUnique();
+        builder.Property(x => x.Revision).HasColumnName("revision").IsConcurrencyToken();
+        builder.Property(x => x.Created).HasColumnName("created");
+        builder.Property(x => x.Updated).HasColumnName("updated");
+    }
+}
@@ -0,0 +1,22 @@
+using HrynCo.NotificationService.DAL.EF.Entities;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+
+namespace HrynCo.NotificationService.DAL.EF.Configurations;
+
+internal sealed class ServiceLanguageEntityConfiguration : IEntityTypeConfiguration<ServiceLanguageEntity>
+{
+    public void Configure(EntityTypeBuilder<ServiceLanguageEntity> builder)
+    {
+        builder.ToTable("service_languages");
+        builder.HasKey(x => x.Id);
+        builder.Property(x => x.Id).HasColumnName("id");
+        builder.Property(x => x.ServiceId).HasColumnName("service_id");
+        builder.Property(x => x.Code).HasColumnName("code").HasMaxLength(10).IsRequired();
+        builder.HasIndex(x => new { x.ServiceId, x.Code }).IsUnique();
+        builder.HasAlternateKey(x => new { x.Id, x.ServiceId });
+        builder.HasOne(x => x.Service).WithMany(x => x.Languages).HasForeignKey(x => x.ServiceId).OnDelete(DeleteBehavior.Restrict);
+        builder.Property(x => x.Created).HasColumnName("created");
+        builder.Property(x => x.Updated).HasColumnName("updated");
+    }
+}
@@ -1,45 +0,0 @@
-using System.Linq.Expressions;
-using Microsoft.EntityFrameworkCore;
-
-namespace HrynCo.NotificationService.DAL.EF.Core;
-
-internal abstract class EfRepository<TEntity>
-    where TEntity : class
-{
-    protected NotificationDbContext DbContext { get; }
-    protected DbSet<TEntity> DbSet { get; }
-
-    protected EfRepository(NotificationDbContext dbContext)
-    {
-        DbContext = dbContext;
-        DbSet = dbContext.Set<TEntity>();
-    }
-
-    protected async Task AddAsync(TEntity entity, CancellationToken ct = default)
-    {
-        await DbSet.AddAsync(entity, ct);
-    }
-
-    protected async Task AddRangeAsync(IEnumerable<TEntity> entities, CancellationToken ct = default)
-    {
-        await DbSet.AddRangeAsync(entities, ct);
-    }
-
-    protected void Update(TEntity entity)
-    {
-        DbSet.Update(entity);
-    }
-
-    protected void Delete(TEntity entity)
-    {
-        DbSet.Remove(entity);
-    }
-
-    protected void DeleteRange(IEnumerable<TEntity> entities)
-    {
-        DbSet.RemoveRange(entities);
-    }
-
-    protected Task<bool> ExistsAsync(Expression<Func<TEntity, bool>> predicate, CancellationToken ct = default) =>
-        DbSet.AnyAsync(predicate, ct);
-}
@@ -1,29 +0,0 @@
-using HrynCo.NotificationService.DAL.Abstract;
-using Microsoft.EntityFrameworkCore.Storage;
-
-namespace HrynCo.NotificationService.DAL.EF.Core;
-
-internal sealed class EfTransactionAdapter : ITransaction
-{
-    private readonly IDbContextTransaction _transaction;
-
-    internal EfTransactionAdapter(IDbContextTransaction transaction)
-    {
-        _transaction = transaction;
-    }
-
-    public Task CommitAsync(CancellationToken cancellationToken = default)
-    {
-        return _transaction.CommitAsync(cancellationToken);
-    }
-
-    public Task RollbackAsync(CancellationToken cancellationToken = default)
-    {
-        return _transaction.RollbackAsync(cancellationToken);
-    }
-
-    public ValueTask DisposeAsync()
-    {
-        return _transaction.DisposeAsync();
-    }
-}
@@ -1,105 +0,0 @@
-using HrynCo.NotificationService.DAL.Abstract;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Storage;
-
-namespace HrynCo.NotificationService.DAL.EF.Core;
-
-internal abstract class EfUnitOfWork<TDbContext> : IUnitOfWork
-    where TDbContext : DbContext
-{
-    private readonly TDbContext _context;
-    private EfTransactionAdapter? _currentTransaction;
-
-    protected EfUnitOfWork(TDbContext context)
-    {
-        _context = context;
-    }
-
-    public Task SaveChangesAsync(CancellationToken cancellationToken = default)
-    {
-        return _context.SaveChangesAsync(cancellationToken);
-    }
-
-    public async Task<ITransaction> BeginTransactionAsync(CancellationToken cancellationToken = default)
-    {
-        if (_currentTransaction != null)
-        {
-            return _currentTransaction;
-        }
-
-        IDbContextTransaction tx = await _context.Database.BeginTransactionAsync(cancellationToken);
-        _currentTransaction = new EfTransactionAdapter(tx);
-        return _currentTransaction;
-    }
-
-    public ITransaction? GetCurrentTransaction()
-    {
-        return _currentTransaction;
-    }
-
-    public async Task ExecuteInTransactionAsync(Func<Task> action)
-    {
-        ITransaction? existing = GetCurrentTransaction();
-        bool ownsTransaction = existing is null;
-        ITransaction tx = existing ?? await BeginTransactionAsync();
-
-        try
-        {
-            await action();
-            if (ownsTransaction)
-            {
-                await tx.CommitAsync();
-            }
-        }
-        catch
-        {
-            if (ownsTransaction)
-            {
-                await tx.RollbackAsync();
-            }
-
-            throw;
-        }
-        finally
-        {
-            if (ownsTransaction)
-            {
-                await tx.DisposeAsync();
-            }
-        }
-    }
-
-    public async Task<TResult> ExecuteInTransactionAsync<TResult>(Func<Task<TResult>> action)
-    {
-        ITransaction? existing = GetCurrentTransaction();
-        bool ownsTransaction = existing is null;
-        ITransaction tx = existing ?? await BeginTransactionAsync();
-
-        try
-        {
-            TResult result = await action();
-            if (ownsTransaction)
-            {
-                await tx.CommitAsync();
-            }
-
-            return result;
-        }
-        catch
-        {
-            if (ownsTransaction)
-            {
-                await tx.RollbackAsync();
-            }
-
-            throw;
-        }
-        finally
-        {
-            if (ownsTransaction)
-            {
-                await tx.DisposeAsync();
-            }
-        }
-    }
-}
@@ -0,0 +1,20 @@
+namespace HrynCo.NotificationService.DAL.EF.Core;
+
+using HrynCo.DAL.Abstract.Entities;
+using HrynCo.DAL.EF.Core;
+
+public abstract class NotificationBaseRepository<TEntity>
+    : BaseRepository<NotificationEfRepository<TEntity>, NotificationDbContext, TEntity, Guid> where TEntity : Entity
+{
+    protected NotificationBaseRepository(NotificationDbContext dbContext)
+    {
+        DbContext = dbContext;
+    }
+
+    private NotificationDbContext DbContext { get; set; }
+
+    protected override NotificationEfRepository<TEntity> CreateEfRepository()
+    {
+        return new NotificationEfRepository<TEntity>(DbContext);
+    }
+}
@@ -0,0 +1,13 @@
+namespace HrynCo.NotificationService.DAL.EF.Core;
+
+using HrynCo.DAL.Abstract.Entities;
+using HrynCo.DAL.EF.Core;
+
+public class NotificationEfRepository<TEntity> : BaseEfRepository<NotificationDbContext, TEntity, Guid>
+    where TEntity : class, IEntity<Guid>
+{
+    public NotificationEfRepository(NotificationDbContext dbContext) :
+        base(dbContext)
+    {
+    }
+}
@@ -1,8 +0,0 @@
-namespace HrynCo.NotificationService.DAL.EF.Core;
-
-internal sealed class UnitOfWork : EfUnitOfWork<NotificationDbContext>
-{
-    public UnitOfWork(NotificationDbContext context) : base(context)
-    {
-    }
-}
@@ -1,4 +1,4 @@
-using HrynCo.NotificationService.DAL.Abstract.Entities;
+using HrynCo.DAL.Abstract.Entities;
 using HrynCo.NotificationService.DAL.Abstract.Providers;

 namespace HrynCo.NotificationService.DAL.EF.Entities;
@@ -1,4 +1,4 @@
-using HrynCo.NotificationService.DAL.Abstract.Entities;
+using HrynCo.DAL.Abstract.Entities;

 namespace HrynCo.NotificationService.DAL.EF.Entities;

@@ -0,0 +1,13 @@
+using HrynCo.DAL.Abstract.Entities;
+
+namespace HrynCo.NotificationService.DAL.EF.Entities;
+
+internal sealed class EmailTemplateDefinitionEntity : Entity
+{
+    public Guid ServiceId { get; set; }
+    public ServiceEntity Service { get; set; } = null!;
+    public required string Key { get; set; }
+    public Guid Revision { get; set; } = Guid.NewGuid();
+    public List<EmailTemplateVariableData> Variables { get; set; } = [];
+    public List<EmailTemplateEntity> Languages { get; set; } = [];
+}
@@ -1,20 +1,15 @@
-using HrynCo.NotificationService.DAL.Abstract.Entities;
+using HrynCo.DAL.Abstract.Entities;

 namespace HrynCo.NotificationService.DAL.EF.Entities;

 internal class EmailTemplateEntity : Entity
 {
-    public required string ServiceName { get; set; }
-    public required string Key { get; set; }
-    public required string LanguageCode { get; set; }
+    public Guid DefinitionId { get; set; }
+    public EmailTemplateDefinitionEntity Definition { get; set; } = null!;
+    public Guid ServiceId { get; set; }
+    public Guid ServiceLanguageId { get; set; }
+    public ServiceLanguageEntity ServiceLanguage { get; set; } = null!;
    public required string Subject { get; set; }
    public required string HtmlBody { get; set; }
    public required string TextBody { get; set; }
-    public List<EmailTemplateVariableData> Variables { get; set; } = [];
-}
-
-internal class EmailTemplateVariableData
-{
-    public required string Name { get; set; }
-    public bool Required { get; set; }
 }
@@ -0,0 +1,7 @@
+namespace HrynCo.NotificationService.DAL.EF.Entities;
+
+internal sealed class EmailTemplateVariableData
+{
+    public required string Name { get; set; }
+    public bool Required { get; set; }
+}
@@ -0,0 +1,10 @@
+using HrynCo.DAL.Abstract.Entities;
+
+namespace HrynCo.NotificationService.DAL.EF.Entities;
+
+internal sealed class ServiceEntity : Entity
+{
+    public required string Name { get; set; }
+    public Guid Revision { get; set; } = Guid.NewGuid();
+    public List<ServiceLanguageEntity> Languages { get; set; } = [];
+}
@@ -0,0 +1,10 @@
+using HrynCo.DAL.Abstract.Entities;
+
+namespace HrynCo.NotificationService.DAL.EF.Entities;
+
+internal sealed class ServiceLanguageEntity : Entity
+{
+    public Guid ServiceId { get; set; }
+    public ServiceEntity Service { get; set; } = null!;
+    public required string Code { get; set; }
+}
@@ -5,7 +5,7 @@
  </ItemGroup>

  <ItemGroup>
-    <PackageReference Include="Microsoft.EntityFrameworkCore" />
+    <PackageReference Include="HrynCo.DAL.EF" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Design">
      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
      <PrivateAssets>all</PrivateAssets>
@@ -0,0 +1,225 @@
+// <auto-generated />
+using System;
+using HrynCo.NotificationService.DAL.EF;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace HrynCo.NotificationService.DAL.EF.Migrations
+{
+    [DbContext(typeof(NotificationDbContext))]
+    [Migration("20260502154249_PendingChanges")]
+    partial class PendingChanges
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "9.0.5")
+                .HasAnnotation("Relational:MaxIdentifierLength", 63);
+
+            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelEntity", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<int?>("DailyLimit")
+                        .HasColumnType("integer")
+                        .HasColumnName("daily_limit");
+
+                    b.Property<int>("EmailChannelType")
+                        .HasColumnType("integer")
+                        .HasColumnName("provider_type");
+
+                    b.Property<bool>("IsActive")
+                        .HasColumnType("boolean")
+                        .HasColumnName("is_active");
+
+                    b.Property<int?>("MonthlyLimit")
+                        .HasColumnType("integer")
+                        .HasColumnName("monthly_limit");
+
+                    b.Property<int>("Priority")
+                        .HasColumnType("integer")
+                        .HasColumnName("priority");
+
+                    b.Property<string>("ServiceName")
+                        .IsRequired()
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)")
+                        .HasColumnName("service_name");
+
+                    b.Property<string>("SettingsJson")
+                        .IsRequired()
+                        .HasColumnType("jsonb")
+                        .HasColumnName("settings");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.Property<int>("WarnThresholdPercent")
+                        .HasColumnType("integer")
+                        .HasColumnName("warn_threshold_percent");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ServiceName", "Priority");
+
+                    b.ToTable("email_channels", (string)null);
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelUsageEntity", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<DateOnly>("Date")
+                        .HasColumnType("date")
+                        .HasColumnName("date");
+
+                    b.Property<Guid>("ProviderId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("provider_id");
+
+                    b.Property<int>("SentCount")
+                        .HasColumnType("integer")
+                        .HasColumnName("sent_count");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ProviderId", "Date")
+                        .IsUnique();
+
+                    b.ToTable("email_channel_usage", (string)null);
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateEntity", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<string>("HtmlBody")
+                        .IsRequired()
+                        .HasColumnType("text")
+                        .HasColumnName("html_body");
+
+                    b.Property<string>("Key")
+                        .IsRequired()
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)")
+                        .HasColumnName("key");
+
+                    b.Property<string>("LanguageCode")
+                        .IsRequired()
+                        .HasMaxLength(10)
+                        .HasColumnType("character varying(10)")
+                        .HasColumnName("language_code");
+
+                    b.Property<string>("ServiceName")
+                        .IsRequired()
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)")
+                        .HasColumnName("service_name");
+
+                    b.Property<string>("Subject")
+                        .IsRequired()
+                        .HasColumnType("text")
+                        .HasColumnName("subject");
+
+                    b.Property<string>("TextBody")
+                        .IsRequired()
+                        .HasColumnType("text")
+                        .HasColumnName("text_body");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ServiceName", "Key", "LanguageCode")
+                        .IsUnique();
+
+                    b.ToTable("email_templates", (string)null);
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelUsageEntity", b =>
+                {
+                    b.HasOne("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelEntity", null)
+                        .WithMany("UsageRecords")
+                        .HasForeignKey("ProviderId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateEntity", b =>
+                {
+                    b.OwnsMany("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateVariableData", "Variables", b1 =>
+                        {
+                            b1.Property<Guid>("EmailTemplateEntityId")
+                                .HasColumnType("uuid");
+
+                            b1.Property<int>("__synthesizedOrdinal")
+                                .ValueGeneratedOnAdd()
+                                .HasColumnType("integer");
+
+                            b1.Property<string>("Name")
+                                .IsRequired()
+                                .HasColumnType("text")
+                                .HasAnnotation("Relational:JsonPropertyName", "name");
+
+                            b1.Property<bool>("Required")
+                                .HasColumnType("boolean")
+                                .HasAnnotation("Relational:JsonPropertyName", "required");
+
+                            b1.HasKey("EmailTemplateEntityId", "__synthesizedOrdinal");
+
+                            b1.ToTable("email_templates");
+
+                            b1.ToJson("variables");
+
+                            b1.WithOwner()
+                                .HasForeignKey("EmailTemplateEntityId");
+                        });
+
+                    b.Navigation("Variables");
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelEntity", b =>
+                {
+                    b.Navigation("UsageRecords");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
@@ -0,0 +1,30 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace HrynCo.NotificationService.DAL.EF.Migrations
+{
+    /// <inheritdoc />
+    public partial class PendingChanges : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddForeignKey(
+                name: "FK_email_channel_usage_email_channels_provider_id",
+                table: "email_channel_usage",
+                column: "provider_id",
+                principalTable: "email_channels",
+                principalColumn: "id",
+                onDelete: ReferentialAction.Cascade);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropForeignKey(
+                name: "FK_email_channel_usage_email_channels_provider_id",
+                table: "email_channel_usage");
+        }
+    }
+}
@@ -0,0 +1,376 @@
+// <auto-generated />
+using System;
+using HrynCo.NotificationService.DAL.EF;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace HrynCo.NotificationService.DAL.EF.Migrations
+{
+    [DbContext(typeof(NotificationDbContext))]
+    [Migration("20261017072410_EmailTemplateLocalizations")]
+    partial class EmailTemplateLocalizations
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "10.0.7")
+                .HasAnnotation("Relational:MaxIdentifierLength", 63);
+
+            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelEntity", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<int?>("DailyLimit")
+                        .HasColumnType("integer")
+                        .HasColumnName("daily_limit");
+
+                    b.Property<int>("EmailChannelType")
+                        .HasColumnType("integer")
+                        .HasColumnName("provider_type");
+
+                    b.Property<bool>("IsActive")
+                        .HasColumnType("boolean")
+                        .HasColumnName("is_active");
+
+                    b.Property<int?>("MonthlyLimit")
+                        .HasColumnType("integer")
+                        .HasColumnName("monthly_limit");
+
+                    b.Property<int>("Priority")
+                        .HasColumnType("integer")
+                        .HasColumnName("priority");
+
+                    b.Property<string>("ServiceName")
+                        .IsRequired()
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)")
+                        .HasColumnName("service_name");
+
+                    b.Property<string>("SettingsJson")
+                        .IsRequired()
+                        .HasColumnType("jsonb")
+                        .HasColumnName("settings");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.Property<int>("WarnThresholdPercent")
+                        .HasColumnType("integer")
+                        .HasColumnName("warn_threshold_percent");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ServiceName", "Priority");
+
+                    b.ToTable("email_channels", (string)null);
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelUsageEntity", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<DateOnly>("Date")
+                        .HasColumnType("date")
+                        .HasColumnName("date");
+
+                    b.Property<Guid>("ProviderId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("provider_id");
+
+                    b.Property<int>("SentCount")
+                        .HasColumnType("integer")
+                        .HasColumnName("sent_count");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ProviderId", "Date")
+                        .IsUnique();
+
+                    b.ToTable("email_channel_usage", (string)null);
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateDefinitionEntity", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<string>("Key")
+                        .IsRequired()
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)")
+                        .HasColumnName("key");
+
+                    b.Property<Guid>("Revision")
+                        .IsConcurrencyToken()
+                        .HasColumnType("uuid")
+                        .HasColumnName("revision");
+
+                    b.Property<Guid>("ServiceId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("service_id");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ServiceId", "Key")
+                        .IsUnique();
+
+                    b.ToTable("email_template_definitions", (string)null);
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateEntity", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<Guid>("DefinitionId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("definition_id");
+
+                    b.Property<string>("HtmlBody")
+                        .IsRequired()
+                        .HasColumnType("text")
+                        .HasColumnName("html_body");
+
+                    b.Property<Guid>("ServiceId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("service_id");
+
+                    b.Property<Guid>("ServiceLanguageId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("service_language_id");
+
+                    b.Property<string>("Subject")
+                        .IsRequired()
+                        .HasColumnType("text")
+                        .HasColumnName("subject");
+
+                    b.Property<string>("TextBody")
+                        .IsRequired()
+                        .HasColumnType("text")
+                        .HasColumnName("text_body");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("DefinitionId", "ServiceId");
+
+                    b.HasIndex("DefinitionId", "ServiceLanguageId")
+                        .IsUnique();
+
+                    b.HasIndex("ServiceLanguageId", "ServiceId");
+
+                    b.ToTable("email_templates", (string)null);
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.ServiceEntity", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)")
+                        .HasColumnName("name");
+
+                    b.Property<Guid>("Revision")
+                        .IsConcurrencyToken()
+                        .HasColumnType("uuid")
+                        .HasColumnName("revision");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("Name")
+                        .IsUnique();
+
+                    b.ToTable("services", (string)null);
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.ServiceLanguageEntity", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<string>("Code")
+                        .IsRequired()
+                        .HasMaxLength(10)
+                        .HasColumnType("character varying(10)")
+                        .HasColumnName("code");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<Guid>("ServiceId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("service_id");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ServiceId", "Code")
+                        .IsUnique();
+
+                    b.ToTable("service_languages", (string)null);
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelUsageEntity", b =>
+                {
+                    b.HasOne("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelEntity", null)
+                        .WithMany("UsageRecords")
+                        .HasForeignKey("ProviderId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateDefinitionEntity", b =>
+                {
+                    b.HasOne("HrynCo.NotificationService.DAL.EF.Entities.ServiceEntity", "Service")
+                        .WithMany()
+                        .HasForeignKey("ServiceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.OwnsMany("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateVariableData", "Variables", b1 =>
+                        {
+                            b1.Property<Guid>("EmailTemplateDefinitionEntityId");
+
+                            b1.Property<int>("__synthesizedOrdinal")
+                                .ValueGeneratedOnAdd();
+
+                            b1.Property<string>("Name")
+                                .IsRequired()
+                                .HasJsonPropertyName("name");
+
+                            b1.Property<bool>("Required")
+                                .HasJsonPropertyName("required");
+
+                            b1.HasKey("EmailTemplateDefinitionEntityId", "__synthesizedOrdinal");
+
+                            b1.ToTable("email_template_definitions");
+
+                            b1
+                                .ToJson("variables")
+                                .HasColumnType("jsonb");
+
+                            b1.WithOwner()
+                                .HasForeignKey("EmailTemplateDefinitionEntityId");
+                        });
+
+                    b.Navigation("Service");
+
+                    b.Navigation("Variables");
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateEntity", b =>
+                {
+                    b.HasOne("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateDefinitionEntity", "Definition")
+                        .WithMany("Languages")
+                        .HasForeignKey("DefinitionId", "ServiceId")
+                        .HasPrincipalKey("Id", "ServiceId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("HrynCo.NotificationService.DAL.EF.Entities.ServiceLanguageEntity", "ServiceLanguage")
+                        .WithMany()
+                        .HasForeignKey("ServiceLanguageId", "ServiceId")
+                        .HasPrincipalKey("Id", "ServiceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.Navigation("Definition");
+
+                    b.Navigation("ServiceLanguage");
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.ServiceLanguageEntity", b =>
+                {
+                    b.HasOne("HrynCo.NotificationService.DAL.EF.Entities.ServiceEntity", "Service")
+                        .WithMany("Languages")
+                        .HasForeignKey("ServiceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.Navigation("Service");
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelEntity", b =>
+                {
+                    b.Navigation("UsageRecords");
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateDefinitionEntity", b =>
+                {
+                    b.Navigation("Languages");
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.ServiceEntity", b =>
+                {
+                    b.Navigation("Languages");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
@@ -0,0 +1,284 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace HrynCo.NotificationService.DAL.EF.Migrations;
+
+public partial class EmailTemplateLocalizations : Migration
+{
+    protected override void Up(MigrationBuilder migrationBuilder)
+    {
+        migrationBuilder.Sql(SourceLayoutGuard());
+        migrationBuilder.Sql("DO $upgrade$ BEGIN IF (SELECT layout FROM it1601_migration_origin) = 'flat' THEN\n"
+            + FlatUpgrade() + "\nELSE\n" + InterimUpgrade() + "\nEND IF; END $upgrade$;");
+    }
+
+    protected override void Down(MigrationBuilder migrationBuilder)
+    {
+        migrationBuilder.Sql("""
+            LOCK TABLE email_templates IN ACCESS EXCLUSIVE MODE;
+            DO $$ BEGIN
+                IF EXISTS (SELECT 1 FROM "__EFMigrationsHistory" WHERE "MigrationId" = '20261017070315_EmailTemplateLocalizations') THEN
+                    RAISE EXCEPTION 'Cannot downgrade an interim-origin database to the flat legacy model. Restore a verified backup instead.';
+                END IF;
+                IF EXISTS (SELECT 1 FROM email_template_definitions d WHERE NOT EXISTS (SELECT 1 FROM email_templates t WHERE t.definition_id = d.id))
+                   OR EXISTS (SELECT 1 FROM service_languages l WHERE NOT EXISTS (SELECT 1 FROM email_templates t WHERE t.service_language_id = l.id))
+                   OR EXISTS (SELECT 1 FROM services s WHERE NOT EXISTS (SELECT 1 FROM email_templates t WHERE t.service_id = s.id)) THEN
+                    RAISE EXCEPTION 'Cannot downgrade catalog-only data or empty definitions to the legacy model. Restore a verified backup instead.';
+                END IF;
+            END $$;
+            ALTER TABLE email_templates ADD COLUMN service_name varchar(100), ADD COLUMN key varchar(100),
+                ADD COLUMN language_code varchar(10), ADD COLUMN variables jsonb;
+            UPDATE email_templates t SET service_name = s.name, key = d.key, variables = d.variables, language_code = l.code
+                FROM email_template_definitions d JOIN services s ON s.id = d.service_id
+                    JOIN service_languages l ON l.service_id = s.id
+                WHERE d.id = t.definition_id AND l.id = t.service_language_id;
+            ALTER TABLE email_templates ALTER COLUMN service_name SET NOT NULL, ALTER COLUMN key SET NOT NULL, ALTER COLUMN language_code SET NOT NULL;
+            ALTER TABLE email_templates DROP COLUMN definition_id, DROP COLUMN service_id, DROP COLUMN service_language_id;
+            DROP TABLE email_template_definitions;
+            DROP TABLE service_languages;
+            DROP TABLE services;
+            CREATE UNIQUE INDEX "IX_email_templates_service_name_key_language_code" ON email_templates(service_name, key, language_code);
+            """);
+    }
+
+    private static string FlatUpgrade() => """
+            DO $audit$
+            DECLARE row_record record;
+            BEGIN
+                FOR row_record IN SELECT id, service_name, key, language_code, variables FROM email_templates LOOP
+                    IF btrim(row_record.service_name) = '' OR btrim(row_record.key) = ''
+                       OR btrim(row_record.language_code) = '' OR row_record.variables IS NULL
+                       OR jsonb_typeof(row_record.variables) <> 'array' THEN
+                        RAISE EXCEPTION 'Invalid template identity or variables array: service=%, key=%, language=%, id=%',
+                            row_record.service_name, row_record.key, row_record.language_code, row_record.id;
+                    END IF;
+                    IF EXISTS (SELECT 1 FROM jsonb_array_elements(row_record.variables) v
+                        WHERE jsonb_typeof(v) <> 'object'
+                           OR jsonb_typeof(v->'name') IS DISTINCT FROM 'string'
+                           OR btrim(v->>'name') = ''
+                           OR jsonb_typeof(v->'required') IS DISTINCT FROM 'boolean'
+                           OR (v - 'name' - 'required') <> '{}'::jsonb) THEN
+                        RAISE EXCEPTION 'Invalid variables shape: service=%, key=%, language=%, id=%',
+                            row_record.service_name, row_record.key, row_record.language_code, row_record.id;
+                    END IF;
+                    IF EXISTS (SELECT 1 FROM jsonb_array_elements(row_record.variables) v GROUP BY v->>'name' HAVING count(*) > 1) THEN
+                        RAISE EXCEPTION 'Duplicate variable names: service=%, key=%, language=%, id=%',
+                            row_record.service_name, row_record.key, row_record.language_code, row_record.id;
+                    END IF;
+                END LOOP;
+            END $audit$;
+            CREATE TEMP TABLE template_contract_audit ON COMMIT DROP AS
+                SELECT t.*, COALESCE((SELECT jsonb_agg(v ORDER BY v->>'name')
+                    FROM jsonb_array_elements(t.variables) v), '[]'::jsonb) AS contract
+                FROM email_templates t;
+            DO $conflicts$
+            DECLARE conflict_record record;
+            BEGIN
+                SELECT service_name, key, string_agg(language_code || ':' || id::text, ', ' ORDER BY language_code) AS records
+                    INTO conflict_record FROM template_contract_audit
+                    GROUP BY service_name, key HAVING count(DISTINCT contract) > 1 LIMIT 1;
+                IF FOUND THEN
+                    RAISE EXCEPTION 'Conflicting shared variables: service=%, key=%, records=%',
+                        conflict_record.service_name, conflict_record.key, conflict_record.records;
+                END IF;
+            END $conflicts$;
+            CREATE TABLE services (
+                id uuid CONSTRAINT "PK_services" PRIMARY KEY, name varchar(100) NOT NULL, revision uuid NOT NULL,
+                created timestamptz NOT NULL, updated timestamptz NULL);
+            CREATE UNIQUE INDEX "IX_services_name" ON services(name);
+            CREATE TABLE service_languages (
+                id uuid CONSTRAINT "PK_service_languages" PRIMARY KEY, service_id uuid NOT NULL,
+                code varchar(10) NOT NULL, created timestamptz NOT NULL, updated timestamptz NULL,
+                CONSTRAINT "AK_service_languages_id_service_id" UNIQUE(id, service_id),
+                CONSTRAINT "FK_service_languages_services_service_id" FOREIGN KEY(service_id) REFERENCES services(id) ON DELETE RESTRICT);
+            CREATE UNIQUE INDEX "IX_service_languages_service_id_code" ON service_languages(service_id, code);
+            CREATE TABLE email_template_definitions (
+                id uuid CONSTRAINT "PK_email_template_definitions" PRIMARY KEY, service_id uuid NOT NULL,
+                key varchar(100) NOT NULL, revision uuid NOT NULL, variables jsonb NOT NULL,
+                created timestamptz NOT NULL, updated timestamptz NULL,
+                CONSTRAINT "AK_email_template_definitions_id_service_id" UNIQUE(id, service_id),
+                CONSTRAINT "FK_email_template_definitions_services_service_id" FOREIGN KEY(service_id) REFERENCES services(id) ON DELETE RESTRICT);
+            CREATE UNIQUE INDEX "IX_email_template_definitions_service_id_key" ON email_template_definitions(service_id, key);
+            INSERT INTO services(id, name, revision, created)
+                SELECT gen_random_uuid(), service_name, gen_random_uuid(), min(created) FROM email_templates GROUP BY service_name;
+            INSERT INTO service_languages(id, service_id, code, created)
+                SELECT gen_random_uuid(), s.id, t.language_code, min(t.created)
+                FROM email_templates t JOIN services s ON s.name = t.service_name GROUP BY s.id, t.language_code;
+            INSERT INTO email_template_definitions(id, service_id, key, revision, variables, created, updated)
+                SELECT DISTINCT ON (t.service_name, t.key) t.id, s.id, t.key, gen_random_uuid(), t.contract,
+                    min(t.created) OVER (PARTITION BY t.service_name, t.key),
+                    max(t.updated) OVER (PARTITION BY t.service_name, t.key)
+                FROM template_contract_audit t JOIN services s ON s.name = t.service_name
+                ORDER BY t.service_name, t.key, t.id;
+            ALTER TABLE email_templates ADD COLUMN definition_id uuid, ADD COLUMN service_id uuid, ADD COLUMN service_language_id uuid;
+            UPDATE email_templates t SET definition_id = d.id, service_id = s.id, service_language_id = l.id
+                FROM email_template_definitions d JOIN services s ON s.id = d.service_id
+                    JOIN service_languages l ON l.service_id = s.id
+                WHERE t.service_name = s.name AND t.key = d.key AND t.language_code = l.code;
+            ALTER TABLE email_templates ALTER COLUMN definition_id SET NOT NULL,
+                ALTER COLUMN service_id SET NOT NULL, ALTER COLUMN service_language_id SET NOT NULL;
+            ALTER TABLE email_templates ADD CONSTRAINT "FK_email_templates_email_template_definitions_definition_id_se~"
+                FOREIGN KEY (definition_id, service_id) REFERENCES email_template_definitions(id, service_id) ON DELETE CASCADE;
+            ALTER TABLE email_templates ADD CONSTRAINT "FK_email_templates_service_languages_service_language_id_servi~"
+                FOREIGN KEY (service_language_id, service_id) REFERENCES service_languages(id, service_id) ON DELETE RESTRICT;
+            DROP INDEX "IX_email_templates_service_name_key_language_code";
+            ALTER TABLE email_templates DROP COLUMN service_name, DROP COLUMN key, DROP COLUMN variables, DROP COLUMN language_code;
+            CREATE UNIQUE INDEX "IX_email_templates_definition_id_service_language_id" ON email_templates(definition_id, service_language_id);
+            CREATE INDEX "IX_email_templates_definition_id_service_id" ON email_templates(definition_id, service_id);
+            CREATE INDEX "IX_email_templates_service_language_id_service_id" ON email_templates(service_language_id, service_id);
+            """;
+
+    private static string SourceLayoutGuard() => """
+            SET LOCAL search_path = public;
+            DO $layout$
+            DECLARE
+                template_columns text[];
+                service_columns text[];
+                definition_columns text[];
+                source_constraints text[];
+                source_indexes text[];
+                known_interim_history boolean;
+                source_layout text;
+            BEGIN
+                SELECT array_agg(column_name || ':' || udt_name || ':' || coalesce(character_maximum_length::text, '') || ':' || is_nullable ORDER BY column_name)
+                    INTO template_columns FROM information_schema.columns WHERE table_schema = 'public' AND table_name = 'email_templates';
+                SELECT array_agg(column_name || ':' || udt_name || ':' || coalesce(character_maximum_length::text, '') || ':' || is_nullable ORDER BY column_name)
+                    INTO service_columns FROM information_schema.columns WHERE table_schema = 'public' AND table_name = 'services';
+                SELECT array_agg(column_name || ':' || udt_name || ':' || coalesce(character_maximum_length::text, '') || ':' || is_nullable ORDER BY column_name)
+                    INTO definition_columns FROM information_schema.columns WHERE table_schema = 'public' AND table_name = 'email_template_definitions';
+                SELECT EXISTS (SELECT 1 FROM "__EFMigrationsHistory" WHERE "MigrationId" = '20261017070315_EmailTemplateLocalizations') INTO known_interim_history;
+                SELECT array_agg(c.relname || ':' || p.conname || ':' || pg_get_constraintdef(p.oid) ORDER BY c.relname, p.conname)
+                    INTO source_constraints FROM pg_constraint p JOIN pg_class c ON c.oid = p.conrelid
+                    JOIN pg_namespace n ON n.oid = c.relnamespace WHERE n.nspname = 'public'
+                    AND c.relname IN ('services', 'email_template_definitions', 'email_templates');
+                SELECT array_agg(indexdef ORDER BY indexname) INTO source_indexes FROM pg_indexes
+                    WHERE schemaname = 'public' AND tablename IN ('services', 'email_template_definitions', 'email_templates');
+                IF to_regclass('public.service_languages') IS NOT NULL THEN
+                    RAISE EXCEPTION 'Unsupported email-template source layout: service language catalog already exists without the current migration history.';
+                END IF;
+                IF template_columns = ARRAY['created:timestamptz::NO',
+                    'html_body:text::NO',
+                    'id:uuid::NO',
+                    'key:varchar:100:NO',
+                    'language_code:varchar:10:NO',
+                    'service_name:varchar:100:NO',
+                    'subject:text::NO',
+                    'text_body:text::NO',
+                    'updated:timestamptz::YES',
+                    'variables:jsonb::YES']
+                   AND service_columns IS NULL AND definition_columns IS NULL AND NOT known_interim_history
+                   AND source_constraints = ARRAY['email_templates:PK_email_templates:PRIMARY KEY (id)']
+                   AND source_indexes = ARRAY[
+                    'CREATE UNIQUE INDEX "IX_email_templates_service_name_key_language_code" ON public.email_templates USING btree (service_name, key, language_code)',
+                    'CREATE UNIQUE INDEX "PK_email_templates" ON public.email_templates USING btree (id)'] THEN
+                    source_layout := 'flat';
+                ELSIF template_columns = ARRAY['created:timestamptz::NO',
+                    'definition_id:uuid::NO',
+                    'html_body:text::NO',
+                    'id:uuid::NO',
+                    'language_code:varchar:10:NO',
+                    'subject:text::NO',
+                    'text_body:text::NO',
+                    'updated:timestamptz::YES']
+                   AND service_columns = ARRAY['created:timestamptz::NO',
+                    'id:uuid::NO',
+                    'name:varchar:100:NO',
+                    'updated:timestamptz::YES']
+                   AND definition_columns = ARRAY['created:timestamptz::NO',
+                    'id:uuid::NO',
+                    'key:varchar:100:NO',
+                    'revision:uuid::NO',
+                    'service_id:uuid::NO',
+                    'updated:timestamptz::YES',
+                    'variables:jsonb::NO']
+                   AND known_interim_history
+                   AND source_constraints = ARRAY[
+                    'email_template_definitions:email_template_definitions_pkey:PRIMARY KEY (id)',
+                    'email_template_definitions:email_template_definitions_service_id_fkey:FOREIGN KEY (service_id) REFERENCES services(id) ON DELETE RESTRICT',
+                    'email_templates:FK_email_templates_email_template_definitions_definition_id:FOREIGN KEY (definition_id) REFERENCES email_template_definitions(id) ON DELETE CASCADE',
+                    'email_templates:PK_email_templates:PRIMARY KEY (id)',
+                    'services:services_pkey:PRIMARY KEY (id)']
+                   AND source_indexes = ARRAY[
+                    'CREATE UNIQUE INDEX "IX_email_template_definitions_service_id_key" ON public.email_template_definitions USING btree (service_id, key)',
+                    'CREATE UNIQUE INDEX "IX_email_templates_definition_id_language_code" ON public.email_templates USING btree (definition_id, language_code)',
+                    'CREATE UNIQUE INDEX "IX_services_name" ON public.services USING btree (name)',
+                    'CREATE UNIQUE INDEX "PK_email_templates" ON public.email_templates USING btree (id)',
+                    'CREATE UNIQUE INDEX email_template_definitions_pkey ON public.email_template_definitions USING btree (id)',
+                    'CREATE UNIQUE INDEX services_pkey ON public.services USING btree (id)'] THEN
+                    source_layout := 'interim';
+                ELSE
+                    RAISE EXCEPTION 'Unsupported email-template source layout or history. Expected the flat legacy schema or the known 20261017070315 interim schema; no changes were made.';
+                END IF;
+                LOCK TABLE email_templates IN ACCESS EXCLUSIVE MODE;
+                IF source_layout = 'interim' THEN
+                    LOCK TABLE services, email_template_definitions IN ACCESS EXCLUSIVE MODE;
+                END IF;
+                CREATE TEMP TABLE it1601_migration_origin (layout text NOT NULL) ON COMMIT DROP;
+                INSERT INTO it1601_migration_origin VALUES (source_layout);
+            END $layout$;
+            """;
+
+    private static string InterimUpgrade() => """
+            DO $interim_audit$
+            DECLARE row_record record;
+            BEGIN
+                IF EXISTS (SELECT 1 FROM services WHERE btrim(name) = '')
+                   OR EXISTS (SELECT 1 FROM email_template_definitions WHERE btrim(key) = '')
+                   OR EXISTS (SELECT 1 FROM email_templates WHERE btrim(language_code) = '') THEN
+                    RAISE EXCEPTION 'Invalid blank identity in interim email-template data; no changes were made.';
+                END IF;
+                IF EXISTS (SELECT 1 FROM email_template_definitions d LEFT JOIN services s ON s.id = d.service_id WHERE s.id IS NULL)
+                   OR EXISTS (SELECT 1 FROM email_templates t LEFT JOIN email_template_definitions d ON d.id = t.definition_id WHERE d.id IS NULL) THEN
+                    RAISE EXCEPTION 'Invalid orphaned reference in interim email-template data; no changes were made.';
+                END IF;
+                FOR row_record IN SELECT d.id, s.name AS service_name, d.key, d.variables FROM email_template_definitions d JOIN services s ON s.id = d.service_id LOOP
+                    IF row_record.variables IS NULL OR jsonb_typeof(row_record.variables) <> 'array' THEN
+                        RAISE EXCEPTION 'Invalid interim shared variables array: service=%, key=%, definition=%', row_record.service_name, row_record.key, row_record.id;
+                    END IF;
+                    IF EXISTS (SELECT 1 FROM jsonb_array_elements(row_record.variables) v
+                        WHERE jsonb_typeof(v) <> 'object'
+                           OR jsonb_typeof(v->'name') IS DISTINCT FROM 'string'
+                           OR btrim(v->>'name') = ''
+                           OR jsonb_typeof(v->'required') IS DISTINCT FROM 'boolean'
+                           OR (v - 'name' - 'required') <> '{}'::jsonb) THEN
+                        RAISE EXCEPTION 'Invalid interim shared variables shape: service=%, key=%, definition=%', row_record.service_name, row_record.key, row_record.id;
+                    END IF;
+                    IF EXISTS (SELECT 1 FROM jsonb_array_elements(row_record.variables) v GROUP BY v->>'name' HAVING count(*) > 1) THEN
+                        RAISE EXCEPTION 'Duplicate interim shared variable names: service=%, key=%, definition=%', row_record.service_name, row_record.key, row_record.id;
+                    END IF;
+                END LOOP;
+            END $interim_audit$;
+            ALTER TABLE services ADD COLUMN revision uuid;
+            UPDATE services SET revision = gen_random_uuid();
+            ALTER TABLE services ALTER COLUMN revision SET NOT NULL;
+            ALTER TABLE services RENAME CONSTRAINT services_pkey TO "PK_services";
+            ALTER TABLE email_template_definitions RENAME CONSTRAINT email_template_definitions_pkey TO "PK_email_template_definitions";
+            ALTER TABLE email_template_definitions RENAME CONSTRAINT email_template_definitions_service_id_fkey TO "FK_email_template_definitions_services_service_id";
+            ALTER TABLE email_template_definitions ADD CONSTRAINT "AK_email_template_definitions_id_service_id" UNIQUE(id, service_id);
+            CREATE TABLE service_languages (
+                id uuid CONSTRAINT "PK_service_languages" PRIMARY KEY, service_id uuid NOT NULL,
+                code varchar(10) NOT NULL, created timestamptz NOT NULL, updated timestamptz NULL,
+                CONSTRAINT "AK_service_languages_id_service_id" UNIQUE(id, service_id),
+                CONSTRAINT "FK_service_languages_services_service_id" FOREIGN KEY(service_id) REFERENCES services(id) ON DELETE RESTRICT);
+            CREATE UNIQUE INDEX "IX_service_languages_service_id_code" ON service_languages(service_id, code);
+            INSERT INTO service_languages(id, service_id, code, created, updated)
+                SELECT gen_random_uuid(), d.service_id, t.language_code, min(t.created), max(t.updated)
+                FROM email_templates t JOIN email_template_definitions d ON d.id = t.definition_id GROUP BY d.service_id, t.language_code;
+            ALTER TABLE email_templates ADD COLUMN service_id uuid, ADD COLUMN service_language_id uuid;
+            UPDATE email_templates t SET service_id = d.service_id, service_language_id = l.id
+                FROM email_template_definitions d JOIN service_languages l ON l.service_id = d.service_id
+                WHERE t.definition_id = d.id AND t.language_code = l.code;
+            ALTER TABLE email_templates ALTER COLUMN service_id SET NOT NULL, ALTER COLUMN service_language_id SET NOT NULL;
+            ALTER TABLE email_templates ADD CONSTRAINT "FK_email_templates_email_template_definitions_definition_id_se~"
+                FOREIGN KEY (definition_id, service_id) REFERENCES email_template_definitions(id, service_id) ON DELETE CASCADE;
+            ALTER TABLE email_templates ADD CONSTRAINT "FK_email_templates_service_languages_service_language_id_servi~"
+                FOREIGN KEY (service_language_id, service_id) REFERENCES service_languages(id, service_id) ON DELETE RESTRICT;
+            ALTER TABLE email_templates DROP CONSTRAINT "FK_email_templates_email_template_definitions_definition_id";
+            DROP INDEX "IX_email_templates_definition_id_language_code";
+            ALTER TABLE email_templates DROP COLUMN language_code;
+            CREATE UNIQUE INDEX "IX_email_templates_definition_id_service_language_id" ON email_templates(definition_id, service_language_id);
+            CREATE INDEX "IX_email_templates_definition_id_service_id" ON email_templates(definition_id, service_id);
+            CREATE INDEX "IX_email_templates_service_language_id_service_id" ON email_templates(service_language_id, service_id);
+            """;
+}
@@ -17,7 +17,7 @@ namespace HrynCo.NotificationService.DAL.EF.Migrations
        {
 #pragma warning disable 612, 618
            modelBuilder
-                .HasAnnotation("ProductVersion", "9.0.5")
+                .HasAnnotation("ProductVersion", "10.0.7")
                .HasAnnotation("Relational:MaxIdentifierLength", 63);

            NpgsqlModelBuilderExtensions.UseIdentityByDefaultColumns(modelBuilder);
@@ -114,6 +114,44 @@ namespace HrynCo.NotificationService.DAL.EF.Migrations
                    b.ToTable("email_channel_usage", (string)null);
                });

+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateDefinitionEntity", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<string>("Key")
+                        .IsRequired()
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)")
+                        .HasColumnName("key");
+
+                    b.Property<Guid>("Revision")
+                        .IsConcurrencyToken()
+                        .HasColumnType("uuid")
+                        .HasColumnName("revision");
+
+                    b.Property<Guid>("ServiceId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("service_id");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ServiceId", "Key")
+                        .IsUnique();
+
+                    b.ToTable("email_template_definitions", (string)null);
+                });
+
            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateEntity", b =>
                {
                    b.Property<Guid>("Id")
@@ -125,28 +163,22 @@ namespace HrynCo.NotificationService.DAL.EF.Migrations
                        .HasColumnType("timestamp with time zone")
                        .HasColumnName("created");

+                    b.Property<Guid>("DefinitionId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("definition_id");
+
                    b.Property<string>("HtmlBody")
                        .IsRequired()
                        .HasColumnType("text")
                        .HasColumnName("html_body");

-                    b.Property<string>("Key")
-                        .IsRequired()
-                        .HasMaxLength(100)
-                        .HasColumnType("character varying(100)")
-                        .HasColumnName("key");
+                    b.Property<Guid>("ServiceId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("service_id");

-                    b.Property<string>("LanguageCode")
-                        .IsRequired()
-                        .HasMaxLength(10)
-                        .HasColumnType("character varying(10)")
-                        .HasColumnName("language_code");
-
-                    b.Property<string>("ServiceName")
-                        .IsRequired()
-                        .HasMaxLength(100)
-                        .HasColumnType("character varying(100)")
-                        .HasColumnName("service_name");
+                    b.Property<Guid>("ServiceLanguageId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("service_language_id");

                    b.Property<string>("Subject")
                        .IsRequired()
@@ -164,44 +196,177 @@ namespace HrynCo.NotificationService.DAL.EF.Migrations

                    b.HasKey("Id");

-                    b.HasIndex("ServiceName", "Key", "LanguageCode")
+                    b.HasIndex("DefinitionId", "ServiceId");
+
+                    b.HasIndex("DefinitionId", "ServiceLanguageId")
                        .IsUnique();

+                    b.HasIndex("ServiceLanguageId", "ServiceId");
+
                    b.ToTable("email_templates", (string)null);
                });

-            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateEntity", b =>
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.ServiceEntity", b =>
                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasMaxLength(100)
+                        .HasColumnType("character varying(100)")
+                        .HasColumnName("name");
+
+                    b.Property<Guid>("Revision")
+                        .IsConcurrencyToken()
+                        .HasColumnType("uuid")
+                        .HasColumnName("revision");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("Name")
+                        .IsUnique();
+
+                    b.ToTable("services", (string)null);
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.ServiceLanguageEntity", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasColumnName("id");
+
+                    b.Property<string>("Code")
+                        .IsRequired()
+                        .HasMaxLength(10)
+                        .HasColumnType("character varying(10)")
+                        .HasColumnName("code");
+
+                    b.Property<DateTimeOffset>("Created")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("created");
+
+                    b.Property<Guid>("ServiceId")
+                        .HasColumnType("uuid")
+                        .HasColumnName("service_id");
+
+                    b.Property<DateTimeOffset?>("Updated")
+                        .HasColumnType("timestamp with time zone")
+                        .HasColumnName("updated");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("ServiceId", "Code")
+                        .IsUnique();
+
+                    b.ToTable("service_languages", (string)null);
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelUsageEntity", b =>
+                {
+                    b.HasOne("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelEntity", null)
+                        .WithMany("UsageRecords")
+                        .HasForeignKey("ProviderId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateDefinitionEntity", b =>
+                {
+                    b.HasOne("HrynCo.NotificationService.DAL.EF.Entities.ServiceEntity", "Service")
+                        .WithMany()
+                        .HasForeignKey("ServiceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
                    b.OwnsMany("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateVariableData", "Variables", b1 =>
                        {
-                            b1.Property<Guid>("EmailTemplateEntityId")
-                                .HasColumnType("uuid");
+                            b1.Property<Guid>("EmailTemplateDefinitionEntityId");

                            b1.Property<int>("__synthesizedOrdinal")
-                                .ValueGeneratedOnAdd()
-                                .HasColumnType("integer");
+                                .ValueGeneratedOnAdd();

                            b1.Property<string>("Name")
                                .IsRequired()
-                                .HasColumnType("text")
-                                .HasAnnotation("Relational:JsonPropertyName", "name");
+                                .HasJsonPropertyName("name");

                            b1.Property<bool>("Required")
-                                .HasColumnType("boolean")
-                                .HasAnnotation("Relational:JsonPropertyName", "required");
+                                .HasJsonPropertyName("required");

-                            b1.HasKey("EmailTemplateEntityId", "__synthesizedOrdinal");
+                            b1.HasKey("EmailTemplateDefinitionEntityId", "__synthesizedOrdinal");

-                            b1.ToTable("email_templates");
+                            b1.ToTable("email_template_definitions");

-                            b1.ToJson("variables");
+                            b1
+                                .ToJson("variables")
+                                .HasColumnType("jsonb");

                            b1.WithOwner()
-                                .HasForeignKey("EmailTemplateEntityId");
+                                .HasForeignKey("EmailTemplateDefinitionEntityId");
                        });

+                    b.Navigation("Service");
+
                    b.Navigation("Variables");
                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateEntity", b =>
+                {
+                    b.HasOne("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateDefinitionEntity", "Definition")
+                        .WithMany("Languages")
+                        .HasForeignKey("DefinitionId", "ServiceId")
+                        .HasPrincipalKey("Id", "ServiceId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("HrynCo.NotificationService.DAL.EF.Entities.ServiceLanguageEntity", "ServiceLanguage")
+                        .WithMany()
+                        .HasForeignKey("ServiceLanguageId", "ServiceId")
+                        .HasPrincipalKey("Id", "ServiceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.Navigation("Definition");
+
+                    b.Navigation("ServiceLanguage");
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.ServiceLanguageEntity", b =>
+                {
+                    b.HasOne("HrynCo.NotificationService.DAL.EF.Entities.ServiceEntity", "Service")
+                        .WithMany("Languages")
+                        .HasForeignKey("ServiceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.Navigation("Service");
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailChannelEntity", b =>
+                {
+                    b.Navigation("UsageRecords");
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.EmailTemplateDefinitionEntity", b =>
+                {
+                    b.Navigation("Languages");
+                });
+
+            modelBuilder.Entity("HrynCo.NotificationService.DAL.EF.Entities.ServiceEntity", b =>
+                {
+                    b.Navigation("Languages");
+                });
 #pragma warning restore 612, 618
        }
    }
@@ -10,6 +10,9 @@ public class NotificationDbContext : DbContext
    {
    }

+    internal DbSet<ServiceLanguageEntity> ServiceLanguages => Set<ServiceLanguageEntity>();
+    internal DbSet<ServiceEntity> Services => Set<ServiceEntity>();
+    internal DbSet<EmailTemplateDefinitionEntity> TemplateDefinitions => Set<EmailTemplateDefinitionEntity>();
    internal DbSet<EmailTemplateEntity> Templates => Set<EmailTemplateEntity>();
    internal DbSet<EmailChannelEntity> Providers => Set<EmailChannelEntity>();
    internal DbSet<EmailChannelUsageEntity> EmailChannelUsage => Set<EmailChannelUsageEntity>();
@@ -0,0 +1,10 @@
+namespace HrynCo.NotificationService.DAL.EF;
+
+using HrynCo.DAL.EF.Core;
+
+public class NotificationUnitOfWork : EfUnitOfWork<NotificationDbContext>
+{
+    public NotificationUnitOfWork(NotificationDbContext context) : base(context)
+    {
+    }
+}
@@ -1,3 +1,5 @@
+namespace HrynCo.NotificationService.DAL.EF.Repositories;
+
 using System.Text.Json;
 using HrynCo.NotificationService.DAL.Abstract.Providers;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
@@ -5,9 +7,7 @@ using HrynCo.NotificationService.DAL.EF.Core;
 using HrynCo.NotificationService.DAL.EF.Entities;
 using Microsoft.EntityFrameworkCore;

-namespace HrynCo.NotificationService.DAL.EF.Repositories;
-
-internal sealed class EmailChannelRepository : EfRepository<EmailChannelEntity>, IEmailChannelRepository
+internal sealed class EmailChannelRepository : NotificationBaseRepository<EmailChannelEntity>, IEmailChannelRepository
 {
    public EmailChannelRepository(NotificationDbContext dbContext) : base(dbContext)
    {
@@ -15,20 +15,14 @@ internal sealed class EmailChannelRepository : EfRepository<EmailChannelEntity>,

    public async Task<IReadOnlyList<EmailChannel>> GetAllAsync(CancellationToken ct = default)
    {
-        var entities = await DbSet
-            .AsNoTracking()
-            .OrderBy(x => x.ServiceName)
-            .ThenBy(x => x.Priority)
-            .ToListAsync(ct);
+        var entities = await EfRepository.Get().ToListAsync(ct);

        return entities.Select(MapToDomain).ToList();
    }

    public async Task<IReadOnlyList<EmailChannel>> GetByServiceAsync(string serviceName, CancellationToken ct = default)
    {
-        var entities = await DbSet
-            .AsNoTracking()
-            .Where(x => x.ServiceName == serviceName)
+        var entities = await EfRepository.Get(x => x.ServiceName == serviceName)
            .OrderBy(x => x.Priority)
            .ToListAsync(ct);

@@ -38,8 +32,7 @@ internal sealed class EmailChannelRepository : EfRepository<EmailChannelEntity>,
    public async Task<IReadOnlyList<ChannelWithUsage>> GetAllWithUsageSummaryAsync(
        DateOnly today, CancellationToken ct = default)
    {
-        var rows = await DbSet
-            .AsNoTracking()
+        var rows = await EfRepository.Get()
            .OrderBy(c => c.ServiceName)
            .ThenBy(c => c.Priority)
            .Select(c => new
@@ -61,30 +54,24 @@ internal sealed class EmailChannelRepository : EfRepository<EmailChannelEntity>,

    public async Task<EmailChannel?> GetByIdAsync(Guid id, CancellationToken ct = default)
    {
-        EmailChannelEntity? entity = await DbSet.AsNoTracking().FirstOrDefaultAsync(x => x.Id == id, ct);
+        EmailChannelEntity? entity = await EfRepository.Get().AsNoTracking().SingleOrDefaultAsync(c => c.Id == id, ct);
        return entity is null ? null : MapToDomain(entity);
    }

    public Task AddAsync(EmailChannel channel, CancellationToken ct = default)
    {
-        return base.AddAsync(MapToEntity(channel), ct);
+        return EfRepository.AddAsync(MapToEntity(channel));
    }

-    public Task UpdateAsync(EmailChannel channel, CancellationToken ct = default)
+    public async Task UpdateAsync(EmailChannel channel, CancellationToken ct = default)
    {
        EmailChannelEntity entity = MapToEntity(channel);
-        entity.Updated = DateTimeOffset.UtcNow;
-        Update(entity);
-        return Task.CompletedTask;
+        await EfRepository.UpdateAsync(entity);
    }

    public async Task DeleteAsync(EmailChannel channel, CancellationToken ct = default)
    {
-        EmailChannelEntity? entity = await DbSet.FindAsync([channel.Id], ct);
-        if (entity is not null)
-        {
-            Delete(entity);
-        }
+        await EfRepository.DeleteAsync(channel.Id);
    }

    private static EmailChannel MapToDomain(EmailChannelEntity e)
@@ -128,8 +115,8 @@ internal sealed class EmailChannelRepository : EfRepository<EmailChannelEntity>,
        return type switch
        {
            EmailChannelType.Smtp => JsonSerializer.Deserialize<SmtpChannelSettings>(json)
-                                 ?? throw new InvalidOperationException(
-                                     "Failed to deserialize SMTP EmailChannel settings."),
+                                     ?? throw new InvalidOperationException(
+                                         "Failed to deserialize SMTP EmailChannel settings."),
            _ => throw new InvalidOperationException($"Unknown or undefined email channel type: {type}")
        };
    }
@@ -5,7 +5,7 @@ using Microsoft.EntityFrameworkCore;

 namespace HrynCo.NotificationService.DAL.EF.Repositories;

-internal sealed class EmailChannelUsageRepository : EfRepository<EmailChannelUsageEntity>, IEmailChannelUsageRepository
+internal sealed class EmailChannelUsageRepository : NotificationBaseRepository<EmailChannelUsageEntity>, IEmailChannelUsageRepository
 {
    public EmailChannelUsageRepository(NotificationDbContext dbContext) : base(dbContext)
    {
@@ -13,7 +13,8 @@ internal sealed class EmailChannelUsageRepository : EfRepository<EmailChannelUsa

    public async Task<int> GetDailyCountAsync(Guid providerId, DateOnly date, CancellationToken ct = default)
    {
-        EmailChannelUsageEntity? entity = await DbSet
+        EmailChannelUsageEntity? entity = await EfRepository.Get()
+            .AsNoTracking()
            .FirstOrDefaultAsync(x => x.ProviderId == providerId && x.Date == date, ct);

        return entity?.SentCount ?? 0;
@@ -21,7 +22,7 @@ internal sealed class EmailChannelUsageRepository : EfRepository<EmailChannelUsa

    public async Task<int> GetMonthlyCountAsync(Guid providerId, int year, int month, CancellationToken ct = default)
    {
-        return await DbSet
+        return await EfRepository.Get()
            .Where(x => x.ProviderId == providerId
                        && x.Date.Year == year
                        && x.Date.Month == month)
@@ -30,15 +31,16 @@ internal sealed class EmailChannelUsageRepository : EfRepository<EmailChannelUsa

    public async Task IncrementUsageAsync(Guid providerId, DateOnly date, CancellationToken ct = default)
    {
-        EmailChannelUsageEntity? entity = await DbSet
+        EmailChannelUsageEntity? entity = await EfRepository.Get()
+            .AsNoTracking()
            .FirstOrDefaultAsync(x => x.ProviderId == providerId && x.Date == date, ct);

        if (entity is null)
-            await AddAsync(new EmailChannelUsageEntity { ProviderId = providerId, Date = date, SentCount = 1 }, ct);
+            await EfRepository.AddAsync(new EmailChannelUsageEntity { ProviderId = providerId, Date = date, SentCount = 1 });
        else
        {
            entity.SentCount++;
-            Update(entity);
+            await EfRepository.UpdateAsync(entity);
        }
    }
 }
@@ -1,83 +1,324 @@
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.DAL.Abstract.Templates;
-using HrynCo.NotificationService.DAL.EF.Core;
 using HrynCo.NotificationService.DAL.EF.Entities;
 using Microsoft.EntityFrameworkCore;

 namespace HrynCo.NotificationService.DAL.EF.Repositories;

-internal sealed class EmailTemplateRepository : EfRepository<EmailTemplateEntity>, IEmailTemplateRepository
+internal sealed class EmailTemplateRepository(NotificationDbContext db, TemplateMutationRunner mutations)
+    : IEmailTemplateRepository, IEmailTemplateDefinitionRepository
 {
-    public EmailTemplateRepository(NotificationDbContext dbContext) : base(dbContext)
+    private IQueryable<EmailTemplateEntity> Languages => db.Templates
+        .Include(t => t.Definition).ThenInclude(d => d.Service).Include(t => t.ServiceLanguage);
+    private IQueryable<EmailTemplateDefinitionEntity> Definitions => db.TemplateDefinitions
+        .Include(d => d.Service).ThenInclude(s => s.Languages)
+        .Include(d => d.Languages).ThenInclude(t => t.ServiceLanguage);
+
+    public async Task<IReadOnlyList<EmailTemplate>> GetAllAsync(string? serviceName = null, string? key = null, CancellationToken ct = default)
    {
+        var query = Languages.AsNoTracking();
+        if (!string.IsNullOrWhiteSpace(serviceName))
+            query = query.Where(t => t.Definition.Service.Name == serviceName);
+        if (!string.IsNullOrWhiteSpace(key))
+            query = query.Where(t => t.Definition.Key == key);
+        var entities = await query.OrderBy(t => t.Definition.Service.Name).ThenBy(t => t.Definition.Key)
+            .ThenBy(t => t.ServiceLanguage.Code).ToListAsync(ct);
+        return entities.Select(MapLanguage).ToList();
    }

-    public async Task<IReadOnlyList<EmailTemplate>> GetAllAsync(CancellationToken ct = default)
-    {
-        List<EmailTemplateEntity> entities = await DbSet.ToListAsync(ct);
-        return entities.Select(MapToDomain).ToList();
-    }
-
-    public async Task<IReadOnlyList<EmailTemplate>> GetByServiceAsync(string serviceName, CancellationToken ct = default)
-    {
-        List<EmailTemplateEntity> entities = await DbSet
-            .Where(x => x.ServiceName == serviceName)
-            .ToListAsync(ct);
-
-        return entities.Select(MapToDomain).ToList();
-    }
+    public Task<IReadOnlyList<EmailTemplate>> GetByServiceAsync(string serviceName, CancellationToken ct = default) =>
+        GetAllAsync(serviceName, ct: ct);

    public async Task<EmailTemplate?> GetAsync(string serviceName, string key, string languageCode, CancellationToken ct = default)
    {
-        EmailTemplateEntity? entity = await DbSet.FirstOrDefaultAsync(
-            x => x.ServiceName == serviceName && x.Key == key && x.LanguageCode == languageCode, ct);
-
-        return entity is null ? null : MapToDomain(entity);
+        var code = languageCode;
+        var entity = await Languages.AsNoTracking().SingleOrDefaultAsync(t =>
+            t.Definition.Service.Name == serviceName && t.Definition.Key == key && t.ServiceLanguage.Code == code, ct);
+        return entity is null ? null : MapLanguage(entity);
    }

-    public Task AddAsync(EmailTemplate EmailTemplate, CancellationToken ct = default) =>
-        base.AddAsync(MapToEntity(EmailTemplate), ct);
-
-    public Task UpdateAsync(EmailTemplate EmailTemplate, CancellationToken ct = default)
+    public async Task<EmailTemplateDefinition?> GetDefinitionAsync(string serviceName, string key, CancellationToken ct = default)
    {
-        EmailTemplateEntity entity = MapToEntity(EmailTemplate);
+        var entity = await Definitions.AsNoTracking().SingleOrDefaultAsync(d => d.Service.Name == serviceName && d.Key == key, ct);
+        return entity is null ? null : MapDefinition(entity);
+    }
+
+    public async Task<EmailTemplateDefinition?> GetDefinitionAsync(Guid serviceId, string key, CancellationToken ct = default)
+    {
+        var entity = await Definitions.AsNoTracking().SingleOrDefaultAsync(d => d.ServiceId == serviceId && d.Key == key, ct);
+        return entity is null ? null : MapDefinition(entity);
+    }
+
+    public async Task<EmailTemplateDefinition?> UpsertDefinitionAsync(EmailTemplateDefinitionPatch patch, CancellationToken ct = default)
+    {
+        EmailTemplateDefinitionEntity? saved = null;
+        await mutations.ExecuteAsync(async () =>
+        {
+            var service = await db.Services.Include(s => s.Languages).SingleOrDefaultAsync(s => s.Id == patch.ServiceId, ct);
+            if (service is null)
+                return;
+            ValidatePatch(patch, service);
+            var entity = await LoadForUpsertAsync(patch, service, ct);
+            entity.Variables = MapVariables(patch.Variables);
+            var removed = patch.RemoveLanguageCodes.ToHashSet(StringComparer.Ordinal);
+            db.Templates.RemoveRange(entity.Languages.Where(t => removed.Contains(t.ServiceLanguage.Code)));
+            // Omitted translations are retained. Only explicitly supplied content is changed.
+            UpsertLanguages(entity, patch.Translations);
+            Touch(entity);
+            saved = entity;
+        }, ct);
+        return saved is null ? null : MapDefinition(saved);
+    }
+
+    private async Task<EmailTemplateDefinitionEntity> LoadForUpsertAsync(EmailTemplateDefinitionPatch patch, ServiceEntity service, CancellationToken ct)
+    {
+        var entity = await Definitions.SingleOrDefaultAsync(d => d.ServiceId == patch.ServiceId && d.Key == patch.Key, ct);
+        if (patch.Revision is null)
+        {
+            if (entity is not null)
+                throw new EmailTemplateWriteException("A definition with this service and key already exists. Read its revision before updating.");
+            entity = new EmailTemplateDefinitionEntity { Service = service, ServiceId = service.Id, Key = patch.Key, Created = DateTimeOffset.UtcNow };
+            db.TemplateDefinitions.Add(entity);
+            return entity;
+        }
+        if (entity is null || entity.Revision != patch.Revision)
+            throw new EmailTemplateWriteException("The definition is missing or its revision changed. Read it again before updating.");
+        return entity;
+    }
+
+    private static void ValidatePatch(EmailTemplateDefinitionPatch patch, ServiceEntity service)
+    {
+        EmailTemplateValidation.ValidateDefinition(new EmailTemplateDefinition
+        {
+            ServiceId = service.Id, ServiceName = service.Name, Key = patch.Key,
+            Variables = patch.Variables, Languages = patch.Translations
+        });
+        if (patch.Revision == Guid.Empty)
+            throw new EmailTemplateWriteException("Revision must be null for creation or a nonempty revision from the last read for update.", false);
+        var removed = patch.RemoveLanguageCodes;
+        if (removed.Any(string.IsNullOrWhiteSpace) || removed.Distinct(StringComparer.Ordinal).Count() != removed.Count)
+            throw new EmailTemplateWriteException("removeLanguageCodes must contain unique nonblank language codes.", false);
+        var supplied = patch.Translations.Select(t => t.LanguageCode).ToHashSet(StringComparer.Ordinal);
+        if (removed.Any(supplied.Contains))
+            throw new EmailTemplateWriteException("A language cannot be supplied and removed in the same request.", false);
+        var supported = service.Languages.Select(l => l.Code).ToHashSet(StringComparer.Ordinal);
+        if (supplied.Concat(removed).Any(code => !supported.Contains(code)))
+            throw new EmailTemplateWriteException("Every supplied or removed language must exactly match a code in this service's catalog.", false);
+    }
+
+    public async Task<IReadOnlyList<EmailTemplateDefinition>> GetDefinitionsAsync(Guid serviceId, CancellationToken ct = default)
+    {
+        var entities = await Definitions.AsNoTracking().Where(d => d.ServiceId == serviceId).OrderBy(d => d.Key).ToListAsync(ct);
+        return entities.Select(MapDefinition).ToList();
+    }
+
+    public async Task<bool> DeleteDefinitionAsync(Guid serviceId, string key, Guid revision, CancellationToken ct = default)
+    {
+        var removed = false;
+        await mutations.ExecuteAsync(async () =>
+        {
+            if (string.IsNullOrWhiteSpace(key) || key.Length > 100 || revision == Guid.Empty)
+                throw new EmailTemplateWriteException("An exact key (at most 100 characters) and a nonempty revision are required.", false);
+            var definition = await Definitions.SingleOrDefaultAsync(d => d.ServiceId == serviceId && d.Key == key, ct);
+            if (definition is null)
+                return;
+            if (definition.Revision != revision)
+                throw new EmailTemplateWriteException("The definition revision changed. Read it again before deleting.");
+            db.TemplateDefinitions.Remove(definition);
+            removed = true;
+        }, ct);
+        return removed;
+    }
+
+    public Task AddAsync(EmailTemplate template, CancellationToken ct = default) => mutations.ExecuteAsync(async () =>
+    {
+        ValidateLegacy(template);
+        var definition = await FindDefinitionAsync(template.ServiceName, template.Key, ct);
+        if (definition is null)
+        {
+            await RequireServiceLanguageAsync(template.ServiceName, template.LanguageCode, ct);
+            definition = await CreateDefinitionAsync(template.ServiceName, template.Key, template.Variables, ct);
+        }
+        EnsureMatchingContract(definition, template.Variables);
+        await RequireServiceLanguageAsync(template.ServiceName, template.LanguageCode, ct);
+        var code = template.LanguageCode;
+        if (definition.Languages.Any(t => t.ServiceLanguage.Code == code))
+            throw new EmailTemplateWriteException("This language already exists for the template.");
+        var language = NewLanguage(template, definition);
+        definition.Languages.Add(language);
+        db.Templates.Add(language);
+        Touch(definition);
+    }, ct);
+
+    public Task UpdateAsync(EmailTemplate template, CancellationToken ct = default) => mutations.ExecuteAsync(async () =>
+    {
+        ValidateLegacy(template);
+        var definition = await RequireDefinitionAsync(template.ServiceName, template.Key, ct);
+        EnsureMatchingContract(definition, template.Variables);
+        var language = definition.Languages.SingleOrDefault(t => t.Id == template.Id)
+            ?? throw new EmailTemplateWriteException("The language changed or was removed. Reload the template.");
+        SetContent(language, template);
+        Touch(definition);
+    }, ct);
+
+    public Task DeleteAsync(EmailTemplate template, CancellationToken ct = default) => mutations.ExecuteAsync(async () =>
+    {
+        var definition = await RequireDefinitionAsync(template.ServiceName, template.Key, ct);
+        var language = definition.Languages.SingleOrDefault(t => t.Id == template.Id)
+            ?? throw new EmailTemplateWriteException("The language changed or was removed. Reload the template.");
+        db.Templates.Remove(language);
+        Touch(definition);
+    }, ct);
+
+    public Task SaveDefinitionAsync(EmailTemplateDefinition definition, bool isNew, CancellationToken ct = default) => mutations.ExecuteAsync(async () =>
+    {
+        EmailTemplateValidation.ValidateDefinition(definition);
+        await ValidateServiceLanguagesAsync(definition, ct);
+        var entity = await LoadForSaveAsync(definition, isNew, ct);
+        entity.Variables = MapVariables(definition.Variables);
+        SynchronizeLanguages(entity, definition.Languages);
+        Touch(entity);
+        definition.Id = entity.Id;
+        definition.Revision = entity.Revision;
+    }, ct);
+
+    private async Task<EmailTemplateDefinitionEntity> LoadForSaveAsync(EmailTemplateDefinition model, bool isNew, CancellationToken ct)
+    {
+        var entity = await FindDefinitionAsync(model.ServiceName, model.Key, ct);
+        if (isNew)
+        {
+            if (entity is not null)
+                throw new EmailTemplateWriteException("A template with this service and key already exists.");
+            return await CreateDefinitionAsync(model.ServiceName, model.Key, model.Variables, ct);
+        }
+        if (entity is null || entity.Id != model.Id || entity.Revision != model.Revision)
+            throw new EmailTemplateWriteException("This template changed after you opened it. Reload before saving; your entered values are retained.");
+        return entity;
+    }
+
+    private void SynchronizeLanguages(EmailTemplateDefinitionEntity definition, IReadOnlyList<EmailTemplate> languages)
+    {
+        var codes = languages.Select(t => t.LanguageCode).ToHashSet(StringComparer.Ordinal);
+        db.Templates.RemoveRange(definition.Languages.Where(t => !codes.Contains(t.ServiceLanguage.Code)));
+        UpsertLanguages(definition, languages);
+    }
+
+    private void UpsertLanguages(EmailTemplateDefinitionEntity definition, IReadOnlyList<EmailTemplate> languages)
+    {
+        foreach (var model in languages)
+        {
+            var code = model.LanguageCode;
+            var entity = definition.Languages.SingleOrDefault(t => t.ServiceLanguage.Code == code);
+            if (entity is null)
+            {
+                var language = NewLanguage(model, definition);
+                definition.Languages.Add(language);
+                db.Templates.Add(language);
+            }
+            else
+                SetContent(entity, model);
+        }
+    }
+
+    public async Task<IReadOnlyList<EmailTemplateDefinition>> GetDefinitionsAsync(string? serviceName = null, string? key = null, CancellationToken ct = default)
+    {
+        var query = Definitions.AsNoTracking();
+        if (!string.IsNullOrWhiteSpace(serviceName))
+            query = query.Where(d => d.Service.Name == serviceName);
+        if (!string.IsNullOrWhiteSpace(key))
+            query = query.Where(d => d.Key == key);
+        var entities = await query.OrderBy(d => d.Service.Name).ThenBy(d => d.Key).ToListAsync(ct);
+        return entities.Select(MapDefinition).ToList();
+    }
+
+    private async Task RequireServiceLanguageAsync(string serviceName, string code, CancellationToken ct)
+    {
+        if (!await db.ServiceLanguages.AnyAsync(l => l.Service.Name == serviceName && l.Code == code, ct))
+            throw new EmailTemplateWriteException("Language is not in this service's catalog. Add it in the service editor first.", false);
+    }
+
+    private async Task ValidateServiceLanguagesAsync(EmailTemplateDefinition definition, CancellationToken ct)
+    {
+        var service = await db.Services.Include(s => s.Languages).SingleOrDefaultAsync(s => s.Name == definition.ServiceName
+                && (definition.ServiceId == Guid.Empty || s.Id == definition.ServiceId), ct)
+            ?? throw new EmailTemplateWriteException("Service does not exist. Create the service first.", false);
+        var codes = service.Languages.Select(l => l.Code).ToHashSet(StringComparer.Ordinal);
+        if (definition.Languages.Any(l => !codes.Contains(l.LanguageCode)))
+            throw new EmailTemplateWriteException("Language is not in this service's catalog. Add it in the service editor first.", false);
+    }
+
+    private Task<EmailTemplateDefinitionEntity?> FindDefinitionAsync(string serviceName, string key, CancellationToken ct) =>
+        Definitions.SingleOrDefaultAsync(d => d.Service.Name == serviceName && d.Key == key, ct);
+
+    private async Task<EmailTemplateDefinitionEntity> RequireDefinitionAsync(string serviceName, string key, CancellationToken ct) =>
+        await FindDefinitionAsync(serviceName, key, ct)
+        ?? throw new EmailTemplateWriteException("The template was removed. Reload the template list.");
+
+    private async Task<EmailTemplateDefinitionEntity> CreateDefinitionAsync(string serviceName, string key,
+        IReadOnlyList<EmailTemplateVariable> variables, CancellationToken ct)
+    {
+        var service = await db.Services.Include(s => s.Languages).SingleOrDefaultAsync(s => s.Name == serviceName, ct)
+            ?? throw new EmailTemplateWriteException("Service does not exist. Create the service and its language codes first.", false);
+        var entity = new EmailTemplateDefinitionEntity
+        {
+            Service = service, Key = key, Variables = MapVariables(variables), Created = DateTimeOffset.UtcNow
+        };
+        db.TemplateDefinitions.Add(entity);
+        return entity;
+    }
+
+    private static void ValidateLegacy(EmailTemplate template)
+    {
+        EmailTemplateValidation.ValidateIdentity(template.ServiceName, template.Key);
+        EmailTemplateValidation.ValidateLanguage(template);
+        EmailTemplateValidation.ValidateVariables(template.Variables);
+    }
+
+    private static void EnsureMatchingContract(EmailTemplateDefinitionEntity definition, IReadOnlyList<EmailTemplateVariable> variables)
+    {
+        var shared = definition.Variables.Select(v => new EmailTemplateVariable { Name = v.Name, Required = v.Required }).ToList();
+        if (!EmailTemplateValidation.ContractsEqual(shared, variables))
+            throw new EmailTemplateWriteException("Variables conflict with the shared template contract. Edit shared variables in the template editor.");
+    }
+
+    private static void Touch(EmailTemplateDefinitionEntity definition)
+    {
+        definition.Revision = Guid.NewGuid();
+        definition.Updated = DateTimeOffset.UtcNow;
+    }
+
+    private static List<EmailTemplateVariableData> MapVariables(IReadOnlyList<EmailTemplateVariable> variables) =>
+        variables.Select(v => new EmailTemplateVariableData { Name = v.Name, Required = v.Required }).ToList();
+
+    private static EmailTemplateEntity NewLanguage(EmailTemplate model, EmailTemplateDefinitionEntity definition) => new()
+    {
+        Id = model.Id, Definition = definition, ServiceId = definition.Service.Id,
+        ServiceLanguage = definition.Service.Languages.SingleOrDefault(l => l.Code == model.LanguageCode)
+            ?? throw new EmailTemplateWriteException("Language is not in this service's catalog. Add it in the service editor first.", false),
+        Subject = model.Subject, HtmlBody = model.HtmlBody, TextBody = model.TextBody, Created = model.Created
+    };
+
+    private static void SetContent(EmailTemplateEntity entity, EmailTemplate model)
+    {
+        entity.Subject = model.Subject;
+        entity.HtmlBody = model.HtmlBody;
+        entity.TextBody = model.TextBody;
        entity.Updated = DateTimeOffset.UtcNow;
-        Update(entity);
-        return Task.CompletedTask;
    }

-    public async Task DeleteAsync(EmailTemplate EmailTemplate, CancellationToken ct = default)
+    private static EmailTemplate MapLanguage(EmailTemplateEntity entity) => new()
    {
-        EmailTemplateEntity? entity = await DbSet.FindAsync([EmailTemplate.Id], ct);
-        if (entity is not null)
-            Delete(entity);
-    }
-
-    private static EmailTemplate MapToDomain(EmailTemplateEntity e) => new()
-    {
-        Id = e.Id,
-        ServiceName = e.ServiceName,
-        Key = e.Key,
-        LanguageCode = e.LanguageCode,
-        Subject = e.Subject,
-        HtmlBody = e.HtmlBody,
-        TextBody = e.TextBody,
-        Variables = e.Variables.Select(v => new EmailTemplateVariable { Name = v.Name, Required = v.Required }).ToList(),
-        Created = e.Created,
-        Updated = e.Updated
+        Id = entity.Id, ServiceName = entity.Definition.Service.Name, Key = entity.Definition.Key,
+        LanguageCode = entity.ServiceLanguage.Code, Subject = entity.Subject, HtmlBody = entity.HtmlBody, TextBody = entity.TextBody,
+        Variables = entity.Definition.Variables.Select(v => new EmailTemplateVariable { Name = v.Name, Required = v.Required }).ToList(),
+        Created = entity.Created, Updated = entity.Updated
    };

-    private static EmailTemplateEntity MapToEntity(EmailTemplate t) => new()
+    private static EmailTemplateDefinition MapDefinition(EmailTemplateDefinitionEntity entity) => new()
    {
-        Id = t.Id,
-        ServiceName = t.ServiceName,
-        Key = t.Key,
-        LanguageCode = t.LanguageCode,
-        Subject = t.Subject,
-        HtmlBody = t.HtmlBody,
-        TextBody = t.TextBody,
-        Variables = t.Variables.Select(v => new EmailTemplateVariableData { Name = v.Name, Required = v.Required }).ToList(),
-        Created = t.Created,
-        Updated = t.Updated
+        Id = entity.Id, ServiceId = entity.ServiceId, ServiceName = entity.Service.Name, Key = entity.Key, Revision = entity.Revision,
+        Variables = entity.Variables.Select(v => new EmailTemplateVariable { Name = v.Name, Required = v.Required }).ToList(),
+        Languages = entity.Languages.OrderBy(t => t.ServiceLanguage.Code).Select(MapLanguage).ToList(),
+        Created = entity.Created, Updated = entity.Updated
    };
-}
+}
@@ -0,0 +1,215 @@
+using HrynCo.NotificationService.DAL.Abstract.Repositories;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.NotificationService.DAL.EF.Entities;
+using Microsoft.EntityFrameworkCore;
+
+namespace HrynCo.NotificationService.DAL.EF.Repositories;
+
+internal sealed class NotificationServiceRepository(NotificationDbContext db, TemplateMutationRunner mutations) : INotificationServiceRepository
+{
+    public async Task<IReadOnlyList<NotificationServiceInfo>> GetAllAsync(CancellationToken ct = default)
+    {
+        var services = await db.Services.AsNoTracking().Include(s => s.Languages).OrderBy(s => s.Name).ToListAsync(ct);
+        var counts = await VersionCountsAsync(ct);
+        return services.Select(s => Map(s, counts)).ToList();
+    }
+
+    public async Task<NotificationServiceInfo?> GetAsync(Guid id, CancellationToken ct = default)
+    {
+        var service = await db.Services.AsNoTracking().Include(s => s.Languages).SingleOrDefaultAsync(s => s.Id == id, ct);
+        return service is null ? null : Map(service, await VersionCountsAsync(ct));
+    }
+
+    public async Task<NotificationServiceInfo?> GetByNameAsync(string name, CancellationToken ct = default)
+    {
+        var service = await db.Services.AsNoTracking().Include(s => s.Languages).SingleOrDefaultAsync(s => s.Name == name, ct);
+        return service is null ? null : Map(service, await VersionCountsAsync(ct));
+    }
+
+    public async Task<bool> DeleteAsync(Guid id, Guid revision, CancellationToken ct = default)
+    {
+        var removed = false;
+        await mutations.ExecuteAsync(async () =>
+        {
+            if (revision == Guid.Empty)
+                throw new EmailTemplateWriteException("A nonempty service revision is required.", false);
+            var service = await db.Services.Include(s => s.Languages).SingleOrDefaultAsync(s => s.Id == id, ct);
+            if (service is null)
+                return;
+            if (service.Revision != revision)
+                throw new EmailTemplateWriteException("The service revision changed. Read it again before deleting.");
+            if (await db.TemplateDefinitions.AnyAsync(d => d.ServiceId == id, ct))
+                throw new EmailTemplateWriteException("Remove every template definition before deleting this service, including definitions without translations.");
+            db.ServiceLanguages.RemoveRange(service.Languages);
+            db.Services.Remove(service);
+            removed = true;
+        }, ct);
+        return removed;
+    }
+
+    public Task SaveAsync(NotificationServiceInfo model, bool isNew, CancellationToken ct = default) => mutations.ExecuteAsync(async () =>
+    {
+        Validate(model);
+        var service = await LoadForSaveAsync(model, isNew, ct);
+        await ValidateLanguageChangesAsync(service, model, ct);
+        await StageLanguageCodeChangesAsync(service, model.Languages, ct);
+        service.Name = model.Name;
+        SynchronizeLanguages(service, model.Languages);
+        Touch(service);
+        await TouchDefinitionsAsync(service.Id, ct);
+        model.Id = service.Id;
+        model.Revision = service.Revision;
+    }, ct);
+
+    public Task RemoveLanguageAsync(Guid serviceId, Guid languageId, int expectedVersionCount, Guid expectedRevision, CancellationToken ct = default) =>
+        mutations.ExecuteAsync(async () =>
+        {
+            var service = await db.Services.Include(s => s.Languages).SingleOrDefaultAsync(s => s.Id == serviceId, ct)
+                ?? throw new EmailTemplateWriteException("Service no longer exists. Reload services.");
+            var language = service.Languages.SingleOrDefault(l => l.Id == languageId)
+                ?? throw new EmailTemplateWriteException("Language no longer exists. Reload the service.");
+            var versions = await db.Templates.Where(t => t.ServiceLanguageId == languageId).ToListAsync(ct);
+            if (service.Revision != expectedRevision || versions.Count != expectedVersionCount)
+                throw new EmailTemplateWriteException("The service or affected version count changed. Review the current count and confirm again.");
+            db.Templates.RemoveRange(versions);
+            // Save dependent removals first because language deletion is restricted by its FK.
+            await db.SaveChangesAsync(ct);
+            db.ServiceLanguages.Remove(language);
+            Touch(service);
+            await TouchDefinitionsAsync(serviceId, ct);
+        }, ct);
+
+    private async Task<ServiceEntity> LoadForSaveAsync(NotificationServiceInfo model, bool isNew, CancellationToken ct)
+    {
+        if (await db.Services.AnyAsync(s => s.Name == model.Name && s.Id != model.Id, ct))
+            throw new EmailTemplateWriteException("A service with this name already exists.");
+        if (isNew)
+        {
+            var created = new ServiceEntity { Name = model.Name, Created = DateTimeOffset.UtcNow };
+            db.Services.Add(created);
+            return created;
+        }
+        var service = await db.Services.Include(s => s.Languages).SingleOrDefaultAsync(s => s.Id == model.Id, ct);
+        if (service is null || service.Revision != model.Revision)
+            throw new EmailTemplateWriteException("This service changed after you opened it. Reload before saving.");
+        return service;
+    }
+
+    private async Task ValidateLanguageChangesAsync(ServiceEntity service, NotificationServiceInfo model, CancellationToken ct)
+    {
+        var ids = service.Languages.Select(l => l.Id).ToHashSet();
+        if (model.Languages.Any(l => l.Id != Guid.Empty && !ids.Contains(l.Id)))
+            throw new EmailTemplateWriteException("A language changed or was removed. Reload the service.");
+        ValidateChangedCodes(service, model.Languages);
+        var retained = model.Languages.Select(l => l.Id).ToHashSet();
+        var removed = service.Languages.Where(l => !retained.Contains(l.Id)).ToList();
+        foreach (var language in removed)
+        {
+            var count = await db.Templates.CountAsync(t => t.ServiceLanguageId == language.Id, ct);
+            if (count > 0)
+                throw new EmailTemplateWriteException($"Cannot remove language '{language.Code}': {count} version(s) use it. Use the separate delete-with-versions confirmation.");
+        }
+    }
+
+    private async Task StageLanguageCodeChangesAsync(ServiceEntity service, IReadOnlyList<ServiceLanguageInfo> languages, CancellationToken ct)
+    {
+        var requested = languages.Where(l => l.Id != Guid.Empty).ToDictionary(l => l.Id, l => l.Code);
+        var removed = service.Languages.Where(l => !requested.ContainsKey(l.Id)).ToList();
+        var changed = service.Languages.Where(l => requested.TryGetValue(l.Id, out var code) && code != l.Code).ToList();
+        if (removed.Count == 0 && changed.Count == 0)
+            return;
+        foreach (var language in removed)
+        {
+            db.ServiceLanguages.Remove(language);
+            service.Languages.Remove(language);
+        }
+        var reserved = service.Languages.Select(l => l.Code).Concat(languages.Select(l => l.Code)).ToHashSet(StringComparer.Ordinal);
+        foreach (var language in changed)
+            language.Code = TemporaryCode(reserved);
+        // Free old codes before final assignments, supporting swaps and replacing unused rows.
+        // These temporary identifiers remain invisible outside this transaction.
+        await db.SaveChangesAsync(ct);
+    }
+
+    private static string TemporaryCode(HashSet<string> reserved)
+    {
+        string code;
+        do { code = "~" + Guid.NewGuid().ToString("N")[..9]; }
+        while (!reserved.Add(code));
+        return code;
+    }
+
+    private void SynchronizeLanguages(ServiceEntity service, IReadOnlyList<ServiceLanguageInfo> languages)
+    {
+        var retained = languages.Select(l => l.Id).ToHashSet();
+        db.ServiceLanguages.RemoveRange(service.Languages.Where(l => !retained.Contains(l.Id)));
+        foreach (var model in languages)
+        {
+            var entity = service.Languages.SingleOrDefault(l => l.Id == model.Id);
+            if (entity is null)
+                db.ServiceLanguages.Add(new ServiceLanguageEntity { Service = service, Code = model.Code, Created = DateTimeOffset.UtcNow });
+            else
+                entity.Code = model.Code;
+        }
+    }
+
+    private async Task TouchDefinitionsAsync(Guid serviceId, CancellationToken ct)
+    {
+        var definitions = await db.TemplateDefinitions.Where(d => d.ServiceId == serviceId).ToListAsync(ct);
+        foreach (var definition in definitions)
+        {
+            definition.Revision = Guid.NewGuid();
+            definition.Updated = DateTimeOffset.UtcNow;
+        }
+    }
+
+    private Task<Dictionary<Guid, int>> VersionCountsAsync(CancellationToken ct) => db.Templates.AsNoTracking()
+        .GroupBy(t => t.ServiceLanguageId).Select(g => new { Id = g.Key, Count = g.Count() })
+        .ToDictionaryAsync(g => g.Id, g => g.Count, ct);
+
+    private static void Validate(NotificationServiceInfo service)
+    {
+        if (string.IsNullOrWhiteSpace(service.Name) || service.Name.Length > 100)
+            throw new EmailTemplateWriteException("Service name is required and must be at most 100 characters.", false);
+        foreach (var language in service.Languages)
+            ValidateCode(language.Code);
+        if (service.Languages.Select(l => l.Code).Distinct(StringComparer.Ordinal).Count() != service.Languages.Count)
+            throw new EmailTemplateWriteException("Language codes must be unique within the service.", false);
+        var ids = service.Languages.Where(l => l.Id != Guid.Empty).Select(l => l.Id).ToList();
+        if (ids.Distinct().Count() != ids.Count)
+            throw new EmailTemplateWriteException("Each service language can appear only once.", false);
+    }
+
+    private static void ValidateCode(string code)
+    {
+        if (string.IsNullOrWhiteSpace(code) || code.Length > 10)
+            throw new EmailTemplateWriteException("Language codes are required and must be at most 10 characters.", false);
+    }
+
+    private static void ValidateChangedCodes(ServiceEntity service, IReadOnlyList<ServiceLanguageInfo> languages)
+    {
+        var persisted = service.Languages.ToDictionary(l => l.Id, l => l.Code);
+        foreach (var language in languages)
+        {
+            if (persisted.TryGetValue(language.Id, out var original) && original == language.Code)
+                continue;
+            if (!System.Text.RegularExpressions.Regex.IsMatch(language.Code, "^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$"))
+                throw new EmailTemplateWriteException("Use letters, numbers and hyphens in new or renamed language codes, without spaces. Codes are case-sensitive.", false);
+        }
+    }
+
+    private static void Touch(ServiceEntity service)
+    {
+        service.Revision = Guid.NewGuid();
+        service.Updated = DateTimeOffset.UtcNow;
+    }
+
+    private static NotificationServiceInfo Map(ServiceEntity service, IReadOnlyDictionary<Guid, int> counts) => new()
+    {
+        Id = service.Id, Name = service.Name, Revision = service.Revision,
+        Languages = service.Languages.OrderBy(l => l.Code).Select(l => new ServiceLanguageInfo
+        {
+            Id = l.Id, Code = l.Code, VersionCount = counts.GetValueOrDefault(l.Id)
+        }).ToList()
+    };
+}
@@ -1,4 +1,4 @@
-using HrynCo.NotificationService.DAL.Abstract;
+using HrynCo.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.DAL.EF.Core;
 using HrynCo.NotificationService.DAL.EF.Repositories;
@@ -16,10 +16,13 @@ public static class ServiceCollectionExtensions
        services.AddDbContext<NotificationDbContext>(options =>
            options.UseNpgsql(connectionString));

-        services.AddScoped<IUnitOfWork, UnitOfWork>();
+        services.AddScoped<TemplateMutationRunner>();
+        services.AddScoped<INotificationServiceRepository, NotificationServiceRepository>();
        services.AddScoped<IEmailTemplateRepository, EmailTemplateRepository>();
+        services.AddScoped<IEmailTemplateDefinitionRepository, EmailTemplateRepository>();
        services.AddScoped<IEmailChannelRepository, EmailChannelRepository>();
        services.AddScoped<IEmailChannelUsageRepository, EmailChannelUsageRepository>();
+        services.AddScoped<IUnitOfWork, NotificationUnitOfWork>();

        return services;
    }
@@ -0,0 +1,19 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace HrynCo.NotificationService.DAL.EF;
+
+internal sealed class TemplateMutationRunner(NotificationDbContext db)
+{
+    public async Task ExecuteAsync(Func<Task> write, CancellationToken ct)
+    {
+        await using var transaction = db.Database.CurrentTransaction is null
+            ? await db.Database.BeginTransactionAsync(ct) : null;
+        // Service/language administration and template writes share the same transaction lock.
+        // Counts, catalog membership and revision checks are therefore valid until commit.
+        await db.Database.ExecuteSqlRawAsync("SELECT pg_advisory_xact_lock(1601)", ct);
+        await write();
+        await db.SaveChangesAsync(ct);
+        if (transaction is not null)
+            await transaction.CommitAsync(ct);
+    }
+}
@@ -0,0 +1,132 @@
+namespace HrynCo.NotificationService.Migrator;
+
+using HrynCo.NotificationService.DAL.Abstract.Providers;
+using HrynCo.NotificationService.DAL.Abstract.Repositories;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using Microsoft.Extensions.Logging;
+
+internal sealed class DevelopmentDataSeeder
+{
+    internal const string DefaultServiceName = "TestService";
+    internal const string DefaultLanguageCode = "en";
+
+    private readonly IEmailChannelRepository _channels;
+    private readonly IEmailTemplateRepository _templates;
+    private readonly INotificationServiceRepository _services;
+    private readonly ILogger<DevelopmentDataSeeder> _logger;
+
+    public DevelopmentDataSeeder(
+        IEmailChannelRepository channels,
+        IEmailTemplateRepository templates,
+        INotificationServiceRepository services,
+        ILogger<DevelopmentDataSeeder> logger)
+    {
+        _channels = channels;
+        _templates = templates;
+        _services = services;
+        _logger = logger;
+    }
+
+    public async Task SeedAsync(string serviceName, CancellationToken cancellationToken = default)
+    {
+        if (string.IsNullOrWhiteSpace(serviceName))
+            throw new InvalidOperationException("Development seed service name is not configured.");
+
+        await SeedMailpitChannelAsync(serviceName, cancellationToken);
+        await SeedServiceAsync(serviceName, cancellationToken);
+
+        foreach (EmailTemplate template in CreateTemplates(serviceName))
+        {
+            EmailTemplate? existing = await _templates.GetAsync(
+                template.ServiceName, template.Key, template.LanguageCode, cancellationToken);
+
+            if (existing is not null)
+            {
+                _logger.LogInformation(
+                    "Development email template already exists; leaving it unchanged [ServiceName={ServiceName}, Key={TemplateKey}, LanguageCode={LanguageCode}]",
+                    template.ServiceName, template.Key, template.LanguageCode);
+                continue;
+            }
+
+            await _templates.AddAsync(template, cancellationToken);
+            _logger.LogInformation(
+                "Created development email template [ServiceName={ServiceName}, Key={TemplateKey}, LanguageCode={LanguageCode}]",
+                template.ServiceName, template.Key, template.LanguageCode);
+        }
+    }
+
+    private async Task SeedServiceAsync(string serviceName, CancellationToken ct)
+    {
+        var services = await _services.GetAllAsync(ct);
+        var service = services.SingleOrDefault(s => s.Name == serviceName);
+        if (service?.Languages.Any(l => l.Code == DefaultLanguageCode) == true)
+            return;
+        var isNew = service is null;
+        service ??= new NotificationServiceInfo { Name = serviceName };
+        service.Languages = [..service.Languages, new ServiceLanguageInfo { Code = DefaultLanguageCode }];
+        await _services.SaveAsync(service, isNew, ct);
+    }
+
+    private async Task SeedMailpitChannelAsync(string serviceName, CancellationToken cancellationToken)
+    {
+        IReadOnlyList<EmailChannel> existingChannels = await _channels.GetByServiceAsync(
+            serviceName, cancellationToken);
+
+        if (existingChannels.Count > 0)
+        {
+            _logger.LogInformation(
+                "Development email channel already exists; leaving all channels unchanged [ServiceName={ServiceName}]",
+                serviceName);
+            return;
+        }
+
+        var channel = new EmailChannel
+        {
+            ServiceName = serviceName,
+            Priority = 1,
+            EmailChannelType = EmailChannelType.Smtp,
+            Settings = new SmtpChannelSettings
+            {
+                Host = "mailpit",
+                Port = 1025,
+                Username = string.Empty,
+                Password = string.Empty,
+                UseSsl = false,
+                FromEmail = "no-reply@local.hrynco.test",
+                FromName = "HrynCo Development"
+            },
+            WarnThresholdPercent = 90,
+            IsActive = true,
+            Created = DateTimeOffset.UtcNow
+        };
+
+        await _channels.AddAsync(channel, cancellationToken);
+        _logger.LogInformation(
+            "Created Mailpit development email channel [ServiceName={ServiceName}]",
+            serviceName);
+    }
+
+    private static IReadOnlyList<EmailTemplate> CreateTemplates(string serviceName)
+    {
+        DateTimeOffset created = DateTimeOffset.UtcNow;
+
+        return
+        [
+            new EmailTemplate
+            {
+                ServiceName = serviceName,
+                Key = "TestEmail",
+                LanguageCode = DefaultLanguageCode,
+                Subject = "Test notification",
+                HtmlBody = "<p>Hello {{RecipientName}},</p><p>{{Message}}</p>",
+                TextBody = "Hello {{RecipientName}}, {{Message}}",
+                Variables =
+                [
+                    new EmailTemplateVariable { Name = "RecipientName", Required = true },
+                    new EmailTemplateVariable { Name = "Message", Required = true }
+                ],
+                Created = created
+            }
+        ];
+    }
+}
@@ -1,5 +1,7 @@
-using HrynCo.NotificationService.DAL.EF;
+using HrynCo.NotificationService.DAL.EF;
+using HrynCo.NotificationService.Migrator;
 using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Configuration;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Hosting;
 using Serilog;
@@ -21,8 +23,8 @@ try
            var connectionString = ctx.Configuration["App:ConnectionString"]
                ?? throw new InvalidOperationException("App:ConnectionString is not configured.");

-            services.AddDbContext<NotificationDbContext>(options =>
-                options.UseNpgsql(connectionString));
+            services.AddNotificationDataAccess(connectionString);
+            services.AddScoped<DevelopmentDataSeeder>();
        })
        .Build();

@@ -32,6 +34,18 @@ try
    Log.Information("Applying migrations...");
    await db.Database.MigrateAsync();
    Log.Information("Migrations applied successfully.");
+
+    var environment = scope.ServiceProvider.GetRequiredService<IHostEnvironment>();
+    if (environment.IsDevelopment())
+    {
+        string serviceName = host.Services.GetRequiredService<IConfiguration>()["DevelopmentSeed:ServiceName"]
+                             ?? DevelopmentDataSeeder.DefaultServiceName;
+
+        Log.Information("Seeding development email configuration...");
+        var seeder = scope.ServiceProvider.GetRequiredService<DevelopmentDataSeeder>();
+        await seeder.SeedAsync(serviceName);
+        Log.Information("Development email configuration is ready.");
+    }
 }
 catch (Exception ex)
 {
@@ -0,0 +1,3 @@
+using System.Runtime.CompilerServices;
+
+[assembly: InternalsVisibleTo("HrynCo.NotificationService.Services.Tests")]
@@ -0,0 +1,85 @@
+namespace HrynCo.NotificationService.Services.Tests;
+
+using HrynCo.NotificationService.DAL.Abstract.Providers;
+using HrynCo.NotificationService.DAL.Abstract.Repositories;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.NotificationService.Migrator;
+using Microsoft.Extensions.Logging.Abstractions;
+using NSubstitute;
+
+public sealed class DevelopmentDataSeederTests
+{
+    private readonly IEmailChannelRepository _channels = Substitute.For<IEmailChannelRepository>();
+    private readonly IEmailTemplateRepository _templates = Substitute.For<IEmailTemplateRepository>();
+    private readonly INotificationServiceRepository _services = Substitute.For<INotificationServiceRepository>();
+
+    [Fact]
+    public async Task SeedAsync_WhenConfigurationIsMissing_CreatesMailpitChannelAndTestTemplate()
+    {
+        _channels.GetByServiceAsync("TestService", Arg.Any<CancellationToken>())
+            .Returns(Array.Empty<EmailChannel>());
+        _templates.GetAsync("TestService", "TestEmail", "en", Arg.Any<CancellationToken>())
+            .Returns((EmailTemplate?)null);
+
+        DevelopmentDataSeeder seeder = CreateSeeder();
+
+        await seeder.SeedAsync("TestService", CancellationToken.None);
+
+        await _channels.Received(1).AddAsync(
+            Arg.Is<EmailChannel>(channel => IsMailpitChannel(channel)),
+            Arg.Any<CancellationToken>());
+        await _templates.Received(1).AddAsync(
+            Arg.Is<EmailTemplate>(template =>
+                template.ServiceName == "TestService" &&
+                template.Key == "TestEmail" &&
+                template.Variables.Any(variable => variable.Name == "Message" && variable.Required)),
+            Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task SeedAsync_WhenConfigurationExists_DoesNotDuplicateOrOverwriteIt()
+    {
+        _channels.GetByServiceAsync("TestService", Arg.Any<CancellationToken>())
+            .Returns([new EmailChannel
+            {
+                ServiceName = "TestService",
+                EmailChannelType = EmailChannelType.Smtp,
+                Settings = new SmtpChannelSettings()
+            }]);
+        _templates.GetAsync("TestService", "TestEmail", "en", Arg.Any<CancellationToken>())
+            .Returns(new EmailTemplate
+            {
+                ServiceName = "TestService",
+                Key = "TestEmail",
+                LanguageCode = "en",
+                Subject = "Existing",
+                HtmlBody = "Existing",
+                TextBody = "Existing"
+            });
+
+        DevelopmentDataSeeder seeder = CreateSeeder();
+
+        await seeder.SeedAsync("TestService", CancellationToken.None);
+
+        await _channels.DidNotReceive().AddAsync(Arg.Any<EmailChannel>(), Arg.Any<CancellationToken>());
+        await _templates.DidNotReceive().AddAsync(Arg.Any<EmailTemplate>(), Arg.Any<CancellationToken>());
+        await _channels.DidNotReceive().UpdateAsync(Arg.Any<EmailChannel>(), Arg.Any<CancellationToken>());
+        await _templates.DidNotReceive().UpdateAsync(Arg.Any<EmailTemplate>(), Arg.Any<CancellationToken>());
+    }
+
+    private DevelopmentDataSeeder CreateSeeder() => new(
+        _channels,
+        _templates,
+        _services,
+        NullLogger<DevelopmentDataSeeder>.Instance);
+
+    private static bool IsMailpitChannel(EmailChannel channel)
+    {
+        return channel.ServiceName == "TestService" &&
+               channel.IsActive &&
+               channel.Settings is SmtpChannelSettings smtp &&
+               smtp.Host == "mailpit" &&
+               smtp.Port == 1025 &&
+               !smtp.UseSsl;
+    }
+}
@@ -0,0 +1,88 @@
+namespace HrynCo.NotificationService.Services.Tests.EmailProcessing;
+
+using HrynCo.NotificationService.Contracts.Messages;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.NotificationService.Worker.Services.EmailProcessing;
+
+public sealed class EmailTemplateRenderingServiceTests
+{
+    private readonly EmailTemplateRenderingService _service = new();
+
+    [Fact]
+    public void Render_InterpolatesItemTrackerVariables()
+    {
+        EmailTemplate template = CreateTemplate();
+        SendEmailMessageData data = CreateData(new Dictionary<string, string>
+        {
+            ["AppName"] = "StoreMate",
+            ["VerificationUrl"] = "https://example.invalid/verify"
+        });
+
+        RenderedEmail result = _service.Render(template, data);
+
+        Assert.Equal("Verify StoreMate", result.Subject);
+        Assert.Equal("<a href=\"https://example.invalid/verify\">Verify</a>", result.HtmlBody);
+        Assert.Equal("Verify at https://example.invalid/verify", result.TextBody);
+    }
+
+    [Fact]
+    public void Render_WhenRequiredVariableIsMissing_ThrowsObservableFailure()
+    {
+        EmailTemplate template = CreateTemplate();
+        SendEmailMessageData data = CreateData(new Dictionary<string, string>
+        {
+            ["AppName"] = "StoreMate"
+        });
+
+        InvalidDataException exception = Assert.Throws<InvalidDataException>(
+            () => _service.Render(template, data));
+
+        Assert.Equal("Required template variables are missing: VerificationUrl.", exception.Message);
+    }
+
+    [Fact]
+    public void Render_HtmlEncodesVariablesWithoutChangingSubjectOrTextBody()
+    {
+        EmailTemplate template = CreateTemplate();
+        SendEmailMessageData data = CreateData(new Dictionary<string, string>
+        {
+            ["AppName"] = "Invemory <script>alert('xss')</script>",
+            ["VerificationUrl"] = "https://example.invalid/verify?next=\" onclick=\"alert('xss')"
+        });
+
+        RenderedEmail result = _service.Render(template, data);
+
+        Assert.Equal("Verify Invemory <script>alert('xss')</script>", result.Subject);
+        Assert.Equal(
+            "<a href=\"https://example.invalid/verify?next=&quot; onclick=&quot;alert(&#39;xss&#39;)\">Verify</a>",
+            result.HtmlBody);
+        Assert.Equal(
+            "Verify at https://example.invalid/verify?next=\" onclick=\"alert('xss')",
+            result.TextBody);
+    }
+
+    private static EmailTemplate CreateTemplate() => new()
+    {
+        ServiceName = "StoreMate-Prod",
+        Key = "EmailVerification",
+        LanguageCode = "uk",
+        Subject = "Verify {{AppName}}",
+        HtmlBody = "<a href=\"{{VerificationUrl}}\">Verify</a>",
+        TextBody = "Verify at {{VerificationUrl}}",
+        Variables =
+        [
+            new EmailTemplateVariable { Name = "AppName", Required = true },
+            new EmailTemplateVariable { Name = "VerificationUrl", Required = true }
+        ]
+    };
+
+    private static SendEmailMessageData CreateData(IReadOnlyDictionary<string, string> variables) => new()
+    {
+        ServiceName = "StoreMate-Prod",
+        TemplateKey = "EmailVerification",
+        RecipientEmail = "owner@example.com",
+        RecipientName = "Owner",
+        LanguageCode = "uk",
+        Variables = variables
+    };
+}
@@ -0,0 +1,97 @@
+namespace HrynCo.NotificationService.Services.Tests.EmailProcessing;
+
+using HrynCo.NotificationService.DAL.Abstract.Repositories;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.NotificationService.Worker.Services.EmailProcessing;
+using NSubstitute;
+
+public sealed class EmailTemplateServiceTests
+{
+    [Theory]
+    [InlineData("RU")]
+    [InlineData(" ru ")]
+    [InlineData(" RU ")]
+    public async Task GetAsync_WhenExactVersionIsMissing_RetriesLegacyTrimmedLowercaseCode(string requestedCode)
+    {
+        IEmailTemplateRepository repository = Substitute.For<IEmailTemplateRepository>();
+        var expected = Template("ru");
+        repository.GetAsync("TestService", "Welcome", "ru", Arg.Any<CancellationToken>()).Returns(expected);
+        var service = new EmailTemplateService(repository);
+
+        Assert.Same(expected, await service.GetAsync("TestService", "Welcome", requestedCode, default));
+        Assert.Equal(new[] { requestedCode, "ru" }, RequestedCodes(repository));
+    }
+
+    [Fact]
+    public async Task GetAsync_WhenBothExactAndLowercaseVersionsExist_PrefersExactVersion()
+    {
+        IEmailTemplateRepository repository = Substitute.For<IEmailTemplateRepository>();
+        var expected = Template("RU");
+        repository.GetAsync("TestService", "Welcome", "RU", Arg.Any<CancellationToken>()).Returns(expected);
+        repository.GetAsync("TestService", "Welcome", "ru", Arg.Any<CancellationToken>()).Returns(Template("ru"));
+        var service = new EmailTemplateService(repository);
+
+        Assert.Same(expected, await service.GetAsync("TestService", "Welcome", "RU", default));
+        Assert.Equal(new[] { "RU" }, RequestedCodes(repository));
+    }
+
+    [Fact]
+    public async Task GetAsync_WhenExactRegionalVersionExists_DoesNotNormalizeIt()
+    {
+        IEmailTemplateRepository repository = Substitute.For<IEmailTemplateRepository>();
+        var expected = Template("ru-RU");
+        repository.GetAsync("TestService", "Welcome", "ru-RU", Arg.Any<CancellationToken>()).Returns(expected);
+        var service = new EmailTemplateService(repository);
+
+        Assert.Same(expected, await service.GetAsync("TestService", "Welcome", "ru-RU", default));
+        Assert.Equal(new[] { "ru-RU" }, RequestedCodes(repository));
+    }
+
+    [Fact]
+    public async Task GetAsync_WhenMissingCodeIsAlreadyCanonical_QueriesOnlyOnce()
+    {
+        IEmailTemplateRepository repository = Substitute.For<IEmailTemplateRepository>();
+        var service = new EmailTemplateService(repository);
+
+        var error = await Assert.ThrowsAsync<InvalidOperationException>(() => service.GetAsync("TestService", "Welcome", "zz", default));
+
+        Assert.Contains("language='zz'", error.Message);
+        Assert.Equal(new[] { "zz" }, RequestedCodes(repository));
+    }
+
+    [Fact]
+    public async Task GetAsync_WhenRegionalLookupMisses_DoesNotScanOtherCaseOrRegionalVariants()
+    {
+        IEmailTemplateRepository repository = Substitute.For<IEmailTemplateRepository>();
+        repository.GetAsync("TestService", "Welcome", "ru-RU", Arg.Any<CancellationToken>()).Returns(Template("ru-RU"));
+        repository.GetAsync("TestService", "Welcome", "ru", Arg.Any<CancellationToken>()).Returns(Template("ru"));
+        var service = new EmailTemplateService(repository);
+
+        await Assert.ThrowsAsync<InvalidOperationException>(() => service.GetAsync("TestService", "Welcome", "RU-ru", default));
+
+        Assert.Equal(new[] { "RU-ru", "ru-ru" }, RequestedCodes(repository));
+    }
+
+    [Theory]
+    [InlineData(null)]
+    [InlineData("")]
+    [InlineData("   ")]
+    public async Task GetAsync_WhenCodeIsBlank_RejectsBeforeRepositoryLookup(string? code)
+    {
+        IEmailTemplateRepository repository = Substitute.For<IEmailTemplateRepository>();
+        var service = new EmailTemplateService(repository);
+
+        await Assert.ThrowsAsync<InvalidDataException>(() => service.GetAsync("TestService", "Welcome", code, default));
+
+        Assert.Empty(repository.ReceivedCalls());
+    }
+
+    private static EmailTemplate Template(string code) => new()
+    {
+        ServiceName = "TestService", Key = "Welcome", LanguageCode = code, Subject = "Subject " + code,
+        HtmlBody = "<p>Hello</p>", TextBody = "Hello"
+    };
+
+    private static string[] RequestedCodes(IEmailTemplateRepository repository) => repository.ReceivedCalls()
+        .Select(call => (string)call.GetArguments()[2]!).ToArray();
+}
@@ -0,0 +1,58 @@
+namespace HrynCo.NotificationService.Services.Tests.EmailProcessing;
+
+using HrynCo.NotificationService.Worker.Services.EmailProcessing;
+using System.Net.Mail;
+using System.Net.Sockets;
+
+public sealed class NotificationDeliveryErrorFormatterTests
+{
+    [Fact]
+    public void Format_UsesInnermostMessageAndRemovesLineBreaks()
+    {
+        var exception = new InvalidOperationException(
+            "outer",
+            new Exception("provider failed\r\nretry rejected"));
+
+        string result = NotificationDeliveryErrorFormatter.Format(exception);
+
+        Assert.Equal(
+            "Notification delivery failed after all retry attempts (provider failed retry rejected).",
+            result);
+    }
+
+    [Fact]
+    public void Format_UnresolvedSmtpHost_AddsSafeChannelContext()
+    {
+        var socketException = new SocketException((int)SocketError.HostNotFound);
+        var exception = new SmtpException("Failure sending mail.", socketException);
+
+        string result = NotificationDeliveryErrorFormatter.Format(exception);
+
+        Assert.Equal(
+            $"SMTP delivery failed after all retry attempts: the configured SMTP server host could not be resolved ({socketException.Message}).",
+            result);
+    }
+
+    [Fact]
+    public void Format_RefusedSmtpConnection_AddsSafeChannelContext()
+    {
+        var socketException = new SocketException((int)SocketError.ConnectionRefused);
+        var exception = new SmtpException("Failure sending mail.", socketException);
+
+        string result = NotificationDeliveryErrorFormatter.Format(exception);
+
+        Assert.Equal(
+            $"SMTP delivery failed after all retry attempts: the configured SMTP server refused the connection ({socketException.Message}).",
+            result);
+    }
+
+    [Fact]
+    public void Format_LongError_IsBoundedToOutboxColumnLength()
+    {
+        var exception = new Exception(new string('x', 2100));
+
+        string result = NotificationDeliveryErrorFormatter.Format(exception);
+
+        Assert.Equal(2000, result.Length);
+    }
+}
@@ -0,0 +1,107 @@
+namespace HrynCo.NotificationService.Services.Tests.EmailProcessing;
+
+using HrynCo.NotificationService.Contracts.Messages;
+using HrynCo.NotificationService.Worker.Services.EmailProcessing;
+using Hrynco.RabbitMq;
+using Microsoft.Extensions.Logging.Abstractions;
+using NSubstitute;
+
+public sealed class NotificationResultPublisherTests
+{
+    [Fact]
+    public async Task PublishAsync_TerminalFailure_PublishesNeutralFailureResultToReplyQueue()
+    {
+        IRabbitMqPublisher rabbitMqPublisher = Substitute.For<IRabbitMqPublisher>();
+        var publisher = new NotificationResultPublisher(
+            rabbitMqPublisher,
+            NullLogger<NotificationResultPublisher>.Instance);
+        SendEmailMessage message = CreateMessage();
+        NotificationResultMessage? publishedResult = null;
+        rabbitMqPublisher
+            .When(x => x.PublishAsync(
+                "item-tracker.notifications.result",
+                Arg.Any<NotificationResultMessage>(),
+                Arg.Any<CancellationToken>()))
+            .Do(call => publishedResult = call.ArgAt<NotificationResultMessage>(1));
+
+        await publisher.PublishAsync(
+            message,
+            "Email provider could not deliver the notification.",
+            CancellationToken.None);
+
+        await rabbitMqPublisher.Received(1).PublishAsync(
+            "item-tracker.notifications.result",
+            Arg.Any<NotificationResultMessage>(),
+            CancellationToken.None);
+        Assert.NotNull(publishedResult);
+        Assert.Equal(message.CorrelationContext.CorrelationId, publishedResult.CorrelationContext.CorrelationId);
+        Assert.Null(publishedResult.CorrelationContext.ReplyTo);
+        Assert.Equal(message.Data.ServiceName, publishedResult.Data.ServiceName);
+        Assert.Equal(message.Data.TemplateKey, publishedResult.Data.TemplateKey);
+        Assert.Equal(message.Data.RecipientEmail, publishedResult.Data.RecipientEmail);
+        Assert.Equal("Email provider could not deliver the notification.", publishedResult.Data.ErrorMessage);
+        Assert.False(publishedResult.Data.IsSuccess);
+    }
+
+    [Fact]
+    public async Task PublishAsync_NoReplyQueue_DoesNotPublish()
+    {
+        IRabbitMqPublisher rabbitMqPublisher = Substitute.For<IRabbitMqPublisher>();
+        var publisher = new NotificationResultPublisher(
+            rabbitMqPublisher,
+            NullLogger<NotificationResultPublisher>.Instance);
+        SendEmailMessage message = CreateMessage();
+        message.CorrelationContext = message.CorrelationContext with { ReplyTo = null };
+
+        await publisher.PublishAsync(message, "delivery failed", CancellationToken.None);
+
+        await rabbitMqPublisher.DidNotReceive()
+            .PublishAsync<NotificationResultData>(
+                Arg.Any<string>(),
+                Arg.Any<NotificationResultMessage>(),
+                Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task PublishAsync_ResultBrokerFailure_IsBestEffort()
+    {
+        IRabbitMqPublisher rabbitMqPublisher = Substitute.For<IRabbitMqPublisher>();
+        rabbitMqPublisher
+            .PublishAsync(
+                Arg.Any<string>(),
+                Arg.Any<NotificationResultMessage>(),
+                Arg.Any<CancellationToken>())
+            .Returns<Task>(_ => throw new InvalidOperationException("reply broker unavailable"));
+        var publisher = new NotificationResultPublisher(
+            rabbitMqPublisher,
+            NullLogger<NotificationResultPublisher>.Instance);
+
+        Exception? exception = await Record.ExceptionAsync(() => publisher.PublishAsync(
+            CreateMessage(),
+            "delivery failed",
+            CancellationToken.None));
+
+        Assert.Null(exception);
+    }
+
+    private static SendEmailMessage CreateMessage()
+    {
+        return new SendEmailMessage
+        {
+            CorrelationContext = new CorrelationContext
+            {
+                CorrelationId = "correlation-id",
+                ReplyTo = "item-tracker.notifications.result"
+            },
+            Data = new SendEmailMessageData
+            {
+                ServiceName = "TestService",
+                TemplateKey = "TestEmail",
+                RecipientEmail = "test.user@itemtracker.local",
+                RecipientName = "Test User",
+                LanguageCode = "en",
+                Variables = new Dictionary<string, string>()
+            }
+        };
+    }
+}
@@ -0,0 +1,16 @@
+namespace HrynCo.NotificationService.Services.Tests.EmailProcessing;
+
+using HrynCo.NotificationService.Worker.Services.EmailProcessing;
+
+public sealed class RecipientAddressRedactorTests
+{
+    [Theory]
+    [InlineData("owner@example.com", "o***@e***.com")]
+    [InlineData("a@b.test", "a***@b***.test")]
+    [InlineData("invalid", "***")]
+    [InlineData(null, "<missing>")]
+    public void Redact_DoesNotExposeFullAddress(string? address, string expected)
+    {
+        Assert.Equal(expected, RecipientAddressRedactor.Redact(address));
+    }
+}
@@ -0,0 +1,60 @@
+namespace HrynCo.NotificationService.Services.Tests.EmailProcessing;
+
+using System.Text.Json;
+using HrynCo.NotificationService.Contracts.Messages;
+using HrynCo.NotificationService.Worker.Services.EmailProcessing;
+
+public sealed class SendEmailContractTests
+{
+    private const string ItemTrackerPayload = """
+        {
+          "CorrelationContext": {
+            "CorrelationId": "3ec4ad3f-0a8a-49f3-b31d-cdad5d1b95cc",
+            "ReplyTo": "item-tracker.notifications.result"
+          },
+          "Data": {
+            "ServiceName": "StoreMate-Prod",
+            "TemplateKey": "EmailVerification",
+            "RecipientEmail": "owner@example.com",
+            "RecipientName": "StoreMate Owner",
+            "Variables": {
+              "AppName": "StoreMate",
+              "VerificationUrl": "https://example.invalid/sensitive-token"
+            },
+            "LanguageCode": "uk"
+          }
+        }
+        """;
+
+    [Fact]
+    public void PascalCaseItemTrackerPayload_DeserializesWithoutLosingValues()
+    {
+        SendEmailMessage? message = JsonSerializer.Deserialize<SendEmailMessage>(ItemTrackerPayload);
+
+        Assert.NotNull(message);
+        SendEmailMessageValidator.Validate(message);
+        Assert.Equal("3ec4ad3f-0a8a-49f3-b31d-cdad5d1b95cc", message.CorrelationContext.CorrelationId);
+        Assert.Equal("item-tracker.notifications.result", message.CorrelationContext.ReplyTo);
+        Assert.Equal("StoreMate-Prod", message.Data.ServiceName);
+        Assert.Equal("EmailVerification", message.Data.TemplateKey);
+        Assert.Equal("owner@example.com", message.Data.RecipientEmail);
+        Assert.Equal("StoreMate Owner", message.Data.RecipientName);
+        Assert.Equal("uk", message.Data.LanguageCode);
+        Assert.Equal("StoreMate", message.Data.Variables["AppName"]);
+        Assert.Equal(
+            "https://example.invalid/sensitive-token",
+            message.Data.Variables["VerificationUrl"]);
+    }
+
+    [Fact]
+    public void MissingLanguageCode_IsRejected()
+    {
+        SendEmailMessage? message = JsonSerializer.Deserialize<SendEmailMessage>(
+            ItemTrackerPayload.Replace("\"uk\"", "null", StringComparison.Ordinal));
+
+        InvalidDataException exception = Assert.Throws<InvalidDataException>(
+            () => SendEmailMessageValidator.Validate(message!));
+
+        Assert.Equal("LanguageCode is required.", exception.Message);
+    }
+}
@@ -0,0 +1,77 @@
+namespace HrynCo.NotificationService.Services.Tests.EmailProcessing;
+
+using HrynCo.NotificationService.Contracts.Messages;
+using HrynCo.NotificationService.Worker;
+using Hrynco.RabbitMq;
+
+public sealed class SendEmailDeliveryValidatorTests
+{
+    [Fact]
+    public void ValidItemTrackerDelivery_IsAccepted()
+    {
+        string? error = SendEmailDeliveryValidator.GetValidationError(
+            CreateMessage(),
+            CreateContext(),
+            SendEmailConsumer.SupportedMessageType);
+
+        Assert.Null(error);
+    }
+
+    [Fact]
+    public void MissingMessageId_IsRejected()
+    {
+        RabbitMqMessageContext context = CreateContext() with { MessageId = null };
+
+        string? error = SendEmailDeliveryValidator.GetValidationError(
+            CreateMessage(),
+            context,
+            SendEmailConsumer.SupportedMessageType);
+
+        Assert.Equal("AMQP MessageId is required.", error);
+    }
+
+    [Fact]
+    public void UnsupportedContractVersion_IsRejected()
+    {
+        RabbitMqMessageContext context = CreateContext() with
+        {
+            MessageType = "Notification.SendEmail.v2"
+        };
+
+        string? error = SendEmailDeliveryValidator.GetValidationError(
+            CreateMessage(),
+            context,
+            SendEmailConsumer.SupportedMessageType);
+
+        Assert.Equal("Unsupported AMQP message type 'Notification.SendEmail.v2'.", error);
+    }
+
+    private static RabbitMqMessageContext CreateContext() => new()
+    {
+        QueueName = SendEmailConsumer.IncomingQueue,
+        Exchange = string.Empty,
+        RoutingKey = SendEmailConsumer.IncomingQueue,
+        MessageId = Guid.NewGuid().ToString("D"),
+        MessageType = SendEmailConsumer.SupportedMessageType,
+        CorrelationId = "correlation-id",
+        ContentType = "application/json"
+    };
+
+    private static SendEmailMessage CreateMessage() => new()
+    {
+        CorrelationContext = new CorrelationContext
+        {
+            CorrelationId = "correlation-id",
+            ReplyTo = "item-tracker.notifications.result"
+        },
+        Data = new SendEmailMessageData
+        {
+            ServiceName = "StoreMate-Prod",
+            TemplateKey = "EmailVerification",
+            RecipientEmail = "owner@example.com",
+            RecipientName = "Owner",
+            LanguageCode = "uk",
+            Variables = new Dictionary<string, string> { ["AppName"] = "StoreMate" }
+        }
+    };
+}
@@ -0,0 +1,123 @@
+namespace HrynCo.NotificationService.Services.Tests.EmailProcessing;
+
+using HrynCo.NotificationService.Contracts.Messages;
+using HrynCo.NotificationService.DAL.Abstract.Providers;
+using HrynCo.NotificationService.DAL.Abstract.Repositories;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.NotificationService.Worker.Services.EmailProcessing;
+using Hrynco.RabbitMq;
+using Microsoft.Extensions.Logging.Abstractions;
+using NSubstitute;
+
+public sealed class SendEmailServiceTests
+{
+    [Fact]
+    public async Task ProcessAsync_ValidItemTrackerMessage_SendsOnceAndUpdatesUsage()
+    {
+        Guid channelId = Guid.NewGuid();
+        var settings = new SmtpChannelSettings
+        {
+            Host = "smtp.example.invalid",
+            Port = 587,
+            Username = "smtp-user",
+            Password = "not-a-real-secret",
+            UseSsl = true,
+            FromEmail = "notifications@example.com",
+            FromName = "StoreMate"
+        };
+        var channel = new EmailChannel
+        {
+            Id = channelId,
+            ServiceName = "StoreMate-Prod",
+            Priority = 1,
+            EmailChannelType = EmailChannelType.Smtp,
+            Settings = settings,
+            IsActive = true
+        };
+        var template = new EmailTemplate
+        {
+            ServiceName = "StoreMate-Prod",
+            Key = "EmailVerification",
+            LanguageCode = "uk",
+            Subject = "Verify {{AppName}}",
+            HtmlBody = "<p>{{AppName}}</p>",
+            TextBody = "{{AppName}}",
+            Variables = [new EmailTemplateVariable { Name = "AppName", Required = true }]
+        };
+
+        IEmailChannelRepository channels = Substitute.For<IEmailChannelRepository>();
+        channels.GetByServiceAsync("StoreMate-Prod", Arg.Any<CancellationToken>())
+            .Returns([channel]);
+        IEmailChannelUsageRepository usage = Substitute.For<IEmailChannelUsageRepository>();
+        IEmailTemplateService templates = Substitute.For<IEmailTemplateService>();
+        templates.GetAsync("StoreMate-Prod", "EmailVerification", "uk", Arg.Any<CancellationToken>())
+            .Returns(template);
+        var renderer = new EmailTemplateRenderingService();
+        var smtp = new RecordingSmtpEmailSender();
+        INotificationResultPublisher resultPublisher = Substitute.For<INotificationResultPublisher>();
+        var service = new SendEmailService(
+            channels,
+            usage,
+            templates,
+            renderer,
+            smtp,
+            resultPublisher,
+            NullLogger<SendEmailService>.Instance);
+        var message = new SendEmailMessage
+        {
+            CorrelationContext = new CorrelationContext
+            {
+                CorrelationId = Guid.NewGuid().ToString("D")
+            },
+            Data = new SendEmailMessageData
+            {
+                ServiceName = "StoreMate-Prod",
+                TemplateKey = "EmailVerification",
+                RecipientEmail = "owner@example.com",
+                RecipientName = "Owner",
+                LanguageCode = "uk",
+                Variables = new Dictionary<string, string> { ["AppName"] = "StoreMate" }
+            }
+        };
+
+        await service.ProcessAsync(message, CancellationToken.None);
+
+        Assert.Equal(1, smtp.SendCount);
+        Assert.Same(settings, smtp.Settings);
+        Assert.Equal("Verify StoreMate", smtp.Email?.Subject);
+        Assert.Equal("owner@example.com", smtp.RecipientEmail);
+        Assert.Equal("Owner", smtp.RecipientName);
+        await usage.Received(1).IncrementUsageAsync(
+            channelId,
+            Arg.Any<DateOnly>(),
+            CancellationToken.None);
+        await resultPublisher.Received(1).PublishAsync(
+            message,
+            null,
+            CancellationToken.None);
+    }
+
+    private sealed class RecordingSmtpEmailSender : ISmtpEmailSender
+    {
+        public int SendCount { get; private set; }
+        public SmtpChannelSettings? Settings { get; private set; }
+        public RenderedEmail? Email { get; private set; }
+        public string? RecipientEmail { get; private set; }
+        public string? RecipientName { get; private set; }
+
+        public Task SendAsync(
+            SmtpChannelSettings settings,
+            RenderedEmail email,
+            string recipientEmail,
+            string recipientName,
+            CancellationToken cancellationToken)
+        {
+            SendCount++;
+            Settings = settings;
+            Email = email;
+            RecipientEmail = recipientEmail;
+            RecipientName = recipientName;
+            return Task.CompletedTask;
+        }
+    }
+}
@@ -10,6 +10,7 @@
  <ItemGroup>
    <PackageReference Include="coverlet.collector" />
    <PackageReference Include="Microsoft.NET.Test.Sdk" />
+    <PackageReference Include="NSubstitute" />
    <PackageReference Include="xunit" />
    <PackageReference Include="xunit.runner.visualstudio" />
  </ItemGroup>
@@ -21,6 +22,10 @@
  <ItemGroup>
    <ProjectReference Include="..\HrynCo.NotificationService.Services\HrynCo.NotificationService.Services.csproj" />
    <ProjectReference Include="..\HrynCo.NotificationService.DAL.Abstract\HrynCo.NotificationService.DAL.Abstract.csproj" />
+    <ProjectReference Include="..\HrynCo.NotificationService.Contracts\HrynCo.NotificationService.Contracts.csproj" />
+    <ProjectReference Include="..\HrynCo.NotificationService.Worker.Services\HrynCo.NotificationService.Worker.Services.csproj" />
+    <ProjectReference Include="..\HrynCo.NotificationService.Worker\HrynCo.NotificationService.Worker.csproj" />
+    <ProjectReference Include="..\HrynCo.NotificationService.Migrator\HrynCo.NotificationService.Migrator.csproj" />
  </ItemGroup>

-</Project>
+</Project>
@@ -1,10 +0,0 @@
-namespace HrynCo.NotificationService.Services.Tests;
-
-public class UnitTest1
-{
-    [Fact]
-    public void Test1()
-    {
-
-    }
-}
@@ -1,5 +1,5 @@
 using HrynCo.Common;
-using HrynCo.NotificationService.DAL.Abstract;
+using HrynCo.DAL.Abstract;
 using MediatR;

 namespace HrynCo.NotificationService.Services.Behaviors;
@@ -18,11 +18,15 @@ public class TransactionBehavior<TRequest, TResponse> : IPipelineBehavior<TReque

    public Task<TResponse> Handle(TRequest request, RequestHandlerDelegate<TResponse> next, CancellationToken cancellationToken) =>
        _profiler.MeasureExecutionAsync(
-            () => _unitOfWork.ExecuteInTransactionAsync(async () =>
+            async () =>
            {
-                TResponse response = await next();
-                await _unitOfWork.SaveChangesAsync(cancellationToken);
-                return response;
-            }),
+                TResponse? response = default;
+                await _unitOfWork.ExecuteInTransactionAsync(async () =>
+                {
+                    response = await next();
+                });
+
+                return response!;
+            },
            typeof(TRequest).Name);
-}
+}
@@ -1,4 +1,3 @@
-using HrynCo.NotificationService.DAL.Abstract;
 using HrynCo.NotificationService.Services.Logging;
 using MediatR;
 using Serilog;
@@ -8,14 +7,12 @@ namespace HrynCo.NotificationService.Services.Core;
 public abstract class RequestHandler<TRequest, TResponse> : IRequestHandler<TRequest, TResponse>
    where TRequest : IRequest<TResponse>
 {
-    protected RequestHandler(IContextualSerilogLogger<TRequest> logger, IUnitOfWork unitOfWork)
+    protected RequestHandler(IContextualSerilogLogger<TRequest> logger)
    {
        Logger = logger.Logger;
-        UnitOfWork = unitOfWork;
    }

    protected ILogger Logger { get; }
-    protected IUnitOfWork UnitOfWork { get; }

    public Task<TResponse> Handle(TRequest request, CancellationToken cancellationToken)
    {
@@ -23,4 +20,4 @@ public abstract class RequestHandler<TRequest, TResponse> : IRequestHandler<TReq
    }

    protected abstract Task<TResponse> DoOnHandle(TRequest request, CancellationToken cancellationToken);
-}
+}
@@ -1,4 +1,4 @@
-using HrynCo.NotificationService.DAL.Abstract;
+using HrynCo.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Providers;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.Services.Core;
@@ -14,9 +14,8 @@ internal sealed class CreateEmailChannelHandler

    public CreateEmailChannelHandler(
        IContextualSerilogLogger<CreateEmailChannelCommand> logger,
-        IUnitOfWork unitOfWork,
        IEmailChannelRepository channels)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _channels = channels;
    }
@@ -1,4 +1,4 @@
-using HrynCo.NotificationService.DAL.Abstract;
+using HrynCo.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.Services.Core;
 using HrynCo.NotificationService.Services.Logging;
@@ -13,9 +13,8 @@ internal sealed class DeleteEmailChannelHandler

    public DeleteEmailChannelHandler(
        IContextualSerilogLogger<DeleteEmailChannelCommand> logger,
-        IUnitOfWork unitOfWork,
        IEmailChannelRepository channels)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _channels = channels;
    }
@@ -1,4 +1,3 @@
-using HrynCo.NotificationService.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Providers;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.Services.Core;
@@ -14,9 +13,8 @@ internal sealed class GetEmailChannelHandler

    public GetEmailChannelHandler(
        IContextualSerilogLogger<GetEmailChannelQuery> logger,
-        IUnitOfWork unitOfWork,
        IEmailChannelRepository channels)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _channels = channels;
    }
@@ -1,4 +1,3 @@
-using HrynCo.NotificationService.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Providers;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.Services.Core;
@@ -14,9 +13,8 @@ internal sealed class GetAllEmailChannelsHandler

    public GetAllEmailChannelsHandler(
        IContextualSerilogLogger<GetAllEmailChannelsQuery> logger,
-        IUnitOfWork unitOfWork,
        IEmailChannelRepository channels)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _channels = channels;
    }
@@ -1,4 +1,3 @@
-using HrynCo.NotificationService.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Providers;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.Services.Core;
@@ -14,9 +13,8 @@ internal sealed class GetEmailChannelsHandler

    public GetEmailChannelsHandler(
        IContextualSerilogLogger<GetEmailChannelsQuery> logger,
-        IUnitOfWork unitOfWork,
        IEmailChannelRepository channels)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _channels = channels;
    }
@@ -1,4 +1,3 @@
-using HrynCo.NotificationService.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.Services.Core;
 using HrynCo.NotificationService.Services.Logging;
@@ -13,9 +12,8 @@ internal sealed class GetChannelUsageSummaryHandler

    public GetChannelUsageSummaryHandler(
        IContextualSerilogLogger<GetChannelUsageSummaryQuery> logger,
-        IUnitOfWork unitOfWork,
        IEmailChannelRepository channelsRepository)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _channelsRepository = channelsRepository;
    }
@@ -1,6 +1,6 @@
 using System.Net;
 using System.Net.Mail;
-using HrynCo.NotificationService.DAL.Abstract;
+using System.Text;
 using HrynCo.NotificationService.DAL.Abstract.Providers;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.Services.Core;
@@ -17,10 +17,9 @@ internal sealed class SendEmailHandler

    public SendEmailHandler(
        IContextualSerilogLogger<SendEmailCommand> logger,
-        IUnitOfWork unitOfWork,
        IEmailChannelRepository channels,
        IEmailChannelUsageRepository usage)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _channels = channels;
        _usage = usage;
@@ -50,14 +49,16 @@ internal sealed class SendEmailHandler
            {
                From = new MailAddress(smtp.FromEmail, smtp.FromName),
                Subject = request.Subject,
-                Body = request.HtmlBody,
-                IsBodyHtml = true
+                Body = request.TextBody ?? string.Empty,
+                IsBodyHtml = false,
+                BodyEncoding = Encoding.UTF8,
+                SubjectEncoding = Encoding.UTF8
            };

-            if (!string.IsNullOrWhiteSpace(request.TextBody))
+            if (!string.IsNullOrWhiteSpace(request.HtmlBody))
            {
-                var plain = AlternateView.CreateAlternateViewFromString(request.TextBody, null, "text/plain");
-                mail.AlternateViews.Add(plain);
+                var html = AlternateView.CreateAlternateViewFromString(request.HtmlBody, Encoding.UTF8, "text/html");
+                mail.AlternateViews.Add(html);
            }

            mail.To.Add(new MailAddress(request.RecipientEmail, request.RecipientName));
@@ -0,0 +1,18 @@
+using HrynCo.NotificationService.Services.Core;
+using MediatR;
+
+namespace HrynCo.NotificationService.Services.EmailChannels.TestSmtp;
+
+/// <summary>
+/// Sends a test email using the provided SMTP settings without persisting anything.
+/// </summary>
+public sealed record TestSmtpCommand(
+    string Host,
+    int Port,
+    string Username,
+    string Password,
+    bool UseSsl,
+    string FromEmail,
+    string FromName,
+    string ToEmail
+) : IRequest<ServiceResult<Core.Unit>>;
@@ -0,0 +1,50 @@
+using System.Net;
+using System.Net.Mail;
+using HrynCo.NotificationService.Services.Core;
+using HrynCo.NotificationService.Services.Logging;
+using static HrynCo.NotificationService.Services.Core.ServiceResultHelper;
+
+namespace HrynCo.NotificationService.Services.EmailChannels.TestSmtp;
+
+internal sealed class TestSmtpHandler
+    : RequestHandler<TestSmtpCommand, ServiceResult<Unit>>
+{
+    public TestSmtpHandler(
+        IContextualSerilogLogger<TestSmtpCommand> logger)
+        : base(logger)
+    {
+    }
+
+    protected override async Task<ServiceResult<Unit>> DoOnHandle(
+        TestSmtpCommand request, CancellationToken cancellationToken)
+    {
+        try
+        {
+            using var client = new SmtpClient(request.Host, request.Port)
+            {
+                EnableSsl = request.UseSsl,
+                Credentials = string.IsNullOrWhiteSpace(request.Username)
+                    ? null
+                    : new NetworkCredential(request.Username, request.Password)
+            };
+
+            using var mail = new MailMessage
+            {
+                From = new MailAddress(request.FromEmail, request.FromName),
+                Subject = "✅ Test email from Notification Service",
+                Body = "<p>This is a test email sent from the <b>Notification Service</b> admin panel to verify the channel settings.</p>",
+                IsBodyHtml = true
+            };
+            mail.To.Add(new MailAddress(request.ToEmail));
+
+            await client.SendMailAsync(mail, cancellationToken);
+        }
+        catch (Exception ex)
+        {
+            Logger.Error(ex, "Ad-hoc SMTP test failed for host {Host}", request.Host);
+            return Failure<Unit>(ex.Message);
+        }
+
+        return Success(Unit.Value);
+    }
+}
@@ -1,4 +1,4 @@
-using HrynCo.NotificationService.DAL.Abstract;
+using HrynCo.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.Services.Core;
 using HrynCo.NotificationService.Services.Logging;
@@ -13,9 +13,8 @@ internal sealed class UpdateEmailChannelHandler

    public UpdateEmailChannelHandler(
        IContextualSerilogLogger<UpdateEmailChannelCommand> logger,
-        IUnitOfWork unitOfWork,
        IEmailChannelRepository channels)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _channels = channels;
    }
@@ -1,4 +1,3 @@
-using HrynCo.NotificationService.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.DAL.Abstract.Templates;
 using HrynCo.NotificationService.Services.Core;
@@ -14,9 +13,8 @@ internal sealed class CreateEmailTemplateHandler

    public CreateEmailTemplateHandler(
        IContextualSerilogLogger<CreateEmailTemplateCommand> logger,
-        IUnitOfWork unitOfWork,
        IEmailTemplateRepository templates)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _templates = templates;
    }
@@ -41,7 +39,14 @@ internal sealed class CreateEmailTemplateHandler
            Variables = request.Variables
        };

-        await _templates.AddAsync(template, cancellationToken);
+        try
+        {
+            await _templates.AddAsync(template, cancellationToken);
+        }
+        catch (EmailTemplateWriteException error)
+        {
+            return Failure<Guid>(error.Message, error.IsConflict ? ServiceErrorCode.Conflict : ServiceErrorCode.InvalidRequest);
+        }

        return Success(template.Id);
    }
@@ -7,5 +7,6 @@ namespace HrynCo.NotificationService.Services.EmailTemplates.Delete;
 public sealed record DeleteEmailTemplateCommand(
    string ServiceName,
    string Key,
-    string LanguageCode
+    string LanguageCode,
+    Guid? ExpectedVersionId = null
 ) : IRequest<ServiceResult<Unit>>;
@@ -1,4 +1,5 @@
-using HrynCo.NotificationService.DAL.Abstract;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.Services.Core;
 using HrynCo.NotificationService.Services.Logging;
@@ -13,9 +14,8 @@ internal sealed class DeleteEmailTemplateHandler

    public DeleteEmailTemplateHandler(
        IContextualSerilogLogger<DeleteEmailTemplateCommand> logger,
-        IUnitOfWork unitOfWork,
        IEmailTemplateRepository templates)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _templates = templates;
    }
@@ -28,8 +28,17 @@ internal sealed class DeleteEmailTemplateHandler

        if (template is null)
            return Failure<Unit>("Template not found.", ServiceErrorCode.NotFound);
+        if (request.ExpectedVersionId is Guid expectedId && template.Id != expectedId)
+            return Failure<Unit>("Template changed after you opened it. Reload before deleting.", ServiceErrorCode.Conflict);

-        await _templates.DeleteAsync(template, cancellationToken);
+        try
+        {
+            await _templates.DeleteAsync(template, cancellationToken);
+        }
+        catch (EmailTemplateWriteException error)
+        {
+            return Failure<Unit>(error.Message, error.IsConflict ? ServiceErrorCode.Conflict : ServiceErrorCode.InvalidRequest);
+        }

        return Success(Unit.Value);
    }
@@ -1,4 +1,3 @@
-using HrynCo.NotificationService.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.DAL.Abstract.Templates;
 using HrynCo.NotificationService.Services.Core;
@@ -14,9 +13,8 @@ internal sealed class GetEmailTemplateHandler

    public GetEmailTemplateHandler(
        IContextualSerilogLogger<GetEmailTemplateQuery> logger,
-        IUnitOfWork unitOfWork,
        IEmailTemplateRepository templates)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _templates = templates;
    }
@@ -1,4 +1,3 @@
-using HrynCo.NotificationService.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.DAL.Abstract.Templates;
 using HrynCo.NotificationService.Services.Core;
@@ -14,9 +13,8 @@ internal sealed class GetAllEmailTemplatesHandler

    public GetAllEmailTemplatesHandler(
        IContextualSerilogLogger<GetAllEmailTemplatesQuery> logger,
-        IUnitOfWork unitOfWork,
        IEmailTemplateRepository templates)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _templates = templates;
    }
@@ -24,7 +22,7 @@ internal sealed class GetAllEmailTemplatesHandler
    protected override async Task<ServiceResult<IReadOnlyList<EmailTemplate>>> DoOnHandle(
        GetAllEmailTemplatesQuery request, CancellationToken cancellationToken)
    {
-        var templates = await _templates.GetAllAsync(cancellationToken);
+        var templates = await _templates.GetAllAsync(request.ServiceName, request.Key, cancellationToken);
        return Success(templates);
    }
 }
@@ -4,4 +4,5 @@ using HrynCo.NotificationService.Services.Core;

 namespace HrynCo.NotificationService.Services.EmailTemplates.GetAll;

-public sealed record GetAllEmailTemplatesQuery : IRequest<ServiceResult<IReadOnlyList<EmailTemplate>>>;
+public sealed record GetAllEmailTemplatesQuery(string? ServiceName = null, string? Key = null)
+    : IRequest<ServiceResult<IReadOnlyList<EmailTemplate>>>;
@@ -1,4 +1,3 @@
-using HrynCo.NotificationService.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.DAL.Abstract.Templates;
 using HrynCo.NotificationService.Services.Core;
@@ -14,9 +13,8 @@ internal sealed class GetEmailTemplatesHandler

    public GetEmailTemplatesHandler(
        IContextualSerilogLogger<GetEmailTemplatesQuery> logger,
-        IUnitOfWork unitOfWork,
        IEmailTemplateRepository templates)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _templates = templates;
    }
@@ -0,0 +1,8 @@
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.NotificationService.Services.Core;
+using MediatR;
+
+namespace HrynCo.NotificationService.Services.EmailTemplates.SaveDefinition;
+
+public sealed record SaveEmailTemplateDefinitionCommand(EmailTemplateDefinition Definition, bool IsNew)
+    : IRequest<ServiceResult<Guid>>;
@@ -0,0 +1,26 @@
+using HrynCo.NotificationService.DAL.Abstract.Repositories;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.NotificationService.Services.Core;
+using HrynCo.NotificationService.Services.Logging;
+using static HrynCo.NotificationService.Services.Core.ServiceResultHelper;
+
+namespace HrynCo.NotificationService.Services.EmailTemplates.SaveDefinition;
+
+internal sealed class SaveEmailTemplateDefinitionHandler(
+    IContextualSerilogLogger<SaveEmailTemplateDefinitionCommand> logger,
+    IEmailTemplateDefinitionRepository definitions)
+    : RequestHandler<SaveEmailTemplateDefinitionCommand, ServiceResult<Guid>>(logger)
+{
+    protected override async Task<ServiceResult<Guid>> DoOnHandle(SaveEmailTemplateDefinitionCommand request, CancellationToken cancellationToken)
+    {
+        try
+        {
+            await definitions.SaveDefinitionAsync(request.Definition, request.IsNew, cancellationToken);
+            return Success(request.Definition.Id);
+        }
+        catch (EmailTemplateWriteException error)
+        {
+            return Failure<Guid>(error.Message, error.IsConflict ? ServiceErrorCode.Conflict : ServiceErrorCode.InvalidRequest);
+        }
+    }
+}
@@ -1,4 +1,5 @@
-using HrynCo.NotificationService.DAL.Abstract;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.DAL.Abstract;
 using HrynCo.NotificationService.DAL.Abstract.Repositories;
 using HrynCo.NotificationService.Services.Core;
 using HrynCo.NotificationService.Services.Logging;
@@ -13,9 +14,8 @@ internal sealed class UpdateEmailTemplateHandler

    public UpdateEmailTemplateHandler(
        IContextualSerilogLogger<UpdateEmailTemplateCommand> logger,
-        IUnitOfWork unitOfWork,
        IEmailTemplateRepository templates)
-        : base(logger, unitOfWork)
+        : base(logger)
    {
        _templates = templates;
    }
@@ -35,7 +35,14 @@ internal sealed class UpdateEmailTemplateHandler
        template.Variables = request.Variables;
        template.Updated = DateTimeOffset.UtcNow;

-        await _templates.UpdateAsync(template, cancellationToken);
+        try
+        {
+            await _templates.UpdateAsync(template, cancellationToken);
+        }
+        catch (EmailTemplateWriteException error)
+        {
+            return Failure<Unit>(error.Message, error.IsConflict ? ServiceErrorCode.Conflict : ServiceErrorCode.InvalidRequest);
+        }

        return Success(Unit.Value);
    }
@@ -0,0 +1,7 @@
+using HrynCo.NotificationService.Services.Core;
+using MediatR;
+using Unit = HrynCo.NotificationService.Services.Core.Unit;
+
+namespace HrynCo.NotificationService.Services.TemplateDefinitions;
+
+public sealed record DeleteEmailTemplateDefinitionCommand(Guid ServiceId, string Key, Guid Revision) : IRequest<ServiceResult<Unit>>;
@@ -0,0 +1,25 @@
+using HrynCo.NotificationService.DAL.Abstract.Repositories;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.NotificationService.Services.Core;
+using HrynCo.NotificationService.Services.Logging;
+using static HrynCo.NotificationService.Services.Core.ServiceResultHelper;
+
+namespace HrynCo.NotificationService.Services.TemplateDefinitions;
+
+internal sealed class DeleteEmailTemplateDefinitionHandler(
+    IContextualSerilogLogger<DeleteEmailTemplateDefinitionCommand> logger, IEmailTemplateDefinitionRepository repository)
+    : RequestHandler<DeleteEmailTemplateDefinitionCommand, ServiceResult<Unit>>(logger)
+{
+    protected override async Task<ServiceResult<Unit>> DoOnHandle(DeleteEmailTemplateDefinitionCommand request, CancellationToken cancellationToken)
+    {
+        try
+        {
+            var removed = await repository.DeleteDefinitionAsync(request.ServiceId, request.Key, request.Revision, cancellationToken);
+            return removed ? Success(Unit.Value) : Failure<Unit>("Template definition not found.", ServiceErrorCode.NotFound);
+        }
+        catch (EmailTemplateWriteException error)
+        {
+            return Failure<Unit>(error.Message, error.IsConflict ? ServiceErrorCode.Conflict : ServiceErrorCode.InvalidRequest);
+        }
+    }
+}
@@ -0,0 +1,7 @@
+using HrynCo.NotificationService.Services.Core;
+using MediatR;
+using Unit = HrynCo.NotificationService.Services.Core.Unit;
+
+namespace HrynCo.NotificationService.Services.TemplateDefinitions;
+
+public sealed record DeleteNotificationServiceCommand(Guid ServiceId, Guid Revision) : IRequest<ServiceResult<Unit>>;
@@ -0,0 +1,25 @@
+using HrynCo.NotificationService.DAL.Abstract.Repositories;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.NotificationService.Services.Core;
+using HrynCo.NotificationService.Services.Logging;
+using static HrynCo.NotificationService.Services.Core.ServiceResultHelper;
+
+namespace HrynCo.NotificationService.Services.TemplateDefinitions;
+
+internal sealed class DeleteNotificationServiceHandler(
+    IContextualSerilogLogger<DeleteNotificationServiceCommand> logger, INotificationServiceRepository repository)
+    : RequestHandler<DeleteNotificationServiceCommand, ServiceResult<Unit>>(logger)
+{
+    protected override async Task<ServiceResult<Unit>> DoOnHandle(DeleteNotificationServiceCommand request, CancellationToken cancellationToken)
+    {
+        try
+        {
+            var removed = await repository.DeleteAsync(request.ServiceId, request.Revision, cancellationToken);
+            return removed ? Success(Unit.Value) : Failure<Unit>("Service not found.", ServiceErrorCode.NotFound);
+        }
+        catch (EmailTemplateWriteException error)
+        {
+            return Failure<Unit>(error.Message, error.IsConflict ? ServiceErrorCode.Conflict : ServiceErrorCode.InvalidRequest);
+        }
+    }
+}
@@ -0,0 +1,7 @@
+using HrynCo.NotificationService.Services.Core;
+using MediatR;
+using Unit = HrynCo.NotificationService.Services.Core.Unit;
+
+namespace HrynCo.NotificationService.Services.TemplateDefinitions;
+
+public sealed record DeleteServiceLanguageVersionsCommand(Guid ServiceId, Guid LanguageId, Guid Revision, int ExpectedVersionCount, bool ConfirmDelete) : IRequest<ServiceResult<Unit>>;
@@ -0,0 +1,30 @@
+using HrynCo.NotificationService.DAL.Abstract.Repositories;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.NotificationService.Services.Core;
+using HrynCo.NotificationService.Services.Logging;
+using static HrynCo.NotificationService.Services.Core.ServiceResultHelper;
+
+namespace HrynCo.NotificationService.Services.TemplateDefinitions;
+
+internal sealed class DeleteServiceLanguageVersionsHandler(
+    IContextualSerilogLogger<DeleteServiceLanguageVersionsCommand> logger, INotificationServiceRepository services)
+    : RequestHandler<DeleteServiceLanguageVersionsCommand, ServiceResult<Unit>>(logger)
+{
+    protected override async Task<ServiceResult<Unit>> DoOnHandle(DeleteServiceLanguageVersionsCommand request, CancellationToken cancellationToken)
+    {
+        if (!request.ConfirmDelete || request.ExpectedVersionCount < 0 || request.Revision == Guid.Empty)
+            return Failure<Unit>("ConfirmDelete must be true; a nonnegative expectedVersionCount and nonempty service revision are required.", ServiceErrorCode.InvalidRequest);
+        var service = await services.GetAsync(request.ServiceId, cancellationToken);
+        if (service?.Languages.Any(l => l.Id == request.LanguageId) != true)
+            return Failure<Unit>("Service language not found.", ServiceErrorCode.NotFound);
+        try
+        {
+            await services.RemoveLanguageAsync(request.ServiceId, request.LanguageId, request.ExpectedVersionCount, request.Revision, cancellationToken);
+            return Success(Unit.Value);
+        }
+        catch (EmailTemplateWriteException error)
+        {
+            return Failure<Unit>(error.Message, error.IsConflict ? ServiceErrorCode.Conflict : ServiceErrorCode.InvalidRequest);
+        }
+    }
+}
@@ -0,0 +1,7 @@
+using HrynCo.NotificationService.Services.Core;
+using MediatR;
+using Unit = HrynCo.NotificationService.Services.Core.Unit;
+
+namespace HrynCo.NotificationService.Services.TemplateDefinitions;
+
+public sealed record DeleteUnusedServiceLanguageCommand(Guid ServiceId, Guid LanguageId, Guid Revision) : IRequest<ServiceResult<Unit>>;
@@ -0,0 +1,34 @@
+using HrynCo.NotificationService.DAL.Abstract.Repositories;
+using HrynCo.NotificationService.DAL.Abstract.Templates;
+using HrynCo.NotificationService.Services.Core;
+using HrynCo.NotificationService.Services.Logging;
+using static HrynCo.NotificationService.Services.Core.ServiceResultHelper;
+
+namespace HrynCo.NotificationService.Services.TemplateDefinitions;
+
+internal sealed class DeleteUnusedServiceLanguageHandler(
+    IContextualSerilogLogger<DeleteUnusedServiceLanguageCommand> logger, INotificationServiceRepository services)
+    : RequestHandler<DeleteUnusedServiceLanguageCommand, ServiceResult<Unit>>(logger)
+{
+    protected override async Task<ServiceResult<Unit>> DoOnHandle(DeleteUnusedServiceLanguageCommand request, CancellationToken cancellationToken)
+    {
+        if (request.Revision == Guid.Empty)
+            return Failure<Unit>("A nonempty service revision is required.", ServiceErrorCode.InvalidRequest);
+        var service = await services.GetAsync(request.ServiceId, cancellationToken);
+        var language = service?.Languages.SingleOrDefault(l => l.Id == request.LanguageId);
+        if (language is null)
+            return Failure<Unit>("Service language not found.", ServiceErrorCode.NotFound);
+        if (language.VersionCount > 0)
+            return Failure<Unit>("This language has template versions. Use delete-with-versions with explicit confirmation and the current count.", ServiceErrorCode.Conflict);
+        try
+        {
+            // The repository repeats the zero-count and revision checks under its mutation lock.
+            await services.RemoveLanguageAsync(request.ServiceId, request.LanguageId, 0, request.Revision, cancellationToken);
+            return Success(Unit.Value);
+        }
+        catch (EmailTemplateWriteException error)
+        {
+            return Failure<Unit>(error.Message, error.IsConflict ? ServiceErrorCode.Conflict : ServiceErrorCode.InvalidRequest);
+        }
+    }
+}
@@ -0,0 +1,5 @@
+namespace HrynCo.NotificationService.Services.TemplateDefinitions;
+
+public sealed record EmailTemplateDefinitionDto(Guid Id, Guid ServiceId, string ServiceName, string Key, Guid Revision,
+    IReadOnlyList<TemplateVariableDto> Variables, IReadOnlyList<TemplateTranslationDto> Translations,
+    DateTimeOffset Created, DateTimeOffset? Updated);
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
agrynco	8e81572386	feat(notification): add admin rest management and deletion Add revision-safe service and template APIs, channel mapping, and validated admin controls. Ref: IT-1601	2026-10-17 22:51:01 +03:00
agrynco	81654c0d33	feat(templates): add service language template management Add normalized service and template catalogs, scoped administration, migration, validation, and regression coverage. Ref: IT-1601	2026-10-17 22:02:43 +03:00
agrynco	36810dc5f1	Merge pull request 'feat(notification): enable Invemory production publisher' (#21 ) from feature/it-1493-notification-k8s into main	2026-10-03 15:19:39 +03:00
agrynco	8d9ed96f2c	feat(notification): enable production publisher Preserve production broker definitions and allow bounded SMTP delivery. Ref: IT-1508	2026-10-03 15:18:03 +03:00
agrynco	a684caf7f7	Merge pull request 'chore: preserve current configuration and documentation' (#20 ) from feature/it-1493-notification-k8s into main	2026-10-03 00:59:44 +03:00
agrynco	27f3603d8f	chore: preserve current workspace changes Save pending configuration, deployment, and documentation work.	2026-10-03 00:56:28 +03:00
agrynco	a44b98292f	Merge pull request 'chore(notification): update service host references' (#19 ) from feature/hrynco-service-hosts into main	2026-10-02 20:18:50 +03:00
agrynco	b088640e9b	chore(notification): update service host references Point production image and package metadata references to hrynco.com. Ref: IT-1493	2026-10-02 20:18:18 +03:00
agrynco	26847f1e9f	Merge pull request 'fix: escape html notification variables' (#18 ) from feature/it-1115-html-template-escaping into main Reviewed-on: #18	2026-08-19 23:07:03 +03:00
agrynco	50033a5bd4	fix: escape html notification variables Encode template variables in HTML bodies while preserving text and subjects. Ref: IT-1115	2026-08-19 23:04:15 +03:00
agrynco	01c622038d	Merge pull request 'fix: correct notification template filter links' (#15 ) from bugfix/it-1039-template-filter-links into main Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/15	2026-08-04 21:02:59 +03:00
agrynco	1ceb71b9a2	fix: correct notification template filter links Use explicit Razor interpolation for create and edit URLs and cover the rendered link syntax with a regression test. Ref: IT-1039	2026-08-04 21:01:46 +03:00
agrynco	bb0de0f2c1	Merge pull request 'feat: consume transactional email notifications' (#14 ) from development into main Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/14	2026-08-04 13:39:28 +03:00
agrynco	d5a2e538f0	Merge pull request 'Merge pull request 'chore: update package versions and refactor TransactionBehavior' (#4 ) from development into main' (#13 ) from IT-1033 into development Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/13	2026-08-04 13:39:04 +03:00
agrynco	9d6b0717e6	docs: document repository git workflow Record the main-based branch and delivery rules for future changes. Ref: IT-1033	2026-08-04 12:32:28 +03:00
agrynco	2757869176	feat: consume transactional email notifications Add contract validation, SMTP delivery results, terminal failure context, neutral development seeding, and local Docker setup. Ref: IT-1033	2026-08-04 12:32:28 +03:00
agrynco	b8435ac07b	Merge pull request 'feat: add persistence and restoration of email template filters in UI and backend' (#12 ) from development into main Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/12	2026-05-17 13:53:58 +03:00
agrynco	cc3857a409	feat: add persistence and restoration of email template filters in UI and backend	2026-05-17 13:53:37 +03:00
agrynco	94f0d45aaf	Merge pull request 'feat: add filtering by `ServiceName` and `Key` in email templates query and UI' (#11 ) from development into main Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/11	2026-05-17 11:43:55 +03:00
agrynco	07f536938f	feat: add filtering by `ServiceName` and `Key` in email templates query and UI	2026-05-17 11:43:25 +03:00
agrynco	e7d3953747	Merge pull request 'refactor: add ordering by `ServiceName` and `Key` in `GetAllAsync` method' (#10 ) from development into main Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/10	2026-05-17 11:34:15 +03:00
agrynco	3381fcc2f8	refactor: add ordering by `ServiceName` and `Key` in `GetAllAsync` method	2026-05-17 11:31:44 +03:00
agrynco	3bd952ef9e	Merge pull request 'refactor: simplify `Program.cs` and clean up `NuGet.Config`' (#9 ) from development into main Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/9	2026-05-17 11:18:43 +03:00
agrynco	285cc6abb7	refactor: simplify `Program.cs` and clean up `NuGet.Config`	2026-05-17 11:18:05 +03:00
agrynco	9589095760	Merge pull request 'refactor: modularize email processing logic and improve service structure' (#8 ) from development into main Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/8	2026-05-14 22:21:30 +03:00
Anatolii Grynchuk	25fb48ccf0	refactor: modularize email processing logic and improve service structure - Extract email template handling, rendering, and sending code into `Worker.Services` project. - Introduce `EmailTemplateService`, `EmailTemplateRenderingService`, and `SendEmailService`. - Simplify consumer logic by delegating to scoped services. - Update project dependencies and package references accordingly.	2026-05-14 22:15:15 +03:00
agrynco	ab042c7617	Merge pull request 'refactor: improve UpdateAsync in EmailTemplateRepository for better entity handling' (#7 ) from development into main Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/7	2026-05-13 03:40:31 +03:00
Anatolii Grynchuk	0861e18cec	refactor: improve UpdateAsync in EmailTemplateRepository for better entity handling - Add null check and fetch entity before updating fields. - Replace the direct property assignment with detailed updates. - Ensure changes are saved using SaveChangesAsync.	2026-05-13 03:39:44 +03:00
agrynco	dfa097eb43	Merge pull request 'refactor: replace internal UnitOfWork with NotificationUnitOfWork and NotificationBaseRepository' (#6 ) from development into main Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/6	2026-05-13 02:12:35 +03:00
Anatolii Grynchuk	c18f0b7fb1	refactor: update admin CSS for improved layout and readability - Switch `.template-preview-variables` to grid layout for better responsiveness. - Adjust form label font size and spacing for consistency. - Enhance styles of `.form-control-sm` for improved usability.	2026-05-13 02:11:59 +03:00
Anatolii Grynchuk	50828d23ec	refactor: replace internal UnitOfWork with NotificationUnitOfWork and NotificationBaseRepository - Consolidate unit of work implementation with NotificationUnitOfWork. - Refactor repositories to use NotificationBaseRepository for consistency. - Simplify request handlers by removing IUnitOfWork dependency. - Update related tests and service registration.	2026-05-13 02:08:43 +03:00
agrynco	f3966705ad	Merge pull request 'refactor: use AsNoTracking for email template queries to improve performance' (#5 ) from development into main Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/5	2026-05-12 22:21:32 +03:00
Anatolii Grynchuk	b4d8497ea7	refactor: use AsNoTracking for email template queries to improve performance	2026-05-12 22:21:00 +03:00
agrynco	7b77062aa7	Merge pull request 'chore: update package versions and refactor TransactionBehavior' (#4 ) from development into main Reviewed-on: https://gitea.grynco.com.ua/hrynco/hrynco-notification-service/pulls/4	2026-05-12 21:58:57 +03:00
Anatolii Grynchuk	9490718c04	feat: add real-time email template preview with variable interpolation - Introduce preview panel to edit form for rendering subject, HTML, and text with sample values. - Add support for real-time updates using JavaScript. - Include supporting styles for preview panel in admin CSS. - Add optional `Scripts` section rendering to `_EditorLayout`. - Create `.env.Development` for better development environment configuration.	2026-05-12 21:56:50 +03:00
Anatolii Grynchuk	0d1aa4f6be	chore: update package versions and refactor TransactionBehavior - Upgrade EF Core packages to 10.0.x and HrynCo.DAL.Abstract to 1.0.10 - Refactor TransactionBehavior to simplify transaction handling logic	2026-05-12 21:37:38 +03:00
agrynco	637af06a9c	Merge pull request 'refactor: replace local DAL abstractions with hrynco-ef packages' (#3 ) from development into main	2026-05-05 20:40:15 +03:00
agrynco	334bf2a567	Merge pull request 'refactor: replace local DAL abstractions with hrynco-ef packages' (#2 ) from use-hrynco-ef-packages into development	2026-05-05 20:40:07 +03:00
Anatolii Grynchuk	ee4c988a0d	refactor: replace local dal abstractions with hrynco-ef packages Remove duplicate IEntity, Entity, ITransaction, IUnitOfWork, EfRepository, EfUnitOfWork, EfTransactionAdapter — now consumed from HrynCo.DAL.Abstract and HrynCo.DAL.EF packages (1.0.1). Ref: IT-0	2026-05-05 20:39:06 +03:00
agrynco	9c2edd4712	Merge pull request 'release: development -> main' (#1 ) from development into main	2026-05-02 23:48:34 +03:00
Anatolii Grynchuk	49982fc27f	chore: add Application property to Serilog for log filtering - Worker logs tagged as 'hrynco-notification-service-worker' - Web logs tagged as 'hrynco-notification-service-web' Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>	2026-05-02 23:47:48 +03:00
Anatolii Grynchuk	5c7b5f7b10	Merge branch 'development'	2026-05-02 19:53:26 +03:00
Anatolii Grynchuk	6302a07178	feat: add test button to create channel form using ad-hoc smtp test endpoint - Add TestSmtpCommand and TestSmtpHandler for ad-hoc smtp testing without saving - Add POST /admin/channels/test-smtp endpoint accepting raw smtp settings - Show Test button on both Create and Edit forms - Test reads current form values so channel can be tested before saving	2026-05-02 19:53:20 +03:00
Anatolii Grynchuk	b07cd06477	Merge branch 'development'	2026-05-02 18:50:17 +03:00
Anatolii Grynchuk	3e1cc696c1	fix: rename api service to web in all docker-compose files - Aligns compose service name with the image name (hrynco.notification-service.web) - Rename API_PORT env var to WEB_PORT for consistency Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>	2026-05-02 18:50:16 +03:00
Anatolii Grynchuk	9a0aaf629b	Merge branch 'development'	2026-05-02 18:43:21 +03:00
Anatolii Grynchuk	d71c3513a5	fix: add missing FK migration for EmailChannelUsage -> EmailChannel - EF model had a pending HasOne/WithMany relationship not in migrations - Adds FK_email_channel_usage_email_channels_provider_id with cascade delete Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>	2026-05-02 18:43:20 +03:00
Anatolii Grynchuk	859ae0b50d	Merge branch 'development'	2026-05-02 18:31:36 +03:00
Anatolii Grynchuk	c5528b253d	fix: add internal network to migrator, api, worker services - migrator, api, worker were missing 'networks: - internal' - db and rabbitmq are only on internal network, so services couldn't reach them - also changed api depends_on db condition to service_healthy Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>	2026-05-02 18:31:34 +03:00
Anatolii Grynchuk	09c3985fad	Merge branch 'development'	2026-05-02 16:38:10 +03:00
Anatolii Grynchuk	166b1a6103	fix: wait for postgres healthcheck before running migrator - Add pg_isready healthcheck to db service (5s interval, 10 retries) - Change migrator depends_on condition: service_started -> service_healthy - Prevents migrator connection failure on fresh postgres startup Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>	2026-05-02 16:38:09 +03:00
Anatolii Grynchuk	8dab3c0dc0	Merge branch 'development'	2026-05-02 15:40:13 +03:00
Anatolii Grynchuk	c88511ce3b	chore: update package versions and formatting in Directory.Packages.props Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>	2026-05-02 15:40:12 +03:00
Anatolii Grynchuk	a6f9a0a530	Merge branch 'development'	2026-05-02 15:25:10 +03:00
Anatolii Grynchuk	ae119d1a3d	feat: add production docker-compose with hrynco-services network - Base compose: explicit internal network, named volumes with VOLUME_PREFIX - docker-compose.prod.yml: production images, ports, restart policies, hrynco-services external network on rabbitmq - docker-compose.Development.yml: cleaned up orphan volumes, named dev volumes Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>	2026-05-02 15:25:09 +03:00
Anatolii Grynchuk	c303514414	Merge branch 'development'	2026-05-02 14:40:07 +03:00
Anatolii Grynchuk	74211f0a4a	chore: add NuGet metadata to Contracts project - Add PackageId, Authors, Description, PackageTags, RepositoryUrl - Matches metadata pattern from HrynCo.Common and HrynCo.RabbitMq Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>	2026-05-02 14:40:01 +03:00
Anatolii Grynchuk	18f7981ccc	merge: development -> main	2026-05-02 14:23:18 +03:00
Anatolii Grynchuk	5003ab8764	fix: move ManagePackageVersionsCentrally to Directory.Packages.props Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>	2026-05-02 14:23:17 +03:00
Anatolii Grynchuk	4a431ec6c6	merge: IT-628 RabbitMQ worker, contracts, usage UI in channels screen	2026-05-02 14:01:04 +03:00