jiapuapp/docs/click-comparison-audit-2026-08-23.md

当前项目与参考项目点击对比审查

审查日期：2026-08-23

结论

本轮同时完成了两类核对：

• 代码全量核对：参考项目 78 条活动路由逐条映射到当前项目 59 条活动路由，合并页面按入口、操作、字段和状态判断，不按页面数量机械判缺。
• 运行时点击核对：参考项目使用用户已登录的浏览器，当前项目使用用户已登录的 MuMu；第一轮对首页、家谱总览、家族视频、相册、个人中心、推广、收益提现、重要证件、VIP 和家谱设置进行了实际点击与截图。继续复核时，参考项目又实点礼仪、谱文、功德、家族恩人、贺礼簿、成长记录、字辈谱、世系谱、家族动态、管理员、消息、创建和加入家谱；MuMu 重新登录后，补点了礼仪、功德、贺礼簿、家族备忘、人物详情和成长日志的列表、空状态及新建表单。

继续复核没有发现需要推翻既有“融合覆盖”判断的新页面，但纠正了两处业务名称：参考 favor 是“贺礼簿”，当前也以“贺礼簿”作为入口并升级为结构化往来记录；参考 memorandum 的产品名称是“家族恩人”，当前运行态明确是“家族备忘”，没有恩人身份或分类，不能判定已经融合。当前仍确认 14 项确定缺口，另有实现方案待产品选择和数据不足待验项。最紧急问题是当前项目的家谱设置仍被接口错误整体阻断。

点击链路结果

链路	参考项目实点结果	当前项目实点结果	判定
首页 → 家谱总览	进入 15 宫格式功能总览	进入纵向家谱总览；谱文、相册、视频等内容合并到“家族”主标签	已融合，不按页面布局判缺
家谱总览 → 家族视频	卡片先显示封面，点击进入独立播放页；浏览器播放页为黑屏，不能据此确认视频源可播放	家族视频入口可进入，但测试家谱没有视频数据；列表源码仍直接渲染播放器	确认列表交互缺口；实际播放待有数据再验
家族 → 相册 → 相册详情	列表显示封面、名称、说明、照片数、创建时间；详情可进入	列表与详情可进入；当前测试相册为空，列表不显示创建时间	创建时间缺口确认；有图预览因数据不对等暂不能下结论
我的 → 分享变现/应用推广	页面直接显示注册链接二维码，可点击链接分享	显示推荐码、邀请人数、复制推荐码、系统分享和推广内容，没有页面二维码或注册链接	确认前后端缺口
我的 → 余额/收益与提现	始终提供提现记录、申请提现；申请页有金额和收款码上传	当前显示收益与提现页，但接口未给最低金额时直接显示“暂未开放提现”	可用性差异确认；记录字段缺口由代码契约进一步确认
家谱总览 → 重要证件	独立家谱级页面按证件类型集中显示多图，并有管理、上传	家谱总览没有聚合入口，仅人物资料内提供证件管理	确认前端聚合入口缺口，现有接口可复用
我的/总览 → VIP 购买记录	每条显示订单号、套餐、状态、支付时间、到期时间	当前显示套餐、金额和状态，不显示订单号，支付/到期时间也未完整分开展示	确认前端字段消费缺口
家谱总览 → 家谱设置 → 重新读取	参考项目基础资料可查看和维护	首次进入显示“家谱设置暂时无法读取”；点击重试后仍为完全相同错误画面	P0 阻断，确认仍未修复

继续点击复核（编号步骤）

1. 点击参考“礼仪”列表并进入详情：列表和详情都显示活动封面，详情另显示分类、时间和地点。当前代码已有 coverFile，但列表与详情没有消费，原“礼仪封面缺口”结论成立。
2. 点击参考“谱文”分类和列表：可进入分类列表；详情被内容密码弹窗拦住，本轮没有绕过密码，因此只保留已有列表与源码证据，不声称详情已验证。
3. 点击参考“功德”列表并进入详情：列表有首图和创建时间，详情可显示多张图片。当前前端虽有上传与预览代码，但后端媒体契约仍未完整闭环，原缺口成立。
4. 点击参考 memorandum 列表并进入详情：页面实际名称是“家族恩人”，显示标题、说明、多图和创建时间。当前只有通用“家族备忘”，代码与最新后端主业务源码均没有恩人类型；是否用备忘录扩展类型或保留独立模块，必须先由产品确认。
5. 点击参考 favor 列表并进入详情：页面实际名称是“贺礼簿”，显示标题、说明、多图和创建时间。当前“往来记录”已升级为姓名、关系、事项、日期、金额、备注和多图，核心能力已融合，只保留列表首图与创建时间差异。
6. 依次点击参考“成长记录 → 人物 → 成长阶段 → 具体记录”：人物层不显示时间，但具体记录列表确实显示 create_time，因此“六类记录创建时间”仍包含成长记录，不能把业务日期代替创建时间。
7. 点击参考“字辈谱”和“世系谱”：当前分别有字辈管理和图形化谱系，属于同能力融合/升级，不补重复页面。
8. 点击参考“家族普”：实际内容是家族动态流，对应当前“家族圈”，不是另一套缺失的家谱模块。
9. 点击参考“管理员”：当前成员与角色管理覆盖且权限表达更细，判定为升级，不补页面。
10. 点击参考“VIP 购买”和“消息”：支付方式能力当前已按后端能力动态展示；消息中的申请、文档和联系入口已被当前消息中心、帮助与合规页面拆分覆盖。
11. 点击参考“创建家谱”和“加入家谱”：当前创建字段覆盖并更完整，仅始迁祖后端落库仍是已确认缺口；当前申请、邀请码和搜索加入属于安全流程升级。
12. 准备继续点击当前 MuMu 时，应用登录态已失效并停在“登录家谱”。本轮拒绝把登录页截图作为功能证据；礼仪、功德、家族恩人/备忘、贺礼簿/往来记录和成长记录的当前端再次实点，需恢复登录后补测。

