refactor: restructure solution into -models/-data/-api project taxonomy

Phases 1-10 of the planned refactoring:

Phase 1: rename shared-models -> common
  - namespace Shared.Models -> Common throughout
  - remove stale AspNetCore.Http.Features 5.0 reference

Phase 2: create shared-data with abstract BaseEntity
  - BaseEntity: required string Id { get; init; } + DateTime CreatedAt { get; init; }

Phase 3: rename myai-models -> myai-data
  - namespace MyAi.Models -> MyAi.Data
  - MigrationsAssembly("myai-data")

Phase 4: rename cv-search-models -> cv-search-data
  - namespace CvSearch.Models -> CvSearch.Data
  - move JobSearchSettings to cv-matcher-api-models
  - JobSearch*Entity now inherits BaseEntity

Phase 5: extract rag-data from rag-api
  - new project: Apis/rag-data with RagDbContext + entities + migrations
  - RagDocumentEntity inherits BaseEntity; cache entities use CacheKey PK
  - fix duplicate AddHttpClient<RagAiClient>/AddScoped registrations in rag-api
  - MigrationsAssembly("rag-data")

Phase 6: extract cv-matcher-data from cv-matcher-api
  - new project: Apis/cv-matcher-data with CvMatcherDbContext + entities + migrations
  - CvMatchResultEntity inherits BaseEntity; CvMatcherChatCacheEntity uses CacheKey PK
  - MigrationsAssembly("cv-matcher-data")

Phase 7: create empty cv-cleanup-job-models and cv-search-job-models

Phase 8: update all 5 Dockerfiles for renamed/new projects

Phase 9: reorganise .sln virtual folders (Apis/Jobs/Models/Data/Helpers)
  - update root CLAUDE.md with new project taxonomy and migration commands
  - update cv-matcher-api/CLAUDE.md and cv-search-job/CLAUDE.md

Phase 10: add Directory.Packages.props for centralised NuGet versions
  - remove Version= from all PackageReference elements in active .csproj files

No database changes. No runtime behaviour changes.
All MigrationId strings in __EFMigrationsHistory are unaffected.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Apis/myai-data/Data/Entities/TemplateEntity.cs

@@ -0,0 +1,11 @@
+namespace MyAi.Data.Entities;
+
+// composite PK (Key + Language) — BaseEntity not applicable
+public sealed class TemplateEntity
+{
+    public string Key { get; set; } = string.Empty;
+    public string Language { get; set; } = string.Empty;
+    public string Value { get; set; } = string.Empty;
+    public string Description { get; set; } = string.Empty;
+    public DateTime UpdatedAt { get; set; }
+}

Apis/myai-data/Data/MyAiDbContext.cs

@@ -0,0 +1,30 @@
+using MyAi.Data.Entities;
+using Microsoft.EntityFrameworkCore;
+
+namespace MyAi.Data;
+
+public sealed class MyAiDbContext : DbContext
+{
+    public const string SchemaName = "myAi";
+    public const string MigrationTableName = "_MyAiMigrations";
+
+    public MyAiDbContext(DbContextOptions<MyAiDbContext> options) : base(options) { }
+
+    public DbSet<TemplateEntity> Templates => Set<TemplateEntity>();
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.HasDefaultSchema(SchemaName);
+
+        modelBuilder.Entity<TemplateEntity>(entity =>
+        {
+            entity.ToTable("Templates");
+            entity.HasKey(x => new { x.Key, x.Language });
+            entity.Property(x => x.Key).HasMaxLength(128);
+            entity.Property(x => x.Language).HasMaxLength(8);
+            entity.Property(x => x.Value).IsRequired();
+            entity.Property(x => x.Description).HasMaxLength(500).HasDefaultValue(string.Empty);
+            entity.Property(x => x.UpdatedAt).HasDefaultValueSql("SYSUTCDATETIME()");
+        });
+    }
+}

Apis/myai-data/Migrations/20260524145351_AddTemplates.Designer.cs

