jiapuapp/docs/frontend-reference-parity-2026-08-17.md

# 当前前端与参考前端完整对比总表

更新时间：2026-08-22

## 核对范围与判定方法

- 参考项目：`C:\Users\Rain\Desktop\job\Jiapu-App`
- 当前项目：`C:\Users\Rain\Desktop\job\jiapuapp`
- 比对对象以两个前端项目为主；需要后端数据才能完成的显示和播放会单独标出，不能把“有页面”写成“功能已可用”。
- 参考项目 `pages.json` 有 78 条活动路由。每条路由同时按 `.vue` 和 `.nvue` 解析，不能只检查 `.vue`。
- 当前项目有 59 条活动路由。多个参考页面合并到一个当前页面或组件时，只要入口、操作、字段和状态完整，判定为“合并覆盖”，不要求文件数量相同。
- 静态空壳、无入口演示页和未实现按钮会明确标记，不能当成当前项目必须复制的正式功能。

> 2026-08-22 第二轮按入口和点击链路复核。此前的 78/78 只表示参考路由已逐项登记，不代表每个入口都完成过真机点击。此次发现“宣传视频”虽有页面映射，但首页没有封面预览且 `G01 → F11` 被路由白名单拦截，原结论不准确，现已修正并加入回归检查。

> 2026-08-22 第三轮严格复核：再次逐项检查 78 条参考路由的模板、点击事件、表单字段、图片/视频显示和当前后端 DTO。此前把“前端已写媒体控件”直接判为“功能覆盖”的结论仍不严谨。功德图片实际上会被当前后端丢弃；谱文多图、礼仪封面显示、家族视频封面优先列表及多个列表的缩略图/批量操作也未完全对齐。下方“严格复核后的真实差异”是当前最终结论，优先于旧的“本轮补齐”措辞。

> 2026-08-22 第四轮融合复核：不再把“能从别处操作”直接等同于完整覆盖，而是继续核对聚合入口、字段是否真正显示、同一记录的生命周期信息是否完整。新增确认：家谱级重要证件总入口缺失；VIP 订单号及支付/到期时间未完整展示；提现单号、处理时间和审核/打款信息未展示；推广中心缺参考项目真实可用的注册链接二维码和复制链接。家谱编号、首页姓氏位置和参考项目更严格的必填规则属于产品取舍，单列待确认，不直接开发。

> 2026-08-22 第五轮字段消费复核：逐项区分“业务发生时间”和“记录创建时间”。参考相册、礼仪、功德、成长记录、贺礼簿、家族恩人列表均显示 `create_time`；当前除相册外显示的是 `ceremonyTime/meritTime/recordDate/eventTime/remindTime` 等业务时间，不能视为同一个字段。最新后端五个已确认映射 VO 及相近的 `AppMemoVo` 均未返回 `createTime`，因此这不是只改模板即可完成的前端项。家族视频使用 `publishTime`、家族圈直接返回 `createTime`，已有等价字段，不重复列入。

状态说明：

- **覆盖**：当前项目有等价或更完整的可执行路径。
- **合并覆盖**：能力存在，但被合并到当前页面、弹窗或组件。
- **升级替代**：参考做法存在安全、契约或产品问题，当前使用更可靠的流程完成同一用户目标。
- **非产品页**：空壳、静态原型、插件演示或没有业务入口，不迁移。
- **本轮补齐**：静态比对发现过差距，本轮已补入当前前端并进入后端联调清单。

## 严格复核后的真实差异

| 优先级 | 模块/参考路由 | 参考项目实际行为 | 当前项目实际行为 | 责任与完成条件 |
| --- | --- | --- | --- | --- |
| P0 | 家族视频 `video/index`、`video2.nvue` | 列表先显示 `item.imgs` 封面，点击后进入播放器/纵向播放 | `platform-videos.vue` 已是封面优先，但 `videos.vue` 的家族视频列表仍直接渲染 `<video controls>`；封面不能作为主要点击入口 | **前端**：家族视频卡片改为有封面先显示图片和播放标识，点击进入纵向播放器；无封面再使用视频占位或首帧 |
| P0 | 功德录 `meritsVirtues/index/add/details` | 列表显示第一张图，新增可传多图，详情显示全部图片 | 前端表单和详情虽使用 `mediaOssIds/mediaFiles`，但最新后端 `AppMeritRecordBody/Vo` 没有媒体字段；MuMu 实测创建成功后详情无图，列表也没有缩略图 | **前后端**：后端增加媒体请求/响应和文件引用；前端补列表首图。以新增、编辑保留、移除、列表首图、详情预览全部实测通过为完成 |
| P0 | 家谱设置 `genealogyList/index` | 谱主可进入资料维护和删除操作 | 当前设置页把基础详情和永久删除资格放进同一个 `Promise.all`；后端资格接口对未归档家谱抛“家谱必须先归档”，导致整个设置页失败 | **前后端**：前端将删除资格作为非关键独立状态，后端拆分 owner 鉴权与 archived 资格；普通谱主必须可读、可改基础设置 |
| P1 | 创建家谱 `createGenealogy` | `first_ancestor_name` 随创建提交 | 当前表单已有 `firstAncestorName`，最新后端 `AppGenealogyCreateBody` 无该字段，也不会在事务内建立首位人物 | **后端**：增加字段并原子创建第一代人物；失败时家谱和人物一起回滚 |
| P1 | 谱文 `puwen/add/genealogy` | 新增维护 `imgs` 数组，详情逐张显示 | 当前仅上传单个 `coverOssId`；列表和详情均未渲染 `coverFile`，后端也只有单封面契约 | **产品+前后端**：先决定“多图正文”还是“单封面”。至少应由前端显示现有封面；若保持参考多图则扩展后端媒体契约 |
| P1 | 礼仪 `gift/index/details/add` | 列表显示封面，详情显示封面，新建上传封面 | 当前编辑页可上传且后端返回 `coverFile`，但列表和详情未渲染图片 | **前端**：列表增加封面缩略图，详情显示可预览封面 |
| P1 | 重要证件 `document/index` | 从家谱总览直接进入全家谱证件列表，再选择查看或维护 | 当前只在单个人物详情内打开证件弹窗，没有家谱级总入口和跨人物列表；现有接口已允许不传 `lineagePersonId` 查询 | **前端**：增加家谱级重要证件入口/列表，复用现有证件弹窗与安全访问能力；无需新增后端接口 |
| P1 | VIP 订单 `mine/vip_success` | 每条显示订单号、套餐、状态、支付时间、到期时间 | 当前订单列表显示套餐、金额、状态，并把支付/到期时间二选一显示；契约还丢弃后端已有 `orderNo` | **前端**：保留 `orderNo`，分别显示订单号、支付时间和到期时间 |
| P1 | 提现记录 `mine/tixian_log` | 每条显示提现单号、金额、状态、申请时间、审核时间和备注 | 当前显示金额、申请时间、状态、收款人和失败原因；契约已有 `withdrawalNo/auditRemark/payoutReference/paidAt` 但页面未展示 | **前端**：显示提现单号，并按状态展示审核备注、打款参考号和到账时间；后端没有通用审核时间字段，不能把 `paidAt` 冒充审核时间 |
| P1 | 推广邀请码 `mine/fenxiang` | 根据注册链接生成二维码，并可复制注册链接给朋友；“下载 App”代码实际已注释 | 当前可复制推荐码和系统分享推荐码文字，但没有二维码或可复制注册链接；最新 `ReferralMeVo` 也没有 `shareUrl` | **前后端**：后端返回可信、可配置的注册链接（携带推荐码或服务端短链），前端再生成二维码、复制和分享；不能在前端重新硬编码旧域名 |
| P1 | 谱文/礼仪/视频编辑时移除封面 | 参考上传组件可删除已有图片，礼仪和视频表单也有明确移除按钮 | 当前三处只能上传或替换封面，没有移除按钮；前端请求规范化会省略 `null/''`，OpenAPI 也未声明封面可置空 | **前后端契约+前端**：更新契约明确 `coverOssId: null` 表示解除引用，规范化保留显式空值，编辑器增加移除并验证旧文件引用释放 |
| P1 | 相册/礼仪/功德/成长记录/贺礼簿/家族恩人列表创建时间 | 六类参考列表均显示记录的 `create_time` | 当前相册列表没有时间；其余页面显示活动/功德/记录/事件/提醒等业务时间，但它们不等于创建时间；五个已确认映射 VO 也没有 `createTime` | **后端+前端**：五类现有 VO/OpenAPI 先增加只读 `createTime`；家族恩人由选定契约持有；现有业务时间继续保留，不能互相冒充 |
| P1 | 贺礼簿 `favor/index/details` | 列表显示 `imgs[0]`，详情显示全部图片 | 当前“往来记录”详情可预览 `mediaFiles`，列表只有文字 | **前端**：列表补第一张图片缩略图 |
| P1 | 家族恩人 `memorandum/index/details` | 独立入口、列表和详情显示恩人记录、`imgs[0]` 与全部图片 | MuMu 实点确认当前只有通用“家族备忘”，表单是提醒语义，没有恩人身份/分类 | **确认缺口**：产品选择复用 Memo 类型或独立档案；前端补入口、文案、首图和创建时间，后端按选定单一契约落库 |
| P1 | 谱文、证件、视频、功德、礼仪、成长日志、贺礼簿、家族恩人列表 | 多数页面有“管理→勾选→批量删除” | 当前相册照片支持批量删除，其余大多只有逐条删除 | **产品决策**：若要求操作一致，先定义回收站下的批量部分成功语义，再由前端补选择态；不应仅因文件已合并就标“完整覆盖” |
| P1 | 首页 `index/index` | 搜索框、创建、加入、排序和两条宣传封面直接露出 | 当前创建/加入/排序主要收在弹窗或二级页，宣传区位于较长家谱列表之后；当前家谱还会在顶部和列表重复显示 | **前端产品体验**：能力存在，但点击层级和信息优先级不同；需按最终产品方向决定是否提升搜索、加入和媒体入口 |
| P1 | 宣传视频 `xcindex/video3/video4` | 有真实封面数据时点击播放 | 当前代码已完成封面优先和指定视频播放，但测试环境 `home_featured/video_center` 均为空 | **后端/运营+真机**：各配置至少一条有效视频和封面后，验证播放、滑动、暂停、返回、点赞和评论 |
| P2 | 注册 `login/login`、`login/register` | 注册时填写实名和性别 | 当前注册填写昵称，实名和性别移到个人资料 | **责任重分配，非缺失**：除非产品要求注册即实名，否则保留当前较短流程 |
| P2 | 加入、找回、删除、权限、视频来源 | 编号直接加入、安全问题找回、直接硬删除、硬编码 `auth_str`、任意视频 URL | 当前使用申请/一次性邀请码、短信找回、回收站/归档、动态权限目录、受控文件上传 | **升级替代，不能回退**：这些是安全和数据完整性改进，不按参考旧实现复制 |
| P2 | `render`、`invite`、`relationship/index`、`tree/add`、`ancestorsOrder`、`mine/share` | 日历演示、空页、静态原型或错误跳转 | 当前不提供对应独立页面，正式能力已在其他页面实现 | **非产品页**：不迁移；其中 `mine/share` 的“立即分享”实际跳创建家谱，不能当作分享功能 |

