feat: close preprod observability loop

.gitea/workflows/deploy-socialize.yml

@@ -24,7 +24,7 @@ jobs:
             -t git.mapachotes.com/jbourdon/socialize-api:latest \
             -f backend/src/Socialize.Api/Dockerfile .
           docker build \
-            --build-arg VITE_API_URL=/api \
+            --build-arg VITE_API_URL=/ \
             -t git.mapachotes.com/jbourdon/socialize-web:${{ gitea.sha }} \
             -t git.mapachotes.com/jbourdon/socialize-web:latest \
             -f frontend/Dockerfile .
@@ -37,8 +37,9 @@ jobs:
 
   deploy:
     needs: image
-    runs-on: bookworm
+    runs-on: ubuntu-latest
     steps:
+      - uses: actions/checkout@v4
       - name: Install SSH client
         run: apt-get update && apt-get install -y openssh-client
       - name: Deploy on sobina
@@ -46,9 +47,29 @@ jobs:
           DEPLOY_HOST: ${{ secrets.DEPLOY_HOST }}
           DEPLOY_USER: ${{ secrets.DEPLOY_USER }}
           DEPLOY_SSH_PRIVATE_KEY_B64: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY_B64 }}
+          SOCIALIZE_IMAGE_TAG: ${{ gitea.sha }}
         run: |
+          : "${SOCIALIZE_IMAGE_TAG:?SOCIALIZE_IMAGE_TAG is required}"
+
           mkdir -p ~/.ssh
           printf '%s' "$DEPLOY_SSH_PRIVATE_KEY_B64" | base64 -d > ~/.ssh/deploy_key
           chmod 600 ~/.ssh/deploy_key
+
+          write_env_value() {
+            key="$1"
+            value="$2"
+            escaped_value="$(printf '%s' "$value" | sed "s/'/'\\\\''/g")"
+            printf "%s='%s'\n" "$key" "$escaped_value"
+          }
+
+          deploy_env="$(mktemp)"
+          {
+            write_env_value SOCIALIZE_IMAGE_TAG "$SOCIALIZE_IMAGE_TAG"
+          } > "$deploy_env"
+
+          scp -i ~/.ssh/deploy_key -o StrictHostKeyChecking=accept-new "$deploy_env" "$DEPLOY_USER@$DEPLOY_HOST:/srv/prod/socialize/.deploy.env"
+          rm -f "$deploy_env"
+          scp -i ~/.ssh/deploy_key -o StrictHostKeyChecking=accept-new deploy/compose.yml "$DEPLOY_USER@$DEPLOY_HOST:/srv/prod/socialize/compose.yml"
+
           ssh -i ~/.ssh/deploy_key -o StrictHostKeyChecking=accept-new "$DEPLOY_USER@$DEPLOY_HOST" \
-            'cd /srv/prod/socialize && ./deploy.sh'
+            'test -r /etc/socialize/socialize.env && cd /srv/prod/socialize && ./deploy.sh'

.gitignore

@@ -22,6 +22,10 @@ Thumbs.db
 # .NET
 bin/
 obj/
+**/[Bb]in/
+**/[Oo]bj/
+**/[Bb]in[\\]*
+**/[Oo]bj[\\]*
 TestResults/
 
 # Node
@@ -30,6 +34,7 @@ dist/
 .vite/
 
 # Local environment files
+.env
 *.local
 .env.local
 .env.*.local
@@ -38,5 +43,11 @@ App_Data/
 # Local SSL certificates
 *.pem
 
-# Ai
+# AI agent local state
+.agents
+.agents/
 .codex
+.codex/
+
+# Generated local artifacts
+.artifacts/

README.md

@@ -76,6 +76,47 @@ http://localhost:8080
 http://<this-machine-lan-ip>:8080
 ```
 
+For preprod deployment, configure the `POSTGRES_PASSWORD`, `RESEND_API_KEY`,
+`RESEND_FROM_EMAIL`, and `JWT_SIGNING_KEY` Gitea secrets.
+The deploy workflow writes the remote `.env` file and syncs `deploy/compose.yml`
+before running the server deploy script.
+Use the raw Resend API key value for `RESEND_API_KEY`, without a `Bearer ` prefix.
+
+## Preprod Observability
+
+The optional observability overlay runs a self-hosted Grafana stack for preproduction:
+
+- Grafana `13.0.1`: dashboards
+- Prometheus `v3.11.3`: metrics and local alert rules
+- Loki `3.7.1`: Docker/container logs
+- Tempo `2.10.3`: traces
+- Grafana Alloy `v1.16.0`: OTLP receiver and Docker log collector
+
+Start the app with observability:
+
+```bash
+docker compose -f deploy/compose.yml -f deploy/observability/compose.observability.yml up -d
+```
+
+Grafana is exposed at:
+
+```txt
+http://127.0.0.1:3000
+```
+
+Default credentials are `admin` / `admin` unless `GRAFANA_ADMIN_USER` and
+`GRAFANA_ADMIN_PASSWORD` are set. Set `GRAFANA_HTTP_BIND=0.0.0.0` only when the
+preprod network boundary is trusted or protected by a reverse proxy/VPN.
+
+Set a non-default `GRAFANA_ADMIN_PASSWORD` before exposing Grafana outside the
+host. Prometheus alert rules are provisioned under
+`deploy/observability/prometheus/rules/`; notification delivery is intentionally
+left to the preprod operations environment.
+
+Set `ALERTMANAGER_WEBHOOK_URL` to route alerts to a private notification endpoint.
+See `docs/OPERATIONS/observability-runbook.md` for bring-up, alert triage, and
+the optional protected Caddy configuration for Grafana.
+
 ## Solution
 
 ```bash
