# 技术债务清单（公告模块）

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

本文件用于记录公告模块的已知技术债务与后续改进建议。

```mermaid
flowchart TD
  Debt[技术债务] --> Triage{优先级评估}
  Triage -->|高| P1[修复并写回归测试]
  Triage -->|中| P2[排期处理]
  Triage -->|低| P3[文档跟踪]
```

## 记录项

| 编号 | 描述 | 影响 | 优先级 | 建议解决方案 |
| --- | --- | --- | --- | --- |
| TD-001 | `IsActive` 字段已废弃但保留用于兼容旧逻辑 | 读写逻辑需要同时维护 `Status` 与 `IsActive`，增加复杂度 | 中 | 完成一次性迁移后移除 `IsActive` 或改为只读计算字段 |
| TD-002 | 部分测试在特定数据库配置下出现 `RowVersion` 初始化/并发冲突问题 | 集成测试偶发失败，影响 CI 稳定性 | 中 | 统一测试数据库并确保 `RowVersion` 为数据库生成（避免默认空字节数组） |
| TD-003 | 计划功能未实现：定时发布、置顶公告 | 产品功能不完整，运营需求需人工执行 | 高 | 使用 `ScheduledPublishAt` 结合后台任务实现定时发布；新增置顶字段与排序策略 |

## 修复示例（RowVersion 处理）

```csharp
// 建议仅由数据库生成 RowVersion，不在业务层手动赋值默认空数组
builder.Property(x => x.RowVersion)
    .IsRowVersion();
```

> 如需补充更多技术债务，请在此文件追加条目并注明日期。