严格结论：78/78 表示参考路由没有漏登记；不表示当前功能已全部完成。差异必须继续经过“当前项目是否已在其他页面或升级流程中实现”的融合判定，不能直接等同于开发任务。

## 融合判定后的处理清单

| 判定 | 项目 | 当前能力核对 | 是否需要补 |
| --- | --- | --- | --- |
| 确认断链 | 家族视频封面式列表 | 家族视频已经支持封面上传、纵向播放器、点赞和评论，但列表仍直接铺播放器；只有平台视频列表实现了封面优先 | **需要前端补**，这是用户实际看到的交互缺口 |
| 确认断链 | 礼仪活动封面 | 编辑页和后端 `coverFile` 已存在，列表、详情都没有消费该字段 | **需要前端补**，属于已有契约未展示 |
| 确认断链 | 谱文单封面显示 | 编辑器和后端 `coverFile` 已存在，列表、详情没有显示 | **需要前端补**，属于已有契约未展示 |
| 确认断链 | 家谱设置 | 页面和全部设置功能都存在，但附加的永久删除资格请求失败会拖垮基础设置 | **前端需要隔离非关键失败，后端需要修资格接口** |
| 确认断链 | 家谱级重要证件入口 | 当前人物详情内的证件管理能力完整，但没有从家谱模块查看全部人物证件的入口；服务层和 OpenAPI 已支持不带人物条件查询 | **需要前端补**家谱级列表/入口，内部复用现有详情与编辑能力 |
| 确认断链 | VIP 订单关键信息 | 后端已有 `orderNo/payTime/expireTime`，当前契约丢弃订单号，页面只显示支付时间或到期时间其中一个 | **需要前端补**契约字段和三项独立展示 |
| 确认断链 | 提现记录处理信息 | 当前契约已保留提现单号、审核备注、打款参考号、到账时间，页面却没有显示 | **需要前端补**按状态展示；若产品必须显示“审核时间”，后端还需提供明确字段 |
| 确认断链 | 推广注册链接/二维码 | 当前推荐关系、推荐码和系统分享均可用，但只有文字推荐码；参考项目可扫码或复制注册链接 | **需要后端补 `shareUrl`，前端补二维码和复制链接**；旧项目硬编码域名不能直接迁移 |
| 确认断链 | 已有封面无法移除 | 谱文、礼仪、视频都能替换封面，但当前 UI 和前端严格契约不能表达“清空封面” | **需要统一契约后补前端**；不能只在本地把预览清空而不释放后端文件引用 |
| 确认断链 | 六类记录创建时间 | 参考相册、礼仪、功德、成长、贺礼簿、家族恩人列表显示创建时间；当前后端 APP VO 不返回该字段，现有页面展示的是缺失或不同语义的业务时间 | **需要后端补只读 `createTime`，前端再展示**；保留现有业务时间，不能拿它们代替创建时间 |
| 确认断链 | 功德图片 | 当前前端已有上传、编辑保留和详情预览，但最新后端请求/响应 DTO 没有媒体字段，MuMu 实测无法回显 | **需要后端补契约**；后端完成后前端再补列表首图并实测 |
| 确认断链 | 始迁祖 | 当前创建表单和前端严格契约已经有 `firstAncestorName`，最新后端创建 DTO 没有 | **只需要后端补**，前端无需重复开发 |
| 已融合 | 贺礼簿图片 | 当前“往来记录”创建/编辑支持上传，详情支持全部图片预览；仅列表没有参考项目的第一张缩略图 | 核心能力**不需要补**；列表首图需补 |
| 确认差异 | 家族恩人 | MuMu 实点确认“家族备忘”支持提醒和图片，但没有“家族恩人”名称、身份或类型 | 恩人业务没有被当前界面表达；产品只需选择复用 Memo 类型还是独立档案，不能继续判为已融合 |
| 部分融合 | 重要证件详情维护 | 当前按人物集中管理多份证件，支持解锁、查看、替换、添加和逐项删除 | 人物内维护无需重做；但家谱级聚合入口仍需补，不能整体判为已融合 |
| 已融合 | 多个列表的批量删除 | 当前都有逐条删除和回收站，相册照片另有完整批量选择与部分失败处理 | 用户目标已覆盖，**不自动补批量模式**；需产品明确后再做 |
| 已融合 | 首页搜索、创建、加入、排序 | 当前在“我的家谱”弹窗、搜索页、申请页和排序弹窗完成，且加入与排序规则更安全 | **不需要重复入口或重复页面**；只属于信息层级优化 |
| 已融合 | 注册实名/性别 | 当前注册保持短流程，实名和性别在个人资料维护 | **不需要补回注册页**，除非业务要求注册即实名 |
| 升级替代 | 加入、找回、删除、权限、视频来源 | 已分别升级为申请/一次性邀请码、短信找回、回收站/归档、动态权限目录、受控文件 | **不按参考旧实现补** |
| 能力已有，待数据 | 平台宣传视频 | 首页封面位、视频中心、指定视频纵向播放均已实现，测试环境列表为空 | **前端不需要补**；后端/运营投放数据后点击验收 |
| 产品待定 | 谱文多图 | 参考项目是 `imgs` 多图；当前产品模型是单个 `coverFile`，正文没有媒体数组 | 不直接判缺失；先确认产品是“单封面谱文”还是“正文多图谱文” |
| 产品待定 | 家谱编号与姓氏展示位置 | 参考总览直接显示家谱编号和姓氏；当前后端有 `genealogyNo`，但前端规范化时丢弃且自有家谱卡片不显示真实姓氏，姓氏只在搜索/设置可见 | 数据能力存在但展示目标不同；确认编号是否仍承担用户识别用途后再补，不能因参考项目有就自动恢复“编号加入” |

