# school_applet_site_version 表文档

## 表概述
**表名**: school_applet_site_version  
**功能**: 小程序站点版本管理表，负责管理教务系统中小程序的版本操作记录，包括版本下载、更新等操作的追踪和管理

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	主键
version_id	int	NULL	NO		0		select,insert,update,references	版本id
type	varchar(20)	utf8mb4_general_ci	NO				select,insert,update,references	小程序类型
action	varchar(20)	utf8mb4_general_ci	NO				select,insert,update,references	操作方式 download 下载  upgrade 更新
create_time	int	NULL	NO		0		select,insert,update,references	创建时间
```

## 功能用途

### 主要功能
- **版本操作记录**: 记录小程序版本的下载和更新操作
- **小程序类型管理**: 区分不同类型的小程序版本操作
- **操作追踪**: 跟踪版本操作的时间和类型
- **版本关联**: 关联具体的版本ID进行操作记录
- **操作统计**: 统计版本操作的频率和类型
- **历史记录**: 保存版本操作的完整历史
- **审计支持**: 为版本管理提供审计追踪
- **时间管理**: 记录每次操作的具体时间
- **操作分类**: 区分下载和更新两种主要操作类型

### 业务场景
- **版本下载**: 记录小程序版本的下载操作
- **版本更新**: 记录小程序版本的更新操作
- **操作审计**: 审计小程序版本的操作历史
- **使用统计**: 统计不同版本的使用情况
- **问题排查**: 通过操作记录排查版本相关问题
- **版本管理**: 管理小程序的版本生命周期
- **操作监控**: 监控版本操作的频率和状态
- **数据分析**: 分析版本操作的趋势和模式
- **合规记录**: 满足版本管理的合规性要求

## 关联关系

### 主要关联表
- `school_applet_version`: 小程序版本表 (version_id字段关联)
- `school_personnel`: 人员信息表 (操作人员关联)
- `school_campus`: 校区信息表 (操作范围关联)
- `school_sys_config`: 系统配置表 (小程序配置关联)
- `sys_log`: 系统日志表 (操作日志关联)

### 关联说明
- **版本关联**: version_id字段关联school_applet_version表的版本信息
- **操作人员**: 通过系统日志关联具体的操作人员
- **小程序类型**: type字段区分不同类型的小程序
- **操作类型**: action字段区分下载和更新操作
- **时间关联**: create_time记录操作的具体时间
- **业务关联**: 与小程序管理业务流程紧密关联

## 索引建议
- **主键索引**: id (已存在)
- **外键索引**: version_id (版本关联查询)
- **业务索引**: 
  - type (小程序类型查询)
  - action (操作类型查询)
- **复合索引**: 
  - (version_id, action) (版本操作查询)
  - (type, action) (类型操作查询)
  - (version_id, create_time) (版本时间查询)
  - (action, create_time) (操作时间查询)
- **时间索引**: create_time (创建时间查询)

## 注意事项
- **版本ID完整性**: version_id必须关联到有效的小程序版本
- **操作类型限制**: action字段限定为download和upgrade两种类型
- **小程序类型**: type字段需要与系统支持的小程序类型保持一致
- **时间精度**: create_time需要精确记录操作时间
- **数据完整性**: 所有必填字段都不允许为空
- **操作原子性**: 版本操作和记录插入应该在同一事务中完成
- **重复操作**: 需要考虑同一版本的重复操作记录
- **权限控制**: 只有授权人员才能进行版本操作
- **日志清理**: 建立合理的操作记录清理策略
- **性能优化**: 大量记录查询时需要考虑性能
- **监控告警**: 建立版本操作的监控机制
- **审计要求**: 满足版本管理的审计要求
- **数据一致性**: 确保操作记录与实际版本状态一致
- **异常处理**: 操作失败时的记录处理策略