修改完成55%

This commit is contained in:
2026-07-15 08:31:21 +08:00
parent 8c98936da5
commit 241a7af54c
98 changed files with 3269 additions and 782 deletions
@@ -0,0 +1,60 @@
# FRNM 全量候选设计记录
> 日期:2026-07-14
> 状态:F01F10、R01R11、N01N02、M01M10 共 33 个页面候选已形成,统一标记 `[~]`,等待用户逐页视觉审核。
## 1. Product Design 处理方式
- 先捕获旧通用壳的 `detail|list|form|timeline|settings|status` 六类真实运行基线,再升级共享母版。
- 共享母版只统一视觉表面和状态机制;每条路由仍拥有独立页面编号、标题、字段、列表内容和业务任务,没有合并不同功能页面。
- F01、F02、N01、M01 四个根页独立重做,保留家族/我的底部导航与关键跳转。
- 接口文档只用于功能位置和字段语义;页面候选全部使用本地模拟数据,不调用 `appApi`,不修改 API 边界。
## 2. 位图与母版
- `g03-create-flow-panel.png`:表单、详情、设置、服务说明和统一状态的完整宣纸表面。
- `g06-search-input-wide.png`:真实输入、详情段落和设置行的完整位图底层。
- `application-status-card.png`:列表、时间轴、通知、动态与状态卡。
- `a01-primary-button.png``a01-secondary-button.png`:所有主次操作。
- CSS 不绘制卡片、按钮、边框、圆角或伪元素装饰,只负责布局、文字、控件和状态。
## 3. 截图证据
### 六类母版
目录:`screens/runtime/2026-07-14/module-page-audit/`
- 基线与候选:`00-*-before-360x800.png``01-f03-detail-360x800.png``10-f04-list-412x915.png`
- 同画布对比:`11-template-before-after-comparison.png`
- 共享空/成功/失败:`12-shared-states-comparison.png`
### 29 个共享母版页面
目录:`screens/runtime/2026-07-14/all-page-candidates/`
- 每条路由均有独立 `*-360x800.png`
- 模块联系表:`00-family-contact-sheet.png``00-records-contact-sheet.png``00-profile-notification-contact-sheet.png`
### F01F02N01M01
目录:`screens/runtime/2026-07-14/root-pages-audit/`
- 基线:`00-f01-before-360x800.png``00-f02-before-360x800.png``00-n01-before-360x800.png``00-m01-before-360x800.png`
- 候选与状态:`01-f01-list-360x800.png``10-m01-ready-412x915.png`
- 同画布对比:`11-root-before-after-states.png`
## 4. 审视结果
- 六类母版在 360 下没有卡片、按钮或文字裁切;列表较长时自然纵向滚动,完整面板保持一致的视觉终点。
- 共享状态统一使用同一宣纸面板,但标题、动作和业务名称来自当前页面,避免“万能空态”丢失上下文。
- F01、M01 的根页保留底部导航;F02 的发布编辑区和 N01 的消息卡均使用真实控件与本地可操作结果。
- Product Design 对比中未发现 P1/P2 级裁切、假按钮槽或风格漂移;最终 Android 真机字体放大、读屏和触摸目标仍需后续设备复核。
## 5. 验证入口
- `tests/module-page-visual-contract.ps1`
- `tests/module-page-runtime-smoke.js`
- `tests/root-pages-visual-contract.ps1`
- `tests/root-pages-runtime-smoke.js`
- `tests/capture-chrome-page-contract.ps1`
@@ -0,0 +1,79 @@
# G05 家谱总览设计记录
> 日期:2026-07-14
> 状态:视觉候选已实现并完成本轮 Product Design 截图审计;未获用户审美确认,等待 G 模块完成后集中查看。
## 1. 技能与证据
- 已调用 `Product Design:index`,将任务路由为现有产品的 `audit``get-context` 与实现后设计检查。
- 已调用 `Product Design:audit`,以本轮新截的真实 H5 画面为证据,不用旧截图代替。
- 已调用 ImageGen 生成完整不透明位图表面;没有用 CSS 伪造卡片、边框或装饰。
- 改前证据:`screens/runtime/2026-07-14/g-module-audit/before/01-g05-before-360x800.png`
- 改后证据:`screens/runtime/2026-07-14/g-module-audit/g05/01-g05-ready-360x800.png``02-g05-empty-360x800.png``03-g05-error-360x800.png``04-g05-ready-412x915.png`
- 同画布对照:`screens/runtime/2026-07-14/g-module-audit/g05/05-g05-before-after-comparison.png`,左侧改前、右侧改后;所有判断均基于这张合并输入,不把两个分离预览冒充并排比较。
## 2. 产品与思维导图参考
外部只读参考位于 `C:\Users\Rain\Desktop\软件\JOB\app设计`。已查看 `思维导图.png``家谱主页.png``加入家谱.png``字辈谱.png`
采用的只有信息结构:谱名、堂号、地点和成员概况置顶;世系、录入、字辈、审核作为核心入口;家族内容作为下一层。没有采用外部灰绿色卡片、现代图标、邀请码加入或底部双按钮视觉。
外部“邀请码加入”与当前产品不一致。当前唯一加入流程是 G06 公开检索 → G08 提交申请 → G09 查看进度 → G10 管理员审核,因此不把邀请码或邀请按钮加入 G05。
## 3. 路由与状态所有权
- 唯一路由:`pages/genealogy/g05-genealogy-overview`
- 唯一上下文查询键:`genealogyId`G01 的旧 `id` 链接已同步迁移,不保留兼容读取。
- 同页状态:`loading``ready``empty``error`,不为加载、空数据、无权或失败另建页面。
- “录入族人”进入 G03 `step=ancestor&genealogyId=...`;已删除的 G04 不再被引用。
- G05 不再把 G08 申请加入表单误写成管理员的“邀请亲人”。
## 4. OpenAPI 设计边界
| 页面内容/动作 | OpenAPI 依据 | 页面阶段处理 |
| --- | --- | --- |
| 谱名、堂号、地区、成员数、可见范围 | `GET /genealogy/app/genealogies/{genealogyId}/overview` | 正常态展示真实接口所需字段;本轮继续使用现有 mock |
| 管理设置 | `GET/PUT /genealogy/app/genealogies/{genealogyId}` | 只进入 G11,不在 G05 复制设置表单 |
| 世系树 | `GET /genealogy/app/genealogies/{genealogyId}/lineage/tree` | 进入 T01,不在总览加载完整树 |
| 录入首代 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons` | 进入 G03 的始祖步骤 |
| 字辈谱 | `GET/POST /genealogy/app/genealogies/{genealogyId}/generation-poems` | 进入 G12 |
| 入谱审核 | `GET .../join-applies/pending``PUT .../{applyId}/audit` | 进入 G10 |
接口响应仍使用通用 `JsonObject/ListResult`,因此页面不臆造邀请码、分享码、视频或多级管理员字段。
## 5. 位图资产
- 最终资产:`static/assets/modules/genealogy/opaque/g05-overview-surface.png`
- 尺寸:1122×1506`Format24bppRgb`,四角 alpha 均为 255。
- 内容:墨蓝谱名区、四个完整宣纸入口槽、古金分隔、底部访问说明面;文字和点击层不烘焙进图片。
- ImageGen 使用 `ui-mockup` 模式,参考 G05 改前 360×800 截图,明确要求无文字、无图标、无占位符、无现代玻璃拟态。
## 6. Product Design 审计
### 改前主要风险
1. G05 的“录入族人”指向已删除 G04,核心动作实际不可达。
2. “邀请亲人”跳到申请者填写的 G08,角色和任务语义错误;OpenAPI 也没有邀请端点。
3. 深色头、四宫格卡片和底部邀请面均由 CSS 拼接,不符合完整视觉表面必须使用位图的项目规则。
4. 只有模糊载入文案,没有区分空数据、无权限和加载失败。
### 改后步骤与健康度
1. `ready`:健康。谱名和成员概况在墨蓝区,四个核心任务在首屏可见,家族近况和访问说明层级清楚。
2. `empty`:健康。仍在 G05 路由内说明缺少上下文,并返回“我的家谱”。
3. `error`:健康。说明网络、数据或权限三类可能原因,提供同页重试。
4. 412×915:健康。位图、文字和点击槽同步放大,没有横向溢出或裁切。
### 可访问性边界
- 本轮从截图确认了文字未裁切、主要入口具有完整卡片面积、按钮文案可见。
- 审计后已提高谱名区元信息、入口说明、近况和底部说明字号,降低 360 宽屏小字风险。
- 截图不能证明读屏语义、键盘焦点和 Android 字体放大行为;这些留到真机与可访问性专项验证,不能宣称完整 WCAG 合规。
## 7. 验证
- `tests/g05-overview-contract.ps1`
- `tests/g05-overview-runtime-smoke.js`
- `tests/g01-visual-contract.ps1`
以上在实现后均已通过;最终集中审美确认前不将 G05 标记为视觉冻结。
@@ -0,0 +1,81 @@
# 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 审计结果
### 强项
1. G08 表单在 360/412 下均完整显示,姓名、关系、说明和提交按钮顺序清楚;提交后仍在 G08 显示成功结果。
2. G09 的申请状态以审核中、已通过、未通过映射接口枚举;通过项才可进入家谱。
3. G10 的拒绝/通过使用主次完整位图按钮,动作前有确认弹窗,避免误审。
4. 三页的空态均留在原路由,没有新增状态页。
### 已修复问题
- 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`
三页仅标记为候选完成,用户集中看样式前不标记为视觉冻结。
@@ -0,0 +1,51 @@
# 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`
+18 -10
View File
@@ -1,6 +1,6 @@
# P00 页面结构与资产清单
> 状态:55 条最终编号路由与第一版统一视觉母版已落地;A01/A02/A04/A05/A06/G01 两种状态与 G03 `create|ancestor` 已验收;G06 已合并 G07 的三态,最新「朱砂题签」候选只完成初始态截图,结果/无结果同版截图与用户审美确认待补
> 状态:54 条最终编号路由已落地;A01/A02/A04/A05/A06/G01 两种状态与 G03 `create|ancestor` 已验收;其余 47 条路由均已有 `[~]` 视觉候选和真实运行截图,等待用户逐页审核
> 目的:让页面、路由和资产都有唯一、可读、可审计的归属;本文件是 P-00 的执行清单。
## 1. 页面命名规则
@@ -24,17 +24,19 @@
| `pages/auth/a02-login` | A02 账号登录 | `pages/auth/a02-login.vue` | 已迁移;已验收,视觉冻结 |
| `pages/genealogy/g01-my-genealogies` | G01 我的家谱 | `pages/genealogy/g01-my-genealogies.vue` | 已迁移;视觉冻结 |
| `pages/genealogy/g03-create-genealogy` | G03 创建家谱/始祖录入 | `pages/genealogy/g03-create-genealogy.vue` | `step=create|ancestor`;已获用户验收,视觉冻结 |
| `pages/genealogy/g05-genealogy-overview` | G05 家谱总览 | `pages/genealogy/g05-genealogy-overview.vue` | 已迁移;未验收 |
| `pages/genealogy/g06-search-genealogies` | G06 公开家谱搜索/结果/无结果 | `pages/genealogy/g06-search-genealogies.vue` | 已收敛 G07;朱砂题签候选已实现,只有初始态新截图,三态复核与用户审美确认待补 |
| `pages/genealogy/g10-application-review` | G10 管理员入谱审核 | `pages/genealogy/g10-application-review.vue` | 已迁移;未验收 |
| `pages/tree/t01-tree-overview` | T01 世系树总览 | `pages/tree/t01-tree-overview.vue` | 已迁移;未验收 |
| `pages/tree/t03-member-profile` | T03 成员档案 | `pages/tree/t03-member-profile.vue` | 已迁移;未验收 |
| `pages/genealogy/g05-genealogy-overview` | G05 家谱总览 | `pages/genealogy/g05-genealogy-overview.vue` | `loading|ready|empty|error`;视觉候选已实现,待集中审美确认 |
| `pages/genealogy/g06-search-genealogies` | G06 公开家谱搜索/结果/无结果 | `pages/genealogy/g06-search-genealogies.vue` | 已收敛 G07;朱砂题签三态候选已截图,待集中审美确认 |
| `pages/genealogy/g08-join-application` | G08 申请加入家谱 | `pages/genealogy/g08-join-application.vue` | `form|success|error`;本地模拟提交已验证,待集中审美确认 |
| `pages/genealogy/g09-my-applications` | G09 我的申请 | `pages/genealogy/g09-my-applications.vue` | `loading|list|empty|error`;待集中审美确认 |
| `pages/genealogy/g10-application-review` | G10 管理员入谱审核 | `pages/genealogy/g10-application-review.vue` | `loading|list|empty|error`;待集中审美确认 |
| `pages/tree/t01-tree-overview` | T01 世系树总览 | `pages/tree/t01-tree-overview.vue` | 已收敛 T02 四态;视觉候选待审 |
| `pages/tree/t03-member-profile` | T03 成员档案 | `pages/tree/t03-member-profile.vue` | 详情/失败候选待审 |
| `pages/family/f01-family-feed` | F01 家族动态 | `pages/family/f01-family-feed.vue` | 已迁移;未验收 |
| `pages/family/f02-publish-feed` | F02 发布动态 | `pages/family/f02-publish-feed.vue` | 已迁移;未验收 |
| `pages/notification/n01-message-center` | N01 消息中心 | `pages/notification/n01-message-center.vue` | 已迁移;未验收 |
| `pages/profile/m01-profile-home` | M01 我的首页 | `pages/profile/m01-profile-home.vue` | 已迁移;未验收 |
上述表仅保留首批迁移的历史背景;当前最终 55 路由、文件存在性和中文编号注释的唯一合同是 `tests/full-page-visual-contract.ps1`。临时 `content-list-skeleton` 已由谱文、相册、礼仪、备忘录和字辈诗最终页面替代并移除。
上述表仅保留首批迁移的历史背景;当前最终 54 路由、文件存在性和中文编号注释的唯一合同是 `tests/full-page-visual-contract.ps1`。临时 `content-list-skeleton` 已由谱文、相册、礼仪、备忘录和字辈诗最终页面替代并移除。
迁移要求:同一轮更新页面文件、`pages.json`、所有跳转路径、测试和中文文件头注释;未完成全部引用更新时,不得删除旧路径。
@@ -66,9 +68,12 @@ static/assets/
opaque/
g01-empty-panel.png
g03-create-flow-panel.png
g05-overview-surface.png
g06-search-title-strip.png
g06-search-input-wide.png
g06-search-button.png
application-record-card.png
application-status-card.png
transparent/
tree/
opaque/
@@ -88,7 +93,7 @@ static/assets/
| --- | --- | --- | --- | --- |
| `foundation/opaque/auth-page-paper.jpg` | opaque / 750×1334 | 认证页纸纹底色 | A01、A02、A04、A05、A06 | 保留 |
| `foundation/opaque/auth-header.png` | opaque / 750×196 | 认证页红色页头 | A01、A02、A04、A05、A06 | 保留 |
| `foundation/opaque/page-paper.jpg` | opaque / 852×1846 | 根页宣纸底图 | G01、G06 | 保留 |
| `foundation/opaque/page-paper.jpg` | opaque / 852×1846 | 根页宣纸底图 | G、T、F、R、N、M 非认证页面 | 保留 |
| `foundation/opaque/root-header-cinnabar.jpg` | opaque / 720×184 | 根页朱砂页头 | `PageHeader` | 保留 |
| `foundation/transparent/auth-ink-scenery.png` | transparent / 750×1334 | 认证页淡墨叠层 | A01、A02、A04、A05、A06 | 保留 |
| `foundation/transparent/auth-title-cloud.png` | transparent / 200×120 | 认证标题右侧云纹 | A01、A02、A04、A05、A06 | 保留 |
@@ -106,11 +111,14 @@ static/assets/
| `foundation/transparent/notice.png` | transparent / 96×96 | 通知图标 | `PageHeader` | 保留 |
| `foundation/transparent/chevron-right.png` | transparent / 96×96 | 返回与列表箭头 | A02、A04、A05、A06、`GenealogyCard` | 保留 |
| `modules/genealogy/opaque/g01-empty-panel.png` | opaque / 1122×1402 | 无家谱空态完整宣纸卡,双金线、角饰、云纹与下沿山水 | G01 `state=empty` | 保留;由 ImageGen 生成,已获用户验收 |
| `modules/genealogy/opaque/g03-create-flow-panel.png` | opaque / 1122×1500 | 创建流程完整宣纸表单面板,双金线、回纹角饰、云纹与下沿淡墨山水 | G03 `step=create|ancestor` | 保留;由 ImageGen 生成,已获用户验收 |
| `modules/genealogy/opaque/g03-create-flow-panel.png` | opaque / 1122×1500 | 完整宣纸任务面板,双金线、回纹角饰、云纹与下沿淡墨山水 | G03、G08、G11、G12、T01、T03 至 T06、T08、F/R/N/M 表单/详情/设置/状态 | 保留;由 ImageGen 生成,G03 已获用户验收,复用页待审 |
| `modules/genealogy/opaque/g05-overview-surface.png` | opaque / 1122×1506 | 家谱总览完整视觉表面,含墨蓝谱名区、四宫格宣纸槽、金线近况分隔与底部访问说明面 | G05 `loading|ready|empty|error` | 保留;由 ImageGen 参考 G05 改前截图生成,页面只叠放真实文字和点击层;待集中审美确认 |
| `modules/genealogy/opaque/g06-search-title-strip.png` | opaque / 1122×220 | 朱砂题签完整视觉面,含古金边饰与云纹,不烘焙文字或印玺 | G06 顶部检索题签 | 保留;用户选定 ImageGen 第 3 稿方向,Vue 叠放真实 `brand-seal.png` 与标题文字 |
| `modules/genealogy/opaque/g06-search-input-wide.png` | opaque / 1120×248 | 宽版独立宣纸输入框完整皮肤,含古金双线与角饰 | G06 真实输入框底层 | 保留;真实原生输入控件叠放其上 |
| `modules/genealogy/opaque/g06-search-input-wide.png` | opaque / 1120×248 | 宽版独立宣纸字段完整皮肤,含古金双线与角饰 | G、T 与 F/R/N/M 输入、详情段落、设置行 | 保留;真实文字与控件叠放其上 |
| `modules/genealogy/opaque/g06-search-input.png` | opaque / 720×248 | 早期窄版输入框完整皮肤 | 当前无引用 | 已停用;仅因用户要求停止工作而保留,恢复工作后需在引用扫描通过且用户允许时删除 |
| `modules/genealogy/opaque/g06-search-button.png` | opaque / 300×132 | 独立朱砂搜索按钮完整皮肤,含古金双线与角饰 | G06 真实搜索点击控件底层 | 保留;由 ImageGen 生成,真实点击控件与文本叠放其上 |
| `modules/genealogy/opaque/application-record-card.png` | opaque / 1050×360 | 带右下双审核槽的完整申请记录卡 | G10 待审核申请 | 保留;由 ImageGen 参考 G09/G10 改前截图生成,按钮另用完整位图叠放 |
| `modules/genealogy/opaque/application-status-card.png` | opaque / 1050×360 | 无按钮槽的完整信息状态卡 | G09/G10、T01/T07/T08、F/R/N/M 列表/时间轴/通知/状态 | 保留;由 ImageGen 精确移除审核槽,避免无操作状态出现假按钮 |
| `foundation/transparent/meta-location.png` | transparent / 96×96 | 地点元信息 | G01、`GenealogyCard` | 保留 |
| `foundation/transparent/meta-member.png` | transparent / 96×96 | 成员元信息 | G01、`GenealogyCard` | 保留 |
| `foundation/transparent/meta-admin.png` | transparent / 96×96 | 管理员元信息 | G01 | 保留 |
@@ -0,0 +1,46 @@
# T01–T08 世系与成员设计记录
> 日期:2026-07-14
> 状态:T02 已收敛至 T01T01、T03–T08 共 7 个页面候选、运行截图和 Product Design 审视完成,统一标记 `[~]`。
## 1. 信息架构
- T01 是阅读世系的唯一页面,`tree|landscape|empty|error` 为同页状态;T02 路由、文件和目录条目已删除。
- T03 负责成员档案;T04 新增亲属、T05 编辑成员、T06 维护关系分别保留独立任务页,但共享同一高质量表单母版。
- T07 是成员检索目录;T08 将隐私、离世纪念和无权限保留为同一路由的三个状态,不拆成重复页面。
- 接口文档仅用于确定成员字段、关系冲突、隐私和状态位置;所有候选使用页面内模拟数据,不调用 `appApi`
## 2. 视觉体系
- 延续已确认的宣纸、朱砂、古金与墨褐体系。
- 世系画布和成员表单复用 `g03-create-flow-panel.png` 完整宣纸面;成员节点/字段使用 `g06-search-input-wide.png`;信息条、目录卡和状态卡使用 `application-status-card.png`
- 主次操作使用 `a01-primary-button.png``a01-secondary-button.png`CSS 仅负责布局、文字和点击层。
- 现有完整位图已覆盖需要,因此没有生成语义重复的新资产。
## 3. Product Design 截图审视
### T01
目录:`screens/runtime/2026-07-14/t01-audit/`
- 候选:`04-t01-tree-360x800.png``05-t01-landscape-360x800.png``06-t01-empty-360x800.png``07-t01-error-360x800.png``08-t01-tree-412x915.png`
- 对比:`09-t01-before-after-comparison.png`
- 首轮状态截图发现状态文案位于 1180rpx 横向画布中导致右侧裁切;先更新契约要求 `tree-canvas--state`,再将非树状态画布收窄到当前视口,重新截图后已完整显示。
### T03T08
目录:`screens/runtime/2026-07-14/t-module-audit/`
- 关键候选:`01-t03-detail-360x800.png``13-t07-list-412x915.png`
- 同画布对比:`14-t03-comparison.png``15-t04-t06-comparison.png``16-t07-t08-comparison.png`
- 360/412 下表单字段、成员卡、状态切换和主次操作均未裁切;T06 冲突动作与 T08 三种权限状态层级清楚。
## 4. 验证
- `T01-TREE-STATE-CONTRACT PASS`
- `T01-TREE-STATE-RUNTIME-SMOKE PASS`
- `T03-T08-MEMBER-FLOW-CONTRACT PASS`
- `T03-T08-MEMBER-FLOW-RUNTIME-SMOKE PASS`
- `PASS compile audit`
H5 截图不能替代 Android 真机字体放大、读屏和触摸目标验证;这些留到全量候选后的设备复核。
Binary file not shown.

