zhjwxt/niucloud/databasedoc/school_weapp_version.md

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) - 支持状态和版本号的复合查询

注意事项

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