live-forum/server/webapi/数据库脚本/v1.0.1_README.md
2026-03-24 11:27:37 +08:00

3.5 KiB
Raw Blame History

团播机构 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 (首页弹窗表)

- 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. 备份数据库

    -- 创建完整备份
    BACKUP DATABASE [LiveForumDB] TO DISK = 'D:\Backup\LiveForumDB_v1.0.1_backup.bak'
    
  2. 停止应用服务

    • 停止Web应用
    • 停止后台管理系统
  3. 执行升级脚本

    -- 在SSMS中执行
    USE [LiveForumDB]
    GO
    -- 执行 v1.0.1_upgrade.sql 脚本内容
    
  4. 验证升级结果

    • 检查脚本输出日志
    • 验证表结构是否正确创建
    • 验证字典数据是否正确添加
  5. 部署应用代码

    • 部署新版本应用程序
    • 部署新版本后台管理系统
  6. 启动服务并测试

    • 启动应用服务
    • 测试首页弹窗功能
    • 测试Banner跳转功能

回滚流程(紧急情况)

如果升级后发现问题,可以执行回滚:

  1. 停止应用服务

  2. 执行回滚脚本

    USE [LiveForumDB]
    GO
    -- 执行 v1.0.1_rollback.sql 脚本内容
    
  3. 恢复旧版本代码

  4. 启动服务

注意事项

执行前检查

  • 确认数据库连接正常
  • 确认有足够的磁盘空间
  • 确认备份已完成
  • 确认在低峰期执行

执行中监控

  • 观察脚本执行日志
  • 检查是否有错误信息
  • 验证每个步骤的执行结果

执行后验证

  • 验证新表是否创建成功
  • 验证约束是否更新正确
  • 验证字典数据是否添加成功
  • 测试应用功能是否正常

功能测试

首页弹窗功能测试

  1. 在后台管理系统中添加弹窗配置
  2. 打开小程序首页,验证弹窗是否显示
  3. 点击弹窗,验证跳转是否正确
  4. 检查后台统计数据是否正确

Banner跳转功能测试

  1. 在后台配置不同类型的Banner跳转
  2. 在小程序首页点击Banner
  3. 验证各种跳转类型是否正确:
    • 帖子详情跳转
    • 外部链接处理
    • 通知详情跳转
    • 无跳转处理

联系信息

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


重要提醒:

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