← 返回：系统设计说明书

KB 车间图纸看板 · 操作指南（详细版）

面向「实际动手操作」的逐步指引 · 与《系统设计说明书》配套使用 · 默认账号 admin / admin123

📑 操作目录（点击直达）

1. 登录与系统初始化 2. 工位组管理 3. 用户与权限 4. 客户管理 5. 生产计划全流程 6. 审批台 7. 图纸库与发布管理 8. BOM 清单核查 9. 字典管理（自定义字段） 10. 通知配置 11. 车间终端看板 12. 部署与编译红线

① 登录与系统初始化

目标：首次启动后完成管理员改密、基础参数确认，确保后续流程能跑通。

入口：浏览器访问站点根路径 → 登录页（login.html）→ 输入账号密码 → 进入管理端（index.html）。
  1. 用 admin / admin123 登录。登录后右上角显示账号名与「注销」入口。
  2. 进入左侧「系统管理 → 系统设置（settings）」，第一件事：修改 admin 密码（首次登录强制建议改密）。
  3. 在设置中确认 / 调整以下开关：
    • 审批总开关 requiresApproval：true=图纸需审批才生效；false=上传即发布。按你公司流程选择。
    • 系统名称 / 默认工位组 defaultGroupId：默认下发岗位的兜底分组。
    • 水印 watermarkEnabled / watermarkText：车间全屏动态水印（防截图泄密），建议开启。
    • 轮询间隔 pollIntervalSec：车间终端拉取数据的间隔，默认 5 秒。
  4. 确认无误后，进入下一步的用户与工位组搭建。
〔截图占位〕系统设置页：密码修改表单 + 开关项 + 保存按钮（位于页面右上角）

💡 建议：JWT 签名密钥已在首次启动时随机生成并入库，改密码后旧 token 会自动失效，需重新登录。

② 工位组管理

工位组是「图纸可见范围」的核心分组（如 机加一组、装配一线）。只有把图纸 / 计划绑定到工位组，车间工位才能在终端看到。

入口：左侧「基础数据 → 工位组（groups）」
  1. 点击「新建工位组」，填写唯一名称（如 机加一组），保存。
  2. 在「工位」子表中为该组添加具体工位（工位名建议带产线/设备编号，便于识别）。
  3. 如需调整，可直接改名；若不再使用，可删除（注意：被图纸/计划引用的组删除前需先解绑）。
〔截图占位〕工位组列表：分组名 + 组内工位数；右侧「新建 / 编辑 / 删除」操作列

⚠️ 工位组名称是 唯一键。新建计划或上传图纸时选择的「下发工位组」必须已存在，否则无法绑定。

③ 用户与权限

四类角色共用一张用户表，靠 role 区分；工位账号额外绑定 station_id。

入口：左侧「系统管理 → 用户（users）」
角色用途绑定要求
admin全权限无
engineer建计划、传图、导入 BOM无
approver审批 / 回收图纸无
station车间看板必须绑定工位
  1. 点「新建用户」，填用户名、密码、选择角色。
  2. 若角色为 station，在表单中指定其所属工位（否则登录后看不到任何图纸）。
  3. 列表支持批量选择与删除；账号状态可启用/停用。
〔截图占位〕用户列表：表格含 角色标签 / 绑定工位 / 状态 / 操作（编辑·删除）；右上「新建用户」按钮

⚠️ 车间工位账号务必绑对工位，否则会出现「终端登录后一片空白」的假象。

④ 客户管理（含 XLSX 模板）

客户主数据支撑生产计划的「客户」字段。支持按模板批量导入 / 导出。

入口：左侧「基础数据 → 客户管理（customers）」
  1. 单条新增：点「新建客户」，填写 客户编码、名称、联系人、电话、地址，保存。
  2. 批量导入：点「下载模板」获取带表头与示例行的 xlsx（?template=1 返回模板）；填好后「导入」上传即可。
  3. 批量导出：勾选若干行 →「导出」按当前选择导出 xlsx；全不选则导出全部。
  4. 列表支持搜索与多选删除。
〔截图占位〕客户列表：操作列含「导入 / 导出模板 / 导出选中」；勾选框在每行首列

