主题
声音导览系统 · 需求说明书
版本：V1.0 · 日期：2026-08-08 · 用途：需求确认
阅读指引：第一章说明系统做什么、数据怎么组织、本期边界在哪；第二章用流程图说明用户怎么走完一件事；第三、四章是页面级清单，逐页说明承载哪些功能，可直接作为设计与开发的依据；第五至七章是数据看板、平台配置与非功能要求；第八章是需要贵方确认的开放问题，请重点过一遍。
一、需求汇总
1.1 系统定位
面向景区、展馆、街区、文旅地标的"扫码即听"声音导览。游客在线下点位扫二维码打开 H5 页面，看图文、听讲解，并可留言互动；平台运营人员在管理端完成内容配置、留言审核与数据运营。
价值链：
线下二维码 → 扫码打开 H5 → 看图文 + 听讲解 → 登录 → 留言 / 点赞 / 评论
↓
内容审核 → 审核通过后公开展示
↓
运营数据回流给客户1.2 系统组成
| 模块 | 使用者 | 说明 |
|---|---|---|
| ① 用户端 H5 | 终端游客 | 扫码打开的核心体验页，含 UGC 互动与个人主页 |
| ② 管理端（管控台） | 平台运营人员 | 客户 / 项目 / 地点 / 模板 / 留言 / 用户 / 数据 / 系统 |
| ③ 运营数据分享页 | 客户（只读） | 由管理端生成链接对外分享，一客户一页 |
1.3 角色定义
| 角色 | 归属 | 能做什么 |
|---|---|---|
| 游客（未登录） | 用户端 | 扫码浏览图文、收听讲解、查看他人留言 |
| 游客（已登录） | 用户端 | 在上述基础上可点赞、评论、发布留言，拥有个人主页与足迹 |
| 平台运营人员 | 管理端 | 内容配置、留言审核、用户管理、数据运营（业务数据） |
| 平台管理员 | 管理端 | 运营人员的全部权限 + 平台设置、账号管理、操作日志（非业务数据） |
| 客户 | 分享页 | 本期不登录管理端，仅通过分享链接只读查看自己的运营数据 |
1.4 数据模型
客户 Customer（组织 / 企业 / 政府）
└── 项目 Project（某个景区、某个展馆）
└── 地点 Location（一个二维码点位）
└── 绑定 1 个模板 Template（可随时切换）
└── 按资源位 code 填充：图片 / 文字 / 音频- 一个客户下有多个项目，一个项目下有多个地点。
- 每个地点绑定一个模板，模板可切换；切换后按资源位 code 重新匹配已填内容。
- 游客产生的数据（留言、足迹、点赞）挂在"地点"上，统计时逐级向上汇总到项目、客户。
1.5 模板机制
- 模板由平台预置、硬编码，不支持在管理端动态新增模板；新增模板 = 新开发 + 发版。
- 模板中可替换的部分称为资源位，每个资源位有一个语义化 code，按 code 填充内容：
| 资源类型 | 说明 | 后台需给出的约束提示 |
|---|---|---|
| 图片 | 一个模板可含多个图片位 | 建议长宽比 + 建议分辨率（如 hero_image 16:9 / 1920×1080） |
| 文字 | 一个模板可含多个文字位 | 建议字数区间（如 title 6–14 字，intro 80–200 字） |
| 音频 | 一个模板可含多个音频位 | 建议时长、格式、大小上限 |
约束提示的目的：让运营人员在填内容时就知道"填多长、传多大"，避免上线后版式被撑坏。提示为软约束（超出高亮警示但不强制拦截），保留特殊情况下的灵活度。
不做色系 / 主题色配置——配色随模板固定，不作为可替换项。理由：配色与版式强耦合，开放换色意味着每套模板都要在 N 种配色下逐一验证对比度与可读性，复杂度和测试量成倍上涨而收益有限。需要不同观感时，用换模板解决。
1.6 术语表
| 术语 | 含义 |
|---|---|
| 客户 | 采购方主体，如某文旅集团、某博物馆、某区文旅局 |
| 项目 | 客户下的一个实体场所，如"XX 古镇""XX 博物馆二期" |
| 地点 | 项目下的一个二维码点位，是游客扫码后落地的最小单元 |
| 模板 | 地点页面的版式，平台预置、代码实现，地点可切换 |
| 资源位 | 模板中可被替换的内容槽，由语义化 code 标识（如 hero_image） |
| 留言 | 游客在地点页发布的 UGC，可含图 / 文 / 音 |
| 评论 | 对某条留言的回复 |
| 热度 | 留言的排序权重，热度 = 点赞数 + 评论数 |
| 足迹 | 用户扫码到访过的地点记录 |
| 先审后显 | UGC 先经内容审核，通过后才对其他用户可见 |
1.7 本期范围边界
做： 扫码浏览（图 / 文 / 音）· 手机号验证码登录注册 · 留言（图 / 文 / 音）+ 点赞 + 评论 · 三态内容审核 + 先审后显 · 个人主页与足迹 · 自定义昵称与头像 · 留言置顶 · 模板与资源位配置 · 客户 / 项目 / 地点管理 · 二维码生成与导出 · C 端用户管理 · 管理端账号与两角色 · 操作日志 · 平台设置 · 运营数据看板与对外分享。
不做（本期）： 用户端内容的多语言（讲解词、留言不做多语种）· 模板色系 / 主题色配置 · 管理端动态新增模板 · 客户自行登录管理端 · 支付 / 电商 · 打卡集章等增值玩法 · 海外手机号（本期仅 +86）。
二、用户动线
2.1 游客主动线（扫码 → 互动）
线下扫码
│
▼
[U-01 地点详情页] ── 自动恢复登录态（有则静默登录，无则保持游客态）
│ · 看背景图 / 标题 / 图文
│ · 点「开始收听」播放讲解音频
│ · 向下滑 → 看其他游客留言（默认按热度排序）
│ · 页面最底部 → 品牌透出（文字 + 链接，弱化处理）
│
├── 点赞 / 评论 / 写留言 ──► 已登录？
│ ├─ 是 ──► 直接操作
│ └─ 否 ──► [U-02 登录浮层] 手机号 + 验证码
│ └─► 登录成功，**原地回到刚才的操作**
│
├── 写留言 ──► [U-04 留言发布页]（图 / 文 / 音）──► 提交
│ └─► 进入审核，**仅自己可见**，标"审核中"
│
├── 点留言 ──► [U-05 留言详情页] 看评论、回评论、点赞
│
└── 点右上角头像 ──► [U-06 个人主页]
· 本项目内的历史扫码足迹 → 点击回到对应地点详情
· 我的留言（含审核状态）
· 我收到的赞与回复
· 改昵称 / 换头像2.2 登录与注册动线
触发登录（点赞 / 评论 / 发留言 / 进个人主页）
│
▼
[U-02 登录浮层]
1. 输入手机号（本期仅 +86，号段校验）
2. 图形验证码校验（防刷）
3. 获取短信验证码 → 输入 6 位码
4. 勾选同意《用户协议》《隐私政策》
│
▼
后端判断手机号是否已存在
├─ 已存在 ──► 登录
└─ 不存在 ──► **自动注册**（无独立注册流程）
· 昵称：默认「游客」+ 手机号后四位
· 头像：**32 个预置头像，按手机号取模**分配
（保证新用户开局即有像样的头像，之后可自行更换或上传）
│
▼
返回登录态（跨客户、跨项目共享）→ 回到触发登录的原操作
│
└─► 同时写入「用户 × 客户 / 项目」关联关系（供客户侧运营统计）登录态规则：
- 用户元数据（手机号、昵称、头像）属于平台，全局唯一一份。
- 登录态在所有客户与项目之间共享：在 A 景区登录过，扫 B 景区的码自动是登录态。
- 同时单独维护"用户在某客户 / 某项目下的关联记录"（首次到访时间、最近到访时间、到访地点数），用于客户维度的运营统计。
2.3 内容生命周期（审核状态机）
┌──────────► 通过 approved ──► 全部用户可见（可被置顶）
│
用户提交 ─► 待审 pending ─► AI 审核 ─┼──────────► 不通过 rejected ─► 仅本人可见，
│ 显示"未通过 + 原因"，
│ 提供【编辑后重新提交】
│
└──► 待人工确认 pending_manual ─► 运营在管理端人工判定
（仅本人可见，显示"审核中"） ├─► 通过
└─► 不通过| 状态 | 本人可见 | 他人可见 | 前端呈现 |
|---|---|---|---|
| 待审 pending | ✅ | ❌ | 卡片角标「审核中」，灰度 |
| 待人工确认 pending_manual | ✅ | ❌ | 同上（对用户不区分是 AI 判不了还是排队等人工） |
| 通过 approved | ✅ | ✅ | 正常展示 |
| 不通过 rejected | ✅ | ❌ | 角标「未通过」+ 原因 + 【编辑后重新提交】按钮 |
适用范围：留言、评论、用户自定义头像与昵称，均走同一套审核与可见性规则。
审核判定顺序：内容安全 API 先筛，仅结论落在灰区的送 AI 复判；任一环节判不了则转"待人工确认"。审核服务不可用时一律转人工，绝不自动放行。
2.4 运营侧动线
[M-01 登录] 用户名 + 密码 + 4 位数字验证码
│
▼
[M-02 工作台] 看待审留言数、今日扫码数、异常提醒
│
├─ 新客户签约 ─► [M-03 客户管理] 建客户
│ └─► [M-05 项目管理] 建项目
│ └─► [M-07 地点管理] 建地点 → 选模板
│ → 按资源位 code 填图 / 文 / 音
│ → 预览 → 发布 → 生成并下载二维码
│
├─ 日常审核 ──► [M-11 留言管理] 处理"待人工确认"队列 → 通过 / 不通过（填原因）
│ └─► 优质留言【置顶】（每地点最多 3 条）
│
├─ 日常运营 ──► [M-13 用户管理] 查 C 端用户、封禁 / 解封
│ └─► [M-14 运营看板] 看统计 → 生成客户分享链接（配鉴权 + 有效期）
│ └─► 发给客户 ──► [S-01 客户数据分享页]
│
└─ 管理员专属 ─► [M-16 管理端账号] / [M-17 平台设置] / [M-18 操作日志]三、用户端页面与功能
全部为移动端 H5，微信内置浏览器与系统浏览器均需兼容。
3.1 页面清单与跳转关系
| 编号 | 页面 | 是否要登录 |
|---|---|---|
| U-01 | 地点详情页（扫码落地页） | 否（互动需登录） |
| U-02 | 登录 / 注册浮层 | — |
| U-03 | 留言列表（详情页内嵌模块） | 否 |
| U-04 | 留言发布 / 编辑页 | 是 |
| U-05 | 留言详情页（评论） | 否（互动需登录） |
| U-06 | 个人主页 | 是 |
| U-07 | 资料编辑（昵称 / 头像） | 是 |
| U-08 | 我的消息（收到的赞与回复） | 是 |
| U-09 | 全局状态与异常兜底 | — |
┌──────────────► [U-02 登录浮层]（任意需登录操作触发，就地弹出）
│
[U-01 地点详情页] ───────┼──► [U-03 留言列表]（页内模块）──► [U-05 留言详情页]
│ │ │
│ │ └──► [U-04 留言发布 / 编辑页]
│ │
└── 头像 ───────┴──► [U-06 个人主页] ──┬──► [U-07 资料编辑]
│ └──► [U-08 我的消息]
│
└── 足迹项 ──► 回到对应的 [U-01]U-01 地点详情页（扫码落地页）
系统的核心页面，游客扫码后的唯一入口。
页面结构（自上而下）：
- 顶部：返回 / 关闭、右上角头像入口（未登录显示默认灰头像，点击触发登录）
- 内容区（由模板渲染）：背景图 / 主图、标题、图文介绍（多个图片位 + 文字位）
- 音频区：「开始收听」浮层触发起播 → 播放 / 暂停、进度条拖动、当前时间 / 总时长；一个地点支持多段音频（多个音频位），可切换
- 留言区（U-03）
- 底部品牌透出：一行弱化文字 + 可点链接（如"技术支持 · XXX"），置于页面最底部，不抢内容
承载功能：
| 功能 | 说明 |
|---|---|
| 静默登录 | 页面加载时若本地登录态有效，自动完成登录，无任何打断 |
| 内容渲染 | 按地点绑定的模板 + 资源位内容渲染 |
| 音频播放 | 一次点击起播；支持多段切换、进度拖动、后台继续播放 |
| 足迹记录 | 首次进入即写入"扫码足迹"（已登录归属到人，未登录先归属到设备，登录后回补） |
| 留言入口 | 悬浮 / 底部固定的【写留言】按钮 |
| 品牌透出 | 文字 + 链接，样式弱化 |
| 分享 | 微信内分享卡片（标题 / 图 / 描述取自模板资源位） |
U-02 登录 / 注册浮层
触发时机： 点赞、评论、写留言、进个人主页，且当前未登录。以半屏浮层方式弹出，不跳走、不丢失当前上下文。
| 功能 | 说明 |
|---|---|
| 手机号输入 | 本期仅 +86，前端号段校验，区号固定展示不可选 |
| 图形验证码 | 发短信前先过图形验证码，防刷号 |
| 短信验证码 | 6 位，有效期与每日发送上限见平台设置；60 秒倒计时重发 |
| 登录即注册 | 手机号未注册则自动注册，无独立注册页 |
| 协议勾选 | 用户协议 + 隐私政策，未勾选不可提交 |
| 登录后回跳 | 登录成功后原地续做触发登录的那个操作（如自动完成刚才那次点赞），不要求用户重新点一遍 |
| 关闭 | 允许关闭浮层，退回浏览态继续看内容 |
U-03 留言列表（U-01 页内模块）
| 功能 | 说明 |
|---|---|
| 排序切换 | 默认按热度；可切换为按时间（最新在前） |
| 热度定义 | 热度 = 点赞数 + 评论数（两者权重可在平台设置中调整） |
| 置顶展示 | 被置顶的留言排在最前，带「置顶」标识，最多 3 条 |
| 留言卡片 | 头像、昵称、时间、正文、图片（多图九宫格）、语音条（时长 + 播放）、点赞数、评论数 |
| 点赞 | 点击点赞 / 取消点赞（需登录，未登录触发 U-02） |
| 进入详情 | 点击卡片进 U-05 |
| 自己的留言 | 未过审的只有自己看得到，带状态角标；未通过的带【编辑后重新提交】 |
| 分页 | 下拉刷新 + 上拉加载更多 |
| 空状态 | 无任何留言时展示友好插画 + 引导文案「来做第一个留言的人」 |
U-04 留言发布 / 编辑页
| 功能 | 说明 |
|---|---|
| 文字 | 多行输入，实时字数统计，上限见平台设置 |
| 图片 | 多图上传，数量与单图大小上限见平台设置；支持删除、排序、预览 |
| 语音 | 按住录音 / 点击录音，时长上限见平台设置；录完可试听、可重录 |
| 组合 | 图 / 文 / 音可任意组合，至少填一项 |
| 提交 | 提交后进入审核，回到列表并优先展示自己那条（标「审核中」） |
| 编辑重提 | 审核不通过的留言可进入本页编辑，重新提交后状态回到"待审" |
| 频控 | 发布频率限制（防刷屏），见平台设置 |
| 草稿保护 | 上传中 / 编辑中退出给二次确认，避免误丢 |
U-05 留言详情页
| 功能 | 说明 |
|---|---|
| 留言主体 | 完整展示图 / 文 / 音 |
| 评论列表 | 平铺展示，按时间正序；显示头像、昵称、时间、内容 |
| 发表评论 | 底部输入框（需登录）；评论同样走审核，未过审仅自己可见 |
| 点赞 | 对留言点赞 |
| 回到地点 | 顶部可跳回所属地点详情页 |
| 空状态 | 暂无评论时的友好展示 |
U-06 个人主页
入口： U-01 右上角头像。上下文：按项目隔离——展示的是当前项目下的数据。
| 区块 | 承载功能 |
|---|---|
| 资料卡 | 头像、昵称、（可选）加入时间；点击进 U-07 编辑 |
| 我的足迹 | 当前项目内的历史扫码记录：地点缩略图、名称、最近到访时间；点击跳回该地点详情页重新查看 |
| 我的留言 | 本人所有留言（含未过审），带状态；可编辑 / 删除 |
| 我收到的 | 别人对我的点赞与回复入口（进 U-08） |
| 数据小结 | 到访地点数、留言数、获赞数（轻量展示） |
| 空状态 | 刚注册无任何数据时，保持友好展示：插画 + 「去逛逛」引导按钮回到地点页，不出现空白页 |
U-07 资料编辑
| 功能 | 说明 |
|---|---|
| 修改昵称 | 支持自定义昵称；长度限制、敏感词校验、允许重名、修改频率可配 |
| 修改头像 | 支持自定义头像：① 从 32 个预置头像中挑选；② 上传自己的图片（支持裁剪为正方形），格式与大小上限见平台设置 |
| 内容审核 | 自定义昵称与上传头像属于 UGC，走内容审核：通过前对外仍展示原昵称 / 原头像，仅本人看到新的并标"审核中"；不通过则回退并提示原因 |
| 只读信息 | 手机号（脱敏展示，不可修改） |
| 退出登录 | 清除本地登录态 |
U-08 我的消息（收到的赞与回复）
| 功能 | 说明 |
|---|---|
| 收到的赞 | 谁、在哪条留言、什么时候；点击跳到对应留言 |
| 收到的回复 | 谁、回复内容、原留言摘要；点击跳到对应留言详情 |
| 已读 / 未读 | 头像入口带小红点提示 |
| 空状态 | 友好插画 + 文案 |
U-09 全局状态与异常兜底
这不是一个独立页面，而是全站统一的兜底规范，是非功能需求在用户端的落地。
| 场景 | 呈现 |
|---|---|
| 二维码无效 / 地点不存在 | 独立提示页：「该点位不存在或已下架」 |
| 地点未发布 / 已停用 | 「该点位暂未开放」 |
| 网络异常 / 接口超时 | 页面级重试按钮，不出现白屏 |
| 接口报错 | 统一 toast + 可重试；关键操作失败不吞错 |
| 前端 JS 异常 | 错误边界兜底页 + 「刷新重试」，并上报 |
| 上传失败 | 单文件失败可单独重传，不清空整条留言 |
| 音频加载失败 | 播放器区域提示 + 重试 |
| 登录态失效 | 静默降级为游客态，操作时再拉起登录浮层 |
| 加载中 | 骨架屏，不用空白 + 转圈 |
四、管理端页面与功能
本期只给平台运营人员使用，不开放给客户。PC Web。
4.1 账号与权限
| 项 | 规则 |
|---|---|
| 认证体系 | 完全独立于用户端，两套账号体系互不相通 |
| 初始账号 | 预置一个管理员账号与密码（首次登录强制改密） |
| 新建账号 | 指定用户名 → 系统自动生成随机密码，仅展示一次（可复制） |
| 重置密码 | 管理员可重置 → 再随机生成一个，仍仅展示一次 |
| 登录校验 | 用户名 + 密码 + 4 位数字图形验证码 |
| 角色 | 管理员 / 运营人员（本期不做细粒度权限，同角色内不再分级） |
| 管理员 | 可查看和操作所有数据（业务数据 + 非业务数据） |
| 运营人员 | 只能操作业务数据；不可进入平台设置、账号管理、操作日志 |
| 业务数据 | 客户、项目、地点、模板配置、留言、C 端用户、运营数据 |
| 非业务数据 | 平台设置、管理端账号、操作日志 |
4.2 页面清单与导航结构
管理端
├── 工作台 M-02
├── 业务管理
│ ├── 客户管理 M-03 / M-04
│ ├── 项目管理 M-05 / M-06
│ ├── 地点管理 M-07 / M-08 / M-09 / M-10
│ ├── 留言管理 M-11
│ ├── 模板管理 M-12
│ └── 用户管理 M-13
├── 数据运营
│ ├── 运营数据看板 M-14
│ └── 分享链接管理 M-15
└── 系统（仅管理员）
├── 账号管理 M-16
├── 平台设置 M-17
└── 操作日志 M-18| 编号 | 页面 | 管理员 | 运营人员 |
|---|---|---|---|
| M-01 | 登录页 | ✅ | ✅ |
| M-02 | 工作台（首页） | ✅ | ✅ |
| M-03 | 客户列表 | ✅ | ✅ |
| M-04 | 客户详情 / 编辑 | ✅ | ✅ |
| M-05 | 项目列表 | ✅ | ✅ |
| M-06 | 项目详情 / 编辑 | ✅ | ✅ |
| M-07 | 地点列表 | ✅ | ✅ |
| M-08 | 地点编辑（模板与资源位配置） | ✅ | ✅ |
| M-09 | 地点预览 | ✅ | ✅ |
| M-10 | 二维码管理 | ✅ | ✅ |
| M-11 | 留言管理 / 审核 | ✅ | ✅ |
| M-12 | 模板管理 | ✅ | ✅ |
| M-13 | C 端用户管理 | ✅ | ✅ |
| M-14 | 运营数据看板 | ✅ | ✅ |
| M-15 | 分享链接管理 | ✅ | ✅ |
| M-16 | 管理端账号管理 | ✅ | ❌ |
| M-17 | 平台设置 | ✅ | ❌ |
| M-18 | 操作日志 | ✅ | ❌ |
M-01 登录页
用户名、密码、4 位数字验证码、登录；密码错误计数与锁定（次数与时长见平台设置）；无自助注册、无自助找回密码（由管理员重置）。
M-02 工作台（首页）
| 区块 | 内容 |
|---|---|
| 待办 | 待人工确认的内容数（可直接点进 M-11）、待审总量 |
| 今日概览 | 今日扫码数、今日新增用户、今日留言数 |
| 趋势 | 近 7 / 30 天扫码与留言趋势 |
| 快捷入口 | 新建客户 / 新建地点 / 去审核 |
| 异常提醒 | 上传失败、审核服务异常、短信通道余量告警等 |
M-03 客户列表
搜索（名称）、状态筛选（启用 / 停用）、分页；列：客户名称、联系人、项目数、地点数、累计扫码、状态、创建时间；操作：查看、编辑、停用 / 启用、进入其项目列表、生成分享链接。
M-04 客户详情 / 编辑
| 字段组 | 内容 |
|---|---|
| 基本信息 | 客户名称、简称 / 客户码、类型（组织 / 企业 / 政府）、Logo |
| 联系信息 | 联系人、电话、邮箱、备注 |
| 状态 | 启用 / 停用（停用后其下所有地点页对外不可访问） |
| 关联视图 | 该客户下的项目列表、数据概览、分享链接状态 |
M-05 项目列表
搜索、筛选（所属客户、状态）；列：项目名称、所属客户、地点数、扫码量、留言数、状态、创建时间；操作：编辑、停用 / 启用、进入地点列表。
M-06 项目详情 / 编辑
项目名称、项目码、所属客户、简介、封面图、开放状态；关联视图：地点列表、项目维度数据概览。
M-07 地点列表
按客户 / 项目筛选；列：地点名称、地点码、所属项目 / 客户、当前模板、发布状态（草稿 / 已发布 / 已下架）、扫码量、留言数、更新时间；操作：编辑、预览、发布 / 下架、复制（快速建同类地点）、下载二维码、查看该地点留言。
M-08 地点编辑（核心配置页）
| 区块 | 承载功能 |
|---|---|
| 基本信息 | 地点名称、地点码（用于二维码 URL）、所属项目、排序、简介 |
| 模板选择 | 从平台预置模板中选择，缩略图预览；可随时切换，切换时按 code 保留已填内容，并提示哪些资源位需要补填 |
| 资源位填充 | 按模板定义的资源位列表逐项填写，每项显示 code + 约束提示： · 图片位：显示建议长宽比 + 建议分辨率，上传后不符给提示（不强制拦截） · 文字位：显示建议字数区间，实时字数统计，超出高亮 · 音频位：显示建议时长 / 格式 / 大小上限，上传后可试听 |
| 素材上传 | 支持替换、删除、重新上传；大文件上传进度与失败重传 |
| 实时预览 | 右侧手机壳内实时预览（或跳 M-09） |
| 保存 / 发布 | 草稿保存、发布上线、下架 |
M-09 地点预览
在手机尺寸容器中还原用户端真实渲染效果；可生成预览链接 / 预览二维码（带时效），供内部或客户在正式发布前确认内容。
M-10 二维码管理
按地点生成二维码；支持自定义尺寸与容错级别、附加地点名称文字；单个下载与批量导出（PNG / SVG / 打印用 PDF）；展示每个二维码对应的落地 URL 与累计扫码量。
M-11 留言管理 / 审核
| 功能 | 说明 |
|---|---|
| 队列切换 | 待人工确认 / 待审 / 已通过 / 未通过 / 全部 |
| 筛选 | 按客户 / 项目 / 地点、内容类型（图 / 文 / 音）、时间范围、用户 |
| 列表列 | 用户、内容摘要、类型、所属地点、机审结论与命中原因、状态、点赞数、评论数、提交时间 |
| 审核操作 | 通过 / 不通过（必须填原因，原因会展示给用户）；支持批量通过 |
| 语音处理 | 语音留言展示转写文本 + 可试听 |
| 置顶 | 对已通过留言置顶 / 取消置顶，每个地点最多 3 条，超出时提示需先取消其中一条 |
| 删除 | 违规内容删除（软删除，可在操作日志追溯） |
| 审核对象范围 | 留言、评论、用户自定义头像与昵称共用同一队列，按类型区分与筛选 |
| 用户跳转 | 点用户可跳到 M-13 该用户详情，必要时封禁 |
M-12 模板管理
模板本身由代码实现，本页面为只读 + 轻量维护。
| 功能 | 说明 |
|---|---|
| 模板列表 | 模板名称、编号、缩略图、适用场景说明、资源位清单（code / 类型 / 约束）、被引用的地点数 |
| 模板详情 | 完整资源位定义与预览；供运营人员在选模板前对照 |
| 上下架 | 可将某模板停用（不影响已使用它的地点，仅不再出现在可选列表） |
| 新增模板 | 不支持在线新增；页面明确提示"新增模板需开发发版" |
M-13 C 端用户管理
| 功能 | 说明 |
|---|---|
| 列表 | 用户 ID、头像、昵称、手机号（脱敏，管理员可查看完整）、注册时间、最近活跃、留言数、获赞数、状态 |
| 筛选 | 按客户 / 项目（基于"用户 × 客户 / 项目"关联关系）、注册时间、活跃时间、状态 |
| 用户详情 | 基本信息、到访过的客户 / 项目 / 地点列表、留言列表、互动记录 |
| 操作 | 封禁 / 解封（封禁后不可登录与互动）、重置违规昵称 / 头像为系统默认值 |
| 导出 | 按筛选条件导出（脱敏） |
M-14 运营数据看板
详见 第五章。
M-15 分享链接管理
| 功能 | 说明 |
|---|---|
| 链接列表 | 所属客户、链接、创建人、创建时间、有效期、是否鉴权、访问次数、状态 |
| 新建 / 编辑 | 选客户 → 配置是否鉴权、访问码 code（可自动生成）、有效期（7 天 / 30 天 / 永久 / 自定义到期时间） |
| 操作 | 复制链接、重置 code、立即失效、延长有效期 |
| 访问记录 | 访问时间、IP、校验通过 / 失败（便于排查客户反馈"打不开"） |
M-16 管理端账号管理（仅管理员）
新建账号（指定用户名 → 随机密码仅展示一次）、重置密码（再随机、仍仅一次）、启用 / 停用、角色分配（管理员 / 运营人员）、查看最近登录时间与 IP。
M-17 平台设置（仅管理员）
详见 第六章。
M-18 操作日志（仅管理员）
| 功能 | 说明 |
|---|---|
| 记录范围 | 管理端用户的关键修改动作：登录 / 登出、客户与项目与地点的增删改、发布 / 下架、模板与资源位变更、内容审核与置顶与删除、C 端用户封禁、分享链接创建与失效、平台设置变更、账号新建与重置密码 |
| 字段 | 操作人、角色、时间、IP、动作类型、对象类型与名称、变更前后摘要、结果（成功 / 失败） |
| 筛选 | 按操作人、动作类型、对象、时间范围 |
| 导出 | 按条件导出 |
| 不可篡改 | 日志只增不改不删 |
五、运营数据看板与对外分享
5.1 使用方式
- M-14 运营数据看板：平台运营人员内部使用，可跨客户查看，可切换客户 / 项目 / 地点与时间范围。
- S-01 客户数据分享页：一个客户一个页面，内容 = 该客户名下全部项目的运营数据，只读，无法导航到其他客户。由 M-15 生成链接后分享给客户。
5.2 统计维度
通用筛选： 时间范围（今日 / 近 7 天 / 近 30 天 / 自定义）、项目、地点。
| 分组 | 指标 |
|---|---|
| ① 概览卡 | 累计扫码次数、独立访客数（UV）、累计注册用户数、累计留言数、累计点赞数、平均单次停留时长 |
| ② 趋势 | 按日 / 周 / 月的扫码量、UV、新增用户、留言量折线；同比 / 环比 |
| ③ 地点排行 | 各地点的扫码量、UV、留言数、音频播放次数排行榜（Top / Bottom 各 10；Bottom 用于发现冷门点位，是客户最关心的运营抓手之一） |
| ④ 内容表现 | 音频播放次数、起播率（进入页面后点了播放的比例）、平均收听时长、完播率、流失分布（按秒段分桶，看游客在第几分钟离开） |
| ⑤ 用户行为 | 新增 / 活跃用户、复访率、人均到访地点数分布、登录转化率（浏览 → 登录）、互动转化率（浏览 → 留言 / 点赞） |
| ⑥ UGC 表现 | 留言提交量、审核通过率、图 / 文 / 音类型占比、留言互动量（点赞 + 评论）、热门留言 Top 10 |
| ⑦ 时段分布 | 24 小时热力图、周一至周日分布（客户排班与讲解资源投放的直接依据） |
| ⑧ 来源与终端 | 微信内 / 系统浏览器占比、iOS / Android 占比、分享带来的二次访问量 |
交互能力： 图表下钻（点趋势中的某天 → 看当天各地点明细）、导出（Excel / 图片）、指标口径说明 tooltip（避免客户误读数据）。
5.3 分享页鉴权
| 配置项 | 说明 |
|---|---|
| 是否鉴权 | 开 / 关。关闭时链接可直接打开 |
| 鉴权方式 | 访问码 code：打开页面先输入 code，校验通过后进入 |
| 有效期 | 支持设定到期时间；到期后页面提示"链接已过期，请联系对接人" |
| 失效控制 | 平台侧可随时立即失效、重置 code |
| 访问记录 | 记录访问时间与校验结果 |
六、平台设置
以下为建议的可配置项清单与默认值。请勾选实际需要做成可配的项——其余写死在代码中即可，能明显降低开发与测试成本。
| 分组 | 配置项 | 建议默认值 |
|---|---|---|
| 短信与登录 | 验证码有效期 | 5 分钟 |
| 同一手机号每日验证码上限 | 10 条 | |
| 重发间隔 | 60 秒 | |
| 单 IP 每小时发送上限 | 20 条 | |
| 用户登录态有效期（免重复登录） | 30 天 | |
| 短信签名 / 模板 | 按备案后配置 | |
| 留言规则 | 单条留言文字上限 | 500 字 |
| 单条留言图片数量上限 | 9 张 | |
| 单图大小上限 | 10 MB | |
| 语音留言时长上限 | 60 秒 | |
| 发布频率限制 | 60 秒 1 条 / 每日 20 条 | |
| 是否允许用户删除自己的留言 | 允许 | |
| 资料规则 | 昵称长度上限 | 12 字 |
| 昵称修改频率 | 不限 | |
| 自定义头像单图大小上限 | 5 MB | |
| 自定义头像 / 昵称是否需审核 | 需要 | |
| 预置头像数量（注册默认分配用） | 32 | |
| 审核 | 机器审核开关 | 开 |
| 灰区阈值（送人工的置信度区间） | 按实际效果调 | |
| 审核服务异常时的兜底策略 | 转人工，不自动通过 | |
| 自定义敏感词库 | 可增删 | |
| 审核不通过原因模板 | 预置若干条，可增删 | |
| 展示与排序 | 热度公式权重（点赞 / 评论） | 1 : 1 |
| 单地点置顶上限 | 3 条 | |
| 留言默认排序 | 热度 | |
| 品牌透出文案与链接 | 可配 | |
| 平台默认语言（中 / 英） | 中文 | |
| 分享页 | 默认是否鉴权 | 开 |
| 默认有效期 | 30 天 | |
| 访问码长度 | 6 位 | |
| 安全与运维 | 管理端登录失败锁定次数 / 时长 | 5 次 / 30 分钟 |
| 管理端会话超时 | 8 小时 | |
| 媒体链接签名有效期 | 12 小时 | |
| 全站维护模式开关 + 公告文案 | 关 |
七、非功能需求
| 类别 | 要求 |
|---|---|
| 模板可扩展性 | 模板做成可通过高代码方式快速新增的结构：一套模板 = 一个前端组件 + 一份资源位声明（code / 类型 / 约束）。新增模板只需新增组件与声明并发版，不改动地点、内容、审核等任何既有逻辑与数据，已上线地点不受影响 |
| 异常处理（前端） | 全局错误边界；接口失败统一提示 + 可重试；上传失败支持单文件重传；加载态用骨架屏；任何情况下不出现白屏；关键异常上报 |
| 异常处理（后端） | 统一错误码与错误信息规范；第三方依赖（短信 / 内容审核 / 对象存储）失败有降级与重试策略；审核服务不可用时转人工，绝不自动放行 |
| 性能 | H5 首屏秒开；音频边下边播；支持景区高峰并发 |
| 兼容性 | iOS / Android，微信内置浏览器 + 系统浏览器 |
| 多语言 | 不做内容多语言（讲解词、留言为单一语种）；平台自身界面文案支持中 / 英切换（按钮、提示、空状态、错误信息等） |
| 安全 | 用户端与管理端认证体系隔离；手机号等敏感信息脱敏展示；管理端操作全量留痕；C 端接口做频控与防刷 |
| 合规 | UGC 先审后显；用户协议与隐私政策；ICP 备案；本期仅 +86 用户，不涉及数据出境 |
八、待确认事项
| # | 事项 | 说明与建议 |
|---|---|---|
| Q1 | 二维码 URL 结构（优先级最高） | 二维码一旦印刷投放，URL 结构就无法再改——改了等于已印的码全部作废。建议采用 /s/{地点码}：地点码全局唯一，与"客户 / 项目 / 地点"的层级结构解耦，将来即使调整层级或客户改名，已印刷的二维码依然有效。此项须在印刷任何二维码之前定稿。 |
| Q2 | 音频起播方式 | iOS Safari 与微信浏览器禁止无用户手势的自动播放，"扫码即自动出声"在真机上做不到。方案为进页面后展示「开始收听」浮层，一次点击起播。请知悉并确认。 |
| Q3 | 置顶的维度 | 本文按每个地点最多 3 条设计。若期望是"每个项目 3 条"请指出——两者的运营含义差别较大。 |
| Q4 | 个人主页足迹的隔离粒度 | 本文按只展示当前项目内的足迹设计。即用户在其他项目扫过的码，在当前项目的个人主页中不展示。请确认符合预期。 |
| Q5 | 自定义头像 / 昵称的审核口径 | 本文按先审后显处理：审核期间其他人看到的仍是旧头像 / 旧昵称。若希望改成"先展示、事后抽查"，体验更顺畅但会有违规内容的暴露窗口，需贵方权衡后决定。 |
| Q6 | 评论是否同样先审后显 | 本文按"评论与留言同规则"设计。若预期评论量较大，需一并评估人工审核的人力投入。 |
| Q7 | 模板数量与规模 | 本期预置几套模板？每套的资源位规模（几张图 / 几段文字 / 几段音频）？这两项直接决定工作量与报价，需在开发前明确。 |
| Q8 | 平台设置的可配范围 | 第六章为建议清单，请勾选实际需要做成可配的项，其余写死以降低成本。 |
| Q9 | 内容多语言 | 本期不含讲解内容的多语种（仅平台界面支持中 / 英）。如后续需要多语种文案与配音，需单独评估工作量。 |
| Q10 | 规模预估 | 首期客户数量、项目数量、地点总数、预计日均访问量——用于容量规划与带宽 / 存储成本测算。 |