@@ -0,0 +1,62 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using MyAi.Data;
+
+#nullable disable
+
+namespace MyAi.Data.Migrations
+{
+    [DbContext(typeof(MyAiDbContext))]
+    [Migration("20260524145351_AddTemplates")]
+    partial class AddTemplates
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasDefaultSchema("myAi")
+                .HasAnnotation("ProductVersion", "10.0.7")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128);
+
+            SqlServerModelBuilderExtensions.UseIdentityColumns(modelBuilder);
+
+            modelBuilder.Entity("MyAi.Data.Entities.TemplateEntity", b =>
+                {
+                    b.Property<string>("Key")
+                        .HasMaxLength(128)
+                        .HasColumnType("nvarchar(128)");
+
+                    b.Property<string>("Language")
+                        .HasMaxLength(8)
+                        .HasColumnType("nvarchar(8)");
+
+                    b.Property<string>("Description")
+                        .IsRequired()
+                        .ValueGeneratedOnAdd()
+                        .HasMaxLength(500)
+                        .HasColumnType("nvarchar(500)")
+                        .HasDefaultValue("");
+
+                    b.Property<DateTime>("UpdatedAt")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("datetime2")
+                        .HasDefaultValueSql("SYSUTCDATETIME()");
+
+                    b.Property<string>("Value")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Key", "Language");
+
+                    b.ToTable("Templates", "myAi");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

Apis/myai-data/Migrations/20260524145351_AddTemplates.cs

@@ -0,0 +1,113 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace MyAi.Data.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddTemplates : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.EnsureSchema(
+                name: "myAi");
+
+            migrationBuilder.CreateTable(
+                name: "Templates",
+                schema: "myAi",
+                columns: table => new
+                {
+                    Key = table.Column<string>(type: "nvarchar(128)", maxLength: 128, nullable: false),
+                    Language = table.Column<string>(type: "nvarchar(8)", maxLength: 8, nullable: false),
+                    Value = table.Column<string>(type: "nvarchar(max)", nullable: false),
+                    Description = table.Column<string>(type: "nvarchar(500)", maxLength: 500, nullable: false, defaultValue: ""),
+                    UpdatedAt = table.Column<DateTime>(type: "datetime2", nullable: false, defaultValueSql: "SYSUTCDATETIME()")
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Templates", x => new { x.Key, x.Language });
+                });
+
+            Seed(migrationBuilder);
+        }
+
+        private static void Seed(MigrationBuilder m)
+        {
+            void Row(string key, string lang, string value, string description = "")
+                => m.InsertData("Templates", ["Key", "Language", "Value", "Description"], [key, lang, value, description], "myAi");
+
+            // Match result email — subject
+            Row("email.match.subject", "en", "MyAi.ro CV Match: {{score}}% - {{jobLabel}}", "Subject for the CV match result email");
+            Row("email.match.subject", "ro", "MyAi.ro Potrivire CV: {{score}}% - {{jobLabel}}", "Subiect email rezultat potrivire CV");
+
+            // Match result email — body
+            Row("email.match.body", "en",
+                "CV Matcher result\n\nCV Document ID: {{cvDocumentId}}\nJob: {{jobLabel}}\nJob URL: {{jobUrl}}\nScore: {{score}}%\n\nSummary:\n{{summary}}\n\nStrengths:\n{{strengths}}\n\nGaps:\n{{gaps}}\n\nRecommendations:\n{{recommendations}}",
+                "Body for the CV match result email");
+            Row("email.match.body", "ro",
+                "Rezultat potrivire CV\n\nID document CV: {{cvDocumentId}}\nJob: {{jobLabel}}\nURL job: {{jobUrl}}\nScor: {{score}}%\n\nRezumat:\n{{summary}}\n\nPuncte forte:\n{{strengths}}\n\nLipsuri:\n{{gaps}}\n\nRecomandări:\n{{recommendations}}",
+                "Corpul emailului pentru rezultatul potrivirii CV");
+
+            // Match result email — job search CTA footer
+            Row("email.match.job-search-footer", "en",
+                "\n\n---\nWant to find more jobs matching your CV?\nClick: {{jobSearchLink}}\n(link valid for {{expiryDays}} days)",
+                "Job search CTA appended to match result email");
+            Row("email.match.job-search-footer", "ro",
+                "\n\n---\nVrei sa gasesti mai multe joburi potrivite CV-ului tau?\nClick: {{jobSearchLink}}\n(link valabil {{expiryDays}} zile)",
+                "CTA cautare joburi adaugat la emailul de potrivire CV");
+
+            // Job search results email — subject
+            Row("email.search-results.subject", "en", "MyAi.ro: {{count}} jobs matching your CV", "Subject for job search results email");
+            Row("email.search-results.subject", "ro", "MyAi.ro: {{count}} joburi potrivite CV-ului tau", "Subiect email rezultate cautare joburi");
+
+            // Job search results email — body preamble (items appended in code)
+            Row("email.search-results.body", "en", "MyAi.ro found {{count}} jobs matching your CV:\n\n{{items}}", "Body preamble for job search results email");
+            Row("email.search-results.body", "ro", "MyAi.ro a gasit {{count}} joburi potrivite CV-ului tau:\n\n{{items}}", "Corpul emailului de rezultate cautare joburi");
+
+            // Job search results email — no results found
+            Row("email.search-results.empty", "en", "MyAi.ro found no jobs matching your CV. Try again later or update your CV.", "No results message for job search results email");
+            Row("email.search-results.empty", "ro", "MyAi.ro nu a gasit joburi care sa corespunda CV-ului tau. Incercati mai tarziu sau ajustati CV-ul.", "Mesaj fara rezultate pentru emailul de cautare joburi");
+
+            // HTML job-search start page messages
+            Row("html.job-search.started.title",    "en", "Job search started",              "Title for job search started page");
+            Row("html.job-search.started.message",  "en", "Your job search has started. Results will be sent to your email shortly.", "Message for job search started page");
+            Row("html.job-search.started.title",    "ro", "Căutare joburi pornită",           "Titlu pagina cautare joburi pornita");
+            Row("html.job-search.started.message",  "ro", "Căutarea joburilor a început. Rezultatele vor fi trimise pe email în scurt timp.", "Mesaj pagina cautare joburi pornita");
+
+            Row("html.job-search.already-used.title",   "en", "Link already used",               "Title for already-used page");
+            Row("html.job-search.already-used.message", "en", "This job search link has already been used.", "Message for already-used page");
+            Row("html.job-search.already-used.title",   "ro", "Link deja folosit",               "Titlu pagina link deja folosit");
+            Row("html.job-search.already-used.message", "ro", "Acest link de cautare joburi a fost deja folosit.", "Mesaj pagina link deja folosit");
+
+            Row("html.job-search.expired.title",   "en", "Link expired",               "Title for expired link page");
+            Row("html.job-search.expired.message", "en", "This job search link has expired. Please request a new CV match to get a fresh link.", "Message for expired link page");
+            Row("html.job-search.expired.title",   "ro", "Link expirat",               "Titlu pagina link expirat");
+            Row("html.job-search.expired.message", "ro", "Acest link de cautare joburi a expirat. Solicita o noua potrivire CV pentru a primi un link nou.", "Mesaj pagina link expirat");
+
+            Row("html.job-search.invalid.title",   "en", "Invalid link",               "Title for invalid link page");
+            Row("html.job-search.invalid.message", "en", "This job search link is not valid.", "Message for invalid link page");
+            Row("html.job-search.invalid.title",   "ro", "Link invalid",               "Titlu pagina link invalid");
+            Row("html.job-search.invalid.message", "ro", "Acest link de cautare joburi nu este valid.", "Mesaj pagina link invalid");
+
+            Row("html.job-search.error.title",   "en", "Error",               "Title for error page");
+            Row("html.job-search.error.message", "en", "An error occurred. Please try again later.", "Message for error page");
+            Row("html.job-search.error.title",   "ro", "Eroare",               "Titlu pagina eroare");
+            Row("html.job-search.error.message", "ro", "A apărut o eroare. Te rugăm să încerci din nou mai târziu.", "Mesaj pagina eroare");
+
+            // AI system prompt for CV matching (language is a {{languageName}} variable inside it)
+            Row("ai.cv-match.system-prompt", "*",
+                "You are a strict CV-to-job matching engine. Return JSON only. Score realistically from 0 to 100.\nPenalize missing required skills. Do not invent experience. Use concise business language.\nRespond entirely in {{languageName}} — all text fields in the JSON must be in {{languageName}}.\nJSON shape: {\"score\":number,\"summary\":\"...\",\"strengths\":[\"...\"],\"gaps\":[\"...\"],\"recommendations\":[\"...\"],\"evidence\":[\"...\"]}",
+                "System prompt template for the CV-to-job LLM matching call. {{languageName}} is substituted at runtime.");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "Templates",
+                schema: "myAi");
+        }
+    }
+}

