perf(report): load side wrinkle layers after report entry

docs/侧脸皱纹浮层异步加载-2026-10-16.md

@@ -0,0 +1,13 @@
+# 侧脸皱纹浮层异步加载
+
+主测肤请求只等待主接口、评分及报告保存，不再同步等待左右侧脸的皱纹浮层。正面浮层随主接口返回。前端在报告切屏并经过两帧绘制后，才调用 `POST api/wrinkle-views`，获取该报告所属任务的左右侧脸标注。
+
+加载期间保留两张侧脸原图并显示「侧脸皱纹标注加载中…」。完成后只更新侧脸图片，不重算分数、不改结论或护理建议。失败/超时仅退回原图提示，报告继续使用。扫描等待页 30 秒兜底只针对主报告，不受浮层任务影响；可选浮层请求前端预算 65 秒，服务端两次顺序请求仍各最多 20 秒、间隔 4 秒。
+
+使用随机任务令牌并绑定服务器会话所属账号；不同账号无法获取他人的标注。重复/并发请求共用同一任务，成功或失败结果都缓存，不自动重新收费调用。微信任务元数据及完成结果持久化，补写原报告 payload、后台标注状态和原始结果，不修改 vm/presentation。服务重启后可继续尚未启动的任务；已标记运行但被重启打断的任务不自动重跑，避免重复调用。老报告无任务令牌时不自动补检。
+
+游客任务、照片及结果仅存内存，五分钟后清除，不写游客身份或报告到磁盘。任务从未被报告页请求时，不调用额外侧脸检测。微信任务可从已有报告快照恢复照片，无需用户重新上传。离开报告或切换账号后，迟到结果不修改当前页面；返回同一报告可显示已加载数据。
+
+后台 `cost_ms` 现在代表主报告检测链路，额外浮层耗时记录为 `wrinkle_cost_ms`。正常案例从进入报告的等待中移走固定的两次 4 秒间隔及两次侧脸请求耗时，但不承诺固定秒数，不减少已实际执行的接口调用数量。
+
+验证使用隔离数据目录和模拟上游，不产生付费检测：主响应只有一次上游调用、报告显示后才请求侧脸、总共三次模拟调用、重复并发与重启缓存、不同账号隔离、游客无磁盘写入、离开/返回和失败降级，以及评分和报告结论不变。