MuMu 重新登录后的补点结果

13. 从当前“家族动态”进入“礼仪”：列表和空状态正常，新建表单显示活动类型、标题、说明、日期、时间、地点、详细地址和封面图片。测试家谱没有礼仪数据，因此不能用运行态证明列表/详情会显示封面；源码不消费 coverFile 的缺口仍成立。
14. 从当前“家族动态”进入“功德录”：列表和空状态正常，新建表单显示捐赠人、标题、金额、内容、类型、日期、时间及相关图片。最新后端 AppMeritRecordBody/AppMeritRecordVo 仍没有媒体字段，所以前端上传入口存在，但保存回传链路未闭环。
15. 从当前“家族动态”进入“贺礼簿”：当前页面标题就是“贺礼簿”，新建表单将参考自由文本升级为亲友姓名、关系称谓、礼仪事项、日期、时间、礼金金额、备注和图片。确认属于融合升级，不新增独立页面；空列表仍无法验证首图和创建时间显示。
16. 从当前“家族动态”进入“家族备忘”：新建表单只有备忘标题、提醒日期/时间、备忘内容和图片，没有恩人姓名、身份、类别或专属文案。参考“家族恩人”的产品语义在当前端确实不可发现，确认是业务入口/分类缺口；可复用现有 Memo 模块扩类型，但不能只改标题冒充完成。
17. 从当前“人物录 → 人物详情 → 成长日志”进入成长记录：链路可走通，新建表单支持人物、成长阶段、标题、内容、记录时间、提醒时间、图片和视频。核心能力已融合且更丰富；当前入口比参考多两层，是否提升到家族首页属于信息架构选择。测试人物没有成长数据，仍不能用运行态验证列表创建时间。

MuMu 补点截图

当前礼仪	当前功德

当前贺礼簿	当前家族备忘	当前成长日志

继续复核截图

礼仪列表与详情	功德列表与详情

家族恩人	贺礼簿	成长具体记录

字辈谱/世系谱	家族动态	创建/加入家谱

截图证据

视频列表与播放入口

参考项目	当前项目

参考卡片点击后确实进入独立播放器，但浏览器中显示黑屏，因此本轮只能确认“封面卡片 → 播放页”的交互，不能声称视频成功播放。

推广邀请

参考项目	当前项目

重要证件与家谱设置

参考项目重要证件	当前项目家谱设置阻断

VIP 订单

参考项目	当前项目

确定需要补的项目

优先级	差异	当前是否已有相近能力	责任与完成条件
P0	家谱设置整体读取失败	页面和表单均已有，但基础详情与永久删除资格被同一个 Promise.all 绑定	前端把删除资格改为非关键独立状态；后端让未归档谱主正常读取详情和 capability 的禁用原因
P0	家族视频列表仍直接铺 <video controls>	已有封面字段和纵向播放器	前端改成封面优先卡片，点击打开指定视频；有真实数据后验播放、暂停、滑动和返回
P0	功德图片提交后无法稳定回显	前端已有上传和详情预览	后端补媒体请求/响应与文件引用；前端补列表首图并完成增删改回归
P1	礼仪封面未在列表和详情显示	编辑页和后端 coverFile 已有	前端消费现有封面并支持预览
P1	谱文封面未在列表和详情显示	编辑页和后端单封面已存在	前端先显示现有单封面；是否扩成参考项目多图正文另行决策
P1	家谱级重要证件聚合入口缺失	人物内证件维护完整，接口允许不传人物 ID	前端增加家谱级列表/入口，复用现有查看、编辑和安全访问能力
P1	VIP 订单号、支付时间、到期时间缺失	后端字段已有	前端契约保留 orderNo，页面分别显示三项
P1	提现记录处理字段未展示	契约已有提现单号、审核备注、打款参考号、到账时间	前端按状态展示已有字段；若产品还要独立审核时间，后端再补 reviewedAt
P1	推广缺注册链接和二维码	推荐码、邀请人数、复制和系统分享已有	后端返回可信 shareUrl；前端生成二维码并提供复制/分享链接
P1	谱文、礼仪、视频封面不能显式移除	可上传或替换	后端/OpenAPI 统一 coverOssId: null 清空语义，前端增加移除并保留显式空值
P1	参考六类列表均有记录创建时间	部分页显示业务发生时间，但语义不同	五类已确认映射 VO 先增加只读 createTime；家族恩人按选定契约持有创建时间；前端与业务时间分别显示
P1	贺礼簿对应的往来记录列表缺首图	详情已有多图预览	前端列表显示 mediaFiles[0] 缩略图
P1	“家族恩人”入口与业务类型缺失	当前家族备忘有相近的标题、内容和图片，但运行态只有提醒语义，没有恩人身份/分类	产品确认复用 Memo 还是独立档案；复用时增加受校验的业务类型、独立入口/文案、列表首图和创建时间，不能只改页面标题
P1	创建家谱的始迁祖未由后端落库	前端表单和请求字段已有	后端在创建家谱事务中接收 firstAncestorName 并原子创建第一代人物

