文档:新增启用通知,操作手册补充缓存刷新说明

- 新增 docs/启用通知.md,可直接发给使用人员
- 操作手册新增第 0 节:访问过旧版的浏览器需强制刷新一次,
  否则会出现"有成品图片标题但没有选择图片按钮"
- 第 10 节补充同一问题的排查方法
- 4.3 补充 8 MB 单张上限与上传超时的处理
- 版本号从 1.0 更新为 1.3.0

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-26 22:20:19 +08:00
co-authored by Claude Fable 5
parent edfb216561
commit 33147faeda
2 changed files with 99 additions and 1 deletions
+18 -1
View File
@@ -1,6 +1,21 @@
# 激光材料数据平台操作手册
版本:1.0 更新日期:2026-07-17
适用平台版本:1.3.0 文档更新日期:2026-07-26
## 0. 老用户请先强制刷新一次
如果你**以前访问过本系统的旧版本**,浏览器很可能仍在使用缓存里的旧页面文件。表现是:录入页能看到“成品图片”这一段标题,但**下面没有“选择图片”按钮**,或者按钮点了没反应。
这不是故障,强制刷新一次即可,且只需做这一次:
| 设备 | 操作 |
|---|---|
| Windows 电脑 | 打开页面后按 `Ctrl` + `F5`(或 `Ctrl` + `Shift` + `R` |
| Mac 电脑 | 按 `Command` + `Shift` + `R` |
| 安卓手机 | 浏览器菜单 →「设置」→「隐私」→ 清除缓存,然后重新打开页面 |
| iPhone | Safari:「设置」→「Safari 浏览器」→「清除历史记录与网站数据」;微信内置浏览器请改用 Safari 打开 |
刷新后仍看不到按钮,请按第 10 节反馈,并附上你使用的设备和浏览器。
## 1. 部署前准备
@@ -93,6 +108,7 @@ docker compose down
- 每条记录最多 6 张。可以选择 JPG、PNG、WebP、HEIC 照片,浏览器会统一转成 JPG 或 PNG 再上传;出于安全考虑不接受 SVG、GIF 及任何伪装成图片的文件。
- 图片在浏览器里就会被压缩到最长边 1600 像素再上传,一般每张 200–400 KB,用手机流量提交也不慢。压缩过程顺带**清除了照片中的 GPS 定位等 EXIF 信息**。
- 图片是逐张依次上传的,缩略图右上角的 × 可以移除,失败的会显示原因并提供“重试”。**上传未完成时提交会被拦下**,请等所有缩略图不再显示进度条。
- 单张图片压缩后仍超过 8 MB 会被拒收(正常手机照片远达不到)。若提示“上传超时”,多为现场网络不稳,点“重试”即可,不必重填表单。
- iPhone 若拍出 HEIC 格式且浏览器无法转换,页面会提示到「设置 → 相机 → 格式」选「兼容性最佳」后重拍。
- 上传后未提交的图片属于临时状态,只有上传者本人能看到,2 小时后自动清理。所以**填完表单要及时提交**。
- 图片二进制保存在数据库中,日常数据库备份已经包含图片,不需要单独备份图片目录。
@@ -180,6 +196,7 @@ docker compose up -d web
- 数据库日志:`docker compose logs --tail=200 db`
- 磁盘检查:关注 PostgreSQL 数据卷、`backups/` 和 Docker 日志空间。
- 无法登录:确认账号未停用、系统时间正确、Cookie 未被浏览器禁止。
- 录入页看不到“选择图片”按钮:多为浏览器缓存了旧版页面文件,按第 0 节强制刷新一次即可。若强刷后仍不显示,按 F12 打开控制台查看是否有报错,并确认 `/static/image-upload.js``/static/entry.js` 都返回 200 或 304。
- 保存返回 422:按提示检查必填、数值范围和日期格式。
- 备份失败:确认容器内 `pg_dump` 可用、磁盘空间充足、数据库连接正常。