文件管理

文件管理是一个独立的文件管理器，围绕台账记录集中存放照片、扫描件、申请表等材料，和"字段里的附件"是两回事——它显示的是真实磁盘目录，没有的东西不会伪装成有。

1. 和"字段级附件"的区别

系统里有两处能传文件，容易混：

2. 权限

文件管理受两个权限点控制，在「角色权限」页给角色勾选：

没有 files:upload 权限时，工具栏的「新建文件夹」「新建文件」「上传文件」按钮和右键菜单里的对应项都不会出现。

3. 文件夹是怎么建出来的

文件库的目录结构不是手工规划的，而是"用到哪个记录就自动建到哪"：

1. 在任意台账的记录详情里点「资料文件夹」，系统会在 files/ 下自动建出 模块名/记录名_记录ID 这样一层目录（模块文件夹在前，记录资料夹在下一级）。
2. 该记录以后每次点「资料文件夹」都会定位到同一个目录，不会重复建。
3. 也可以直接进「文件管理」自己新建文件夹，不依赖某条记录，比如按年份、按专项工作整理材料。

根目录下，一级目录会被识别成"模块文件夹"，显示成带图标的卡片，卡片上标着这个模块下有几个记录资料夹、几个文件；点卡片下方的「打开 ›」能直接跳进第一个记录资料夹。

4. 浏览：网格 / 列表、面包屑、搜索

• 网格 / 列表切换：工具栏右侧的视图开关，选择会记住，下次进来还是上次的模式。
• 面包屑导航：路径面包屑显示当前所在层级，点任意一级可以直接跳回去；根目录叫「文件库」。
• 按文件名搜索：工具栏搜索框输入关键词回车，会递归搜遍整个文件库（不区分大小写），最多返回 200 个结果；结果超过 200 个时会提示"结果太多，请换更具体的关键词"。搜索结果里点「所在位置」能跳到那个文件所在的文件夹。
• 刷新：工具栏「刷新」按钮重新拉取当前目录。

5. 新建文件夹 / 新建文件

1. 新建文件夹：工具栏「新建文件夹」或空白处右键，输入名称即可。
2. 新建文件：工具栏「新建文件」下拉，可选「Word 文档（.docx）」「Excel 表格（.xlsx）」「文本文件（.txt）」，输入名称（不用带后缀）就会生成一个空白文件，之后双击打开编辑。

6. 上传文件

1. 点「上传文件」选择本机文件，支持一次选多个。
2. 或者直接把文件拖进浏览区：松开鼠标会弹"松开鼠标，上传到「当前文件夹」"提示；拖入的可以是整个文件夹（会连同子目录结构一起建出来），也可以是多个文件混拖，一次最多 500 个。
3. 撞到同名文件会弹出确认框问"是否覆盖"，点「覆盖」才会替换，否则跳过这一个继续传其他的。

上传没有系统层面写死的单文件大小上限（受服务器整体 512MB 请求体上限约束，日常照片、Word、Excel、PDF 都远用不到）；如果是用「手机扫码上传」传，单个文件不能超过 100MB（见下文）。

7. 打开、预览与下载

• 图片（jpg/jpeg/png/gif/bmp/webp）：网格视图直接显示缩略图；双击或单击图标会在应用内打开可缩放、可左右翻页的图片查看器，不会跳出系统看图软件。
• 在装有本系统的这台电脑上：双击 Word/Excel/PDF 等其他文件会调用本机默认关联程序打开，编辑保存后文件管理里看到的就是最新版。
• 在局域网的其他电脑上访问（非安装本系统的主机）：双击文件会直接下载到本机，改完需要重新上传覆盖。
• 下载：列表视图或右键菜单里的「下载」按钮，直接存到浏览器默认下载目录。

8. 重命名与删除

都在列表视图操作列或右键菜单里：

• 重命名：需要 files:upload 权限，弹框输入新名称，同样受第 5 节的命名规则约束。
• 删除：需要 files:delete 权限，会弹二次确认；删文件夹会把里面全部内容一起删掉，且无法恢复（文件管理没有回收站，这点和记录数据的删除不同，操作前务必确认）。

9. 手机扫码上传

不想先把照片传到电脑再转存，可以直接生成一个二维码让手机扫码上传：

1. 在记录详情的「资料」弹窗里点「手机上传」（需要 files:upload 权限），会显示一个二维码。
2. 手机连上同一个 WiFi，扫码打开网页，直接拍照或选文件上传，不用装 App。
3. 手机传完后，电脑这边的资料弹窗每 4 秒自动刷新，不用手动点刷新就能看到新文件。

手机连拍多张同名照片（如都叫 image.jpg）不会互相覆盖，系统会自动改成"文件名 (2).jpg"这样的编号。上传链接不需要登录，token 本身就是凭证，重启程序后所有链接会失效，需要重新生成。

10. 数据安全提醒

文件管理没有单独的回收站，删除即永久丢失。备份时请确认备份恢复覆盖了数据目录下的 files/ 文件夹，不要只备份数据库；卸载软件前也建议把这个目录整个复制出来保存。