yunzerwebsite/yunzerwebsiteallinone

Fork 0

Files

T

hero920103 fa281363fb 做统一认证登录

2026-09-19 21:44:04 +08:00

5.6 KiB

Raw Blame History

平台更新内容功能说明

📋 功能概述

该平台更新内容功能用于在官网首页展示平台的近期更新记录，包括更新日期、标题和内容详情。

🗂️ 文件清单

后端文件

模型: go/models/platform_upgrade.go
- 定义平台更新记录的数据结构
控制器: go/controllers/api_platform_upgrade.go
- /api/platform/upgrade/list - 获取更新列表
- /api/platform/upgrade/detail - 获取单条详情
路由: go/routers/api/api.go
- 已注册 API 路由

前端文件

官网首页组件: website/src/views/home/components/ScheduleSection.vue
- 展示平台更新时间轴
- 自动从后端 API 获取数据
管理平台页面: platform/src/views/platform/platformupgrade/index.vue
- 更新内容的增删改查管理界面

数据库

SQL 脚本: docs/sql/platform_upgrade.sql
- 建表语句
- 示例数据

🚀 使用步骤

1. 执行 SQL 脚本

在数据库中执行以下 SQL 文件创建表结构：

# 路径：docs/sql/platform_upgrade.sql

该脚本会：

创建 yz_platform_upgrade 表
插入 3 条示例数据（可选）

表结构说明:

CREATE TABLE `yz_platform_upgrade` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
  `tenant_id` varchar(64) NOT NULL DEFAULT '',        -- 租户 ID（空表示全局）
  `update_date` varchar(20) NOT NULL DEFAULT '',      -- 更新日期 YYYY-MM-DD
  `title` varchar(255) NOT NULL DEFAULT '',           -- 更新标题
  `content` text,                                     -- 更新内容（支持 HTML）
  `sort` int(11) NOT NULL DEFAULT '0',                -- 排序权重（越大越靠前）
  `status` tinyint(4) NOT NULL DEFAULT '1',           -- 状态：0-隐藏 1-显示
  `create_user_id` varchar(64) NOT NULL DEFAULT '',   -- 创建人 ID
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `update_time` datetime DEFAULT NULL,
  `delete_time` datetime DEFAULT NULL,                -- 软删除时间
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

2. 重启后端服务

确保后端服务重新加载，注册新的路由：

cd go
# 如果是开发环境
bee run

# 如果是生产环境
./main

3. 配置菜单权限（可选）

如需在后台管理系统中访问"更新管理"页面，需要配置菜单权限：

菜单配置:

菜单名称：更新管理
路由地址：/platform/platformupgrade
组件路径：platform/platformupgrade
是否显示：是
排序：根据实际需要设置

4. 测试功能

4.1 查看官网首页展示

访问官网首页，滚动到"近期平台更新内容"区域，应该能看到从数据库读取的更新记录。

4.2 后台管理

访问 http://localhost:端口/platform/platformupgrade（具体端口根据实际情况），可以：

新增更新内容
编辑已有内容
删除更新记录
调整排序和显示状态

4.3 API 接口测试

获取更新列表:

curl http://localhost:端口/api/platform/upgrade/list?limit=10

获取单条详情:

curl http://localhost:端口/api/platform/upgrade/detail?id=1

预期响应:

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "id": 1,
      "update_date": "2026-09-18",
      "title": "平台 V3.0 版本发布",
      "content": "<h3>🎉 核心功能更新</h3>...",
      "create_time": "2026-09-18 10:00:00"
    }
  ]
}

📝 数据维护建议

添加新更新记录

通过后台管理界面点击"新增更新内容"
填写以下信息：
- 更新日期: 选择发布日期
- 标题: 简明扼要地描述更新主题
- 更新内容: 详细描述更新内容，支持 HTML 格式
- 排序: 数值越大越靠前显示
- 状态: 选择显示或隐藏

更新内容格式建议

推荐使用 HTML 格式，示例：

<h3>🎉 核心功能更新</h3>
<ul>
  <li><strong>CRM 模块增强</strong>: 新增上下游项目金额拆分管理</li>
  <li><strong>回款精细化管理</strong>: 支持多种回款周期类型</li>
</ul>

<h3>💡 体验优化</h3>
<ul>
  <li>移动端全面适配</li>
  <li>性能优化，加载速度提升 50%</li>
</ul>

删除记录

建议使用"隐藏"状态而非直接删除，保留历史记录便于追溯。如需彻底删除，请在后台管理中操作。

🔧 常见问题

Q1: 官网首页没有显示更新内容？

检查项:

确认数据库表已创建且包含数据
确认 status = 1（显示状态）
检查浏览器控制台是否有 API 请求错误
确认后端服务已重启并正确注册路由

Q2: 如何自定义显示数量？

修改 ScheduleSection.vue 中的 API 调用参数：

const response = await fetch('/api/platform/upgrade/list?limit=20');

或在后端控制器的 List() 方法中调整默认值。

Q3: 能否按租户隔离显示？

当前设计为全局显示（tenant_id 为空）。如需按租户隔离，可：

在查询时增加租户过滤条件
在前端传递租户 ID 参数
修改控制器逻辑

📊 扩展功能建议

版本对比: 增加版本号字段，支持版本对比
附件下载: 支持上传更新相关的附件（如安装包）
分类标签: 增加功能分类（如 CRM/OA/ERP/CMS）
统计功能: 记录每条更新的阅读量、点赞数等
推送通知: 更新时通过邮件/短信通知用户

📞 技术支持

如有问题，请联系开发团队或查看项目文档。

最后更新: 2026-09-18

5.6 KiB Raw Blame History Unescape Escape