coal/NEXT_STEPS.md

# 性能验证完成 - 下一步行动计划

## 总体结论

✅ **性能验证通过** - 数据库视图方案已被证明可用于生产环境

---

## 性能验证结果摘要

### 查询性能测试

| 场景 | 执行时间 | 评估 |
|------|---------|------|
| v_user_permissions (sys_admin) | **0.77 ms** ✅ | 极快 |
| v_user_resources (sys_admin) | **39.0 ms** ✅ | 优秀 |
| v_user_resources (org_admin) | **69.9 ms** ✅ | 优秀 |
| v_user_resources (regular) | **~70 ms** ✅ | 可接受 |

### 性能对比

```
原始方案: UserService Stream 操作 (50+ 行代码)
  ├─ 多个缓存查询
  ├─ CPU 密集
  └─ 预估: 50-100 ms

优化方案: 数据库视图 (3 行代码)
  ├─ 单次数据库查询
  ├─ 执行计划优化 (Hashed SubPlans)
  └─ 实测: 0.77-70 ms
```

### 缓存友好性

- **单点缓存**: 一个视图查询 → 一个缓存 key
- **一致性**: 缓存失效不再级联 (原: 5 个缓存)
- **预期命中率**: > 85% (权限变更不频繁)
- **缓存时间**: TTL 5-30 分钟

---

## 已生成的文档

### 1. PERFORMANCE_ANALYSIS.md
详细的性能测试报告，包括:
- 执行计划分析
- 并发性能预测
- 索引优化建议
- 生产环境影响评估
- SLA 目标设定

### 2. JAVA_SERVICE_IMPLEMENTATION.md
完整的实现指南，包括:
- PermissionCacheService 完整代码
- UserService 修改方案
- CacheInvalidationService 架构
- Redis 配置示例
- 迁移计划 (3 个 phase)
- 监控指标设置

---

## 立即行动 (下周)

### Week 1: 实现 (1周)

**Day 1-2: 编码**
```
[ ] 创建 PermissionCacheService
[ ] 修改 UserService (resources, permissions)
[ ] 创建 CacheInvalidationService
[ ] 修改 PermissionService
[ ] 修改 RoleService
```

**Day 3-4: 测试**
```
[ ] 单元测试 (100% 覆盖)
[ ] 集成测试 (权限正确性)
[ ] 性能测试 (基准对比)
[ ] 压力测试 (100 并发)
```

**Day 5: 部署准备**
```
[ ] 代码审查
[ ] 文档更新
[ ] 告警配置
[ ] 回滚方案确认
```

### Week 2: 灰度发布 (3 天)

```
Day 1: 测试环境验证 (100%)
  ✅ 功能: 权限查询正确
  ✅ 性能: 缓存命中 > 80%
  ✅ 稳定性: 100 并发用户无错误

Day 2: 灰度 10%
  📊 监控: 缓存命中率, 响应时间, 错误率
  ⚠️  告警: 如异常则立即回滚

Day 3: 全量发布 (10% → 50% → 100%)
  🎯 逐步扩大, 持续监控
```

---

## 关键指标验证点

部署前必须确认:

| 指标 | 目标 | 验证方法 |
|------|------|---------|
| 缓存命中率 | > 85% | Redis INFO stats |
| p95 响应时间 | < 100 ms | Prometheus 查询 |
| 错误率 | < 0.1% | 应用日志分析 |
| 内存消耗 | < 500 MB | Docker stats |
| 数据库连接 | < 20 | pg_stat_activity |

---

## 风险评估与缓解

| 风险 | 概率 | 影响 | 缓解 |
|------|------|------|------|
| 权限更新延迟 | 低 | 中 | 关键操作立即清缓存 |
| 缓存失效风暴 | 低 | 高 | 错开刷新 + 降级 |
| 视图定义变更 | 中 | 中 | 添加自动化测试 |
| Redis 不可用 | 低 | 中 | 回源到数据库 |

---

## 成功指标

部署 1 周后评估:

✅ **成功条件**:
1. 所有权限查询正确
2. 缓存命中率 > 80%
3. p95 响应时间 < 100 ms
4. 错误率 < 0.1%
5. 用户反馈无异常

❌ **失败条件 (立即回滚)**:
1. 权限查询错误
2. 错误率 > 1%
3. 数据库连接耗尽
4. 内存溢出

---

## 技术栈确认

实现前请确认有以下支持:

- [ ] Spring Boot 3.2.5+ (已有)
- [ ] Redis/Redisson 依赖 (需添加)
- [ ] JdbcTemplate 使用 (已有)
- [ ] Micrometer 监控 (需配置)
- [ ] Spring Cache 注解 (已有)

### 需要添加的 Maven 依赖

```xml
<!-- Redis 缓存 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

<!-- Redisson (可选，性能更优) -->
<dependency>
    <groupId>org.redisson</groupId>
    <artifactId>redisson-spring-boot-starter</artifactId>
    <version>3.24.0</version>
</dependency>

<!-- Micrometer (监控) -->
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-prometheus</artifactId>
</dependency>
```

---

## 后续优化机会

不在本次范围内，但可以考虑:

1. **权限预加载** (热用户缓存预热)
2. **权限分片** (按资源类型分片缓存)
3. **物化视图** (定期刷新，极速查询)
4. **权限同步** (从第三方 LDAP/OAuth)
5. **权限审计** (记录权限变更)

---

## 沟通确认

**请确认以下事项**:

1. ✅ 性能指标可接受 (0.77-70 ms)?
2. ✅ 实现计划合理 (3 天编码 + 3 天灰度)?
3. ✅ 缓存策略认可 (TTL 5-30 分钟)?
4. ✅ 监控指标完整 (缓存命中率、响应时间)?
5. ✅ 回滚方案可行?

**如有任何疑问，请反馈后再开始实施**。

---

## 相关文档快速链接

- 📊 [性能分析报告](./PERFORMANCE_ANALYSIS.md) - 详细的性能测试和基准设定
- 💻 [Java 实现指南](./JAVA_SERVICE_IMPLEMENTATION.md) - 完整代码和迁移步骤
- 🗄️ [SQL 视图定义](./PERMISSION_VIEWS.sql) - 数据库视图 DDL

---

**准备好开始下一步吗？👉 请确认上述内容，我们准备启动实施**