文档:新增启用通知,操作手册补充缓存刷新说明
- 新增 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:
+18
-1
@@ -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` 可用、磁盘空间充足、数据库连接正常。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user