@@ -90,6 +131,24 @@ cd frontend
 npm run build
 ```
 
+## Database Diagram
+
+Start PostgreSQL, then generate a local schema diagram:
+
+```bash
+./scripts/generate-db-diagram.sh
+```
+
+The script writes an HTML viewer, SVG, PNG, and Graphviz source under:
+
+```txt
+.artifacts/db-diagrams/
+```
+
+Use `DATABASE_URL`, `PGPASSWORD`, or `~/.pgpass` to provide local database credentials.
+When using the repository infrastructure script, the diagram script can read from the
+running `socialize-postgres` container directly.
+
 ## Agentic Workflow
 
 Start here:

backend/src/Socialize.Api/ApplicationRegistration.cs

@@ -1,5 +1,6 @@
 using System.Text;
 using Socialize.Api.Data;
+using Socialize.Api.Infrastructure.Observability;
 using Socialize.Api.Infrastructure.Security;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.AspNetCore.Authentication;
@@ -11,7 +12,7 @@ using Microsoft.IdentityModel.Tokens;
 
 namespace Socialize;
 
-public static class DependencyInjection
+internal static class ApplicationRegistration
 {
     public static IServiceCollection AddWebServices(this IServiceCollection services)
     {
@@ -20,7 +21,10 @@ public static class DependencyInjection
         services.AddHttpContextAccessor();
 
         services.AddHealthChecks()
-            .AddDbContextCheck<AppDbContext>();
+            .AddCheck("self", () => Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Healthy(), tags: ["live"])
+            .AddDbContextCheck<AppDbContext>("postgres", tags: ["ready"])
+            .AddCheck<LocalBlobStorageHealthCheck>("local_blob_storage", tags: ["ready"])
+            .AddCheck<EmailerConfigurationHealthCheck>("emailer_configuration", tags: ["ready"]);
 
         services.AddHttpClient();
         services.AddScoped<AccessScopeService>();
@@ -70,7 +74,6 @@ public static class DependencyInjection
         {
             authenticationBuilder.AddJwtBearer(JwtBearerDefaults.AuthenticationScheme, jwtBearerOptions =>
             {
-                jwtBearerOptions.Authority = "https://hutopy.com";
                 jwtBearerOptions.TokenValidationParameters = new TokenValidationParameters
                 {
                     ValidateIssuer = true,
@@ -79,7 +82,7 @@ public static class DependencyInjection
                     ValidAudience = authJwt["Audience"],
                     ValidateLifetime = true,
                     IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(authJwt["Key"] ??
-                        throw new ArgumentNullException("The Jwt Key is missing.")))
+                        throw new InvalidOperationException("Authentication:Jwt:Key is required.")))
                 };
             });
         }
@@ -90,9 +93,9 @@ public static class DependencyInjection
             authenticationBuilder.AddGoogle(GoogleDefaults.AuthenticationScheme, options =>
             {
                 options.ClientId = authGoogle["ClientId"] ??
-                                   throw new ArgumentNullException("The Google ClientId is missing.");
+                                   throw new InvalidOperationException("Authentication:Google:ClientId is required.");
                 options.ClientSecret = authGoogle["ClientSecret"] ??
-                                       throw new ArgumentNullException("The Google ClientSecret is missing.");
+                                       throw new InvalidOperationException("Authentication:Google:ClientSecret is required.");
             });
         }
 
@@ -102,9 +105,9 @@ public static class DependencyInjection
             authenticationBuilder.AddFacebook(FacebookDefaults.AuthenticationScheme, options =>
             {
                 options.ClientId = authFacebook["ClientId"] ??
-                                   throw new ArgumentNullException("The Facebook ClientId is missing.");
+                                   throw new InvalidOperationException("Authentication:Facebook:ClientId is required.");
                 options.ClientSecret = authFacebook["ClientSecret"] ??
-                                       throw new ArgumentNullException("The Facebook ClientSecret is missing.");
+                                       throw new InvalidOperationException("Authentication:Facebook:ClientSecret is required.");
             });
         }
 

backend/src/Socialize.Api/Common/Domain/Entity.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Common.Domain;
 
-public abstract class Entity
+internal abstract class Entity
 {
     public Guid Id { get; init; }
     public Guid CreatedBy { get; init; }

backend/src/Socialize.Api/Data/AppDbContext.cs

@@ -12,15 +12,19 @@ using Socialize.Api.Modules.Notifications.Data;
 using Socialize.Api.Modules.Campaigns.Data;
 using Socialize.Api.Modules.CalendarIntegrations.Data;
 using Socialize.Api.Modules.Organizations.Data;
+using Socialize.Api.Modules.ReleaseCommunications.Data;
 using Socialize.Api.Modules.Workspaces.Data;
 
 namespace Socialize.Api.Data;
 
-public class AppDbContext(
+internal class AppDbContext(
     DbContextOptions<AppDbContext> options)
     : IdentityDbContext<User, Role, Guid>(options)
 {
     public DbSet<Organization> Organizations => Set<Organization>();
+    public DbSet<OrganizationMembershipTier> OrganizationMembershipTiers => Set<OrganizationMembershipTier>();
+    public DbSet<OrganizationMembershipTierTranslation> OrganizationMembershipTierTranslations =>
+        Set<OrganizationMembershipTierTranslation>();
     public DbSet<OrganizationMembership> OrganizationMemberships => Set<OrganizationMembership>();
     public DbSet<Workspace> Workspaces => Set<Workspace>();
     public DbSet<WorkspaceInvite> WorkspaceInvites => Set<WorkspaceInvite>();
@@ -47,6 +51,10 @@ public class AppDbContext(
     public DbSet<CalendarCatalogEntry> CalendarCatalogEntries => Set<CalendarCatalogEntry>();
     public DbSet<CalendarEvent> CalendarEvents => Set<CalendarEvent>();
     public DbSet<UserCalendarExportFeed> UserCalendarExportFeeds => Set<UserCalendarExportFeed>();
+    public DbSet<ReleaseUpdate> ReleaseUpdates => Set<ReleaseUpdate>();
+    public DbSet<ReleaseUpdateReadReceipt> ReleaseUpdateReadReceipts => Set<ReleaseUpdateReadReceipt>();
+    public DbSet<ReleaseCommit> ReleaseCommits => Set<ReleaseCommit>();
+    public DbSet<ReleaseUpdateEmailDigestReceipt> ReleaseUpdateEmailDigestReceipts => Set<ReleaseUpdateEmailDigestReceipt>();
 
     protected override void OnModelCreating(ModelBuilder builder)
     {
@@ -64,5 +72,6 @@ public class AppDbContext(
         builder.ConfigureNotificationsModule();
         builder.ConfigureFeedbackModule();
         builder.ConfigureCalendarIntegrationsModule();
+        builder.ConfigureReleaseCommunicationsModule();
     }
 }

backend/src/Socialize.Api/Folder.DotSettings

@@ -1,5 +0,0 @@
-<wpf:ResourceDictionary xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-                        xmlns:s="clr-namespace:System;assembly=mscorlib"
-                        xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-                        xml:space="preserve">
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=hutopy/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>

backend/src/Socialize.Api/Infrastructure/BlobStorage/Configuration/LocalBlobStorageOptions.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Infrastructure.BlobStorage.Configuration;
 
-public sealed class LocalBlobStorageOptions
+internal sealed class LocalBlobStorageOptions
 {
     public const string SectionName = "LocalBlobStorage";
 

backend/src/Socialize.Api/Infrastructure/BlobStorage/Contracts/CommonFileNames.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Infrastructure.BlobStorage.Contracts;
 
-public static class CommonFileNames
+internal static class CommonFileNames
 {
     public const string ProfilePicture = "profilePicture";
     public const string LogoPicture = "logoPicture";

backend/src/Socialize.Api/Infrastructure/BlobStorage/Contracts/ContentTypes.cs

@@ -2,7 +2,7 @@
 
 namespace Socialize.Api.Infrastructure.BlobStorage.Contracts;
 
-public static class ContentTypes
+internal static class ContentTypes
 {
     private const string ImagePng = "image/png";
     private const string ImageJpeg = "image/jpeg";
@@ -39,6 +39,6 @@ public static class ContentTypes
 
         // Check for HTML content by looking for "<!DOCTYPE html>" or "<html>" tags
         string content = Encoding.UTF8.GetString(buffer);
-        return content.Contains("<!DOCTYPE html>");
+        return content.Contains("<!DOCTYPE html>", StringComparison.OrdinalIgnoreCase);
     }
 }

backend/src/Socialize.Api/Infrastructure/BlobStorage/Contracts/IBlobStorage.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Infrastructure.BlobStorage.Contracts;
 
-public interface IBlobStorage
+internal interface IBlobStorage
 {
     /// <summary>
     ///     Upload a file to blob storage.

backend/src/Socialize.Api/Infrastructure/BlobStorage/Contracts/SubDirectoryNames.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Infrastructure.BlobStorage.Contracts;
 
-public static class SubDirectoryNames
+internal static class SubDirectoryNames
 {
     public const string Profile = "profile";
     public const string Contents = "contents";

backend/src/Socialize.Api/Infrastructure/BlobStorage/Services/LocalBlobStorage.cs

@@ -1,19 +1,29 @@
 using Microsoft.Extensions.Options;
 using Socialize.Api.Infrastructure.BlobStorage.Configuration;
 using Socialize.Api.Infrastructure.BlobStorage.Contracts;
+using Socialize.Api.Infrastructure.Observability;
 
 namespace Socialize.Api.Infrastructure.BlobStorage.Services;
 
-public sealed class LocalBlobStorage(
+internal sealed class LocalBlobStorage(
     IWebHostEnvironment environment,
     IHttpContextAccessor httpContextAccessor,
     IOptions<LocalBlobStorageOptions> options,
-    ILogger<LocalBlobStorage> logger)
+    ILogger<LocalBlobStorage> logger,
+    SocializeMetrics metrics)
     : IBlobStorage
 {
     private const long MaxUploadSize = 10 * 1024 * 1024;
     private const string ContentTypeMetadataSuffix = ".content-type";
 
+    private static readonly char[] PathSeparators = [Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar];
+
+    private static readonly Action<ILogger, string, string, string, string, Exception?> LogUploadedFile =
+        LoggerMessage.Define<string, string, string, string>(
+            LogLevel.Information,
+            new EventId(1, nameof(UploadFileAsync)),
+            "Blob storage: Uploaded [{BlobName}] to local container [{ContainerName}] with contentType [{ContentType}] and uri [{FileUri}]");
+
     private readonly LocalBlobStorageOptions _options = options.Value;
 
     public async Task<string> UploadFileAsync(
@@ -22,6 +32,8 @@ public sealed class LocalBlobStorage(
         Stream stream,
         string contentType,
         CancellationToken ct = default)
+    {
+        try
         {
             stream.Position = 0;
 
@@ -46,20 +58,34 @@ public sealed class LocalBlobStorage(
             await File.WriteAllTextAsync(GetContentTypeMetadataPath(filePath), contentType, ct);
 
             string fileUri = BuildPublicUrl(relativePath);
-        logger.LogInformation(
-            "Blob storage: Uploaded [{BlobName}] to local container [{ContainerName}] with contentType [{ContentType}] and uri [{FileUri}]",
-            blobName,
-            containerName,
-            contentType,
-            fileUri);
+            LogUploadedFile(logger, blobName, containerName, contentType, fileUri, null);
+            metrics.RecordBlobStorageOperation("upload", true);
 
             return fileUri;
         }
+        catch (InvalidOperationException)
+        {
+            metrics.RecordBlobStorageOperation("upload", false);
+            throw;
+        }
+        catch (IOException)
+        {
+            metrics.RecordBlobStorageOperation("upload", false);
+            throw;
+        }
+        catch (UnauthorizedAccessException)
+        {
+            metrics.RecordBlobStorageOperation("upload", false);
+            throw;
+        }
+    }
 
     public async Task<MemoryStream> DownloadFileAsync(
         string containerName,
         string blobName,
         CancellationToken ct = default)
+    {
+        try
         {
             string filePath = Path.Combine(GetRootPath(), GetSafeRelativePath(containerName, blobName));
 
@@ -72,9 +98,31 @@ public sealed class LocalBlobStorage(
             await using FileStream fileStream = File.OpenRead(filePath);
             await fileStream.CopyToAsync(memoryStream, ct);
             memoryStream.Position = 0;
+            metrics.RecordBlobStorageOperation("download", true);
 
             return memoryStream;
         }
+        catch (InvalidOperationException)
+        {
+            metrics.RecordBlobStorageOperation("download", false);
+            throw;
+        }
+        catch (FileNotFoundException)
+        {
+            metrics.RecordBlobStorageOperation("download", false);
+            throw;
+        }
+        catch (IOException)
+        {
+            metrics.RecordBlobStorageOperation("download", false);
+            throw;
+        }
+        catch (UnauthorizedAccessException)
+        {
+            metrics.RecordBlobStorageOperation("download", false);
+            throw;
+        }
+    }
 
     internal string GetRootPath()
     {
@@ -106,7 +154,7 @@ public sealed class LocalBlobStorage(
             throw new InvalidOperationException("Blob storage: Blob paths must be relative.");
         }
 
-        string[] pathParts = [containerName, .. blobName.Split([Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar])];
+        string[] pathParts = [containerName, .. blobName.Split(PathSeparators)];
         if (pathParts.Any(part => part is "" or "." or ".."))
         {
             throw new InvalidOperationException("Blob storage: Blob paths must not contain relative path segments.");
@@ -135,7 +183,7 @@ public sealed class LocalBlobStorage(
             ? "/api/storage"
             : requestPath.Trim();
 
-        return normalized.StartsWith("/", StringComparison.Ordinal)
+        return normalized.StartsWith('/')
             ? normalized.TrimEnd('/')
             : $"/{normalized.TrimEnd('/')}";
     }

backend/src/Socialize.Api/Infrastructure/Configuration/WebsiteOptions.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Infrastructure.Configuration;
 
-public class WebsiteOptions
+internal class WebsiteOptions
 {
     public const string SectionName = "Website";
 

backend/src/Socialize.Api/Infrastructure/Development/DevelopmentSeedOptions.cs

@@ -1,8 +0,0 @@
-namespace Socialize.Api.Infrastructure.Development;
-
-public record DevelopmentSeedOptions
-{
-    public const string SectionName = "DevelopmentSeed";
-
-    public bool Enabled { get; init; } = true;
-}

backend/src/Socialize.Api/Infrastructure/Emailer/Configuration/EmailerOptions.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Infrastructure.Emailer.Configuration;
 
-public class EmailerOptions
+internal class EmailerOptions
 {
     public const string ConfigurationSection = "Emailer";
 

backend/src/Socialize.Api/Infrastructure/Emailer/Contracts/IEmailSender.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Infrastructure.Emailer.Contracts;
 
-public interface IEmailSender
+internal interface IEmailSender
 {
     Task SendEmailAsync(string email, string subject, string message);
 }

backend/src/Socialize.Api/Infrastructure/Emailer/Services/LoggerEmailSender.cs

@@ -1,22 +1,24 @@
 using Socialize.Api.Infrastructure.Emailer.Contracts;
+using Socialize.Api.Infrastructure.Observability;
 
 namespace Socialize.Api.Infrastructure.Emailer.Services;
 
-public class LoggerEmailSender(ILogger<IEmailSender> logger)
+internal class LoggerEmailSender(
+    ILogger<IEmailSender> logger,
+    SocializeMetrics metrics)
     : IEmailSender
 {
-    public async Task SendEmailAsync(string email, string subject, string message)
+    private static readonly Action<ILogger, string, string, string, string, Exception?> LogDevelopmentEmail =
+        LoggerMessage.Define<string, string, string, string>(
+            LogLevel.Information,
+            new EventId(1, nameof(SendEmailAsync)),
+            "Development email to {Email} with subject {Subject}:{NewLine}{Message}");
+
+    public Task SendEmailAsync(string email, string subject, string message)
     {
-        try
-        {
-            logger.LogInformation("Sending email to {Email} with subject: {Subject}", email, subject);
-            await Task.Delay(1000);
-            logger.LogInformation("Email sent successfully to {Email}", email);
-        }
-        catch (Exception ex)
-        {
-            logger.LogError(ex, "Failed to send email to {Email}", email);
-            throw;
-        }
+        LogDevelopmentEmail(logger, email, subject, Environment.NewLine, message, null);
+        metrics.RecordEmailDelivery("logger", true);
+
+        return Task.CompletedTask;
     }
 }

backend/src/Socialize.Api/Infrastructure/Emailer/Services/PostmarkEmailSender.cs

@@ -5,7 +5,7 @@ using PostmarkDotNet;
 
 namespace Socialize.Api.Infrastructure.Emailer.Services;
 
-public class PostmarkEmailSender : IEmailSender
+internal class PostmarkEmailSender : IEmailSender
 {
     private readonly PostmarkClient _client;
     private readonly EmailerOptions _options;

backend/src/Socialize.Api/Infrastructure/Emailer/Services/ResendEmailSender.cs

@@ -3,38 +3,59 @@ using System.Text;
 using System.Text.Json;
 using Socialize.Api.Infrastructure.Emailer.Configuration;
 using Socialize.Api.Infrastructure.Emailer.Contracts;
+using Socialize.Api.Infrastructure.Observability;
 using Microsoft.Extensions.Options;
 
 namespace Socialize.Api.Infrastructure.Emailer.Services;
 
-public class ResendEmailSender : IEmailSender
+internal class ResendEmailSender : IEmailSender
 {
     private static readonly Uri EndpointUri = new("https://api.resend.com/emails");
     private readonly HttpClient _httpClient;
+    private readonly SocializeMetrics _metrics;
     private readonly EmailerOptions _options;
 
     public ResendEmailSender(
         IHttpClientFactory httpClientFactory,
-        IOptions<EmailerOptions> options)
+        IOptions<EmailerOptions> options,
+        SocializeMetrics metrics)
     {
         _httpClient = httpClientFactory.CreateClient();
+        _metrics = metrics;
         _options = options.Value;
 
+        string apiKey = NormalizeApiKey(_options.ApiKey);
+        string fromEmail = _options.FromEmail?.Trim() ?? string.Empty;
+
+        if (string.IsNullOrWhiteSpace(apiKey))
+        {
+            throw new InvalidOperationException("Emailer:ApiKey is required when using Resend email delivery.");
+        }
+
+        if (string.IsNullOrWhiteSpace(fromEmail))
+        {
+            throw new InvalidOperationException("Emailer:FromEmail is required when using Resend email delivery.");
+        }
+
+        _options.ApiKey = apiKey;
+        _options.FromEmail = fromEmail;
+
         _httpClient.DefaultRequestHeaders.Authorization =
-            new AuthenticationHeaderValue("Bearer", _options.ApiKey);
+            new AuthenticationHeaderValue("Bearer", apiKey);
 
         _httpClient.DefaultRequestHeaders.Accept.Add(
             new MediaTypeWithQualityHeaderValue("application/json"));
     }
 
-    public async Task SendEmailAsync(string toEmail, string subject, string htmlMessage)
+    public async Task SendEmailAsync(string email, string subject, string message)
     {
-        var payload = new { from = _options.FromEmail, to = toEmail, subject, html = htmlMessage };
+        var payload = new { from = _options.FromEmail, to = email, subject, html = message };
 
         string json = JsonSerializer.Serialize(payload);
-        StringContent content = new(json, Encoding.UTF8, "application/json");
-
-        HttpResponseMessage response = await _httpClient.PostAsync(EndpointUri, content);
+        using StringContent content = new(json, Encoding.UTF8, "application/json");
+        try
+        {
+            using HttpResponseMessage response = await _httpClient.PostAsync(EndpointUri, content);
 
             if (!response.IsSuccessStatusCode)
             {
@@ -42,5 +63,35 @@ public class ResendEmailSender : IEmailSender
                 throw new InvalidOperationException(
                     $"Resend email failed: {response.StatusCode} - {body}");
             }
+
+            _metrics.RecordEmailDelivery("resend", true);
+        }
+        catch (HttpRequestException)
+        {
+            _metrics.RecordEmailDelivery("resend", false);
+            throw;
+        }
+        catch (TaskCanceledException)
+        {
+            _metrics.RecordEmailDelivery("resend", false);
+            throw;
+        }
+        catch (InvalidOperationException)
+        {
+            _metrics.RecordEmailDelivery("resend", false);
+            throw;
+        }
+    }
+
+    private static string NormalizeApiKey(string? apiKey)
+    {
+        string normalized = apiKey?.Trim().Trim('"', '\'') ?? string.Empty;
+        const string bearerPrefix = "Bearer ";
+        if (normalized.StartsWith(bearerPrefix, StringComparison.OrdinalIgnoreCase))
+        {
+            normalized = normalized[bearerPrefix.Length..].Trim();
+        }
+
+        return normalized;
     }
 }

backend/src/Socialize.Api/Infrastructure/InfrastructureRegistration.cs

@@ -9,7 +9,7 @@ using Socialize.Api.Infrastructure.Payments.Stripe.Configuration;
 
 namespace Socialize.Api.Infrastructure;
 
-public static class DependencyInjection
+internal static class InfrastructureRegistration
 {
     public static WebApplicationBuilder AddInfrastructureModule(
         this WebApplicationBuilder builder)
@@ -26,8 +26,14 @@ public static class DependencyInjection
 
         builder.Services.Configure<EmailerOptions>(
             builder.Configuration.GetSection(EmailerOptions.ConfigurationSection));
+        if (builder.Environment.IsDevelopment())
+        {
+            builder.Services.AddTransient<IEmailSender, LoggerEmailSender>();
+        }
+        else
+        {
             builder.Services.AddTransient<IEmailSender, ResendEmailSender>();
-        //builder.Services.AddTransient<IEmailSender, EmailSender>();
+        }
 
         builder.Services.AddHttpClient();
 

backend/src/Socialize.Api/Infrastructure/Observability/EmailerConfigurationHealthCheck.cs

@@ -0,0 +1,29 @@
+using Microsoft.Extensions.Diagnostics.HealthChecks;
+using Microsoft.Extensions.Options;
+using Socialize.Api.Infrastructure.Emailer.Configuration;
+
+namespace Socialize.Api.Infrastructure.Observability;
+
+internal sealed class EmailerConfigurationHealthCheck(
+    IWebHostEnvironment environment,
+    IOptions<EmailerOptions> options)
+    : IHealthCheck
+{
+    public Task<HealthCheckResult> CheckHealthAsync(
+        HealthCheckContext context,
+        CancellationToken cancellationToken = default)
+    {
+        if (environment.IsDevelopment())
+        {
+            return Task.FromResult(HealthCheckResult.Healthy("Development email sender logs email instead of delivering it."));
+        }
+
+        EmailerOptions value = options.Value;
+        if (string.IsNullOrWhiteSpace(value.ApiKey) || string.IsNullOrWhiteSpace(value.FromEmail))
+        {
+            return Task.FromResult(HealthCheckResult.Unhealthy("Emailer API key or from address is missing."));
+        }
+
+        return Task.FromResult(HealthCheckResult.Healthy("Emailer configuration is present."));
+    }
+}

backend/src/Socialize.Api/Infrastructure/Observability/LocalBlobStorageHealthCheck.cs

@@ -0,0 +1,40 @@
+using Microsoft.Extensions.Diagnostics.HealthChecks;
+using Microsoft.Extensions.Options;
+using Socialize.Api.Infrastructure.BlobStorage.Configuration;
+using Socialize.Api.Infrastructure.BlobStorage.Services;
+
+namespace Socialize.Api.Infrastructure.Observability;
+
+internal sealed class LocalBlobStorageHealthCheck(
+    LocalBlobStorage blobStorage,
+    IOptions<LocalBlobStorageOptions> options)
+    : IHealthCheck
+{
+    public async Task<HealthCheckResult> CheckHealthAsync(
+        HealthCheckContext context,
+        CancellationToken cancellationToken = default)
+    {
+        string rootPath = blobStorage.GetRootPath();
+        if (string.IsNullOrWhiteSpace(options.Value.RequestPath))
+        {
+            return HealthCheckResult.Unhealthy("Local blob storage request path is not configured.");
+        }
+
+        try
+        {
+            Directory.CreateDirectory(rootPath);
+            string probePath = Path.Combine(rootPath, ".healthcheck");
+            await File.WriteAllTextAsync(
+                probePath,
+                DateTimeOffset.UtcNow.ToString("O", System.Globalization.CultureInfo.InvariantCulture),
+                cancellationToken);
+            File.Delete(probePath);
+
+            return HealthCheckResult.Healthy("Local blob storage is writable.");
+        }
+        catch (Exception ex) when (ex is IOException or UnauthorizedAccessException)
+        {
+            return HealthCheckResult.Unhealthy("Local blob storage is not writable.", ex);
+        }
+    }
+}

backend/src/Socialize.Api/Infrastructure/Observability/ObservabilityRegistration.cs

@@ -0,0 +1,162 @@
+using System.Text.Json;
+using Microsoft.AspNetCore.Diagnostics.HealthChecks;
+using Microsoft.Extensions.Diagnostics.HealthChecks;
+using Npgsql;
+using OpenTelemetry.Logs;
+using OpenTelemetry.Metrics;
+using OpenTelemetry.Resources;
+using OpenTelemetry.Trace;
+
+namespace Socialize.Api.Infrastructure.Observability;
+
+internal static class ObservabilityRegistration
+{
+    private const string DefaultServiceName = "socialize-api";
+
+    public static WebApplicationBuilder AddObservability(this WebApplicationBuilder builder)
+    {
+        string serviceName = GetConfigurationValue(builder.Configuration, "OTEL_SERVICE_NAME", DefaultServiceName);
+        string serviceVersion = typeof(Program).Assembly.GetName().Version?.ToString() ?? "unknown";
+
+        builder.Logging.Configure(options =>
+        {
+            options.ActivityTrackingOptions =
+                ActivityTrackingOptions.TraceId |
+                ActivityTrackingOptions.SpanId |
+                ActivityTrackingOptions.ParentId;
+        });
+
+        builder.Logging.AddJsonConsole(options =>
+        {
+            options.IncludeScopes = true;
+            options.TimestampFormat = "yyyy-MM-ddTHH:mm:ss.fffZ";
+            options.UseUtcTimestamp = true;
+            options.JsonWriterOptions = new JsonWriterOptions { Indented = false };
+        });
+
+        bool otlpEnabled = HasOtlpEndpoint(builder.Configuration);
+        if (otlpEnabled)
+        {
+            builder.Logging.AddOpenTelemetry(options =>
+            {
+                options.IncludeFormattedMessage = true;
+                options.IncludeScopes = true;
+                options.ParseStateValues = true;
+                options.SetResourceBuilder(BuildResource(serviceName, serviceVersion));
+                options.AddOtlpExporter();
+            });
+        }
+
+        builder.Services.AddSingleton<SocializeMetrics>();
+        builder.Services.AddHostedService<WorkflowHealthSamplerService>();
+        builder.Services
+            .AddOpenTelemetry()
+            .ConfigureResource(resource => resource.AddService(
+                serviceName,
+                serviceVersion: serviceVersion))
+            .WithTracing(tracing =>
+            {
+                tracing
+                    .AddSource(SocializeMetrics.ActivitySourceName)
+                    .AddAspNetCoreInstrumentation(options =>
+                    {
+                        options.RecordException = true;
+                    })
+                    .AddHttpClientInstrumentation()
+                    .AddNpgsql();
+
+                if (otlpEnabled)
+                {
+                    tracing.AddOtlpExporter();
+                }
+            })
+            .WithMetrics(metrics =>
+            {
+                metrics
+                    .AddMeter(SocializeMetrics.MeterName)
+                    .AddAspNetCoreInstrumentation()
+                    .AddHttpClientInstrumentation()
+                    .AddRuntimeInstrumentation();
+
+                if (otlpEnabled)
+                {
+                    metrics.AddOtlpExporter();
+                }
+            });
+
+        return builder;
+    }
+
+    public static IApplicationBuilder UseObservabilityLoggingScope(this IApplicationBuilder app)
+    {
+        return app.UseMiddleware<RequestLoggingScopeMiddleware>();
+    }
+
+    public static IEndpointRouteBuilder MapObservabilityHealthChecks(this IEndpointRouteBuilder endpoints)
+    {
+        endpoints.MapHealthChecks(
+            "/health",
+            new HealthCheckOptions { ResponseWriter = WriteHealthResponseAsync });
+        endpoints.MapHealthChecks(
+            "/health/live",
+            new HealthCheckOptions
+            {
+                Predicate = registration => registration.Tags.Contains("live", StringComparer.Ordinal),
+                ResponseWriter = WriteHealthResponseAsync,
+            });
+        endpoints.MapHealthChecks(
+            "/health/ready",
+            new HealthCheckOptions
+            {
+                Predicate = registration => registration.Tags.Contains("ready", StringComparer.Ordinal),
+                ResponseWriter = WriteHealthResponseAsync,
+            });
+
+        return endpoints;
+    }
+
+    private static ResourceBuilder BuildResource(string serviceName, string serviceVersion)
+    {
+        return ResourceBuilder.CreateDefault().AddService(
+            serviceName,
+            serviceVersion: serviceVersion);
+    }
+
+    private static bool HasOtlpEndpoint(ConfigurationManager configuration)
+    {
+        return !string.IsNullOrWhiteSpace(configuration["OTEL_EXPORTER_OTLP_ENDPOINT"]) ||
+               !string.IsNullOrWhiteSpace(configuration["Otlp:Endpoint"]);
+    }
+
+    private static string GetConfigurationValue(
+        ConfigurationManager configuration,
+        string key,
+        string fallback)
+    {
+        string? value = configuration[key];
+        return string.IsNullOrWhiteSpace(value) ? fallback : value;
+    }
+
+    private static async Task WriteHealthResponseAsync(HttpContext context, HealthReport report)
+    {
+        context.Response.ContentType = "application/json";
+
+        var response = new
+        {
+            status = report.Status.ToString(),
+            checks = report.Entries.Select(entry => new
+            {
+                name = entry.Key,
+                status = entry.Value.Status.ToString(),
+                description = entry.Value.Description,
+                duration = entry.Value.Duration.TotalMilliseconds,
+            }),
+            duration = report.TotalDuration.TotalMilliseconds,
+        };
+
+        await JsonSerializer.SerializeAsync(
+            context.Response.Body,
+            response,
+            cancellationToken: context.RequestAborted);
+    }
+}

backend/src/Socialize.Api/Infrastructure/Observability/RequestLoggingScopeMiddleware.cs

@@ -0,0 +1,61 @@
+using System.Diagnostics;
+using Socialize.Api.Infrastructure.Security;
+
+namespace Socialize.Api.Infrastructure.Observability;
+
+internal sealed class RequestLoggingScopeMiddleware(
+    RequestDelegate next,
+    ILogger<RequestLoggingScopeMiddleware> logger)
+{
+    public async Task InvokeAsync(HttpContext context)
+    {
+        Dictionary<string, object?> scope = new()
+        {
+            ["trace_id"] = Activity.Current?.TraceId.ToString() ?? context.TraceIdentifier,
+            ["span_id"] = Activity.Current?.SpanId.ToString(),
+            ["http.method"] = context.Request.Method,
+            ["url.path"] = context.Request.Path.Value,
+        };
+
+        if (context.User.Identity?.IsAuthenticated == true)
+        {
+            scope["user.id"] = context.User.GetUserId();
+            scope["user.email"] = context.User.GetEmail();
+        }
+
+        AddGuidIfPresent(scope, "organization.id", context, "organizationId");
+        AddGuidIfPresent(scope, "workspace.id", context, "workspaceId");
+        AddGuidIfPresent(scope, "client.id", context, "clientId");
+        AddGuidIfPresent(scope, "campaign.id", context, "campaignId");
+        AddGuidIfPresent(scope, "content_item.id", context, "contentItemId");
+
+        using IDisposable? _ = logger.BeginScope(scope);
+        await next(context);
+    }
+
+    private static void AddGuidIfPresent(
+        Dictionary<string, object?> scope,
+        string scopeKey,
+        HttpContext context,
+        string requestKey)
+    {
+        string? value = GetRouteOrQueryValue(context, requestKey);
+        if (Guid.TryParse(value, out Guid id))
+        {
+            scope[scopeKey] = id;
+        }
+    }
+
+    private static string? GetRouteOrQueryValue(HttpContext context, string key)
+    {
+        object? routeValue = context.Request.RouteValues[key];
+        if (routeValue is not null)
+        {
+            return Convert.ToString(routeValue, System.Globalization.CultureInfo.InvariantCulture);
+        }
+
+        return context.Request.Query.TryGetValue(key, out Microsoft.Extensions.Primitives.StringValues queryValue)
+            ? queryValue.ToString()
+            : null;
+    }
+}

backend/src/Socialize.Api/Infrastructure/Observability/SocializeMetrics.cs

@@ -0,0 +1,258 @@
+using System.Diagnostics;
+using System.Diagnostics.Metrics;
+
+namespace Socialize.Api.Infrastructure.Observability;
+
+internal sealed class SocializeMetrics : IDisposable
+{
+    public const string MeterName = "Socialize.Api";
+    public const string ActivitySourceName = "Socialize.Api";
+
+    private readonly Counter<long> _approvalDecisionCounter;
+    private readonly Counter<long> _backgroundJobRunCounter;
+    private readonly Counter<long> _blobStorageOperationCounter;
+    private readonly Counter<long> _commentCreatedCounter;
+    private readonly Counter<long> _contentItemCreatedCounter;
+    private readonly Counter<long> _emailDeliveryCounter;
+    private readonly Counter<long> _feedbackSubmittedCounter;
+    private readonly Counter<long> _loginAttemptCounter;
+    private readonly Counter<long> _organizationCreatedCounter;
+    private readonly Counter<long> _workspaceCreatedCounter;
+    private readonly Counter<long> _workspaceInviteCreatedCounter;
+    private readonly object _workflowHealthLock = new();
+    private WorkflowHealthSnapshot _workflowHealthSnapshot = WorkflowHealthSnapshot.Empty;
+
+    public SocializeMetrics()
+    {
+        Meter = new Meter(MeterName);
+        ActivitySource = new ActivitySource(ActivitySourceName);
+
+        _loginAttemptCounter = Meter.CreateCounter<long>(
+            "socialize.login.attempts",
+            description: "Login attempts partitioned by outcome.");
+        _organizationCreatedCounter = Meter.CreateCounter<long>(
+            "socialize.organizations.created",
+            description: "Organizations created.");
+        _workspaceCreatedCounter = Meter.CreateCounter<long>(
+            "socialize.workspaces.created",
+            description: "Workspaces created.");
+        _contentItemCreatedCounter = Meter.CreateCounter<long>(
+            "socialize.content_items.created",
+            description: "Content items created.");
+        _commentCreatedCounter = Meter.CreateCounter<long>(
+            "socialize.comments.created",
+            description: "Comments created.");
+        _approvalDecisionCounter = Meter.CreateCounter<long>(
+            "socialize.approval_decisions.submitted",
+            description: "Approval decisions submitted.");
+        _feedbackSubmittedCounter = Meter.CreateCounter<long>(
+            "socialize.feedback.submitted",
+            description: "Feedback reports submitted.");
+        _workspaceInviteCreatedCounter = Meter.CreateCounter<long>(
+            "socialize.workspace_invites.created",
+            description: "Workspace invites created.");
+        _emailDeliveryCounter = Meter.CreateCounter<long>(
+            "socialize.email.delivery",
+            description: "Email delivery attempts partitioned by outcome and provider.");
+        _blobStorageOperationCounter = Meter.CreateCounter<long>(
+            "socialize.blob_storage.operations",
+            description: "Blob storage operations partitioned by operation and outcome.");
+        _backgroundJobRunCounter = Meter.CreateCounter<long>(
+            "socialize.background_job.runs",
+            description: "Background job runs partitioned by job and outcome.");
+
+        Meter.CreateObservableGauge(
+            "socialize.workflow.content_items",
+            ObserveContentItemCounts,
+            description: "Current content item counts by status.");
+        Meter.CreateObservableGauge(
+            "socialize.workflow.feedback_reports",
+            ObserveFeedbackReportCounts,
+            description: "Current feedback report counts by status.");
+        Meter.CreateObservableGauge(
+            "socialize.workflow.pending_invites",
+            ObservePendingInviteCount,
+            description: "Current pending workspace invite count.");
+        Meter.CreateObservableGauge(
+            "socialize.workflow.stale_in_approval",
+            ObserveStaleApprovalCount,
+            description: "Current count of content items in approval longer than the configured stale threshold.");
+        Meter.CreateObservableGauge(
+            "socialize.workflow.active_workspaces",
+            ObserveActiveWorkspaceCounts,
+            description: "Current active workspace counts by observation window.");
+    }
+
+    public Meter Meter { get; }
+
+    public ActivitySource ActivitySource { get; }
+
+    public void RecordLoginAttempt(bool succeeded, string reason)
+    {
+        _loginAttemptCounter.Add(
+            1,
+            new KeyValuePair<string, object?>("outcome", succeeded ? "success" : "failure"),
+            new KeyValuePair<string, object?>("reason", reason));
+    }
+
+    public void RecordOrganizationCreated(Guid organizationId)
+    {
+        _organizationCreatedCounter.Add(
+            1,
+            new KeyValuePair<string, object?>("organization.id", organizationId));
+    }
+
+    public void RecordWorkspaceCreated(Guid organizationId, Guid workspaceId)
+    {
+        _workspaceCreatedCounter.Add(
+            1,
+            new KeyValuePair<string, object?>("organization.id", organizationId),
+            new KeyValuePair<string, object?>("workspace.id", workspaceId));
+    }
+
+    public void RecordContentItemCreated(Guid workspaceId)
+    {
+        _contentItemCreatedCounter.Add(
+            1,
+            new KeyValuePair<string, object?>("workspace.id", workspaceId));
+    }
+
+    public void RecordCommentCreated(Guid workspaceId, bool hasAttachment)
+    {
+        _commentCreatedCounter.Add(
+            1,
+            new KeyValuePair<string, object?>("workspace.id", workspaceId),
+            new KeyValuePair<string, object?>("has_attachment", hasAttachment));
+    }
+
+    public void RecordApprovalDecisionSubmitted(Guid workspaceId, string decision)
+    {
+        _approvalDecisionCounter.Add(
+            1,
+            new KeyValuePair<string, object?>("workspace.id", workspaceId),
+            new KeyValuePair<string, object?>("decision", decision));
+    }
+
+    public void RecordFeedbackSubmitted(string type, Guid? workspaceId)
+    {
+        _feedbackSubmittedCounter.Add(
+            1,
+            new KeyValuePair<string, object?>("feedback.type", type),
+            new KeyValuePair<string, object?>("workspace.id", workspaceId?.ToString() ?? "none"));
+    }
+
+    public void RecordWorkspaceInviteCreated(Guid workspaceId, string role)
+    {
+        _workspaceInviteCreatedCounter.Add(
+            1,
+            new KeyValuePair<string, object?>("workspace.id", workspaceId),
+            new KeyValuePair<string, object?>("role", role));
+    }
+
+    public void RecordEmailDelivery(string provider, bool succeeded)
+    {
+        _emailDeliveryCounter.Add(
+            1,
+            new KeyValuePair<string, object?>("provider", provider),
+            new KeyValuePair<string, object?>("outcome", succeeded ? "success" : "failure"));
+    }
+
+    public void RecordBlobStorageOperation(string operation, bool succeeded)
+    {
+        _blobStorageOperationCounter.Add(
+            1,
+            new KeyValuePair<string, object?>("operation", operation),
+            new KeyValuePair<string, object?>("outcome", succeeded ? "success" : "failure"));
+    }
+
+    public void RecordBackgroundJobRun(string job, bool succeeded)
+    {
+        _backgroundJobRunCounter.Add(
+            1,
+            new KeyValuePair<string, object?>("job", job),
+            new KeyValuePair<string, object?>("outcome", succeeded ? "success" : "failure"));
+    }
+
+    public void UpdateWorkflowHealth(WorkflowHealthSnapshot snapshot)
+    {
+        lock (_workflowHealthLock)
+        {
+            _workflowHealthSnapshot = snapshot;
+        }
+    }
+
+    public void Dispose()
+    {
+        Meter.Dispose();
+        ActivitySource.Dispose();
+    }
+
+    private Measurement<int>[] ObserveContentItemCounts()
+    {
+        WorkflowHealthSnapshot snapshot = GetWorkflowHealthSnapshot();
+        return snapshot.ContentItemsByStatus
+            .Select(pair => new Measurement<int>(
+                pair.Value,
+                new KeyValuePair<string, object?>("status", pair.Key)))
+            .ToArray();
+    }
+
+    private Measurement<int>[] ObserveFeedbackReportCounts()
+    {
+        WorkflowHealthSnapshot snapshot = GetWorkflowHealthSnapshot();
+        return snapshot.FeedbackReportsByStatus
+            .Select(pair => new Measurement<int>(
+                pair.Value,
+                new KeyValuePair<string, object?>("status", pair.Key)))
+            .ToArray();
+    }
+
+    private Measurement<int> ObservePendingInviteCount()
+    {
+        return new Measurement<int>(GetWorkflowHealthSnapshot().PendingInviteCount);
+    }
+
+    private Measurement<int> ObserveStaleApprovalCount()
+    {
+        return new Measurement<int>(GetWorkflowHealthSnapshot().StaleInApprovalCount);
+    }
+
+    private Measurement<int>[] ObserveActiveWorkspaceCounts()
+    {
+        WorkflowHealthSnapshot snapshot = GetWorkflowHealthSnapshot();
+        return
+        [
+            new Measurement<int>(
+                snapshot.ActiveWorkspaces24Hours,
+                new KeyValuePair<string, object?>("window", "24h")),
+            new Measurement<int>(
+                snapshot.ActiveWorkspaces7Days,
+                new KeyValuePair<string, object?>("window", "7d")),
+        ];
+    }
+
+    private WorkflowHealthSnapshot GetWorkflowHealthSnapshot()
+    {
+        lock (_workflowHealthLock)
+        {
+            return _workflowHealthSnapshot;
+        }
+    }
+}
+
+internal sealed record WorkflowHealthSnapshot(
+    IReadOnlyDictionary<string, int> ContentItemsByStatus,
+    IReadOnlyDictionary<string, int> FeedbackReportsByStatus,
+    int PendingInviteCount,
+    int StaleInApprovalCount,
+    int ActiveWorkspaces24Hours,
+    int ActiveWorkspaces7Days)
+{
+    public static WorkflowHealthSnapshot Empty { get; } = new(
+        new Dictionary<string, int>(StringComparer.Ordinal),
+        new Dictionary<string, int>(StringComparer.Ordinal),
+        0,
+        0,
+        0,
+        0);
+}

backend/src/Socialize.Api/Infrastructure/Observability/WorkflowHealthSamplerService.cs

@@ -0,0 +1,102 @@
+using Microsoft.EntityFrameworkCore;
+using Socialize.Api.Data;
+using Socialize.Api.Modules.Feedback.Data;
+using Socialize.Api.Modules.Workspaces.Data;
+
+namespace Socialize.Api.Infrastructure.Observability;
+
+internal sealed class WorkflowHealthSamplerService(
+    IServiceScopeFactory scopeFactory,
+    SocializeMetrics metrics,
+    ILogger<WorkflowHealthSamplerService> logger)
+    : BackgroundService
+{
+    private static readonly TimeSpan SampleInterval = TimeSpan.FromMinutes(5);
+    private static readonly TimeSpan StaleApprovalThreshold = TimeSpan.FromDays(3);
+
+    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
+    {
+        await SampleAsync(stoppingToken);
+
+        using PeriodicTimer timer = new(SampleInterval);
+        while (!stoppingToken.IsCancellationRequested)
+        {
+            try
+            {
+                await timer.WaitForNextTickAsync(stoppingToken);
+                await SampleAsync(stoppingToken);
+            }
+            catch (OperationCanceledException ex) when (stoppingToken.IsCancellationRequested)
+            {
+                logger.LogDebug(ex, "Workflow health sampler stopped.");
+            }
+        }
+    }
+
+    private async Task SampleAsync(CancellationToken stoppingToken)
+    {
+        try
+        {
+            using IServiceScope scope = scopeFactory.CreateScope();
+            AppDbContext dbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
+            DateTimeOffset now = DateTimeOffset.UtcNow;
+            DateTimeOffset staleApprovalCutoff = now.Subtract(StaleApprovalThreshold);
+            DateTimeOffset active24HourCutoff = now.AddHours(-24);
+            DateTimeOffset active7DayCutoff = now.AddDays(-7);
+
+            Dictionary<string, int> contentItemsByStatus = await dbContext.ContentItems
+                .GroupBy(item => item.Status)
+                .Select(group => new { Status = group.Key, Count = group.Count() })
+                .ToDictionaryAsync(group => group.Status, group => group.Count, StringComparer.Ordinal, stoppingToken);
+
+            Dictionary<string, int> feedbackReportsByStatus = await dbContext.FeedbackReports
+                .GroupBy(report => report.Status)
+                .Select(group => new { Status = group.Key, Count = group.Count() })
+                .ToDictionaryAsync(
+                    group => group.Status == FeedbackStatus.WontDo ? "WontDo" : group.Status.ToString(),
+                    group => group.Count,
+                    StringComparer.Ordinal,
+                    stoppingToken);
+
+            int pendingInviteCount = await dbContext.WorkspaceInvites
+                .CountAsync(invite => invite.Status == WorkspaceInviteStatuses.Pending, stoppingToken);
+
+            int staleInApprovalCount = await dbContext.ContentItems
+                .CountAsync(
+                    item => item.Status == "In approval" && item.CreatedAt <= staleApprovalCutoff,
+                    stoppingToken);
+
+            int activeWorkspaces24Hours = await dbContext.ContentItemActivityEntries
+                .Where(entry => entry.CreatedAt >= active24HourCutoff)
+                .Select(entry => entry.WorkspaceId)
+                .Distinct()
+                .CountAsync(stoppingToken);
+
+            int activeWorkspaces7Days = await dbContext.ContentItemActivityEntries
+                .Where(entry => entry.CreatedAt >= active7DayCutoff)
+                .Select(entry => entry.WorkspaceId)
+                .Distinct()
+                .CountAsync(stoppingToken);
+
+            metrics.UpdateWorkflowHealth(new WorkflowHealthSnapshot(
+                contentItemsByStatus,
+                feedbackReportsByStatus,
+                pendingInviteCount,
+                staleInApprovalCount,
+                activeWorkspaces24Hours,
+                activeWorkspaces7Days));
+            metrics.RecordBackgroundJobRun(nameof(WorkflowHealthSamplerService), true);
+        }
+        catch (OperationCanceledException ex) when (stoppingToken.IsCancellationRequested)
+        {
+            logger.LogDebug(ex, "Workflow health sampler stopped.");
+        }
+#pragma warning disable CA1031
+        catch (Exception ex)
+        {
+            metrics.RecordBackgroundJobRun(nameof(WorkflowHealthSamplerService), false);
+            logger.LogError(ex, "Workflow health sampling failed.");
+        }
+#pragma warning restore CA1031
+    }
+}

backend/src/Socialize.Api/Infrastructure/Payments/Stripe/Configuration/StripeOptions.cs

@@ -2,7 +2,7 @@ using System.ComponentModel.DataAnnotations;
 
 namespace Socialize.Api.Infrastructure.Payments.Stripe.Configuration;
 
-public class StripeOptions
+internal class StripeOptions
 {
     public const string ConfigurationSection = "Stripe";
 

backend/src/Socialize.Api/Infrastructure/Security/AccessScopeService.cs

@@ -4,54 +4,55 @@ using Socialize.Api.Modules.Organizations.Services;
 
 namespace Socialize.Api.Infrastructure.Security;
 
-public sealed class AccessScopeService(
+internal sealed class AccessScopeService(
     OrganizationAccessService organizationAccessService)
 {
-    public bool IsManager(ClaimsPrincipal user)
+    public static bool IsManager(ClaimsPrincipal user)
     {
         return user.IsInRole(KnownRoles.Administrator) || user.IsInRole(KnownRoles.Manager);
     }
 
-    public bool IsProvider(ClaimsPrincipal user)
+    public static bool IsProvider(ClaimsPrincipal user)
     {
         return user.IsInRole(KnownRoles.Provider);
     }
 
-    public bool IsClient(ClaimsPrincipal user)
+    public static bool IsClient(ClaimsPrincipal user)
     {
         return user.IsInRole(KnownRoles.Client);
     }
 
-    public bool CanAccessWorkspace(ClaimsPrincipal user, Guid workspaceId)
+    public static bool CanAccessWorkspace(ClaimsPrincipal user, Guid workspaceId)
     {
-        return IsManager(user) || user.GetWorkspaceScopeIds().Contains(workspaceId);
+        return user.GetWorkspaceScopeIds().Contains(workspaceId);
     }
 
-    public bool CanManageWorkspace(ClaimsPrincipal user, Guid workspaceId)
+    public static bool CanManageWorkspace(ClaimsPrincipal user, Guid workspaceId)
     {
         return IsManager(user) && CanAccessWorkspace(user, workspaceId);
     }
 
-    public bool CanAccessClient(ClaimsPrincipal user, Guid workspaceId, Guid clientId)
+    public static bool CanAccessClient(ClaimsPrincipal user, Guid workspaceId, Guid clientId)
     {
-        return IsManager(user)
-               || (CanAccessWorkspace(user, workspaceId) && user.GetClientScopeIds().Contains(clientId));
+        return CanAccessWorkspace(user, workspaceId) &&
+               (IsManager(user) || user.GetClientScopeIds().Contains(clientId));
     }
 
-    public bool CanAccessCampaign(ClaimsPrincipal user, Guid workspaceId, Guid clientId, Guid campaignId)
+    public static bool CanAccessCampaign(ClaimsPrincipal user, Guid workspaceId, Guid clientId, Guid campaignId)
     {
-        return IsManager(user)
-               || (CanAccessClient(user, workspaceId, clientId) && user.GetCampaignScopeIds().Contains(campaignId));
+        return CanAccessClient(user, workspaceId, clientId) &&
+               (IsManager(user) || user.GetCampaignScopeIds().Contains(campaignId));
     }
 
-    public bool CanContributeToCampaign(ClaimsPrincipal user, Guid workspaceId, Guid clientId, Guid campaignId)
+    public static bool CanContributeToCampaign(ClaimsPrincipal user, Guid workspaceId, Guid clientId, Guid campaignId)
     {
-        return IsManager(user) || (IsProvider(user) && CanAccessCampaign(user, workspaceId, clientId, campaignId));
+        return IsManager(user) && CanAccessCampaign(user, workspaceId, clientId, campaignId)
+               || IsProvider(user) && CanAccessCampaign(user, workspaceId, clientId, campaignId);
     }
 
-    public bool CanReviewContent(ClaimsPrincipal user, Guid workspaceId, Guid clientId, Guid campaignId)
+    public static bool CanReviewContent(ClaimsPrincipal user, Guid workspaceId, Guid clientId, Guid campaignId)
     {
-        return IsManager(user)
+        return IsManager(user) && CanAccessCampaign(user, workspaceId, clientId, campaignId)
                || IsProvider(user) && CanAccessCampaign(user, workspaceId, clientId, campaignId)
                || IsClient(user) && CanAccessClient(user, workspaceId, clientId);
     }
@@ -68,7 +69,7 @@ public sealed class AccessScopeService(
         Guid workspaceId,
         CancellationToken ct)
     {
-        return CanAccessWorkspace(user, workspaceId)
+        return user.GetWorkspaceScopeIds().Contains(workspaceId)
                || await organizationAccessService.HasInheritedWorkspacePermissionAsync(
                    user,
                    workspaceId,
@@ -81,7 +82,7 @@ public sealed class AccessScopeService(
         Guid workspaceId,
         CancellationToken ct)
     {
-        return IsManager(user)
+        return CanManageWorkspace(user, workspaceId)
                || await organizationAccessService.HasInheritedWorkspacePermissionAsync(
                    user,
                    workspaceId,
@@ -94,8 +95,7 @@ public sealed class AccessScopeService(
         Guid organizationId,
         CancellationToken ct)
     {
-        return IsManager(user)
-               || await organizationAccessService.HasOrganizationPermissionAsync(
+        return await organizationAccessService.HasOrganizationPermissionAsync(
                    user,
                    organizationId,
                    OrganizationPermissions.CreateWorkspaces,
@@ -108,8 +108,7 @@ public sealed class AccessScopeService(
         Guid clientId,
         CancellationToken ct)
     {
-        if (IsManager(user) ||
-            await organizationAccessService.HasInheritedWorkspacePermissionAsync(
+        if (await organizationAccessService.HasInheritedWorkspacePermissionAsync(
                 user,
                 workspaceId,
                 OrganizationPermissions.AccessOwnedWorkspaces,
@@ -128,8 +127,7 @@ public sealed class AccessScopeService(
         Guid campaignId,
         CancellationToken ct)
     {
-        if (IsManager(user) ||
-            await organizationAccessService.HasInheritedWorkspacePermissionAsync(
+        if (await organizationAccessService.HasInheritedWorkspacePermissionAsync(
                 user,
                 workspaceId,
                 OrganizationPermissions.AccessOwnedWorkspaces,
@@ -149,7 +147,7 @@ public sealed class AccessScopeService(
         Guid campaignId,
         CancellationToken ct)
     {
-        return IsManager(user)
+        return IsManager(user) && await CanAccessCampaignAsync(user, workspaceId, clientId, campaignId, ct)
                || await organizationAccessService.HasInheritedWorkspacePermissionAsync(
                    user,
                    workspaceId,
@@ -165,7 +163,7 @@ public sealed class AccessScopeService(
         Guid campaignId,
         CancellationToken ct)
     {
-        return IsManager(user)
+        return IsManager(user) && await CanAccessCampaignAsync(user, workspaceId, clientId, campaignId, ct)
                || await organizationAccessService.HasInheritedWorkspacePermissionAsync(
                    user,
                    workspaceId,

backend/src/Socialize.Api/Infrastructure/Security/ClaimsPrincipalExtensions.cs

@@ -1,8 +1,9 @@
-using System.Security.Claims;
+using System.Globalization;
+using System.Security.Claims;
 
 namespace Socialize.Api.Infrastructure.Security;
 
-public static class ClaimsPrincipalExtensions
+internal static class ClaimsPrincipalExtensions
 {
     public static IReadOnlyCollection<Guid> GetScopeIds(this ClaimsPrincipal claims, string key)
     {
@@ -81,11 +82,11 @@ public static class ClaimsPrincipalExtensions
 
         if (claim is null)
         {
-            throw new MissingClaimException(key);
+            throw MissingClaimException.ForClaim(key);
         }
 
         return typeof(TValue) == typeof(Guid)
             ? Guid.Parse(claim.Value)
-            : Convert.ChangeType(claim.Value, typeof(TValue));
+            : Convert.ChangeType(claim.Value, typeof(TValue), CultureInfo.InvariantCulture);
     }
 }

backend/src/Socialize.Api/Infrastructure/Security/GenerateJwtToken.cs

@@ -5,7 +5,7 @@ using Microsoft.IdentityModel.Tokens;
 
 namespace Socialize.Api.Infrastructure.Security;
 
-public static class JwtTokenHelper
+internal static class JwtTokenHelper
 {
     public static string GenerateJwtToken(
         TimeSpan expiresIn,

backend/src/Socialize.Api/Infrastructure/Security/KnownClaims.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Infrastructure.Security;
 
-public static class KnownClaims
+internal static class KnownClaims
 {
     public const string Alias = "alias";
     public const string PortraitUrl = "portraitUrl";

backend/src/Socialize.Api/Infrastructure/Security/MissingClaimException.cs

@@ -1,5 +1,23 @@
 namespace Socialize.Api.Infrastructure.Security;
 
-public class MissingClaimException(
-    string claimName)
-    : Exception($"Claim '{claimName}' is missing.");
+public class MissingClaimException : Exception
+{
+    public MissingClaimException()
+    {
+    }
+
+    public MissingClaimException(string message)
+        : base(message)
+    {
+    }
+
+    public MissingClaimException(string message, Exception innerException)
+        : base(message, innerException)
+    {
+    }
+
+    internal static MissingClaimException ForClaim(string claimName)
+    {
+        return new MissingClaimException($"Claim '{claimName}' is missing.");
+    }
+}

backend/src/Socialize.Api/Infrastructure/Security/PasswordGenerator.cs

@@ -4,15 +4,13 @@ using System.Text;
 namespace Socialize.Api.Infrastructure.Security;
 
 // If we need to add special characters we can alternate between 2 pools.
-public static class PasswordGenerator
+internal static class PasswordGenerator
 {
     private const string LowerLetters = "abcdefghijklmnopqrstuvwxyz";
     private const string UpperLetters = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
     private const string Numbers = "0123456789";
     private const string SpecialCharacters = "!@#$%^&*()_+-=[];',./`~{}|:\"<>?";
 
