Files
jiapuapp/docs/design/G11-G12_设置与字辈诗_设计记录.md
T
2026-07-15 08:31:33 +08:00

52 lines
3.0 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.
# G11–G12 家谱设置与字辈诗设计记录
> 日期:2026-07-14
> 状态:页面候选、同页状态、运行截图与 Product Design 对比审视已完成;标记为 `[~]`,等待用户后续逐页视觉审核。
## 1. 设计边界
- 继续使用项目已冻结的宣纸、朱砂、藏青与古金视觉体系,不照搬外部参考的颜色、卡片或按钮。
- OpenAPI 只用于确认可设计的功能位置与数据语义,不导入 `appApi`、不新增 API 方法、不进行接口联调。
- G11 与 G12 的空、失败、成功、编辑状态全部留在原路由,不为同一任务新增页面。
- G11 不放置“转让管理权”假入口:该动作需要成员选择上下文,当前页面只安排名称、公开范围和访问说明。
## 2. 页面与状态
| 页面 | 核心任务 | 同页状态 |
| --- | --- | --- |
| G11 | 编辑家谱名称、公开范围、访问说明 | `loading``form``success``error` |
| G12 | 查看逐代字辈、批量录入连续字辈 | `loading``list``empty``edit``error` |
G11 的公开范围提供“仅成员可见”和“公开可申请”两个明确选项,并给出权限解释。G12 采用外部思维导图可借鉴的逐世代行结构,但视觉表面仍完全使用本项目资产;编辑区保留接口清单所描述的连续 `content` 与“缺失旧世代时停止”策略位置。
## 3. 视觉资产
- 两页复用 `g03-create-flow-panel.png` 作为完整双金线宣纸面板。
- 输入、字辈行使用 `g06-search-input-wide.png` 完整位图皮肤。
- 主次操作分别使用 `a01-primary-button.png``a01-secondary-button.png`
- CSS 只负责布局、真实文字和点击层,不绘制卡片背景、边框、圆角或装饰。
- 现有资产已能覆盖页面,因此本轮没有调用 ImageGen 新增近似资产。
## 4. 截图证据
目录:`screens/runtime/2026-07-14/g-module-audit/settings-poems/`
- 改前基线:`00-g11-before-360x800.png``00-g12-before-360x800.png`
- G11`01-g11-form-360x800.png``02-g11-success-360x800.png``03-g11-form-412x915.png`
- G12`04-g12-list-360x800.png``05-g12-empty-360x800.png``06-g12-edit-360x800.png``07-g12-list-412x915.png`
- 同画布对比:`08-g11-before-after-comparison.png``09-g12-before-after-comparison.png`
## 5. Product Design 审视
- G11 相比通用设置壳,信息层级变为“设置目的 → 名称 → 公开范围及权限解释 → 访问说明 → 保存”,不再出现无法完成的管理权转让入口。
- G12 相比通用详情壳,逐世代字辈可直接扫描,当前字辈使用朱砂强调;空态与编辑态仍保持同一页面语义。
- 360 × 800 与 412 × 915 下,完整面板、按钮和底部山水均未被裁切;编辑态主次动作层级清楚。
- 截图不能证明 Android 字体放大、读屏播报和真机触摸区域,留到最终真机验证阶段。
## 6. 验证
- `G11-G12-SETTINGS-POEMS-CONTRACT PASS`
- `G11-G12-SETTINGS-POEMS-RUNTIME-SMOKE PASS`
- 页面代码不引用 `@/utils/api.js``appApi`