MSuMshk
857f776447
核心功能： - 公告状态机（草稿/已发布/已撤销）支持发布、撤销和重新发布 - 发布者范围区分平台级和租户级公告 - 目标受众定向推送（全部租户/指定角色/指定用户） - 平台管理、租户管理和应用端查询API - 已读/未读管理和未读统计 技术实现： - CQRS+DDD架构，清晰的领域边界和事件驱动 - 查询性能优化：数据库端排序和限制，估算策略减少内存占用 - 并发控制：修复RowVersion配置（IsRowVersion→IsConcurrencyToken） - 完整的FluentValidation验证器和输入保护 测试验证： - 36个测试全部通过（27单元+9集成） - 性能测试达标（1000条数据<5秒） - 代码质量评级A（优秀） 文档： - 完整的ADR、API文档和迁移指南 - 交付报告和技术债务记录
99 lines
2.8 KiB
Markdown
99 lines
2.8 KiB
Markdown
# 公告状态迁移说明
|
||
|
||
> 最后更新日期：2025-12-20
|
||
|
||
本文档说明公告状态相关迁移的目的、数据变化与回滚策略。
|
||
|
||
## 迁移列表
|
||
|
||
1. `20251220160000_AddTenantAnnouncementStatusAndPublisher.cs`
|
||
2. `20251220183000_GrantAnnouncementPermissionsToSuperAdmin.cs`
|
||
|
||
## 迁移目的
|
||
|
||
- 引入公告状态机（`Status`）与发布者信息（`PublisherScope/PublisherUserId`）。
|
||
- 增加目标受众字段（`TargetType/TargetParameters`）。
|
||
- 增加 `RowVersion` 以支持乐观并发。
|
||
- 预置公告相关权限到超级管理员角色。
|
||
|
||
## 数据结构变化
|
||
|
||
### 迁移前（tenant_announcements）
|
||
|
||
| 字段 | 说明 |
|
||
| --- | --- |
|
||
| `IsActive` | 是否启用（旧字段） |
|
||
| `EffectiveFrom` / `EffectiveTo` | 生效区间 |
|
||
| 其他基础字段 | 标题、内容、类型等 |
|
||
|
||
### 迁移后（新增字段）
|
||
|
||
| 字段 | 说明 |
|
||
| --- | --- |
|
||
| `Status` | 公告状态（Draft/Published/Revoked） |
|
||
| `PublisherScope` | 发布者范围（Platform/Tenant） |
|
||
| `PublisherUserId` | 发布者用户 ID |
|
||
| `PublishedAt` / `RevokedAt` | 实际发布时间/撤销时间 |
|
||
| `ScheduledPublishAt` | 预定发布时间（暂未使用） |
|
||
| `TargetType` / `TargetParameters` | 目标受众筛选 |
|
||
| `RowVersion` | 并发控制版本 |
|
||
|
||
### 索引新增
|
||
|
||
- `IX_tenant_announcements_TenantId_Status_EffectiveFrom`
|
||
- `IX_tenant_announcements_Status_EffectiveFrom_Platform`（TenantId=0）
|
||
|
||
## 数据迁移逻辑
|
||
|
||
迁移中将历史 `IsActive` 映射到 `Status`：
|
||
|
||
```sql
|
||
UPDATE tenant_announcements
|
||
SET "Status" = CASE WHEN "IsActive" THEN 1 ELSE 0 END;
|
||
```
|
||
|
||
## 权限迁移逻辑
|
||
|
||
迁移会为以下角色自动授予公告相关权限：
|
||
|
||
- `super-admin`
|
||
- `SUPER_ADMIN`
|
||
- `PlatformAdmin`
|
||
- `platform-admin`
|
||
|
||
并插入权限码：
|
||
`platform-announcement:create`、`platform-announcement:publish`、`platform-announcement:revoke`、
|
||
`tenant-announcement:publish`、`tenant-announcement:revoke`。
|
||
|
||
## 回滚策略
|
||
|
||
1. **应用数据库（公告表）**
|
||
- 回滚到迁移前版本：
|
||
```bash
|
||
dotnet ef database update <上一个迁移>
|
||
```
|
||
- 删除新增字段与索引（由 `Down` 执行）。
|
||
|
||
2. **身份数据库（权限）**
|
||
- 回滚迁移后，权限仅从 `role_permissions` 中删除，`permissions` 记录保留（符合当前 Down 逻辑）。
|
||
|
||
## 数据修复脚本（回滚后）
|
||
|
||
如需恢复旧逻辑，可手动同步 `IsActive`：
|
||
|
||
```sql
|
||
UPDATE tenant_announcements
|
||
SET "IsActive" = CASE WHEN "Status" = 1 THEN TRUE ELSE FALSE END;
|
||
```
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
Start[备份数据库] --> M1[执行迁移 20251220160000]
|
||
M1 --> M2[执行迁移 20251220183000]
|
||
M2 --> Check[验证状态/权限]
|
||
Check -->|失败| Rollback[回滚并修复数据]
|
||
Check -->|成功| Done[发布]
|
||
```
|
||
|
||
> 建议在生产环境迁移前进行全量备份，并在灰度环境验证数据一致性。
|