laoyang 294c34bbc2 feat: 补齐默认头像资源，修复「删除头像」静默失效 ...

问题：添加观影人页面的头像预览指向 /assets/default-avatar.png，但仓库里
从来没有这个文件 → 该预览一直是坏图；同时未上传头像时会按姓名首字母生成
彩色 SVG 头像，导致「没有头像」这一种状态有两种表现，行为不统一。

改动
- assets/default-avatar.png（新增）：200x200 中性灰人形剪影，随仓库分发；
  生成脚本见 _tooling/make_default_avatar.py（Pillow，4 倍超采样）。
- lib/helpers.php：新增 defaultAvatarUrl()；getAvatarUrl() 在未上传头像时
  一律返回默认头像（不再生成首字母头像）；资源缺失时退化为内联 SVG 剪影，
  彻底消除「兜底图本身就是坏图」这类问题。
- persons.php：
  * 后端开始处理 delete_avatar —— 此前前端设了标记、后端从未读取，
    点「删除」再保存头像原样保留，是个静默失效的按钮。
  * 上传新头像优先于删除标记，避免「先点删除、后又重新选图」时上传被忽略。
  * removeAvatar() 复用同一个隐藏域，重复点击不再叠加多个同名 input。
  * 表单预览统一走 getAvatarUrl()（顺带修掉头像键存在但文件丢失时仍渲染坏图）。
- README.md：更新头像兜底说明、目录树与「已知限制」。

验证
- storage_test.py 新增第 [21] 节 21 项断言（资源合法性、HTTP 可访问、四个分支、
  资源缺失降级、页面渲染、删除头像端到端），合计 196 项全绿。
- 47 个端点的 A/B 回归：剔除「预期的头像地址替换」与「persons.php 内联 JS 重写」
  后无任何其它差异（0 处未解释变更）。
- 第 10 批部署已上线：线上 assets/default-avatar.png 的 sha256 与本地逐字节一致，
  全站无 PHP 诊断泄漏，数据行数不变（movies 219 / persons 17 / viewers 449）。

2026-09-21 22:21:01 +08:00

5.2 KiB

200x200px

Raw History