feat(achievements): AchievementCatalogImporter, idempotent by (type, level)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

SVSim.Bootstrap/Importers/AchievementCatalogImporter.cs

@@ -0,0 +1,60 @@
+using Microsoft.EntityFrameworkCore;
+using SVSim.Bootstrap.Models.Seed;
+using SVSim.Database;
+using SVSim.Database.Models;
+
+namespace SVSim.Bootstrap.Importers;
+
+/// <summary>
+/// Idempotent upsert of achievement-catalog rows from <c>seeds/achievement-catalog.json</c>.
+/// Keyed by (AchievementType, Level) so re-running with new captures grows the ladder.
+/// Rows missing from the seed are LEFT INTACT.
+/// </summary>
+public class AchievementCatalogImporter
+{
+    public async Task<int> ImportAsync(SVSimDbContext context, string seedDir)
+    {
+        var seed = SeedLoader.LoadList<AchievementCatalogSeed>(Path.Combine(seedDir, "achievement-catalog.json"));
+        if (seed.Count == 0)
+        {
+            Console.WriteLine("[AchievementCatalogImporter] No seed rows; skipping.");
+            return 0;
+        }
+
+        var existing = await context.AchievementCatalog
+            .ToDictionaryAsync(e => (e.AchievementType, e.Level));
+        int created = 0, updated = 0;
+        var unmappedTypes = new HashSet<int>();
+        foreach (var s in seed)
+        {
+            if (s.AchievementType == 0 || s.Level == 0) continue;
+            var key = (s.AchievementType, s.Level);
+            var entry = existing.TryGetValue(key, out var ex) ? ex : new AchievementCatalogEntry
+            {
+                AchievementType = s.AchievementType,
+                Level = s.Level,
+            };
+            entry.Name = s.Name;
+            entry.RequireNumber = s.RequireNumber;
+            entry.RewardType = s.RewardType;
+            entry.RewardDetailId = s.RewardDetailId;
+            entry.RewardNumber = s.RewardNumber;
+            entry.OrderNum = s.OrderNum;
+            entry.EventType = s.EventType;
+            entry.EventArg = s.EventArg;
+            if (ex is null) { context.AchievementCatalog.Add(entry); existing[key] = entry; created++; }
+            else updated++;
+            if (s.EventType is null) unmappedTypes.Add(s.AchievementType);
+        }
+
+        await context.SaveChangesAsync();
+        Console.WriteLine($"[AchievementCatalogImporter] +{created}/~{updated}");
+        if (unmappedTypes.Count > 0)
+        {
+            Console.WriteLine($"[AchievementCatalogImporter] WARN: {unmappedTypes.Count} types " +
+                              $"with no event_type: [{string.Join(", ", unmappedTypes.OrderBy(x => x))}] — " +
+                              "add to ACHIEVEMENT_EVENT_MAP in data_dumps/extract/extract-achievements.py");
+        }
+        return created + updated;
+    }
+}

SVSim.Bootstrap/Models/Seed/AchievementCatalogSeed.cs

@@ -0,0 +1,17 @@
+using System.Text.Json.Serialization;
+
+namespace SVSim.Bootstrap.Models.Seed;
+
+public sealed class AchievementCatalogSeed
+{
+    [JsonPropertyName("achievement_type")] public int AchievementType { get; set; }
+    [JsonPropertyName("level")] public int Level { get; set; }
+    [JsonPropertyName("name")] public string Name { get; set; } = "";
+    [JsonPropertyName("require_number")] public int RequireNumber { get; set; }
+    [JsonPropertyName("reward_type")] public int RewardType { get; set; }
+    [JsonPropertyName("reward_detail_id")] public long RewardDetailId { get; set; }
+    [JsonPropertyName("reward_number")] public int RewardNumber { get; set; }
+    [JsonPropertyName("order_num")] public int OrderNum { get; set; }
+    [JsonPropertyName("event_type")] public string? EventType { get; set; }
+    [JsonPropertyName("event_arg")] public int? EventArg { get; set; }
+}