# 阿尼坊后台管理系统功能需求文档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：
- 短信服务：

---