验收20%

docs/验收规划.md

@@ -2,7 +2,7 @@
 
 > 更新日期：2026-07-15  
 > 适用范围：Android `uni-app` 用户端  
-> 当前实现：`pages.json` 仍有 54 条路由；A02 已确定并入 A01，完成收敛后的最终验收目标为 53 条路由。历史上的 7 个验收结果仅作为旧视觉证据，不计入本轮完成状态。  
+> 当前实现：`pages.json` 已收敛为 53 条最终路由；A02 已并入 A01。历史上的 7 个验收结果仅作为旧视觉证据，不计入本轮完成状态。
 > 本文件只管理逐页视觉、页面状态外观、弹窗与加载样式、手机适配和表现质量；不替代 `docs/规划.md` 对项目范围和最终路由的管理，也不承担接口与业务功能验收。功能验收规则后续单独编写。
 
 ## 1. 标记与审核规则
@@ -19,7 +19,7 @@
 
 1. 页面在真实运行环境中打开；流程页优先从上游可见入口进入，尚未实现入口时明确标记 `⚠`，不能冒充流程设计完整。
 2. 正常、加载、空、失败、权限、校验和成功等适用状态的视觉呈现均已检查；本阶段只验状态外观，不验证后台结果真伪。
-3. 浅色、深色两套主题在 320×568、360×640、360×800、412×915 四个尺寸均无溢出、裁切、遮挡或错位；“跟随系统”使用当前系统主题，但不得依赖系统自动反色。
+3. 基础版本只验收当前浅色国风主题，并在 320×568、360×640、360×800、412×915 四个尺寸确认无溢出、裁切、遮挡或错位；深色与跟随系统整体延期到下一版本，不作为本轮 53 页通过条件。
 4. 默认系统字号和约 1.3 倍系统字号均可完整操作；关键按钮、表单错误、姓名、关系和操作结果不得截断，空间不足时允许合理换行或滚动，不得强行缩小文字或遮挡主操作，并使用超长族谱名、生僻姓名完成边界检查。
 5. 状态栏、底部手势区、软键盘、系统返回和长文本不会破坏页面。
 6. 点击反馈、加载、滚动、动画和图片解码在当前静态／Mock 数据下无明显卡顿。
@@ -37,9 +37,9 @@
 
 本轮不沿用任何页面的历史完成标记。A01、A04、A05、A06、G01、G03 也必须重新完成页面结构、视觉状态、兼容性、弹窗加载样式和表现质量检查；用户重新确认后才能标记 `[x]`。
 
-审核证据默认每页只展示一张 360×800 代表图；需要同时确认明暗主题时，将浅色与深色代表态合成一张联系表，不连续展示两张前后对比图。其余尺寸在内部完成检查，只有发现问题或用户要求时才展开。
+审核证据默认每页只展示一张 360×800 代表图；复杂状态合成一张联系表，不连续展示多张前后对比图。其余尺寸在内部完成检查，只有发现问题或用户要求时才展开。
 
-每个页面必须在同一验收项内完成浅色与深色主题，不拆分为两轮：两套主题的代表态、适用关键状态、四档尺寸、代码质量和性能全部通过后，才可提交一张明暗联系表供用户确认；用户确认后两套主题同时标记 `[x]` 并冻结。任一主题未完成或未通过时，整个页面保持 `[~]` 或 `[!]`。
+基础版本的每个页面只按当前浅色国风主题完成适用关键状态、四档尺寸、代码质量和性能验收；用户确认后标记 `[x]` 并冻结。下一版本引入深色与跟随系统时，属于会影响全部冻结页面的全局视觉变更，必须单独建立升级验收计划，并按冻结回归规则重新复核受影响页面。
 
 ## 2. 已确认的核心用户流程合同
 