最终确认断链共 12 项。前端可独立处理的是家族视频列表、礼仪封面、谱文单封面、设置页失败隔离、家谱级重要证件入口、VIP 订单字段和提现记录字段；功德图片、始迁祖、推广注册链接、封面清空语义及六类记录创建时间需要后端契约配合。其余差异已融合、属于升级替代、需要运营数据或等待产品选择，不应重复开发。

## 逐路由映射表（78/78）

| 参考路由 | 参考功能 | 当前页面/组件 | 状态 | 核对结论 |
| --- | --- | --- | --- | --- |
| `pages/index/index` | 首页公开家谱搜索、创建、加入、排序、两条宣传视频封面 | `pages/genealogy/my-genealogies`、`search`、`platform-videos` | 本轮补齐 | 首页读取 `home_featured` 并显示至多两条封面；点封面直达指定视频，点“查看更多”进入视频中心；当前后端未配置投放数据，MuMu 只能验证空状态和入口 |
| `pages/login/login` | 密码登录、旧式找回、注册、协议、微信登录 | `pages/auth/sign-in`、`register`、`reset-password` | 升级替代 | 密码/短信/微信、协议均覆盖；实名生日找回改为短信验证 |
| `pages/render/render` | 六个阳历/农历日历插件演示按钮 | 无 | 非产品页 | 无任何业务页面入口，仅为组件演示，不迁移 |
| `pages/index/addGenealogy` | 输入家谱编号加入 | `pages/genealogy/search`、`join-application` | 升级替代 | 改为一次性邀请码预览/兑换或公开家谱申请，避免盲加入 |
| `pages/index/createGenealogy` | 姓氏、谱名、堂号、始迁祖、地区、简介、访问权限 | `pages/genealogy/create` | 本轮补齐 | “始迁祖”已加入创建表单和严格请求契约；等待后端事务内创建首位世系人物 |
| `pages/index/invite` | 仅标题栏 | `components/genealogy/InvitationManager` | 非产品页 | 参考页为空壳；当前反而已有生成、复制、记录和撤销 |
| `pages/index/genealogyList/index` | 家谱总览、编号、姓氏、模块入口、邀请、删除 | `pages/genealogy/overview`、`settings` | 部分合并 | 主要基础信息、邀请、归档/注销均有入口；缺家谱级重要证件入口，且总览未显示后端已有的家谱编号，是否恢复编号展示待产品确认 |
| `pages/index/genealogyList/characterTable` | 字辈列表、人数、编辑入口 | `pages/genealogy/generation-poems` | 覆盖 | 当前另有批量预览、停用、恢复和排序 |
| `pages/index/genealogyList/add` | 新增、修改、删除字辈 | `pages/genealogy/generation-poems` | 合并覆盖 | 在同页完成批量维护，删除改为停用 |
| `pages/index/puwen/classList` | 文献分类筛选、无效的管理图标 | `pages/family/articles` | 覆盖 | 分类筛选已覆盖；参考页管理按钮没有完整写接口 |
| `pages/index/puwen/index` | 谱文列表、管理、密码解锁 | `pages/family/articles`、`article-detail` | 合并覆盖 | 列表、筛选、解锁、删除均覆盖 |
| `pages/index/puwen/genealogy` | 谱文标题、正文、落款、时间、图片及编辑 | `pages/family/article-detail` | 部分覆盖 | 正文、作者和权限已覆盖，但当前详情不显示现有单封面，也不支持参考项目的多图正文 |
| `pages/index/puwen/add` | 标题、正文、落款、安全问题、查看密码、多图及移除图片 | `pages/family/article-editor`、`article-detail` | 部分升级 | 安全问题已升级为短信找回；当前仅支持一个 `coverOssId`，没有参考项目的 `imgs` 多图契约，已有封面也不能移除 |
| `pages/index/puwen/wjmm` | 安全问题找回谱文/证件/日志密码 | `components/ContentPasswordRecoveryDialog` | 升级替代 | 改为已验证手机号短信找回，覆盖三类资源 |
| `pages/index/album/index` | 相册列表、名称、描述、数量、时间、新建 | `pages/family/albums` | 部分覆盖 | 加载、空、错、创建、编辑、回收站状态完整；当前列表和 APP VO 缺参考项目显示的创建时间 |
| `pages/index/album/add` | 相册名称、描述、创建 | `pages/family/albums` | 合并覆盖 | 当前使用同页表单弹层完成 |
| `pages/index/album/details` | 图片预览、管理勾选 | `pages/family/album-detail` | 覆盖 | 当前支持全选、批量删除和部分失败保留选择 |
| `pages/index/album/edit` | 修改名称/描述、删除相册 | `pages/family/albums` | 合并覆盖 | 编辑和移至回收站在列表页完成 |
| `pages/index/document/index` | 家谱级重要证件列表、批量管理、密码解锁 | `components/tree/PersonDocumentDialog` | 部分合并 | 单人物证件、多资源、解锁、编辑和逐项删除已覆盖；缺家谱级入口及跨人物列表。现有接口支持无 `lineagePersonId` 查询，前端可直接补齐 |
| `pages/index/document/add` | 人物关系、文件、安全问题、查看密码 | `components/tree/PersonDocumentDialog` | 升级替代 | 人物归属、文件和密码覆盖；安全问题改为短信找回 |
| `pages/index/video/index` | 封面式家族视频列表、管理、全屏播放入口 | `pages/family/videos` | 部分覆盖 | 发布、编辑、回收站、播放、点赞和评论已覆盖；列表仍直接铺 `<video>`，未按参考项目先显示封面后点击播放，也没有批量管理 |
| `pages/index/video/add` | 标题、链接、描述、封面/视频上传及移除 | `pages/family/videos` | 部分升级 | 当前只接受受控文件上传，不信任任意外链；但已有封面只能替换不能移除 |
| `pages/index/video/xcindex` | 宣传视频封面列表和详情入口 | `pages/family/platform-videos` | 本轮补齐 | 列表改为有封面时先显示封面，点击后进入指定视频纵向播放；无封面时显示原生视频控件 |
| `pages/index/video/details` | 单视频 controls 播放 | `pages/family/videos`、`platform-videos` | 合并覆盖 | 播放器直接嵌入对应业务页，避免依赖全局 store URL |
| `pages/index/meritsVirtues/index` | 功德录列表首图、姓名、内容、时间、批量管理 | `pages/records/merit-records` | 部分覆盖 | 文字增删改查可用；列表无首图和批量管理，图片会被当前后端契约丢弃 |
| `pages/index/meritsVirtues/add` | 姓名、内容、图片 | `pages/records/merit-records` | 前端待后端 | 前端已写上传控件，但最新 `AppMeritRecordBody` 无 `mediaOssIds`，不能判为功能完成 |
| `pages/index/meritsVirtues/details` | 姓名、内容、图片、时间、编辑 | `pages/records/merit-records` | 前端待后端 | 前端已写图片展示，最新 `AppMeritRecordVo` 无 `mediaFiles`；MuMu 实测新增后详情无图 |
| `pages/index/gift/index` | 贺礼邀请分类、封面列表、批量管理 | `pages/records/ceremonies` | 部分升级 | 当前统一为活动礼仪并增加正式受邀人管理，但列表未显示已有封面且无批量管理 |
| `pages/index/gift/details` | 标题、类别、时间、地点、封面、备注 | `pages/records/ceremony-detail` | 部分覆盖 | 业务字段、礼簿和邀请状态已覆盖，但详情未显示后端已经返回的 `coverFile` |
| `pages/index/gift/add` | 类型、标题、时间、地点、封面、备注及移除封面 | `pages/records/ceremony-editor` | 部分覆盖 | 创建和编辑字段均覆盖，类型来自服务端字典；已有封面只能替换不能移除 |
| `pages/index/log/index` | 按人物进入成长日志 | `pages/records/growth-journal` | 合并覆盖 | 当前在同页选择人物和分类 |
| `pages/index/log/details` | 成长日志详情及编辑 | `components/records/GrowthRecordDetailDialog` | 合并覆盖 | 详情、密码解锁、密码管理和编辑完整 |
| `pages/index/log/add` | 人物、类型、内容、密码、图片/视频 | `pages/records/growth-journal` | 本轮补齐 | 已补视频选择、上传和详情播放；安全问题改短信找回 |
| `pages/index/favor/index` | 带首图的贺礼簿列表和批量管理 | `pages/records/relative-records` | 部分覆盖 | 当前升级为结构化往来记录，增删改查和详情图片已覆盖；列表未显示首图且无批量管理 |
| `pages/index/favor/details` | 标题、内容及编辑 | `pages/records/relative-records` | 合并覆盖 | 详情在当前列表页弹层展示 |
| `pages/index/favor/add` | 标题、内容 | `pages/records/relative-record-editor` | 覆盖 | 当前增加往来类型、对象、金额、日期等结构化字段 |
| `pages/index/memorandum/index` | 带首图的家族恩人列表和批量管理 | `pages/records/memos` | 部分覆盖 | 当前家族备忘具备相近的提醒、状态、增删改查和详情图片，但实点与代码均没有恩人名称/类型；确认存在语义缺口，具体存储方案待产品选择 |
| `pages/index/memorandum/add` | 标题、内容 | `pages/records/memos` | 合并覆盖 | 当前同页表单完成 |
| `pages/index/memorandum/details` | 标题、内容、时间及编辑 | `pages/records/memos` | 合并覆盖 | 当前同页详情/编辑完成 |
| `pages/index/admin/index` | 管理员列表、删除 | `pages/genealogy/members` | 覆盖 | 当前同时管理角色、人物绑定、退出、移除和转让谱主 |
| `pages/index/admin/add` | 勾选成员成为管理员 | `pages/genealogy/members` | 合并覆盖 | 当前在成员操作面板内修改角色 |
| `pages/index/admin/power` | `auth_str` 逐项权限 | `pages/genealogy/members` | 升级替代 | 改为服务端动态权限目录，不硬编码旧权限串 |
| `pages/index/familyCircle/index` | 动态、媒体、评论、回复、删除 | `pages/family/feed`、`feed-detail` | 覆盖 | 当前另有点赞、分页评论、回复、删除权限和失败重试 |
| `pages/index/familyCircle/add` | 内容、图片、发布 | `pages/family/feed-editor` | 覆盖 | 当前支持创建、编辑、媒体上传和草稿离开确认 |
| `pages/index/tree/index` | 表格世系、关系、状态、人物入口 | `pages/tree/overview`、`member-directory` | 合并覆盖 | 树、目录和人物状态拆分为清晰入口 |
| `pages/index/tree/tree` | 树谱、父母/配偶/兄弟/子女新增、编辑、删除、绑定 | `pages/tree/pedigree`、`add-relative`、`member-profile` | 覆盖 | 亲属新增、身份绑定、排序、编辑和停用均覆盖 |
| `pages/message/index` | 通知、加入审核、广告消息、邀请弹窗 | `pages/notification/message-center`、`message-detail` | 合并覆盖 | 通知目标可进入审核、动态、备忘和活动邀请；广告由推广组件处理 |
| `pages/message/details` | 通知详情 | `pages/notification/message-detail` | 覆盖 | 当前增加类型、家谱、发送人、关联事项和已读状态 |
| `pages/mine/index` | 个人资料、余额、VIP、帮助、设置、推广、退出 | `pages/profile/home`、`earnings`、`vip`、`settings` | 合并覆盖 | 入口全部覆盖并增加推荐偏好和合规文档 |
| `pages/mine/help` | 帮助分类和搜索框 | `pages/profile/help` | 覆盖 | 当前提供真实关键词过滤、加载、空和错误状态 |
| `pages/mine/setting` | 关于、联系、协议、退出 | `pages/profile/settings`、`compliance-document` | 合并覆盖 | 当前增加账号注销、版本化协议和服务端正文 |
| `pages/mine/password` | 旧密码、新密码、确认 | `pages/profile/change-password` | 升级替代 | 当前使用服务端验证策略，不把旧式表单当唯一安全边界 |
| `pages/mine/opinion` | 联系方式、反馈描述 | `pages/profile/feedback` | 覆盖 | 当前增加反馈历史、提交状态和失败提示 |
| `pages/mine/share` | 静态奖励图；“立即分享”错误跳创建家谱 | `pages/profile/promotions` | 非产品页 | 参考按钮没有分享实现，不复制错误跳转 |
| `pages/mine/vip_xf` | 套餐、协议、微信/支付宝/余额选择、支付 | `pages/profile/vip` | 覆盖 | 当前按 capability 动态展示渠道并严格校验支付结果 |
| `pages/mine/vip_success` | VIP 订单号、套餐、状态、支付/到期时间 | `pages/profile/vip` | 部分合并 | 当前已有订单记录、套餐、金额和状态；缺订单号，且支付时间与到期时间被合并为二选一显示 |
| `pages/mine/helpDetails` | 帮助正文 | `pages/profile/help`、`compliance-document` | 合并覆盖 | 普通帮助内联详情，协议使用独立版本化页面 |
| `pages/index/relationship/index` | 写死的“资料/亲属”静态原型 | `pages/tree/member-profile` | 非产品页 | 无真实数据或提交逻辑；当前人物详情已有真实亲属数据 |
| `pages/index/tree/personalData` | 人物基础、生卒、教育、职业资料 | `pages/tree/member-profile` | 覆盖 | 当前按服务端契约展示并保护敏感病史 |
| `pages/index/tree/add` | 大量未绑定输入框的静态人物原型 | `pages/tree/add-relative` | 非产品页 | 参考输入多数没有 v-model/提交实现；当前有真实表单 |
| `pages/mine/userInfo` | 个人/人物编辑及亲属新增的主实现 | `edit-profile`、`add-relative`、`edit-member` | 合并覆盖 | 账号资料和家谱人物资料按责任拆分，字段见下表 |
| `pages/index/log/selectUser` | 为日志或管理员选择成员 | 人物选择器、成员权限弹层 | 合并覆盖 | 当前从服务端候选项选择，不通过跨页临时存储回传 |
| `pages/index/genealogyList/ancestorsOrder` | 空模板 | `pages/tree/member-rank` | 非产品页 | 参考页仅 67 字节；当前已有真实同辈排序 |
| `pages/mine/helpList` | 帮助文章列表 | `pages/profile/help` | 合并覆盖 | 分类、列表、筛选和详情合并在一个页面 |
| `pages/content/detail` | 登录协议或普通文章正文 | `pages/profile/compliance-document` | 升级替代 | 当前按文档 key、版本和生效日期读取，不使用固定文章 ID |
| `pages/mine/fenxiang` | 注册链接二维码、复制注册链接；下载 App 入口已被注释 | `pages/profile/promotions` | 部分覆盖 | 推荐码、邀请人数和系统分享已覆盖；缺二维码和注册链接，当前后端仅返回推荐码及分享文案 |
| `pages/login/register` | 另一套短信注册页面 | `pages/auth/register` | 合并覆盖 | 删除重复注册入口，统一为一个严格契约页面 |
| `pages/mine/changemobile` | 密码验证后修改手机号 | `pages/profile/change-phone` | 升级替代 | 当前按服务端验证策略和短信码修改手机号 |
| `pages/index/sortGenealogy` | 手填排序序号 | `components/genealogy/OrderDialog` | 升级替代 | 改为上移/下移并一次保存稳定 ID 顺序 |
| `pages/index/log/list` | 指定人物和分类的成长日志、密码解锁 | `pages/records/growth-journal` | 合并覆盖 | 筛选、列表、详情、解锁均在同页完成 |
| `pages/index/log/class` | 成长日志分类 | `pages/records/growth-journal` | 合并覆盖 | 分类由服务端字典渲染，无需额外页面 |
| `pages/index/video/video2` | 家族视频 `.nvue` 上下滑动、自动播放、评论 | `pages/family/videos`、`components/family/VerticalVideoViewer` | 本轮补齐 | 已有纵向分页观看，滑走暂停、当前项播放，并保留点赞和评论入口 |
| `pages/index/video/video3` | 首页宣传视频 `.nvue` 上下滑动、自动播放 | `pages/family/platform-videos`、`components/family/VerticalVideoViewer` | 本轮补齐 | `G01 → F11` 路由已放行，首页封面可带 `videoId` 进入宣传视频纵向观看 |
| `pages/index/video/video4` | 指定宣传视频 `.nvue` 上下滑动、自动播放、评论 | `pages/family/platform-videos`、`components/family/VerticalVideoViewer` | 本轮补齐 | 页面加载后按 `videoId` 定位并打开指定内容，保留点赞和评论入口；需后端真实视频数据完成播放实测 |
| `pages/message/ad_detail` | 广告标题、图片、内容详情 | `components/AppPromotionStrip`、`pages/profile/promotions` | 升级替代 | 按推广目标类型安全打开，不复制独立旧广告页 |
| `pages/mine/withdrawal` | 余额、收益流水、申请提现、提现记录 | `pages/profile/earnings` | 覆盖 | 当前增加可用/冻结金额、最低金额、分页和取消申请 |
| `pages/mine/tixian` | 输入提现金额并提交 | `components/profile/EarningWithdrawalDialog` | 合并覆盖 | 当前增加收款方式、账户、姓名、幂等键和金额精度校验 |
| `pages/mine/tixian_log` | 提现单号、金额、状态、审核时间、备注 | `pages/profile/earnings` | 部分合并 | 当前已有金额、申请时间、状态、收款人和失败原因；契约已保留但页面未显示提现单号、审核备注、打款参考号和到账时间 |

