G08–G10 入谱申请链路设计记录

日期：2026-07-14
状态：页面候选、本地模拟交互与本轮 Product Design 截图审计已完成；标记为 [~]，等待后续逐页视觉审核。

1. Product Design 工作流

Product Design:index：将工作路由为现有产品的上下文确认、截图审计和实现后设计检查。
Product Design:audit：本轮重新捕获 G08–G10 的表单、成功、列表、空态和 412 宽屏，不使用旧通用壳图冒充最终证据。
ImageGen：生成 application-record-card.png，并在截图审计发现假按钮后精确编辑出 application-status-card.png。
TDD：tests/g08-g10-application-flow-contract.ps1 与运行冒烟先因通用壳和缺少同页状态红灯，再由最小实现转绿。

2. 思维导图与外部参考

已查看 C:\Users\Rain\Desktop\软件\JOB\app设计\思维导图.png 与 加入家谱.png。外部参考的“加入家谱”依赖邀请码，但当前 OpenAPI 没有邀请码端点，因此不采用该流程。

当前申请链路唯一结构是：G06 公开家谱检索 → G08 填写真实身份与关系 → G09 查看自己的全部申请 → G10 管理员审核。三个阶段是不同用户任务，保留三条路由；各自的加载、空、失败、提交成功和审核结果只作为原路由状态，不再拆页。

3. 页面与状态

页面	独立任务	同页状态
G08	对某一 `genealogyId` 提交加入申请	`form`、提交中、`success`、`error`
G09	当前用户查看全部申请	`loading`、`list`、`empty`、`error`；`PENDING/APPROVED/REJECTED` 为卡内状态
G10	当前家谱管理员审核待处理申请	`loading`、`list`、`empty`、`error`；审核确认与结果留在卡内

G07/G08/G09 的旧 ModulePage 目录条目已经删除；G07 结果态继续只归 G06。

4. OpenAPI 功能参考

页面动作	OpenAPI
G08 提交	`POST /genealogy/app/genealogies/{genealogyId}/join-applies`
G09 我的申请	`GET /genealogy/app/genealogies/join-applies/mine`
G09 撤销边界	`DELETE /genealogy/app/genealogies/join-applies/{applyId}`；本轮页面不展示未接入的撤销按钮
G10 待审核列表	`GET /genealogy/app/genealogies/{genealogyId}/join-applies/pending`
G10 审核	`PUT /genealogy/app/genealogies/{genealogyId}/join-applies/{applyId}/audit`

OpenAPI 的申请体仍是 JsonObject，页面只使用已有业务能解释的 realName、relation、message，没有臆造邀请码、推荐人层级或多管理员审批字段。本阶段只据此安排字段、状态和动作位置；三页均使用页面内模拟数据与交互，不调用 appApi，不进行接口对接。

5. 视觉资产

G08 复用 g03-create-flow-panel.png 的完整宣纸表单面，以及 g06-search-input-wide.png 的完整输入框皮肤；没有复制近似资产。
application-record-card.png：1050×360、24 位 RGB、不透明；右下留双审核槽，只供 G10 列表。
application-status-card.png：1050×360、24 位 RGB、不透明；移除双审核槽，供 G09 列表和 G09/G10 空/失败状态。
主次操作分别使用 a01-primary-button.png 与 a01-secondary-button.png，CSS 只负责位置、文字和点击层。

6. 截图证据

G08：screens/runtime/2026-07-14/g-module-audit/applications/01-g08-form-360x800.png、02-g08-success-360x800.png、03-g08-form-412x915.png。
G09：04-g09-list-360x800.png、05-g09-empty-360x800.png。
G10：06-g10-list-360x800.png、07-g10-empty-360x800.png、08-g10-list-412x915.png。
同画布对照：09-g08-form-success-comparison.png、10-g09-list-empty-comparison.png、11-g10-list-empty-comparison.png。

7. Product Design 审计结果

强项

G08 表单在 360/412 下均完整显示，姓名、关系、说明和提交按钮顺序清楚；提交后仍在 G08 显示成功结果。
G09 的申请状态以审核中、已通过、未通过映射接口枚举；通过项才可进入家谱。
G10 的拒绝/通过使用主次完整位图按钮，动作前有确认弹窗，避免误审。
三页的空态均留在原路由，没有新增状态页。

已修复问题

P2：第一张共享卡为审核按钮预留了两个槽，放到 G09 和空态时形成假按钮。已生成无按钮槽的状态卡并重新截图，问题消失。
P2：运行冒烟最初在面板出现后立即查找原生输入，可能早于 uni-input 内部节点渲染。测试改为等待真实输入节点，再填写和点击；真实提交已到达同页成功态。

可访问性边界

截图可确认主按钮、审核按钮、表单顺序和文字未裁切。
G10 审核按钮在 360 下仍有完整卡内点击区域，但最终 Android 真机仍需验证触摸目标、字体放大和读屏标签。
截图不能证明弹窗焦点管理或读屏状态播报，不宣称完整无障碍合规。

8. 验证

G08-G10-APPLICATION-FLOW-CONTRACT PASS
G08-G10-APPLICATION-FLOW-RUNTIME-SMOKE PASS，包含真实控件填写与本地模拟提交
PASS compile audit

三页仅标记为候选完成，用户集中看样式前不标记为视觉冻结。

5.2 KiB Raw Blame History Unescape Escape