@@ -53,7 +53,7 @@
 - A04 注册成功后直接建立登录状态并进入 G01“我的家谱”，不得要求用户返回 A01 重复输入账号密码；注册接口能否返回有效登录凭证在后续功能验收核对，当前页面样式验收先覆盖提交中、成功过渡和进入 G01 的视觉连续性。
 - A05 重置密码成功后不自动登录：先显示短暂的自定义成功结果，再返回 A01，自动保留刚才使用的手机号、切换到密码登录并聚焦密码框，让用户使用新密码完成登录；不得清空手机号或要求重新寻找登录方式。
 - A01 内部直接处理密码错误、验证码错误和手机号未注册，使用就近校验，不跳转 A06；微信授权取消仍留在 A01，视为用户取消而非登录失败。A06 只承接账号冻结、停用、风险限制或其他无法继续登录的阻断性状态，必须说明原因、影响范围和明确恢复入口，不得成为普通错误的汇总页。
-- A01 在 320×568 最小验收尺寸下不得依赖纵向滚动：品牌区、密码／验证码切换、当前登录表单、登录按钮、微信登录、注册、忘记密码和协议入口必须同屏可见。小屏允许明显压缩品牌头与山水装饰高度，但不得缩小输入框、按钮和协议的有效触控区。
+- A01 在 320×568 最小验收尺寸下允许自然纵向滚动，不为追求全部核心入口同屏而压缩品牌头、表单、字号或有效触控区；必须保证首屏层级清楚、滚动顺畅、无横向溢出，底部协议和主操作可完整滚动到达。
 - A01 未勾选协议时采用页内校验：协议区域轻微震动并高亮，下方显示明确错误文案；不弹原生 Toast 或确认弹窗，不跳转。用户勾选后错误样式立即消失。
 - A02 从最终路由和验收表移除，不保留兼容入口；A04、A05、A06 的登录返回统一指向 A01。实际代码收敛完成前，`pages.json` 的 54 条是实施现状，不是最终验收数量。
 - A01、A04、A05 共用同一行为验证弹层，但触发时机不同。A01 登录在账号信息、协议等本地校验通过并点击“登录”后弹出，验证成功后自动继续登录；A05 忘记密码在用户请求发送短信验证码前弹出，验证成功后自动发送短信，重置提交时不重复验证。A04 注册当前因短信注册接口尚未提供，临时按 A01 方式在完整填写并点击“注册”后弹出；注册短信接口提供即为临时契约的移除条件，届时必须迁移为“发送短信验证码前验证”，并删除注册提交前的旧触发路径，不保留双重验证。用户关闭或验证失败时必须保留原表单内容。当前页面样式阶段只审核弹层初始、拖动、成功、失败和关闭状态，不审核真实滑动轨迹、`validToken` 或接口自动续接。原始 TAC 运行库保存在 `static/vendor/tac/`，留待功能阶段使用。
@@ -122,7 +122,7 @@
 
 所有表单采用“就近显示错误”：单字段错误显示在对应输入框下；关联错误同时标记相关字段；页面级错误显示在提交区附近；网络或系统错误使用自定义结果弹层。提交时错误字段执行一次 200–260ms、3–5px 的横向视觉抖动，只使用 `transform`，不调用手机振动、不循环闪烁；动画必须与静态错误描边和文字同时存在，减少动态效果时仅保留静态提示。
 
-主题模式统一提供“浅色、深色、跟随系统”三个选项。入口放在 M10“设置与关于”页面顶部，由 M01 的“设置”菜单进入，不新增独立路由。浅色与深色共用页面结构、组件层级、交互规则和国风视觉语言，但必须通过统一主题变量分别定义背景、文字、边框、遮罩、状态色、状态栏图标和必要的位图资产；严禁使用系统自动反色或在页面内散落颜色覆盖。用户选择后当前页面立即生效，不重启、不重新进入页面、不闪白屏；页面、弹窗和状态栏使用一次 150–200ms 的轻微明暗过渡同步完成切换，不得出现局部延迟或颜色割裂。当前页面样式验收检查三选项控件和两套主题的完整视觉；选项持久化、重启恢复、系统主题变化后的自动联动归入后续功能验收。
+基础版本固定使用当前浅色国风主题，M10“设置与关于”不展示尚未生效的外观模式入口，也不实现主题切换、持久化或跟随系统。深色与跟随系统统一延期到下一版本；升级时继续使用统一主题变量管理背景、文字、边框、遮罩、状态色、状态栏图标和必要位图资产，禁止依赖系统自动反色或在页面内散落覆盖样式。下一版本的主题切换、过渡、持久化和系统联动必须另建产品合同与验收计划。
 
 所有分页列表共用同一套底部加载视觉：接近列表末尾时在内容流内显示轻量水墨／印章动效和“正在展开更多……”；失败时保留已加载内容并显示“加载失败，点击重试”；数据结束时显示“已阅至末尾”；数据不足一页时不强行显示结束文案，也不循环触发加载。底部分页不得使用全屏遮罩、清空现有列表、改变当前滚动位置或造成列表跳动。
 
