# 授权码模块部署检查清单

## 📋 部署前检查

### 1. 文件完整性检查
- [ ] ruoyi-license 模块目录存在
- [ ] pom.xml 已添加 license 模块
- [ ] ruoyi-admin/pom.xml 已添加 license 依赖
- [ ] SysLicenseController.java 已创建
- [ ] license.html 和 active.html 已创建
- [ ] login.html 和 login.js 已修改
- [ ] sys_license.sql 脚本已准备

### 2. 数据库准备
- [ ] 创建 sys_license 表
- [ ] 插入授权管理菜单数据
- [ ] 验证表结构正确
- [ ] 检查菜单权限配置

### 3. 代码配置
- [ ] 修改 LicenseUtils.java 中的密钥（生产环境必须）
- [ ] 确认拦截器路径配置正确
- [ ] 确认定时任务cron表达式
- [ ] 启动类添加 @EnableScheduling 注解

## 🔧 部署步骤

### 步骤1: 执行数据库脚本
```bash
mysql -u root -p your_database < sql/sys_license.sql
```
- [ ] 执行成功
- [ ] 表创建成功
- [ ] 菜单数据插入成功

### 步骤2: 修改启动类
```java
@SpringBootApplication
@EnableScheduling  // 添加此注解
public class RuoYiApplication {
    // ...
}
```
- [ ] 注解已添加

### 步骤3: 编译项目
```bash
mvn clean install
```
- [ ] 编译成功
- [ ] 无错误信息
- [ ] JAR包生成

### 步骤4: 启动应用
```bash
java -jar ruoyi-admin.jar
```
- [ ] 启动成功
- [ ] 无异常日志
- [ ] 端口正常监听

### 步骤5: 生成授权码
**方式A: 使用独立工具**
```bash
java com.ruoyi.license.util.LicenseGenerator
```
- [ ] 工具运行成功
- [ ] 授权码生成成功
- [ ] 授权码已保存

**方式B: 使用系统界面**
- [ ] 登录系统
- [ ] 访问授权管理
- [ ] 点击生成授权码
- [ ] 输入天数并生成

### 步骤6: 激活授权码
- [ ] 访问登录页
- [ ] 点击"激活授权码"
- [ ] 输入授权码
- [ ] 激活成功

## ✅ 功能测试

### 测试1: 授权码生成
- [ ] 系统界面生成授权码成功
- [ ] 独立工具生成授权码成功
- [ ] 授权码格式正确

### 测试2: 授权码激活
- [ ] 登录页激活成功
- [ ] 系统内激活成功
- [ ] 数据库记录正确

### 测试3: 授权验证
- [ ] 有效授权可正常登录
- [ ] 无授权无法登录
- [ ] 过期授权无法登录

### 测试4: 授权拦截
- [ ] 未授权访问被拦截
- [ ] 有效授权可正常访问
- [ ] 静态资源不被拦截

### 测试5: 定时检查
- [ ] 定时任务正常执行
- [ ] 授权过期自动更新状态
- [ ] 在线用户被踢出

### 测试6: 授权管理
- [ ] 授权列表查询正常
- [ ] 授权信息显示正确
- [ ] 授权删除功能正常

## 🔍 问题排查

### 问题1: 编译失败
**检查项:**
- [ ] Maven依赖是否正确
- [ ] JDK版本是否匹配
- [ ] pom.xml配置是否正确

**解决方案:**
```bash
mvn clean
mvn dependency:resolve
mvn install
```

### 问题2: 启动失败
**检查项:**
- [ ] 数据库连接是否正常
- [ ] 端口是否被占用
- [ ] 配置文件是否正确

**解决方案:**
- 检查 application.yml 配置
- 查看启动日志错误信息
- 确认数据库表已创建

### 问题3: 无法激活授权码
**检查项:**
- [ ] 授权码格式是否正确
- [ ] 授权码是否已过期
- [ ] 密钥是否一致

**解决方案:**
- 重新生成授权码
- 检查 LicenseUtils 密钥配置
- 查看后台错误日志

### 问题4: 授权验证不生效
**检查项:**
- [ ] 拦截器是否注册
- [ ] 数据库授权记录是否正确
- [ ] 定时任务是否执行

**解决方案:**
- 检查 LicenseConfig 配置
- 验证数据库 status 字段
- 确认 @EnableScheduling 已添加

### 问题5: 在线用户未被踢出
**检查项:**
- [ ] SessionDAO 是否注入
- [ ] 定时任务是否执行
- [ ] Shiro配置是否正确

**解决方案:**
- 检查 LicenseCheckTask 日志
- 验证 SessionDAO bean
- 重启应用服务器

## 📊 监控指标

### 运行时监控
- [ ] 授权状态正常
- [ ] 定时任务执行正常
- [ ] 无异常日志
- [ ] 内存使用正常
- [ ] CPU使用正常

### 业务监控
- [ ] 授权激活次数
- [ ] 授权过期提醒
- [ ] 用户登录成功率
- [ ] 授权拦截次数

## 🔐 安全检查

### 配置安全
- [ ] 生产环境已修改默认密钥
- [ ] 数据库密码已加密
- [ ] 授权码传输使用HTTPS
- [ ] 敏感日志已脱敏

### 权限安全
- [ ] 授权管理菜单仅管理员可见
- [ ] 授权激活操作有日志记录
- [ ] 授权码生成有权限控制
- [ ] 数据库访问有权限限制

### 数据安全
- [ ] 授权码加密存储
- [ ] 定期备份授权数据
- [ ] 授权日志完整保存
- [ ] 敏感信息不输出到日志

## 📝 上线清单

### 上线前
- [ ] 所有测试通过
- [ ] 代码已提交版本库
- [ ] 数据库脚本已准备
- [ ] 部署文档已编写
- [ ] 回滚方案已准备

### 上线中
- [ ] 备份现有数据
- [ ] 执行数据库脚本
- [ ] 部署新版本代码
- [ ] 生成初始授权码
- [ ] 激活授权码

### 上线后
- [ ] 验证功能正常
- [ ] 检查日志无异常
- [ ] 监控系统运行状态
- [ ] 通知相关人员
- [ ] 更新运维文档

## 📞 应急联系

### 技术支持
- 开发负责人: ___________
- 运维负责人: ___________
- 数据库管理员: ___________

### 应急预案
1. 授权失效 -> 立即激活新授权码
2. 系统无法登录 -> 检查授权状态
3. 数据丢失 -> 从备份恢复
4. 性能问题 -> 调整定时任务频率

---

**检查人**: ___________
**检查日期**: ___________
**部署环境**: [ ] 开发 [ ] 测试 [ ] 生产
**部署状态**: [ ] 成功 [ ] 失败 [ ] 部分成功