## 旧轮补齐记录（严格复核结果以上文为准）

| 优先级 | 原差距 | 参考证据 | 本轮结果 |
| --- | --- | --- | --- |
| P0 | 创建家谱缺“始迁祖”字段 | `createGenealogy.vue` 的 `first_ancestor_name` | 创建表单增加“始迁祖”，写入 camelCase 严格契约并等待后端 |
| P1 | 宣传视频没有首页直接入口 | 参考首页直接进入宣传视频列表/全屏页 | “我的家谱”有谱和空状态都提供宣传视频入口 |
| P1 | 首页宣传视频只有文字行，没有参考项目的两条封面，且点击被路由来源限制拦截 | `pages/index/index.vue` 读取两条宣传视频封面，点击进入指定视频 | 首页接入 `home_featured` 封面预览；放行 `G01 → F11`；封面携带 `videoId` 直达播放器 |
| P1 | 宣传视频列表直接铺开全部播放器，没有“先看封面、点后播放”的层级 | `xcindex.vue` 先显示封面，点击进入 `video3/video4.nvue` | 有封面时先显示图片与播放标识，点击进入纵向播放器；缺封面才显示原生视频控件 |
| P1 | 家族/宣传视频缺上下滑动观看 | `video2.nvue`、`video3.nvue`、`video4.nvue` 均使用纵向分页列表 | 当前增加可复用的纵向视频浏览器；滑走暂停、当前项播放 |
| P1 | 成长日志缺视频上传和播放 | `log/add.vue` 的 `accept="video"` 与 `log/details.vue` 的 `video_urls` | 成长记录表单已支持图片/视频，详情按媒体类型显示图片或视频 |
| P1 | 功德录缺图片上传和详情展示 | `meritsVirtues/add.vue` 的 `imgs` 与详情图片列表 | 仅完成前端控件；最新后端 DTO 没有媒体字段，MuMu 实测图片未回显，仍未完成 |

