添加功能

Application/Sandbox/Notes/
├── ArchiveNoteCommand.cs          → 命令 DTO
├── ArchiveNoteCommandHandler.cs   → 处理器
└── ArchiveNoteCommandRule.cs       → 验证规则

Api/Endpoints/
├── NoteEndpoints.cs                → 添加归档端点

public record ArchiveNoteCommand(Guid NoteId) : IRequest<Result<Unit>>;

public class ArchiveNoteCommandRule : IRequestRule<ArchiveNoteCommand>
{
    public IReadOnlyList<Error> Validate(ArchiveNoteCommand request)
    {
        if (request.NoteId == Guid.Empty)
            return [Error.Validation("ArchiveNote.Id", "笔记 ID 不能为空")];
        return [];
    }
}

public class ArchiveNoteCommandHandler : IRequestHandler<ArchiveNoteCommand, Result<Unit>>
{
    public async ValueTask<Result<Unit>> Handle(
        ArchiveNoteCommand request, CancellationToken ct)
    {
        // 业务逻辑：验证所有权、设置 IsArchived、提交
        return Result<Unit>.Success(Unit.Value);
    }
}

group.MapPost("/{id:guid}/archive", async (
    Guid id, IMediator mediator) =>
{
    var result = await mediator.Send(new ArchiveNoteCommand(id));
    return result.ToProblemDetails();
});

services.AddScoped<IRequestRule<ArchiveNoteCommand>, ArchiveNoteCommandRule>();