151 lines
3.5 KiB
Markdown
151 lines
3.5 KiB
Markdown
# 团播机构 v1.0.1 数据库升级说明
|
||
|
||
## 概述
|
||
|
||
本次升级包含以下功能：
|
||
1. **首页弹窗功能** - 支持在小程序首页显示可配置的弹窗
|
||
2. **Banner跳转功能** - 支持Banner点击跳转到不同页面类型
|
||
|
||
## 文件说明
|
||
|
||
| 文件名 | 说明 | 用途 |
|
||
|--------|------|------|
|
||
| `v1.0.1_upgrade.sql` | 升级脚本 | 执行数据库升级 |
|
||
| `v1.0.1_rollback.sql` | 回滚脚本 | 紧急回滚使用 |
|
||
| `v1.0.1_README.md` | 说明文档 | 执行指南 |
|
||
|
||
## 升级内容
|
||
|
||
### 1. 新增表结构
|
||
|
||
#### T_HomePopups (首页弹窗表)
|
||
```sql
|
||
- Id: 主键，自增
|
||
- Title: 弹窗标题
|
||
- ImageUrl: 弹窗图片URL (必填)
|
||
- LinkType: 链接类型 (1-外部链接, 2-帖子详情, 3-通知详情, 4-无链接)
|
||
- LinkUrl: 链接地址
|
||
- TargetId: 目标ID (帖子ID或通知ID)
|
||
- IsActive: 是否启用
|
||
- StartTime: 开始时间
|
||
- EndTime: 结束时间
|
||
- SortOrder: 排序
|
||
- ViewCount: 浏览次数
|
||
- ClickCount: 点击次数
|
||
- CreatedAt: 创建时间
|
||
- UpdatedAt: 更新时间
|
||
```
|
||
|
||
### 2. 修改现有表
|
||
|
||
#### T_Banners 表约束更新
|
||
- 更新 `LinkType` 字段约束，支持值：1, 2, 3, 4
|
||
- 新增支持"通知详情"跳转类型
|
||
|
||
### 3. 字典配置
|
||
|
||
#### 新增字典类型
|
||
- `liveforum_popup_linktype`: 弹窗链接类型
|
||
|
||
#### 更新字典数据
|
||
- Banner链接类型新增"通知详情"选项
|
||
|
||
## 执行步骤
|
||
|
||
### 生产环境升级流程
|
||
|
||
1. **备份数据库**
|
||
```sql
|
||
-- 创建完整备份
|
||
BACKUP DATABASE [LiveForumDB] TO DISK = 'D:\Backup\LiveForumDB_v1.0.1_backup.bak'
|
||
```
|
||
|
||
2. **停止应用服务**
|
||
- 停止Web应用
|
||
- 停止后台管理系统
|
||
|
||
3. **执行升级脚本**
|
||
```sql
|
||
-- 在SSMS中执行
|
||
USE [LiveForumDB]
|
||
GO
|
||
-- 执行 v1.0.1_upgrade.sql 脚本内容
|
||
```
|
||
|
||
4. **验证升级结果**
|
||
- 检查脚本输出日志
|
||
- 验证表结构是否正确创建
|
||
- 验证字典数据是否正确添加
|
||
|
||
5. **部署应用代码**
|
||
- 部署新版本应用程序
|
||
- 部署新版本后台管理系统
|
||
|
||
6. **启动服务并测试**
|
||
- 启动应用服务
|
||
- 测试首页弹窗功能
|
||
- 测试Banner跳转功能
|
||
|
||
### 回滚流程（紧急情况）
|
||
|
||
如果升级后发现问题，可以执行回滚：
|
||
|
||
1. **停止应用服务**
|
||
|
||
2. **执行回滚脚本**
|
||
```sql
|
||
USE [LiveForumDB]
|
||
GO
|
||
-- 执行 v1.0.1_rollback.sql 脚本内容
|
||
```
|
||
|
||
3. **恢复旧版本代码**
|
||
|
||
4. **启动服务**
|
||
|
||
## 注意事项
|
||
|
||
### 执行前检查
|
||
- [ ] 确认数据库连接正常
|
||
- [ ] 确认有足够的磁盘空间
|
||
- [ ] 确认备份已完成
|
||
- [ ] 确认在低峰期执行
|
||
|
||
### 执行中监控
|
||
- [ ] 观察脚本执行日志
|
||
- [ ] 检查是否有错误信息
|
||
- [ ] 验证每个步骤的执行结果
|
||
|
||
### 执行后验证
|
||
- [ ] 验证新表是否创建成功
|
||
- [ ] 验证约束是否更新正确
|
||
- [ ] 验证字典数据是否添加成功
|
||
- [ ] 测试应用功能是否正常
|
||
|
||
## 功能测试
|
||
|
||
### 首页弹窗功能测试
|
||
1. 在后台管理系统中添加弹窗配置
|
||
2. 打开小程序首页，验证弹窗是否显示
|
||
3. 点击弹窗，验证跳转是否正确
|
||
4. 检查后台统计数据是否正确
|
||
|
||
### Banner跳转功能测试
|
||
1. 在后台配置不同类型的Banner跳转
|
||
2. 在小程序首页点击Banner
|
||
3. 验证各种跳转类型是否正确：
|
||
- 帖子详情跳转
|
||
- 外部链接处理
|
||
- 通知详情跳转
|
||
- 无跳转处理
|
||
|
||
## 联系信息
|
||
|
||
如有问题，请联系开发团队。
|
||
|
||
---
|
||
|
||
**重要提醒**:
|
||
- 生产环境执行前务必备份数据库
|
||
- 建议先在测试环境验证脚本
|
||
- 执行过程中如遇问题，立即停止并联系技术团队 |