工单追踪系统

部署 · 使用 · 维护指南

一、系统部署

1.1 环境要求

项目要求
操作系统Linux（推荐 Ubuntu 20.04+ / Debian 11+）
Docker20.10+
Docker Compose2.0+
端口1700（HTTP）
浏览器Chrome / Safari / Edge 最新版

1.2 部署步骤

  1. 将交付包 order-tracker.tar.gz 上传到服务器的 /opt 目录
  2. 解压并进入目录： 
    cd /opt
tar -xzf order-tracker.tar.gz
cd order-tracker
  3. 启动容器（SaaS 模式）： 
    sudo docker compose up -d
  4. 等待约 2-3 分钟（首次启动需下载依赖）
  5. 检查运行状态： 
    sudo docker ps --filter "name=order-tracker"
    状态显示 Up 即表示运行正常
  6. 浏览器访问 http://服务器IP:1700
提示：如果服务器有防火墙，请放行 1700 端口。

1.3 买断版激活

  1. 启动后访问页面，系统会自动显示机器码
  2. 将机器码发送给您的软件供应商
  3. 供应商返回一个 .key 授权文件
  4. 将 .key 文件放入 data/ 目录
  5. 重启容器： 
    sudo docker restart order-tracker
  6. 刷新页面，进入登录界面即表示激活成功
注意：升级系统或重建 Docker 服务后，机器码可能会变化，届时需要重新获取授权文件。正常情况下机器码不会频繁变更。

二、系统使用

2.1 初始账号

角色用户名初始密码
超级管理员admin联系供应商获取
请首次登录后立即修改密码！

2.2 角色说明

角色权限
超级管理员创建/管理用户账号、设置到期时间
工厂管理员订单管理、工段管理、员工管理、系统设置
工人扫码操作工段、提交备注

2.3 快速上手

  1. 超级管理员登录后，创建工厂账号并设置到期时间
  2. 工厂管理员登录后：
    • 进入工段管理，设置工段模板（如下料、封边、打孔等）
    • 进入订单管理，创建订单并选择工段
    • 生成订单二维码，张贴到车间
  3. 工人扫码完成工段操作
  4. 客户可通过首页输入订单码查询进度

2.4 功能模块一览

模块功能说明
生产看板实时数据概览、工段积压统计、订单进度
订单管理创建/编辑/删除订单、子单、分支工段、二维码
员工档案管理工人信息、人脸录入（可选）
直播工厂查看车间实时画面
车间配置绑定摄像头视频流地址
系统设置人脸识别开关、语音输入开关、PushDeer通知、修改密码
异常处理工段异常备注确认
操作日志查看所有操作记录

2.5 通知绑定（PushDeer）

  1. 在 iOS/Android 应用商店下载 PushDeer
  2. 打开 App，获取你的 PushDeer Key
  3. 在系统设置中粘贴 Key 并保存
  4. 可同时绑定多个设备（用英文逗号分隔 Key）
  5. 绑定后将收到订单完成、工序超时等推送通知

2.6 人脸识别（可选功能）

在系统设置中开启后：

提示：人脸识别功能需要服务器有摄像头设备，或工人使用手机浏览器扫码操作。

2.7 语音输入（可选功能）

在系统设置中开启后，工段操作页面的备注框会出现麦克风按钮，点击后可直接语音输入备注内容。

2.8 车间视频流配置

  1. 进入车间配置
  2. 填写工段名称（如"封边车间"）
  3. 填写摄像头视频流的完整地址（如 https://your-server.com/webrtc/webrtc.html?src=封边_h264）
  4. 保存后即可在直播工厂和订单进度页查看实时画面

三、系统维护

3.1 常用命令

操作命令
启动容器sudo docker compose up -d
停止容器sudo docker compose down
重启容器sudo docker restart order-tracker
查看状态sudo docker ps --filter "name=order-tracker"
查看日志sudo docker logs order-tracker --tail 50
提示：以上命令需要在项目目录下执行。

3.2 数据备份

系统数据库和授权文件存储在 data/ 目录下。建议定期备份该目录：

# 手动备份
cp -r /opt/order-tracker/data /backup/order-tracker-$(date +%Y%m%d)

# 或使用系统自带 crontab 设置定时备份
0 3 * * * cp -r /opt/order-tracker/data /backup/order-tracker-$(date +\%Y\%m\%d)

3.3 系统升级

  1. 备份 data/ 目录
  2. 用新版本文件覆盖 app.py、common_routes.py 和 templates/
  3. 重启容器： 
    sudo docker restart order-tracker
注意：升级前务必先备份 data 目录，防止数据丢失。

3.4 故障排查

问题排查方法
页面无法访问检查容器状态：sudo docker ps；检查防火墙是否放行1700端口
容器不断重启查看日志：sudo docker logs order-tracker --tail 50
人脸识别不可用确认系统设置中人脸识别开关已开启；确认服务器安装了 face-recognition 依赖
授权失效检查 data/ 目录下是否有 .key 文件；联系供应商重新获取

3.5 修改密码

  1. 登录后进入系统设置
  2. 输入旧密码和新密码
  3. 点击确认修改

3.6 管理用户

  1. 超级管理员登录后可管理所有用户账号
  2. 可设置每个用户的到期时间
  3. 过期账号将无法登录

四、技术支持

如需获取授权文件、系统升级或其他技术支持，请联系您的软件供应商。

Powered by 简 · 工单追踪