## 主要用户路径逐步对比

| 用户目标 | 参考项目步骤 | 当前项目步骤 | 结论 |
| --- | --- | --- | --- |
| 登录/找回 | 登录页输入手机号和密码；找回时填写实名、生日等旧身份信息 | 登录页选择密码、短信或微信；忘记密码进入短信验证和重置 | 目标覆盖，找回方式升级 |
| 注册账号 | 手机号 → 验证码 → 密码/确认 → 真实姓名/性别 → 邀请码 → 勾选协议 | 手机号 → 验证码 → 密码/确认 → 昵称/推荐码 → 勾选协议；实名和性别在资料页补充 | 目标覆盖，账号字段责任重新划分 |
| 创建家谱 | 首页创建 → 姓氏/谱名/堂号/始迁祖/地区/简介/权限 → 提交 | 我的家谱 → 创建 → 同等字段及封面/加入模式 → 提交 → 返回家谱列表 | 前端完整；始迁祖等待后端原子建人 |
| 查找并加入家谱 | 首页搜索或输入家谱编号 → 直接加入 | 搜索公开家谱 → 查看状态 → 提交申请，或输入一次性邀请码 → 预览 → 兑换 | 目标覆盖，加入权限更严格 |
| 管理家谱 | 进入家谱 → 邀请/排序/资料/删除 | 进入总览 → 邀请、成员、权限、排序、设置 → 归档或永久注销 | 当前覆盖并细分高风险操作 |
| 维护字辈 | 字辈列表 → 新增/编辑/删除 | 字辈页 → 批量编辑 → 预览 → 保存；缺失项可停用/恢复 | 当前覆盖并保留历史 |
| 浏览和维护世系 | 树谱 → 点人物 → 新增亲属/编辑/删除/绑定 | 世系树或成员目录 → 人物详情 → 新增亲属/编辑/身份绑定/同辈排序/停用 | 当前完整覆盖 |
| 管理人物证件 | 家谱证件总表 → 解锁 → 新增/编辑/批量删除 | 人物详情 → 证件弹窗 → 解锁 → 新增资源/编辑/单项删除 | 人物内维护已覆盖且文件授权粒度更细；缺家谱级聚合入口 |
| 管理谱文 | 分类 → 列表 → 解锁 → 详情/新增/编辑/删除 | 谱文列表筛选 → 详情解锁 → 编辑器 → 回收站删除 | 当前覆盖，密码找回改为短信 |
| 管理相册 | 相册列表 → 新建/编辑 → 图片管理 | 相册列表 → 新建/编辑 → 相册详情 → 上传/预览/全选/批量删除 | 当前完整覆盖 |
| 观看家族/宣传视频 | 首页两条封面或视频列表 → 点击指定内容 → `.nvue` 上下滑动 → 点赞/评论 | 首页推荐封面 → 指定视频纵向播放，或“查看更多” → 封面列表 → 点击播放 → 点赞/评论 → 关闭返回 | 前端链路已补齐；MuMu 已验证入口和空状态，播放仍等待后端投放真实数据 |
| 发布家族圈 | 家族圈 → 发布文字/图片 → 评论/回复/删除 | 动态列表 → 编辑器发布 → 详情分页评论/回复/点赞/删除 | 当前完整覆盖 |
| 记录成长日志 | 选择人物/分类 → 填内容/图片/视频/密码 → 详情解锁 | 成长日志筛选 → 新建/编辑 → 图片或视频上传 → 详情图片预览/视频播放 → 密码管理 | 本轮补齐视频后完整覆盖 |
| 记录功德 | 功德录 → 姓名/内容/图片 → 详情/编辑 | 功德记录 → 姓名/标题/类型/金额/内容/时间/图片 → 详情/编辑/删除 | 文字和结构化字段已覆盖；图片等待后端媒体契约，列表首图也待补 |
| 创建礼仪活动 | 贺礼分类 → 新建 → 标题/时间/地点/封面/备注 → 详情 | 活动列表 → 新建/编辑 → 同等字段 → 详情 → 邀请对象/回复/礼簿 | 当前完整覆盖 |
| 处理通知 | 消息列表 → 通知详情/加入审核/邀请 | 消息中心 → 详情 → 按目标进入审核、动态、备忘或活动邀请 | 当前目标路由更明确 |
| 维护个人资料与安全 | 我的 → 资料/设置/改密码/改手机号/反馈 | 个人中心 → 资料、安全、设置、协议、反馈 → 对应独立流程 | 当前完整覆盖 |
| 分享推荐关系 | 推广页 → 展示注册链接二维码或复制链接 | 推广中心 → 查看推荐码/人数 → 复制推荐码或系统分享文字 | 推荐关系已覆盖；扫码和注册链接渠道未覆盖，等待后端可信 `shareUrl` |
| 开通 VIP | 套餐 → 协议 → 支付方式 → 支付 → 成功页/完整订单信息 | VIP 页 → 套餐/协议 → capability 支持的渠道 → 支付 → 订单列表 | 支付链路已覆盖；订单号、支付时间、到期时间的独立展示仍待前端补齐 |
| 查看收益和提现 | 收益 → 提现金额 → 提交 → 提现记录 | 收益页 → 提现弹窗 → 金额/方式/账户/姓名 → 提交 → 分页记录/取消 | 提交和取消链路已覆盖；记录页缺提现单号及处理结果字段 |

