帮助请求

帮助请求是 Aptli 内置的问题与支持跟踪系统。任何用户均可直接从记录详情页提交帮助请求——请求会自动附加到该记录，因此请求内容永远不会产生歧义。管理员通过管理面板管理请求队列。

谁会使用帮助请求

提交帮助请求（从任意记录）

每条记录的详情页（/[entity]/[id]）的页面头部都有一个寻求帮助按钮——请查找 badge-help 图标。这包括项目、报告、任务、工单、验证、站点、资源和库存项。

步骤：

1. 打开任意记录的详情页（例如任务、工单或用户档案）
2. 点击页面头部的寻求帮助
3. 右侧滑出面板打开——记录已作为目标自动附加（在"关于"字段中显示为只读标签）
4. 填写以下字段：
   • 标题 (必填) — 简短且清晰的问题描述
   • 说明 — 复现步骤或补充背景信息
   • 目标角色 — 应处理此问题的团队（可搜索的下拉列表；可选——留空则由任意管理员处理）
   • 紧急程度 — 低 / 中 / 高 / 危急
   • 附件 — 可选的照片或文件
   • 通知目标角色 — 可选复选框，立即向目标角色发送邮件通知
5. 点击提交

系统会静默捕获当前页面的 URL，方便管理员直接跳转回您所在的页面。

无遮罩层——边写边继续工作

帮助面板以右侧滑出方式打开，没有模态框遮罩，您仍可滚动、阅读和复制背后记录中的文字，同时填写请求说明。关闭面板后，记录的编辑内容不受影响。

相关帮助请求徽章

每条支持帮助请求的记录，在寻求帮助按钮旁都会显示一个聚合帮助请求徽章，用于一目了然地汇总针对该记录的未解决请求数量。

• 灰色 / 零 — 没有相关请求
• 彩色 / 数量 — 有一条或多条请求；悬停可查看各状态明细

点击徽章可跳转至筛选后的列表视图，范围限定为该记录。

在请求中分享记录

每个详情页还有一个分享按钮，可将短链接（例如 /help/:id）复制到剪贴板。将其粘贴到任何位置——Slack、邮件或另一条帮助请求的说明中——打开链接的人即可直接跳转到对应记录。

紧急程度等级

以数字紧急程度存储的历史请求在读取时会自动映射为新标签——无需迁移。

管理员：队列管理

导航至管理 → 帮助请求（/admin/help-requests）以查看所有已提交的请求。

筛选

• 使用顶部的筛选栏按标题或描述搜索
• 使用状态筛选器——默认显示未解决，让管理员优先看到待处理工作。其他选项：已受理、已推迟、失败、已解决
• 在右上角切换显示已删除以查看已归档请求
• 使用面板顶部的我的请求链接，仅查看您本人提交的请求

查看请求

点击任意行中的展开箭头，即可查看完整的请求详情，包括：

• 请求者邮箱及提交日期
• 附加记录（目标——以链接形式呈现）
• 上下文 URL（用户提交请求时所在的页面）
• 说明及附件
• 分配的目标角色
• 当前状态与紧急程度

更新请求

在展开视图中，管理员可以：

• 更改状态（参见下方生命周期说明）
• 重新分配目标角色
• 若初始评估有误，则调整紧急程度
• 填写解决备注、解决人和解决时间（标记为已解决时自动填充）

使用提交更改按钮（右上角的云上传图标）保存更改。更改将立即生效。

请求生命周期

open → committed（工作已开始）
     → deferred（已确认，尚未排程）
     → failed（无法解决）
     → resolved（完成——记录 resolvedAt/resolvedBy/resolutionNote）

解决请求

在展开视图中点击解决，打开解决模态框。输入概括处理结果的解决备注后确认——请求将变为 resolved 状态，并记录您的用户信息和时间戳。请求者在重新查看请求时可看到解决备注。

批量操作

使用复选框选择多行以：

• 批量删除或批量恢复请求
• 通过浮动工具栏中的设置（齿轮）按钮批量更新共享属性

安全——请求者由服务器强制设置

帮助请求的请求者在服务器端通过会话强制赋值，用户无法在提交时伪造他人的请求者身份。管理员的编辑操作不会更改原始请求者。

提示

• 从实际记录中打开面板 — 附加的目标意味着管理员永远不必问"这是关于哪条记录的？"
• 标题要具体。 "站点 S-42 的地图无法加载"比"地图问题"更具可操作性。
• 使用目标角色，当您清楚哪个团队负责处理此类问题时——这有助于管理员更快进行分类处理
• 危急请求还应通过电话或消息直接沟通——应用内请求队列并非实时警报系统
• 通知目标角色适用于需要立即通知管理团队的紧急问题
• 已解决请求保留在系统中——通过已解决（或显示已删除）筛选器可查看历史解决记录