Files
TakeoutSaaS.AdminApi/tests/TakeoutSaaS.Integration.Tests/App/Tenants/AnnouncementWorkflowTests.cs
MSuMshk 857f776447 feat: 实现完整的多租户公告管理系统
核心功能:
- 公告状态机(草稿/已发布/已撤销)支持发布、撤销和重新发布
- 发布者范围区分平台级和租户级公告
- 目标受众定向推送(全部租户/指定角色/指定用户)
- 平台管理、租户管理和应用端查询API
- 已读/未读管理和未读统计

技术实现:
- CQRS+DDD架构,清晰的领域边界和事件驱动
- 查询性能优化:数据库端排序和限制,估算策略减少内存占用
- 并发控制:修复RowVersion配置(IsRowVersion→IsConcurrencyToken)
- 完整的FluentValidation验证器和输入保护

测试验证:
- 36个测试全部通过(27单元+9集成)
- 性能测试达标(1000条数据<5秒)
- 代码质量评级A(优秀)

文档:
- 完整的ADR、API文档和迁移指南
- 交付报告和技术债务记录
2025-12-20 19:57:09 +08:00

222 lines
8.6 KiB
C#

using FluentAssertions;
using Microsoft.EntityFrameworkCore;
using Moq;
using TakeoutSaaS.Application.App.Tenants.Commands;
using TakeoutSaaS.Application.App.Tenants.Handlers;
using TakeoutSaaS.Application.Messaging.Abstractions;
using TakeoutSaaS.Domain.Tenants.Entities;
using TakeoutSaaS.Domain.Tenants.Enums;
using TakeoutSaaS.Infrastructure.App.Repositories;
using TakeoutSaaS.Integration.Tests.Fixtures;
using TakeoutSaaS.Shared.Abstractions.Constants;
using TakeoutSaaS.Shared.Abstractions.Exceptions;
namespace TakeoutSaaS.Integration.Tests.App.Tenants;
public sealed class AnnouncementWorkflowTests
{
[Fact]
public async Task GivenDraftAnnouncement_WhenPublish_ThenStatusIsPublishedAndActive()
{
// Arrange
using var database = new SqliteTestDatabase();
using var context = database.CreateContext(tenantId: 100, userId: 11);
var announcement = CreateDraftAnnouncement(tenantId: 100, id: 9001);
context.TenantAnnouncements.Add(announcement);
await context.SaveChangesAsync();
context.ChangeTracker.Clear();
var repository = new EfTenantAnnouncementRepository(context);
var tenantProvider = new TestTenantProvider(100);
var eventPublisher = new Mock<IEventPublisher>();
var handler = new PublishAnnouncementCommandHandler(repository, tenantProvider, eventPublisher.Object);
// Act
var result = await handler.Handle(new PublishAnnouncementCommand
{
AnnouncementId = announcement.Id,
RowVersion = announcement.RowVersion
}, CancellationToken.None);
// Assert
result.Should().NotBeNull();
result!.Status.Should().Be(AnnouncementStatus.Published);
result.IsActive.Should().BeTrue();
using var verifyContext = database.CreateContext(tenantId: 100);
var persisted = await verifyContext.TenantAnnouncements.FirstAsync(x => x.Id == announcement.Id);
persisted.Status.Should().Be(AnnouncementStatus.Published);
persisted.IsActive.Should().BeTrue();
persisted.PublishedAt.Should().NotBeNull();
}
[Fact]
public async Task GivenPublishedAnnouncement_WhenRevoke_ThenStatusIsRevokedAndInactive()
{
// Arrange
using var database = new SqliteTestDatabase();
using var context = database.CreateContext(tenantId: 200, userId: 11);
var announcement = CreateDraftAnnouncement(tenantId: 200, id: 9002);
announcement.Status = AnnouncementStatus.Published;
announcement.IsActive = true;
context.TenantAnnouncements.Add(announcement);
await context.SaveChangesAsync();
context.ChangeTracker.Clear();
var repository = new EfTenantAnnouncementRepository(context);
var tenantProvider = new TestTenantProvider(200);
var eventPublisher = new Mock<IEventPublisher>();
var handler = new RevokeAnnouncementCommandHandler(repository, tenantProvider, eventPublisher.Object);
// Act
var result = await handler.Handle(new RevokeAnnouncementCommand
{
AnnouncementId = announcement.Id,
RowVersion = announcement.RowVersion
}, CancellationToken.None);
// Assert
result.Should().NotBeNull();
result!.Status.Should().Be(AnnouncementStatus.Revoked);
result.IsActive.Should().BeFalse();
using var verifyContext = database.CreateContext(tenantId: 200);
var persisted = await verifyContext.TenantAnnouncements.FirstAsync(x => x.Id == announcement.Id);
persisted.Status.Should().Be(AnnouncementStatus.Revoked);
persisted.IsActive.Should().BeFalse();
persisted.RevokedAt.Should().NotBeNull();
}
[Fact]
public async Task GivenRevokedAnnouncement_WhenPublish_ThenRepublishAndClearRevokedAt()
{
// Arrange
using var database = new SqliteTestDatabase();
using var context = database.CreateContext(tenantId: 300, userId: 11);
var announcement = CreateDraftAnnouncement(tenantId: 300, id: 9003);
announcement.Status = AnnouncementStatus.Revoked;
announcement.IsActive = false;
announcement.RevokedAt = DateTime.UtcNow.AddMinutes(-5);
context.TenantAnnouncements.Add(announcement);
await context.SaveChangesAsync();
context.ChangeTracker.Clear();
var repository = new EfTenantAnnouncementRepository(context);
var tenantProvider = new TestTenantProvider(300);
var eventPublisher = new Mock<IEventPublisher>();
var handler = new PublishAnnouncementCommandHandler(repository, tenantProvider, eventPublisher.Object);
// Act
var result = await handler.Handle(new PublishAnnouncementCommand
{
AnnouncementId = announcement.Id,
RowVersion = announcement.RowVersion
}, CancellationToken.None);
// Assert
result.Should().NotBeNull();
result!.Status.Should().Be(AnnouncementStatus.Published);
result.IsActive.Should().BeTrue();
using var verifyContext = database.CreateContext(tenantId: 300);
var persisted = await verifyContext.TenantAnnouncements.FirstAsync(x => x.Id == announcement.Id);
persisted.Status.Should().Be(AnnouncementStatus.Published);
persisted.IsActive.Should().BeTrue();
persisted.RevokedAt.Should().BeNull();
}
[Fact]
public async Task GivenPublishedAnnouncement_WhenUpdate_ThenThrowsBusinessException()
{
// Arrange
using var database = new SqliteTestDatabase();
using var context = database.CreateContext(tenantId: 400, userId: 11);
var announcement = CreateDraftAnnouncement(tenantId: 400, id: 9004);
announcement.Status = AnnouncementStatus.Published;
announcement.IsActive = true;
context.TenantAnnouncements.Add(announcement);
await context.SaveChangesAsync();
context.ChangeTracker.Clear();
var repository = new EfTenantAnnouncementRepository(context);
var handler = new UpdateTenantAnnouncementCommandHandler(repository);
var command = new UpdateTenantAnnouncementCommand
{
TenantId = 400,
AnnouncementId = announcement.Id,
Title = "更新标题",
Content = "更新内容",
TargetType = "ALL_TENANTS",
RowVersion = announcement.RowVersion
};
// Act
Func<Task> act = async () => await handler.Handle(command, CancellationToken.None);
// Assert
var exception = await act.Should().ThrowAsync<BusinessException>();
exception.Which.ErrorCode.Should().Be(ErrorCodes.Conflict);
}
[Fact]
public async Task GivenStaleRowVersion_WhenUpdate_ThenThrowsConcurrencyException()
{
// Arrange
using var database = new SqliteTestDatabase();
using var context = database.CreateContext(tenantId: 500, userId: 11);
var announcement = CreateDraftAnnouncement(tenantId: 500, id: 9005);
announcement.RowVersion = new byte[] { 1 };
context.TenantAnnouncements.Add(announcement);
await context.SaveChangesAsync();
await context.Database.ExecuteSqlRawAsync(
"UPDATE tenant_announcements SET \"RowVersion\" = {0} WHERE \"Id\" = {1}",
new byte[] { 9 }, announcement.Id);
context.ChangeTracker.Clear();
var repository = new EfTenantAnnouncementRepository(context);
var handler = new UpdateTenantAnnouncementCommandHandler(repository);
var command = new UpdateTenantAnnouncementCommand
{
TenantId = 500,
AnnouncementId = announcement.Id,
Title = "并发更新",
Content = "内容",
TargetType = "ALL_TENANTS",
RowVersion = new byte[] { 1 }
};
// Act
Func<Task> act = async () => await handler.Handle(command, CancellationToken.None);
// Assert
await act.Should().ThrowAsync<DbUpdateConcurrencyException>();
}
private static TenantAnnouncement CreateDraftAnnouncement(long tenantId, long id)
=> new()
{
Id = id,
TenantId = tenantId,
Title = "公告",
Content = "内容",
AnnouncementType = TenantAnnouncementType.System,
Priority = 1,
EffectiveFrom = DateTime.UtcNow.AddMinutes(-10),
EffectiveTo = DateTime.UtcNow.AddMinutes(30),
PublisherScope = PublisherScope.Tenant,
Status = AnnouncementStatus.Draft,
TargetType = "ALL_TENANTS",
TargetParameters = null,
IsActive = false,
RowVersion = new byte[] { 1 }
};
}