## 操作、显示和状态覆盖表

| 模块 | 入口与操作 | 主要显示字段 | 表单/提交字段 | 当前状态处理 |
| --- | --- | --- | --- | --- |
| 认证 | 登录、注册、发码、重置、微信登录、查看协议 | 手机号、登录方式、协议标题/版本 | 手机号、验证码、密码、确认密码、昵称、推荐码、协议同意 | 发码倒计时、错误、提交中、协议未同意、登录取消 |
| 家谱列表/搜索 | 创建、搜索、申请加入、邀请码兑换、排序、宣传视频 | 谱名、姓氏、简介、地区、成员数、角色、加入状态 | 关键词、邀请码、申请说明、稳定 ID 顺序 | 加载、空、错误、申请中、已加入、已申请、无权限 |
| 家谱设置 | 编辑资料、邀请、归档、恢复、注销 | 编号、谱名、堂号、地区、简介、封面、可见性、加入模式 | 谱名、堂号、地区编码、详细地址、简介、封面 OSS ID、访问/加入策略 | 未保存确认、上传中、归档限制、注销资格、短信双确认 |
| 世系人物 | 树/目录查看、新增亲属、编辑、绑定、排序、停用 | 人物全名、世代、排行、父母、配偶、兄弟、子女、在世状态及完整档案 | 关系类型、人物资料、配偶关系、同辈顺序、身份绑定 | 无权限、敏感字段隐藏、关系冲突、加载/空/错、删除确认 |
| 字辈 | 查看、批量编辑、预览、停用、恢复、排序 | 世代、字辈、说明、人数、状态 | 多行字辈文本、是否停用缺失世代 | 非法重复、空行预览、提交中、历史保留 |
| 谱文 | 分类筛选、详情、创建、编辑、解锁、删除 | 分类、标题、摘要、正文、封面、作者、发布时间、密码状态 | 分类 ID、标题、摘要、正文、作者、封面 OSS ID | 锁定/解锁、短信找回、无权限、回收站、加载/空/错 |
| 相册 | 创建、编辑、进入相册、上传、预览、批量删除 | 名称、描述、封面、照片数、创建时间、照片信息 | 相册名、描述、照片标题/描述/拍摄人/时间、图片 OSS ID | 上传中、选择态、全选、部分删除失败、回收站 |
| 视频 | 发布、编辑、普通播放、纵向观看、点赞、评论、删除 | 标题、描述、封面、视频、发布人、时间、播放/点赞/评论数 | 标题、描述、封面 OSS ID、视频 OSS ID、时长 | 自动播放/暂停、上下滑动、评论分页、无权限、回收站 |
| 家族圈 | 发布、编辑、详情、点赞、评论、回复、删除 | 发布人、头像、正文、图片、时间、点赞/评论数 | 动态类型、正文、媒体 OSS ID | 草稿离开确认、评论分页、失败重试、重复提交保护 |
| 功德记录 | 列表、创建、编辑、详情、图片预览、删除 | 姓名、标题、类型、金额、内容、时间、图片、合计 | 捐赠人、标题、类型、金额、内容、时间、图片 OSS ID | 上传中、移除附件、金额精度、加载/空/错、回收站 |
| 成长记录 | 人物/分类筛选、创建、编辑、详情、解锁、删除 | 人物、分类、标题、内容、记录/提醒时间、图片、视频 | 人物 ID、类型、标题、内容、记录/提醒时间、媒体 OSS ID | 图片/视频上传、移除附件、媒体播放、密码保护/找回、回收站 |
| 人情记录 | 列表、创建、编辑、详情、图片预览、删除 | 对象、关系、事项、时间、金额、内容、图片 | 对象、关系、事项、时间、礼金、内容、媒体 OSS ID | 金额校验、上传中、加载/空/错、回收站 |
| 家族恩人/家族备忘 | 参考：家族恩人列表、创建、编辑、详情、删除；当前：备忘完成切换 | 参考显示标题、说明、图片、创建时间；当前另有提醒时间和完成状态 | 当前仅有备忘标题、内容、提醒时间、完成状态、媒体 OSS ID | 已确认恩人语义未覆盖；产品选择在 Memo 中增加独立类型或新建档案契约 |
| 礼仪活动 | 分类筛选、创建、编辑、详情、邀请、回复、记礼 | 类型、标题、时间、地点、地址、备注、封面、邀请/礼簿状态 | 类型、标题、时间、地点、地址、备注、封面 OSS ID、受邀人、礼金/留言 | 字典加载、上传中、邀请接受/拒绝、重复记礼保护 |
| 通知 | 列表、已读、详情、跳转业务目标 | 类型、标题、摘要、正文、发送人、家谱、时间、已读状态 | 通知目标参数 | 加载/空/错、目标失效、权限不足 |
| 个人中心 | 编辑资料、改密码、改手机号、帮助、反馈、推广、退出 | 头像、昵称、实名、性别、生日、邮箱、手机号、版本和协议 | 头像 OSS ID、资料字段、旧/新密码、短信码、反馈、推荐码 | 上传、短信倒计时、未保存确认、退出、账号注销 |
| VIP/收益 | 选套餐、支付、查订单、查流水、申请/取消提现 | 套餐、价格、渠道、订单状态；可用/冻结余额、流水、提现状态。订单号/双时间及提现处理信息待补 | 套餐 ID、渠道、金额、收款方式、账户、姓名、幂等键 | 渠道 capability、支付取消/未知、分页、金额上下限、取消资格 |
| 推广 | 查看推荐码/邀请人数、复制、系统分享、查看推广内容 | 推荐码、邀请人数、分享标题/文案、推广封面/链接；缺注册链接与二维码 | 无前端提交；注册时提交推荐码 | 推荐功能关闭、读取失败、系统分享取消、推广链接失效 |

