feat: 大屏新增虚拟工位滚动栏与多订单轮播,附件表增加删除原因及彻底清除留痕字段

This commit is contained in:
SunYF
2026-10-29 18:16:53 +08:00
parent 4d3c4e2c3a
commit 11dbdaae75
75 changed files with 6801 additions and 965 deletions
+7 -7
View File
@@ -284,7 +284,7 @@ export const helpReturnOrder = {
export const helpZone = {
title: '区域维护(库位四级)',
overview:
'维护库区/库位字典,供入库/半成品/出库等所有页面的"区域"下拉框选择。\n库位按四级结构组织:区域 → 货架 → 层 → 位置号,四个页签各自独立维护、独立分页、按上级筛选。上级字段用下拉选择(不重复录入)。\n\n· 区域:物理库区(如待检、合格 Z02、不合格…),入库时必须指明放到哪个区,质量检验合格后再转移到合格区;\n· 货架:挂在某个区域下;新建货架时会自动创建一个「默认位置」,物料可不细分到层时直接挂这里;\n· 层:挂在某个货架下;\n· 位置号:挂在某个层(或货架默认位置)下。\n\n四级均可维护「名称」与「备注」(需求E);新建默认「启用」。库位不删除、只停用(避免库存/单据追溯断裂);停用后不再出现在入库/出库/盘点的可选库位下拉中,历史数据保留。\n\n列表实时库存(需求E/需求7):每次打开/查询页面实时聚合当前在库量(quantity>0 且 status∈{在库,锁定} 且非半成品),不缓存;区域=全区域合计、货架/层/位置逐级细化。区域行会额外显示「⚠ 未上架 N」徽标(该区域「未分配货架」的库存量);货架页签顶部固定一条灰色「(未分配货架)」虚拟行,汇总该区域未指定具体货架的库存(缺货位为合法状态,不计入具体货架/层/位置号),虚拟行不可编辑。\n\n「未分区」= 按设计不指定区域的库存行(如成品直落区,成品入库本就不录货位),单独汇总展示;与「未上架」口径不同:未上架=有区域无货架(脏数据,已加录入校验拦截新增),未分区=无区域(设计性归类,非缺陷),二者互不重叠。当前保持显示,待成品入库等实际业务明确后再定口径。\n\n列表页禁用关键字混搜,编码与名称各自独立筛选。\n\n位置号支持「批量生成」:选区域+货架+层号(字母或数字均可,层不存在则自动创建),填生成数量,系统从「该层已存在的最大位置号 +1」起连续生成,先预览(标出已存在)再确认写入,已存在的位置自动跳过。',
'维护库区/库位字典,供入库/半成品/出库等所有页面的"区域"下拉框选择。\n库位按四级结构组织:区域 → 货架 → 层 → 位置号,四个页签各自独立维护、独立分页、按上级筛选。上级字段用下拉选择(不重复录入)。\n\n· 区域:物理库区(如待检、合格 Z02、不合格…),入库时必须指明放到哪个区,质量检验合格后再转移到合格区;\n· 货架:挂在某个区域下;新建货架时会自动创建一个「默认位置」,物料可不细分到层时直接挂这里;\n· 层:挂在某个货架下;\n· 位置号:挂在某个层(或货架默认位置)下。\n\n四级均可维护「名称」与「备注」(需求E);新建默认「启用」。库位不删除、只停用(避免库存/单据追溯断裂);停用后不再出现在入库/出库/盘点的可选库位下拉中,历史数据保留。\n\n列表实时库存(需求E/需求7):每次打开/查询页面实时聚合当前在库量(quantity>0 且 status∈{在库,锁定} 且非半成品),不缓存;区域=全区域合计、货架/层/位置逐级细化。区域行会额外显示「⚠ 未上架 N」徽标(该区域「未分配货架」的库存量);货架页签顶部固定一条灰色「(未分配货架)」虚拟行,汇总该区域未指定具体货架的库存(缺货位为合法状态,不计入具体货架/层/位置号),虚拟行不可编辑。\n\n「未分区」= 按设计不指定区域的库存行(如成品直落区,成品入库本就不录货位),单独汇总展示;与「未上架」口径不同:未上架=有区域无货架(脏数据,已加录入校验拦截新增),未分区=无区域(设计性归类,非缺陷),二者互不重叠。当前保持显示,待成品入库等实际业务明确后再定口径。\n\n列表页禁用关键字混搜,编码与名称各自独立筛选。\n\n位置号支持「批量生成」:选区域+货架+层号(层号用下拉选择,只能选该货架下已存在的层;层不存在请先在「层」页签创建,系统不会自动建层),填生成数量,系统从「该层已存在的最大位置号 +1」起连续生成,先预览(标出已存在)再确认写入,已存在的位置自动跳过。',
fields: [
{ name: '区域编码', source: '手工填写,仓库自定义(新增后不可改)。', purpose: '库区唯一编号', fill: '如 Z02、Z05,建议字母+数字,唯一;新增后不可改' },
{ name: '名称(四级)', source: '手工填写(可空)。区域/货架/层/位置四级均可命名。', purpose: '本级中文名称,便于识别', fill: '区域如 合格区/待检区;位置如 A架3层12位' },
@@ -293,7 +293,7 @@ export const helpZone = {
{ name: '位置号', source: '新增位置号时从「区域+货架+层」下拉逐级选(层必选,父级不能为空),再填位置号。', purpose: '库位第四级,最小存放单位', fill: '如 12' },
{ name: '实时库存', source: '系统实时聚合(不缓存)。口径:quantity>0 且 status∈{在库,锁定} 且非半成品。', purpose: '直观看到该区域/货架/层/位置当前在库总量;区域行另显示「⚠ 未上架 N」(未分配货架量)', fill: '只读;区域为全区域合计,逐级向下细化;货架页签顶部「(未分配货架)」虚拟行汇总未指定具体货架的库存' },
{ name: '状态', source: '启用/停用(新建默认启用)。', purpose: '不删除、只停用;停用后不再进入可选库位下拉', fill: '编辑弹窗切换启用/停用' },
{ name: '批量生成', source: '位置号页签「批量生成」按钮。', purpose: '在选定的区域+货架+层下,一次生成一批位置号', fill: '选区域+货架+层号(字母或数字均可,层不存在则自动创建)+ 生成数量 → 预览 → 确认生成;从「该层已存在的最大位置号 +1」起连续生成,只生成位置号、不创建父级层,已存在的自动跳过' },
{ name: '批量生成', source: '位置号页签「批量生成」按钮。', purpose: '在选定的区域+货架+层下,一次生成一批位置号', fill: '选区域+货架+层号(层号下拉选择,必须为已存在的层,不自动创建层)+ 生成数量 → 预览 → 确认生成;从「该层已存在的最大位置号 +1」起连续生成,只生成位置号、不创建父级层,已存在的自动跳过' },
{ name: '备注', source: '手工填写(可空),四级均可。', purpose: '补充描述', fill: '可空' }
]
}
@@ -301,15 +301,15 @@ export const helpZone = {
export const helpAttachment = {
title: '附件中心',
overview:
'统一查看全系统上传的附件(图纸/报告/照片/Excel 等)。附件按「业务类型」挂靠具体单据,磁盘按「年/月/日/文件类型/uuid.ext」分层存储,库内只存相对路径。\n\n本页只读查询 + 下载/删除(不提供在线预览“查看”,统一走下载)。删除为逻辑删除(索引标记),真正的磁盘文件由「已删除附件」抽屉统一物理清理释放。顶部会显示附件磁盘剩余空间告警:低于 20% 提醒、低于 10% 提示立即清理。\n\n删除保护:工艺流程(PROCESS_PDF)、流程卡(PROCESS_CARD) 为关键工艺文件,全程禁删;检验照片/报告(INSPECTION_*) 在质量追溯保留期(本地保留年数)内禁删。\n\n已删除附件(页面右上「已删除附件」按钮,需 attachment:manage 权限):物理清理已标记删除的磁盘文件释放空间(索引保留),每项先「预检」看影响范围、确认后再执行。附件历史数据按时间窗的备份与清理统一在「数据归档」页面完成。',
'统一查看全系统上传的附件(图纸/报告/照片/Excel 等)。附件按「业务类型」挂靠具体单据,磁盘按「年/月/日/文件类型/uuid.ext」分层存储,库内只存相对路径。\n\n本页为纯查阅页:查询、在线预览(图片/PDF 内联)、下载、状态追溯。附件的删除、恢复与磁盘释放统一在「数据归档 → 磁盘空间回收」完成(需 attachment:manage 权限);业务单据附件面板中,上传人本人可「移除」自己误传的附件。\n\n状态三态:正常 / 已删除(文件仍在磁盘、彻底清除前可恢复)/ 已清除(磁盘文件已删除,索引保留可追溯)。已删除/已清除的记录悬浮可看删除人、时间、说明等前因后果;默认隐藏的已删除附件会在筛选时提示条数。\n\n删除保护:工艺流程(PROCESS_PDF)、流程卡(PROCESS_CARD) 为关键工艺文件,全程禁删;检验照片/报告(INSPECTION_*) 在质量追溯保留期(本地保留年数)内禁删;所有清理仅允许处理保护期(默认 180 天,archive.protect.days)之前的数据。',
fields: [
{ name: '文件类型', source: '筛选条件。文件类型目录(大写),决定磁盘存放目录。', purpose: '按附件类别过滤', fill: '工艺流程/检验照片/检验报告/图纸/流程卡/包装照片/Excel导入/其他' },
{ name: '业务类型', source: '筛选条件。附件挂靠的业务对象。', purpose: '只看某类业务的附件', fill: '入库/物料档案/质量检验/半成品/出库' },
{ name: '业务标识', source: '筛选条件。', purpose: '按单号/编码/ID 定位某条业务记录的附件', fill: '如入库单号、物料编码、检验记录 ID' },
{ name: '下载', source: '行末按钮。', purpose: '下载原件(带原文件名)', fill: '本页不提供在线“查看”预览,统一下载后本地打开' },
{ name: '删除', source: '行末按钮(权限 attachment:manage)。', purpose: '逻辑删除附件索引(文件待「已删除附件」抽屉物理清理释放)', fill: '确认后标记已删除;工艺流程/流程卡及保留期内检验记录受保护不可删' },
{ name: '已删除附件', source: '页面右上按钮(权限 attachment:manage),抽屉式物理清理已删附件。', purpose: '释放磁盘空间:物理删除已删文件', fill: '先「预检」(dryRun)看影响数量与释放空间,再「执行」前二次确认;删除的附件仍占用磁盘空间,需彻底删除才释放' },
{ name: '磁盘告警', source: '系统每天早上 7:00 自动检测附件目录剩余空间。', purpose: '提前发现空间不足,避免写入失败', fill: '剩余 <20% 告警、<10% 提示立即清理;本页顶部同步展示' }
{ name: '预览', source: '行末按钮。', purpose: '图片/PDF 浏览器内联打开,其他类型转下载', fill: '已删除/已清除的附件会先弹出前因后果提示,确认后仍可打开' },
{ name: '下载', source: '行末按钮。', purpose: '下载原件(带原文件名)', fill: '已清除(文件已物理删除)的附件不可下载' },
{ name: '状态', source: '列表列。', purpose: '三态:正常/已删除/已清除;悬浮查看删除人、时间、说明等前因后果', fill: '已删除=文件仍在磁盘可恢复;已清除=文件已删,找回依赖备份包(介质可读性由保管人自行核对)' },
{ name: '磁盘告警', source: '系统每天早上 7:00 自动检测附件目录剩余空间。', purpose: '提前发现空间不足,避免写入失败', fill: '剩余 <20% 告警、<10% 提示立即清理;本页顶部同步展示;清理入口在「数据归档 → 磁盘空间回收」' }
]
}