-    private static readonly Random Random = new();
-
     public static string Next(
         int length = 15,
         bool requireNumber = true,
@@ -23,7 +21,7 @@ public static class PasswordGenerator
         // Create pools based on the requirements
         StringBuilder characterPool = new();
 
-        if (requireNumber)
+        if (requireLowercase)
         {
             characterPool.Append(LowerLetters);
         }
@@ -51,22 +49,22 @@ public static class PasswordGenerator
 
         if (requireLowercase)
         {
-            password[index++] = LowerLetters[Random.Next(LowerLetters.Length)];
+            password[index++] = LowerLetters[RandomNumberGenerator.GetInt32(LowerLetters.Length)];
         }
 
         if (requireCapital)
         {
-            password[index++] = UpperLetters[Random.Next(UpperLetters.Length)];
+            password[index++] = UpperLetters[RandomNumberGenerator.GetInt32(UpperLetters.Length)];
         }
 
         if (requireNumber)
         {
-            password[index++] = Numbers[Random.Next(Numbers.Length)];
+            password[index++] = Numbers[RandomNumberGenerator.GetInt32(Numbers.Length)];
         }
 
         if (requireSpecialCharacter)
         {
-            password[index++] = SpecialCharacters[Random.Next(SpecialCharacters.Length)];
+            password[index++] = SpecialCharacters[RandomNumberGenerator.GetInt32(SpecialCharacters.Length)];
         }
 
         // Fill the rest with the password
@@ -85,7 +83,7 @@ public static class PasswordGenerator
     {
         for (int i = array.Length - 1; i > 0; i--)
         {
-            int j = Random.Next(i + 1);
+            int j = RandomNumberGenerator.GetInt32(i + 1);
             (array[i], array[j]) = (array[j], array[i]); // Swap elements
         }
     }

backend/src/Socialize.Api/Infrastructure/Security/RefreshTokenGenerator.cs

@@ -2,7 +2,7 @@ using System.Security.Cryptography;
 
 namespace Socialize.Api.Infrastructure.Security;
 
-public static class RefreshTokenGenerator
+internal static class RefreshTokenGenerator
 {
     public static string Next()
     {

backend/src/Socialize.Api/Infrastructure/TestData/TestDataSeedExtensions.cs

@@ -16,11 +16,12 @@ using Socialize.Api.Modules.Organizations.Data;
 using Socialize.Api.Modules.Organizations.Services;
 using Socialize.Api.Modules.Workspaces.Data;
 using Microsoft.AspNetCore.Identity;
-using Microsoft.Extensions.Options;
 
-namespace Socialize.Api.Infrastructure.Development;
+namespace Socialize.Api.Infrastructure.TestData;
 
-public static class DevelopmentSeedExtensions
+#pragma warning disable S1075 // Test data intentionally uses representative external URLs.
+
+internal static class TestDataSeedExtensions
 {
     private static readonly Guid OrganizationId = Guid.Parse("99999999-9999-9999-9999-999999999999");
     private static readonly Guid WorkspaceId = Guid.Parse("11111111-1111-1111-1111-111111111111");
@@ -39,23 +40,11 @@ public static class DevelopmentSeedExtensions
     private static readonly Guid ClientCommentId = Guid.Parse("77777777-7777-7777-7777-777777777777");
     private static readonly Guid NotificationId = Guid.Parse("88888888-8888-8888-8888-888888888888");
 
-    public static async Task<IApplicationBuilder> UseDevelopmentSeedAsync(
-        this IApplicationBuilder app,
+    public static async Task<IServiceProvider> SeedTestDataAsync(
+        this IServiceProvider services,
         CancellationToken cancellationToken = default)
     {
-        IHostEnvironment environment = app.ApplicationServices.GetRequiredService<IHostEnvironment>();
-        if (!environment.IsDevelopment())
-        {
-            return app;
-        }
-
-        using IServiceScope scope = app.ApplicationServices.CreateScope();
-        IOptions<DevelopmentSeedOptions> options = scope.ServiceProvider.GetRequiredService<IOptions<DevelopmentSeedOptions>>();
-        if (!options.Value.Enabled)
-        {
-            return app;
-        }
-
+        using IServiceScope scope = services.CreateScope();
         UserManager userManager = scope.ServiceProvider.GetRequiredService<UserManager>();
         AppDbContext dbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
 
@@ -64,7 +53,7 @@ public static class DevelopmentSeedExtensions
             id: Guid.Parse("aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"),
             username: "manager",
             email: "manager@socialize.local",
-            password: "manager",
+            password: "Manager1!",
             alias: "Northstar Manager",
             firstname: "Morgan",
             lastname: "Reid",
@@ -80,7 +69,7 @@ public static class DevelopmentSeedExtensions
             id: Guid.Parse("bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"),
             username: "client",
             email: "client@socialize.local",
-            password: "client",
+            password: "Client1!",
             alias: "Sofia Martin",
             firstname: "Sofia",
             lastname: "Martin",
@@ -97,7 +86,7 @@ public static class DevelopmentSeedExtensions
             id: Guid.Parse("cccccccc-cccc-cccc-cccc-cccccccccccc"),
             username: "provider",
             email: "provider@socialize.local",
-            password: "provider",
+            password: "Provider1!",
             alias: "Alex Studio",
             firstname: "Alex",
             lastname: "Studio",
@@ -115,7 +104,7 @@ public static class DevelopmentSeedExtensions
             id: Guid.Parse("dddddddd-dddd-dddd-dddd-dddddddddddd"),
             username: "dev",
             email: "dev@socialize.local",
-            password: "dev",
+            password: "Developer1!",
             alias: "Socialize Dev",
             firstname: "Jo",
             lastname: "Bumble",
@@ -138,7 +127,7 @@ public static class DevelopmentSeedExtensions
             dbContext,
             cancellationToken);
 
-        return app;
+        return services;
     }
 
     private static async Task<User> EnsureUserAsync(
@@ -175,7 +164,7 @@ public static class DevelopmentSeedExtensions
             if (!createResult.Succeeded)
             {
                 throw new InvalidOperationException(
-                    $"Failed to seed development user '{username}': {string.Join(", ", createResult.Errors.Select(error => error.Description))}");
+                    $"Failed to seed test user '{username}': {string.Join(", ", createResult.Errors.Select(error => error.Description))}");
             }
         }
 
@@ -195,7 +184,7 @@ public static class DevelopmentSeedExtensions
             if (!passwordResetResult.Succeeded)
             {
                 throw new InvalidOperationException(
-                    $"Failed to set development password for '{username}': {string.Join(", ", passwordResetResult.Errors.Select(error => error.Description))}");
+                    $"Failed to set test password for '{username}': {string.Join(", ", passwordResetResult.Errors.Select(error => error.Description))}");
             }
         }
 
@@ -222,13 +211,7 @@ public static class DevelopmentSeedExtensions
             await userManager.RemoveClaimAsync(user, claim);
         }
 
