---
name: 测试要求增强与权限方案优化
overview: 1. 增强测试要求：代码级100%覆盖（每个类/方法/if-else/case分支）、测试前置流程（修改后必须先测试通过才能继续）；2. 权限实时生效方案从"数据库轮询标记"改为"Redis Pub/Sub"，利用已有Redis实例零额外中间件
todos:
  - id: update-08-redis
    content: 更新08-项目技术要求.md中权限实时通知方案为Redis Pub/Sub
    status: completed
  - id: update-08-test
    content: 更新08-项目技术要求.md中测试要求（100%覆盖+测试前置流程）
    status: completed
    dependencies:
      - update-08-redis
  - id: update-08-misc
    content: 更新08-项目技术要求.md中缓存策略表、缓存管理表、配置项等关联内容
    status: completed
    dependencies:
      - update-08-redis
  - id: update-03-redis
    content: 更新03-业务流转逻辑.md中权限实时生效描述
    status: completed
  - id: update-01-redis
    content: 更新01-模块划分.md中权限实时生效描述
    status: completed
---

## 用户需求

### 需求1：权限实时生效方案优化

当前方案"数据库轮询标记 + Spring Event"每5秒轮询一次数据库，资源消耗大。需要改为更轻量的方案，利用已有Redis实例实现毫秒级权限变更通知，零额外中间件、零数据库压力。

### 需求2：测试要求增强

- **100%代码级覆盖**：每个类、方法、包括方法里if-else、case分支都必须测试到
- **测试前置流程**：每次代码修改后，必须先进行测试，测试通过后才能进行下一步操作

## 方案概述

### 一、权限实时生效：Redis Pub/Sub 替代数据库轮询

**原理**：权限变更时通过 Redis `PUBLISH` 命令发布消息，各服务节点通过 `MessageListener` 订阅频道，收到消息后刷新本地权限缓存。

**优势对比**：

| 对比项 | 数据库轮询（原方案） | Redis Pub/Sub（新方案） |
| --- | --- | --- |
| 数据库压力 | 每5秒N次SQL | 0（不碰数据库） |
| 延迟 | 最大5秒 | 毫秒级（内存操作） |
| 资源消耗 | 定时线程+DB连接 | 复用已有Redis连接，几乎零额外开销 |
| 多节点支持 | 需每节点轮询 | 天然支持（每节点各自订阅） |
| 降级策略 | 无 | Redis断连时，权限缓存TTL(2小时)到期后自然刷新 |


**实现要点**：

- 频道命名：`permission:changed`
- 消息内容：版本号（Long），用于判断是否需要刷新
- 发布时机：角色权限变更、用户角色分配变更
- 订阅方：各服务实例启动时注册 `RedisMessageListenerContainer`
- 降级保障：Redis连接断开时不影响业务，缓存TTL到期后自动刷新

### 二、测试要求增强

- 单元测试覆盖率从70%提升至100%（行覆盖+分支覆盖）
- 新增JaCoCo分支覆盖指标要求
- 新增"9.6 测试前置流程"章节，定义代码修改→测试→下一步的强制流程
- 在7.8代码审查要求中增加测试覆盖率检查项

### 修改范围

3个文档，共约12处修改点：

1. **docs/08-项目技术要求.md**（9处）

- 3.1 权限变更实时通知：方案描述+代码示例
- 3.3 跨实例通信描述
- 5.3 缓存策略表
- 7.8 代码审查要求
- 8.4 缓存管理策略表
- 9.1 单元测试：覆盖率和分支要求
- 9.2 集成测试：权限生效延迟描述
- 新增9.6 测试前置流程
- 10.3 配置项：删除轮询间隔，新增Redis频道配置

2. **docs/03-业务流转逻辑.md**（1处）

- 2.3 权限实时生效流程中的描述

3. **docs/01-模块划分.md**（1处）

- 2.4 权限实时生效机制中的描述