Apis/myai-data/Migrations/MyAiDbContextModelSnapshot.cs

@@ -0,0 +1,59 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using MyAi.Data;
+
+#nullable disable
+
+namespace MyAi.Data.Migrations
+{
+    [DbContext(typeof(MyAiDbContext))]
+    partial class MyAiDbContextModelSnapshot : ModelSnapshot
+    {
+        protected override void BuildModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasDefaultSchema("myAi")
+                .HasAnnotation("ProductVersion", "10.0.7")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128);
+
+            SqlServerModelBuilderExtensions.UseIdentityColumns(modelBuilder);
+
+            modelBuilder.Entity("MyAi.Data.Entities.TemplateEntity", b =>
+                {
+                    b.Property<string>("Key")
+                        .HasMaxLength(128)
+                        .HasColumnType("nvarchar(128)");
+
+                    b.Property<string>("Language")
+                        .HasMaxLength(8)
+                        .HasColumnType("nvarchar(8)");
+
+                    b.Property<string>("Description")
+                        .IsRequired()
+                        .ValueGeneratedOnAdd()
+                        .HasMaxLength(500)
+                        .HasColumnType("nvarchar(500)")
+                        .HasDefaultValue("");
+
+                    b.Property<DateTime>("UpdatedAt")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("datetime2")
+                        .HasDefaultValueSql("SYSUTCDATETIME()");
+
+                    b.Property<string>("Value")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Key", "Language");
+
+                    b.ToTable("Templates", "myAi");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}

Apis/myai-data/Services/DbTemplateService.cs

@@ -0,0 +1,70 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Logging;
+using MyAi.Data;
+using System.Collections.Concurrent;
+
+namespace MyAi.Data.Services;
+
+public sealed class DbTemplateService : ITemplateService
+{
+    private readonly IServiceScopeFactory _scopeFactory;
+    private readonly ILogger<DbTemplateService> _logger;
+    private ConcurrentDictionary<string, string> _cache = new(StringComparer.OrdinalIgnoreCase);
+    private DateTime _loadedAt = DateTime.MinValue;
+    private static readonly TimeSpan CacheTtl = TimeSpan.FromMinutes(10);
+
+    public DbTemplateService(IServiceScopeFactory scopeFactory, ILogger<DbTemplateService> logger)
+    {
+        _scopeFactory = scopeFactory;
+        _logger = logger;
+    }
+
+    public string Get(string key, string language = "en")
+    {
+        EnsureCacheLoaded();
+
+        if (_cache.TryGetValue(CacheKey(key, language), out var value))
+            return value;
+
+        if (!string.Equals(language, "en", StringComparison.OrdinalIgnoreCase)
+            && _cache.TryGetValue(CacheKey(key, "en"), out var fallback))
+            return fallback;
+
+        _logger.LogWarning("Template not found: key={Key}, language={Language}", key, language);
+        return key;
+    }
+
+    public string Render(string key, string language, params (string Key, string Value)[] placeholders)
+    {
+        var template = Get(key, language);
+        foreach (var (k, v) in placeholders)
+            template = template.Replace($"{{{{{k}}}}}", v, StringComparison.OrdinalIgnoreCase);
+        return template;
+    }
+
+    private void EnsureCacheLoaded()
+    {
+        if (DateTime.UtcNow - _loadedAt < CacheTtl) return;
+
+        try
+        {
+            using var scope = _scopeFactory.CreateScope();
+            var db = scope.ServiceProvider.GetRequiredService<MyAiDbContext>();
+            var rows = db.Templates.AsNoTracking().ToList();
+            var fresh = new ConcurrentDictionary<string, string>(StringComparer.OrdinalIgnoreCase);
+            foreach (var row in rows)
+                fresh[CacheKey(row.Key, row.Language)] = row.Value;
+
+            _cache = fresh;
+            _loadedAt = DateTime.UtcNow;
+            _logger.LogDebug("Template cache refreshed. {Count} templates loaded.", rows.Count);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Failed to refresh template cache. Serving stale cache.");
+        }
+    }
+
+    private static string CacheKey(string key, string language) => $"{key}::{language}";
+}

Apis/myai-data/Services/ITemplateService.cs

@@ -0,0 +1,7 @@
+namespace MyAi.Data.Services;
+
+public interface ITemplateService
+{
+    string Get(string key, string language = "en");
+    string Render(string key, string language, params (string Key, string Value)[] placeholders);
+}

Apis/myai-data/myai-data.csproj

@@ -0,0 +1,23 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <AssemblyName>myai-data</AssemblyName>
+    <RootNamespace>MyAi.Data</RootNamespace>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\shared-data\shared-data.csproj" />
+  </ItemGroup>
+
+</Project>

Apis/myai-data/myai-models.csproj

@@ -0,0 +1,18 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>MyAi.Models</RootNamespace>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.7" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.7">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+  </ItemGroup>
+
+</Project>