sapphirexai/bufferpad

简体中文 · English · 文档目录

面向制造现场的缓冲垫寿命追踪与 PLC 联动系统。

BufferPad 通过条码扫描追踪可重复使用的工业缓冲垫，处理重复计数，并向配置的 PLC 通知寿命阈值状态。本仓库包含 Web 前端、Java 后端和 Windows 部署脚本。

项目提供扫码计数、防重复计数、寿命预警、使用记录、运行事件和本地部署。它从三个内部 Git 仓库迁移而来，保留了开发历史；文件清理和历史编号变化见迁移记录。

在一个页面查看产线连接状态、等待扫码提示、使用次数与寿命阈值。设备抽屉进一步区分 TCP 连接、通信验证和超时故障。

查看三张截图与操作流程说明。截图为维护者提供的界面记录，展示数据和设备状态不代表你的部署；公开副本中的现场地址已遮盖。

后端目录沿用历史名称 wms-opc，当前项目不提供通用 OPC UA 服务。真实 PLC 接入前请阅读设备配置说明。

中文与英文文档均已覆盖部署、开发、设备配置和历史验收；点击顶部语言链接切换首页，或进入完整文档目录选择对应主题。各文档顶部也可切换语言。软件界面目前仍为中文。

1. 克隆仓库，阅读快速开始。
2. 自行准备 HslCommunication 3.4.0 的适用授权及 JAR，放到依赖说明指定的位置。
3. 准备数据库和自己的初始管理员密码，按构建与打包构建前后端。
4. 需要 Windows 离线部署时，再准备运行时安装包，生成本地安装目录。

这是源码仓库。 仓库及其公开历史不包含 HSL JAR、第三方安装包、前后端成品、运行日志和 PDF。没有准备 HSL JAR 时，当前后端不能完整编译；安装脚本也需要本地生成应用制品后才能安装。第三方依赖的获取与再分发受各自许可证约束。

子项目中的历史验收、部署记录为工程沿革，已进行现场信息脱敏；其中示例地址与过去的账号策略不用于当前部署。当前配置以本页、快速开始和登录与权限为准。

• 数据库连接使用 BUFFERPAD_DB_URL、BUFFERPAD_DB_USERNAME、BUFFERPAD_DB_PASSWORD。默认地址仅为本机示例，需要先建立数据库并授予账户适当权限。
• 空账户表初始化时，用户名默认 admin，必须通过 BUFFERPAD_ADMIN_PASSWORD 提供自己的密码。已有账户不会被初始化配置覆盖。
• superadmin 维护登录默认关闭。需要时由部署者提供自己的 BUFFERPAD_MAINTENANCE_PASSWORD_HASH；没有通用维护密码。更换哈希并重启后，旧维护会话失效。
• Windows 安装还需要 BUFFERPAD_MYSQL_ROOT_PASSWORD；安装脚本的默认数据库用户名为 root，此时 BUFFERPAD_DB_PASSWORD 必须与其 root 密码一致，也可以按安装说明配置独立应用账户。

前端包含 Jest 单元测试；后端包含业务单元测试、H2 认证集成测试和本地协议回环测试。此次迁移的验证结果记录了检查范围。回环测试不能代替真实设备验收。当前技术栈包含旧版依赖，版本升级应单独验证。

GitHub Actions 自动检查前端测试与构建、脚本语法及仓库文件；后端完整测试需要本地 HSL 依赖。查看 CI 范围和复现命令。

请在 Issue 中描述版本、复现步骤和脱敏日志，不上传数据库备份、实际凭据或现场设备连接信息。贡献流程见 CONTRIBUTING.md，安全问题见 SECURITY.md。

后续方向见维护路线图，公开版本见更新日志和 Releases。维护者的 PR 与发布流程见维护说明。

本项目自有代码采用 MIT License。第三方库、字体和运行时依赖按各自条款使用，见 THIRD_PARTY_NOTICES.md。MIT 许可不授予 HslCommunication 或其他第三方组件的额外使用、下载或再分发权。