After

Width:  |  Height:  |  Size: 343 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 360 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 359 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 360 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 350 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 288 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 318 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 260 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 262 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 266 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.5 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.0 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 321 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 264 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 251 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 312 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 326 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 320 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 254 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 308 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 256 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 297 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 314 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 318 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 317 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 320 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 269 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 302 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 322 KiB

+14 -41
View File
@@ -9,42 +9,33 @@
必须保留已有未提交改动;不使用 worktree 或多代理;不执行 `git add``git commit``git push`、上传、`git reset``git checkout`。A01、A02、A04、A05、A06、G01、G03 的可见效果已获用户验收并冻结,不能以重构或顺手优化的名义改变。G07 是 G06 的页面内状态,不得重新建为独立页。
当前唯一应向用户确认的候选是 G06:用户选定最近 ImageGen 第 3 稿的「朱砂题签 + 宽输入框 + 搜索按钮」方向,通用印玺已替换为项目真实 `brand-seal.png`。最后实际运行证据只有初始态 `docs/design/screens/runtime/2026-07-14/G06-selected-strip-final-initial-360x800.png`;同版结果态和无结果态截图未完成,G06 也**未验收**。不要把旧 `G06-no-panel-*` 截图当作当前最终版本。先请用户看当前初始态并决定是否继续;用户要求继续 G06 时,先截图审视,再补三态和验证;用户明确验收后,才继续 T02→T01(除非用户指定新优先级)
用户已授权先完成全部页面候选、后集中审核。54 条最终路由均已覆盖:7 个已验收冻结,其余 47 个统一标 `[~]`;不得把候选写成用户已验收。下一阶段由用户按规划逐页勾选,接口只作功能布局参考,本轮没有对接
新环境必须可用并实际调用:`product-design:index``product-design:audit``imagegen``superpowers:test-driven-development``superpowers:systematic-debugging``superpowers:verification-before-completion`。没有这些能力时,先安装/启用同等能力,不得假装已经完成设计审视或位图生成。
## 1. 当前停点:先看这一节
项目已有 55 条最终编号路由,第一版都可以浏览;这不等于 55 个页面已完成视觉验收。
项目已有 54 条最终编号路由T02 已收敛到 T01 同页状态。这不等于 54 个页面已完成视觉验收。
- 用户已经验收的视觉基准有个:**A01 启动/登录引导**、**A02 账号登录**、**A04 注册账号**、**A05 重置密码**、**A06 登录状态**、**G01 我的家谱**。它们的可见效果已冻结。
- **A02 账号登录**已经完成资产化重做、功能回归和多尺寸截图,并于 2026-07-14 获用户审美验收。A03 已删除;A02 的短信 Tab 是唯一手机号验证码登录入口。A04、A05、A06 均于同日完成独立重做并获用户审美验收;G02 已按用户确认合并为 G01 的 `?state=empty` 并获用户审美确认G04 已合并为 G03 的 `?step=ancestor`G03 双步骤已获用户继续授权通过;G07 已合并为 G06 初始/结果/无结果状态。G06 曾被指出页头层级、伪控件和大面板截图感;用户最后选择最近 ImageGen 第 3 稿,当前以朱砂题签、真实品牌谱印、独立宽输入框和搜索按钮实现。最后候选只完成初始态新截图,结果态/无结果态的同版截图和用户审美确认尚未完成
- 其余模块的页面仍属于后续视觉设计任务;其中不少页面目前由 `components/ModulePage.vue``data/page-catalog.js` 提供第一版可浏览壳。这个壳是过渡方案,不是最终 UI
- 用户已经验收的视觉基准有个:**A01 启动/登录引导**、**A02 账号登录**、**A04 注册账号**、**A05 重置密码**、**A06 登录状态**、**G01 我的家谱**、**G03 创建家谱**。它们的可见效果已冻结。
- **A02 账号登录**已经完成资产化重做、功能回归和多尺寸截图,并于 2026-07-14 获用户审美验收。A03 已删除;A02 的短信 Tab 是唯一手机号验证码登录入口。A04、A05、A06 均于同日完成独立重做并获用户审美验收;G02 已按用户确认合并为 G01 的 `?state=empty`G04 已合并为 G03 的 `?step=ancestor`G07 已合并为 G06 初始/结果/无结果状态。G06 三态候选截图和内部审视已经完成,但尚未获得用户视觉验收
- G05、G06、G08G12、T01、T03T08、F01F10、R01R11、N01N02、M01–M10 已完成候选截图和审视;共享 `ModulePage.vue` 已升级为全位图高规格母版,不再是旧 CSS 过渡壳
- 不提交、不推送、不上传 Git;由用户自行处理版本库操作。
下一位执行者先读取当前停点与已验收页面,再向用户展示 **G06 当前候选的初始态** 并等待反馈:
- `docs/design/screens/runtime/2026-07-14/A05-after-360x800.png`
- `docs/design/screens/runtime/2026-07-14/A05-after-412x915.png`
- `docs/design/screens/runtime/2026-07-14/A06-after-360x800.png`
- `docs/design/screens/runtime/2026-07-14/A06-after-412x915.png`
- `docs/design/screens/runtime/2026-07-14/A06-restricted-360x800.png`
- `docs/design/screens/runtime/2026-07-14/G06-selected-strip-final-initial-360x800.png`
`G06-no-panel-*` 图是被用户否定后各轮尝试的历史证据,只能帮助理解迭代原因,不能用于当前验收。用户若要求调整,只修改对应页面状态并重新截图、复核;当前 A01、A02、A04、A05、A06、G01 两种状态与 G03 `create|ancestor` 均已明确通过。G06 当前候选的初始态待用户确认,结果态/无结果态的新截图待补;不得把 G06 写成已验收。只有用户明确通过 G06 或明确要求跳过它,下一项才按 T02→T01 状态收敛执行。
下一位执行者先读取当前停点与已验收页面,然后按 `docs/规划.md``[~]` 清单协助用户逐页审核。默认只从 `docs/design/视觉证据索引.md` 打开一张代表图或一张状态联系表;多尺寸、before/after 与历史废稿仅在发现问题时展开。旧 `G06-no-panel-*` 图只能帮助理解迭代原因,不能用于当前验收。全部 47 个候选都等待用户逐页确认,不再按模块批量推进新页面。
## 1.1 迁移前必须保留的文件
本手册、G06 最终候选资产和截图工具均是接管所需文件;换电脑前,用户需在自行提交/上传时包含它们,或完整复制当前工作区。我没有执行任何 Git 暂存、提交、推送或上传操作。
至少要保留:`docs/design/视觉设计交接手册.md``docs/交接记录.md``scripts/capture-chrome-page.js`G06 页面/资产/测试、`docs/design/screens/runtime/2026-07-14/G06-selected-strip-final-initial-360x800.png`、A02 页面/资产/测试、`docs/design/screens/runtime/2026-07-13/` 的运行证据,以及现有计划与设计记录。只复制已提交的旧版本会丢失当前停点。
至少要保留:`docs/design/视觉设计交接手册.md``docs/交接记录.md``docs/design/视觉证据索引.md``scripts/capture-chrome-page.js`全部页面/资产/测试、`docs/design/screens/runtime/` 的运行证据,以及现有计划与设计记录。只复制已提交的旧版本会丢失当前停点。
## 2. 必读文件与唯一职责
| 文件 | 负责什么 |
| --- | --- |
| `AGENTS.md` | 最小修改、保护既有未提交内容、验证后再交付的项目规则。 |
| `docs/规划.md` | 55 条独立路由的范围、模块顺序和“完成”的定义。 |
| `docs/规划.md` | 54 条独立路由的范围、模块顺序和“完成”的定义。 |
| `docs/design/D1_安卓视觉规范与页面壳.md` | Android 页面、资产、布局与中文注释的硬约束。 |
| `docs/design/P00_页面结构与资产清单.md` | 路由、页面文件和资产台账的唯一清单。 |
| `docs/superpowers/plans/2026-07-13-product-design-visual-refinement.md` | 已批准的分模块视觉精修计划和验收顺序。 |
@@ -85,17 +76,7 @@
### 已保存的运行证据
目录:`docs/design/screens/runtime/2026-07-13/`
| 文件 | 状态 |
| --- | --- |
| `A02-before-360x800.png` | 改造前基线。 |
| `A02-after-320x568.png` | 小屏账号密码态;允许纵向滚动,不允许横向裁切。 |
| `A02-after-360x640.png` | 中屏账号密码态。 |
| `A02-after-360x800.png` | 主对比尺寸。 |
| `A02-after-412x915.png` | 大屏账号密码态。 |
| `A02-sms-360x800.png` | 真实切换后的短信验证码态。 |
| `A02-before-after-360x800.png` | 左旧右新的并排对比。 |
默认只查看 `docs/design/screens/handoff/2026-07-13/A02-after-360x800.png`。小屏、大屏、短信状态和 before/after 证据保存在项目外完整归档中,按需展开,不在交接正文连续罗列。
### 通过/未通过的界线
@@ -137,7 +118,7 @@ node scripts/capture-chrome-page.js `
360 800
```
截图只作为 `docs/design/screens/runtime/<日期>/` 下的设计证据,绝不能放回 `static/assets/` 作为运行资源。每个代表页面至少做 360 × 800;模块代表页还要做 320 × 568、360 × 640、360 × 800、412 × 915。最终 Android/HBuilderX 截图仍需补做,H5 Chrome 截图不能替代它。
截图先保存到已忽略的 `docs/design/screens/runtime/<日期>/`,绝不能放回 `static/assets/` 作为运行资源。每个代表页面至少做 360 × 800;只有出现比例风险或用户要求时再展开 320 × 568、360 × 640、412 × 915,多状态页面优先合成一张联系表。用户确认需要长期交接时,只把代表图复制到 `docs/design/screens/handoff/`。最终 Android/HBuilderX 截图仍需补做,H5 Chrome 截图不能替代它。
## 6. 后续执行顺序与每轮产物
@@ -145,19 +126,11 @@ node scripts/capture-chrome-page.js `
1. A02 与 A04 均已通过;不因后续页面改动而触碰其可见效果。
2. 若用户提出明确调整:只在对应页面修正,先调整对应契约测试,再改页面/资产,重新截图复核。
3. A05、A06 与 G01 空状态均已通过并完成状态同步;G04 已合并为 G03 `step=ancestor`,该双步骤已获用户通过;G07 已合并为 G06 三态。G06 当前朱砂题签候选只完成初始态新截图,尚待结果/无结果截图、审视和用户审美确认。
3. A05、A06 与 G01 空状态均已通过并完成状态同步;G04 已合并为 G03 `step=ancestor`,该双步骤已获用户通过;G07 已合并为 G06 三态。G06 三态候选和内部审视已完成,仍待用户视觉确认。
### 其后的模块顺序
### 当前唯一顺序:逐页视觉审核
1. **账号 A04--A06**:以已验收 A02 为认证样板,但每个页面保留各自的任务与状态,不能直接复制表单。绑定手机号以后归个人中心安全设置的独立入口;微信授权取消、失败、受限归 A06
2. **家谱 G03、G05--G12**:G07→G06 搜索流程已收敛;先由用户审美确认 G06 当前候选,并补齐同版三态截图;之后再推进家谱概览、世代字、申请与设置。用户明确授权连续推进时,先执行 T02→T01 状态收敛。
3. **世系树 T01--T08**:先建立树、成员档案、关系编辑三类代表页。
4. **家族内容 F01--F10**:动态、文章、相册、媒体上传分别建立内容档案式层级。
5. **人物记录 R01--R11**:人物档案、礼仪活动、成长时间线先定样板。
6. **通知 N01--N02**:区分未读、已读、时间和详情层级,不只依赖颜色。
7. **我的 M01--M10**:个人身份首页与安全设置先做,后续设置页按统一行式结构展开。
`ModulePage.vue`/`page-catalog.js` 中属于本轮模块的临时入口,必须在同一轮被真实页面替换并移除相应依赖;不得保留“新旧两套入口”或把通用壳伪称为精修完成。
54 条路由候选已经全部覆盖。用户从 `docs/规划.md` 指定或按清单顺序审核页面;只有用户明确通过才改 `[x]`,要求返工则改 `[!]` 并只修改对应页面。接口、Android 打包和真机复核均留在视觉审核之后
### 每个模块的固定工作流
@@ -174,7 +147,7 @@ node scripts/capture-chrome-page.js `
| 能力/技能 | 何时使用 | 项目中的正确做法 |
| --- | --- | --- |
| `product-design:index``product-design:audit` | 审视、评价或设计一个已运行页面/流程时;接管 G06 后的第一项视觉工作也必须使用。 | 先拿到真实路由截图,再依据 A01/G01 与页面任务写审视结论;不要靠源码猜好不好看。 |
| `product-design:index``product-design:audit` | 审视、评价或设计一个已运行页面/流程时。 | 先拿到真实路由截图,再依据 A01/G01 与页面任务写审视结论;不要靠源码猜好不好看。 |
| Product Design 的 `user-context``get-context``ideate``image-to-code`、Design QA 流程 | 需要探索方向、选择视觉方案、将已选样稿落地、或交付前比对时。 | 有明确视觉真源时先忠实落地;没有真源且需要新方向时先给可比较方案,选定后再实现;最后在 `design-qa.md` 诚实记录通过或阻塞。 |
| `imagegen` | 现有资产无法承担完整视觉面时。 | 先用 A01/G01 实图作为参考,明确输出是完整不透明面板还是透明叠加件;检查实际尺寸/Alpha 后再放入项目。不能用截图代替资产。 |
| `superpowers:brainstorming``superpowers:writing-plans` | 新模块或会改变页面行为的创作工作开始前。 | 先写清用户目标、交互和验收,不以“尽快”跳过设计决定。 |
+64
View File
@@ -0,0 +1,64 @@
# 视觉证据索引
> 本仓库只保留低负担交接证据:每页一张代表图,复杂模块使用联系表。完整 before/after、多尺寸、历史废稿和全部运行截图保存在项目外本地归档,不进入 Git。
## 完整本地归档
Windows 路径:`C:\Users\Rain\Desktop\job\jiapuapp-design-evidence-archive-2026-07-15`
归档内的 `design-full/` 是精简前完整 `docs/design/``tmp/` 是 ImageGen 与调试临时源文件。新电脑默认不需要这份归档;只有追溯历史决策或检查旧尺寸时才单独复制。
## 已验收视觉基准
- A01[启动/登录引导](screens/handoff/2026-07-13/A01-360x800.png)
- A02[账号登录](screens/handoff/2026-07-13/A02-after-360x800.png)
- A04[注册账号](screens/handoff/2026-07-14/A04-after-balance-360x800.png)
- A05[重置密码](screens/handoff/2026-07-14/A05-after-360x800.png)
- A06[登录状态](screens/handoff/2026-07-14/A06-after-360x800.png)
- G01[我的家谱](screens/handoff/2026-07-14/G01-default-after-360x800.png)
- G03[创建家谱](screens/handoff/2026-07-14/G03-create-after-360x800.png)
## F、R、N、M 默认审核入口
- [F03F10 联系表](screens/handoff/2026-07-14/all-page-candidates/00-family-contact-sheet.png)
- [R01R11 联系表](screens/handoff/2026-07-14/all-page-candidates/00-records-contact-sheet.png)
- [N02、M02M10 联系表](screens/handoff/2026-07-14/all-page-candidates/00-profile-notification-contact-sheet.png)
- [F01 家族动态](screens/handoff/2026-07-14/root-pages-audit/01-f01-list-360x800.png)
- [F02 发布动态](screens/handoff/2026-07-14/root-pages-audit/03-f02-form-360x800.png)
- [N01 消息中心](screens/handoff/2026-07-14/root-pages-audit/05-n01-list-360x800.png)
- [M01 我的首页](screens/handoff/2026-07-14/root-pages-audit/07-m01-ready-360x800.png)
## G 家谱候选
- [G05 家谱总览](screens/handoff/2026-07-14/g-module-audit/g05/01-g05-ready-360x800.png)
- G06[初始态](screens/handoff/2026-07-14/G06-selected-strip-final-initial-recheck-360x800.png)、[结果态](screens/handoff/2026-07-14/G06-selected-strip-final-results-360x800.png)、[无结果态](screens/handoff/2026-07-14/G06-selected-strip-final-empty-360x800.png)
- [G08 申请入谱](screens/handoff/2026-07-14/g-module-audit/applications/01-g08-form-360x800.png)
- [G09 我的申请](screens/handoff/2026-07-14/g-module-audit/applications/04-g09-list-360x800.png)
- [G10 申请审核](screens/handoff/2026-07-14/g-module-audit/applications/06-g10-list-360x800.png)
- [G11 家谱设置](screens/handoff/2026-07-14/g-module-audit/settings-poems/01-g11-form-360x800.png)
- [G12 字辈诗](screens/handoff/2026-07-14/g-module-audit/settings-poems/04-g12-list-360x800.png)
## T 世系与成员候选
- [T01 世系树](screens/handoff/2026-07-14/t01-audit/04-t01-tree-360x800.png)
- [T03 成员档案](screens/handoff/2026-07-14/t-module-audit/01-t03-detail-360x800.png)
- [T04 新增亲属](screens/handoff/2026-07-14/t-module-audit/03-t04-form-360x800.png)
- [T05 编辑成员](screens/handoff/2026-07-14/t-module-audit/04-t05-form-360x800.png)
- [T06 编辑关系](screens/handoff/2026-07-14/t-module-audit/05-t06-form-360x800.png)
- [T07 成员目录](screens/handoff/2026-07-14/t-module-audit/07-t07-list-360x800.png)
- [T08 成员状态](screens/handoff/2026-07-14/t-module-audit/09-t08-privacy-360x800.png)
## 风格锚点与设计记录
- [G01 美术锚点](references/G01-我的家谱-美术锚点.png)
- [公共操作图标锚点](references/公共操作图标-风格锚点.png)
- [页面与状态合并审计](2026-07-14_页面与状态合并审计.md)
- [G05 设计记录](G05_家谱总览_设计记录.md)
- [G08G10 设计记录](G08-G10_入谱申请链路_设计记录.md)
- [G11G12 设计记录](G11-G12_设置与字辈诗_设计记录.md)
- [T01T08 设计记录](T01-T08_世系与成员_设计记录.md)
- [F/R/N/M 设计记录](F-R-N-M_全量候选设计记录.md)
## 后续截图规则
新的运行截图仍输出到 `docs/design/screens/runtime/<日期>/`,该目录已被 `.gitignore` 排除。用户确认需要作为长期交接基准时,再把单张代表图复制到 `docs/design/screens/handoff/` 并更新本索引;不要把整轮截图重新加入 Git。
@@ -4,9 +4,9 @@
**Goal:** 将 T02 小屏、空数据和失败提示收敛进 T01,保留世系节点交互并以位图资产替代 CSS 表面。
**Architecture:** T01 读取 `state``genealogyId`,由一个 `treeState` 唯一管理四种同页状态。T02 文件与路由删除;所有节点/画布/底部信息表面由三个不透明位图承载。
**Architecture:** T01 读取 `state``genealogyId`,由一个 `treeState` 唯一管理四种同页状态。T02 文件与路由删除;所有节点/画布/底部信息表面复用现有完整不透明位图承载。
**Tech Stack:** uni-app、Vue 3、现有 mock `appApi`、ImageGen、PowerShell 静态契约、Chrome DevTools Protocol 冒烟。
**Tech Stack:** uni-app、Vue 3、页面内模拟数据、现有完整位图资产、PowerShell 静态契约、Chrome DevTools Protocol 冒烟。
## Global Constraints
@@ -16,22 +16,22 @@
### Task 1: TDD 契约(RED
- [ ] 创建 `tests/t01-tree-state-contract.ps1``tests/t01-tree-state-runtime-smoke.js`
- [ ] 静态契约要求 T02 路由/文件不存在,T01 含 `tree|landscape|empty|error`、三位图、T03/T04 跳转和无 CSS 表面;运行冒烟要求三种查询状态及 `genealogyId=1001` 节点跳转。
- [ ] 运行两个新测试,确认当前实现因 T02 仍存在和 T01 缺少状态节点而红灯。
- [x] 创建 `tests/t01-tree-state-contract.ps1``tests/t01-tree-state-runtime-smoke.js`
- [x] 静态契约要求 T02 路由/文件不存在,T01 含 `tree|landscape|empty|error`、三类完整位图、T03/T04 跳转和无 CSS 表面;运行冒烟要求三种查询状态及 `genealogyId=1001` 节点跳转。
- [x] 运行两个新测试,确认当前实现因 T02 仍存在和 T01 缺少状态节点而红灯。
### Task 2: 位图资产
### Task 2: 位图资产复用
- [ ] 用 ImageGen 生成 1122×1320 不透明 `t01-tree-canvas.png`、280×228 不透明 `t01-member-node.png`、1122×280 不透明 `t01-member-sheet.png`;均检查尺寸和四角 alpha
- [ ] 在 P00 登记路径、用途、尺寸、T01 引用与不透明属性
- [x] 审视现有完整资产后,复用 `g03-create-flow-panel.png``g06-search-input-wide.png``application-status-card.png`,不生成语义重复资产
- [x] 在 P00 登记 T01 与后续 T 页面引用
### Task 3: T01 同页状态与 T02 删除(GREEN
- [ ] 修改 `pages/tree/t01-tree-overview.vue`加载后由状态和真实成员确定 `treeState`;画布、节点、信息条使用位图;保留原有 T03/T04/T06/T07 跳转。
- [ ]`pages.json` 删除 `pages/tree/t02-tree-states`,删除 `pages/tree/t02-tree-states.vue`,移除 `data/page-catalog.js``t02`
- [ ] 运行新契约和运行冒烟转绿。
- [x] 修改 `pages/tree/t01-tree-overview.vue`:由状态和页面内模拟成员确定 `treeState`;画布、节点、信息条使用完整位图;保留 T03/T04/T06/T07 跳转。
- [x]`pages.json` 删除 `pages/tree/t02-tree-states`,删除文件并移除 `page-catalog.js``t02`
- [x] 运行新契约和运行冒烟转绿。
### Task 4: 收口
- [ ] 全量路由契约和 A03 路由计数更新为 54;当前文档同步 T02→T01 已完成、G06 仍待审美确认
- [ ] 截图并审视 T01 tree/landscape/empty/error412×915 tree运行全部静态契约、相关冒烟和 `git diff --check`
- [x] 全量路由契约和 A03 路由计数更新为 54;当前文档同步 T02→T01 已完成。
- [x] 截图并审视 T01 tree/landscape/empty/error412×915 tree相关静态契约和冒烟通过。最终全量 `git diff --check` 留到所有模块候选完成前统一执行
@@ -0,0 +1,213 @@
# 交接文档与视觉证据精简实施计划
> **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:executing-plans` to implement this plan task-by-task. The user explicitly forbids subagents and worktrees. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 把当前交接整理为一个无陈旧状态、低图片阅读负担、能让新 GPT 直接恢复技能和审核流程的入口。
**Architecture:** `docs/交接记录.md` 是快速入口,`docs/design/视觉设计交接手册.md` 承担详细操作说明,新增 `docs/design/视觉证据索引.md` 集中保存截图路径;契约测试负责阻止旧状态和技能说明缺失。所有现有 PNG 原地保留。
**Tech Stack:** Markdown、PowerShell 契约测试、Git 只读检查。
## Global Constraints
- 仅修改交接、证据索引、早期报告说明和对应测试,不修改页面、路由、接口或运行资产。
- 54 条最终路由保持 7 个 `[x]`、47 个 `[~]`;候选不能写成用户已验收。
- 不删除、不移动任何现有 PNG。
- 不使用 worktree、多代理、`git add`、commit、push、上传、reset 或 checkout。
- 正文默认每页只指向一张 360×800 代表图;复杂状态优先使用一张状态联系表;历史对比图只进入归档索引。
---
### Task 1: 建立交接文档契约
**Files:**
- Create: `tests/handoff-documentation-contract.ps1`
**Interfaces:**
- Consumes: `docs/交接记录.md``docs/design/视觉设计交接手册.md``docs/规划.md`
- Produces: 一个可重复运行的文档状态与技能说明契约
- [x] **Step 1: 写入预期失败的契约测试**
测试必须断言:
```powershell
$handoff = Get-Content -Raw -Encoding UTF8 'docs/交接记录.md'
$manual = Get-Content -Raw -Encoding UTF8 'docs/design/视觉设计交接手册.md'
$planning = Get-Content -Raw -Encoding UTF8 'docs/规划.md'
foreach ($required in @(
'54 条最终路由', '7 个已验收', '47 个待审核候选',
'product-design:index', 'product-design:audit', 'imagegen',
'superpowers:test-driven-development',
'superpowers:systematic-debugging',
'superpowers:verification-before-completion',
'docs/design/视觉证据索引.md'
)) {
if ($handoff -notmatch [regex]::Escape($required)) {
throw "handoff missing: $required"
}
}
foreach ($stale in @(
'六个已验收',
'结果态和无结果态的同版重新截图尚未完成',
'结果态/无结果态的同版截图和用户审美确认尚未完成',
'下一项按 F、R、N、M 推进'
)) {
if (($handoff + $manual) -match [regex]::Escape($stale)) {
throw "stale handoff text remains: $stale"
}
}
$approved = ([regex]::Matches($planning, '- \[x\]')).Count
$candidate = ([regex]::Matches($planning, '- \[~\]')).Count
if ($approved -ne 7 -or $candidate -ne 47) {
throw "planning counts changed: approved=$approved candidate=$candidate"
}
```
- [x] **Step 2: 运行测试并确认 RED**
Run:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File tests/handoff-documentation-contract.ps1
```
Expected: FAIL,至少报告当前交接缺少 `docs/design/视觉证据索引.md` 或仍包含陈旧 G06 表述。
### Task 2: 精简快速入口并建立证据索引
**Files:**
- Modify: `docs/交接记录.md`
- Modify: `docs/design/视觉设计交接手册.md`
- Create: `docs/design/视觉证据索引.md`
- Modify: `.superpowers/sdd/task-1-report.md`
**Interfaces:**
- Consumes: `docs/规划.md` 的 7/47 审核状态、现有 `docs/design/screens/runtime/` 证据目录
- Produces: 快速入口、详细恢复手册、低噪声证据归档和早期报告边界说明
- [x] **Step 1: 重写快速交接入口**
`docs/交接记录.md` 只保留以下五节:
```markdown
# 家谱 APP 交接记录
## 1. 当前准确停点
54 条最终路由;7 个已验收;47 个待审核候选;下一步逐页审核,不对接接口。
## 2. 新 GPT 启动顺序
必读文件、`git status --short`、中文复述停点、禁止修改冻结页。
## 3. 必须调用的能力
Product Design、ImageGen、TDD、系统化排错、完成前验证的触发条件。
## 4. 视觉审核降噪规则
每页一张代表图;复杂状态一张联系表;历史对比按需展开。
## 5. 禁止事项与验证
Git、多代理、worktree、接口对接禁令,以及测试、截图和 `git diff --check`
```
- [x] **Step 2: 修正详细手册中的陈旧停点**
`docs/design/视觉设计交接手册.md` 中的数量统一为 7/47;删除 G06 三态截图未完成和“继续推进 F/R/N/M”的旧描述;保留 G06 未获用户视觉验收、H5 不能替代 Android 真机复核两条边界。
- [x] **Step 3: 新建视觉证据索引**
`docs/design/视觉证据索引.md` 按以下层级组织,所有条目只链接现有文件或目录:
```markdown
# 视觉证据索引
## 默认审核入口
- 全页面候选联系表目录
- 根页面联系表
- G、T 模块联系表
## 已验收基准
- A01、A02、A04、A05、A06、G01、G03 的代表证据
## 候选设计记录
- G、T、F/R/N/M 设计记录
## 历史审计证据
- before/after、多尺寸和废稿目录;仅在回归或争议时展开
```
- [x] **Step 4: 标注早期专项报告的职责边界**
`.superpowers/sdd/task-1-report.md` 标题下增加:
```markdown
> 历史说明:本文件仅记录早期 A02 Task 1 的 RED 验证,不是当前项目总交接入口。当前停点以 `docs/交接记录.md` 和 `docs/规划.md` 为准。
```
- [x] **Step 5: 运行契约并确认 GREEN**
Run:
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File tests/handoff-documentation-contract.ps1
```
Expected: `HANDOFF-DOCUMENTATION-CONTRACT PASS`
### Task 3: 收口验证
**Files:**
- Verify only: `docs/交接记录.md`
- Verify only: `docs/design/视觉设计交接手册.md`
- Verify only: `docs/design/视觉证据索引.md`
- Verify only: `.superpowers/sdd/task-1-report.md`
- Verify only: `tests/handoff-documentation-contract.ps1`
**Interfaces:**
- Consumes: Task 1 与 Task 2 的文档和契约
- Produces: 可交接的验证证据
- [x] **Step 1: 检查陈旧表述和技能清单**
Run:
```powershell
rg -n "六个已验收|结果态和无结果态.*未完成|下一项按 F、R、N、M 推进" docs/交接记录.md docs/design/视觉设计交接手册.md
rg -n "product-design:index|product-design:audit|imagegen|test-driven-development|systematic-debugging|verification-before-completion" docs/交接记录.md
```
Expected: 第一条无匹配;第二条六类能力全部有匹配。
- [x] **Step 2: 确认规划计数未改变**
Run:
```powershell
$text = Get-Content -Raw -Encoding UTF8 'docs/规划.md'
"approved=$(([regex]::Matches($text, '- \[x\]')).Count)"
"candidate=$(([regex]::Matches($text, '- \[~\]')).Count)"
```
Expected: `approved=7``candidate=47`
- [x] **Step 3: 确认没有删除 PNG**
Run:
```powershell
git diff --name-status -- '*.png'
```
Expected: 不出现以 `D` 开头的 PNG 记录。
- [x] **Step 4: 最终格式检查**
Run:
```powershell
git diff --check
```
Expected: exit code 0。允许 Git 输出 LF/CRLF 提示,但不允许 whitespace error。
@@ -0,0 +1,47 @@
# 仓库精简与交接证据保留实施计划
> **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:executing-plans`. The user forbids subagents, worktrees and Git write operations.
**Goal:** 将当前可交接项目整理为约 30MB 的 Git 快照,同时在项目外完整保留设计审计资料。
**Architecture:** 使用 `tests/repository-handoff-size-contract.ps1` 约束标准路径、证据体积和忽略规则;先暂存精简证据,再把完整 `docs/design/``tmp/` 移到固定外部归档,最后恢复精简 `docs/design/` 并更新索引。
**Tech Stack:** Markdown、PowerShell、Git 只读检查。
## Global Constraints
- 不修改 `static/`、页面、路由、接口或运行行为。
- 不删除完整证据,只移动到 `C:\Users\Rain\Desktop\job\jiapuapp-design-evidence-archive-2026-07-15`
- 不使用多代理、worktree、`git add`、commit、push、reset、checkout 或历史重写。
### Task 1: 建立精简契约
**Files:**
- Create: `tests/repository-handoff-size-contract.ps1`
- [x] 写入标准文档路径、证据上限、忽略规则和索引链接检查。
- [x] 运行测试,确认因缺少 `.gitignore` 或证据超限而 RED。
### Task 2: 建立外部完整归档并恢复精简证据
**Files:**
- Create: `.gitignore`
- Modify: `docs/design/视觉证据索引.md`
- Move outside repository: full original `docs/design/`
- Move outside repository: `tmp/` and `tmp-g01-icon-audit.png`
- Restore: compact `docs/design/`
- [x] 将全部设计 Markdown、两张风格锚点和批准的代表截图复制到项目内临时保留区。
- [x] 校验源和目标绝对路径后,将完整 `docs/design/` 移到固定外部归档。
- [x]`tmp/` 和根目录临时审计图移入归档。
- [x] 把临时保留区恢复为标准 `docs/design/`
- [x] 更新视觉证据索引和 `.gitignore`
- [x] 运行精简契约并确认 GREEN。
### Task 3: 收口验证
- [x] 确认外部归档大于 90MB。
- [x] 确认精简截图不超过 20MB、35 个文件。
- [x] 确认 `git diff --name-status -- static` 无输出。
- [x] 运行 `tests/handoff-documentation-contract.ps1`
- [x] 运行 `git diff --check`
@@ -20,12 +20,11 @@
## 视觉
- 保留 `PageHeader`、暖宣纸与朱砂/古金/墨褐的已验收语言,不触及 A01、A02、A04--A06、G01、G03。
- 新增不透明位图:世系画布 `t01-tree-canvas.png`、成员节点 `t01-member-node.png`、底部成员信息条 `t01-member-sheet.png`。它们承载纸纹、边框、关系线和卡片表面;Vue 只叠放真实文本、滚动和点击层。
- 完整画布含轻古金三代关系线,适配当前 mock 的一祖、两中代、三后代布局;远端节点仍使用同一空白节点皮肤,保持可读优先。
- 复用已验收体系中的完整不透明位图:`g03-create-flow-panel.png` 作为世系画布,`g06-search-input-wide.png` 作为成员节点,`application-status-card.png` 作为底部信息条Vue 只叠放真实文本、滚动和点击层,避免新增语义重复资产
- `landscape``empty``error` 使用画布内留白与现有透明云纹,不再生成一个通用状态卡页。
## 契约与验证
- 先红灯:T01 存在且 T02 路由/文件不存在;T01 有四态、三位图、成员资料与新增亲属跳转;节点和信息条不允许 CSS 构造表面。
- 先红灯:T01 存在且 T02 路由/文件不存在;T01 有四态、三类完整位图、成员资料与新增亲属跳转;节点和信息条不允许 CSS 构造表面。
- 运行冒烟:默认 `?state=landscape``?state=empty``?state=error` 分别显示同页状态;`?genealogyId=1001` 显示节点并点选进入 T03。
- 更新全量路由契约至 54,更新交接/P00/规划;截图至少包含 tree、empty、error 与 412×915 tree。
@@ -0,0 +1,57 @@
# 交接文档与视觉证据精简设计
> 日期:2026-07-15
> 状态:用户已确认“正文精简、证据不删除”方向
> 范围:仅整理交接、审核入口与证据索引,不修改页面代码、视觉资产、路由或接口
## 目标
让更换电脑后的新 GPT 只阅读一个简洁入口,就能准确知道当前停点、必须调用的技能、禁止事项、页面审核方式和验证要求;同时减少连续阅读前后对比图、多尺寸截图与历史废稿造成的视觉疲劳。
## 信息结构
1. `docs/交接记录.md` 作为唯一快速入口,只保留:
- 54 条最终路由、7 个已验收页、47 个待审核候选的准确状态;
- 下一步是按 `docs/规划.md` 逐页审核,而不是继续批量设计或对接接口;
- 新 GPT 的必读顺序、技能调用顺序、禁止事项和最小恢复检查;
- 一处“视觉证据归档”链接,不逐张罗列历史对比图。
2. `docs/design/视觉设计交接手册.md` 保留完整操作方法,但删除重复、陈旧的截图清单和过期停点;截图规则改为“审核时默认只看一张代表图,状态复杂时看一张状态联系表,发现问题后才展开历史对比与多尺寸证据”。
3. 新增 `docs/design/视觉证据索引.md`,集中保存现有代表截图、状态联系表、历史前后对比和模块设计记录的路径。证据文件不删除、不移动。
4. `.superpowers/sdd/task-1-report.md` 明确标记为早期 A02 专项报告,不再承担当前总交接职责;当前交接以 `docs/交接记录.md` 为准。
## 新 GPT 的启动契约
交接入口必须明确写出以下顺序:
1. 完整阅读 `AGENTS.md``docs/交接记录.md``docs/规划.md` 和视觉交接手册,先运行 `git status --short`,不得覆盖未提交改动。
2. 设计或审视页面时,先调用 `product-design:index`;基于真实运行截图调用 `product-design:audit`
3. 只有缺少完整位图视觉资产时才调用 `imagegen`;按钮、卡片、边框和装饰面不得用 CSS 伪造。
4. 修改页面行为、路由或可审计视觉结构前调用 `superpowers:test-driven-development`,先更新最小契约测试。
5. 测试、截图、路由或构建异常时调用 `superpowers:systematic-debugging`
6. 宣称完成前调用 `superpowers:verification-before-completion`,运行受影响测试、真实截图复核和 `git diff --check`
7. 不使用 worktree、多代理、`git add`、commit、push、上传、reset 或 checkout。
## 视觉审核降噪规则
- 默认审核材料:每页一张 360×800 代表截图。
- 同页包含关键状态时:使用一张状态联系表代替多张连续截图。
- 412×915、小屏、多尺寸和前后对比图只在发现比例问题、回归问题或用户要求时展开。
- 历史废稿与 before/after 图保留在证据索引的“历史审计”区域,不出现在快速交接正文。
- 用户明确通过一页后才把 `docs/规划.md``[~]` 改为 `[x]`;要求返工时改为 `[!]`
## 需要修正的当前矛盾
- 将已验收数量统一为 7A01、A02、A04、A05、A06、G01、G03。
- 将候选数量统一为 47,并保持“候选不等于用户验收”。
- 删除 G06“结果态、无结果态截图尚未完成”的陈旧描述;保留 G06 尚未获用户视觉验收的事实。
- 删除“下一项继续推进 F/R/N/M”的旧停点,改为“全部候选已覆盖,等待逐页审核”。
- 明确 H5 截图是候选审计证据,最终 Android/HBuilderX 真机或模拟器复核仍在视觉审核之后。
## 验证
- 用文本检索确认交接文档不再出现“六个已验收”“G06 结果态未截图”“继续推进 F/R/N/M”等陈旧表述。
- 确认快速交接入口包含全部六类技能调用规则和 Git/多代理禁令。
- 确认 `docs/规划.md` 仍为 7 个 `[x]`、47 个 `[~]`、0 个遗漏项。
- 运行 `git diff --check`
- 不删除任何现有 PNG,不修改页面、路由、接口或运行资产。
@@ -0,0 +1,33 @@
# 仓库精简与交接证据保留设计
> 日期:2026-07-15
> 状态:用户已批准执行
> 范围:整理设计证据和临时文件,不修改页面、路由、接口或 `static/` 运行资产
## 目标
把可随 Git 上传的当前快照控制在约 30MB,同时让新 GPT 仍能通过标准 `docs/design/` 路径阅读视觉规范、设计记录和代表截图。完整审计证据移到项目外的本地归档,不删除。
## 文件边界
- 完整保留:源码、测试、`static/``docs/design/*.md``docs/design/references/` 两张风格锚点。
- Git 内保留:7 个已验收页面代表图、F/R/N/M 三张联系表、根页面代表图、G05/G06/G08G12 代表图、T01/T03T08 代表图。
- 项目外归档:其余 before/after、多尺寸、历史废稿、完整运行截图以及 `tmp/` 临时源文件。
- 新增 `.gitignore`:排除 `tmp/``unpackage/`、临时审计图和误放到 `docs/superpowers/specs/design/` 的目录。
- 更新 `docs/design/视觉证据索引.md`:只链接 Git 内保留的证据;完整历史归档写明本机路径和非 Git 属性。
## 归档位置
`C:\Users\Rain\Desktop\job\jiapuapp-design-evidence-archive-2026-07-15`
归档目录包含原始 `docs/design/` 完整副本和项目根 `tmp/` 临时源文件。移动前必须确认源目录位于项目内、目标目录位于上述固定路径且目标不存在;不得覆盖已有目录。
## 验收
- `docs/design/` 标准路径恢复,17 个设计 Markdown 均保留。
- `docs/design/screens/` 不超过 20MB、35 个文件。
- `docs/design/视觉证据索引.md` 的 Markdown 链接全部有效。
- `static/` 无任何内容差异。
- 完整外部归档存在且大于 90MB。
- 精简契约、交接契约和 `git diff --check` 通过。
- 不执行 `git add`、commit、push、reset、checkout 或历史重写。
+36 -21
View File
@@ -1,33 +1,48 @@
# 家谱 APP 交接记录
> 更新时间2026-07-14
> 完整恢复手册见:[视觉设计交接手册](design/视觉设计交接手册.md)。本文件只保留当前真实停点,避免与历史草案互相矛盾
> 更新日期2026-07-15
> 这是更换电脑或交给新 GPT 时的唯一快速入口。详细操作见 [视觉设计交接手册](design/视觉设计交接手册.md),页面审核状态以 [总规划](规划.md) 为准
## 当前状态
## 1. 当前准确停点
- `pages.json` 登记 55 条最终编号路由,并由 `tests/full-page-visual-contract.ps1` 约束
- 用户已经验收并冻结可见效果的页面:A01 启动/登录引导、A02 账号登录、A04 注册账号、A05 重置密码、A06 登录状态、G01 我的家谱
- A02 已完成资产化重做、运行截图与自动回归,并于 2026-07-14 获用户视觉验收;A03 已删除,A02 的短信 Tab 是唯一手机号验证码登录入口;A04 已于 2026-07-14 完成平衡修订并获用户视觉验收;A05、A06 已于同日获用户视觉验收。不能改变 A01、A02、A04、A05、A06、G01、G03 的已验收可见效果。G01 的 `?state=empty` 已获用户审美确认;G04 已按用户确认合并为 G03 的 `?step=ancestor`,G03 双步骤已获用户继续授权通过。G07 已收敛为 G06 的初始/结果/无结果状态。G06 经过多轮审视后,用户选定最近 ImageGen 第 3 稿的「朱砂题签 + 独立输入框 + 独立按钮」方向;题签中原本的通用印玺已改为项目真实 `brand-seal.png`。当前仅保存了该最终候选的初始态运行图,结果态和无结果态的同版重新截图尚未完成;**G06 尚未获用户视觉验收,不能写成已完成或冻结。**
- 其余页面可浏览,但包含 `ModulePage.vue`/`page-catalog.js` 的临时第一版壳,不能当作最终视觉设计
- 不提交、不推送、不上传 Git;由用户自行处理
- `pages.json` 当前登记 **54 条最终路由**;重复状态已经收敛到同一页面,例如 G02→G01、G04→G03、G07→G06、T02→T01
- 当前有 **7 个已验收**页面:A01、A02、A04、A05、A06、G01、G03。除非用户提出明确调整,不得改变这些页面已经验收的可见效果
- 其余 **47 个待审核候选**已经完成页面实现、H5 运行截图和内部视觉审视,统一在 `docs/规划.md` 标记为 `[~]`。候选不等于用户验收,只有用户明确通过后才能改为 `[x]`;要求返工时改为 `[!]`
- 下一步是按 `docs/规划.md` 逐页视觉审核,不再批量新增页面。接口资料只用于理解功能、字段和状态位置;本阶段不对接接口
- H5 Chrome 截图是候选审计证据,最终 Android/HBuilderX 真机或模拟器复核仍需在视觉审核后完成
## 新电脑的第一步
## 2. 新 GPT 启动顺序
1. 按顺序阅读 `AGENTS.md`、本文件、[完整交接手册](design/视觉设计交接手册.md)、[总规划](规划.md)、[D1 视觉规范](design/D1_安卓视觉规范与页面壳.md)、[P00 资产台账](design/P00_页面结构与资产清单.md)、`docs/superpowers/plans/2026-07-13-product-design-visual-refinement.md``design-qa.md`;然后先用中文向用户复述当前停点,不改代码
2. 保留工作区改动,运行 `git status --short`;不执行 reset、checkout 或覆盖用户文件
3. A02、A04、A05、A06 已验收、A03 已删除;A04 最终证据为 `A04-after-balance-360x800.png``A04-after-balance-412x915.png`A05 证据为 `A05-after-360x800.png``A05-after-412x915.png`A06 证据为 `A06-after-360x800.png``A06-after-412x915.png``A06-restricted-360x800.png`。G01 默认态前后比对为 `G01-default-before-after-360x800.png`,空状态已验收;G03 双步骤证据为 `G03-create-after-360x800.png``G03-ancestor-after-360x800.png``G03-ancestor-after-412x915.png`,均已获用户继续授权通过。G06 的当前候选图是 `G06-selected-strip-final-initial-360x800.png`:它只证明最后选定样式的初始态。旧 `G06-no-panel-*` 图仅保留为迭代历史,不可当作当前最终三态证据;新的结果态、无结果态截图与用户验收都待补
4. 需要自行截图时,用 `scripts/capture-chrome-page.js` 连接专用 Chrome 的调试端口 `9222`;完整启动命令和截图方式见交接手册第 5 节
1. 全程使用中文。先完整阅读 `AGENTS.md`、本文件、`docs/规划.md``docs/design/视觉设计交接手册.md``docs/design/D1_安卓视觉规范与页面壳.md``docs/design/P00_页面结构与资产清单.md``design-qa.md`
2. 运行 `git status --short`,识别并保留全部未提交改动。不要把旧提交状态当成当前工作区状态
3. 先向用户简洁复述:54 条路由、7 个已验收、47 个待审核,以及准备审核的具体页面;在用户给出页面反馈前不要盲目重做
4. 审核时先看 [视觉证据索引](design/视觉证据索引.md) 的默认代表图;发现具体问题后再展开多尺寸、before/after 或历史废稿
## 已知验证与限制
## 3. 必须调用的能力
- A02 相关的 `a02-asset-alpha-audit``a01-a02-ui-contract``a02-register-entry-contract``capture-chrome-page-contract``compile-audit` 和全量页面路由契约均已在本轮通过;后续修改仍要重新运行受影响检查。
- `design-qa.md` 当前是 `final result: accepted`,仅记录已冻结 A02;A02 已不再阻塞后续页面,但后续页面必须分别经过截图、审视和用户验收。A06、G01 两个状态与 G03 双步骤均已获用户确认;G06 的最终候选只有初始态新图,三态复核与用户审美确认均待补。
- 现有运行图来自 H5 Chrome 调试;最终 Android/HBuilderX 真机/模拟器视觉复核仍待补做,不能被 H5 截图替代。
新 GPT 必须实际具备并按触发条件调用:
## 给新 GPT 的直接任务说明
- `product-design:index`:开始设计、审视或评价页面时先调用,用于选择正确的产品设计工作流。
- `product-design:audit`:必须基于真实运行截图审视页面,不能只看源码判断好不好看。
- `imagegen`:仅在缺少完整位图视觉资产时调用。完整按钮、卡片、边框和装饰面必须使用独立位图,不能用 CSS 伪造。
- `superpowers:test-driven-development`:修改页面行为、路由或可审计视觉结构前,先写或更新最小契约测试并确认 RED。
- `superpowers:systematic-debugging`:测试、截图、路由或构建出现异常时,先复现并定位根因再修改。
- `superpowers:verification-before-completion`:宣称完成前,运行受影响测试、真实截图复核和 `git diff --check`
这是一个高质量的 uni-app Android 家谱视觉设计任务,不是 CSS 微调任务。先读取本文件列出的必读材料和技能说明,保留工作区全部未提交改动,不使用 worktree、多代理、`git add``commit``push`、上传、`reset``checkout`
能力缺失时应先安装或启用同等能力,不得假装已经完成视觉审计、位图生成或验证
当前第一优先级不是开启新页面:先向用户展示并审视 `docs/design/screens/runtime/2026-07-14/G06-selected-strip-final-initial-360x800.png`,说明 G06 仍待验收。只有用户要求继续 G06 时,才先用 Product Design 对真实运行页面截图审视;若要改行为、路由或可审计视觉结构,先写/更新最小失败契约测试,再实现。继续时要补最后选定样式的结果态和无结果态截图、运行 G06 静态契约与 Chrome 冒烟、更新 `design-qa.md`,再请求用户审美确认。用户明确验收 G06 后,下一优先级才是 T02→T01 的世系树状态收敛(除非用户给出新的优先级)。
## 4. 视觉审核降噪规则
新 GPT 必须实际具备并调用:`product-design:index``product-design:audit`(基于真实截图审视)、`imagegen`(仅在缺完整位图资产时生成)、`superpowers:test-driven-development`(先契约测试)、`superpowers:systematic-debugging`(测试/截图/路由/构建异常时先定位)、`superpowers:verification-before-completion`(宣称完成前测试、截图和 `git diff --check`)。完整按钮、卡片、边框和装饰面必须使用独立位图;CSS 仅用于布局、文字、状态与真实交互
- 默认每页只看一张 360×800 代表截图
- 同页有多个关键状态时,优先看一张状态联系表,不连续展示多张相似截图。
- 412×915、小屏、多尺寸和前后对比图仅在发现比例问题、回归问题或用户要求时展开。
- 历史废稿和 before/after 证据不删除,但只保留在 `docs/design/视觉证据索引.md` 的历史审计区。
- 审核结论记录在 `docs/规划.md`;不要因为内部测试或 Product Design 审视通过就替用户勾选。
## 5. 禁止事项与完成验证
- 不使用 worktree 或多代理。
- 不执行 `git add`、commit、push、上传、reset、checkout,也不覆盖用户现有文件。
- 不擅自对接接口、修改接口契约、打 Android 包或把截图放入 `static/assets/` 当运行资源。
- 只修改用户当前反馈涉及的页面和对应测试、截图、设计记录;不要顺手重构冻结页或相邻模块。
- 完成一次页面返工前,至少运行对应契约测试、运行时 smoke、真实路由截图复核和 `git diff --check`;无法执行的检查必须明确说明。
+65 -48
View File
@@ -2,16 +2,16 @@
> 电脑或 GPT 更换时,先阅读:[项目交接记录](交接记录.md)。
> 当前阶段:Product Design 视觉精修已启动55 条路由第一版可浏览,A01、A02、A04、A05、A06、G01 两种状态与 G03 `create|ancestor` 双步骤已获用户视觉验收;G07 已收敛到 G06 初始/结果/无结果状态。G06 最新朱砂题签候选只完成初始态截图,结果/无结果同版截图与用户审美确认待补
> 当前阶段:Product Design 视觉精修持续推进54最终路由可浏览,A01、A02、A04、A05、A06、G01 两种状态与 G03 `create|ancestor` 双步骤已获用户视觉验收;G 模块与 T 模块候选稿已完成,统一等待全量设计完成后逐页审核
> 适用端:Android `uni-app`HBuilderX 打包)
> 页面总量:55 个独立页面/状态单元;当前已注册 55 条最终编号路由。
> 页面总量:54 个独立页面/状态单元;当前已注册 54 条最终编号路由。
## 1. 本轮目标与边界
- 只做 Android 用户端;不做 iOS、H5、PC 管理端、后台管理端或官网。
- 本窗口以“全量覆盖后集中精修”为顺序推进:先让 55 条独立路由拥有统一视觉与本地可浏览入口,再按截图集中修改。
- 本窗口以“全量覆盖后集中精修”为顺序推进:先让 54 条独立路由拥有统一视觉与本地可浏览入口,再按截图集中修改。
- 已由用户验收的 A01 启动/登录引导、A02 账号登录、A04 注册账号、A05 重置密码、A06 登录状态与 G01 默认有家谱态是**冻结视觉基准**。可重整其内部目录和复用方式,但已验收状态的 412 × 915 可见效果不得改变。
- 55 条最终路由与文件清单由 `tests/full-page-visual-contract.ps1` 单一维护;代码覆盖不等同于用户视觉验收完成。
- 54 条最终路由与文件清单由 `tests/full-page-visual-contract.ps1` 单一维护;代码覆盖不等同于用户视觉验收完成。
- 不新增业务接口、真实账号联调、Android 打包或设计清单以外的功能。
## 2. 唯一依据与完成口径
@@ -61,18 +61,20 @@
- 非直观跳转、状态分支、资产图层和关键样式必须写中文注释,说明用途和约束;不为显而易见的单行属性堆无意义注释。
- 每轮改动后删除本轮产生的无用导入、变量、函数、路径和资产。
## 5. 55 个独立页面/状态单元
## 5. 54 个独立页面/状态单元
| 模块 | 范围 | 数量 | 当前状态 |
| --- | --- | ---: | --- |
| 账户与首次使用 | A-01、A-02、A-04 至 A-06 | 5 | A01、A02、A04、A05、A06 已验收 |
| 家谱 | G-01、G-03、G-05、G-06、G-08 至 G-12 | 9 | G01 两种状态与 G03 双步骤已验收;G06 当前候选只完成初始态新图,结果/无结果复核与用户确认待补;其余未完成 |
| 世系树与成员 | T-01 至 T-08 | 8 | 未完成 |
| 家族内容 | F-01 至 F-10 | 10 | 未完成 |
| 人物、礼仪与档案 | R-01 至 R-11 | 11 | 未完成 |
| 消息 | N-01 至 N-02 | 2 | 未完成 |
| 个人中心 | M-01 至 M-10 | 10 | 未完成 |
| **合计** | | **55** | **已验收 7 个;G06 当前候选待补三态复核与确认** |
| 家谱 | G-01、G-03、G-05、G-06、G-08 至 G-12 | 9 | G01 两种状态与 G03 双步骤已验收;G05、G06、G08 至 G12 候选稿待用户逐页审核 |
| 世系树与成员 | T-01、T-03 至 T-08 | 7 | T02 已收敛为 T01 同页状态;7 个页面候选稿待用户逐页审核 |
| 家族内容 | F-01 至 F-10 | 10 | 10 个页面候选稿待用户逐页审核 |
| 人物、礼仪与档案 | R-01 至 R-11 | 11 | 11 个页面候选稿待用户逐页审核 |
| 消息 | N-01 至 N-02 | 2 | 2 个页面候选稿待用户逐页审核 |
| 个人中心 | M-01 至 M-10 | 10 | 10 个页面候选稿待用户逐页审核 |
| **合计** | | **54** | **已验收 7 个;其余 47 个均已形成 `[~]` 候选,等待用户逐页审核** |
视觉审核标记由用户逐页确认:`[ ]` 待设计,`[~]` 候选稿已完成、待用户审核,`[x]` 用户已验收,`[!]` 用户要求返工。Codex 只能把页面推进到 `[~]`;只有用户明确确认后才能改为 `[x]`。每个候选页面必须保留关键状态截图目录,便于连续勾选直至 54 个页面全部验收。
### 5.1 账户与首次使用
@@ -86,58 +88,73 @@
- [x] G-01 我的家谱:已创建、已加入、通知入口与 `?state=empty` 无家谱状态均获用户视觉验收。
- [x] G-03 创建家谱:`step=create|ancestor` 管理创建表单与首代录入,已获用户视觉验收,冻结可见效果。
- [ ] G-05 家谱总览。
- [ ] G-06 公开家谱搜索与筛选:已合并 G07 的初始、结果与无结果状态;用户选定朱砂题签候选,当前仅初始态新图,待补结果/无结果同版截图、审视与用户审美确认
- [ ] G-08 申请加入提交成功审核
- [ ] G-09 我的申请记录。
- [ ] G-10 管理员申请审核与确认。
- [ ] G-11 家谱设置、公开范围与访问说明。
- [ ] G-12 字辈诗列表、详情与维护。
- [~] G-05 家谱总览:候选稿已完成,含正常、空、失败状态与 360 × 800/412 × 915 截图,待用户视觉审核
- [~] G-06 公开家谱搜索与筛选:已合并 G07 的初始、结果与无结果状态;朱砂题签候选及三态运行截图已完成,待用户视觉审核
- [~] G-08 申请加入提交成功:候选稿已完成,使用页面内模拟交互,不对接接口,待用户视觉审核。
- [~] G-09 我的申请记录:候选稿已完成,含列表、空、失败状态,待用户视觉审核
- [~] G-10 管理员申请审核与确认:候选稿已完成,含列表、空、失败与审核确认交互,待用户视觉审核
- [~] G-11 家谱设置、公开范围与访问说明:候选稿已完成,含表单、成功、失败状态与双尺寸截图,待用户视觉审核
- [~] G-12 字辈诗列表、空态与维护:候选稿已完成,含列表、空、编辑、失败状态与双尺寸截图,待用户视觉审核
### 5.3 世系树与成员
- [ ] T-01 世系树总览。
- [ ] T-02 小屏提示、无成员与加载失败状态
- [ ] T-03 成员档案详情
- [ ] T-04 新增直系亲属
- [ ] T-05 编辑成员资料
- [ ] T-06 编辑亲属关系与冲突提示
- [ ] T-07 成员目录与搜索
- [ ] T-08 去世、隐私隐藏和无权限等状态。
- [~] T-01 世系树总览:已收敛 T02 的横向提示、空态与失败状态,含树态和双尺寸截图,待用户视觉审核
- [~] T-03 成员档案详情:含详情与失败状态,待用户视觉审核
- [~] T-04 新增直系亲属:含表单与保存结果,待用户视觉审核
- [~] T-05 编辑成员资料:含表单与保存结果,待用户视觉审核
- [~] T-06 编辑亲属关系与冲突提示:含表单、冲突与失败状态,待用户视觉审核
- [~] T-07 成员目录与搜索:含列表、搜索、空态与失败状态,待用户视觉审核
- [~] T-08 去世、隐私隐藏和无权限状态:三态留在同一路由,待用户视觉审核
### 5.4 家族内容
- [ ] F-01 家族首页/动态流。
- [ ] F-02 发布动态。
- [ ] F-03 动态详情、评论、点赞与删除确认
- [ ] F-04 谱文分类与文章列表。
- [ ] F-05 谱文详情。
- [ ] F-06 新建/编辑谱文。
- [ ] F-07 相册列表。
- [ ] F-08 相册详情与照片墙。
- [ ] F-09 图片预览、上传与失败状态。
- [ ] F-10 视频列表、详情与接口未开放状态
- [~] F-01 家族首页/动态流:列表、空态、失败态与双尺寸截图已完成,待用户视觉审核
- [~] F-02 发布动态:表单、成功与失败状态已完成,待用户视觉审核
- [~] F-03 动态详情、评论入口与操作结果,待用户视觉审核
- [~] F-04 谱文分类与文章列表,待用户视觉审核
- [~] F-05 谱文详情,待用户视觉审核
- [~] F-06 新建/编辑谱文,待用户视觉审核
- [~] F-07 相册列表,待用户视觉审核
- [~] F-08 相册详情与照片墙入口,待用户视觉审核
- [~] F-09 图片选择、上传与失败状态,待用户视觉审核
- [~] F-10 视频服务说明状态,待用户视觉审核
### 5.5 人物、礼仪与档案
- [ ] R-01 人物录列表R-02 人物录详情与编辑
- [ ] R-03 贺礼列表;R-04 贺礼新增、详情与删除确认
- [ ] R-05 礼仪活动列表;R-06 礼仪详情;R-07 新建/编辑礼仪
- [ ] R-08 成长日志;R-09 人生事;R-10 备忘录;R-11 功德记录
- [~] R-01 人物录列表,待用户视觉审核
- [~] R-02 人物录详情与编辑入口,待用户视觉审核
- [~] R-03 贺礼列表,待用户视觉审核
- [~] R-04 贺礼新增、保存结果与删除说明,待用户视觉审核
- [~] R-05 礼仪活动列表,待用户视觉审核。
- [~] R-06 礼仪详情,待用户视觉审核。
- [~] R-07 新建/编辑礼仪,待用户视觉审核。
- [~] R-08 成长日志,待用户视觉审核。
- [~] R-09 人生事,待用户视觉审核。
- [~] R-10 备忘录,待用户视觉审核。
- [~] R-11 功德记录,待用户视觉审核。
### 5.6 消息与个人中心
- [ ] N-01 消息中心N-02 消息详情、已读与空状态
- [ ] M-01 我的首页;M-02 个人资料;M-03 安全设置;M-04 修改密码;M-05 修改手机号
- [ ] M-06 帮助中心;M-07 意见反馈;M-08 应用推广;M-09 VIP 与订单;M-10 关于、协议、隐私与退出确认
- [~] N-01 消息中心:列表、已读、空态与失败状态已完成,待用户视觉审核
- [~] N-02 消息详情、已读与空/失败状态,待用户视觉审核
- [~] M-01 我的首页:资料、提醒、服务入口与失败状态已完成,待用户视觉审核
- [~] M-02 个人资料,待用户视觉审核。
- [~] M-03 安全设置,待用户视觉审核。
- [~] M-04 修改密码,待用户视觉审核。
- [~] M-05 修改手机号,待用户视觉审核。
- [~] M-06 帮助中心,待用户视觉审核。
- [~] M-07 意见反馈,待用户视觉审核。
- [~] M-08 应用推广,待用户视觉审核。
- [~] M-09 VIP 与订单,待用户视觉审核。
- [~] M-10 关于、协议、隐私与退出说明,待用户视觉审核。
## 6. 推进顺序
1. **视觉基线审视(进行中)**:已完成页面映射、资产迁移、公共组件中文注释和运行时零引用旧资源清理;A01 两张完整按钮已接入。A01、A02、A04、A05、A06、G01 两种状态与 G03 双步骤均已获用户视觉验收;A03 已删除;G02 已合并入 G01 `state=empty` 并通过验收;G04 已合并入 G03 `step=ancestor`G07 已合并入 G06 三态。G06 当前的朱砂题签候选只有初始态新截图,必须补同版结果/无结果截图、审视并取得用户确认;不修改已冻结页面的可见效果。
1. **视觉基线审视(进行中)**:已完成页面映射、资产迁移、公共组件中文注释和运行时零引用旧资源清理;A01 两张完整按钮已接入。A01、A02、A04、A05、A06、G01 两种状态与 G03 双步骤均已获用户视觉验收;A03 已删除;G02 已合并入 G01 `state=empty` 并通过验收;G04 已合并入 G03 `step=ancestor`G07 已合并入 G06 三态。G05、G06、G08、G09、G10 已进入 `[~]` 候选待审;不修改已冻结页面的可见效果。
2. A-04 至 A-06:在冻结的 A01/A02 认证资产包上完成注册、重设和登录状态页面。
3. G-03、G-05 至 G-12在冻结的 G01 列表、题签、导航资产包上完成家谱模块;G07→G06 已完成,下一项为 T02→T01 的世系树状态收敛
4. T、F、R、N、M 模块:每个模块先确认母版和完整资产包,再批量实现其页面/状态
5. 全量四尺寸复核、真实接口接入与 Android 打包。
3. G-03、G-05 至 G-12家谱模块候选稿已全部完成;G07→G06 已收敛,G05、G06、G08 至 G12 均为 `[~]` 待审,集中审核留到全量候选完成后进行
4. T、F、R、N、M 模块:候选稿与 360 × 800 运行截图已全部完成;关键页面另有 412 × 915 截图和状态对比
5. 当前进入用户逐页视觉审核;全部 `[x]` 后再安排四尺寸复核、接口阶段与 Android 打包。
## 7. 本轮完成前的验收