💡 模板文件已内置示例数据与填写说明单元格，照着改即可，避免表头错位导致导入失败。

⑤ 生产计划全流程（核心）

「计划」是串联 图纸 / BOM / 工单 的主线。本模块覆盖创建、编辑、删除、导入 BOM、上传图纸、发布、开工、关闭。

入口：左侧「生产管理 → 生产计划（plans）」

5.1 新建计划

  1. 点「新建计划」（页面右上带 id 的按钮），填写：
    • 计划单号（系统可自动生成，也可手填）
    • 客户：从客户管理选择（必填，已修复为可检索）
    • 产品型号 product_model
    • 优先级 priority：下拉来自字典，可自定义（见第 9 节）
    • 主下发工位组 group_id：图纸默认下发到该组
    • 备注（可选）
  2. 保存后状态为「草稿」。
〔截图占位〕新建/编辑计划弹窗：表单字段如上；保存按钮在右下

5.2 导入 BOM

  1. 在计划详情页，点「导入 BOM」，上传 xlsx（支持树状层级：order_no / parent_id / level / material_code / drawing_no / version）。
  2. 系统按图号匹配已上传图纸，标记 match_status（匹配 / 缺图 / 版本不一致）。
  3. 若导入后图纸有变动，点「重新匹配 BOM」按钮实时重算（已修复：不再用导入时刻快照，避免漏报）。

5.3 上传图纸

  1. 在计划内「批量传图」，文件名建议按 图号_版本.扩展名（如 ABC-001_V1.0.pdf），系统自动解析图号与版本。
  2. 未匹配到计划 BOM 的图纸按「审批总开关」决定：开审批→进待审批；关审批→直接发布。

5.4 发布 / 编辑 / 删除

  1. 发布：草稿 / 已发布均可编辑改字段；点「发布」后按每条图纸自动生成工单（pending）。
  2. 若开启审批：发布时图纸保持「待审批」，需在审批台放行后才对车间生效（已修复的 P1 后门）。
  3. 编辑：草稿或已发布状态可改；操作列「编辑」打开与新建同款表单。
  4. 删除：仅「草稿且无工单」可删（已修复 P1），删除会级联清理计划 BOM、解绑图纸。
  5. 全部工单完工后，计划自动标记「已完成」；可手动「关闭」。
〔截图占位〕计划详情页：顶部进度概览（BOM 覆盖率 / 缺图 / 版本不一致 / 工单完成率）+ 重新匹配 BOM 按钮 + 操作列（编辑·删除）

⚠️ 已修复逻辑：① 发布不再绕过审批总开关；② 计划可编辑/删除；③ BOM 实时重算。发布前务必先「重新匹配 BOM」确认覆盖率。

⑥ 审批台

当「审批总开关」开启时，上传的图纸进入待审批。审批员在此逐条放行或退回。

入口：左侧「生产管理 → 审批台（approve）」
  1. 列表展示所有 pending 图纸（图号 / 版本 / 提交人 / 关联计划）。
  2. 「通过」：图纸状态变 approved，自动下发到主工位组，车间可见。
  3. 「退回」：填写退回理由，图纸回到草稿/待处理，由工程师修正后重新提交。
  4. 「回收」已发布图纸（含重新发布）：选择回收原因（见字典 9.3），旧图停用，新版本顶上时旧版本自动归档。
〔截图占位〕审批台：待审列表 + 通过/退回/回收 操作；回收时弹出原因选择

⑦ 图纸库与发布管理

图纸库是全量图纸仓库；发布管理聚焦「已发布 / 待发布」视角。

入口：左侧「生产管理 → 图纸库（lib）/ 发布管理（publish）」
  1. 支持搜索（图号 / 版本 / 状态）、分页、批量上传。
  2. 「批量上传」：支持多文件，文件名按正则自动解析图号_版本；未匹配计划的按审批开关处理。
  3. 「回收」：选择回收原因，停用该版本并通知相关工位（红色紧急遮罩）。
  4. 「重新发布」：被回收图纸可在审批台/详情恢复。
〔截图占位〕图纸库：搜索栏 + 多选 + 批量上传按钮 + 状态标签（待审批/已发布/已回收/归档）

