jiapuapp/docs/superpowers/specs/2026-07-19-r01-people-directory-baseline-design.md

R01 人物录基准页返工设计

目标

将 R01“人物录”重做为 R 模块视觉基准：移除通用申请状态卡及框外白底，建立适合人物档案的透明名帖卡，并补齐本地搜索、空态和失败态的视觉审核入口。

已选方案

采用 R01 专用透明“人物名帖”线框卡＋独立搜索区。

未选方案：

• 复用 T07 成员卡：开发较快，但会混淆人物目录与世系成员目录的模块语义。
• 仅给通用卡去白底：改动最少，但仍保留申请状态式红竖线和右上短横，不能成为 R 模块基准。

修改范围

• 将 pages/records/r01-people-list.vue 从通用 ModulePage 改为 R01 独立页面。
• 新增 R01 自有透明人物名帖卡资产。
• 复用项目现有真实搜索框、按钮、Loading、Toast、页头和 R 模块背景。
• 新增 R01 聚焦契约和运行证据。

不修改 ModulePage.vue、其他 R 页面、接口、公共组件或底层路由合同。

正常列表态

• 页头只显示“人物录”；删除标题栏下方重复的印章、R-01 页码和说明文字。
• 搜索区直接承接标题栏，可按姓名、身份或世代本地筛选三条候选数据。
• 每张人物卡只显示姓名、身份、世代和低权重“查看人物档案”提示。
• 卡框外和卡内均透明，让 R 模块长背景连续显示；不出现白色矩形底、申请状态红竖线或右上状态短横。
• 三张卡等宽、等高、间距一致；姓名是第一视觉焦点。
• “新建人物”继续使用现有主卷轴按钮；当前视觉阶段点击后使用项目 AppToast 说明后续功能阶段开放。

状态

• 正常列表：三条人物记录。
• 搜索无结果：搜索框保留，同页显示明确无结果说明，清空关键词可恢复三条记录。
• 空态：说明尚未建立人物记录，保留“新建人物”入口。
• 失败态：说明人物录暂不可用，提供“重新查看”恢复入口。
• 不新增接口调用，不使用原生 Toast、Modal、Loading 或 ActionSheet。

响应式与可用性

• 自查 320×568、360×640、360×800、412×915。
• 搜索操作、新建人物和恢复操作触控高度不低于 44 CSS px。
• 四档均不得出现页面横向溢出、文字裁切、卡片错位或主要操作不可达。

验收条件

• R01 不再引用 ModulePage 或 application-status-card.png。
• R01 不显示标题栏下方的印章、页面编号或重复说明块；后续页面审核遇到同类块时在各自页面范围内删除。
• R01 使用自有透明人物名帖卡，卡片区域没有白色矩形底。
• 搜索三条、无结果和清空恢复可在本地真实触发。
• 列表、空、失败和新建提示均使用项目组件与真实资产。
• 相关契约、R 系列视觉契约和 H5 运行检查通过。

证据边界

• H5 截图只作为内部候选证据。
• Android/HBuilderX 真机或模拟器仍未验证。
• 用户逐状态通过前不得把 R01 标记为 [x]。

自检

• 无 TBD、TODO 或未决设计选择。
• 页面、资产、状态、交互和验收条件没有冲突。
• 修改范围严格限定为 R01 及其直接测试、资产、文档和截图。