# 变更日志

> 最后更新日期：2025-12-20

## v2.1.0 - 2025-12-20

### 新增
- 公告状态机（Draft/Published/Revoked）与平台公告（TenantId=0）支持。
- 平台公告管理 API：创建、查询、更新、发布、撤销。
- 租户公告发布/撤销端点与应用端公告列表/未读/已读端点。
- 目标受众过滤（TargetType/TargetParameters）与用户已读记录。
- 公告发布/撤销领域事件：`tenant-announcement.published`、`tenant-announcement.revoked`。
- 公告权限与超级管理员角色默认授权迁移。
- 公告模块单元测试/集成测试/性能测试基线。
- 公告相关文档与 ADR。

### 变更
- 公告查询逻辑支持 `TenantId IN (当前租户, 0)`，并按优先级与生效时间排序。
- 公告更新限制为草稿状态；已发布公告必须先撤销再重发。
- 新增 `RowVersion` 乐观并发控制字段。
- 保留 `IsActive` 作为兼容字段，并同步到 `Status`。

### 修复
- 标记已读操作幂等化，已读重复请求不再失败。

### 弃用
- `IsActive` 作为主状态字段（保留但不再作为唯一状态依据）。

### 升级提示（示例）

```bash
dotnet ef database update
```

```mermaid
flowchart LR
  Start[升级开始] --> Db[执行迁移]
  Db --> Api[更新 API]
  Api --> Done[完成]
```