feat: 实现完整的多租户公告管理系统

核心功能:
- 公告状态机(草稿/已发布/已撤销)支持发布、撤销和重新发布
- 发布者范围区分平台级和租户级公告
- 目标受众定向推送(全部租户/指定角色/指定用户)
- 平台管理、租户管理和应用端查询API
- 已读/未读管理和未读统计

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

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

文档:
- 完整的ADR、API文档和迁移指南
- 交付报告和技术债务记录
This commit is contained in:
2025-12-20 19:50:17 +08:00
parent 00eb357e6e
commit 857f776447
76 changed files with 12957 additions and 281 deletions

View File

@@ -39,7 +39,53 @@ public sealed class TenantAnnouncement : MultiTenantEntityBase
public DateTime? EffectiveTo { get; set; }
/// <summary>
/// 是否启用
/// 发布者范围
/// </summary>
public PublisherScope PublisherScope { get; set; }
/// <summary>
/// 发布者用户 ID平台或租户后台账号
/// </summary>
public long? PublisherUserId { get; set; }
/// <summary>
/// 公告状态。
/// </summary>
public AnnouncementStatus Status { get; set; } = AnnouncementStatus.Draft;
/// <summary>
/// 实际发布时间UTC
/// </summary>
public DateTime? PublishedAt { get; set; }
/// <summary>
/// 撤销时间UTC
/// </summary>
public DateTime? RevokedAt { get; set; }
/// <summary>
/// 预定发布时间UTC
/// </summary>
public DateTime? ScheduledPublishAt { get; set; }
/// <summary>
/// 目标受众类型。
/// </summary>
public string TargetType { get; set; } = string.Empty;
/// <summary>
/// 目标受众参数JSON
/// </summary>
public string? TargetParameters { get; set; }
/// <summary>
/// 并发控制字段。
/// </summary>
public byte[] RowVersion { get; set; } = Array.Empty<byte>();
/// <summary>
/// 是否启用(已弃用,迁移期保留)。
/// </summary>
[Obsolete("Use Status instead.")]
public bool IsActive { get; set; } = true;
}

View File

@@ -0,0 +1,22 @@
namespace TakeoutSaaS.Domain.Tenants.Enums;
/// <summary>
/// 公告状态。
/// </summary>
public enum AnnouncementStatus
{
/// <summary>
/// 草稿。
/// </summary>
Draft = 0,
/// <summary>
/// 已发布。
/// </summary>
Published = 1,
/// <summary>
/// 已撤销。
/// </summary>
Revoked = 2
}

View File

@@ -0,0 +1,17 @@
namespace TakeoutSaaS.Domain.Tenants.Enums;
/// <summary>
/// 发布者范围。
/// </summary>
public enum PublisherScope
{
/// <summary>
/// 平台发布。
/// </summary>
Platform = 0,
/// <summary>
/// 租户发布。
/// </summary>
Tenant = 1
}

View File

@@ -18,5 +18,35 @@ public enum TenantAnnouncementType
/// <summary>
/// 运营通知。
/// </summary>
Operation = 2
Operation = 2,
/// <summary>
/// 平台系统更新公告。
/// </summary>
SYSTEM_PLATFORM_UPDATE = 3,
/// <summary>
/// 系统安全公告。
/// </summary>
SYSTEM_SECURITY_NOTICE = 4,
/// <summary>
/// 系统合规公告。
/// </summary>
SYSTEM_COMPLIANCE = 5,
/// <summary>
/// 租户内部公告。
/// </summary>
TENANT_INTERNAL = 6,
/// <summary>
/// 租户财务公告。
/// </summary>
TENANT_FINANCE = 7,
/// <summary>
/// 租户运营公告。
/// </summary>
TENANT_OPERATION = 8
}

View File

@@ -0,0 +1,22 @@
namespace TakeoutSaaS.Domain.Tenants.Events;
/// <summary>
/// 公告发布事件。
/// </summary>
public sealed class AnnouncementPublished
{
/// <summary>
/// 公告 ID。
/// </summary>
public long AnnouncementId { get; init; }
/// <summary>
/// 发布时间UTC
/// </summary>
public DateTime PublishedAt { get; init; }
/// <summary>
/// 目标受众类型。
/// </summary>
public string TargetType { get; init; } = string.Empty;
}

View File

@@ -0,0 +1,17 @@
namespace TakeoutSaaS.Domain.Tenants.Events;
/// <summary>
/// 公告撤销事件。
/// </summary>
public sealed class AnnouncementRevoked
{
/// <summary>
/// 公告 ID。
/// </summary>
public long AnnouncementId { get; init; }
/// <summary>
/// 撤销时间UTC
/// </summary>
public DateTime RevokedAt { get; init; }
}

View File

@@ -9,18 +9,55 @@ namespace TakeoutSaaS.Domain.Tenants.Repositories;
public interface ITenantAnnouncementRepository
{
/// <summary>
/// 查询公告列表,按类型、启用状态与生效时间筛选。
/// 查询公告列表(包含平台公告 TenantId=0,按类型、状态与生效时间筛选。
/// </summary>
/// <param name="tenantId">租户 ID。</param>
/// <param name="status">公告状态。</param>
/// <param name="type">公告类型。</param>
/// <param name="isActive">启用状态。</param>
/// <param name="effectiveFrom">生效开始时间筛选。</param>
/// <param name="effectiveTo">生效结束时间筛选。</param>
/// <param name="effectiveAt">生效时间点,为空不限制。</param>
/// <param name="orderByPriority">是否按优先级降序和生效时间降序排序,默认 false。</param>
/// <param name="limit">限制返回数量,为空不限制。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <returns>公告集合。</returns>
Task<IReadOnlyList<TenantAnnouncement>> SearchAsync(
long tenantId,
AnnouncementStatus? status,
TenantAnnouncementType? type,
bool? isActive,
DateTime? effectiveFrom,
DateTime? effectiveTo,
DateTime? effectiveAt,
bool orderByPriority = false,
int? limit = null,
CancellationToken cancellationToken = default);
/// <summary>
/// 按 ID 获取公告(包含平台公告 TenantId=0
/// </summary>
/// <param name="tenantId">租户 ID。</param>
/// <param name="announcementId">公告 ID。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <returns>公告实体或 null。</returns>
Task<TenantAnnouncement?> FindByIdInScopeAsync(long tenantId, long announcementId, CancellationToken cancellationToken = default);
/// <summary>
/// 查询未读公告(包含平台公告 TenantId=0
/// </summary>
/// <param name="tenantId">租户 ID。</param>
/// <param name="userId">用户 ID。</param>
/// <param name="status">公告状态。</param>
/// <param name="isActive">启用状态。</param>
/// <param name="effectiveAt">生效时间点,为空不限制。</param>
/// <param name="cancellationToken">取消标记。</param>
/// <returns>未读公告集合。</returns>
Task<IReadOnlyList<TenantAnnouncement>> SearchUnreadAsync(
long tenantId,
long? userId,
AnnouncementStatus? status,
bool? isActive,
DateTime? effectiveAt,
CancellationToken cancellationToken = default);