feat: implement strangler-fig-demo Session 1 (backend + smoke script)

Builds the four-seam, three-write-path reference demo backend: case-framework (seam D stand-in), legacy-backend/frontend (SQL Server, seams A/B/C targets), and new-backend (Domain/Application/Infrastructure.*/Api implementing the source resolver, take/release-ownership, write-through translator, and owned assessment flow), wired together via docker-compose with a plain placeholder frontend standing in for the Angular portal until Session 2. All 11 Architecture.Tests pass and scripts/smoke.sh passes end-to-end against a fresh `docker compose up`, covering acceptance criteria 1-3 and 7-22. Fixes two real domain bugs found only once the stack ran for real: the BSN eleven-proof checksum trivially passes all-zero digits, and the adoption mapper silently treated a partial legacy address as absent instead of failing loudly. Also fixes several environment-specific integration issues (rootless Podman/SELinux bind-mount permissions, a buildah NuGet layer-caching bug, SqlClient's invariant-globalization incompatibility, and an nginx path-prefix mismatch for the legacy frontend). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-31 07:57:26 +02:00
parent 09b27173a7
commit a6a1abbe9c
129 changed files with 6379 additions and 1 deletions
@@ -0,0 +1,42 @@
+using System.Text.RegularExpressions;
+
+namespace New.Domain.ValueObjects;
+
+/// <summary>How the applicant prefers to be contacted.</summary>
+public enum CorrespondenceChannel
+{
+    Post,
+    Email,
+}
+
+/// <summary>
+/// Email/phone plus the applicant's preferred channel. The one real invariant:
+/// choosing <see cref="CorrespondenceChannel.Email"/> requires a non-empty,
+/// well-formed email address - you can't ask to be emailed with no email on file.
+/// </summary>
+public sealed record ContactDetails
+{
+    private static readonly Regex SimpleEmailPattern =
+        new(@"^[^@\s]+@[^@\s]+\.[^@\s]+$", RegexOptions.Compiled);
+
+    public string? Email { get; }
+    public string? Phone { get; }
+    public CorrespondenceChannel PreferredChannel { get; }
+
+    public ContactDetails(string? email, string? phone, CorrespondenceChannel preferredChannel)
+    {
+        if (preferredChannel == CorrespondenceChannel.Email && !IsWellFormedEmail(email))
+        {
+            throw new DomainInvariantViolationException(
+                "ContactDetails.EmailRequiredForEmailChannel",
+                "Preferring email as the correspondence channel requires a non-empty, well-formed email address.");
+        }
+
+        Email = email;
+        Phone = phone;
+        PreferredChannel = preferredChannel;
+    }
+
+    private static bool IsWellFormedEmail(string? email) =>
+        !string.IsNullOrWhiteSpace(email) && SimpleEmailPattern.IsMatch(email);
+}