# 团播机构 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. 验证各种跳转类型是否正确：
   - 帖子详情跳转
   - 外部链接处理
   - 通知详情跳转
   - 无跳转处理

## 联系信息

如有问题，请联系开发团队。

---

**重要提醒**: 
- 生产环境执行前务必备份数据库
- 建议先在测试环境验证脚本
- 执行过程中如遇问题，立即停止并联系技术团队