## 关键字段对比

| 模块 | 参考字段/显示项 | 当前结果 |
| --- | --- | --- |
| 注册 | 手机号、验证码、密码、确认密码、真实姓名、性别、邀请码、协议 | 手机号、验证码、密码、确认密码、昵称、推荐码、协议已覆盖；真实姓名和性别移到注册后的账号资料页，避免注册契约重复 |
| 创建家谱 | 姓氏、谱名、堂号、始迁祖、地区、简介、访问权限 | 全部覆盖；当前另有所在地、详细地址、封面、加入模式，始迁祖等待后端落库联调 |
| 家谱卡片/总览 | 姓氏、谱名、简介、成员数、家谱编号 | 公开搜索显示姓氏、简介和成员数；自有家谱卡片不显示真实姓氏/简介，总览显示简介但不显示 `genealogyNo`。属于展示位置差异，编号是否恢复待产品确认 |
| 谱文 | 分类、标题、正文、落款、时间、查看密码 | 当前覆盖分类、标题、摘要、正文、封面、作者、时间、密码状态和权限 |
| 相册 | 名称、描述、照片数、创建时间、照片 | 名称、描述、封面、照片数和照片管理已覆盖；列表及最新 APP VO 缺创建时间，另有批量选择、部分失败和回收站恢复 |
| 重要证件 | 家谱级入口、归属人物、证件类型、图片、查看密码 | 人物内字段和维护全部覆盖，另有多文件资源、资源编辑、单资源删除和安全访问票据；缺家谱级聚合入口 |
| 家族视频 | 标题、视频链接/文件、描述、封面、创建人、评论 | 内容字段、互动和纵向观看全部覆盖；任意 URL 改为受控业务文件 |
| 功德录 | 姓名、内容、图片、时间 | 文字字段覆盖；图片未完成，后端无媒体字段且当前列表无首图 |
| 贺礼/活动 | 类型、标题、时间、地点、封面、备注 | 全部覆盖，另有受邀人、接受/拒绝状态和礼簿 |
| 成长日志 | 人物、分类、内容、图片/视频、查看密码 | 全部覆盖，安全问题改为短信找回 |
| 贺礼簿 | 标题、内容、时间 | 当前往来记录已覆盖并结构化为对象、关系、事项、金额、日期和备注 |
| 家族恩人 | 标题、内容、时间 | 当前家族备忘有相近字段并增加提醒时间和完成状态，但没有恩人身份/类型，属于确认语义缺口 |
| 家族圈 | 发布人、正文、图片、时间、评论、回复 | 全部覆盖并增加点赞、分页、删除权限、错误和弱网状态 |
| 账号资料 | 头像、昵称、真实姓名、性别、生日、邮箱、手机号 | 当前账号资料覆盖；手机号由独立安全流程维护 |
| 人物资料 | 姓名、昵称、字、别名、性别、亲属、同辈顺序、配偶、出生/农历、生肖、地址、手机、邮箱、学历、职业、生平、状态、享年、病史、逝世日期/地点/类型、安葬日期/地点 | 当前人物新增、编辑、详情契约均覆盖；病史由服务端能力控制，无权限不得返回 |
| VIP | 套餐、价格、协议、微信/支付宝/余额、订单号、订单状态、支付时间和到期时间 | 支付能力已覆盖；后端已有字段，但当前缺订单号，支付/到期时间也未分别显示 |
| 收益提现 | 余额、流水、金额、提现记录、状态、审核/打款信息 | 提交、取消、冻结金额和幂等保护已覆盖；页面未消费契约已有的提现单号、审核备注、打款参考号和到账时间 |
| 推广邀请 | 推荐码、注册链接、二维码、复制/分享 | 推荐码、邀请人数、复制推荐码和系统分享文字已覆盖；注册链接和二维码缺失，后端也未返回可信 `shareUrl` |

## 表单必填规则差异（产品确认项）

这些差异是提交规则不同，不等于当前项目漏字段。除非后端业务约束或产品明确要求，不按参考项目机械收紧。

