功能覆盖矩阵
本页把网页菜单、使用指南和验证动作对应起来。账号类型、机台状态和版本可能影响实际可见性。
| 网页入口 | 主要使用者 | 详细文档 | 最小验收 |
|---|---|---|---|
| 账号选择/登录 | 所有用户 | 快速开始、账号与 Token | 登录、验证、切换账号 |
| 账号选择页面 | 所有用户 | 账号选择与登录页面 | 登录方式、本地条目、导入导出、密码绑定 |
| 账号异常恢复 | 所有用户 | 账号异常与恢复流程 | 登录失败、Token、名称和数据归属 |
| 网页导航与会话流程 | 所有用户 | 网页完整使用流程 | 登录、切换、退出、移动端验收 |
| 移动端与 PWA | 所有用户 | 移动端、浏览器与 PWA | 菜单、二维码、文件、主题和网络切换 |
| 网页页面控件目录 | 所有用户/管理员 | 网页页面控件总目录 | 按页面核对按钮、输入和状态 |
| 网页可见功能全表 | 所有用户/开发者 | 网页可见功能全表 | 账号、数据、机台、内容和 API 入口总览 |
| 网页状态与时序 | 所有用户/开发者 | 网页状态与操作时序矩阵 | 加载、空数据、保存、超时和重试 |
| 主页 | 所有用户 | 主页统计 | 统计可加载、地区可展开 |
| 主页仪表盘 | 所有用户 | 主页仪表盘逐项说明 | 卡片、折叠区、聚合数据和安全提示 |
| 获取访问码 | 用户/机台账号 | 二维码与访问码 | 生成、复制、再次登录 |
| 访问码页面控件 | 用户/机台账号 | 访问码页面逐项控件参考 | 通知、感应、标签、绑定、识别和清理 |
| 访问码页面完整控件 | 用户/机台账号 | 访问码页面逐项完整参考 | 访问码、二维码、NFC、领取、绑定、验证、错误和回归 |
| 配方 | 用户/机台账号 | 配方与机台设置、配方字段详解 | 读取、修改一项、重新加载 |
| 配方编辑器 | 用户/机台账号 | 配方编辑器逐步使用 | 卡片、值类型、图片、JSON和保存 |
| 配方页面控件参考 | 用户/机台账号 | 配方页面控件与可见字段类型参考 | 输入类型、卡片状态、上传和单项保存 |
| 机台侧扩展设置 | 机台账号/维护人员 | 机台侧扩展设置 | 启动、输入、画面、音频、硬件、测试和网页联动 |
| 数据缓存 | 用户账号 | 缓存与离线恢复 | 下载 JSON、预览、恢复 |
| 普通缓存控件 | 用户账号 | 普通缓存页面逐项控件参考 | 备份、格式、文件选择、预览、恢复和回显 |
| 普通缓存完整控件 | 用户账号 | 普通缓存页面逐项完整参考 | 下载格式、文件解析、恢复状态、账号切换和回归 |
| 数据生命周期 | 所有用户/开发者 | 数据生命周期与页面对应关系 | 产生、上传、索引、备份和删除 |
| 上传缓存 | 用户账号 | 缓存与离线恢复、上传缓存 API | 列表、上传、下载、删除 |
| 上传缓存页面 | 用户账号 | 上传缓存页面 | 字段、状态、快照和失败重试 |
| 上传缓存控件 | 用户账号 | 上传缓存页面逐项控件参考 | 访问码、地址、下载、上传、删除和回读 |
| 访问码/缓存控件参考 | 用户/机台账号 | 访问码、二维码与缓存页面控件参考 | 登录方式、图片识别、备份、恢复和上传缓存 |
| 相片 | 用户账号 | 相片、记录与成绩 | 刷新、查看、下载、删除 |
| 相片页面 | 用户账号 | 相片页面 | 缩略图、原图、缓存和删除 |
| 相片实战流程 | 用户账号 | 相片页面实战流程 | 列表、预览、下载、删除和切换账号 |
| 游玩记录 | 用户账号 | 相片、记录与成绩、游玩记录 API | 分页、跳页、刷新 |
| 游玩记录页面 | 用户账号 | 游玩记录页面 | 卡片展开、判定、分页和隐私 |
| 游玩记录字段参考 | 用户账号 | 游玩记录页面字段与分页参考 | 字段、详情、时间、分页和空状态 |
| 游玩记录页面完整控件 | 用户账号 | 游玩记录页面逐项完整参考 | 加载、卡片、判定、Rating、店铺、对战、分页和隐私 |
| 乐曲成绩 | 用户/审核账号 | 乐曲成绩页面 | 搜索、排序、评论、反馈 |
| 成绩页面控件参考 | 用户/审核账号 | 成绩页面控件与数据字段参考 | 卡片、排序、评论、反馈、审核和分页 |
| 成绩页面完整控件 | 用户/审核账号 | 成绩页面逐项完整参考 | 搜索、排序、详情、评论、举报、审核队列、历史和分页 |
| 乐曲成绩互动 | 用户/审核账号 | 乐曲成绩互动页面 | 筛选、互动、反馈和审核 |
| 成绩互动实战 | 用户/审核账号 | 成绩页面与互动实战流程 | 搜索、评论、反馈、审核和隐私 |
| 查卡 | 机台账号 | 查卡与会话统计 | 单机台、多机台、自动刷新 |
| 查卡页面 | 机台账号 | 查卡页面逐项说明 | 选择、合并、图表、会话摘要 |
| 查卡页面完整控件 | 机台账号 | 查卡与机台统计页面完整参考 | 单/多机台、自动刷新、在线、时段、会话和频率 |
| 统计指标解释 | 机台账号 | 查卡与机台统计指标解释 | 在线、时间段、时长、频率和合并 |
| 机台管理 | 机台账号 | 机台管理员指南 | 健康、配置、状态刷新 |
| 控制面板 | 有权限的机台账号 | 机台控制项详解 | 单项操作、结果、取消 |
| 控制卡片/弹窗逐项参考 | 有权限的机台账号 | 机台控制卡片与弹窗逐项参考 | 限速、列表、侧载、高级测试和进度 |
| 机台操作场景 | 有权限的机台账号 | 机台操作场景手册 | 截图、网络、侧载、订单、重启和直播 |
| 机台页面完整目录 | 有权限的机台账号 | 机台管理页面完整控件目录 | 健康、订单、显示、授权、维护和状态 |
| 机台页面逐项完整参考 | 有权限的机台账号 | 机台管理页面逐项完整参考 | 全部健康字段、控制卡片、弹窗、轮询、解锁和回归 |
| 控制弹窗与输入项 | 有权限的机台账号 | 机台管理弹窗与输入项 | 范围、字段、校验、保存和验收 |
| 自定义订单 | 有权限的机台账号 | 订单与 VHDX 配置 | JSON、订单选择、进度 |
| VHDX 字段行为 | 有权限的机台账号 | VHDX 订单字段与编辑器行为参考 | 字段类型、输入规范化、映射、保存和验收 |
| VHDX 场景化操作 | 有权限的机台账号 | VHDX 订单场景化操作手册 | 空配置、多安装项、可选项、时间、校验、挂载、启动和回滚 |
| 自定义订单编辑器 | 有权限的机台账号 | 自定义订单编辑器 | 表单、示例、安装项、映射和 JSON 保存 |
| 自定义订单字段矩阵 | 有权限的机台账号/维护人员 | 自定义订单字段与控件矩阵 | 每个输入、默认值、类型、联动、风险和测试用例 |
| 订单恢复排障 | 有权限的机台账号 | 订单下载、安装与回滚排障 | 生命周期、下载、Hash、VHDX、分支和回滚 |
| 测试内容 | 获授权账号 | 测试内容与谱面浏览 | 搜索、详情、下载确认 |
| 测试内容页面完整控件 | 获授权账号/内容提交者 | 测试内容页面逐项完整参考 | 索引、懒加载、详情、难度、下载、申请和发布验收 |
| 测试计划页面 | 获授权账号 | 测试内容计划页面逐项参考 | 申请、联系方式、协议、分支和提交 |
| 内容发布验收 | 内容提交者/维护人员 | 测试内容发布与机台可见性 | 提交、审核、分支、订单和现场验收 |
| 已弃用特殊入口 | 管理员明确要求时 | 已弃用的特殊入口 | 输入校验、结果记录、登录复核 |
| 网页内 API 参考 | 开发者/机台账号 | 公开 API 工作流示例 | 登录、读取、写入、失败处理 |
| 网页内 API 页面 | 开发者 | 网页内 API 参考页面逐项说明 | 分类、参数、响应树、复制和兼容性 |
| 网页内 API 页面完整参考 | 开发者 | 网页内 API 参考页面完整参考 | 请求表、响应树、文件接口、弃用、错误和回归 |
| 全量公开接口 | 开发者 | 公开接口总参考 | 接口索引、权限、返回类型和重试 |
| SDK 集成 | 开发者 | SDK 集成手册 | TypeScript/Python、状态机、分页和测试 |
| 游玩记录字段 | 开发者 | 游玩记录字段深度参考 | 身份、成绩、判定、模式和隐私 |
| 成绩互动字段 | 开发者/审核账号 | 成绩互动字段深度参考 | 摘要、评论树、反馈和审核历史 |
| 查卡字段 | 开发者/机台账号 | 查卡字段深度参考 | 在线、时段、会话、频率和合并 |
| API 错误处理 | 开发者 | API 错误模型与重试 | HTTP、业务字段、退避和写入超时 |
| API 分页文件 | 开发者 | 分页、范围与文件接口 | 范围、去重、二进制和导出 |
| API 兼容性 | 开发者 | API 兼容性与版本迁移 | 未知字段、版本、迁移和回滚 |
| API 隐私 | 开发者/管理员 | API 数据最小化与日志安全 | 脱敏、存储、分享和泄露处理 |
| API 测试 | 开发者 | 公开 API 客户端测试 | 夹具、不变量、工作流和浏览器回归 |
| FAQ | 所有用户 | 常见问题 | 按现象检索处理步骤 |
| 聊天经验 FAQ | 所有用户/管理员 | 聊天记录整理 FAQ | 安装、更新、登录、缓存和现场问题 |
| 聊天经验到页面索引 | 所有用户/管理员 | 聊天经验与对应文档索引 | 将 Q1–Q56 直接映射到安装、缓存、机台、订单、内容和排障页面 |
| 更新/恢复 | 管理员 | 更新通道与提交、恢复与回滚 | 备份、更新、回滚 |
| 现场维护 | 管理员/维护人员 | 现场维护运行手册 | 授权、安装、网络、更新、验收、回滚 |
| 维护记录 | 管理员/维护人员 | 现场维护记录簿 | 变更、回读、验收、交接和敏感信息 |
| 回滚决策 | 管理员/维护人员 | 回滚决策与最小恢复路径 | 判断、介质、数据、回滚与关闭 |
| U 盘诊断 | 管理员/维护人员 | U 盘安装与恢复诊断 | 介质、根目录、启动、卡住和回滚 |
| 网络诊断 | 管理员/维护人员 | 网络接入与分层诊断 | 链路、健康、HTTP/TCP、会话和反馈 |
| 安装后验收 | 管理员/维护人员 | 安装后的完整验收清单 | 启动、网络、账号、数据、内容和交付 |
| 事故处理 | 管理员/维护人员 | 现场事故处理与证据保全 | 停止条件、证据、回滚与关闭事故 |
如何判断页面缺少文档
如果页面出现新的按钮、字段或弹窗：
- 先在本矩阵中找对应入口；
- 打开对应详细页面搜索按钮原文；
- 如果只有概述没有字段/风险/验收步骤，应补充该页面章节；
- 涉及写入、删除、网络、订单或机台重启的功能必须补充回滚说明。
权限与可见性
- 普通用户不应看到机台控制项；
- 机台账号可见的字段不等于普通用户可调用；
- 审核入口只对明确授权的账号显示；
- 测试内容入口可能按账号或计划状态隐藏；
- 404、隐藏菜单和空数据要分别判断，不能混为一个错误。