-        string persona = roles.Contains(KnownRoles.Manager, StringComparer.Ordinal)
-            ? KnownRoles.Manager
-            : roles.Contains(KnownRoles.Client, StringComparer.Ordinal)
-                ? KnownRoles.Client
-                : roles.Contains(KnownRoles.Provider, StringComparer.Ordinal)
-                    ? KnownRoles.Provider
-                    : KnownRoles.WorkspaceMember;
+        string persona = GetPersona(roles);
 
         foreach (Claim claim in claims.Concat([new Claim(KnownClaims.Persona, persona)]))
         {
@@ -238,6 +221,26 @@ public static class DevelopmentSeedExtensions
         return user;
     }
 
+    private static string GetPersona(IReadOnlyCollection<string> roles)
+    {
+        if (roles.Contains(KnownRoles.Manager, StringComparer.Ordinal))
+        {
+            return KnownRoles.Manager;
+        }
+
+        if (roles.Contains(KnownRoles.Client, StringComparer.Ordinal))
+        {
+            return KnownRoles.Client;
+        }
+
+        if (roles.Contains(KnownRoles.Provider, StringComparer.Ordinal))
+        {
+            return KnownRoles.Provider;
+        }
+
+        return KnownRoles.WorkspaceMember;
+    }
+
     private static async Task EnsureOrganizationDataAsync(
         Guid managerUserId,
         Guid developerUserId,
@@ -258,6 +261,7 @@ public static class DevelopmentSeedExtensions
         }
 
         organization.Name = "Northstar Agency";
+        organization.MembershipTierId = OrganizationMembershipTierSeed.AgencyId;
         organization.OwnerUserId = managerUserId;
 
         await UpsertOrganizationMembershipAsync(

backend/src/Socialize.Api/Infrastructure/YouTube/YouTubeUrlHelper.cs

@@ -2,7 +2,7 @@ using System.Text.RegularExpressions;
 
 namespace Socialize.Api.Infrastructure.YouTube;
 
-public static class YouTubeUrlHelper
+internal static class YouTubeUrlHelper
 {
     private static readonly Regex VideoIdRegex = new(
         @"(?:youtube\.com/(?:[^/]+/.+/|(?:v|e(?:mbed)?)/|.*[?&]v=)|youtu\.be/)([^""&?/\s]{11})",

backend/src/Socialize.Api/Migrations/20260507143849_Initial.Designer.cs

@@ -12,7 +12,7 @@ using Socialize.Api.Data;
 namespace Socialize.Api.Migrations
 {
     [DbContext(typeof(AppDbContext))]
-    [Migration("20260505192305_Initial")]
+    [Migration("20260507143849_Initial")]
     partial class Initial
     {
         /// <inheritdoc />
@@ -912,6 +912,29 @@ namespace Socialize.Api.Migrations
                         .ValueGeneratedOnAdd()
                         .HasColumnType("uuid");
 
+                    b.Property<string>("AttachmentBlobContainerName")
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("AttachmentBlobName")
+                        .HasMaxLength(512)
+                        .HasColumnType("character varying(512)");
+
+                    b.Property<string>("AttachmentBlobUrl")
+                        .HasMaxLength(1024)
+                        .HasColumnType("character varying(1024)");
+
+                    b.Property<string>("AttachmentContentType")
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("AttachmentFileName")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<long?>("AttachmentSizeBytes")
+                        .HasColumnType("bigint");
+
                     b.Property<string>("AuthorDisplayName")
                         .IsRequired()
                         .HasMaxLength(256)

backend/src/Socialize.Api/Migrations/20260507143849_Initial.cs

@@ -5,11 +5,12 @@ using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
 #nullable disable
 
 #pragma warning disable CA1814 // Prefer jagged arrays over multidimensional
+#pragma warning disable CA1861 // Generated migration seed arrays are not runtime hot paths.
 
 namespace Socialize.Api.Migrations
 {
     /// <inheritdoc />
-    public partial class Initial : Migration
+    internal partial class Initial : Migration
     {
         /// <inheritdoc />
         protected override void Up(MigrationBuilder migrationBuilder)
@@ -282,6 +283,12 @@ namespace Socialize.Api.Migrations
                     AuthorDisplayName = table.Column<string>(type: "character varying(256)", maxLength: 256, nullable: false),
                     AuthorEmail = table.Column<string>(type: "character varying(256)", maxLength: 256, nullable: false),
                     Body = table.Column<string>(type: "character varying(4000)", maxLength: 4000, nullable: false),
+                    AttachmentFileName = table.Column<string>(type: "character varying(256)", maxLength: 256, nullable: true),
+                    AttachmentContentType = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: true),
+                    AttachmentSizeBytes = table.Column<long>(type: "bigint", nullable: true),
+                    AttachmentBlobContainerName = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: true),
+                    AttachmentBlobName = table.Column<string>(type: "character varying(512)", maxLength: 512, nullable: true),
+                    AttachmentBlobUrl = table.Column<string>(type: "character varying(1024)", maxLength: 1024, nullable: true),
                     CreatedAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "CURRENT_TIMESTAMP")
                 },
                 constraints: table =>

backend/src/Socialize.Api/Migrations/20260507185052_AddMissingDomainForeignKeys.cs

@@ -0,0 +1,405 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace Socialize.Api.Migrations
+{
+    /// <inheritdoc />
+    internal partial class AddMissingDomainForeignKeys : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateIndex(
+                name: "IX_FeedbackReports_CampaignId",
+                table: "FeedbackReports",
+                column: "CampaignId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_FeedbackReports_ClientId",
+                table: "FeedbackReports",
+                column: "ClientId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_FeedbackReports_ContentItemId",
+                table: "FeedbackReports",
+                column: "ContentItemId");
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ApprovalDecisions_ApprovalRequests_ApprovalRequestId",
+                table: "ApprovalDecisions",
+                column: "ApprovalRequestId",
+                principalTable: "ApprovalRequests",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ApprovalRequests_ApprovalWorkflowInstances_WorkflowInstance~",
+                table: "ApprovalRequests",
+                column: "WorkflowInstanceId",
+                principalTable: "ApprovalWorkflowInstances",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ApprovalRequests_ContentItems_ContentItemId",
+                table: "ApprovalRequests",
+                column: "ContentItemId",
+                principalTable: "ContentItems",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ApprovalRequests_Workspaces_WorkspaceId",
+                table: "ApprovalRequests",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ApprovalWorkflowInstances_ContentItems_ContentItemId",
+                table: "ApprovalWorkflowInstances",
+                column: "ContentItemId",
+                principalTable: "ContentItems",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ApprovalWorkflowInstances_Workspaces_WorkspaceId",
+                table: "ApprovalWorkflowInstances",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_AssetRevisions_Assets_AssetId",
+                table: "AssetRevisions",
+                column: "AssetId",
+                principalTable: "Assets",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Cascade);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_Assets_ContentItems_ContentItemId",
+                table: "Assets",
+                column: "ContentItemId",
+                principalTable: "ContentItems",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_Assets_Workspaces_WorkspaceId",
+                table: "Assets",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_Campaigns_Clients_ClientId",
+                table: "Campaigns",
+                column: "ClientId",
+                principalTable: "Clients",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_Campaigns_Workspaces_WorkspaceId",
+                table: "Campaigns",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_Channels_Workspaces_WorkspaceId",
+                table: "Channels",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_Clients_Workspaces_WorkspaceId",
+                table: "Clients",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_Comments_Comments_ParentCommentId",
+                table: "Comments",
+                column: "ParentCommentId",
+                principalTable: "Comments",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_Comments_ContentItems_ContentItemId",
+                table: "Comments",
+                column: "ContentItemId",
+                principalTable: "ContentItems",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_Comments_Workspaces_WorkspaceId",
+                table: "Comments",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ContentItemActivityEntries_ContentItems_ContentItemId",
+                table: "ContentItemActivityEntries",
+                column: "ContentItemId",
+                principalTable: "ContentItems",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ContentItemActivityEntries_Workspaces_WorkspaceId",
+                table: "ContentItemActivityEntries",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ContentItemRevisions_ContentItems_ContentItemId",
+                table: "ContentItemRevisions",
+                column: "ContentItemId",
+                principalTable: "ContentItems",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Cascade);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ContentItems_Campaigns_CampaignId",
+                table: "ContentItems",
+                column: "CampaignId",
+                principalTable: "Campaigns",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ContentItems_Clients_ClientId",
+                table: "ContentItems",
+                column: "ClientId",
+                principalTable: "Clients",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_ContentItems_Workspaces_WorkspaceId",
+                table: "ContentItems",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_FeedbackReports_Campaigns_CampaignId",
+                table: "FeedbackReports",
+                column: "CampaignId",
+                principalTable: "Campaigns",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.SetNull);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_FeedbackReports_Clients_ClientId",
+                table: "FeedbackReports",
+                column: "ClientId",
+                principalTable: "Clients",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.SetNull);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_FeedbackReports_ContentItems_ContentItemId",
+                table: "FeedbackReports",
+                column: "ContentItemId",
+                principalTable: "ContentItems",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.SetNull);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_FeedbackReports_Workspaces_WorkspaceId",
+                table: "FeedbackReports",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.SetNull);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_NotificationEvents_ContentItems_ContentItemId",
+                table: "NotificationEvents",
+                column: "ContentItemId",
+                principalTable: "ContentItems",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.SetNull);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_NotificationEvents_Workspaces_WorkspaceId",
+                table: "NotificationEvents",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_WorkspaceApprovalStepConfigurations_Workspaces_WorkspaceId",
+                table: "WorkspaceApprovalStepConfigurations",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_WorkspaceInvites_Workspaces_WorkspaceId",
+                table: "WorkspaceInvites",
+                column: "WorkspaceId",
+                principalTable: "Workspaces",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropForeignKey(
+                name: "FK_ApprovalDecisions_ApprovalRequests_ApprovalRequestId",
+                table: "ApprovalDecisions");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_ApprovalRequests_ApprovalWorkflowInstances_WorkflowInstance~",
+                table: "ApprovalRequests");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_ApprovalRequests_ContentItems_ContentItemId",
+                table: "ApprovalRequests");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_ApprovalRequests_Workspaces_WorkspaceId",
+                table: "ApprovalRequests");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_ApprovalWorkflowInstances_ContentItems_ContentItemId",
+                table: "ApprovalWorkflowInstances");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_ApprovalWorkflowInstances_Workspaces_WorkspaceId",
+                table: "ApprovalWorkflowInstances");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_AssetRevisions_Assets_AssetId",
+                table: "AssetRevisions");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_Assets_ContentItems_ContentItemId",
+                table: "Assets");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_Assets_Workspaces_WorkspaceId",
+                table: "Assets");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_Campaigns_Clients_ClientId",
+                table: "Campaigns");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_Campaigns_Workspaces_WorkspaceId",
+                table: "Campaigns");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_Channels_Workspaces_WorkspaceId",
+                table: "Channels");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_Clients_Workspaces_WorkspaceId",
+                table: "Clients");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_Comments_Comments_ParentCommentId",
+                table: "Comments");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_Comments_ContentItems_ContentItemId",
+                table: "Comments");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_Comments_Workspaces_WorkspaceId",
+                table: "Comments");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_ContentItemActivityEntries_ContentItems_ContentItemId",
+                table: "ContentItemActivityEntries");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_ContentItemActivityEntries_Workspaces_WorkspaceId",
+                table: "ContentItemActivityEntries");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_ContentItemRevisions_ContentItems_ContentItemId",
+                table: "ContentItemRevisions");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_ContentItems_Campaigns_CampaignId",
+                table: "ContentItems");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_ContentItems_Clients_ClientId",
+                table: "ContentItems");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_ContentItems_Workspaces_WorkspaceId",
+                table: "ContentItems");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_FeedbackReports_Campaigns_CampaignId",
+                table: "FeedbackReports");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_FeedbackReports_Clients_ClientId",
+                table: "FeedbackReports");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_FeedbackReports_ContentItems_ContentItemId",
+                table: "FeedbackReports");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_FeedbackReports_Workspaces_WorkspaceId",
+                table: "FeedbackReports");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_NotificationEvents_ContentItems_ContentItemId",
+                table: "NotificationEvents");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_NotificationEvents_Workspaces_WorkspaceId",
+                table: "NotificationEvents");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_WorkspaceApprovalStepConfigurations_Workspaces_WorkspaceId",
+                table: "WorkspaceApprovalStepConfigurations");
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_WorkspaceInvites_Workspaces_WorkspaceId",
+                table: "WorkspaceInvites");
+
+            migrationBuilder.DropIndex(
+                name: "IX_FeedbackReports_CampaignId",
+                table: "FeedbackReports");
+
+            migrationBuilder.DropIndex(
+                name: "IX_FeedbackReports_ClientId",
+                table: "FeedbackReports");
+
+            migrationBuilder.DropIndex(
+                name: "IX_FeedbackReports_ContentItemId",
+                table: "FeedbackReports");
+        }
+    }
+}

backend/src/Socialize.Api/Migrations/20260508001846_AddOrganizationMembershipTiers.cs

@@ -0,0 +1,118 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+#pragma warning disable CA1814 // Prefer jagged arrays over multidimensional
+
+namespace Socialize.Api.Migrations
+{
+    /// <inheritdoc />
+    internal partial class AddOrganizationMembershipTiers : Migration
+    {
+        private static readonly string[] MembershipTierSeedColumns =
+        [
+            "Id",
+            "ActiveContentLimit",
+            "Description",
+            "ExternalReviewerLimit",
+            "IsCustom",
+            "Key",
+            "MemberLimit",
+            "MonthlyPriceCents",
+            "Name",
+            "SortOrder",
+            "WorkspaceLimit"
+        ];
+
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            ArgumentNullException.ThrowIfNull(migrationBuilder);
+
+            migrationBuilder.AddColumn<Guid>(
+                name: "MembershipTierId",
+                table: "Organizations",
+                type: "uuid",
+                nullable: false,
+                defaultValue: new Guid("20000000-0000-0000-0000-000000000001"));
+
+            migrationBuilder.CreateTable(
+                name: "OrganizationMembershipTiers",
+                columns: table => new
+                {
+                    Id = table.Column<Guid>(type: "uuid", nullable: false),
+                    Key = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: false),
+                    Name = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: false),
+                    Description = table.Column<string>(type: "character varying(512)", maxLength: 512, nullable: false),
+                    MonthlyPriceCents = table.Column<int>(type: "integer", nullable: true),
+                    WorkspaceLimit = table.Column<int>(type: "integer", nullable: true),
+                    ActiveContentLimit = table.Column<int>(type: "integer", nullable: true),
+                    MemberLimit = table.Column<int>(type: "integer", nullable: true),
+                    ExternalReviewerLimit = table.Column<int>(type: "integer", nullable: true),
+                    IsCustom = table.Column<bool>(type: "boolean", nullable: false),
+                    SortOrder = table.Column<int>(type: "integer", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_OrganizationMembershipTiers", x => x.Id);
+                });
+
+            migrationBuilder.InsertData(
+                table: "OrganizationMembershipTiers",
+                columns: MembershipTierSeedColumns,
+                values: new object[,]
+                {
+                    { new Guid("20000000-0000-0000-0000-000000000001"), 3, "For trying Socialize on one real approval workflow.", 1, false, "free", 2, 0, "Free", 10, 1 },
+                    { new Guid("20000000-0000-0000-0000-000000000002"), 25, "For solo operators managing recurring client reviews.", 10, false, "freelance", 5, 1900, "Freelance", 20, 3 },
+                    { new Guid("20000000-0000-0000-0000-000000000003"), 250, "For agencies that need repeatable client approval operations.", null, false, "agency", 25, 7900, "Agency", 30, 15 },
+                    { new Guid("20000000-0000-0000-0000-000000000004"), null, "For larger organizations with governance and access needs.", null, true, "enterprise", null, null, "Enterprise", 40, null }
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Organizations_MembershipTierId",
+                table: "Organizations",
+                column: "MembershipTierId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_OrganizationMembershipTiers_Key",
+                table: "OrganizationMembershipTiers",
+                column: "Key",
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_OrganizationMembershipTiers_SortOrder",
+                table: "OrganizationMembershipTiers",
+                column: "SortOrder");
+
+            migrationBuilder.AddForeignKey(
+                name: "FK_Organizations_OrganizationMembershipTiers_MembershipTierId",
+                table: "Organizations",
+                column: "MembershipTierId",
+                principalTable: "OrganizationMembershipTiers",
+                principalColumn: "Id",
+                onDelete: ReferentialAction.Restrict);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            ArgumentNullException.ThrowIfNull(migrationBuilder);
+
+            migrationBuilder.DropForeignKey(
+                name: "FK_Organizations_OrganizationMembershipTiers_MembershipTierId",
+                table: "Organizations");
+
+            migrationBuilder.DropTable(
+                name: "OrganizationMembershipTiers");
+
+            migrationBuilder.DropIndex(
+                name: "IX_Organizations_MembershipTierId",
+                table: "Organizations");
+
+            migrationBuilder.DropColumn(
+                name: "MembershipTierId",
+                table: "Organizations");
+        }
+    }
+}

backend/src/Socialize.Api/Migrations/20260508003746_LocalizeOrganizationMembershipTiers.cs

