联合营销平台-主题活动管理需求说明文档

基于原型界面的详细功能需求与开发指南

主题活动管理系统原型预览
主题活动管理系统原型界面预览 - 查看完整原型

1. 系统概述

联合营销平台主题活动管理系统是一个基于Web的企业级营销活动管理平台，主要用于管理营销主题活动的全生命周期。系统提供活动创建、查询、编辑、状态管理、转盘配置等核心功能，支持批量操作和多维度数据筛选。

1.1 核心功能模块

系统包含以下主要功能模块：

2. 查询筛选功能

2.1 功能描述

系统提供多维度的活动查询筛选功能，支持精确查找和模糊搜索，帮助用户快速定位目标活动。

2.2 筛选字段

字段名称 字段类型 查询方式 是否必填 字段限制
主题活动ID 文本输入 精确匹配 否 最大长度50字符，支持数字和字母
主题名称 文本输入 模糊匹配 否 最大长度100字符
头寸编号 下拉选择 精确匹配 否 从预设头寸编号列表选择
报名机构 下拉搜索 精确匹配 否 从预设机构列表选择
关联银行 下拉搜索 精确匹配 否 从预设银行列表选择
是否开启大转盘 下拉选择 精确匹配 否 是/否/全部
状态 下拉选择 精确匹配 否 生效中/已终止/全部
活动时间 日期范围 范围查询 否 开始时间不能晚于结束时间
字段约束说明：

2.3 业务流程

1
用户在筛选区域输入查询条件
2
系统进行前端字段验证（格式、长度等）
3
点击"搜索"按钮，发送查询请求到后端
4
后端执行数据库查询，返回符合条件的活动列表
5
前端更新数据表格显示查询结果
开发注意事项：

3. 活动列表展示

3.1 数据表格字段

字段名称 数据类型 显示格式 说明
复选框 Boolean 复选框 用于批量操作选择
序号 Number 数字 自动递增序号
主题活动ID String 文本 活动唯一标识符
头寸编号 String 文本 23位数字编号
主题名称 String 文本 活动业务名称
报名机构 String 文本 机构ID
关联银行 String 文本 银行ID
活动时间 DateTime YYYY-MM-DD HH:mm:ss - YYYY-MM-DD HH:mm:ss 活动开始和结束时间
创建人 String 文本 活动创建者
创建时间 DateTime YYYY-MM-DD HH:mm:ss 记录创建时间
最后修改人 String 文本 最后修改者
最后修改时间 DateTime YYYY-MM-DD HH:mm:ss 最后修改时间
是否开启大转盘 Boolean 是/否 转盘功能开启状态
状态 Enum 状态标签 生效中/已暂停
操作 Actions 操作按钮 查看/编辑/暂停/启用/开启转盘/配置转盘

3.2 状态管理

生效中
→
已暂停
→
生效中

活动状态支持在"生效中"和"已暂停"之间切换，系统会根据当前状态动态显示对应的操作按钮。

3.3 操作按钮逻辑

按钮名称 显示条件 操作说明
查看 始终显示 打开活动详情查看模态框
编辑 始终显示 打开活动编辑模态框
暂停 状态为"生效中"时显示 暂停当前活动，需二次确认
启用 状态为"已暂停"时显示 重新启用活动，需二次确认
开启转盘 状态为"生效中"且转盘未开启时显示 开启大转盘功能
配置转盘 状态为"生效中"且转盘已开启时显示 进入转盘配置界面

4. 新增活动功能

4.1 功能描述

通过右侧弹出模态框的方式，提供新增主题活动的功能。模态框占据浏览器高度100%，提供良好的表单填写体验。

4.2 表单字段定义

字段名称 字段类型 是否必填 验证规则 默认值
主题名称 文本输入 是 最大100字符，不能为空 无
头寸编号 下拉选择 否 从预设列表选择 请选择头寸编号
报名机构 下拉选择 是 从预设列表选择 请选择机构
关联银行 下拉选择 是 从预设列表选择 请选择银行
活动时间 日期范围 是 结束时间必须晚于开始时间 无
背景图 文件上传 是 图片格式，建议尺寸375px*812px 上传区域
规则说明 多行文本 是 最大1000字符 无
最大领取次数 数字输入 是 正整数，1-999 无
字段约束详细说明：

4.3 业务流程

1
用户点击"新增"按钮，打开右侧弹出模态框
2
用户填写活动基本信息，系统实时进行前端验证
3
用户上传背景图片，系统验证图片格式和大小
4
用户填写规则说明和参与限制
5
点击"确定"按钮，系统进行完整性验证
6
验证通过后，提交数据到后端API
7
后端保存数据并返回结果
8
前端显示操作结果，成功后关闭模态框并刷新列表
开发注意事项：

5. 编辑活动功能

5.1 功能描述

允许用户编辑已存在的主题活动信息。编辑功能采用与新增相同的右侧弹出模态框设计，但会预填充当前活动的数据。

5.2 编辑限制规则

