From 33147faedae3d5c7ddd22adfb49d80e14e00a30a Mon Sep 17 00:00:00 2001
From: obroccolio <jinjunxiang@hnu.edu.cn>
Date: Sun, 26 Jul 2026 22:20:19 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=EF=BC=9A=E6=96=B0=E5=A2=9E?=
 =?UTF-8?q?=E5=90=AF=E7=94=A8=E9=80=9A=E7=9F=A5=EF=BC=8C=E6=93=8D=E4=BD=9C?=
 =?UTF-8?q?=E6=89=8B=E5=86=8C=E8=A1=A5=E5=85=85=E7=BC=93=E5=AD=98=E5=88=B7?=
 =?UTF-8?q?=E6=96=B0=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 docs/启用通知.md | 81 ++++++++++++++++++++++++++++++++++++++++++++++++
 docs/操作手册.md | 19 +++++++++++-
 2 files changed, 99 insertions(+), 1 deletion(-)
 create mode 100644 docs/启用通知.md

diff --git a/docs/启用通知.md b/docs/启用通知.md
new file mode 100644
index 0000000..6c943c8
--- /dev/null
+++ b/docs/启用通知.md
@@ -0,0 +1,81 @@
+# 关于激光材料数据平台正式启用的通知
+
+各位同事：
+
+激光材料实验数据平台已完成部署与测试，即日起正式启用。此前分散在各人 Excel 表格中的实验数据，请统一改为在本平台录入。现将有关事项通知如下。
+
+## 一、访问地址
+
+| 用途 | 地址 | 是否需要登录 |
+|---|---|---|
+| 数据看板（查询、浏览） | `http://<服务器地址>:5980/` | 否 |
+| 快速录入（四位 Key） | `http://<服务器地址>:5980/entry` | 输入四位 Key |
+| 管理后台 | `http://<服务器地址>:5980/login` | 账号密码 |
+
+> 发布前请将 `<服务器地址>` 替换为实际 IP 或域名。手机、平板、电脑均可使用，推荐 Chrome、Edge 或 Safari。
+
+## 二、重要：老用户请先强制刷新一次
+
+**凡是以前访问过本系统旧版本的同事，第一次打开新版页面时请先强制刷新一次。**
+
+浏览器会把旧版页面文件缓存在本地，不刷新会出现「能看到『成品图片』的标题，但下面没有『选择图片』按钮」的情况。这不是故障，刷新一次即可，之后不用再刷。
+
+- **Windows 电脑**：打开页面后按 `Ctrl` + `F5`
+- **Mac 电脑**：按 `Command` + `Shift` + `R`
+- **安卓手机**：浏览器菜单 →「设置」→ 清除缓存后重新打开
+- **iPhone**：「设置」→「Safari 浏览器」→「清除历史记录与网站数据」
+
+从未访问过本系统的同事可跳过这一步，直接使用。
+
+## 三、本次上线的主要功能
+
+1. **公开数据看板**：无需登录即可查询全部实验数据，支持按实验 ID、材料名称、材料大类筛选。
+2. **两种录入方式**：管理后台「手动录入」，或用四位 Key 从手机直接访问 `/entry` 快速录入，适合在实验现场随手记录。
+3. **成品图上传（本次新增）**：每条实验记录最多可上传 6 张成品图。手机和平板上可以**直接调起相机拍照**，也可以从相册选择；电脑上支持把图片拖进上传框。点开数据详情即可查看图片，点击可全屏放大。
+4. **自定义数据字段**：固定的 32 项之外，管理员可按需增加数据种类，历史数据不受影响。
+5. **权限与留痕**：分管理员、数据录入员、只读三种角色；登录、录入、修改、删除均记入审计日志。
+6. **每日自动备份**：数据与图片一并备份。
+
+## 四、录入须知
+
+- **实验 ID 全系统唯一**，建议采用固定规则，例如 `LAS-2026-0001`。
+- 带 `*` 的字段必须填写；百分比填 0–100，评分填 0–10。
+- 提交时需再次输入本人**登录用户名**（不是显示名称）确认，确保数据可追溯到个人。
+- 图片会在手机上自动压缩后再上传，用流量提交也不慢，同时会**自动清除照片中的 GPS 定位信息**。
+- **图片上传完成后请及时提交表单**。上传了但未提交的图片属于临时状态，2 小时后会自动清理。
+- 四位 Key 验证后有效期 30 分钟，超时会提示重新输入，表单内容不会丢失。
+
+## 五、请特别注意：成品图片是公开可见的
+
+**上传的成品图会显示在无需登录的公开看板上，任何能访问该网址的人都能看到。**
+
+拍照时请避开白板、工牌、电脑屏幕、纸质文件等可能含有内部信息的画面，只拍材料成品本身。
+
+如果某批实验的图片属于内部资料不宜公开，请**先不要上传**，并联系管理员调整权限设置。
+
+## 六、账号与权限
+
+- 需要录入数据的同事，请联系管理员开通个人账号，并由本人设置四位录入 Key。
+- **禁止多人共用同一账号**，否则审计日志无法追溯到具体责任人。
+- 首次登录后系统会要求修改初始密码，请设置至少 10 位、同时含字母和数字的密码。
+- 四位 Key 请勿设置为生日、年份或 1234 这类易猜组合，也不要在群里传播。
+
+## 七、使用文档与反馈
+
+详细操作步骤见随本通知一并发出的《激光材料数据平台操作手册》，其中第 4 节为录入流程，第 4.3 节为图片上传说明。
+
+使用中遇到问题，或需要新增数据字段，请联系：
+
+- 系统管理员：__________（姓名 / 联系方式）
+- 反馈时请说明：使用的设备和浏览器、操作步骤、页面提示的原文或截图。
+
+## 八、执行要求
+
+自即日起，新的实验数据请一律在平台录入，不再单独维护个人 Excel 表格。历史数据的迁移安排另行通知。
+
+请各位在 __________ 前完成首次登录并修改初始密码。
+
+特此通知。
+
+__________（部门 / 单位）
+2026 年 7 月 26 日
diff --git a/docs/操作手册.md b/docs/操作手册.md
index c0cfcab..dd2b9c5 100644
--- a/docs/操作手册.md
+++ b/docs/操作手册.md
@@ -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` 可用、磁盘空间充足、数据库连接正常。