jiapuapp/docs/second-pass-comparison-audit-2026-08-23.md

当前项目与参考项目第二轮独立复审

审查日期：2026-08-23
参考项目：C:\Users\Rain\Desktop\job\Jiapu-App（浏览器，已登录）
当前项目：C:\Users\Rain\Desktop\job\jiapuapp（MuMu，已登录）
后端项目：C:\Users\Rain\Desktop\job\Genealogy

结论

第二轮没有沿用第一轮截图直接下结论，而是重新抓取参考项目与 MuMu 当前页面、重新点击关键入口，并再次核对当前前端源码、OpenAPI 与后端 Java 契约。

• 78 条参考路由仍全部有映射，当前项目 59 条路由和 172 个源码文件的完整性检查通过。页面数量不同主要来自当前项目的融合设计，不能按数量机械判缺。
• 第一轮确认的 14 项差异，经第二轮逐项复查后仍然成立；部分前端契约已经接入，但对应页面未消费，或后端契约尚未闭环。
• 第二轮新增确认 1 个当前项目自身的交互缺陷：成长记录新建表单未手动填写时，因自动带入人物仍被判定为“已修改”，返回会错误弹出放弃确认。
• 合计：14 项参考对比差异 + 1 项当前交互缺陷。最高风险仍是“家谱设置完全无法读取”。
• 本轮只做审查和文档整理，没有修改业务代码、接口契约或数据。

编号复审步骤与健康度

步骤	重新检查的范围	健康度	第二轮结论
1	路由与源码完整性	健康	参考 78 条路由均有登记与融合映射；当前 59 条路由、172 个源码文件检查通过。
2	首页与入口层级	基本健康	搜索、创建、加入、排序、宣传内容在当前项目均可找到，但位置比参考项目更深；属于信息架构差异，不计缺页。
3	家谱总览与家族主入口	基本健康	字辈、世系、成员、审核、谱文、相册、礼仪、备忘、人物录、贺礼簿、功德和视频均已有融合入口。
4	谱文、相册、礼仪、备忘、贺礼簿、功德、视频逐项进入	部分健康	7 个入口都可进入且空状态正常；由于测试家谱缺少对应内容，只能确认入口和状态，列表媒体与播放仍结合源码判断。
5	家族视频展示与播放入口	不健康	参考项目先显示封面卡片，点击后播放；当前列表仍直接铺设 <video controls>，未使用已有 coverFile 做封面优先卡片。
6	谱文与礼仪封面	不健康	两类响应契约均已保留 coverFile，编辑器也能上传，但列表和详情仍未渲染，属于前端字段消费缺口。
7	功德记录媒体闭环	不健康	当前前端已有上传、详情预览和 mediaOssIds/mediaFiles 处理；最新后端 AppMeritRecordBody/AppMeritRecordVo 仍无媒体字段，保存回显链路未闭环。
8	推广、收益提现与 VIP	不健康	推广推荐码与系统分享可用，但无注册链接/二维码；提现契约字段未完整展示；VIP 未显示订单号且支付/到期时间没有独立展示。
9	重要证件与家族恩人语义	不健康	重要证件只存在于人物详情，没有参考项目的家谱级聚合入口；当前“家族备忘”也没有“家族恩人”的身份、分类和档案语义。
10	家谱设置首次读取与重试	阻断	首次进入显示“家谱设置暂时无法读取”，点击“重新读取”后画面完全相同。源码仍把基础设置与永久删除资格放在同一个 Promise.all。
11	创建家谱始迁祖	不健康	前端有 firstAncestorName 表单与请求字段；最新后端业务源码未找到接收并原子创建第一代人物的实现。
12	成长日志新建后返回	不健康（新增）	空表单自动带入 lineagePersonId 后即被 dirty 判定为真，未编辑也弹出“放弃成长记录？”。

第二轮确认仍需处理的差异