已融合或升级，不应重复补页面

参考能力	当前实现	判定
谱文、相册、视频、功德、礼仪、成长、贺礼簿等宫格入口	合并到“家族”主标签和内容模块	合并覆盖，不需要复制参考总览宫格；“家族恩人”是否映射“家族备忘”单独待确认
注册真实姓名、性别	注册后在个人资料维护	流程重分配；是否改回注册必填属于产品决策
编号加入、直接硬删除、安全问题找回、任意视频 URL	申请/一次性邀请码、回收站/归档、短信找回、受控文件上传	安全与数据完整性升级，不回退
人物证件查看与维护	人物详情中的多文件证件弹窗、安全票据和删除能力	人物级功能已覆盖；只缺家谱级聚合入口
视频点赞、评论、纵向播放器	当前已有独立组件和路由	播放能力代码存在；家族视频列表入口和真实数据验收仍待补
个人中心广告/推广内容	当前个人中心底部推广条和推广中心内容	已融合；缺的是邀请注册链接二维码，不是整个推广模块

不能直接判定为缺口的项目

• 首页搜索、加入、排序和宣传内容的位置与参考项目不同，但能力已存在；是否提升到首页首屏是产品信息架构选择。
• 当前家谱编号和自有家谱卡片的姓氏/简介显示位置不同，字段并非完全不存在；是否强制同位置展示需产品确认。
• 参考项目多处批量管理，当前除相册照片外大多逐条删除。要补之前需先定义回收站下的批量部分成功语义。
• 宣传视频接口本轮仍为空，当前只能验证入口和空状态，不能验证原生播放、上下滑动、横竖屏和弱网恢复。
• “纯图片宣传并点击放大”不能拿视频封面代替；若确有该产品需求，后端要先定义混合媒体类型和目标行为。
• 参考“家族恩人”不是仅靠路由名可以判定的普通备忘录。MuMu 补点已确认当前只有“家族备忘”，因此“恩人”业务语义缺失计入确定缺口；具体采用独立档案还是 Memo 类型仍需产品选择，在此之前不虚构后端字段。

可用性与可访问性观察

• 参考“世系谱”在窄屏中使用密集竖排小字，人物较多时可读性和点击命中范围有明显风险；当前图形化谱系方向更适合移动端，但仍应在真机数据量较大时复测缩放、聚焦和文字截断。
• 参考多个列表把“管理”、删除态和普通卡片操作放在相近位置，操作模式不够一致；当前使用明确按钮和回收站语义更安全，不建议为了视觉一致而回退。
• 本轮只能根据截图和可见控件判断层级、字号与触控风险；没有执行屏幕阅读器、外接键盘焦点顺序、对比度测量，因此不声称已完成完整无障碍验收。

本轮验证边界

• 两端使用的是不同账号和不同数据集，因此内容条数、姓名和图片本身不作一致性判断，只比较可执行路径、字段与状态。
• 参考项目运行在 440×960 浏览器视口，当前项目运行在 900×1600 MuMu；本轮是功能与信息架构审查，不是逐像素视觉还原。
• 未执行购买、提现提交、删除、归档、资料保存、验证码发送等会写入数据或触发外部动作的操作。
• 全量路由脚本只证明 78 条参考路由已登记和映射；没有真实数据的播放器、支付、微信和写操作仍需专项联调。
• 继续复核期间 MuMu 曾短暂失去登录态；截图 35-current-ceremonies.png 和 49-current-login-check.png 仅用于证明当时的阻断，不作为任何当前功能的通过证据。用户重新登录后，步骤 13～17 已补测完成。