feat(guild): repositories for Guild aggregate

SVSim.Database/Repositories/Guild/IGuildRepository.cs

@@ -0,0 +1,27 @@
+using SVSim.Database.Entities.Guild;
+
+namespace SVSim.Database.Repositories.Guild;
+
+public interface IGuildRepository
+{
+    Task<Entities.Guild.Guild?> GetByIdAsync(int guildId, CancellationToken ct = default);
+
+    /// <summary>Returns guild only if not soft-deleted (BreakupAt is null).</summary>
+    Task<Entities.Guild.Guild?> GetActiveByIdAsync(int guildId, CancellationToken ct = default);
+
+    /// <summary>Returns guild + populated Members list (split-query).</summary>
+    Task<Entities.Guild.Guild?> GetWithMembersAsync(int guildId, CancellationToken ct = default);
+
+    Task<bool> NameExistsAsync(string name, CancellationToken ct = default);
+
+    Task<Entities.Guild.Guild> AddAsync(Entities.Guild.Guild g, CancellationToken ct = default);
+
+    /// <summary>Soft-delete: sets BreakupAt to UtcNow. Caller is responsible for cascading
+    /// hard-deletes on Members / Invites / JoinRequests / ChatMessages.</summary>
+    Task MarkBrokenUpAsync(int guildId, DateTime brokenUpAt, CancellationToken ct = default);
+
+    /// <summary>Filtered + bucketed search. Empty name = match-all; activity/joinCondition/bucket = 0 = any.</summary>
+    Task<IReadOnlyList<Entities.Guild.Guild>> SearchAsync(
+        string name, int activity, int joinCondition, int memberBucket,
+        int maxMemberCap, int resultCap, CancellationToken ct = default);
+}