优先级	差异	当前项目已有能力	责任与完成条件
P0	家谱设置整体读取失败	设置页面和全部表单已存在	前端将基础设置读取与永久删除资格拆成独立状态；后端确认普通家谱的详情及删除资格响应。首次读取和重试均须成功。
P0	家族视频列表不是“封面卡片 → 点击播放”	coverFile、视频文件、纵向播放器均已有	前端以封面卡片作为列表主展示，点击打开指定视频；有真实数据后验证播放、暂停、返回和上下滑动。
P0	功德图片无法由后端稳定保存和回显	前端上传、移除、详情预览已存在	后端为功德请求/响应增加媒体字段及文件引用维护；前后端完成新增、编辑、删除、回显联调。
P0	成长日志空表单误报未保存修改	已有返回保护机制	前端的脏状态基线应包含系统自动带入的人物，只有用户实际修改后才弹放弃确认。
P1	礼仪封面未展示	后端和前端契约已有 coverFile，编辑器可上传	前端列表和详情消费封面，支持预览。
P1	谱文封面未展示	后端和前端契约已有 coverFile，编辑器可上传	前端列表和详情消费封面；正文是否扩展为多图另行决定。
P1	家谱级重要证件聚合入口缺失	人物详情已有证件管理与安全访问	前端新增家谱级入口和聚合列表，复用现有查看、编辑及安全能力。
P1	VIP 订单号、支付时间、到期时间显示不完整	后端已有 orderNo/payTime/expireTime	前端契约保留 orderNo，页面将三项分别标注展示。
P1	提现处理字段未展示	前端契约已有 withdrawalNo/auditRemark/payoutReference/paidAt	按状态显示提现单号、审核备注、打款参考号和到账时间。
P1	推广注册链接与二维码缺失	推荐码、邀请人数、复制和系统分享已存在	后端返回可信 shareUrl；前端展示二维码，并支持复制/分享注册链接。
P1	谱文、礼仪、视频封面不能显式移除	三类编辑器可上传和替换	统一 coverOssId: null 的清空契约，前端增加移除操作并验证保存回显。
P1	参考内容列表的创建时间未覆盖	当前已有业务发生时间	后端为谱文、礼仪、相册、成长、往来和功德等响应补只读 createTime，前端与业务时间分开显示。
P1	贺礼簿列表缺少首图	详情可预览 mediaFiles	前端列表显示 mediaFiles[0] 缩略图。
P1	“家族恩人”业务语义缺失	通用家族备忘有标题、内容、提醒和图片	产品先确定扩展 Memo 类型或建立独立档案；随后补身份、分类、独立入口、首图和创建时间。
P1	创建家谱的始迁祖未由后端落库	前端已提交 firstAncestorName	后端在创建家谱事务中接收该字段，并原子创建第一代人物。

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

参考能力	当前项目对应能力	判定
世系谱	图形化世系树	已融合升级，不另建重复页面。
字辈谱	字辈管理	已融合升级。
管理员	成员、角色与权限管理	已覆盖且权限更细。
家族普/家族动态	家族圈、动态详情、点赞和评论	已融合升级。
贺礼簿	结构化亲友往来记录	核心能力已融合，保留列表首图和创建时间差异。
成长记录	人物详情下的成长日志	核心字段和图片/视频能力更丰富；入口深度属于产品选择。
个人中心推广内容	推广中心和个人中心推广条	已融合；缺的是注册链接和二维码，不是整个推广模块。

关键截图证据

首页和总览

参考项目	当前项目

家族内容入口

当前谱文	当前相册	当前家族视频

参考谱文	参考相册	参考家族视频

财务、推广与阻断项

参考推广二维码	当前推广中心

参考 VIP 订单	当前 VIP 订单

当前设置首次失败	点击重试后

第二轮新增缺陷

验证边界

• 两端登录的是不同账号、使用不同数据集，内容条数、姓名和图片本身不作为一致性判断；比较的是入口、操作、字段、状态和交互。
• 参考项目浏览器视口与 MuMu 分辨率不同，本轮不是逐像素视觉还原审查。
• 测试家谱的谱文、礼仪、功德、贺礼簿和视频大多为空，空状态只能证明入口可达，不能证明有数据时的封面、首图、时间和播放正常；这些结论由当前源码和后端契约补证。
• 没有执行购买、提现提交、删除、归档、保存或验证码发送等写操作。
• 没有执行屏幕阅读器、外接键盘焦点顺序和自动对比度测试，因此不声明已完成完整无障碍验收。