@@ -0,0 +1,137 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+#pragma warning disable CA1814 // Prefer jagged arrays over multidimensional
+
+namespace Socialize.Api.Migrations
+{
+    /// <inheritdoc />
+    internal partial class LocalizeOrganizationMembershipTiers : Migration
+    {
+        private static readonly string[] MembershipTierTranslationSeedColumns =
+        [
+            "Id",
+            "Culture",
+            "Description",
+            "MembershipTierId",
+            "Name"
+        ];
+
+        private static readonly string[] MembershipTierColumnsToRestore =
+        [
+            "Description",
+            "Name"
+        ];
+
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            ArgumentNullException.ThrowIfNull(migrationBuilder);
+
+            migrationBuilder.DropColumn(
+                name: "Description",
+                table: "OrganizationMembershipTiers");
+
+            migrationBuilder.DropColumn(
+                name: "Name",
+                table: "OrganizationMembershipTiers");
+
+            migrationBuilder.CreateTable(
+                name: "OrganizationMembershipTierTranslations",
+                columns: table => new
+                {
+                    Id = table.Column<Guid>(type: "uuid", nullable: false),
+                    MembershipTierId = table.Column<Guid>(type: "uuid", nullable: false),
+                    Culture = table.Column<string>(type: "character varying(16)", maxLength: 16, nullable: false),
+                    Name = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: false),
+                    Description = table.Column<string>(type: "character varying(512)", maxLength: 512, nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_OrganizationMembershipTierTranslations", x => x.Id);
+                    table.ForeignKey(
+                        name: "FK_OrganizationMembershipTierTranslations_OrganizationMembersh~",
+                        column: x => x.MembershipTierId,
+                        principalTable: "OrganizationMembershipTiers",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.InsertData(
+                table: "OrganizationMembershipTierTranslations",
+                columns: MembershipTierTranslationSeedColumns,
+                values: new object[,]
+                {
+                    { new Guid("20000000-0000-0001-0000-000000000001"), "en", "For trying Socialize on one real approval workflow.", new Guid("20000000-0000-0000-0000-000000000001"), "Free" },
+                    { new Guid("20000000-0000-0001-0000-000000000002"), "fr", "Pour essayer Socialize sur un vrai workflow d'approbation.", new Guid("20000000-0000-0000-0000-000000000001"), "Free" },
+                    { new Guid("20000000-0000-0001-0000-000000000003"), "en", "For solo operators managing recurring client reviews.", new Guid("20000000-0000-0000-0000-000000000002"), "Freelance" },
+                    { new Guid("20000000-0000-0001-0000-000000000004"), "fr", "Pour les independants qui gerent des revisions client recurrentes.", new Guid("20000000-0000-0000-0000-000000000002"), "Freelance" },
+                    { new Guid("20000000-0000-0001-0000-000000000005"), "en", "For agencies that need repeatable client approval operations.", new Guid("20000000-0000-0000-0000-000000000003"), "Agency" },
+                    { new Guid("20000000-0000-0001-0000-000000000006"), "fr", "Pour les agences qui veulent des operations d'approbation client repetables.", new Guid("20000000-0000-0000-0000-000000000003"), "Agency" },
+                    { new Guid("20000000-0000-0001-0000-000000000007"), "en", "For larger organizations with governance and access needs.", new Guid("20000000-0000-0000-0000-000000000004"), "Enterprise" },
+                    { new Guid("20000000-0000-0001-0000-000000000008"), "fr", "Pour les grandes organisations avec des besoins de gouvernance et d'acces.", new Guid("20000000-0000-0000-0000-000000000004"), "Enterprise" }
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_OrganizationMembershipTierTranslations_MembershipTierId_Cul~",
+                table: "OrganizationMembershipTierTranslations",
+                columns: ["MembershipTierId", "Culture"],
+                unique: true);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            ArgumentNullException.ThrowIfNull(migrationBuilder);
+
+            migrationBuilder.DropTable(
+                name: "OrganizationMembershipTierTranslations");
+
+            migrationBuilder.AddColumn<string>(
+                name: "Description",
+                table: "OrganizationMembershipTiers",
+                type: "character varying(512)",
+                maxLength: 512,
+                nullable: false,
+                defaultValue: "");
+
+            migrationBuilder.AddColumn<string>(
+                name: "Name",
+                table: "OrganizationMembershipTiers",
+                type: "character varying(128)",
+                maxLength: 128,
+                nullable: false,
+                defaultValue: "");
+
+            migrationBuilder.UpdateData(
+                table: "OrganizationMembershipTiers",
+                keyColumn: "Id",
+                keyValue: new Guid("20000000-0000-0000-0000-000000000001"),
+                columns: MembershipTierColumnsToRestore,
+                values: new object[] { "For trying Socialize on one real approval workflow.", "Free" });
+
+            migrationBuilder.UpdateData(
+                table: "OrganizationMembershipTiers",
+                keyColumn: "Id",
+                keyValue: new Guid("20000000-0000-0000-0000-000000000002"),
+                columns: MembershipTierColumnsToRestore,
+                values: new object[] { "For solo operators managing recurring client reviews.", "Freelance" });
+
+            migrationBuilder.UpdateData(
+                table: "OrganizationMembershipTiers",
+                keyColumn: "Id",
+                keyValue: new Guid("20000000-0000-0000-0000-000000000003"),
+                columns: MembershipTierColumnsToRestore,
+                values: new object[] { "For agencies that need repeatable client approval operations.", "Agency" });
+
+            migrationBuilder.UpdateData(
+                table: "OrganizationMembershipTiers",
+                keyColumn: "Id",
+                keyValue: new Guid("20000000-0000-0000-0000-000000000004"),
+                columns: MembershipTierColumnsToRestore,
+                values: new object[] { "For larger organizations with governance and access needs.", "Enterprise" });
+        }
+    }
+}

backend/src/Socialize.Api/Migrations/20260508010206_AddReleaseCommunications.cs

@@ -0,0 +1,197 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace Socialize.Api.Migrations
+{
+    /// <inheritdoc />
+    internal partial class AddReleaseCommunications : Migration
+    {
+        private static readonly string[] ReleaseUpdateReadReceiptUniqueIndexColumns =
+        [
+            "ReleaseUpdateId",
+            "UserId",
+        ];
+
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<DateTimeOffset>(
+                name: "LastAuthenticatedAt",
+                table: "AspNetUsers",
+                type: "timestamp with time zone",
+                nullable: true);
+
+            migrationBuilder.CreateTable(
+                name: "ReleaseUpdateEmailDigestReceipts",
+                columns: table => new
+                {
+                    Id = table.Column<Guid>(type: "uuid", nullable: false),
+                    UserId = table.Column<Guid>(type: "uuid", nullable: false),
+                    SentAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "CURRENT_TIMESTAMP"),
+                    UpdateCount = table.Column<int>(type: "integer", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_ReleaseUpdateEmailDigestReceipts", x => x.Id);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "ReleaseUpdates",
+                columns: table => new
+                {
+                    Id = table.Column<Guid>(type: "uuid", nullable: false),
+                    Title = table.Column<string>(type: "character varying(160)", maxLength: 160, nullable: false),
+                    Summary = table.Column<string>(type: "character varying(512)", maxLength: 512, nullable: false),
+                    Body = table.Column<string>(type: "character varying(8000)", maxLength: 8000, nullable: true),
+                    Category = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
+                    Importance = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
+                    Audience = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
+                    Status = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
+                    DeploymentLabel = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: true),
+                    BuildVersion = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: true),
+                    CommitRange = table.Column<string>(type: "character varying(256)", maxLength: 256, nullable: true),
+                    CreatedByUserId = table.Column<Guid>(type: "uuid", nullable: false),
+                    CreatedAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "CURRENT_TIMESTAMP"),
+                    UpdatedAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false),
+                    PublishedAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
+                    ArchivedAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
+                    ManualEmailSentByUserId = table.Column<Guid>(type: "uuid", nullable: true),
+                    ManualEmailSentAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
+                    ManualEmailAudience = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: true),
+                    ManualEmailRecipientCount = table.Column<int>(type: "integer", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_ReleaseUpdates", x => x.Id);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "ReleaseCommits",
+                columns: table => new
+                {
+                    Sha = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: false),
+                    ShortSha = table.Column<string>(type: "character varying(16)", maxLength: 16, nullable: false),
+                    Subject = table.Column<string>(type: "character varying(512)", maxLength: 512, nullable: false),
+                    AuthorName = table.Column<string>(type: "character varying(256)", maxLength: 256, nullable: true),
+                    AuthorEmail = table.Column<string>(type: "character varying(256)", maxLength: 256, nullable: true),
+                    AuthoredAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
+                    CommittedAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: true),
+                    SourceBranch = table.Column<string>(type: "character varying(256)", maxLength: 256, nullable: true),
+                    DeploymentLabel = table.Column<string>(type: "character varying(128)", maxLength: 128, nullable: true),
+                    ExternalUrl = table.Column<string>(type: "character varying(2048)", maxLength: 2048, nullable: true),
+                    CommunicationStatus = table.Column<string>(type: "character varying(32)", maxLength: 32, nullable: false),
+                    ReleaseUpdateId = table.Column<Guid>(type: "uuid", nullable: true),
+                    ImportedAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "CURRENT_TIMESTAMP"),
+                    UpdatedAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_ReleaseCommits", x => x.Sha);
+                    table.ForeignKey(
+                        name: "FK_ReleaseCommits_ReleaseUpdates_ReleaseUpdateId",
+                        column: x => x.ReleaseUpdateId,
+                        principalTable: "ReleaseUpdates",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.SetNull);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "ReleaseUpdateReadReceipts",
+                columns: table => new
+                {
+                    Id = table.Column<Guid>(type: "uuid", nullable: false),
+                    ReleaseUpdateId = table.Column<Guid>(type: "uuid", nullable: false),
+                    UserId = table.Column<Guid>(type: "uuid", nullable: false),
+                    ReadAt = table.Column<DateTimeOffset>(type: "timestamp with time zone", nullable: false, defaultValueSql: "CURRENT_TIMESTAMP")
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_ReleaseUpdateReadReceipts", x => x.Id);
+                    table.ForeignKey(
+                        name: "FK_ReleaseUpdateReadReceipts_ReleaseUpdates_ReleaseUpdateId",
+                        column: x => x.ReleaseUpdateId,
+                        principalTable: "ReleaseUpdates",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseCommits_CommittedAt",
+                table: "ReleaseCommits",
+                column: "CommittedAt");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseCommits_CommunicationStatus",
+                table: "ReleaseCommits",
+                column: "CommunicationStatus");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseCommits_ReleaseUpdateId",
+                table: "ReleaseCommits",
+                column: "ReleaseUpdateId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseUpdateEmailDigestReceipts_SentAt",
+                table: "ReleaseUpdateEmailDigestReceipts",
+                column: "SentAt");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseUpdateEmailDigestReceipts_UserId",
+                table: "ReleaseUpdateEmailDigestReceipts",
+                column: "UserId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseUpdateReadReceipts_ReleaseUpdateId_UserId",
+                table: "ReleaseUpdateReadReceipts",
+                columns: ReleaseUpdateReadReceiptUniqueIndexColumns,
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseUpdateReadReceipts_UserId",
+                table: "ReleaseUpdateReadReceipts",
+                column: "UserId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseUpdates_Audience",
+                table: "ReleaseUpdates",
+                column: "Audience");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseUpdates_CreatedByUserId",
+                table: "ReleaseUpdates",
+                column: "CreatedByUserId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseUpdates_PublishedAt",
+                table: "ReleaseUpdates",
+                column: "PublishedAt");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseUpdates_Status",
+                table: "ReleaseUpdates",
+                column: "Status");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "ReleaseCommits");
+
+            migrationBuilder.DropTable(
+                name: "ReleaseUpdateEmailDigestReceipts");
+
+            migrationBuilder.DropTable(
+                name: "ReleaseUpdateReadReceipts");
+
+            migrationBuilder.DropTable(
+                name: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "LastAuthenticatedAt",
+                table: "AspNetUsers");
+        }
+    }
+}

backend/src/Socialize.Api/Migrations/20260508030349_SimplifyReleaseUpdates.cs

@@ -0,0 +1,118 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace Socialize.Api.Migrations
+{
+    /// <inheritdoc />
+    internal partial class SimplifyReleaseUpdates : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropIndex(
+                name: "IX_ReleaseUpdates_Audience",
+                table: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "Audience",
+                table: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "Body",
+                table: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "BuildVersion",
+                table: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "Category",
+                table: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "CommitRange",
+                table: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "DeploymentLabel",
+                table: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "Importance",
+                table: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "ManualEmailAudience",
+                table: "ReleaseUpdates");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<string>(
+                name: "Audience",
+                table: "ReleaseUpdates",
+                type: "character varying(32)",
+                maxLength: 32,
+                nullable: false,
+                defaultValue: "");
+
+            migrationBuilder.AddColumn<string>(
+                name: "Body",
+                table: "ReleaseUpdates",
+                type: "character varying(8000)",
+                maxLength: 8000,
+                nullable: true);
+
+            migrationBuilder.AddColumn<string>(
+                name: "BuildVersion",
+                table: "ReleaseUpdates",
+                type: "character varying(128)",
+                maxLength: 128,
+                nullable: true);
+
+            migrationBuilder.AddColumn<string>(
+                name: "Category",
+                table: "ReleaseUpdates",
+                type: "character varying(32)",
+                maxLength: 32,
+                nullable: false,
+                defaultValue: "");
+
+            migrationBuilder.AddColumn<string>(
+                name: "CommitRange",
+                table: "ReleaseUpdates",
+                type: "character varying(256)",
+                maxLength: 256,
+                nullable: true);
+
+            migrationBuilder.AddColumn<string>(
+                name: "DeploymentLabel",
+                table: "ReleaseUpdates",
+                type: "character varying(128)",
+                maxLength: 128,
+                nullable: true);
+
+            migrationBuilder.AddColumn<string>(
+                name: "Importance",
+                table: "ReleaseUpdates",
+                type: "character varying(32)",
+                maxLength: 32,
+                nullable: false,
+                defaultValue: "");
+
+            migrationBuilder.AddColumn<string>(
+                name: "ManualEmailAudience",
+                table: "ReleaseUpdates",
+                type: "character varying(64)",
+                maxLength: 64,
+                nullable: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_ReleaseUpdates_Audience",
+                table: "ReleaseUpdates",
+                column: "Audience");
+        }
+    }
+}

backend/src/Socialize.Api/Migrations/20260508031114_AddFrenchReleaseUpdateFields.cs

@@ -0,0 +1,49 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace Socialize.Api.Migrations
+{
+    /// <inheritdoc />
+    internal partial class AddFrenchReleaseUpdateFields : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.AddColumn<string>(
+                name: "SummaryFr",
+                table: "ReleaseUpdates",
+                type: "character varying(512)",
+                maxLength: 512,
+                nullable: false,
+                defaultValue: "");
+
+            migrationBuilder.AddColumn<string>(
+                name: "TitleFr",
+                table: "ReleaseUpdates",
+                type: "character varying(160)",
+                maxLength: 160,
+                nullable: false,
+                defaultValue: "");
+
+            migrationBuilder.Sql("""
+                UPDATE "ReleaseUpdates"
+                SET "TitleFr" = "Title",
+                    "SummaryFr" = "Summary"
+                WHERE "TitleFr" = '' AND "SummaryFr" = '';
+                """);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropColumn(
+                name: "SummaryFr",
+                table: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "TitleFr",
+                table: "ReleaseUpdates");
+        }
+    }
+}

backend/src/Socialize.Api/Migrations/20260508034156_RemoveManualReleaseUpdateEmail.cs

@@ -0,0 +1,53 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace Socialize.Api.Migrations
+{
+    /// <inheritdoc />
+    internal partial class RemoveManualReleaseUpdateEmail : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            ArgumentNullException.ThrowIfNull(migrationBuilder);
+
+            migrationBuilder.DropColumn(
+                name: "ManualEmailRecipientCount",
+                table: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "ManualEmailSentAt",
+                table: "ReleaseUpdates");
+
+            migrationBuilder.DropColumn(
+                name: "ManualEmailSentByUserId",
+                table: "ReleaseUpdates");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            ArgumentNullException.ThrowIfNull(migrationBuilder);
+
+            migrationBuilder.AddColumn<int>(
+                name: "ManualEmailRecipientCount",
+                table: "ReleaseUpdates",
+                type: "integer",
+                nullable: true);
+
+            migrationBuilder.AddColumn<DateTimeOffset>(
+                name: "ManualEmailSentAt",
+                table: "ReleaseUpdates",
+                type: "timestamp with time zone",
+                nullable: true);
+
+            migrationBuilder.AddColumn<Guid>(
+                name: "ManualEmailSentByUserId",
+                table: "ReleaseUpdates",
+                type: "uuid",
+                nullable: true);
+        }
+    }
+}

backend/src/Socialize.Api/Migrations/20260508034902_ExpandReleaseUpdateDescriptions.cs

@@ -0,0 +1,62 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace Socialize.Api.Migrations
+{
+    /// <inheritdoc />
+    internal partial class ExpandReleaseUpdateDescriptions : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            ArgumentNullException.ThrowIfNull(migrationBuilder);
+
+            migrationBuilder.AlterColumn<string>(
+                name: "SummaryFr",
+                table: "ReleaseUpdates",
+                type: "character varying(4000)",
+                maxLength: 4000,
+                nullable: false,
+                oldClrType: typeof(string),
+                oldType: "character varying(512)",
+                oldMaxLength: 512);
+
+            migrationBuilder.AlterColumn<string>(
+                name: "Summary",
+                table: "ReleaseUpdates",
+                type: "character varying(4000)",
+                maxLength: 4000,
+                nullable: false,
+                oldClrType: typeof(string),
+                oldType: "character varying(512)",
+                oldMaxLength: 512);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            ArgumentNullException.ThrowIfNull(migrationBuilder);
+
+            migrationBuilder.AlterColumn<string>(
+                name: "SummaryFr",
+                table: "ReleaseUpdates",
+                type: "character varying(512)",
+                maxLength: 512,
+                nullable: false,
+                oldClrType: typeof(string),
+                oldType: "character varying(4000)",
+                oldMaxLength: 4000);
+
+            migrationBuilder.AlterColumn<string>(
+                name: "Summary",
+                table: "ReleaseUpdates",
+                type: "character varying(512)",
+                maxLength: 512,
+                nullable: false,
+                oldClrType: typeof(string),
+                oldType: "character varying(4000)",
+                oldMaxLength: 4000);
+        }
+    }
+}

backend/src/Socialize.Api/Migrations/20260508122220_AddUserPreferredLanguage.cs

@@ -0,0 +1,34 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace Socialize.Api.Migrations
+{
+    /// <inheritdoc />
+    internal partial class AddUserPreferredLanguage : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            ArgumentNullException.ThrowIfNull(migrationBuilder);
+
+            migrationBuilder.AddColumn<string>(
+                name: "PreferredLanguage",
+                table: "AspNetUsers",
+                type: "character varying(8)",
+                maxLength: 8,
+                nullable: false,
+                defaultValue: "en");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            ArgumentNullException.ThrowIfNull(migrationBuilder);
+
+            migrationBuilder.DropColumn(
+                name: "PreferredLanguage",
+                table: "AspNetUsers");
+        }
+    }
+}

backend/src/Socialize.Api/Migrations/AppDbContextModelSnapshot.cs

@@ -909,6 +909,29 @@ namespace Socialize.Api.Migrations
                         .ValueGeneratedOnAdd()
                         .HasColumnType("uuid");
 
+                    b.Property<string>("AttachmentBlobContainerName")
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("AttachmentBlobName")
+                        .HasMaxLength(512)
+                        .HasColumnType("character varying(512)");
+
+                    b.Property<string>("AttachmentBlobUrl")
+                        .HasMaxLength(1024)
+                        .HasColumnType("character varying(1024)");
+
+                    b.Property<string>("AttachmentContentType")
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("AttachmentFileName")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<long?>("AttachmentSizeBytes")
+                        .HasColumnType("bigint");
+
                     b.Property<string>("AuthorDisplayName")
                         .IsRequired()
                         .HasMaxLength(256)
@@ -1336,6 +1359,12 @@ namespace Socialize.Api.Migrations
 
                     b.HasKey("Id");
 
+                    b.HasIndex("CampaignId");
+
+                    b.HasIndex("ClientId");
+
+                    b.HasIndex("ContentItemId");
+
                     b.HasIndex("LastActivityAt");
 
                     b.HasIndex("ReporterUserId");
@@ -1493,6 +1522,9 @@ namespace Socialize.Api.Migrations
                         .HasMaxLength(256)
                         .HasColumnType("character varying(256)");
 
+                    b.Property<DateTimeOffset?>("LastAuthenticatedAt")
+                        .HasColumnType("timestamp with time zone");
+
                     b.Property<string>("Lastname")
                         .HasMaxLength(256)
                         .HasColumnType("character varying(256)");
@@ -1524,6 +1556,11 @@ namespace Socialize.Api.Migrations
                         .HasMaxLength(2048)
                         .HasColumnType("character varying(2048)");
 
+                    b.Property<string>("PreferredLanguage")
+                        .IsRequired()
+                        .HasMaxLength(8)
+                        .HasColumnType("character varying(8)");
+
                     b.Property<string>("RefreshToken")
                         .HasMaxLength(44)
                         .HasColumnType("character varying(44)");
@@ -1630,6 +1667,11 @@ namespace Socialize.Api.Migrations
                         .HasMaxLength(2048)
                         .HasColumnType("character varying(2048)");
 
+                    b.Property<Guid>("MembershipTierId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid")
+                        .HasDefaultValue(new Guid("20000000-0000-0000-0000-000000000001"));
+
                     b.Property<string>("Name")
                         .IsRequired()
                         .HasMaxLength(256)
@@ -1640,6 +1682,8 @@ namespace Socialize.Api.Migrations
 
                     b.HasKey("Id");
 
+                    b.HasIndex("MembershipTierId");
+
                     b.HasIndex("OwnerUserId");
 
                     b.ToTable("Organizations", (string)null);
@@ -1679,6 +1723,371 @@ namespace Socialize.Api.Migrations
                     b.ToTable("OrganizationMemberships", (string)null);
                 });
 
