# school_addon_log 表文档

## 表概述
**表名**: school_addon_log  
**功能**: 插件操作日志表，用于记录插件的安装、卸载、更新等操作历史，包括版本变更追踪、操作审计和故障排查支持

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	主键
action	varchar(40)	utf8mb4_general_ci	NO				select,insert,update,references	操作类型   install 安装 uninstall 卸载 update 更新
key	varchar(20)	utf8mb4_general_ci	NO				select,insert,update,references	插件标识
from_version	varchar(20)	utf8mb4_general_ci	NO				select,insert,update,references	升级前的版本号
to_version	varchar(20)	utf8mb4_general_ci	NO				select,insert,update,references	升级后的版本号
create_time	int	NULL	NO		0		select,insert,update,references	创建时间
```

## 功能用途

### 主要功能
- **插件操作日志**: 记录插件的安装、卸载、更新等操作历史
- **版本追踪**: 跟踪插件版本变更历史，记录升级前后版本号
- **操作审计**: 提供插件操作的审计追踪和历史记录
- **故障排查**: 为插件相关问题提供操作历史支持
- **回滚支持**: 为插件回滚操作提供版本信息参考
- **操作统计**: 统计插件的使用和更新频率
- **合规记录**: 满足系统变更管理的合规性要求
- **时间追踪**: 记录每次操作的具体时间
- **插件标识**: 通过key字段唯一标识操作的插件

### 业务场景
- **插件安装**: 记录新插件的安装操作和版本信息
- **插件卸载**: 记录插件卸载操作，保留历史信息
- **版本升级**: 记录插件版本升级的完整过程
- **故障诊断**: 通过操作历史排查插件相关问题
- **系统审计**: 定期审计插件变更操作
- **回滚操作**: 基于历史记录进行插件版本回滚
- **变更管理**: 管理和跟踪系统插件变更
- **操作报告**: 生成插件操作统计报告
- **合规检查**: 满足系统变更的合规性检查

## 关联关系

### 主要关联表
- `school_addon`: 插件管理表 (key字段关联)
- `school_personnel`: 人员信息表 (操作人员关联)
- `school_sys_config`: 系统配置表 (插件配置关联)
- `sys_log`: 系统日志表 (操作日志关联)
- `school_campus`: 校区信息表 (操作范围关联)

### 关联说明
- **插件关联**: key字段关联school_addon表的插件标识
- **操作人员**: 通过系统日志关联操作人员信息
- **配置关联**: 插件操作可能涉及相关配置变更
- **日志关联**: 与系统操作日志形成完整的审计链
- **范围关联**: 插件操作可能限定在特定校区范围
- **版本关联**: from_version和to_version形成版本变更链

## 索引建议
- **主键索引**: id (已存在)
- **业务索引**: 
  - key (插件标识查询)
  - action (操作类型查询)
  - from_version (源版本查询)
  - to_version (目标版本查询)
- **复合索引**: 
  - (key, action) (插件操作类型查询)
  - (key, create_time) (插件操作时间查询)
  - (action, create_time) (操作类型时间查询)
  - (key, from_version, to_version) (版本变更查询)
- **时间索引**: 
  - create_time (创建时间查询)

## 注意事项
- **操作类型**: action字段限定为install、uninstall、update三种类型
- **插件标识**: key字段必须与school_addon表中的插件标识保持一致
- **版本格式**: from_version和to_version需要遵循版本号格式规范
- **只增不删**: 日志记录应该只增不删，保持完整的操作历史
- **时间精度**: create_time需要精确记录操作时间
- **数据完整性**: 所有字段都不允许为空，确保日志完整性
- **版本一致性**: 升级操作的to_version应该与实际安装版本一致
- **操作原子性**: 插件操作和日志记录应该在同一事务中完成
- **日志清理**: 建立合理的日志清理策略，避免数据过度膨胀
- **权限控制**: 只有授权人员才能进行插件操作
- **备份策略**: 重要插件操作前需要进行数据备份
- **回滚验证**: 记录的版本信息需要支持插件回滚操作
- **异常处理**: 操作失败时也需要记录相应的日志信息
- **监控告警**: 建立插件操作的监控和异常告警机制
- **审计要求**: 满足系统变更管理的审计要求
- **性能考虑**: 大量日志查询时需要考虑性能优化