字段名称 是否可编辑 限制说明
主题活动ID 否 系统自动生成，不可修改
主题名称 是 可修改，但需遵循新增时的验证规则
头寸编号 是 可修改，从预设列表选择
报名机构 否 一旦确定不可修改，显示为禁用状态
关联银行 否 一旦确定不可修改，显示为禁用状态
活动时间 是 可修改，但不能与已发放的券冲突
背景图 是 可重新上传，覆盖原图
规则说明 是 可修改内容
最大领取次数 是 可修改，但不能小于已领取的最大次数
业务规则说明：

6. 查看活动详情

6.1 功能描述

提供活动详细信息的只读查看功能，包含三个标签页：查看批次数据、查看商户、查看二维码/链接。

6.2 标签页功能

6.2.1 查看批次数据

字段名称 数据类型 说明
序号 Number 自动递增序号
微信活动ID String 微信端活动标识
批次号 String 优惠券批次编号
券面额 String 优惠券金额，如"10元"
领取数量 Number 已领取的券数量
核销数量 Number 已使用的券数量

6.2.2 查看商户

字段名称 数据类型 说明
序号 Number 自动递增序号
商户号 String 商户唯一标识
业主ID String 业主标识号
业主名称 String 业主或机构名称
活动开始时间 Date 商户参与活动的开始时间
活动结束时间 Date 商户参与活动的结束时间

6.2.3 查看二维码/链接

开发注意事项：

7. 大转盘配置功能

7.1 功能描述

为已开启转盘功能的活动配置转盘奖品和抽奖规则。支持动态添加奖品、设置中奖概率、配置奖品展示样式等。

7.2 转盘配置字段

字段名称 字段类型 是否必填 验证规则 说明
排序 数字输入 是 正整数，1-12 奖品在转盘上的显示顺序
内容 下拉选择 是 从活动关联的奖品列表选择 奖品内容，显示为卡片样式
颜色 颜色选择器 是 16进制颜色值 奖品区域背景颜色
权重 数字输入 是 正整数，1-100 中奖权重，影响中奖概率

7.3 奖品内容卡片

奖品内容以彩色卡片形式展示，包含以下信息：

7.4 颜色选择器

提供预设颜色面板和自定义颜色输入：

7.5 业务流程

1
点击"配置转盘"按钮，打开转盘配置模态框
2
加载当前活动的现有转盘配置（如果有）
3
用户添加或编辑奖品配置项
4
设置奖品排序、选择内容、配置颜色和权重
5
系统验证配置完整性（至少2个奖品，权重总和合理）
6
保存配置到后端，更新转盘数据
配置约束：
开发注意事项：

8. 机构银行管理

8.1 功能描述

为活动管理报名机构和关联银行信息，支持机构和银行的增删改查操作，确保活动参与主体的准确性。

8.2 报名机构管理

功能 描述 操作方式
查询筛选 根据机构号、机构名称筛选 输入关键词，点击搜索
新增机构 从预设列表选择机构添加 下拉选择机构，点击新增
删除机构 移除单个或批量机构 单选删除或批量删除
批量导入 通过Excel文件批量导入 上传Excel文件，系统解析

8.3 关联银行管理

功能 描述 操作方式
查询筛选 根据银行ID、银行名称筛选 输入关键词，点击搜索
新增银行 从预设列表选择银行添加 下拉选择银行，点击新增
删除银行 移除单个或批量银行 单选删除或批量删除
批量导入 通过Excel文件批量导入 上传Excel文件，系统解析
业务规则：

9. 批量操作功能

9.1 批量暂停

支持同时暂停多个"生效中"状态的活动，提高管理效率。

操作流程：

1
用户勾选需要暂停的活动（仅限生效中状态）
2
点击表格上方的"暂停"按钮
3
系统弹出确认对话框，显示选中的活动数量
4
用户确认后，系统批量执行暂停操作
5
更新活动状态，清除选中状态，显示操作结果

9.2 数据导出

支持将当前查询结果导出为Excel文件，方便数据分析和备份。

导出字段：

导出限制：

10. 分页和全选功能

10.1 分页配置

配置项 默认值 可选值 说明
每页显示条数 10 10, 20, 50, 100 用户可动态调整
页码显示 当前页±2 最多显示5个页码 超出部分显示省略号
总数统计 实时更新 显示"共X条" 根据筛选条件动态变化

10.2 全选功能

11. 技术规范

11.1 前端技术要求

技术栈要求：

11.2 性能要求

性能指标 要求 说明
页面首次加载 ≤ 3秒 包含数据加载和渲染
查询响应时间 ≤ 1秒 正常网络环境下
模态框打开 ≤ 500ms 包含动画时间
文件上传 支持进度显示 大文件分片上传
内存占用 ≤ 100MB 长时间操作不内存泄露

11.3 浏览器兼容性

11.4 安全要求

安全措施：

11.5 API设计规范

规范项 要求 示例
URL设计 RESTful风格 GET /api/activities, POST /api/activities
HTTP状态码 标准语义 200成功, 400客户端错误, 500服务器错误
响应格式 统一JSON格式 {"code": 200, "data": {}, "message": ""}
分页参数 标准化 page, pageSize, total
错误处理 详细错误信息 包含错误码和用户友好提示

11.2 数据字典

