页面质量 Gate:ready 不写数据库 不调用飞书 不 refresh snapshot 不改后端

HRMS 人类可用页面标准

这个页面用来规定 HRMS 后续所有页面必须达到的最低体验质量:业务负责人和 HR 不需要懂 JSON、schema、endpoint 或任务包名,也能知道页面能做什么、现在卡在哪、下一步怎么走。

当前状态

标准已建立,后续页面必须过 checklist。

下一步动作

新页面开发前先套用页面结构模板;提交前按 100 分 checklist 验收。

不能做什么

不能用纯 JSON、技术报告或任务包名页面冒充产品页。

质量底线

85 分以下不得进入业务验收。

每个页面必须回答的 6 个问题

1. 这个页面给谁用?
2. 用户今天能完成什么?
3. 当前状态是什么?
4. 下一步动作是什么?
5. 什么不能做?
6. 是否写库、调用飞书、产生正式结论?

Human Usable Page Checklist

检查项验收标准分值
页面标题是业务语言必须通过8
首屏说明页面用来做什么必须通过8
当前状态清楚可见必须通过8
下一步动作清楚可见必须通过8
不能做什么清楚可见必须通过8
写库 / 飞书 / business effective 状态可见必须通过8
主操作不超过 1-2 个必须通过7
空 / 错 / 等待状态有说明必须通过7
英文 technical key 有中文解释必须通过7
危险操作 gated必须通过8
敏感字段默认脱敏或隐藏必须通过8
0 技术背景 HR 可理解必须通过8
桌面 / 移动基础可读建议通过7

页面结构模板

首屏

业务标题、一句话用途、当前状态、安全边界。

业务流程

展示用户从入口到输出的步骤,当前步骤高亮。

操作区

最多 1-2 个主操作,危险操作必须 gated。

证据区

JSON、报告、URL、验收命令放这里,不放首屏压人。

按钮状态规范

状态中文表达什么时候用
clickable可点击当前条件满足,用户点击后会执行明确动作。
disabled不可用条件不足,按钮不可点击,并显示原因。
gated需要 Gate危险或真实写入动作,需要单独审批。
preview_only仅预览只生成预览,不写库、不生效。
requires_approval待批准负责人或管理员批准后才能进入下一步。

好页面 / 坏页面

坏页面

  • 标题是任务包名。
  • 首屏只有 JSON 链接。
  • 按钮叫 execute,没有说明影响范围。
  • 用户不知道是否会写库或反写飞书。

好页面

  • 标题是业务动作。
  • 首屏说明用途、状态、下一步。
  • 主按钮文案明确,例如“生成只读快照试跑”。
  • 清楚标注不写主数据、不反写飞书。

敏感信息展示规范

真实员工姓名、手机号、邮箱、open_id、union_id、user_id、token、secret、DATABASE_URL 等默认不得在 public 页面和 JSON 中明文展示。需要展示时必须按权限、场景和脱敏规则处理。

业务 runthrough 必填

每个业务纵切页面必须写清楚:角色、业务目标、入口 URL、输入数据、主操作、输出、数据落点、是否写库、是否调用飞书、是否 business effective、approval gate、rollback path 和验收 URL。