Enhance documentation with new features: added dark/light/system theme support, instructions page, and application catalog. Updated API and domain model for app management and automatic migrations on startup. Improved frontend structure with new routes and features for user instructions and app management.

backend/src/PnvPanel.Application/Admin/Inbounds/InboundDto.cs

@@ -0,0 +1,13 @@
+using PnvPanel.Domain.Inbounds;
+
+namespace PnvPanel.Application.Admin.Inbounds;
+
+public sealed record InboundDto(
+    Guid Id, Guid NodeId, string RemoteInboundId, VpnProtocol Protocol, string Remark, int Port,
+    bool IsPublished, string? DisplayName, int? MaxClients, IReadOnlyList<Guid> AllowedRoleIds,
+    DateTimeOffset? LastSyncAt)
+{
+    public static InboundDto FromDomain(Inbound inbound) => new(
+        inbound.Id, inbound.NodeId, inbound.RemoteInboundId, inbound.Protocol, inbound.Remark, inbound.Port,
+        inbound.IsPublished, inbound.DisplayName, inbound.MaxClients, inbound.AllowedRoleIds, inbound.LastSyncAt);
+}

backend/src/PnvPanel.Application/Admin/Inbounds/InboundErrors.cs

@@ -0,0 +1,8 @@
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Inbounds;
+
+public static class InboundErrors
+{
+    public static readonly Error NotFound = Error.NotFound("Inbounds.NotFound", "Inbound не найден.");
+}

backend/src/PnvPanel.Application/Admin/Inbounds/ListInboundsQuery.cs

@@ -0,0 +1,6 @@
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Inbounds;
+
+public sealed record ListInboundsQuery(Guid? NodeId) : IQuery<Result<IReadOnlyList<InboundDto>>>;

backend/src/PnvPanel.Application/Admin/Inbounds/ListInboundsQueryHandler.cs

@@ -0,0 +1,19 @@
+using Microsoft.EntityFrameworkCore;
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Inbounds;
+
+public sealed class ListInboundsQueryHandler(IAppDbContext dbContext) : IQueryHandler<ListInboundsQuery, Result<IReadOnlyList<InboundDto>>>
+{
+    public async Task<Result<IReadOnlyList<InboundDto>>> Handle(ListInboundsQuery query, CancellationToken cancellationToken)
+    {
+        var inboundsQuery = dbContext.Inbounds.AsNoTracking();
+        if (query.NodeId is { } nodeId)
+            inboundsQuery = inboundsQuery.Where(i => i.NodeId == nodeId);
+
+        var inbounds = await inboundsQuery.OrderBy(i => i.Remark).ToListAsync(cancellationToken);
+        return Result.Success<IReadOnlyList<InboundDto>>(inbounds.Select(InboundDto.FromDomain).ToList());
+    }
+}

backend/src/PnvPanel.Application/Admin/Inbounds/PublishInboundCommand.cs

@@ -0,0 +1,8 @@
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Inbounds;
+
+public sealed record PublishInboundCommand(
+    Guid InboundId, bool IsPublished, string? DisplayName, IReadOnlyList<Guid> AllowedRoleIds, int? MaxClients)
+    : ICommand<Result<InboundDto>>;

backend/src/PnvPanel.Application/Admin/Inbounds/PublishInboundCommandHandler.cs

@@ -0,0 +1,24 @@
+using Microsoft.EntityFrameworkCore;
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Inbounds;
+
+public sealed class PublishInboundCommandHandler(IAppDbContext dbContext)
+    : ICommandHandler<PublishInboundCommand, Result<InboundDto>>
+{
+    public async Task<Result<InboundDto>> Handle(PublishInboundCommand command, CancellationToken cancellationToken)
+    {
+        var inbound = await dbContext.Inbounds.FirstOrDefaultAsync(i => i.Id == command.InboundId, cancellationToken);
+        if (inbound is null)
+            return Result.Failure<InboundDto>(InboundErrors.NotFound);
+
+        if (command.IsPublished)
+            inbound.Publish(command.DisplayName, command.AllowedRoleIds, command.MaxClients);
+        else
+            inbound.Unpublish();
+
+        return Result.Success(InboundDto.FromDomain(inbound));
+    }
+}

backend/src/PnvPanel.Application/Admin/Inbounds/PublishInboundCommandValidator.cs

@@ -0,0 +1,12 @@
+using FluentValidation;
+
+namespace PnvPanel.Application.Admin.Inbounds;
+
+public sealed class PublishInboundCommandValidator : AbstractValidator<PublishInboundCommand>
+{
+    public PublishInboundCommandValidator()
+    {
+        RuleFor(x => x.DisplayName).MaximumLength(100);
+        RuleFor(x => x.MaxClients).GreaterThan(0).When(x => x.MaxClients.HasValue);
+    }
+}