@@ -158,14 +158,14 @@
 | `[ ]` | C05 | 页面级加载 | 首屏使用结构稳定的骨架屏；按钮在原位置显示内部进度；局部卡片仅覆盖局部；列表统一下拉刷新与底部加载状态；仅在页面结构完全不可预知时使用全屏加载，不闪白屏或突然跳布局 |
 | `[ ]` | C06 | 按钮级加载 | 登录、提交、保存期间立即禁用重复点击并显示明确进度 |
 | `[ ]` | C07 | 权限与进度 | 相册、上传、分享权限及上传进度、取消、失败重试均有自定义反馈 |
-| `[ ]` | C08 | 主题与四尺寸适配 | 浅色、深色均通过 320×568、360×640、360×800、412×915；跟随系统不自动反色，状态栏、弹窗和页面颜色一致且无溢出、裁切和错位 |
+| `[ ]` | C08 | 基础主题与四尺寸适配 | 当前浅色国风主题通过 320×568、360×640、360×800、412×915；状态栏、弹窗和页面颜色一致且无溢出、裁切和错位；深色与跟随系统延期到下一版本 |
 | `[ ]` | C09 | 安全区适配 | 状态栏、刘海、底部手势区和固定导航不遮挡页面内容或操作 |
 | `[ ]` | C10 | 软键盘适配 | 输入框、校验信息和提交按钮不被软键盘遮挡，页面可滚动到当前字段 |
 | `[ ]` | C11 | 字体与长文本 | 默认字号与约 1.3 倍系统字号下，Android 字体回退、超长族谱名、生僻姓名和长文案均不重叠、不截断关键含义、不遮挡主操作 |
 | `[ ]` | C12 | 触控与误操作 | 点击区不小于约 44dp；连续点击不重复提交；返回前保护未保存内容 |
 | `[ ]` | C13 | 图片性能 | 图片按显示槽位使用；避免同页同时解码多张超大位图；屏外图片延迟加载 |
 | `[ ]` | C14 | 列表性能 | 使用至少 500 条 Mock 数据测试；长列表分批渲染并使用稳定 `key`；下拉刷新和触底加载均保留已有内容、滚动位置与布局高度；短列表不循环触发，滚动时不反复重绘整页 |
-| `[ ]` | C15 | 动画性能 | 优先使用 `transform` 和 `opacity`；不使用大面积模糊、复杂滤镜和重阴影动画；主题切换在 150–200ms 内同步完成且不白屏、不持续掉帧 |
+| `[ ]` | C15 | 动画性能 | 优先使用 `transform` 和 `opacity`；不使用大面积模糊、复杂滤镜和重阴影动画；页面过渡不白屏、不持续掉帧 |
 | `[ ]` | C16 | 响应反馈 | 点击后 100ms 内出现反馈；超过 300ms 的操作必须显示自定义加载状态 |
 | `[ ]` | C17 | 页面生命周期 | 离开页面时清理定时器、监听器、上传任务和动画状态，避免越用越卡 |
 | `[ ]` | C18 | 路由压力 | 同一详情连续进入／退出 20 次，快速切 Tab、重复开关弹窗，不白屏、不串状态、不重复堆栈、不残留遮罩且不逐次变慢 |
@@ -178,7 +178,7 @@
 
 | 状态 | 序号 | 页面 | 真实入口与必须覆盖的可能性 |
 | --- | ---: | --- | --- |