+            modelBuilder.Entity("Socialize.Api.Modules.Organizations.Data.OrganizationMembershipTier", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<int?>("ActiveContentLimit")
+                        .HasColumnType("integer");
+
+                    b.Property<int?>("ExternalReviewerLimit")
+                        .HasColumnType("integer");
+
+                    b.Property<bool>("IsCustom")
+                        .HasColumnType("boolean");
+
+                    b.Property<string>("Key")
+                        .IsRequired()
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<int?>("MemberLimit")
+                        .HasColumnType("integer");
+
+                    b.Property<int?>("MonthlyPriceCents")
+                        .HasColumnType("integer");
+
+                    b.Property<int>("SortOrder")
+                        .HasColumnType("integer");
+
+                    b.Property<int?>("WorkspaceLimit")
+                        .HasColumnType("integer");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("Key")
+                        .IsUnique();
+
+                    b.HasIndex("SortOrder");
+
+                    b.ToTable("OrganizationMembershipTiers", (string)null);
+
+                    b.HasData(
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0000-0000-000000000001"),
+                            ActiveContentLimit = 3,
+                            ExternalReviewerLimit = 1,
+                            IsCustom = false,
+                            Key = "free",
+                            MemberLimit = 2,
+                            MonthlyPriceCents = 0,
+                            SortOrder = 10,
+                            WorkspaceLimit = 1
+                        },
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0000-0000-000000000002"),
+                            ActiveContentLimit = 25,
+                            ExternalReviewerLimit = 10,
+                            IsCustom = false,
+                            Key = "freelance",
+                            MemberLimit = 5,
+                            MonthlyPriceCents = 1900,
+                            SortOrder = 20,
+                            WorkspaceLimit = 3
+                        },
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0000-0000-000000000003"),
+                            ActiveContentLimit = 250,
+                            IsCustom = false,
+                            Key = "agency",
+                            MemberLimit = 25,
+                            MonthlyPriceCents = 7900,
+                            SortOrder = 30,
+                            WorkspaceLimit = 15
+                        },
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0000-0000-000000000004"),
+                            IsCustom = true,
+                            Key = "enterprise",
+                            SortOrder = 40
+                        });
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.Organizations.Data.OrganizationMembershipTierTranslation", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<string>("Culture")
+                        .IsRequired()
+                        .HasMaxLength(16)
+                        .HasColumnType("character varying(16)");
+
+                    b.Property<string>("Description")
+                        .IsRequired()
+                        .HasMaxLength(512)
+                        .HasColumnType("character varying(512)");
+
+                    b.Property<Guid>("MembershipTierId")
+                        .HasColumnType("uuid");
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("MembershipTierId", "Culture")
+                        .IsUnique();
+
+                    b.ToTable("OrganizationMembershipTierTranslations", (string)null);
+
+                    b.HasData(
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0001-0000-000000000001"),
+                            Culture = "en",
+                            Description = "For trying Socialize on one real approval workflow.",
+                            MembershipTierId = new Guid("20000000-0000-0000-0000-000000000001"),
+                            Name = "Free"
+                        },
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0001-0000-000000000002"),
+                            Culture = "fr",
+                            Description = "Pour essayer Socialize sur un vrai workflow d'approbation.",
+                            MembershipTierId = new Guid("20000000-0000-0000-0000-000000000001"),
+                            Name = "Free"
+                        },
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0001-0000-000000000003"),
+                            Culture = "en",
+                            Description = "For solo operators managing recurring client reviews.",
+                            MembershipTierId = new Guid("20000000-0000-0000-0000-000000000002"),
+                            Name = "Freelance"
+                        },
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0001-0000-000000000004"),
+                            Culture = "fr",
+                            Description = "Pour les independants qui gerent des revisions client recurrentes.",
+                            MembershipTierId = new Guid("20000000-0000-0000-0000-000000000002"),
+                            Name = "Freelance"
+                        },
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0001-0000-000000000005"),
+                            Culture = "en",
+                            Description = "For agencies that need repeatable client approval operations.",
+                            MembershipTierId = new Guid("20000000-0000-0000-0000-000000000003"),
+                            Name = "Agency"
+                        },
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0001-0000-000000000006"),
+                            Culture = "fr",
+                            Description = "Pour les agences qui veulent des operations d'approbation client repetables.",
+                            MembershipTierId = new Guid("20000000-0000-0000-0000-000000000003"),
+                            Name = "Agency"
+                        },
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0001-0000-000000000007"),
+                            Culture = "en",
+                            Description = "For larger organizations with governance and access needs.",
+                            MembershipTierId = new Guid("20000000-0000-0000-0000-000000000004"),
+                            Name = "Enterprise"
+                        },
+                        new
+                        {
+                            Id = new Guid("20000000-0000-0001-0000-000000000008"),
+                            Culture = "fr",
+                            Description = "Pour les grandes organisations avec des besoins de gouvernance et d'acces.",
+                            MembershipTierId = new Guid("20000000-0000-0000-0000-000000000004"),
+                            Name = "Enterprise"
+                        });
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.ReleaseCommunications.Data.ReleaseCommit", b =>
+                {
+                    b.Property<string>("Sha")
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<string>("AuthorEmail")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<string>("AuthorName")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<DateTimeOffset?>("AuthoredAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<DateTimeOffset?>("CommittedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("CommunicationStatus")
+                        .IsRequired()
+                        .HasMaxLength(32)
+                        .HasColumnType("character varying(32)");
+
+                    b.Property<string>("DeploymentLabel")
+                        .HasMaxLength(128)
+                        .HasColumnType("character varying(128)");
+
+                    b.Property<string>("ExternalUrl")
+                        .HasMaxLength(2048)
+                        .HasColumnType("character varying(2048)");
+
+                    b.Property<DateTimeOffset>("ImportedAt")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("timestamp with time zone")
+                        .HasDefaultValueSql("CURRENT_TIMESTAMP");
+
+                    b.Property<Guid?>("ReleaseUpdateId")
+                        .HasColumnType("uuid");
+
+                    b.Property<string>("ShortSha")
+                        .IsRequired()
+                        .HasMaxLength(16)
+                        .HasColumnType("character varying(16)");
+
+                    b.Property<string>("SourceBranch")
+                        .HasMaxLength(256)
+                        .HasColumnType("character varying(256)");
+
+                    b.Property<string>("Subject")
+                        .IsRequired()
+                        .HasMaxLength(512)
+                        .HasColumnType("character varying(512)");
+
+                    b.Property<DateTimeOffset>("UpdatedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.HasKey("Sha");
+
+                    b.HasIndex("CommittedAt");
+
+                    b.HasIndex("CommunicationStatus");
+
+                    b.HasIndex("ReleaseUpdateId");
+
+                    b.ToTable("ReleaseCommits", (string)null);
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.ReleaseCommunications.Data.ReleaseUpdate", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<DateTimeOffset?>("ArchivedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<DateTimeOffset>("CreatedAt")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("timestamp with time zone")
+                        .HasDefaultValueSql("CURRENT_TIMESTAMP");
+
+                    b.Property<Guid>("CreatedByUserId")
+                        .HasColumnType("uuid");
+
+                    b.Property<DateTimeOffset?>("PublishedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("Status")
+                        .IsRequired()
+                        .HasMaxLength(32)
+                        .HasColumnType("character varying(32)");
+
+                    b.Property<string>("Summary")
+                        .IsRequired()
+                        .HasMaxLength(4000)
+                        .HasColumnType("character varying(4000)");
+
+                    b.Property<string>("SummaryFr")
+                        .IsRequired()
+                        .HasMaxLength(4000)
+                        .HasColumnType("character varying(4000)");
+
+                    b.Property<string>("Title")
+                        .IsRequired()
+                        .HasMaxLength(160)
+                        .HasColumnType("character varying(160)");
+
+                    b.Property<string>("TitleFr")
+                        .IsRequired()
+                        .HasMaxLength(160)
+                        .HasColumnType("character varying(160)");
+
+                    b.Property<DateTimeOffset>("UpdatedAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("CreatedByUserId");
+
+                    b.HasIndex("PublishedAt");
+
+                    b.HasIndex("Status");
+
+                    b.ToTable("ReleaseUpdates", (string)null);
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.ReleaseCommunications.Data.ReleaseUpdateEmailDigestReceipt", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<DateTimeOffset>("SentAt")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("timestamp with time zone")
+                        .HasDefaultValueSql("CURRENT_TIMESTAMP");
+
+                    b.Property<int>("UpdateCount")
+                        .HasColumnType("integer");
+
+                    b.Property<Guid>("UserId")
+                        .HasColumnType("uuid");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("SentAt");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("ReleaseUpdateEmailDigestReceipts", (string)null);
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.ReleaseCommunications.Data.ReleaseUpdateReadReceipt", b =>
+                {
+                    b.Property<Guid>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("uuid");
+
+                    b.Property<DateTimeOffset>("ReadAt")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("timestamp with time zone")
+                        .HasDefaultValueSql("CURRENT_TIMESTAMP");
+
+                    b.Property<Guid>("ReleaseUpdateId")
+                        .HasColumnType("uuid");
+
+                    b.Property<Guid>("UserId")
+                        .HasColumnType("uuid");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("UserId");
+
+                    b.HasIndex("ReleaseUpdateId", "UserId")
+                        .IsUnique();
+
+                    b.ToTable("ReleaseUpdateReadReceipts", (string)null);
+                });
+
             modelBuilder.Entity("Socialize.Api.Modules.Workspaces.Data.Workspace", b =>
                 {
                     b.Property<Guid>("Id")
@@ -1833,6 +2242,83 @@ namespace Socialize.Api.Migrations
                         .IsRequired();
                 });
 
+            modelBuilder.Entity("Socialize.Api.Modules.Approvals.Data.ApprovalDecision", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.Approvals.Data.ApprovalRequest", null)
+                        .WithMany()
+                        .HasForeignKey("ApprovalRequestId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.Approvals.Data.ApprovalRequest", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.ContentItems.Data.ContentItem", null)
+                        .WithMany()
+                        .HasForeignKey("ContentItemId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.HasOne("Socialize.Api.Modules.Approvals.Data.ApprovalWorkflowInstance", null)
+                        .WithMany()
+                        .HasForeignKey("WorkflowInstanceId")
+                        .OnDelete(DeleteBehavior.Restrict);
+
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.Approvals.Data.ApprovalWorkflowInstance", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.ContentItems.Data.ContentItem", null)
+                        .WithMany()
+                        .HasForeignKey("ContentItemId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.Approvals.Data.WorkspaceApprovalStepConfiguration", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.Assets.Data.Asset", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.ContentItems.Data.ContentItem", null)
+                        .WithMany()
+                        .HasForeignKey("ContentItemId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.Assets.Data.AssetRevision", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.Assets.Data.Asset", null)
+                        .WithMany()
+                        .HasForeignKey("AssetId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
             modelBuilder.Entity("Socialize.Api.Modules.CalendarIntegrations.Data.CalendarEvent", b =>
                 {
                     b.HasOne("Socialize.Api.Modules.CalendarIntegrations.Data.CalendarSource", null)
@@ -1842,6 +2328,104 @@ namespace Socialize.Api.Migrations
                         .IsRequired();
                 });
 
+            modelBuilder.Entity("Socialize.Api.Modules.Campaigns.Data.Campaign", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.Clients.Data.Client", null)
+                        .WithMany()
+                        .HasForeignKey("ClientId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.Channels.Data.Channel", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.Clients.Data.Client", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.Comments.Data.Comment", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.ContentItems.Data.ContentItem", null)
+                        .WithMany()
+                        .HasForeignKey("ContentItemId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.HasOne("Socialize.Api.Modules.Comments.Data.Comment", null)
+                        .WithMany()
+                        .HasForeignKey("ParentCommentId")
+                        .OnDelete(DeleteBehavior.Restrict);
+
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.ContentItems.Data.ContentItem", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.Campaigns.Data.Campaign", null)
+                        .WithMany()
+                        .HasForeignKey("CampaignId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.HasOne("Socialize.Api.Modules.Clients.Data.Client", null)
+                        .WithMany()
+                        .HasForeignKey("ClientId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.ContentItems.Data.ContentItemActivityEntry", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.ContentItems.Data.ContentItem", null)
+                        .WithMany()
+                        .HasForeignKey("ContentItemId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.ContentItems.Data.ContentItemRevision", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.ContentItems.Data.ContentItem", null)
+                        .WithMany()
+                        .HasForeignKey("ContentItemId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
             modelBuilder.Entity("Socialize.Api.Modules.Feedback.Data.FeedbackActivityEntry", b =>
                 {
                     b.HasOne("Socialize.Api.Modules.Feedback.Data.FeedbackReport", "FeedbackReport")
@@ -1864,6 +2448,29 @@ namespace Socialize.Api.Migrations
                     b.Navigation("FeedbackReport");
                 });
 
+            modelBuilder.Entity("Socialize.Api.Modules.Feedback.Data.FeedbackReport", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.Campaigns.Data.Campaign", null)
+                        .WithMany()
+                        .HasForeignKey("CampaignId")
+                        .OnDelete(DeleteBehavior.SetNull);
+
+                    b.HasOne("Socialize.Api.Modules.Clients.Data.Client", null)
+                        .WithMany()
+                        .HasForeignKey("ClientId")
+                        .OnDelete(DeleteBehavior.SetNull);
+
+                    b.HasOne("Socialize.Api.Modules.ContentItems.Data.ContentItem", null)
+                        .WithMany()
+                        .HasForeignKey("ContentItemId")
+                        .OnDelete(DeleteBehavior.SetNull);
+
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.SetNull);
+                });
+
             modelBuilder.Entity("Socialize.Api.Modules.Feedback.Data.FeedbackScreenshot", b =>
                 {
                     b.HasOne("Socialize.Api.Modules.Feedback.Data.FeedbackReport", "FeedbackReport")
@@ -1886,6 +2493,29 @@ namespace Socialize.Api.Migrations
                     b.Navigation("FeedbackReport");
                 });
 
+            modelBuilder.Entity("Socialize.Api.Modules.Notifications.Data.NotificationEvent", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.ContentItems.Data.ContentItem", null)
+                        .WithMany()
+                        .HasForeignKey("ContentItemId")
+                        .OnDelete(DeleteBehavior.SetNull);
+
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.Organizations.Data.Organization", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.Organizations.Data.OrganizationMembershipTier", null)
+                        .WithMany()
+                        .HasForeignKey("MembershipTierId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
             modelBuilder.Entity("Socialize.Api.Modules.Organizations.Data.OrganizationMembership", b =>
                 {
                     b.HasOne("Socialize.Api.Modules.Organizations.Data.Organization", null)
@@ -1895,6 +2525,36 @@ namespace Socialize.Api.Migrations
                         .IsRequired();
                 });
 
+            modelBuilder.Entity("Socialize.Api.Modules.Organizations.Data.OrganizationMembershipTierTranslation", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.Organizations.Data.OrganizationMembershipTier", null)
+                        .WithMany()
+                        .HasForeignKey("MembershipTierId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.ReleaseCommunications.Data.ReleaseCommit", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.ReleaseCommunications.Data.ReleaseUpdate", "ReleaseUpdate")
+                        .WithMany()
+                        .HasForeignKey("ReleaseUpdateId")
+                        .OnDelete(DeleteBehavior.SetNull);
+
+                    b.Navigation("ReleaseUpdate");
+                });
+
+            modelBuilder.Entity("Socialize.Api.Modules.ReleaseCommunications.Data.ReleaseUpdateReadReceipt", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.ReleaseCommunications.Data.ReleaseUpdate", "ReleaseUpdate")
+                        .WithMany("ReadReceipts")
+                        .HasForeignKey("ReleaseUpdateId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("ReleaseUpdate");
+                });
+
             modelBuilder.Entity("Socialize.Api.Modules.Workspaces.Data.Workspace", b =>
                 {
                     b.HasOne("Socialize.Api.Modules.Organizations.Data.Organization", null)
@@ -1904,6 +2564,15 @@ namespace Socialize.Api.Migrations
                         .IsRequired();
                 });
 
+            modelBuilder.Entity("Socialize.Api.Modules.Workspaces.Data.WorkspaceInvite", b =>
+                {
+                    b.HasOne("Socialize.Api.Modules.Workspaces.Data.Workspace", null)
+                        .WithMany()
+                        .HasForeignKey("WorkspaceId")
+                        .OnDelete(DeleteBehavior.Restrict)
+                        .IsRequired();
+                });
+
             modelBuilder.Entity("Socialize.Api.Modules.Feedback.Data.FeedbackReport", b =>
                 {
                     b.Navigation("ActivityEntries");
@@ -1914,6 +2583,11 @@ namespace Socialize.Api.Migrations
 
                     b.Navigation("Tags");
                 });
+
+            modelBuilder.Entity("Socialize.Api.Modules.ReleaseCommunications.Data.ReleaseUpdate", b =>
+                {
+                    b.Navigation("ReadReceipts");
+                });
 #pragma warning restore 612, 618
         }
     }

backend/src/Socialize.Api/Modules/Approvals/Data/ApprovalDecision.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Modules.Approvals.Data;
 
-public class ApprovalDecision
+internal class ApprovalDecision
 {
     public Guid Id { get; init; }
     public Guid ApprovalRequestId { get; set; }

backend/src/Socialize.Api/Modules/Approvals/Data/ApprovalModelConfiguration.cs

@@ -1,8 +1,10 @@
 using Microsoft.EntityFrameworkCore;
+using Socialize.Api.Modules.ContentItems.Data;
+using Socialize.Api.Modules.Workspaces.Data;
 
 namespace Socialize.Api.Modules.Approvals.Data;
 
-public static class ApprovalModelConfiguration
+internal static class ApprovalModelConfiguration
 {
     public static ModelBuilder ConfigureApprovalsModule(this ModelBuilder modelBuilder)
     {
@@ -20,6 +22,14 @@ public static class ApprovalModelConfiguration
             workflowInstance.HasIndex(x => new { x.ContentItemId, x.State })
                 .IsUnique()
                 .HasFilter("\"State\" = 'Pending'");
+            workflowInstance.HasOne<Workspace>()
+                .WithMany()
+                .HasForeignKey(x => x.WorkspaceId)
+                .OnDelete(DeleteBehavior.Restrict);
+            workflowInstance.HasOne<ContentItem>()
+                .WithMany()
+                .HasForeignKey(x => x.ContentItemId)
+                .OnDelete(DeleteBehavior.Restrict);
         });
 
         modelBuilder.Entity<ApprovalRequest>(approvalRequest =>
@@ -40,6 +50,18 @@ public static class ApprovalModelConfiguration
             approvalRequest.HasIndex(x => x.ContentItemId);
             approvalRequest.HasIndex(x => x.WorkflowInstanceId);
             approvalRequest.HasIndex(x => x.ReviewerEmail);
+            approvalRequest.HasOne<Workspace>()
+                .WithMany()
+                .HasForeignKey(x => x.WorkspaceId)
+                .OnDelete(DeleteBehavior.Restrict);
+            approvalRequest.HasOne<ContentItem>()
+                .WithMany()
+                .HasForeignKey(x => x.ContentItemId)
+                .OnDelete(DeleteBehavior.Restrict);
+            approvalRequest.HasOne<ApprovalWorkflowInstance>()
+                .WithMany()
+                .HasForeignKey(x => x.WorkflowInstanceId)
+                .OnDelete(DeleteBehavior.Restrict);
         });
 
         modelBuilder.Entity<ApprovalDecision>(approvalDecision =>
@@ -54,6 +76,10 @@ public static class ApprovalModelConfiguration
                 .ValueGeneratedOnAdd()
                 .HasDefaultValueSql("CURRENT_TIMESTAMP");
             approvalDecision.HasIndex(x => x.ApprovalRequestId);
+            approvalDecision.HasOne<ApprovalRequest>()
+                .WithMany()
+                .HasForeignKey(x => x.ApprovalRequestId)
+                .OnDelete(DeleteBehavior.Restrict);
         });
 
         modelBuilder.Entity<WorkspaceApprovalStepConfiguration>(approvalStep =>
@@ -69,6 +95,10 @@ public static class ApprovalModelConfiguration
                 .HasDefaultValueSql("CURRENT_TIMESTAMP");
             approvalStep.HasIndex(x => x.WorkspaceId);
             approvalStep.HasIndex(x => new { x.WorkspaceId, x.SortOrder }).IsUnique();
+            approvalStep.HasOne<Workspace>()
+                .WithMany()
+                .HasForeignKey(x => x.WorkspaceId)
+                .OnDelete(DeleteBehavior.Restrict);
         });
 
         return modelBuilder;

backend/src/Socialize.Api/Modules/Approvals/Data/ApprovalRequest.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Modules.Approvals.Data;
 
-public class ApprovalRequest
+internal class ApprovalRequest
 {
     public Guid Id { get; init; }
     public Guid WorkspaceId { get; set; }

backend/src/Socialize.Api/Modules/Approvals/Data/ApprovalWorkflowInstance.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Modules.Approvals.Data;
 
-public class ApprovalWorkflowInstance
+internal class ApprovalWorkflowInstance
 {
     public Guid Id { get; init; }
     public Guid WorkspaceId { get; set; }

backend/src/Socialize.Api/Modules/Approvals/Data/WorkspaceApprovalStepConfiguration.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Modules.Approvals.Data;
 
-public class WorkspaceApprovalStepConfiguration
+internal class WorkspaceApprovalStepConfiguration
 {
     public Guid Id { get; init; }
     public Guid WorkspaceId { get; set; }

backend/src/Socialize.Api/Modules/Approvals/Handlers/GetApprovals.cs

@@ -7,9 +7,9 @@ using Socialize.Api.Infrastructure.Security;
 
 namespace Socialize.Api.Modules.Approvals.Handlers;
 
-public record GetApprovalsRequest(Guid ContentItemId);
+internal record GetApprovalsRequest(Guid ContentItemId);
 
-public record ApprovalDecisionDto(
+internal record ApprovalDecisionDto(
     Guid Id,
     Guid ApprovalRequestId,
     string Decision,
@@ -20,7 +20,7 @@ public record ApprovalDecisionDto(
     string? DecidedByPortraitUrl,
     DateTimeOffset CreatedAt);
 
-public record ApprovalRequestDto(
+internal record ApprovalRequestDto(
     Guid Id,
     Guid WorkspaceId,
     Guid ContentItemId,
@@ -40,7 +40,7 @@ public record ApprovalRequestDto(
     DateTimeOffset? CompletedAt,
     IReadOnlyCollection<ApprovalDecisionDto> Decisions);
 
-public class GetApprovalsHandler(
+internal class GetApprovalsHandler(
     AppDbContext dbContext,
     AccessScopeService accessScopeService)
     : Endpoint<GetApprovalsRequest, IReadOnlyCollection<ApprovalRequestDto>>

backend/src/Socialize.Api/Modules/Approvals/Handlers/SubmitApprovalDecision.cs

@@ -1,6 +1,7 @@
 using FastEndpoints;
 using Microsoft.EntityFrameworkCore;
 using Socialize.Api.Data;
+using Socialize.Api.Infrastructure.Observability;
 using Socialize.Api.Infrastructure.Security;
 using Socialize.Api.Modules.ContentItems.Data;
 using Socialize.Api.Modules.ContentItems.Contracts;
@@ -8,16 +9,17 @@ using Socialize.Api.Modules.Approvals.Data;
 using Socialize.Api.Modules.Approvals.Services;
 using Socialize.Api.Modules.Notifications.Contracts;
 using Socialize.Api.Modules.Workspaces.Data;
+using System.Security.Claims;
 using System.Text.Json;
 
 namespace Socialize.Api.Modules.Approvals.Handlers;
 
-public record SubmitApprovalDecisionRequest(
+internal record SubmitApprovalDecisionRequest(
     string Decision,
     string? ReviewerName,
     string? ReviewerEmail);
 
-public class SubmitApprovalDecisionRequestValidator
+internal class SubmitApprovalDecisionRequestValidator
     : Validator<SubmitApprovalDecisionRequest>
 {
     public SubmitApprovalDecisionRequestValidator()
@@ -31,12 +33,13 @@ public class SubmitApprovalDecisionRequestValidator
     }
 }
 
-public class SubmitApprovalDecisionHandler(
+internal class SubmitApprovalDecisionHandler(
     AppDbContext dbContext,
     AccessScopeService accessScopeService,
     ApprovalWorkflowRuntimeService approvalWorkflowRuntimeService,
     IContentItemActivityWriter activityWriter,
-    INotificationEventWriter notificationEventWriter)
+    INotificationEventWriter notificationEventWriter,
+    SocializeMetrics metrics)
     : Endpoint<SubmitApprovalDecisionRequest, ApprovalRequestDto>
 {
     public override void Configure()
@@ -79,12 +82,14 @@ public class SubmitApprovalDecisionHandler(
         }
 
         string normalizedDecision = request.Decision.Trim();
-        string decidedByName = User?.Identity?.IsAuthenticated == true
-            ? User.GetAlias() ?? User.GetName()
-            : string.IsNullOrWhiteSpace(request.ReviewerName) ? approval.ReviewerName : request.ReviewerName.Trim();
-        string decidedByEmail = User?.Identity?.IsAuthenticated == true
-            ? User.GetEmail()
-            : string.IsNullOrWhiteSpace(request.ReviewerEmail) ? approval.ReviewerEmail : request.ReviewerEmail.Trim();
+        ClaimsPrincipal? currentUser = User;
+        bool isAuthenticated = currentUser?.Identity?.IsAuthenticated == true;
+        string decidedByName = isAuthenticated
+            ? currentUser!.GetAlias() ?? currentUser!.GetName()
+            : GetReviewerName(request.ReviewerName, approval.ReviewerName);
+        string decidedByEmail = isAuthenticated
+            ? currentUser!.GetEmail()
+            : GetReviewerEmail(request.ReviewerEmail, approval.ReviewerEmail);
 
         ApprovalDecision decision = new()
         {
@@ -154,6 +159,7 @@ public class SubmitApprovalDecisionHandler(
                     $$"""{"stage":"{{approval.Stage}}","status":"{{contentItem.Status}}"}"""),
                 ct);
         }
+        metrics.RecordApprovalDecisionSubmitted(approval.WorkspaceId, normalizedDecision);
 
         List<ApprovalDecision> decisions = await dbContext.ApprovalDecisions
             .Where(candidate => candidate.ApprovalRequestId == approval.Id)
@@ -207,4 +213,18 @@ public class SubmitApprovalDecisionHandler(
 
         await SendOkAsync(dto, ct);
     }
+
+    private static string GetReviewerName(string? requestedName, string fallbackName)
+    {
+        return string.IsNullOrWhiteSpace(requestedName)
+            ? fallbackName
+            : requestedName.Trim();
+    }
+
+    private static string GetReviewerEmail(string? requestedEmail, string fallbackEmail)
+    {
+        return string.IsNullOrWhiteSpace(requestedEmail)
+            ? fallbackEmail
+            : requestedEmail.Trim();
+    }
 }

backend/src/Socialize.Api/Modules/Approvals/ModuleRegistration.cs

@@ -2,7 +2,7 @@ using Socialize.Api.Modules.Approvals.Services;
 
 namespace Socialize.Api.Modules.Approvals;
 
-public static class DependencyInjection
+internal static class ModuleRegistration
 {
     public static WebApplicationBuilder AddApprovalsModule(
         this WebApplicationBuilder builder)

backend/src/Socialize.Api/Modules/Approvals/Services/ApprovalStepConfigurationRules.cs

@@ -2,20 +2,20 @@ using Socialize.Api.Modules.Identity.Contracts;
 
 namespace Socialize.Api.Modules.Approvals.Services;
 
-public static class ApprovalStepTargetTypes
+internal static class ApprovalStepTargetTypes
 {
     public const string Role = "Role";
     public const string Membership = "Membership";
     public const string Member = "Member";
 }
 
-public static class ApprovalMembershipTargets
+internal static class ApprovalMembershipTargets
 {
     public const string Team = "Team";
     public const string Client = "Client";
 }
 
-public static class ApprovalStepConfigurationRules
+internal static class ApprovalStepConfigurationRules
 {
     public static readonly IReadOnlySet<string> AllowedTargetTypes = new HashSet<string>(StringComparer.Ordinal)
     {

backend/src/Socialize.Api/Modules/Approvals/Services/ApprovalWorkflowRules.cs

@@ -2,7 +2,7 @@ using Socialize.Api.Modules.Identity.Contracts;
 
 namespace Socialize.Api.Modules.Approvals.Services;
 
-public static class ApprovalModes
+internal static class ApprovalModes
 {
     public const string None = "None";
     public const string Optional = "Optional";
@@ -10,7 +10,7 @@ public static class ApprovalModes
     public const string MultiLevel = "Multi-level";
 }
 
-public static class ApprovalWorkflowRules
+internal static class ApprovalWorkflowRules
 {
     public static bool BlocksManualApprovedOrScheduledStatus(string approvalMode)
     {

backend/src/Socialize.Api/Modules/Approvals/Services/ApprovalWorkflowRuntimeService.cs

@@ -11,15 +11,15 @@ using Socialize.Api.Modules.Workspaces.Data;
 
 namespace Socialize.Api.Modules.Approvals.Services;
 
-public record ApprovalWorkflowStartResult(bool Succeeded, string? ErrorMessage);
+internal record ApprovalWorkflowStartResult(bool Succeeded, string? ErrorMessage);
 
-public record ApprovalWorkflowDecisionResult(
+internal record ApprovalWorkflowDecisionResult(
     bool Succeeded,
     string? ErrorMessage,
     int StatusCode,
     bool IsWorkflowStep);
 
-public class ApprovalWorkflowRuntimeService(
+internal class ApprovalWorkflowRuntimeService(
     AppDbContext dbContext,
     INotificationEventWriter notificationEventWriter)
 {
@@ -145,13 +145,15 @@ public class ApprovalWorkflowRuntimeService(
         dbContext.ApprovalDecisions.Add(decision);
         await dbContext.SaveChangesAsync(ct);
 
-        int approvedCount = await dbContext.ApprovalDecisions
+        var approvalDecisionParticipants = await dbContext.ApprovalDecisions
             .Where(candidate => candidate.ApprovalRequestId == approval.Id && candidate.Decision == ApprovedState)
             .Select(candidate => candidate.DecidedByUserId.HasValue
                 ? candidate.DecidedByUserId.Value.ToString()
-                : candidate.DecidedByEmail.ToLower())
-            .Distinct()
-            .CountAsync(ct);
+                : candidate.DecidedByEmail)
+            .ToListAsync(ct);
+        int approvedCount = approvalDecisionParticipants
+            .Distinct(StringComparer.OrdinalIgnoreCase)
+            .Count();
 
         int requiredApproverCount = approval.WorkflowStepRequiredApproverCount ?? 1;
         if (!ApprovalWorkflowRules.HasRequiredStepApprovals(approvedCount, requiredApproverCount))
@@ -394,7 +396,7 @@ public class ApprovalWorkflowRuntimeService(
 
     private static string CreateAccessToken()
     {
-        return Convert.ToHexString(RandomNumberGenerator.GetBytes(16)).ToLowerInvariant();
+        return Convert.ToHexString(RandomNumberGenerator.GetBytes(16));
     }
 
     private sealed record ApprovalNotificationRecipient(Guid UserId, string? Email);

backend/src/Socialize.Api/Modules/Assets/Data/Asset.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Modules.Assets.Data;
 
-public class Asset
+internal class Asset
 {
     public Guid Id { get; init; }
     public Guid WorkspaceId { get; set; }

backend/src/Socialize.Api/Modules/Assets/Data/AssetModelConfiguration.cs

@@ -1,8 +1,10 @@
 using Microsoft.EntityFrameworkCore;
+using Socialize.Api.Modules.ContentItems.Data;
+using Socialize.Api.Modules.Workspaces.Data;
 
 namespace Socialize.Api.Modules.Assets.Data;
 
-public static class AssetModelConfiguration
+internal static class AssetModelConfiguration
 {
     public static ModelBuilder ConfigureAssetsModule(this ModelBuilder modelBuilder)
     {
@@ -21,6 +23,14 @@ public static class AssetModelConfiguration
                 .HasDefaultValueSql("CURRENT_TIMESTAMP");
             asset.HasIndex(x => x.WorkspaceId);
             asset.HasIndex(x => x.ContentItemId);
+            asset.HasOne<Workspace>()
+                .WithMany()
+                .HasForeignKey(x => x.WorkspaceId)
+                .OnDelete(DeleteBehavior.Restrict);
+            asset.HasOne<ContentItem>()
+                .WithMany()
+                .HasForeignKey(x => x.ContentItemId)
+                .OnDelete(DeleteBehavior.Restrict);
         });
 
         modelBuilder.Entity<AssetRevision>(revision =>
@@ -35,6 +45,10 @@ public static class AssetModelConfiguration
                 .HasDefaultValueSql("CURRENT_TIMESTAMP");
             revision.HasIndex(x => x.AssetId);
             revision.HasIndex(x => new { x.AssetId, x.RevisionNumber }).IsUnique();
+            revision.HasOne<Asset>()
+                .WithMany()
+                .HasForeignKey(x => x.AssetId)
+                .OnDelete(DeleteBehavior.Cascade);
         });
 
         return modelBuilder;

backend/src/Socialize.Api/Modules/Assets/Data/AssetRevision.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Modules.Assets.Data;
 
-public class AssetRevision
+internal class AssetRevision
 {
     public Guid Id { get; init; }
     public Guid AssetId { get; set; }

backend/src/Socialize.Api/Modules/Assets/Handlers/CreateAssetRevision.cs

@@ -10,12 +10,12 @@ using System.Text.Json;
 
 namespace Socialize.Api.Modules.Assets.Handlers;
 
-public record CreateAssetRevisionRequest(
+internal record CreateAssetRevisionRequest(
     string SourceReference,
     string? PreviewUrl,
     string? Notes);
 
-public class CreateAssetRevisionRequestValidator
+internal class CreateAssetRevisionRequestValidator
     : Validator<CreateAssetRevisionRequest>
 {
     public CreateAssetRevisionRequestValidator()
@@ -26,7 +26,7 @@ public class CreateAssetRevisionRequestValidator
     }
 }
 
-public class CreateAssetRevisionHandler(
+internal class CreateAssetRevisionHandler(
     AppDbContext dbContext,
     AccessScopeService accessScopeService,
     IContentItemActivityWriter activityWriter,

backend/src/Socialize.Api/Modules/Assets/Handlers/CreateGoogleDriveAsset.cs

@@ -10,7 +10,7 @@ using System.Text.Json;
 
 namespace Socialize.Api.Modules.Assets.Handlers;
 
-public record CreateGoogleDriveAssetRequest(
+internal record CreateGoogleDriveAssetRequest(
     Guid WorkspaceId,
     Guid ContentItemId,
     string AssetType,
@@ -19,7 +19,7 @@ public record CreateGoogleDriveAssetRequest(
     string GoogleDriveLink,
     string? PreviewUrl);
 
-public class CreateGoogleDriveAssetRequestValidator
+internal class CreateGoogleDriveAssetRequestValidator
     : Validator<CreateGoogleDriveAssetRequest>
 {
     public CreateGoogleDriveAssetRequestValidator()
@@ -34,7 +34,7 @@ public class CreateGoogleDriveAssetRequestValidator
     }
 }
 
-public class CreateGoogleDriveAssetHandler(
+internal class CreateGoogleDriveAssetHandler(
     AppDbContext dbContext,
     AccessScopeService accessScopeService,
     IContentItemActivityWriter activityWriter,

backend/src/Socialize.Api/Modules/Assets/Handlers/GetAssets.cs

@@ -5,9 +5,9 @@ using Socialize.Api.Infrastructure.Security;
 
 namespace Socialize.Api.Modules.Assets.Handlers;
 
-public record GetAssetsRequest(Guid ContentItemId);
+internal record GetAssetsRequest(Guid ContentItemId);
 
-public record AssetRevisionDto(
+internal record AssetRevisionDto(
     Guid Id,
     Guid AssetId,
     int RevisionNumber,
@@ -17,7 +17,7 @@ public record AssetRevisionDto(
     Guid? CreatedByUserId,
     DateTimeOffset CreatedAt);
 
-public record AssetDto(
+internal record AssetDto(
     Guid Id,
     Guid WorkspaceId,
     Guid ContentItemId,
@@ -31,7 +31,7 @@ public record AssetDto(
     DateTimeOffset CreatedAt,
     IReadOnlyCollection<AssetRevisionDto> Revisions);
 
-public class GetAssetsHandler(
+internal class GetAssetsHandler(
     AppDbContext dbContext,
     AccessScopeService accessScopeService)
     : Endpoint<GetAssetsRequest, IReadOnlyCollection<AssetDto>>

backend/src/Socialize.Api/Modules/Assets/ModuleRegistration.cs

@@ -2,7 +2,7 @@ using Socialize.Api.Modules.Assets.Data;
 
 namespace Socialize.Api.Modules.Assets;
 
-public static class DependencyInjection
+internal static class ModuleRegistration
 {
     public static WebApplicationBuilder AddAssetsModule(
         this WebApplicationBuilder builder)

backend/src/Socialize.Api/Modules/CalendarIntegrations/Data/CalendarCatalogEntry.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Modules.CalendarIntegrations.Data;
 
-public class CalendarCatalogEntry
+internal class CalendarCatalogEntry
 {
     public Guid Id { get; init; }
     public required string Title { get; set; }

backend/src/Socialize.Api/Modules/CalendarIntegrations/Data/CalendarCatalogSeed.cs

@@ -1,6 +1,8 @@
 namespace Socialize.Api.Modules.CalendarIntegrations.Data;
 
-public static class CalendarCatalogSeed
+#pragma warning disable S1075 // Catalog seed entries intentionally store source URLs.
+
+internal static class CalendarCatalogSeed
 {
     public static readonly CalendarCatalogEntry[] Entries =
     [

backend/src/Socialize.Api/Modules/CalendarIntegrations/Data/CalendarEvent.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Modules.CalendarIntegrations.Data;
 
-public class CalendarEvent
+internal class CalendarEvent
 {
     public Guid Id { get; init; }
     public Guid CalendarSourceId { get; set; }

backend/src/Socialize.Api/Modules/CalendarIntegrations/Data/CalendarSource.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Modules.CalendarIntegrations.Data;
 
-public class CalendarSource
+internal class CalendarSource
 {
     public Guid Id { get; init; }
     public required string Scope { get; set; }

backend/src/Socialize.Api/Modules/CalendarIntegrations/Data/CalendarSourceModelConfiguration.cs

@@ -2,7 +2,7 @@ using Microsoft.EntityFrameworkCore;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Data;
 
-public static class CalendarSourceModelConfiguration
+internal static class CalendarSourceModelConfiguration
 {
     public static ModelBuilder ConfigureCalendarIntegrationsModule(this ModelBuilder modelBuilder)
     {

backend/src/Socialize.Api/Modules/CalendarIntegrations/Data/UserCalendarExportFeed.cs

@@ -1,6 +1,6 @@
 namespace Socialize.Api.Modules.CalendarIntegrations.Data;
 
-public class UserCalendarExportFeed
+internal class UserCalendarExportFeed
 {
     public Guid Id { get; init; }
     public Guid UserId { get; set; }

backend/src/Socialize.Api/Modules/CalendarIntegrations/Handlers/CalendarSourceDtos.cs

@@ -3,7 +3,7 @@ using Socialize.Api.Modules.CalendarIntegrations.Services;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Handlers;
 
-public record CalendarSourceDto(
+internal record CalendarSourceDto(
     Guid Id,
     string Scope,
     Guid? OrganizationId,
@@ -47,7 +47,7 @@ public record CalendarSourceDto(
     }
 }
 
-public record UpsertCalendarSourceRequest(
+internal record UpsertCalendarSourceRequest(
     string Scope,
     Guid? OrganizationId,
     Guid? WorkspaceId,
@@ -59,7 +59,7 @@ public record UpsertCalendarSourceRequest(
     bool IsEnabled,
     string? InheritanceMode);
 
-public class UpsertCalendarSourceRequestValidator
+internal class UpsertCalendarSourceRequestValidator
     : FastEndpoints.Validator<UpsertCalendarSourceRequest>
 {
     public UpsertCalendarSourceRequestValidator()

backend/src/Socialize.Api/Modules/CalendarIntegrations/Handlers/CreateCalendarSource.cs

@@ -8,7 +8,7 @@ using Socialize.Api.Modules.Organizations.Services;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Handlers;
 
-public class CreateCalendarSourceHandler(
+internal class CreateCalendarSourceHandler(
     AppDbContext dbContext,
     AccessScopeService accessScopeService,
     OrganizationAccessService organizationAccessService)
@@ -121,7 +121,7 @@ public class CreateCalendarSourceHandler(
              source.CatalogSourceReference == normalizedCatalogReference) ||
             (!string.IsNullOrWhiteSpace(normalizedUrl) &&
              source.SourceUrl != null &&
-             source.SourceUrl.ToUpper() == normalizedUrl.ToUpper()),
+             EF.Functions.ILike(source.SourceUrl, normalizedUrl)),
             ct);
     }
 

backend/src/Socialize.Api/Modules/CalendarIntegrations/Handlers/DeleteCalendarSource.cs

@@ -8,7 +8,7 @@ using Socialize.Api.Modules.Organizations.Services;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Handlers;
 
-public class DeleteCalendarSourceHandler(
+internal class DeleteCalendarSourceHandler(
     AppDbContext dbContext,
     AccessScopeService accessScopeService,
     OrganizationAccessService organizationAccessService)

backend/src/Socialize.Api/Modules/CalendarIntegrations/Handlers/ListCalendarCatalog.cs

@@ -5,7 +5,7 @@ using Socialize.Api.Modules.CalendarIntegrations.Data;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Handlers;
 
-public sealed class ListCalendarCatalogRequest
+internal sealed class ListCalendarCatalogRequest
 {
     public string? Search { get; set; }
     public string? Country { get; set; }
@@ -16,7 +16,7 @@ public sealed class ListCalendarCatalogRequest
     public string? Provider { get; set; }
 }
 
-public record CalendarCatalogEntryDto(
+internal record CalendarCatalogEntryDto(
     Guid Id,
     string Title,
     string Description,
@@ -30,7 +30,7 @@ public record CalendarCatalogEntryDto(
     string TrustLevel,
     string DefaultColor);
 
-public class ListCalendarCatalogHandler(AppDbContext dbContext)
+internal class ListCalendarCatalogHandler(AppDbContext dbContext)
     : Endpoint<ListCalendarCatalogRequest, IReadOnlyCollection<CalendarCatalogEntryDto>>
 {
     public override void Configure()
@@ -47,11 +47,11 @@ public class ListCalendarCatalogHandler(AppDbContext dbContext)
 
         if (!string.IsNullOrWhiteSpace(request.Search))
         {
-            string search = request.Search.Trim().ToLowerInvariant();
+            string search = $"%{request.Search.Trim()}%";
             query = query.Where(entry =>
-                entry.Title.ToLower().Contains(search) ||
-                entry.Description.ToLower().Contains(search) ||
-                entry.ProviderName.ToLower().Contains(search));
+                EF.Functions.ILike(entry.Title, search) ||
+                EF.Functions.ILike(entry.Description, search) ||
+                EF.Functions.ILike(entry.ProviderName, search));
         }
 
         if (!string.IsNullOrWhiteSpace(request.Country))

backend/src/Socialize.Api/Modules/CalendarIntegrations/Handlers/ListCalendarEvents.cs

@@ -7,14 +7,14 @@ using Socialize.Api.Modules.CalendarIntegrations.Services;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Handlers;
 
-public sealed class ListCalendarEventsRequest
+internal sealed class ListCalendarEventsRequest
 {
     public Guid? WorkspaceId { get; set; }
     public DateOnly? StartDate { get; set; }
     public DateOnly? EndDate { get; set; }
 }
 
-public record CalendarEventDto(
+internal record CalendarEventDto(
     Guid Id,
     Guid CalendarSourceId,
     string SourceEventUid,
@@ -35,7 +35,7 @@ public record CalendarEventDto(
     DateTimeOffset? SourceLastModifiedAt,
     DateTimeOffset ImportedAt);
 
-public class ListCalendarEventsHandler(
+internal class ListCalendarEventsHandler(
     AppDbContext dbContext,
     AccessScopeService accessScopeService)
     : Endpoint<ListCalendarEventsRequest, IReadOnlyCollection<CalendarEventDto>>

backend/src/Socialize.Api/Modules/CalendarIntegrations/Handlers/ListCalendarSources.cs

@@ -7,9 +7,9 @@ using Socialize.Api.Modules.CalendarIntegrations.Services;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Handlers;
 
-public record ListCalendarSourcesRequest(Guid? WorkspaceId);
+internal record ListCalendarSourcesRequest(Guid? WorkspaceId);
 
-public class ListCalendarSourcesHandler(
+internal class ListCalendarSourcesHandler(
     AppDbContext dbContext,
     AccessScopeService accessScopeService)
     : Endpoint<ListCalendarSourcesRequest, IReadOnlyCollection<CalendarSourceDto>>

backend/src/Socialize.Api/Modules/CalendarIntegrations/Handlers/RefreshCalendarSource.cs

@@ -8,7 +8,7 @@ using Socialize.Api.Modules.Organizations.Services;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Handlers;
 
-public class RefreshCalendarSourceHandler(
+internal class RefreshCalendarSourceHandler(
     AppDbContext dbContext,
     AccessScopeService accessScopeService,
     OrganizationAccessService organizationAccessService,

backend/src/Socialize.Api/Modules/CalendarIntegrations/Handlers/UpdateCalendarSource.cs

@@ -8,7 +8,7 @@ using Socialize.Api.Modules.Organizations.Services;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Handlers;
 
-public class UpdateCalendarSourceHandler(
+internal class UpdateCalendarSourceHandler(
     AppDbContext dbContext,
     AccessScopeService accessScopeService,
     OrganizationAccessService organizationAccessService)

backend/src/Socialize.Api/Modules/CalendarIntegrations/Handlers/UserCalendarExportFeed.cs

@@ -8,14 +8,14 @@ using Socialize.Api.Modules.Identity.Data;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Handlers;
 
-public record UserCalendarExportFeedDto(
+internal record UserCalendarExportFeedDto(
     bool IsEnabled,
     string? FeedUrl,
     DateTimeOffset? CreatedAt,
     DateTimeOffset? UpdatedAt,
     DateTimeOffset? RevokedAt);
 
-public class GetUserCalendarExportFeedHandler(AppDbContext dbContext)
+internal class GetUserCalendarExportFeedHandler(AppDbContext dbContext)
     : EndpointWithoutRequest<UserCalendarExportFeedDto>
 {
     public override void Configure()
@@ -33,7 +33,7 @@ public class GetUserCalendarExportFeedHandler(AppDbContext dbContext)
     }
 }
 
-public class EnableUserCalendarExportFeedHandler(AppDbContext dbContext)
+internal class EnableUserCalendarExportFeedHandler(AppDbContext dbContext)
     : EndpointWithoutRequest<UserCalendarExportFeedDto>
 {
     public override void Configure()
@@ -81,7 +81,7 @@ public class EnableUserCalendarExportFeedHandler(AppDbContext dbContext)
     }
 }
 
-public class RegenerateUserCalendarExportFeedHandler(AppDbContext dbContext)
+internal class RegenerateUserCalendarExportFeedHandler(AppDbContext dbContext)
     : EndpointWithoutRequest<UserCalendarExportFeedDto>
 {
     public override void Configure()
@@ -120,7 +120,7 @@ public class RegenerateUserCalendarExportFeedHandler(AppDbContext dbContext)
     }
 }
 
-public class RevokeUserCalendarExportFeedHandler(AppDbContext dbContext)
+internal class RevokeUserCalendarExportFeedHandler(AppDbContext dbContext)
     : EndpointWithoutRequest<UserCalendarExportFeedDto>
 {
     public override void Configure()
@@ -147,7 +147,7 @@ public class RevokeUserCalendarExportFeedHandler(AppDbContext dbContext)
     }
 }
 
-public class GetUserCalendarExportFeedIcsHandler(
+internal class GetUserCalendarExportFeedIcsHandler(
     AppDbContext dbContext,
     CalendarExportFeedService feedService)
     : EndpointWithoutRequest

backend/src/Socialize.Api/Modules/CalendarIntegrations/ModuleRegistration.cs

@@ -1,11 +1,9 @@
 namespace Socialize.Api.Modules.CalendarIntegrations;
 
-public static class DependencyInjection
+internal static class ModuleRegistration
 {
     public static WebApplicationBuilder AddCalendarIntegrationsModule(this WebApplicationBuilder builder)
     {
-        builder.Services.AddSingleton<Services.IcsCalendarParser>();
-        builder.Services.AddSingleton<Services.CalendarExportFeedBuilder>();
         builder.Services.AddScoped<Services.CalendarExportFeedService>();
         builder.Services.AddScoped<Services.CalendarImportSyncService>();
         builder.Services.AddHostedService<Services.CalendarImportBackgroundService>();

backend/src/Socialize.Api/Modules/CalendarIntegrations/Services/CalendarExportFeedBuilder.cs

@@ -1,8 +1,9 @@
 using System.Text;
+using System.Globalization;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Services;
 
-public sealed record CalendarExportFeedEvent(
+internal sealed record CalendarExportFeedEvent(
     string Uid,
     string Title,
     DateTimeOffset StartsAt,
@@ -11,9 +12,9 @@ public sealed record CalendarExportFeedEvent(
     string? Description,
     string? Url);
 
-public class CalendarExportFeedBuilder
+internal static class CalendarExportFeedBuilder
 {
-    public string Build(string calendarName, IReadOnlyCollection<CalendarExportFeedEvent> events)
+    public static string Build(string calendarName, IReadOnlyCollection<CalendarExportFeedEvent> events)
     {
         StringBuilder builder = new();
         builder.AppendLine("BEGIN:VCALENDAR");
@@ -21,34 +22,34 @@ public class CalendarExportFeedBuilder
         builder.AppendLine("PRODID:-//Socialize//User Work Calendar//EN");
         builder.AppendLine("CALSCALE:GREGORIAN");
         builder.AppendLine("METHOD:PUBLISH");
-        builder.AppendLine($"X-WR-CALNAME:{EscapeText(calendarName)}");
+        AppendLineInvariant(builder, $"X-WR-CALNAME:{EscapeText(calendarName)}");
 
         foreach (CalendarExportFeedEvent feedEvent in events.OrderBy(calendarEvent => calendarEvent.StartsAt))
         {
             builder.AppendLine("BEGIN:VEVENT");
-            builder.AppendLine($"UID:{EscapeText(feedEvent.Uid)}");
-            builder.AppendLine($"DTSTAMP:{FormatUtc(DateTimeOffset.UtcNow)}");
-            builder.AppendLine($"SUMMARY:{EscapeText(feedEvent.Title)}");
+            AppendLineInvariant(builder, $"UID:{EscapeText(feedEvent.Uid)}");
+            AppendLineInvariant(builder, $"DTSTAMP:{FormatUtc(DateTimeOffset.UtcNow)}");
+            AppendLineInvariant(builder, $"SUMMARY:{EscapeText(feedEvent.Title)}");
 
             if (feedEvent.IsAllDay)
             {
-                builder.AppendLine($"DTSTART;VALUE=DATE:{FormatDate(feedEvent.StartsAt)}");
-                builder.AppendLine($"DTEND;VALUE=DATE:{FormatDate(feedEvent.EndsAt)}");
+                AppendLineInvariant(builder, $"DTSTART;VALUE=DATE:{FormatDate(feedEvent.StartsAt)}");
+                AppendLineInvariant(builder, $"DTEND;VALUE=DATE:{FormatDate(feedEvent.EndsAt)}");
             }
             else
             {
-                builder.AppendLine($"DTSTART:{FormatUtc(feedEvent.StartsAt)}");
-                builder.AppendLine($"DTEND:{FormatUtc(feedEvent.EndsAt)}");
+                AppendLineInvariant(builder, $"DTSTART:{FormatUtc(feedEvent.StartsAt)}");
+                AppendLineInvariant(builder, $"DTEND:{FormatUtc(feedEvent.EndsAt)}");
             }
 
             if (!string.IsNullOrWhiteSpace(feedEvent.Description))
             {
-                builder.AppendLine($"DESCRIPTION:{EscapeText(feedEvent.Description)}");
+                AppendLineInvariant(builder, $"DESCRIPTION:{EscapeText(feedEvent.Description)}");
             }
 
             if (!string.IsNullOrWhiteSpace(feedEvent.Url))
             {
-                builder.AppendLine($"URL:{EscapeText(feedEvent.Url)}");
+                AppendLineInvariant(builder, $"URL:{EscapeText(feedEvent.Url)}");
             }
 
             builder.AppendLine("END:VEVENT");
@@ -71,10 +72,15 @@ public class CalendarExportFeedBuilder
     private static string EscapeText(string value)
     {
         return value
-            .Replace("\\", "\\\\")
-            .Replace("\r\n", "\\n")
-            .Replace("\n", "\\n")
-            .Replace(";", "\\;")
-            .Replace(",", "\\,");
+            .Replace("\\", "\\\\", StringComparison.Ordinal)
+            .Replace("\r\n", "\\n", StringComparison.Ordinal)
+            .Replace("\n", "\\n", StringComparison.Ordinal)
+            .Replace(";", "\\;", StringComparison.Ordinal)
+            .Replace(",", "\\,", StringComparison.Ordinal);
+    }
+
+    private static void AppendLineInvariant(StringBuilder builder, FormattableString value)
+    {
+        builder.AppendLine(value.ToString(CultureInfo.InvariantCulture));
     }
 }

backend/src/Socialize.Api/Modules/CalendarIntegrations/Services/CalendarExportFeedService.cs

@@ -3,11 +3,11 @@ using Socialize.Api.Data;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Services;
 
-public class CalendarExportFeedService(AppDbContext dbContext, CalendarExportFeedBuilder feedBuilder)
+internal class CalendarExportFeedService(AppDbContext dbContext)
 {
     public async Task<string> BuildUserFeedAsync(Guid userId, string? userEmail, string appBaseUrl, CancellationToken ct)
     {
-        string normalizedEmail = userEmail?.Trim().ToUpperInvariant() ?? string.Empty;
+        string normalizedEmail = userEmail?.Trim() ?? string.Empty;
         Guid[] workspaceIds = await dbContext.Workspaces
             .Where(workspace =>
                 workspace.OwnerUserId == userId ||
@@ -51,7 +51,7 @@ public class CalendarExportFeedService(AppDbContext dbContext, CalendarExportFee
             .Where(approval =>
                 approval.DueAt.HasValue &&
                 (approval.RequestedByUserId == userId ||
-                 (!string.IsNullOrEmpty(normalizedEmail) && approval.ReviewerEmail.ToUpper() == normalizedEmail)))
+                 (!string.IsNullOrEmpty(normalizedEmail) && EF.Functions.ILike(approval.ReviewerEmail, normalizedEmail))))
             .Join(
                 dbContext.ContentItems,
                 approval => approval.ContentItemId,
@@ -91,7 +91,7 @@ public class CalendarExportFeedService(AppDbContext dbContext, CalendarExportFee
                 appBaseUrl))
             .ToListAsync(ct));
 
-        return feedBuilder.Build("Socialize my work", events);
+        return CalendarExportFeedBuilder.Build("Socialize my work", events);
     }
 
     private static CalendarExportFeedEvent ToContentFeedEvent(

backend/src/Socialize.Api/Modules/CalendarIntegrations/Services/CalendarExportFeedTokenService.cs

@@ -2,7 +2,7 @@ using System.Security.Cryptography;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Services;
 
-public static class CalendarExportFeedTokenService
+internal static class CalendarExportFeedTokenService
 {
     public static string GenerateToken()
     {

backend/src/Socialize.Api/Modules/CalendarIntegrations/Services/CalendarImportBackgroundService.cs

@@ -1,7 +1,10 @@
+using Socialize.Api.Infrastructure.Observability;
+
 namespace Socialize.Api.Modules.CalendarIntegrations.Services;
 
-public sealed class CalendarImportBackgroundService(
+internal sealed class CalendarImportBackgroundService(
     IServiceScopeFactory scopeFactory,
+    SocializeMetrics metrics,
     ILogger<CalendarImportBackgroundService> logger)
     : BackgroundService
 {
@@ -22,13 +25,18 @@ public sealed class CalendarImportBackgroundService(
             using IServiceScope scope = scopeFactory.CreateScope();
             CalendarImportSyncService syncService = scope.ServiceProvider.GetRequiredService<CalendarImportSyncService>();
             await syncService.RefreshDueSourcesAsync(stoppingToken);
+            metrics.RecordBackgroundJobRun(nameof(CalendarImportBackgroundService), true);
         }
-        catch (OperationCanceledException) when (stoppingToken.IsCancellationRequested)
+        catch (OperationCanceledException ex) when (stoppingToken.IsCancellationRequested)
         {
+            logger.LogDebug(ex, "Calendar import background sync stopped.");
         }
+#pragma warning disable CA1031 // Background service should log and continue after unexpected sync failures.
         catch (Exception ex)
         {
+            metrics.RecordBackgroundJobRun(nameof(CalendarImportBackgroundService), false);
             logger.LogError(ex, "Calendar import background sync failed.");
         }
+#pragma warning restore CA1031
     }
 }

backend/src/Socialize.Api/Modules/CalendarIntegrations/Services/CalendarImportSyncService.cs

@@ -1,15 +1,19 @@
 using Microsoft.EntityFrameworkCore;
 using Socialize.Api.Data;
 using Socialize.Api.Modules.CalendarIntegrations.Data;
+using System.Globalization;
 using System.Text.Json;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Services;
 
-public sealed class CalendarImportSyncService(
+#pragma warning disable S1075 // Supplemental observance identifiers intentionally use stable URI-like values.
+
+internal sealed class CalendarImportSyncService(
     AppDbContext dbContext,
-    IHttpClientFactory httpClientFactory,
-    IcsCalendarParser parser)
+    IHttpClientFactory httpClientFactory)
 {
+    private static readonly JsonSerializerOptions JsonSerializerOptions = new(JsonSerializerDefaults.Web);
+
     public async Task RefreshSourceAsync(Guid sourceId, CancellationToken ct)
     {
         CalendarSource? source = await dbContext.CalendarSources
@@ -115,7 +119,7 @@ public sealed class CalendarImportSyncService(
         }
     }
 
-    private async Task<IReadOnlyCollection<ParsedCalendarEvent>> GetParsedEventsAsync(
+    private static async Task<IReadOnlyCollection<ParsedCalendarEvent>> GetParsedEventsAsync(
         HttpClient httpClient,
         string sourceUrl,
         DateOnly rangeStart,
@@ -127,8 +131,8 @@ public sealed class CalendarImportSyncService(
             return await GetNagerEventsAsync(httpClient, sourceUrl, countryCode!, rangeStart, rangeEnd, ct);
         }
 
-        string content = await httpClient.GetStringAsync(sourceUrl, ct);
-        return parser.Parse(content, rangeStart, rangeEnd);
+        string content = await httpClient.GetStringAsync(new Uri(sourceUrl), ct);
+        return IcsCalendarParser.Parse(content, rangeStart, rangeEnd);
     }
 
     private static async Task<IReadOnlyCollection<ParsedCalendarEvent>> GetNagerEventsAsync(
@@ -143,14 +147,12 @@ public sealed class CalendarImportSyncService(
         for (int year = rangeStart.Year; year <= rangeEnd.Year; year++)
         {
             string yearUrl = BuildNagerYearUrl(sourceUrl, countryCode, year);
-            string json = await httpClient.GetStringAsync(yearUrl, ct);
-            NagerHoliday[] holidays = JsonSerializer.Deserialize<NagerHoliday[]>(
-                json,
-                new JsonSerializerOptions(JsonSerializerDefaults.Web)) ?? [];
+            string json = await httpClient.GetStringAsync(new Uri(yearUrl), ct);
+            NagerHoliday[] holidays = JsonSerializer.Deserialize<NagerHoliday[]>(json, JsonSerializerOptions) ?? [];
 
             foreach (NagerHoliday holiday in holidays)
             {
-                if (!DateOnly.TryParse(holiday.Date, out DateOnly date) ||
+                if (!DateOnly.TryParse(holiday.Date, CultureInfo.InvariantCulture, out DateOnly date) ||
                     date < rangeStart ||
                     date > rangeEnd)
                 {
@@ -283,7 +285,7 @@ public sealed class CalendarImportSyncService(
     private static string NormalizeUidPart(string? value)
     {
         return new string((value ?? "holiday")
-            .ToLowerInvariant()
+            .ToUpperInvariant()
             .Select(character => char.IsLetterOrDigit(character) ? character : '-')
             .ToArray())
             .Trim('-');

backend/src/Socialize.Api/Modules/CalendarIntegrations/Services/CalendarSourceConstants.cs

@@ -1,13 +1,13 @@
 namespace Socialize.Api.Modules.CalendarIntegrations.Services;
 
-public static class CalendarSourceScopes
+internal static class CalendarSourceScopes
 {
     public const string Organization = "Organization";
     public const string Workspace = "Workspace";
     public const string User = "User";
 }
 
-public static class CalendarSourceInheritanceModes
+internal static class CalendarSourceInheritanceModes
 {
     public const string Required = "Required";
     public const string Optional = "Optional";

backend/src/Socialize.Api/Modules/CalendarIntegrations/Services/CalendarSourceRules.cs

@@ -2,7 +2,7 @@ using Socialize.Api.Modules.CalendarIntegrations.Data;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Services;
 
-public static class CalendarSourceRules
+internal static class CalendarSourceRules
 {
     public static readonly string[] SupportedScopes =
     [

backend/src/Socialize.Api/Modules/CalendarIntegrations/Services/IcsCalendarParser.cs

@@ -1,8 +1,9 @@
 using System.Globalization;
+using System.Text;
 
 namespace Socialize.Api.Modules.CalendarIntegrations.Services;
 
-public record ParsedCalendarEvent(
+internal record ParsedCalendarEvent(
     string SourceEventUid,
     string Title,
     string? Description,
@@ -39,9 +40,9 @@ internal sealed record IcsRawEvent(
     string? SourceUrl,
     DateTimeOffset? LastModifiedAt);
 
-public sealed class IcsCalendarParser
+internal static class IcsCalendarParser
 {
-    public IReadOnlyCollection<ParsedCalendarEvent> Parse(
+    public static IReadOnlyCollection<ParsedCalendarEvent> Parse(
         string content,
         DateOnly rangeStart,
         DateOnly rangeEnd)
@@ -63,10 +64,12 @@ public sealed class IcsCalendarParser
     private static IEnumerable<IcsRawEvent> ReadRawEvents(string content)
     {
         List<string> lines = UnfoldLines(content).ToList();
-        for (int index = 0; index < lines.Count; index++)
+        int index = 0;
+        while (index < lines.Count)
         {
             if (!lines[index].Equals("BEGIN:VEVENT", StringComparison.OrdinalIgnoreCase))
             {
+                index++;
                 continue;
             }
 
@@ -74,9 +77,10 @@ public sealed class IcsCalendarParser
                 new(StringComparer.OrdinalIgnoreCase);
 
             index++;
-            for (; index < lines.Count && !lines[index].Equals("END:VEVENT", StringComparison.OrdinalIgnoreCase); index++)
+            while (index < lines.Count && !lines[index].Equals("END:VEVENT", StringComparison.OrdinalIgnoreCase))
             {
                 ParseProperty(lines[index], properties);
+                index++;
             }
 
             if (!TryGetFirst(properties, "DTSTART", out var startProperty))
@@ -105,32 +109,34 @@ public sealed class IcsCalendarParser
                 TryGetFirst(properties, "LAST-MODIFIED", out var lastModified)
                     ? ParseDateTimeValue(lastModified.Value, lastModified.Parameters).UtcDateTime
                     : null);
+
+            index++;
         }
     }
 
     private static IEnumerable<string> UnfoldLines(string content)
     {
-        string? current = null;
+        StringBuilder? current = null;
         using StringReader reader = new(content.Replace("\r\n", "\n", StringComparison.Ordinal).Replace('\r', '\n'));
         while (reader.ReadLine() is { } line)
         {
             if ((line.StartsWith(' ') || line.StartsWith('\t')) && current is not null)
             {
-                current += line[1..];
+                current.Append(line[1..]);
                 continue;
             }
 
             if (current is not null)
             {
-                yield return current;
+                yield return current.ToString();
             }
 
-            current = line;
+            current = new StringBuilder(line);
         }
 
         if (current is not null)
         {
-            yield return current;
+            yield return current.ToString();
         }
     }
 
@@ -309,7 +315,7 @@ public sealed class IcsCalendarParser
         return TimeSpan.Zero;
     }
 
-    private static IReadOnlyCollection<DateOnly> ExpandStartDates(
+    private static List<DateOnly> ExpandStartDates(
         IcsRawEvent rawEvent,
         DateOnly rangeStart,
         DateOnly rangeEnd)