SVSim/SVSimServer
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

feat(guild): service skeletons + DI

Browse Source
This commit is contained in:
gamer147
2026-06-27 11:25:55 -04:00
parent 45947053c8
commit a1aa6998b8
6 changed files with 252 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
SVSim.Database/Services/Guild/IGuildService.cs Normal file
View File

@@ -0,0 +1,40 @@
namespace SVSim.Database.Services.Guild;
/// <summary>
/// Single dispatch surface for guild business operations. Enforces:
/// - one viewer ≤1 guild
/// - MaxMemberNum / MaxSubLeaderNum caps (from GuildConfig)
/// - role-based permissions per docs/superpowers/specs/2026-06-27-guild-functionality-design.md
/// - leader-leaves-with-members blocked
/// - auto-routing single-member leader leave -> breakup
/// - clear pending invites + cancel pending join_requests on successful join
/// - emit system chat events via IGuildChatService
/// </summary>
public interface IGuildService
{
Task<GuildFullView?> GetMyGuildAsync(long viewerId, CancellationToken ct = default);
Task<Entities.Guild.Guild?> GetActiveAsync(int guildId, CancellationToken ct = default);
Task<IReadOnlyList<GuildSearchEntry>> SearchAsync(string name, int activity, int joinCondition, int memberBucket, CancellationToken ct = default);
Task<GuildOpResult> CreateAsync(long viewerId, CreateGuildRequest req, CancellationToken ct = default);
Task<GuildOpResult> UpdateAsync(long viewerId, UpdateGuildRequest req, CancellationToken ct = default);
Task<GuildOpResult> UpdateDescriptionAsync(long viewerId, string description, CancellationToken ct = default);
Task<GuildOpResult> UpdateEmblemAsync(long viewerId, long emblemId, CancellationToken ct = default);
Task<GuildOpResult> BreakupAsync(long viewerId, CancellationToken ct = default);
Task<GuildOpResult> InviteAsync(long callerViewerId, long targetViewerId, CancellationToken ct = default);
Task<GuildOpResult> CancelInviteAsync(long callerViewerId, long targetViewerId, CancellationToken ct = default);
Task<GuildOpResult> RejectInviteAsync(long callerViewerId, int guildId, CancellationToken ct = default);
Task<GuildOpResult> JoinAsync(long viewerId, int guildId, CancellationToken ct = default);
Task<GuildOpResult> CancelJoinRequestAsync(long viewerId, int guildId, CancellationToken ct = default);
Task<GuildOpResult> AcceptJoinRequestAsync(long callerViewerId, long applicantViewerId, CancellationToken ct = default);
Task<GuildOpResult> RejectJoinRequestAsync(long callerViewerId, long applicantViewerId, CancellationToken ct = default);
Task<GuildOpResult> LeaveAsync(long viewerId, CancellationToken ct = default);
Task<GuildOpResult> RemoveAsync(long callerViewerId, long targetViewerId, CancellationToken ct = default);
Task<GuildOpResult> ChangeRoleAsync(long callerViewerId, long targetViewerId, int newRoleId, CancellationToken ct = default);
Task<IReadOnlyList<Entities.Guild.GuildInvite>> ListPendingInvitesForMeAsync(long viewerId, CancellationToken ct = default);
Task<IReadOnlyList<Entities.Guild.GuildJoinRequest>> ListPendingJoinRequestsForMyGuildAsync(long viewerId, CancellationToken ct = default);
}