-| `[~]` | 1 | A01 登录 | APP 首次打开；首次默认密码登录、后续恢复上次密码／短信方式，品牌区、微信登录入口、注册、忘记密码、协议未勾选／已勾选、空输入、错误提示、完整输入后点击登录再显示行为验证、按钮加载、键盘遮挡；320×568 全部核心入口同屏且不滚动 |
+| `[~]` | 1 | A01 登录 | APP 首次打开；首次默认密码登录、后续恢复上次密码／短信方式，品牌区、微信登录入口、注册、忘记密码、协议未勾选／已勾选、空输入、错误提示、完整输入后点击登录再显示行为验证、按钮加载、键盘遮挡；320×568 保持正常比例并允许自然纵向滚动 |
 | `[~]` | 2 | A04 注册账号 | A01→注册；协议、手机号错误、密码不一致、注册中、成功／失败页面样式；当前临时在完整填写并点击注册后显示行为验证，注册短信接口提供后迁移为发送验证码前验证；注册成功后自动建立登录状态并进入 G01 |
 | `[~]` | 3 | A05 重置密码 | A01→忘记密码；手机号、发送短信前行为验证、验证码、新密码、两次不一致、重设中、成功／失败页面样式；成功后返回 A01，保留手机号、切到密码登录并聚焦密码框，不自动登录 |
 | `[~]` ⚠ | 4 | A06 登录状态 | A01 登录结果→阻断状态；仅覆盖账号冻结、停用、风险限制等无法继续登录的状态，必须展示原因、影响范围和恢复入口；普通密码／验证码错误、未注册及微信取消均留在 A01；当前缺少真实结果跳转 |
@@ -265,7 +265,7 @@
 | `[~]` ⚠ | 50 | M07 意见反馈 | 应由 M06 进入；校验、提交中、成功／失败 |
 | `[~]` ⚠ | 51 | M08 应用推广 | 应由 M01 进入；分享权限、生成海报、取消、失败 |
 | `[~]` ⚠ | 52 | M09 VIP 与订单 | 应由 M01 进入；无订单、权益、订单列表、加载失败 |
-| `[~]` | 53 | M10 设置与关于 | M01→设置；页面顶部外观模式（浅色／深色／跟随系统）、协议、隐私、版本、退出确认／取消；明暗主题视觉均需审核 |
+| `[~]` | 53 | M10 设置与关于 | M01→设置；协议、隐私、版本、退出确认／取消；基础版本不展示外观模式入口，深色与跟随系统延期到下一版本 |
 
 ## 6. 当前视觉流程断点与后续功能依赖
 
@@ -286,12 +286,12 @@
 
 1. 从本表上一项或明确的分支入口进入页面。
 2. 捕获本轮真实运行截图并检查是否为正确页面、正确状态、非加载中画面。
-3. 默认展示一张代表图；明暗主题或复杂状态展示一张联系表，不连续铺陈对比截图。
-4. 确认浅色与深色的关键状态、四档尺寸、代码质量和性能均已通过；任一主题未通过时不得提交冻结。
-5. 用户确认通过则两套主题同时标 `[x]` 并冻结；用户指出问题则整个页面标 `[!]`。
+3. 默认展示一张代表图；复杂状态展示一张联系表，不连续铺陈对比截图。
+4. 确认当前浅色国风主题的关键状态、四档尺寸、代码质量和性能均已通过。
+5. 用户确认通过则当前基础版本页面标 `[x]` 并冻结；用户指出问题则整个页面标 `[!]`。
 6. 返工前先更新最小契约测试并确认 RED，再做最小实现。
 7. 测试、构建、截图或路由异常时先复现并定位根因，不盲改样式。
-8. 返工后运行受影响测试、运行时 smoke、两套主题四尺寸复核、真实路由截图和 `git diff --check`。
+8. 返工后运行受影响测试、运行时 smoke、当前主题四尺寸复核、真实路由截图和 `git diff --check`。
 9. 接口资料只用于理解功能、字段和状态位置；本阶段不对接接口，也不执行接口功能验收。
 
 ## 8. 单项验收记录模板