SunYF/bj_power
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update and refine project requirement documents

Browse Source 
1. 整理并更新工位终端、工艺流程、用户权限等多模块的需求文档
2. 移除冗余的内置账号相关旧需求，补充统一用户源、工艺步骤自定义等新需求细节
3. 优化文档结构，合并重复内容，修正英文状态词使用问题
4. 补充操作流程、PDF挂载、流程卡打印等业务场景的详细设计方案
This commit is contained in:
SunYF
2026-08-31 09:13:23 +08:00
parent 4ec6784629
commit a3145a8bd6
4 changed files with 487 additions and 446 deletions
Download Patch File Download Diff File Expand all files Collapse all files
问题记录.md
+19 -445
View File
@@ -1,464 +1,38 @@
一、
mes --- > 工艺流程----> 工位管理 ， 1、状态不要用 ENABLED 等英文。2、一个工位只能 有一个 启用的 工艺流程。 这个启用，分两个维度，1、工艺流程是否启动，第二工位管理有没有启用这个工艺流程。我建议简单化，把第二个去掉。所以逻辑就成了，一个工位只能绑定一个工艺流程即可。
另外，工艺流程里面 也有英文 ACTIVE ，请改成中文
另外，工位管理，改为关联工位。因为工位数量是不变的
另外，请考虑，工艺流程、工序，叫法是否合适，如果合适，就保持不变即可。
一、工位终端，问题：
1、北京动力 · 工位终端 ？ 这个标题很潦草，不允许出现 公司名称，而且，北京动力是你瞎写的
2、内置账号：admin / admin123 operator1 / 123456 ，这个写法也很多余。内置管理员即可。和mes一样统一登录 密码 admin 123456 ，如果是纯数字 并且提示更改密码，不更改也可以继续登录。 密码填写要求都和mes一样。
3、MES 服务不可达：MES GET http://127.0.0.1:8888/api/internal/station/task?dockCode=DOCK01 返回 404：not found
4、拧紧结果（实时） ，不需要，1、不需要如此模拟。2、实际应用时也不是这样展示的。工位，先选择的工单，工单有工序步骤（客户维护的），步骤里面有要采集哪些参数，拧紧枪只是其中一项，也可以手动填写。
5、拧紧枪，是否ng 什么标准？，数据也是可 编辑
6、工位不要展示 英文：dock1 ，我以前跟你提过这个问题
7、客户明确表示，希望在这个地方展示操作流程，就是一个PDF一样的说明。来源，是跟着什么走呢？ 我记得：一个工位可以有 几个工艺？一个工艺有多道工艺步骤 ，每个步骤有 标准 参考 数字，判断是否ng。你好好捋捋。
8、待同步xxx条，应该是指 未点击报工，本地sqlite存的数据表。不用在这里显示。并且上报维度是 工序，你写这么多条，怎么对应工序，有病吗，
9、参考，录音通话。看看他想如何展示
二、工艺流程 ---> 编辑工艺流程
1、采集方式：在帮助文档里面，给一个详细说明
2、考核标准：在帮助文档里面，给一个详细说明，在什么地方用，如何收集数据等。
3、菜单，工艺参数 ，和，工艺流程 里面的 步骤模版，重复了。我理解对吗，我建议，去除 工艺参数。 并提出建议：编辑工艺流程--》步骤模板---》考核标准 ，点击多个考核标准时，都出现在下面，不好，不知道哪个是哪个，也没有一个单独的保存按钮。你再设计设计。
4、工位绑定，倒是可以从工艺流程里面，拿出来，将来好分配菜单权限。
三、我现在仍然不知道如何操作。原因：1、问号帮助文档，内容还是不够详细。2、缺少：操作手册.md
问题回答补充： 包含，我跟其他ai的一些聊天，请斟酌对错，告知我你的 答案，经我同意，再执行：
1、admin也不保留，工位终端，不维护数据，他的用户体系来源于 mes ，mes新建用户时，增加是否可以登录工位终端？ 还是在mes的用户体系单独开一个 mes操作员 的 维护 tab。单独建账号，分配密码。工位终端可以改自己的密码。
2、pdf挂哪里？ 挂工位上面吧。和工单等实际产品解耦。mes维护工位信息。刚才提到的问题1，在这里也有了答案，每个工人可以登录的工位是不一样的，不是谁都能操作工位1 ，所以，mes维护工位时，可以在已有用户体系选择 某用户可以操作此工位，多选。 引申出另一个问题，如果某用户没有任何mes菜单权限，显示什么，你要给我方案。并且告诉我，你做菜单权限没有，是不是精确到按钮权限，我们讨论过这个问题。
3、你的理解，不对。我反复说，不仅仅有拧紧枪，还有其他步骤，具体有什么，是mes管理后台自定义的。 自定义的工艺流程、工艺步骤，工艺流程包含多个步骤，工艺流程 有个pdf说明，一个工位当前只能绑定一个工艺流程。一个工艺流程可以绑定多个工位。明白没
四、PLC工序下发，我们聊过，菜单，做什么用的，我仍然没明白。帮助文档里面，也没有业务说明。你再捋捋，弄清楚些
下面是ai给我的建议，仅参考，他没你知道的多呢：
五、帮助按钮，太大了。放到右上角，是不是更好？ 右上角优化，点击 登录人名称 例如“系统管理员”，修改密码，即可。修改密码，按钮，不要了。 帮助文档 点击标题 弹出来（不是左边菜单，是右边大模块左上角的标题，例如 工单管理）
一、工位终端用户体系
1. 统一用户源
MES是唯一用户源。工位终端不建独立用户表
MES用户表新增两个字段：
五、工单管理---> 维护工序组合123456789101112 ，这也太潦草了。 如何区分 11 还是 11 。要求，1、必须按顺序执行，比如，可以是123不能是 132，传送带不会往回走。要求2，可以选择 启动或未启动的 工序，如果工序禁用，这个工位就不走。 另外说明，当 操作 一个工艺流程，让他变成 停用时，必须先跟工位解绑。 同理，工位绑定 工艺流程，必须是 启用的。
另外，工艺流程 菜单，里面的 操作列，加上 按钮 “启用”“停用”。同理，同操作习惯 工单管理也加上 状态操作，在操作里面
can_login_workstation：布尔值，表示该用户能否登录工位终端
workstation_password：工位终端专用密码，用于登录D项目时验证
六、菜单：工单管理，里面有个 日排产 。和 菜单： 日排产，重复了，菜单责任划分不明确。应该去除 前者。
2. 工位操作员管理
MES后台新增「工位操作员管理」功能：
七、添加物料清单，跟 wms什么关系，帮助也没说清楚。 编码如何对应。等等 。
操作方式，非常错误。 选择：产品编码， 点击 添加物料 。列表，又没有 产品编码 。非常反人类。禁止这种 标题选择添加，有病吗，你的设计。添加物料清单，就好好添加，在选择框里面选择 产品编码。 你有病吗
备料单---》按日排产生成备料， 不明不白，你有病吗。是互联网操作方式吗。
从已有用户列表中选择用户
勾选“允许登录工位终端”开关
分配可操作的工位（多选，从1~12号工位中选择）
工位终端登录后可以修改自己的密码（仅改 workstation_password，不改 MES 主密码）
3. 工位终端登录逻辑
用户输入工号 + 工位终端密码，请求 MES 验证
MES 验证内容：
用户存在
can_login_workstation = true
密码正确
该用户至少被分配了一个工位
验证通过后返回：用户可操作的工位列表 + 对应工位的当前工艺流程信息
如用户未被分配任何工位，提示“您未被授权操作任何工位，请联系管理员”
二、用户无 MES 菜单权限时的显示
如用户没有任何 MES 后台菜单权限，登录 MES 网页时不显示空白页
重定向到「工位操作员工作台」页面，包含：
当前可操作工位列表及状态
当前工单信息
操作记录查询（仅限本人）
修改个人信息/密码
三、权限体系
1. 权限粒度
菜单级 + 按钮级，精确到按钮
每个按钮对应一个权限码（如 workorder:delete、material:edit）
前端根据用户权限码控制按钮显示/隐藏
后端每个接口校验当前用户是否具有该操作权限
2. 操作日志
所有关键操作记录完整日志
日志必含字段：
操作人ID和姓名
操作时间
操作类型（新增/修改/删除/提交/审核等）
操作对象（工单号、物料编码、SN码等）
操作前后数据变化（如有）
操作结果（成功/失败及失败原因）
日志中必须包含 workOrderNo、operator 字段
四、PDF 与工艺流程
1. PDF 归属
PDF（作业指导书）挂载在工艺流程上，不直接挂工位或工单
每个工艺流程有一个 PDF 文件
工位绑定的是工艺流程（PDF 跟着工艺流程走）
工位 D 启动时，根据当前绑定的工艺流程，预缓存其 PDF 到本地
登录后替换成 PDF，不每次请求 MES
2. 工位与工艺流程关系
一个工位当前只能绑定一个工艺流程
一个工艺流程可以绑定多个工位
工位今天绑了流程 A，所有经过该工位的工件都按 A 的步骤加工
明天换成流程 B，就按 B 加工
3. 工艺流程自定义
MES 后台自定义工艺流程
工艺流程包含多个工艺步骤
工艺步骤不仅限于拧紧枪，管理员可自定义：
步骤类型 示例 数据采集方式
拧紧 拧螺丝A，目标扭矩 2.5Nm 拧紧枪自动采集
手动检查 外观检查 工人手动打勾
测量 测量尺寸，公差 ±0.1 工人手工输入数值
装配 安装主板 人工操作，扫码确认
测试 通电测试，电压 5V 测试设备采集或手动输入
4. 工艺步骤与考核数据模型
text
工艺流程 (Process Flow)
↓ 包含
工艺步骤 (Step) — 顺序号、操作描述、采集方式
↓ 包含
考核标准 (Standard) — 参数名、单位、上限、下限
↓ 对应
考核数据 (Data) — 实际值、是否合格、采集方式（手动/设备）
每个步骤可配置多个考核标准
工人操作时按步骤顺序执行，每步完成后点击「完成本步骤」进入下一步
五、工人工作量统计
1. 工人端 — 工位终端「我的工作量」
登录工位终端后可查看
展示内容：
总完工工件数（按时间范围统计）
总工作天数
平均日产量
整体合格率（合格数/总完工数）
明细列表：日期、操作工位、完工工件SN、产品型号、合格/不合格、不合格原因
时间筛选：今日/本周/本月/近3个月/近1年/自定义起始日期
合格率趋势图（按日/按周）
导出 Excel/CSV
工人仅能看到本人数据，接口校验当前登录用户 ID
2. 管理端 — MES 后台「工人绩效报表」
权限：仅具备该菜单权限的用户可访问
筛选条件：时间范围、工位、工人、产品型号
汇总统计表：
工号 姓名 总完工数 合格数 不合格数 合格率 操作工位 操作
001 张三 245 240 5 97.96% 工位1、3 查看明细
支持按任意列排序，支持分页
点击「查看明细」弹窗显示：
完整历史记录（同工人端明细列表）
各工位分布统计（工位1干了多少件、工位2干了多少件等）
汇总图表：
各工人合格率对比柱状图
各工位产量分布图
每日产量趋势图（可切换查看不同工人的趋势）
导出 Excel/CSV
六、数据库变更
MES 用户表新增字段：
sql
ALTER TABLE users ADD COLUMN can_login_workstation BOOLEAN DEFAULT FALSE;
ALTER TABLE users ADD COLUMN workstation_password VARCHAR(128);
用户-工位关联表（多对多）：
sql
CREATE TABLE user_workstations (
id BIGSERIAL PRIMARY KEY,
user_id BIGINT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
workstation_id INT NOT NULL, -- 1~12
created_at TIMESTAMP DEFAULT NOW(),
UNIQUE(user_id, workstation_id)
);
权限码表（种子数据）：
sql
CREATE TABLE permissions (
id BIGSERIAL PRIMARY KEY,
code VARCHAR(64) UNIQUE NOT NULL, -- workorder:delete, material:edit, 等
name VARCHAR(128) NOT NULL, -- 显示名称
category VARCHAR(64), -- 所属模块
created_at TIMESTAMP DEFAULT NOW()
);
用户-权限关联表（按钮级）：
sql
CREATE TABLE user_permissions (
id BIGSERIAL PRIMARY KEY,
user_id BIGINT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
permission_code VARCHAR(64) NOT NULL REFERENCES permissions(code) ON DELETE CASCADE,
created_at TIMESTAMP DEFAULT NOW(),
UNIQUE(user_id, permission_code)
);
工人工作量统计相关查询涉及的现有表：
work_order（工单）
scan_record（扫码报工记录）
torque_result（拧紧数据）
process_log（工序流转记录）
七、接口设计
工位终端登录验证：
text
POST /api/internal/workstation/login
请求：{ "username": "xxx", "password": "xxx" }
返回：{
"success": true,
"workstations": [1, 3, 5], -- 可操作的工位列表
"user_info": { "id": 1, "name": "张三" },
"station_configs": { -- 各工位当前绑定的工艺流程
"1": { "process_flow_id": 10, "name": "装配流程A", "pdf_url": "..." },
"3": { "process_flow_id": 12, "name": "测试流程B", "pdf_url": "..." }
}
}
工位终端修改密码：
text
POST /api/internal/workstation/change-password
请求：{ "old_password": "xxx", "new_password": "xxx" }
工人端 — 我的工作量：
text
GET /api/internal/workstation/my-workload
请求参数：start_date, end_date（默认近30天）
返回：{ total_qty, qualified_qty, unqualified_qty, pass_rate,
details: [{ date, workstation_id, sn, product_code, result, reason }],
chart_data: { dates: [], rates: [] } }
管理端 — 工人绩效报表：
text
GET /api/internal/report/worker-performance
请求参数：start_date, end_date, workstation_id(可选), worker_id(可选), product_code(可选), page, page_size
返回：{ list: [{ worker_id, name, total, qualified, unqualified, pass_rate, workstations }],
total, page, page_size }
管理端 — 工人明细下钻：
text
GET /api/internal/report/worker-performance/detail
请求参数：worker_id, start_date, end_date
返回：{ details: [...], station_distribution: { "1": 80, "3": 45 } }
另外一件事，录音里面说： 希望有个可以打印的东西，上面有工位工人 签名的地方。这个涉及到两个事：
1、mes用户体系，需要有一个用户签名的照片？png？ 你看看如何设计，将来可以融合到文档里面一起打印。文档是个pdf？
2、这个文档，什么维度？工人一天的工作量？ 一个成品工件 多个工人的签名？ 看看录音如何说吧。我理解是一个成品的质量追踪，也就是 工件多人签名。上面可能显示 ，开始时间、结束时间、工件名称，工艺步骤、合格率、各个工人签名、或者线长（拿pad的那个审核人）的签名。 这个文档自动生产的，但是生成前，可以手动维护 开始时间、结束时间、合格率、等，默认有签名人，也可以手动选择。没问题了，生成pdf。
数据来源就必须要去 每步工作流程都记录清楚了，每个精密件步骤都能追踪到。
其他ai答：
好，我直接按录音和常规质量追溯实践，给你落地方案：
---
## 一、签名怎么存？
**不用图片，用“账号名 + 确认时间”即可。**
录音里工人已经说了：“不一定非得签字，就是他能追到这个人是他们这一天干了这个活。”所以不需要让用户上传签名照片（PNG），那是自找麻烦——每个工人还得专门拍一张、上传、维护，工厂里根本推行不动。
**方案：用账号名作为签名字段。**
打印时显示：
```
操作人：张三（工号：1001） 确认时间：2026-08-29 14:32:15
检验人：李四（工号：1002） 确认时间：2026-08-29 14:35:22
```
如果甲方坚持要“手写签名效果”，可以加一个“电子签名图片”字段，让用户上传一次（可选），有则显示图片，无则显示账号名。但默认用账号名。
**扩展：**
- 在用户管理中添加`signature_image`字段（可选，存储图片URL），供将来扩展用
- 如果用户上传了签名图片，打印PDF时使用图片；否则使用账号名（文本）
## 二、文档按什么维度生成？
**录音原文：**
> “流程卡呢记录了工序一、工序二，就是所有工序……工序一最终谁干的，然后谁签的字，以及谁检验的。”
**所以维度是：一个成品工件（SN）的质量追溯。** 一个工件经过多个工位，每个工位有操作人、检验人、时间、合格率。文档汇总了这些信息。
**不是“工人一天干了多少活”（那是工作量报表，不是这个），而是“这个工件由哪些人经手完成的”。**
## 三、文档里要包含哪些内容？
| 区域 | 内容 |
|------|------|
| **头信息** | 工件SN、产品型号、产品名称、工单号、开始时间、结束时间、总合格率 |
| **工序追溯明细** | 工序序号、工序名称、工位号、操作人、检验人、各步骤合格状态、完成时间 |
| **考核数据摘要** | 该工件各考核项的实际值/判定（拧紧扭矩、测量值等） |
| **签名区** | 各工位操作人签名、检验人签名、最终审核人签名（账号名） |
| **生成信息** | PDF生成时间、打印人 |
## 四、生成前人工维护什么？
用户说得对：“生成前可以手动维护开始时间、结束时间、合格率等，默认有签名人，也可以手动选择。”
**所以流程是：**
1. 用户在MES后台选择“生成流程卡”
2. 输入/选择工件SN或工单号
3. 系统自动带出所有工序记录（默认值）
4. 用户可手动调整：
- 开始时间、结束时间
- 合格率（如果系统数据有误，人工修正）
- 签名人（默认是实际操作人/检验人，可手动换成别人）
5. 点击“生成PDF” → 系统根据当前数据生成PDF文件
6. 可下载/打印
## 五、表结构变更
```sql
-- 用户表增加签名图片字段（可选扩展）
ALTER TABLE users ADD COLUMN signature_image VARCHAR(256);
-- 流程卡生成记录表（存储每次生成的快照，防止事后修改导致追溯失效）
CREATE TABLE process_card (
id BIGSERIAL PRIMARY KEY,
card_no VARCHAR(64) UNIQUE NOT NULL, -- 流程卡编号
work_order_no VARCHAR(64) NOT NULL, -- 关联工单
product_code VARCHAR(64) NOT NULL, -- 产品编码
serial_no VARCHAR(64) NOT NULL, -- 工件SN
start_time TIMESTAMP, -- 开始时间（可手动修正）
end_time TIMESTAMP, -- 结束时间（可手动修正）
pass_rate NUMERIC(5,2), -- 总合格率（可手动修正）
operator_snapshot JSONB, -- 各工位操作人快照（账号名）
inspector_snapshot JSONB, -- 各工位检验人快照（账号名）
step_details JSONB, -- 各步骤考核数据快照
generated_by BIGINT NOT NULL, -- 生成人
generated_at TIMESTAMP DEFAULT NOW(), -- 生成时间
pdf_url VARCHAR(256) -- 生成的PDF文件路径
);
```
## 六、PDF模板
```
┌─────────────────────────────────────────────────────────────┐
│ 【北京电力设备总厂】 产线流程卡 │
│ 编号：PC-20260829-001 │
├─────────────────────────────────────────────────────────────┤
│ 产品信息 │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 工件SN：SN-HLX-001 工单号：WO001 │ │
│ │ 产品名称：汇流箱 2026标准型 开始：08-29 08:00 │ │
│ │ 结束：08-29 15:30 总合格率：98.5% │ │
│ └─────────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────┤
│ 工序追溯明细 │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 工序1 工位1 操作：张三 检验：李四 OK 08:30 │ │
│ │ 工序2 工位2 操作：张三 检验：李四 OK 09:00 │ │
│ │ 工序3 工位3 操作：王五 检验：赵六 NG 09:30 │ │
│ │ → 合格率：90.0% 已返修通过 │ │
│ │ 工序4 工位4 操作：王五 检验：赵六 OK 10:00 │ │
│ └─────────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────┤
│ 考核数据摘要 │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 拧紧螺丝A：2.48Nm（标准：2.5±0.1） OK │ │
│ │ 尺寸测量：300.05mm（标准：300±0.5） OK │ │
│ └─────────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────┤
│ 签名区 │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 工序1操作人：张三(工号1001) 检验人：李四(工号1002) │ │
│ │ 工序2操作人：张三(工号1001) 检验人：李四(工号1002) │ │
│ │ 工序3操作人：王五(工号1003) 检验人：赵六(工号1004) │ │
│ │ 工序4操作人：王五(工号1003) 检验人：赵六(工号1004) │ │
│ │ │ │
│ │ 最终审核人：韩总(admin) 日期：2026-08-29 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ 生成时间：2026-08-29 16:00 打印人：管理员 │
└─────────────────────────────────────────────────────────────┘
```
## 七、接口设计
**生成流程卡（生成前可预览修改）：**
```
POST /api/internal/process-card/generate
请求：{
"serial_no": "SN-HLX-001",
"start_time": "2026-08-29 08:00:00", -- 可选，默认自动
"end_time": "2026-08-29 15:30:00", -- 可选，默认自动
"pass_rate": 98.5, -- 可选，默认自动计算
"operator_overrides": { -- 可选，手动指定某些工位的操作人
"3": "wangwu" -- 工序3换成王五
}
}
返回：{
"card_no": "PC-20260829-001",
"preview": { ...完整数据... } -- 前端展示供用户确认
}
```
**确认生成PDF：**
```
POST /api/internal/process-card/confirm
请求：{ "card_no": "PC-20260829-001" }
返回：{ "pdf_url": "/uploads/process-card-PC-20260829-001.pdf" }
```
**查询已生成的流程卡：**
```
GET /api/internal/process-card/list
请求参数：serial_no(可选), work_order_no(可选), start_date, end_date, page, page_size
返回：列表 + 分页
```