使用手册
文件管理系统用于上传、管理各类文档，支持版本更新与在线预览。主要功能包括：
进入文件管理系统后，首先看到的是文件列表页面。
页面顶部显示四个统计卡片：
| 卡片 | 说明 |
|---|---|
| 文件总数 | 当前正常状态的文件数量 |
| 正常文件 | 状态正常的文件数量 |
| 总浏览 | 所有文件的累计浏览次数 |
| 总下载 | 所有文件的累计下载次数 |
工具栏包含以下操作：
| 列名 | 说明 |
|---|---|
| 分类 | 文件所属分类，可点击按该分类筛选 |
| 文件名 | 文件标题 |
| 编号 | 文件唯一编号 |
| 版本 | 当前版本号（如 v1.0、v1.1、v2.0） |
| 状态 | 正常 / 已删除 |
| 更新时间 | 最后更新时间 |
| 操作 | 详情、编辑、升级、删除（回收站中为恢复、彻底删除） |
列表底部提供分页导航，每页显示 20 条记录。
点击工具栏的 新增文件 按钮进入新增页面。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 文件名称 | 必填 | 文件的标题，例如"2025年产品清单" |
| 分类 | 选填 | 从下拉框中选择预设分类 |
| 描述 | 选填 | 文件的简要说明 |
编号支持两种模式：
手动输入
选择"手动输入"后，在编号输入框中填写唯一编号（如 FM-2025-001）。编号不可与已有编号重复，否则会提示"编号已被使用"。
规则生成
选择"规则生成"后，从下拉框中选择一条预设的编号规则，系统将自动生成编号，无需手动输入。
编号规则由管理员在系统设置中配置，详见第七章。
点击上传区域选择文件上传。上传成功后区域变为绿色并显示文件名和大小。
主文件为必填项，支持任意格式。
点击上传区域选择 PDF 文件上传。预览文件用于在详情页在线展示文件内容。
预览文件仅支持 PDF 格式，为选填项。
访问权限分为 允许查看详情 和 允许下载 两项，各自独立设置。
不限制模式
勾选"不限制"复选框时，所有用户均可查看/下载，此为默认设置。
限制模式
取消勾选"不限制"后，展开权限设置区域，可通过标签页切换两种授权方式：
两种方式为"或"的关系——用户只要满足角色或用户任一条件即可访问。
特别说明：文件的创建人和更新人始终拥有查看和下载权限，不受权限设置限制。
填写完成后点击 确认新增 按钮。系统校验通过后文件入库，自动跳转回文件列表。
在文件列表中点击 编辑 按钮，或在文件详情页点击 编辑 按钮，进入编辑页面。
| 字段 | 说明 |
|---|---|
| 文件名称 | 修改文件标题 |
| 描述 | 修改文件描述 |
| 主文件 | 可重新上传替换原文件（不更换则保留原文件） |
| 预览文件 | 可重新上传替换预览文件 |
| 访问权限 | 可修改查看和下载权限设置 |
编号和分类在编辑模式下不可修改。
如需更换主文件或预览文件，点击对应的上传区域重新选择文件即可。原文件将被自动删除。若不需要更换，保持原样即可。
在文件列表中点击 升级 按钮，或在文件详情页点击 版本升级 按钮，进入版本升级页面。
系统采用语义化版本号，格式为 主版本号.次版本号（如 v1.0、v1.1、v2.0）。
页面顶部显示版本变化提示，例如：
升级后，旧版本文件自动归入历史版本，不会丢失。可在文件详情页查看和下载历史版本。
在文件列表中点击 详情 按钮，进入文件详情页。
详情页左侧展示文件的完整信息：
| 信息项 | 说明 |
|---|---|
| 编号 | 文件唯一编号 |
| 版本 | 当前版本号 |
| 分类 | 所属分类 |
| 类型 | 文件扩展名 |
| 浏览 | 累计浏览次数 |
| 下载 | 累计下载次数 |
| 创建人 | 上传该文件的用户 |
| 更新人 | 最后更新该文件的用户 |
| 创建时间 | 文件首次上传时间 |
| 更新时间 | 最后更新时间 |
| 描述 | 文件说明 |
历史版本和已删除文件不显示编辑和升级按钮。
如果上传了 PDF 预览文件，详情页右侧将显示在线预览窗口，可直接在页面内查看文件内容。如未上传预览文件，则显示"暂无预览文件"。
页面底部展示历史版本列表，每条记录包含：
管理员可在后台 文件管理设置 页面进行系统配置。
设置默认的编号规则表达式。当上传文件选择"规则生成"但未匹配到具体规则时，使用此默认规则。
每行输入一个分类名称，例如：
保存后，上传文件时的分类下拉框将显示这些选项。
每行定义一条编号规则，格式为 规则名称|规则表达式，例如：
保存后，上传文件选择"规则生成"时，可从下拉框中选用这些规则。
| 占位符 | 说明 | 示例 |
|---|---|---|
| {i} | 自增序号，默认从1开始，步长1 | FM-{i} → FM-1, FM-2, FM-3 |
| {i:起始,步长,格式} | 自定义自增序号 | {i:001,1,%03d} → 001, 002, 003 |
| {r:位数} | 随机数字 | {r:4} → 3847 |
| {rs:位数} | 随机字母数字 | {rs:6} → a3Kx9m |
| {date} | 当前日期（默认 Y-m-d） | 2025-05-11 |
| {date:格式} | 自定义日期格式 | {date:Ymd} → 20250511 |
| {time} | 时间戳 | 1746960000 |
示例组合：
下载的文件名自动按以下格式命名：
例如：产品清单_v1.1_20250511.xlsx
如果文件设置了下载权限限制，只有被授权的用户才能下载。文件的创建人和更新人不受此限制。
在文件列表中点击 删除 按钮，系统弹出确认提示，确认后文件移入回收站。移入回收站的文件不会真正删除，可随时恢复。
在回收站中点击 恢复 按钮，文件恢复到正常状态，重新出现在文件列表中。
在回收站中点击 彻底删除 按钮，系统弹出二次确认提示（此操作不可恢复），确认后文件及所有历史版本将从系统中永久删除，关联的物理文件也将一并清除。
注意：彻底删除操作不可逆，请谨慎操作。
| 权限 | 控制范围 |
|---|---|
| 允许查看详情 | 控制用户是否可以查看文件详情页 |
| 允许下载 | 控制用户是否可以下载文件 |
两种权限独立设置，互不影响。
| 模式 | 说明 |
|---|---|
| 不限制 | 所有用户均可访问（默认） |
| 按角色 | 仅指定角色的成员可访问 |
| 按用户 | 仅指定的用户可访问 |
按角色和按用户为"或"的关系：用户只要属于被授权的角色，或本身被选中，即可访问。
文件详情页中，权限信息以标签形式展示：
上传的文件统一存储在服务器的 res/upload/filemanager/ 目录下，按年月自动创建子文件夹归类，例如：
版本升级时，旧版本文件保留在原路径，新版本文件存储到当前年月对应的文件夹中。