From 222ceadb2de8eb3a93e6308d6c7a3b2d49556b53 Mon Sep 17 00:00:00 2001
From: Hinton <hinton@users.noreply.github.com>
Date: Tue, 16 Dec 2025 20:33:01 +0100
Subject: [PATCH] Document repositories

---
 .../AdminConsole/Repositories/OrganizationRepository.cs    | 4 ++++
 src/Infrastructure.Dapper/Repositories/UserRepository.cs   | 4 ++++
 .../AdminConsole/Repositories/OrganizationRepository.cs    | 4 ++++
 .../Repositories/UserRepository.cs                         | 7 +++++--
 4 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/src/Infrastructure.Dapper/AdminConsole/Repositories/OrganizationRepository.cs b/src/Infrastructure.Dapper/AdminConsole/Repositories/OrganizationRepository.cs
index de16439c9e..8d31aa44b0 100644
--- a/src/Infrastructure.Dapper/AdminConsole/Repositories/OrganizationRepository.cs
+++ b/src/Infrastructure.Dapper/AdminConsole/Repositories/OrganizationRepository.cs
@@ -254,6 +254,10 @@ public class OrganizationRepository : Repository<Organization, Guid>, IOrganizat
     }
 }
 
+/// <summary>
+/// Decorator around the <see cref="OrganizationRepository"/> that tracks
+/// created Organizations for seeding.
+/// </summary>
 public class TestOrganizationTrackingOrganizationRepository : OrganizationRepository
 {
     private readonly IPlayDataService _playDataService;
diff --git a/src/Infrastructure.Dapper/Repositories/UserRepository.cs b/src/Infrastructure.Dapper/Repositories/UserRepository.cs
index 0a373dee6f..fbd443bc03 100644
--- a/src/Infrastructure.Dapper/Repositories/UserRepository.cs
+++ b/src/Infrastructure.Dapper/Repositories/UserRepository.cs
@@ -474,6 +474,10 @@ public class UserRepository : Repository<User, Guid>, IUserRepository
     }
 }
 
+/// <summary>
+/// Decorator around the <see cref="UserRepository"/> that tracks
+/// created Users for seeding.
+/// </summary>
 public class TestUserTrackingUserRepository : UserRepository
 {
     private readonly IPlayDataService _playDataService;
diff --git a/src/Infrastructure.EntityFramework/AdminConsole/Repositories/OrganizationRepository.cs b/src/Infrastructure.EntityFramework/AdminConsole/Repositories/OrganizationRepository.cs
index f0e0d33f21..d936e53d53 100644
--- a/src/Infrastructure.EntityFramework/AdminConsole/Repositories/OrganizationRepository.cs
+++ b/src/Infrastructure.EntityFramework/AdminConsole/Repositories/OrganizationRepository.cs
@@ -441,6 +441,10 @@ public class OrganizationRepository : Repository<Core.AdminConsole.Entities.Orga
     }
 }
 
+/// <summary>
+/// Decorator around the <see cref="OrganizationRepository"/> that tracks
+/// created Organizations for seeding.
+/// </summary>
 public class TestOrganizationTrackingOrganizationRepository : OrganizationRepository
 {
     private readonly IPlayDataService _playDataService;
diff --git a/src/Infrastructure.EntityFramework/Repositories/UserRepository.cs b/src/Infrastructure.EntityFramework/Repositories/UserRepository.cs
index eab66985c2..ab39f45862 100644
--- a/src/Infrastructure.EntityFramework/Repositories/UserRepository.cs
+++ b/src/Infrastructure.EntityFramework/Repositories/UserRepository.cs
@@ -8,7 +8,6 @@ using Bit.Core.Services;
 using Bit.Infrastructure.EntityFramework.Models;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Logging;
 
 #nullable enable
 
@@ -18,7 +17,7 @@ public class UserRepository : Repository<Core.Entities.User, User, Guid>, IUserR
 {
     public UserRepository(IServiceScopeFactory serviceScopeFactory, IMapper mapper)
         : base(serviceScopeFactory, mapper, (DatabaseContext context) => context.Users)
-    {}
+    { }
 
     public async Task<Core.Entities.User?> GetByEmailAsync(string email)
     {
@@ -501,6 +500,10 @@ public class UserRepository : Repository<Core.Entities.User, User, Guid>, IUserR
     }
 }
 
+/// <summary>
+/// Decorator around the <see cref="UserRepository"/> that tracks
+/// created Users for seeding.
+/// </summary>
 public class TestUserTrackingUserRepository : UserRepository
 {
     private readonly IPlayDataService _playDataService;