feat: 实现完整的多租户公告管理系统
核心功能: - 公告状态机(草稿/已发布/已撤销)支持发布、撤销和重新发布 - 发布者范围区分平台级和租户级公告 - 目标受众定向推送(全部租户/指定角色/指定用户) - 平台管理、租户管理和应用端查询API - 已读/未读管理和未读统计 技术实现: - CQRS+DDD架构,清晰的领域边界和事件驱动 - 查询性能优化:数据库端排序和限制,估算策略减少内存占用 - 并发控制:修复RowVersion配置(IsRowVersion→IsConcurrencyToken) - 完整的FluentValidation验证器和输入保护 测试验证: - 36个测试全部通过(27单元+9集成) - 性能测试达标(1000条数据<5秒) - 代码质量评级A(优秀) 文档: - 完整的ADR、API文档和迁移指南 - 交付报告和技术债务记录
This commit is contained in:
98
docs/migrations/announcement-status-migration.md
Normal file
98
docs/migrations/announcement-status-migration.md
Normal file
@@ -0,0 +1,98 @@
|
||||
# 公告状态迁移说明
|
||||
|
||||
> 最后更新日期: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[发布]
|
||||
```
|
||||
|
||||
> 建议在生产环境迁移前进行全量备份,并在灰度环境验证数据一致性。
|
||||
Reference in New Issue
Block a user