This repository has been archived on 2026-04-19. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
knowledge-base/mini-app/阿尼坊后台管理系统功能需求文档.md
T

801 lines
23 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 阿尼坊后台管理系统功能需求文档v1.2
**文档版本**: v1.2
**创建日期**: 2025年12月8日
**最后更新**: 2026年3月23日
**适用范围**: 后台管理网站开发
---
## 📝 版本更新记录
| 版本 | 日期 | 更新内容 |
|------|------|--------|
| v1.1 | 2025-12-08 | 初版发布 |
| v1.2 | 2026-03-23 | 依据内测修改意见(2026-02-09)补录已实现功能:场次字段补全、状态流转逻辑、公布摊位号机制、重抽功能、申摊管理导航变更、评论人工审核开关等 |
---
## 📌 文档说明
本文档基于《阿尼坊会员系统功能需求文档251202》,梳理后台管理系统需要实现的核心功能模块。功能按优先级分为:
- **P0 **: 平台运营的基础功能
- **P1 **: 提升运营效率和数据分析能力的重要功能
---
## 🎯 P0 核心必须功能
### 一、内容管理模块
#### 1.1 活动公告管理
**功能列表**:
1. **轮播图管理**
- 上传轮播图(支持图片格式:JPG/PNG,大小限制5MB)
- 设置轮播图排序(拖拽排序)
- 配置跳转链接(可选:公告详情/外部链接/无跳转)
- 启用/停用轮播图
- 预览效果
2. **公告文章管理**
- 新建公告(标题、正文、封面图)
- 富文本编辑器(支持图文视频混排、格式化工具栏)
- 发布/下架公告
- 编辑已发布公告
- 删除公告(需二次确认)
- 公告列表(显示标题、发布时间、状态、点赞数)
- 搜索与筛选(按标题、发布时间、状态)
3. **评论管理**
- 查看所有评论(按公告、用户、时间筛选)
- 审核评论(通过/驳回)
- 删除违规评论
- 评论举报处理
- **人工审核开关**:可全局开启/关闭评论人工审核;关闭后评论直接发布,不进入审核队列
4. **用户须知管理**
- 编辑须知正文内容(支持超链接)
- 预览须知弹窗效果
- 版本历史记录
**数据字段**:
- 轮播图: ID、图片URL、排序值、跳转链接、状态、创建时间
- 公告: ID、标题、正文、封面图、点赞数、发布时间、状态
- 评论: ID、公告ID、用户ID、内容、点赞数、创建时间、状态
---
#### 1.2 市集卡片管理
**功能列表**:
1. **摊位卡片审核**
- 待审核列表(显示标题、图片、提交时间、申请人)
- 卡片详情查看(完整内容、申请人信息、场次信息)
- 审核操作(通过/驳回、填写驳回原因)
- 审核记录查看(审核人、审核时间、审核结果)
2. **商铺卡片审核**
- 审核流程同摊位卡片
- 支持查看商铺历史发布记录
3. **卡片管理**
- 已发布卡片列表(摊位卡片、商铺卡片混合展示)
- 按类型筛选(全部/摊位/商铺)
- 按状态筛选(审核中/已通过/已驳回)
- 搜索(标题、标签、发布人)
- 管理员强制下架卡片
- 管理员编辑卡片内容
4. **商铺卡片发布权限**
- 商铺会员可自由发布新卡片
- 新增卡片发布后设置冷却期(X小时后可发布下一张,可在后台配置)
- 已发布卡片可随时编辑,编辑操作会扣减热度值(编辑劝退系数)
- 后台可配置编辑劝退系数(取值0.0-1.0)
- 记录卡片编辑次数用于热度计算
5. **动漫IP标签库管理**
- 新增标签(标签名称、分类)
- 编辑/删除标签
- 标签热度排序设置
- 标签搜索与批量管理
6. **卡片收藏管理**
- 用户收藏记录列表
- 支持按类型筛选(摊位/商铺)
- 支持按收藏时间排序
**数据字段**:
- 卡片: ID、类型(摊位/商铺)、标题、正文、图片、标签、发布人ID、场次ID(仅摊位)、审核状态、审核意见、点赞数、热度值、发布时间、编辑次数、最后编辑时间
- 标签: ID、名称、分类、热度值、使用次数
- 收藏: ID、用户ID、卡片ID、卡片类型、收藏时间
---
### 二、设施预约管理模块
#### 2.1 设施基础管理
**功能列表**:
1. **设施信息管理**
- 新增设施(名称、描述、位置说明)
- 编辑设施信息
- 删除设施(需检查是否有未完成订单)
- 设施状态管理(正常营业/维护中/已关闭)
- 设施列表展示
2. **场所平面图管理**
- 上传平面图(支持JPG/PNG格式)
- 在平面图上标注设施位置(坐标点击配置)
- 设置设施点击跳转(跳转至预订时间表)
- 预览平面图效果
**数据字段**:
- 设施: ID、名称、描述、位置说明、状态、平面图坐标、创建时间、更新时间
---
#### 2.2 预约规则配置
**功能列表**:
1. **价格设置**
- 默认价格设置(周一至周五、周六日)
- 按日期自定义价格(选择日期范围,设置特殊价格)
- 节假日价格批量设置
- 价格历史记录查看
2. **预约范围设置**
- 可提前预约天数(如:可提前60天预约)
- 最短预约时长(如:1小时起约)
- 最长连续预约时长(如:最多连续预约8小时)
3. **营业时间设置**
- 默认营业时间(10:00-22:00)
- 按星期自定义营业时间
- 特殊日期营业时间调整
4. **锁定机制配置**
- 临时锁定时长设置(默认15分钟)
- 超时自动释放开关
- 心跳检测间隔设置
**数据字段**:
- 价格规则: ID、设施ID、日期范围、星期、每小时价格、创建时间
- 预约规则: ID、设施ID、提前天数、最短时长、最长时长、营业开始时间、营业结束时间
- 锁定配置: ID、锁定时长、心跳间隔
---
#### 2.3 订单管理
**功能列表**:
1. **订单列表**
- 全部订单展示(分页显示)
- 按状态筛选(全部/待支付/已支付/已取消/已完成)
- 按设施筛选
- 按日期范围筛选
- 按用户搜索(手机号/UID)
- 导出订单数据(Excel格式)
2. **订单详情**
- 订单基本信息(订单号、设施名称、预约日期、时段、总时长)
- 用户信息(姓名、手机号、UID)
- 支付信息(总价、支付时间、支付方式)
- 订单状态变更记录
3. **订单操作**
- 订单取消(管理员主动取消,需填写原因)
- 退款处理(全额/部分退款)
- 订单编辑(修改价格、时间、备注等关键字段)
- 订单备注(管理员添加备注信息)
4. **时段占用可视化日历**
- 按设施查看日历视图
- 已预约时段高亮显示
- 点击时段查看订单详情
- 快速定位空闲时段
**数据字段**:
- 订单: ID、订单号、设施ID、用户ID、预约日期、开始时间、结束时间、总时长、总价、支付状态、支付时间、订单状态、取消原因、管理员备注、创建时间
---
### 三、摊位市集管理模块
#### 3.1 场次管理
> **导航说明**:申摊管理(3.2节)已整合为场次的二级界面,点击场次列表中任意场次即可进入该场次的申摊管理页。
**功能列表**:
1. **场次创建**
- 新增场次(日期、星期、场地区域)
- 设置摊位总数量
- 设置手续费金额
- 设置申请开始/结束时间
- 设置抽签时间
- 设置支付截止时间
- 设置退款截止时间(**必填**;默认值自动联动场次日期:= 场次日期 − 2天 23:59,可手动修改)
- 填写「预约详情-备注」(展示于小程序预约详情页,公布摊位号后生效)
2. **场次列表**
- 展示所有场次(日期、区域、摊位数、申请人数、状态、**手续费**、**预约详情-备注**摘要)
- 排序规则:先按**日期升序**,同日期再按**区域字典序**排列
- 按日期筛选
- 按状态筛选(未开放/申请中/抽签中/已完成)
3. **场次详情**
- 查看场次基本信息(含手续费、退款截止时间、预约详情-备注)
- 实时显示:**剩余摊位数**、**未收款摊位数**、**已收款金额**、**总收入**
4. **场次操作**
- 编辑场次信息
- 场次开放/关闭控制
- 删除场次(需检查是否有申请)
**数据字段**:
- 场次: ID、日期、星期、场地区域(A区/B区)、摊位总数、手续费、申请开始时间、申请结束时间、抽签时间、支付截止时间、退款截止时间、预约详情-备注、状态、创建时间
---
#### 3.2 申摊管理
> **导航入口**:从场次列表点击场次进入,为场次二级界面,仅展示当前场次的申摊数据。
**功能列表**:
1. **申请列表**
- 展示当前场次全部申请(申请人、标题、提交时间、状态)
- 按状态筛选(待审核/审核通过/审核驳回/待抽签/中签/未中签/已支付)
- 按用户搜索
2. **审核操作**
- 查看申请详情(卡片内容、申请人信息、实名信息)
- 批量审核(勾选多个申请,批量通过/驳回)
- 填写驳回原因
- 审核记录查看
- **触发「审核完毕」**:所有申请审核完成后,点击「审核完毕」按钮,小程序端申请状态才会变更(未触发前小程序一律显示「待抽签」);触发后各申请按结果显示:`未中签` / `待缴费` / `审核驳回`
3. **抽签系统**
- 手动触发抽签(按场次执行)
- 查看抽签结果
- 抽签记录导出
- 主动推送通知(通知所有中签用户,可选择推送渠道:小程序/短信)
- 未中签用户通知
4. **重抽功能**
- 在「公布摊位号」之前,对因审核驳回而空余出的摊位,在未中签用户池中发起重抽
- 重抽结果记录至抽签记录
5. **摊位分配**
- 中签用户列表
- 手动分配摊位号
- 批量分配摊位号(自动按规则分配)
- 摊位号调整
- **摊位号格式**`场次日期(月.日) + 区域 + 编号`,例:`2.1 A区13`
- **公布摊位号**:点击后,申摊卡片在小程序「市集」页和「我的发布」页变为可见;同时将「预约详情-备注」内容推送至小程序预约详情页展示(公布前两处均不可见)
6. **黑名单管理**
- 添加用户至黑名单(填写原因)
- 黑名单列表(显示用户、原因、添加时间)
- 移除黑名单
**数据字段**:
- 申摊申请: ID、场次ID、用户ID、标题、正文、图片、标签、QQ号、审核状态、审核意见、审核人、审核时间、抽签状态、摊位号(格式:月.日+区域+编号)、支付状态、是否已公布、创建时间
- 黑名单: ID、用户ID、原因、添加人、添加时间
---
#### 3.3 商铺会员管理
**功能列表**:
1. **商铺会员升级**
- 普通会员搜索(按UID/手机号/昵称)
- 升级为商铺会员操作
- 录入商铺信息(商铺名称、商铺号、商铺头像)
- 绑定实名信息确认
2. **商铺会员列表**
- 展示所有商铺会员(商铺名称、商铺号、绑定用户、创建时间)
- 搜索商铺(商铺名称/商铺号)
- 查看商铺详情
3. **权限管理**
- 暂停商铺发布权限
- 恢复商铺发布权限
- 查看商铺发布记录
**数据字段**:
- 商铺会员: ID、用户ID、商铺名称、商铺号、商铺头像、状态(正常/暂停)、创建时间
---
#### 3.4 热度值管理
**功能列表**:
1. **衰减参数配置**
- 商铺卡片衰减系数设置(0.0~1.0)
- 摊位卡片衰减系数设置(0.0~1.0)
- 编辑劝退系数设置
- 热度计算时间段设置(X小时)
2. **热度值查看**
- 卡片热度值实时查看
- 热度值变化趋势图表
- 热度值排行榜(Top 50)
**数据字段**:
- 热度配置: ID、卡片类型(商铺/摊位)、衰减系数、编辑劝退系数、计算时间段、更新时间
---
### 四、用户管理模块
#### 4.1 用户基础管理
**功能列表**:
1. **用户列表**
- 展示所有用户(头像、昵称、UID、手机号、会员类型、注册时间)
- 按会员类型筛选(游客/普通会员/商铺会员)
- 按实名认证状态筛选(已认证/未认证)
- 搜索用户(UID/手机号/昵称)
- 导出用户数据(Excel格式)
2. **用户详情**
- 基本信息(头像、昵称、UID、手机号、QQ号、注册时间)
- 实名信息(姓名、身份证号、认证时间)
- 预约记录(设施预约、摊位申请)
- 发布记录(摊位卡片/商铺卡片)
- 评论记录
- 点赞记录
- 收藏记录
3. **用户操作**
- 禁用用户(填写原因,禁用后无法登录)
- 启用用户
- 强制修改用户信息(昵称、手机号)
- 重置用户手机号修改冷却
- 标记转摊记录(记录用户转摊次数,支持添加备注文本)
**数据字段**:
- 用户: ID、UID、昵称、头像、手机号、QQ号、会员类型、实名认证状态、账号状态、转摊标记次数、备注、注册时间、最后登录时间
---
#### 4.2 实名认证管理
**功能列表**:
1. **认证审核**
- 待审核列表(用户、提交时间)
- 查看认证信息(姓名、身份证号)
- 调用第三方接口验证(身份证号+姓名匹配)
- 审核通过/驳回
- 填写驳回原因
2. **认证记录**
- 已认证用户列表
- 认证失败记录
- 认证失败原因统计
**数据字段**:
- 实名认证: ID、用户ID、姓名、身份证号、认证状态、认证时间、审核人、驳回原因
---
#### 4.3 意见反馈管理
**功能列表**:
1. **反馈列表**
- 展示所有反馈(用户、内容摘要、提交时间、处理状态)
- 按处理状态筛选(待处理/已处理/已忽略)
- 按提交时间筛选
2. **反馈详情**
- 查看完整反馈内容
- 查看用户信息
- 查看提交时间
3. **反馈处理**
- 标记为"已处理"
- 标记为"已忽略"
- 添加处理备注
- 回复用户(可选功能)
**数据字段**:
- 意见反馈: ID、用户ID、内容、提交时间、处理状态、处理人、处理备注、处理时间
---
### 五、系统管理模块
#### 5.1 管理员账号管理
**功能列表**:
1. **管理员列表**
- 展示所有管理员(用户名、角色、状态、创建时间)
- 按角色筛选
- 按状态筛选(正常/已停用)
2. **管理员操作**
- 新增管理员(用户名、密码、角色、手机号、邮箱)
- 编辑管理员信息
- 重置管理员密码
- 停用/启用管理员账号
- 删除管理员(需二次确认)
**数据字段**:
- 管理员: ID、用户名、密码(加密)、角色、手机号、邮箱、状态、创建时间、最后登录时间
---
#### 5.2 权限管理
**功能列表**:
1. **角色管理**
- 预设角色:
- 超级管理员(拥有所有权限)
- 内容审核员(公告管理、卡片审核、评论管理)
- 运营人员(场次管理、申摊管理、订单查看)
- 客服(用户管理、意见反馈、订单处理)
- 自定义角色(选择权限组合)
- 编辑角色权限
2. **权限分配**
- 查看角色权限详情
- 为管理员分配角色
- 为管理员单独授予/撤销权限
**数据字段**:
- 角色: ID、角色名称、权限列表(JSON)、创建时间
- 权限: ID、权限名称、权限代码、所属模块
---
#### 5.3 操作日志
**功能列表**:
1. **日志记录**
- 自动记录所有管理员操作:
- 登录/登出
- 内容管理操作(新增、编辑、删除、审核)
- 用户管理操作
- 订单操作
- 系统配置修改
2. **日志查询**
- 按管理员筛选
- 按操作模块筛选
- 按操作类型筛选
- 按时间范围筛选
- 搜索关键词
- 导出日志(Excel格式)
3. **日志详情**
- 查看操作详情(操作前后数据对比)
- 追溯责任人
**数据字段**:
- 操作日志: ID、管理员ID、操作模块、操作类型、操作对象、操作详情(JSON)、IP地址、操作时间
---
#### 5.4 系统配置
**功能列表**:
1. **全局配置**
- 小程序名称
- 小程序LOGO
- 客服联系方式(电话、微信、邮箱、工作时间)
- 备注信息文本(申摊须知、预约须知)
2. **接口配置**
- 微信小程序AppID/AppSecret
- 微信支付商户号/API密钥
- 短信接口配置(供应商、API密钥)
- 实名认证接口配置
**数据字段**:
- 系统配置: ID、配置项名称、配置项值、更新时间、更新人
---
#### 5.5 定时任务管理
**功能列表**:
1. **任务配置**
- 周期清理过期卡片(时间配置:每周执行一次,清理满一年的卡片)
- 过期锁定时段自动释放
- 定时推送提醒消息
- 查看任务执行日志(执行时间、执行结果、清理数量)
2. **任务监控**
- 查看定时任务列表(任务名称、执行周期、上次执行时间、执行状态)
- 手动触发任务执行
- 任务执行历史查看
**数据字段**:
- 定时任务: ID、任务名称、任务类型、执行周期、执行时间、执行状态、上次执行时间、执行日志
---
### 六、运营工具模块
#### 6.1 IP摊位对照表导出
**功能列表**:
1. **IP表生成**
- 按场次生成IP对照表(Excel/CSV格式)
- 表格结构:
* 每行:各种动漫IP(如:名侦探柯南、棋魂、EVA等)
* 每列:场次+摊位号(如:2025-11-15 A区 摊位B15)
- 支持筛选中签摊位
- 支持按IP分类展示
2. **表格导出**
- 生成供游客查看的IP表(清晰展示各IP对应的摊位号)
- 支持多场次批量导出
- 导出格式:Excel/CSV
- 记录导出日期和版本
**使用场景**: 方便游客快速查找心仪IP所在摊位号
**数据字段**:
- 导出记录: ID、场次ID、导出时间、导出人、文件名、导出格式
---
## 📊 原P1重要功能(六、七、八)
### 六、数据统计与分析模块
#### 6.1 用户增长统计
**功能列表**:
1. **用户总览**
- 用户总数(游客/普通会员/商铺会员)
- 新增用户数(今日/本周/本月)
- 活跃用户数(今日/本周/本月)
- 实名认证率
2. **增长趋势图表**
- 按日/周/月查看新增用户趋势(折线图)
- 按日/周/月查看活跃用户趋势(折线图)
- 用户留存率(次日/7日/30日留存)
3. **用户来源分析**
- 按渠道统计(直接访问/分享/扫码)
- 按地区统计(如果可获取)
---
#### 6.2 收入统计
**功能列表**:
1. **收入总览**
- 总收入(今日/本周/本月/累计)
- 设施预约收入
- 摊位收入
- 退款金额
2. **收入趋势图表**
- 按日/周/月查看收入趋势(柱状图)
- 按设施查看收入贡献(饼图)
- 按场次查看摊位收入(柱状图)
3. **收入明细**
- 可导出详细收入报表
- 支持按支付方式筛选
---
#### 6.3 设施使用率分析
**功能列表**:
1. **使用率总览**
- 各设施整体使用率(预约时长/营业时长)
- 今日/本周/本月使用率对比
2. **热门时段分析**
- 按小时统计预约频次(热力图)
- 识别高峰时段和空闲时段
3. **设施对比**
- 多设施使用率对比(柱状图)
- 最受欢迎设施排行
---
#### 6.4 市集数据分析
**功能列表**:
1. **申摊数据总览**
- 总申请数(今日/本周/本月)
- 审核通过率
- 中签率
- 支付完成率
2. **热门标签分析**
- 标签使用频次排行(Top 20)
- 标签趋势变化
3. **场次数据对比**
- 各场次申请人数对比
- 各场次收入对比
---
#### 6.5 报表导出
**功能列表**:
1. **自动报表生成**
- 每日数据报表(用户、收入、订单)
- 每周数据报表
- 每月数据报表
2. **自定义报表**
- 选择数据维度(用户/订单/设施/市集)
- 选择时间范围
- 选择导出格式(Excel/PDF)
- 定时发送报表至邮箱(可选)
---
### 七、财务管理模块
#### 7.1 支付记录管理
**功能列表**:
1. **支付流水查询**
- 展示所有支付记录(订单号、用户、金额、支付方式、支付时间)
- 按支付方式筛选(微信支付)
- 按业务类型筛选(设施预约/摊位支付)
- 按时间范围筛选
- 导出流水(Excel格式)
2. **对账功能**
- 按日期对账(平台记录与微信支付记录比对)
- 标记对账异常
- 异常记录追踪
**数据字段**:
- 支付记录: ID、订单号、业务类型、用户ID、支付金额、支付方式、微信交易号、支付时间、对账状态
---
#### 7.2 退款管理
**功能列表**:
1. **退款申请列表**
- 展示所有退款申请(订单号、用户、退款金额、申请时间、处理状态)
- 按处理状态筛选(待处理/已退款/已拒绝)
- 按业务类型筛选
2. **退款处理**
- 查看退款详情(订单信息、退款原因、用户信息)
- 全额退款
- 部分退款(输入退款金额)
- 拒绝退款(填写拒绝原因)
- 调用微信支付接口执行退款
3. **退款记录**
- 已退款记录查询
- 退款统计(今日/本周/本月退款总额)
- 导出退款记录
**数据字段**:
- 退款申请: ID、订单ID、用户ID、退款金额、退款原因、申请时间、处理状态、处理人、处理时间、微信退款单号
---
### 八、通知推送系统
#### 8.1 消息模板管理
**功能列表**:
1. **预设模板类型**
- 审核通知(卡片审核通过/驳回)
- 抽签通知(中签/未中签)
- 支付提醒(订单待支付、支付成功)
- 预约提醒(预约开始前1小时提醒)
- 系统通知(维护通知、规则变更)
2. **模板编辑**
- 编辑模板文案(支持变量占位符,如:{{用户昵称}}、{{场次日期}})
- 预览模板效果
- 启用/停用模板
3. **模板列表**
- 展示所有模板(模板名称、类型、状态、更新时间)
- 搜索模板
**数据字段**:
- 消息模板: ID、模板名称、模板类型、模板内容、状态、创建时间、更新时间
---
#### 8.2 推送记录查看
**功能列表**:
1. **推送记录列表**
- 展示所有推送记录(接收人、模板类型、发送时间、发送状态)
- 按模板类型筛选
- 按发送状态筛选(成功/失败)
- 按时间范围筛选
2. **推送详情**
- 查看推送内容
- 查看发送结果(送达状态、错误信息)
3. **推送统计**
- 今日/本周/本月推送总数
- 推送成功率
- 按模板类型统计推送量
**数据字段**:
- 推送记录: ID、用户ID、模板ID、推送内容、推送渠道(小程序/短信)、发送时间、发送状态、错误信息
---
#### 8.3 推送配置
**功能列表**:
1. **小程序推送配置**
- 配置小程序订阅消息模板ID
- 测试推送功能
2. **短信推送配置**
- 配置短信接口参数
- 配置短信签名
- 测试短信发送
- 查看短信余额
---
## 🔧 技术架构
### 前端技术栈
- 框架:
- UI组件库:
- 图表库:
- 富文本编辑器:
### 后端技术栈
- 框架:
- 数据库: PostgreSQL
- 缓存:
- 对象存储:
### 第三方服务
- 微信小程序API
- 微信支付API
- 实名认证API
- 短信服务:
---