💡 「发布管理」与「图纸库」共用底层数据，区别在视图维度：前者看「下发节奏」，后者看「图纸资产」。

⑧ BOM 清单核查

用于核对「计划需要的图」与「实际传的图」是否一致。

入口：左侧「生产管理 → BOM 清单（bom）」
  1. 按计划查看 BOM 明细树（层级缩进）。
  2. 缺图（图号无对应图纸）标红；版本不一致（BOM 版本 ≠ 已发布版本）标橙。
  3. 点击「重新匹配」可在列表层或计划详情层重算，确保状态实时准确。
〔截图占位〕BOM 清单：树状层级 + match_status 颜色标记（红=缺图 / 橙=版本不一致）

⑨ 字典管理（自定义字段）

所有「可选内容」都来自字典，支持自定义改名、禁用，不再写死。

入口：左侧「基础数据 → 字典管理（dict）」
  1. 优先级 priority：如 紧急/高/中/低，可改名、调顺序、禁用无效项。
  2. 发布状态 / 计划状态：系统与业务共用，改动需谨慎，建议只改名不删。
  3. 回收原因 recall_reason：已预置 6 条（工艺变更、尺寸错误、客户取消、设计更新、替代料、其他）；可增删改。
  4. 每条字典含 category / label / value / color / enabled，颜色用于前端标签展示。
〔截图占位〕字典管理：按 category 分组，每行 label + 颜色块 + 启用开关 + 编辑/删除

⚠️ 回收原因若被图纸引用，删除前先确认无在用记录；建议「禁用」而非「删除」。

⑩ 通知配置

支持企业微信 / 钉钉 / 飞书 webhook 推送（如回收、发布等关键事件）。

入口：左侧「系统管理 → 通知（notify）」
  1. 选择类型（wecom / dingtalk / feishu），填入 webhook 与 secret。
  2. 保存后系统按模板推送；测试失败请检查外网可达性与机器人权限。
〔截图占位〕通知配置：类型切换 + webhook 输入框 + 保存按钮

⑪ 车间终端看板

车间工位用浏览器打开独立页面，只看得到本工位图纸，管理端入口默认隐藏。

入口：浏览器访问 /station.html（工位账号自动进入绑定工位）
  1. 工位账号登录后，左侧列出「本工位可见图纸」，点击右侧预览（版本锁定为生效版，带动态水印）。
  2. 图纸被回收时，页面弹红色紧急遮罩「停加工」，恢复后自动消失。
  3. 可对图纸点「接受 / 完成」反馈进度（写回 TaskAccept）。
  4. 管理端入口被隐藏：在「工位名」上 5 秒内连点 5 次才会短暂出现（5 秒后隐藏），防误操作。
〔截图占位〕车间终端：左列表 + 右预览（带水印）+ 紧急遮罩示例

💡 终端无需账号密码暴露给工人，由管理员发放专属工位账号即可。

⑫ 部署与编译红线

运行（Windows）

  1. 以管理员 PowerShell 运行 service-install.ps1 注册开机自启任务（SYSTEM 账户，崩溃自动重启）。
  2. 启动：Start-ScheduledTask -TaskName KB-DrawingBoard，监听 127.0.0.1:8080。
  3. 前置反代（Caddy / IIS / nginx）对外暴露，防火墙放行 8080 / 443。

重新编译（重要红线）

  1. 修改前端后只需重编译：进入 C:\kb\kb，执行 go build -p 2（限核心数）。
  2. 必须后台 / 低优先级执行，避免打满内存导致整机卡死——已封装 build-safe.bat。
  3. 编译产物 kb.exe 拷到 C:\kb\kb-deploy-windows 替换，前端已嵌入无需单独部署。

备份与迁移

  1. 全部状态在 -data 目录（kb.db + uploads/）。
  2. 停服后 Compress-Archive -Path "C:\kb\data" -DestinationPath kb-backup.zip。
  3. 恢复：解压回数据目录，无需改配置。
⚠️ 严禁 go build 全核编译；本机内存有限，曾因全核编译导致整机卡死。始终走 build-safe.bat。

操作指南与《KB 车间图纸看板 · 系统设计说明书》配套 · 项目位于 C:\kb\kb · 部署于 C:\kb\kb-deploy-windows