# school_weapp_version 表文档

## 表概述
**表名**: school_weapp_version  
**功能**: 微信小程序版本管理表，用于管理教育机构微信小程序的版本发布和更新，包括版本号管理、发布状态控制、任务追踪、失败原因记录等，支持版本迭代、灰度发布和回滚机制，为学校提供完整的小程序版本生命周期管理功能

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	
version	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	
version_no	int	NULL	NO		1		select,insert,update,references	
desc	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	说明
create_time	int	NULL	NO		0		select,insert,update,references	
status	tinyint	NULL	NO		0		select,insert,update,references	状态
update_time	int	NULL	NO		0		select,insert,update,references	
fail_reason	text	utf8mb4_general_ci	YES		NULL		select,insert,update,references	
task_key	varchar(20)	utf8mb4_general_ci	NO				select,insert,update,references	上传任务key
```

## 功能用途

### 主要功能
- **版本管理**: 管理微信小程序的版本信息，包括版本号和版本描述
- **版本发布控制**: 控制小程序版本的发布状态，支持版本的启用和禁用
- **版本序号管理**: 通过版本序号实现版本的有序管理和版本比较
- **发布任务追踪**: 通过任务key追踪版本发布的异步任务状态
- **失败原因记录**: 记录版本发布失败的详细原因，便于问题排查
- **版本描述存储**: 存储版本的详细说明信息，便于版本管理和用户了解
- **时间追踪**: 记录版本的创建和更新时间，便于版本生命周期管理
- **状态监控**: 实时监控版本的发布状态，确保版本发布的可靠性

### 业务场景
- **小程序发布**: 管理教育机构微信小程序的版本发布和更新
- **功能迭代**: 支持小程序功能的迭代开发和版本管理
- **Bug修复**: 快速发布Bug修复版本，确保用户体验
- **版本回滚**: 在新版本出现问题时，支持快速回滚到稳定版本
- **灰度发布**: 支持小程序的灰度发布和A/B测试
- **用户通知**: 配合版本更新通知用户新功能和改进
- **合规审核**: 配合微信平台的审核流程，管理版本审核状态
- **发布计划**: 制定和执行小程序的版本发布计划
- **质量控制**: 通过版本管理确保发布质量和用户体验

## 关联关系

### 主要关联表
- **school_sys_config**: 系统配置表，可能存储小程序的基础配置信息
- **school_sys_user**: 系统用户表，关联版本发布的操作人员
- **school_campus**: 校区表，不同校区可能使用不同的小程序版本
- **school_sys_notice**: 系统通知表，可能关联版本更新通知
- **school_wechat_config**: 微信配置表，关联小程序的基础配置
- **school_sys_log**: 系统日志表，记录版本发布的操作日志

### 关联说明
- 与微信开发平台API集成，实现版本的自动发布和管理
- 与系统配置关联，管理小程序的全局配置参数
- 与用户权限系统关联，控制版本发布的操作权限
- 与通知系统关联，及时通知相关人员版本发布状态
- 与日志系统关联，记录详细的版本发布操作日志
- 与监控系统关联，实时监控版本发布的成功率和性能

## 索引建议
- **主键索引**: `PRIMARY KEY (id)` - 自动创建
- **版本号索引**: `UNIQUE INDEX idx_version (version)` - 确保版本号唯一性
- **版本序号索引**: `INDEX idx_version_no (version_no)` - 支持按版本序号查询
- **状态索引**: `INDEX idx_status (status)` - 支持按状态查询
- **任务key索引**: `UNIQUE INDEX idx_task_key (task_key)` - 确保任务key唯一性
- **时间索引**: `INDEX idx_create_time (create_time)` - 支持按创建时间查询
- **复合索引**: `INDEX idx_status_version_no (status, version_no)` - 支持状态和版本号的复合查询

## 注意事项
- **版本唯一性**: 确保版本号的唯一性，避免版本冲突
- **发布权限**: 严格控制版本发布权限，防止未授权的版本发布
- **任务监控**: 密切监控发布任务的执行状态，及时处理失败情况
- **回滚准备**: 保持版本回滚的能力，确保问题版本的快速处理
- **审核合规**: 确保版本内容符合微信平台的审核要求
- **测试验证**: 发布前进行充分的测试验证，确保版本质量
- **用户通知**: 及时通知用户版本更新信息和新功能
- **数据备份**: 发布前备份重要数据，防止版本发布导致的数据问题
- **性能监控**: 监控新版本的性能表现，及时发现和解决性能问题
- **失败处理**: 建立完善的发布失败处理机制，确保服务的连续性