Files
jiapuapp/docs/superpowers/specs/2026-07-19-r01-people-directory-baseline-design.md
T
2026-07-20 06:52:33 +08:00

68 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 及其直接测试、资产、文档和截图。