11.2.1 主题活动表（bmt_theme_activity）

字段名 数据类型 长度 描述 约束
id BIGINT - 主键 主键，自增，非空
owner_id VARCHAR 20 业主id 可空
bank_id VARCHAR 50 银行id 可空
theme_activity_id VARCHAR 50 主题活动号 非空
header_number VARCHAR 50 头寸编号 可空
activity_start_time DATETIME - 活动开始时间 可空
activity_end_time DATETIME - 活动结束时间 可空
rules TEXT - 参与规则 可空
participation_limit INT - 参与次数上限（null为没有上限，0为没有参与次数） 可空
max_draws INT - 当日参与次数上限（null为没有上限，0为没有参与次数） 可空
background_image INT - 背景图 可空
status VARCHAR 20 活动状态 可空
gmt_create DATETIME - 创建时间 可空
create_by VARCHAR 50 创建人 可空
gmt_modified DATETIME - 修改时间 可空
modified_by VARCHAR 50 修改人 可空

11.2.2 大转盘配置表（wheel_config）

字段名 数据类型 长度 描述 约束
id BIGINT - 主键ID 主键，自增
activity_id BIGINT - 关联活动ID 外键，非空
prize_name VARCHAR 100 奖品名称 非空
prize_type VARCHAR 20 奖品类型（COUPON-优惠券，CASH-现金，GIFT-实物） 非空
prize_value DECIMAL 10,2 奖品价值 非空，>=0
probability DECIMAL 5,4 中奖概率（0-1之间） 非空，0<=值<=1
total_count INT - 奖品总数量 非空，>=0
remaining_count INT - 剩余数量 非空，>=0
sort_order INT - 显示顺序 非空，默认0
status VARCHAR 20 状态（ACTIVE-生效，INACTIVE-失效） 非空，默认ACTIVE
create_time DATETIME - 创建时间 非空
update_time DATETIME - 更新时间 可空

11.2.3 报名机构表（institution）

字段名 数据类型 长度 描述 约束
id BIGINT - 主键ID 主键，自增
institution_code VARCHAR 8 机构编码 唯一，非空
institution_name VARCHAR 100 机构名称 非空
institution_type VARCHAR 20 机构类型 非空
contact_person VARCHAR 50 联系人 可空
contact_phone VARCHAR 20 联系电话 可空
status VARCHAR 20 状态（NORMAL-正常，DISABLED-停用） 非空，默认NORMAL
create_time DATETIME - 创建时间 非空
update_time DATETIME - 更新时间 可空

11.2.4 关联银行表（bank）

字段名 数据类型 长度 描述 约束
id BIGINT - 主键ID 主键，自增
bank_code VARCHAR 8 银行编码 唯一，非空
bank_name VARCHAR 100 银行名称 非空
bank_type VARCHAR 20 银行类型 非空
bank_standard_code VARCHAR 10 银行标准代码 可空
contact_person VARCHAR 50 联系人 可空
contact_phone VARCHAR 20 联系电话 可空
status VARCHAR 20 状态（NORMAL-正常，DISABLED-停用） 非空，默认NORMAL
create_time DATETIME - 创建时间 非空
update_time DATETIME - 更新时间 可空

11.3 状态字典

11.3.1 活动状态字典

状态编码 状态名称 状态描述 可执行操作
ACTIVE 生效中 活动正常运行，用户可以参与 暂停、编辑、查看、删除
PAUSED 已暂停 活动暂时停止，用户无法参与 启用、编辑、查看、删除
EXPIRED 已过期 活动已结束，不可参与 查看

11.3.2 转盘状态字典

状态编码 状态名称 状态描述 可执行操作
ENABLED 已开启 转盘功能已启用，可配置奖品 配置奖品、关闭转盘、查看
DISABLED 未开启 转盘功能未启用 开启转盘

11.4 错误码字典

错误码 错误类型 错误描述 处理建议
200 成功 操作成功 正常处理
400 参数错误 请求参数格式错误或缺失 检查参数格式和必填项
401 未授权 用户未登录或token过期 重新登录获取token
403 权限不足 用户无权限执行该操作 联系管理员分配权限
404 资源不存在 请求的资源不存在 检查资源ID是否正确
409 冲突 数据冲突，如重复的头寸编号 检查数据唯一性
422 验证失败 业务规则验证失败 检查业务规则约束
500 服务器错误 服务器内部错误 联系技术支持
503 服务不可用 服务暂时不可用 稍后重试
技术规范说明：

13. 测试要求

13.1 功能测试用例

测试场景 测试要点 预期结果
新增活动 填写完整信息并提交 活动成功创建，列表显示新记录
字段验证 输入无效数据 显示相应的错误提示信息
状态切换 暂停/启用活动 状态正确更新，操作按钮相应变化
批量操作 选择多个活动进行批量暂停 所有选中活动状态更新为已暂停
数据查询 使用各种筛选条件查询 返回符合条件的活动列表
文件上传 上传背景图片 图片正确显示预览，文件保存成功
转盘配置 配置转盘奖品和权重 配置保存成功，转盘正确显示

13.2 边界测试

13.3 兼容性测试