Documentation modifications

adas-core.Application/Services/PermissionService.cs

@@ -10,6 +10,11 @@ using MongoDB.Bson;
 
 namespace adas_core.Application.Services;
 
+/// <summary>
+/// Implements <see cref="IPermissionService"/> to evaluate user permissions from the configured <see cref="PermissionSettings"/> and the available authority data stores.
+/// Resolves <see cref="IDisplayService"/>, <see cref="IUserRepository"/>, and <see cref="IAuthorityRepository"/> through <see cref="Lazy{T}"/> so their construction is deferred until needed.
+/// </summary>
+/// <!-- aidoc:v1 sig=62dd81d -->
 public class PermissionService(
     IOptions<PermissionSettings> permissionsConfig,
     ILogger<PermissionService> logger,