| 表单 | 参考项目提交校验 | 当前项目提交校验 | 结论 |
| --- | --- | --- | --- |
| 创建家谱 | 谱名、姓氏、堂号、始迁祖、地区、简介都必填 | 姓氏、谱名、地区必填；堂号、始迁祖、简介可选 | 字段均已有（始迁祖待后端落库），必填强度不同，需产品确认 |
| 谱文 | 标题、正文、落款、查看密码和两组安全问答必填 | 标题、正文必填；作者、摘要、封面可选；密码找回改短信 | 当前是安全流程升级与较短表单，不回退旧安全问答 |
| 家族视频 | 参考提交只强制视频 URL | 当前强制已上传视频和标题 | 当前规则更完整，不按参考放宽 |
| 功德录 | 姓名和内容必填 | 捐赠人和标题必填，内容可选 | 业务语义不同；需确认“内容”是否必须，媒体缺口另行处理 |
| 贺礼簿 | 标题和内容必填 | 当前往来记录为亲友姓名必填，其余结构化字段和备注可选 | 当前已从自由文本升级为结构化记录；是否要求事项/备注需产品确认 |
| 家族恩人 | 标题和内容必填 | 当前家族备忘为标题必填，内容可选 | 先确认是否复用备忘录；若复用，再确认是否允许仅标题记录 |
| 礼仪活动 | 标题、备注、地点、时间必填 | 类型和标题必填，时间、地点、备注可选 | 当前允许先建草稿式活动；若活动发布必须完整，需定义状态后再收紧 |
| 成长日志 | 人物、内容、查看密码和两组安全问答必填 | 标题必填，人物来自筛选上下文；内容、媒体可选；密码按当前保护机制设置 | 当前流程已融合人物上下文并升级找回方式，不复制旧问答校验 |

## 第四轮复核后仍待处理或验证

| 优先级 | 项目 | 当前事实 | 责任与完成条件 |
| --- | --- | --- | --- |
| P0 | 普通谱主进入家谱设置 | MuMu 仍收到后端“家谱必须先归档”，与参考项目可进入设置的目标不一致 | 后端拆分所有者鉴权和永久删除资格；修复后前端回归详情、设置、归档和恢复 |
| P1 | 家谱级重要证件 | 当前只有人物详情入口；服务端查询条件允许不传人物 ID | 前端增加家谱级入口和跨人物列表，复用现有证件详情/编辑能力 |
| P1 | VIP 订单完整字段 | 当前未显示订单号，支付时间和到期时间只显示其一 | 前端修正订单规范化契约并独立展示三项字段 |
| P1 | 提现记录处理字段 | 页面未显示契约已有的提现单号、审核备注、打款参考号和到账时间 | 前端按提现状态展示现有字段；若必须显示独立审核时间，再由后端增加字段 |
| P1 | 推广注册链接和二维码 | 参考项目能展示二维码并复制注册链接；当前只能分享推荐码文字，后端没有链接字段 | 后端提供可信 `shareUrl`，前端生成二维码并提供复制/分享；不迁移旧硬编码域名 |
| P1 | 六类列表创建时间 | 参考相册、礼仪、功德、成长记录、贺礼簿和家族恩人列表显示 `create_time`；当前除相册外只显示不同语义的业务时间，五个已确认映射 VO 均无 `createTime` | 后端先为五个已确认映射 VO/OpenAPI 增加只读创建时间；家族恩人按选定契约增加；前端同时保留业务时间 |
| P1 | 宣传视频真实内容 | 前端入口、封面态、指定视频直达和播放器已完成；测试环境 `home_featured`、`video_center` 均返回空列表 | 后端/运营各配置至少一条有效期内、含 `videoFile` 和建议含 `coverFile` 的数据后，在 MuMu 完成播放点击验收 |
| P1 | 独立图片宣传内容 | 最新后端 `PlatformVideoVo` 只表达视频及可选封面，不能表达“只有图片、点击放大”的独立内容 | 若产品确认需要纯图片，后端先定义混合媒体类型、图片文件和点击行为；前端再增加图片预览，不能猜字段 |
| P1 | 原生视频最终行为 | 代码和路由检查通过，空数据环境无法验证首帧、自动播放、上下滑动、横竖屏和弱网恢复 | 有真实视频数据后在 MuMu 和至少一台 Android 真机走完播放、切换、暂停、返回和评论 |
| P1 | 其余参考路径的交互级验收 | 78/78 路由已逐项登记，但本表不是 78 条路径的全部真机点击记录 | 按高频主路径逐页执行点击用例并记录结果；未点击的项不能再仅凭页面映射声称完全一致 |

## 交互与状态核对

当前项目对所有正式业务页统一补充了参考项目普遍缺失的状态：加载、空数据、错误重试、提交中、按钮禁用、离开未保存确认、删除二次确认、权限不足、请求取消和非幂等结果未知。它们属于当前项目正式验收范围，不因为参考项目没有实现而删除。

本表由 `scripts/check-frontend-parity.mjs` 校验参考 78 条活动路由是否逐条且只出现一次。它只能证明静态清单无遗漏；真实后端数据、真机微信/支付和原生视频行为仍需联调或真机验证。

## 第六轮：浏览器与 MuMu 实际点击复核（2026-08-23）

本轮按用户指定环境区分执行：参考项目在已登录浏览器中点击，当前项目在已登录 MuMu 中点击，同时保留代码全量路由核对。详细步骤、截图和分组结论见 [点击对比审查](click-comparison-audit-2026-08-23.md)。

新增运行时证据没有推翻上文的融合判定，重点确认如下：

- 家族内容模块确实合并到当前“家族”主标签，不是缺页。
- 参考家族视频采用封面卡片进入独立播放页；当前测试家谱为空，无法验真实播放，但当前家族视频列表源码直接渲染播放器的差异仍成立。
- 参考推广页直接显示注册链接二维码；当前只有推荐码、复制和系统分享，没有页面二维码或注册链接。
- 参考家谱级“重要证件”可集中显示多张证件图片并提供管理/上传；当前只有人物内证件入口。
- 参考 VIP 记录显示订单号、支付时间和到期时间；当前订单卡仍缺这些完整字段。
- 当前家谱设置进入即读取失败，点击“重新读取”后画面完全相同，P0 阻断仍未修复。

## 第七轮：剩余核心入口继续点击（2026-08-23）

继续实点参考礼仪、谱文、功德、家族恩人、贺礼簿、成长记录、字辈谱、世系谱、家族动态、管理员、VIP 购买、消息、创建和加入家谱，并再次核对当前页面与最新后端源码。

- 礼仪封面、功德多图、成长具体记录的 `create_time` 均由运行态确认，既有三项结论成立。
- 参考 `favor` 的真实产品名称是“贺礼簿”；MuMu 当前入口也直接显示“贺礼簿”，新建页是字段更完整的往来记录，确认不缺独立重复页面。
- 参考 `memorandum` 的真实产品名称是“家族恩人”；MuMu 当前入口和新建页明确是提醒型“家族备忘”，最新前后端主业务代码也没有恩人类型。确认存在业务语义缺口；产品只需选择复用 Memo 类型还是独立档案。
- 参考“家族普”实际是动态流，对应当前“家族圈”；字辈谱、世系谱、管理员、消息和加入家谱均已有融合或更安全的升级实现。
- MuMu 登录态恢复后已补点礼仪、功德、贺礼簿、家族备忘、人物详情和成长日志。五组页面均可进入，空状态和新建表单稳定；因测试家谱对应列表为空，首图、详情媒体和创建时间仍只能依据契约/模板判断，不能声称有数据链路已通过。