bj_power/bj_power_workstation/临时文件.md at 1f0ee844a40fddd7975c922ab1c0d4e24c3abea5

Files

T

SunYF 1f0ee844a4 chore: init bj_power monorepo (dashboard/mes/wms/wms_client/workstation), clear subproject git metadata and align naming to folder names

2026-08-27 10:09:54 +08:00

23 KiB

Raw Blame History

如何描述清楚功能，是个大事情

现状描述： 1、现在代码是，完全复制的https://bjhardman.cn/bjhardman/hougai_insize_micrometer.git ，目的仅仅是为了阅读，实际将来我要引用这个git，因为它封装了千分尺的通讯（即：监控Windows，采集千分尺测量的数据）。 2、hougai_insize_micrometer.git，还有一些对我有用的内容，比如他的页面风格。govcl写的。下面描述是真正的需求，根据具体需求，仅保留hougai_insize_micrometer.git有用内容，例如：技术架构说明：下文中原git 就是指的 hougai_insize_micrometer.git 要求： 1、引用 hougai_insize_micrometer.git，它里面已经包含千分尺的采集模块。 2、生产环境部署在 window ，要求用govcl、有托盘、有桌面图标、开机自启、自动全屏显示、桌面快捷图标、固定开始屏幕、点击输入框自动弹出系统软键盘输入法 3、没有数据库，用8888接口请求，模仿原git 代码写法。（8888没有开发呢，你先写着，定义好 url、出入参） 4、8888 是/Users/syf/space/hardman/spherical 这个服务器启动地址页面和功能描述（参考图片样式，图片是原git，下面统称 jpg）：

在原git 页面基础上，我对页面进行了布局重新描述。（我把原页面让ai转成布局描述）布局描述如下：

核心策略：结构化 + 控件化（govcl / Lazarus LCL 风格）不要写长篇大论的散文，要用配置表格式描述每个控件的位置、属性和样式。

全局设置 (Global Config) 基准窗口：1280 x 720，PoScreenCenter 居中，Caption = "7315-2 千分尺采集"。配色风格（govcl 体系）：面板底色：colors.ClBtnFace（系统默认灰，约 #F0F0F0）选中高亮：types.TColor(0x00FFE0C0)（浅暖橙，与现有项目一致）状态绿：colors.ClGreen 状态红：colors.ClRed 字体：默认微软雅黑（系统默认），数字 label 不做额外等宽处理（govcl 对 Consolas 不敏感）。布局方式：绝对定位（Left / Top / Width / Height），间距常量 gapX=8, gapY=10。缩放机制：基于 baseW=1280 / baseH=720，relayout() 中按 sx/sy 等比缩放，字号、宽高均 clamp 下限。
区域拆解 (Area Breakdown) 三模块：顶部控制栏 / 仪表盘显示区 / 操作与数据区。

模块 A：顶部控制栏位置：top0 = 8，从左到右水平排列，垂直居中对齐。控件列表（按 Left 递增）：

控件 | 类型 | Left | Top | Width | Height | 关键属性 [portLab] | TLabel | 12 | 13 | Auto | Auto | Caption="串口:"，FontSize=12 [portCombo] | TComboBox | 56 | 8 | 110 | 28 | Style=CsDropDownList，默认选中第一项（COM7 优先） [statusLabel] | TLabel | 172 | 12 | 120 | 24 | Caption="●已连接"=ClGreen / "●未连接"=ClBtnFace / "●已断开"=ClRed，FontSize=12 [connectBtn] | TButton | 296 | 8 | 60 | 28 | Caption 切换 "连接"/"断开" [refreshBtn] | TButton | 360 | 8 | 60 | 28 | Caption="刷新" [labU] | TLabel | 440 | 12 | Auto | Auto | Caption="单位:"，FontSize=12 [rbMM] | TRadioButton | 490 | 10 | Auto | Auto | Caption="mm"，Checked（同 Form 下自动互斥） [rbInch] | TRadioButton | 550 | 10 | Auto | Auto | Caption="inch" [autoStartChk]| TCheckBox | 610 | 12 | Auto | Auto | Caption="开机启动"，Checked 同步注册表

模块 B：仪表盘显示区（4 卡片面板）容器：TPanel，BevelOuter=BvRaised（凸起卡片效果），4 个水平排列。位置：top0 = 50，Left = 16 + i*(panelW + gapX)，其中 panelW = (cw - 5*gapX)/4（响应式等分）。面板内部：父 = 对应 TPanel，3 行 TLabel 垂直居中。

卡片 n 内部控件（以卡片 1 为例）：

四卡片内容：

卡片 | name Caption | value 示例 1 | "① 左侧底孔 B" | "425.282" 2 | "② 变量活塞孔大孔 D" | "425.282" 3 | "③ 变量活塞孔小孔 E" | "423.151" 4 | "④ 右侧变量活塞孔 M" | "423.151"

高亮状态：当前选中面板 → panel.Color = TColor(0x00FFE0C0)；未选中 → colors.ClBtnFace。（govcl TPanel 无圆角/border 颜色能力，用 BevelOuter + Color 区分即可。）

模块 C：操作与数据区中间行：

底部表格：容器：TListView，ViewStyle=VsReport，ReadOnly=true，RowSelect=true，GridLines=true。 FontSize=12（范围 10-20）。 9 列定义（列宽随 sx 缩放，末列占剩余宽度）：

序号 | Caption | 基准 Width 1 | 时间 | 130 2 | 工件号 | 110 3 | 工单号 | 110 4 | 托盘码 | 100 5 | 分类 | 90 6 | 左侧底孔 B | 120 7 | 活塞孔大 D | 120 8 | 活塞孔小 E | 120 9 | 活塞孔右 M | 剩余 cw - 前8列（min=100）

（govcl TListView 不支持斑马纹，通过 GridLines 保证可读性即可。）

按需求修改后的布局描述如下：

核心策略：结构化 + 控件化（govcl / Lazarus LCL 风格）不要写长篇大论的散文，要用配置表格式描述每个控件的位置、属性和样式。

全局设置 (Global Config) 基准窗口：1280 x 720，PoScreenCenter 居中，Caption = "7315-2 千分尺采集"。配色风格（govcl 体系）：面板底色：colors.ClBtnFace（系统默认灰，约 #F0F0F0）选中高亮：types.TColor(0x00FFE0C0)（浅暖橙，与现有项目一致）状态绿：colors.ClGreen 状态红：colors.ClRed 字体：默认微软雅黑（系统默认），数字 label 不做额外等宽处理（govcl 对 Consolas 不敏感）。布局方式：绝对定位（Left / Top / Width / Height），间距常量 gapX=8, gapY=10。缩放机制：基于 baseW=1280 / baseH=720，relayout() 中按 sx/sy 等比缩放，字号、宽高均 clamp 下限。
区域拆解 (Area Breakdown) 三模块：顶部控制栏 / 工单信息 / 仪表盘显示区 / 操作与数据区。

模块 A：顶部控制栏位置：top0 = 8，从左到右水平排列，垂直居中对齐。控件列表（按 Left 递增）：

模块 B：工单信息来源说明：输入工单号，查询出来的，包括工件数量、工件类型、工单状态、创建时间。位置：top0 = 48，从左到右水平排列，垂直居中对齐。控件列表（按 Left 递增）：

控件 | 类型 | Left | Top | Width | Height | 关键属性 [workOrderNoLabel]| TLabel | 12 | 53 | Auto | Auto | Caption="工单号:"，FontSize=12 [workOrderNoEdit] | TEdit | 72 | 48 | 200 | 28 | Text=""，Placeholder="请输入工单号" [queryBtn] | TButton | 278 | 48 | 70 | 28 | Caption="查询" [typeLabel] | TLabel | 356 | 53 | Auto | Auto | Caption="工件类型:"，FontSize=12 [typeCombo] | TComboBox | 426 | 48 | 120 | 28 | Style=CsDropDownList，ReadOnly=true [countLabel] | TLabel | 554 | 53 | Auto | Auto | Caption="工件数量:"，FontSize=12 [countValue] | TLabel | 626 | 53 | 60 | Auto | Caption="--"，FontSize=12 [statusLabel] | TLabel | 694 | 53 | Auto | Auto | Caption="工单状态:"，FontSize=12 [statusValue] | TLabel | 766 | 53 | 80 | Auto | Caption="--"，FontSize=12 [timeLabel] | TLabel | 854 | 53 | Auto | Auto | Caption="创建时间:"，FontSize=12 [timeValue] | TLabel | 934 | 53 | 220 | Auto | Caption="--"，FontSize=12

模块 C：仪表盘显示区（动态面板）（工件类型是“方形” 对应1 卡片面板）（工件类型是“圆形” 对应3 卡片面板）容器：TPanel，BevelOuter=BvRaised（凸起卡片效果），水平排列。位置：top0 = 84，Left = 16 + i*(panelW + gapX)，其中：

方形（1卡片）：panelW = cw - 32（左右边距各16）
圆形（3卡片）：panelW = (cw - 4*gapX - 32)/3（响应式等分）面板内部：父 = 对应 TPanel，3 行 TLabel 垂直居中。

卡片 n 内部控件（以卡片 1 为例）：

方形（1卡片）内容：

卡片 | name Caption | value 示例 1 | "① 弧面半径 B" | "425.282"

圆形（3卡片）内容：

卡片 | name Caption | value 示例 1 | "① 球面直径 A" | "425.282" 2 | "② 球面轮廓度 B" | "425.282" 3 | "③ 球面位置 C" | "423.151"

高亮状态：当前选中面板 → panel.Color = TColor(0x00FFE0C0)；未选中 → colors.ClBtnFace。（govcl TPanel 无圆角/border 颜色能力，用 BevelOuter + Color 区分即可。）

模块 D：操作与数据区中间行：

底部表格：容器：TListView，ViewStyle=VsReport，ReadOnly=true，RowSelect=true，GridLines=true。 FontSize=12（范围 10-20）。列定义（列宽随 sx 缩放，末列占剩余宽度，根据工件类型动态显示测量列）：

方形（5列）：序号 | Caption | 基准 Width 1 | 时间 | 130 2 | 工单号 | 130 3 | 工件号 | 110 4 | 分类 | 90 5 | 弧面半径 B | 剩余 cw - 前4列（min=120）

圆形（7列）：序号 | Caption | 基准 Width 1 | 时间 | 130 2 | 工单号 | 130 3 | 工件号 | 110 4 | 分类 | 90 5 | 球面直径 A | 120 6 | 球面轮廓度 B | 120 7 | 球面位置 C | 剩余 cw - 前6列（min=100）

（govcl TListView 不支持斑马纹，通过 GridLines 保证可读性即可。）

功能交互描写： 1、模块 B：工单信息：输入工单号，点击"查询"按钮，调用 8888 查询工单信息，并展示工件类型、工件数量、工单状态、创建时间。 2、根据查询返回的工件类型，动态切换仪表盘显示区：方形 → 1卡片面板，圆形 → 3卡片面板。 3、工件号输入框：输入工件号后点击"筛选"按钮，调用8888查询对应工件的测量记录，填充底部表格。 4、提交按钮：点击提交前检查工单号是否填写，未填写则提示；提交成功后自动刷新底部表格。

8888 后端 API 接口定义（服务地址：http://localhost:8888）

接口 1：查询工单信息

路径：GET /api/v1/work-order/query
入参：
- work_order_no (string, 必填): 工单号

响应：

{
  "code": 0,
  "msg": "success",
  "data": {
    "work_order_no": "WO-2024001-001",
    "workpiece_type": "square",
    "workpiece_type_name": "方形",
    "workpiece_count": 100,
    "status": "processing",
    "status_name": "处理中",
    "created_at": "2024-01-15 10:30:00"
  }
}

字段说明：
- workpiece_type: "square"（方形）/ "circle"（圆形）
- status: 参考 public.work_order.status 枚举值

接口 2：查询工件测量记录列表

路径：GET /api/v1/measurement/list
入参：
- work_order_no (string, 必填): 工单号
- workpiece_no (string, 可选): 工件号（过滤条件）
- page (int, 默认 1): 页码
- limit (int, 默认 20): 每页数量

响应：

{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": 1,
        "work_order_no": "WO-2024001-001",
        "workpiece_no": "WP-001",
        "category": "A类",
        "workpiece_type": "circle",
        "value_a": 425.282,
        "value_b": 425.282,
        "value_c": 423.151,
        "unit": "mm",
        "created_at": "2024-01-15 11:00:00"
      }
    ],
    "total": 150,
    "page": 1,
    "limit": 20
  }
}

字段说明：
- value_a: 球面直径 A（圆形）/ 弧面半径 B（方形）
- value_b: 球面轮廓度 B（圆形）
- value_c: 球面位置 C（圆形）
- category: 分类
- 方形工件仅返回 value_a

接口 3：提交测量数据

路径：POST /api/v1/measurement/upload

入参：

{
  "work_order_no": "WO-2024001-001",
  "workpiece_no": "WP-002",
  "category": "A类",
  "workpiece_type": "circle",
  "value_a": 425.282,
  "value_b": 425.282,
  "value_c": 423.151,
  "unit": "mm",
  "serial": "COM7",
  "timestamp": "2024-01-15 11:30:00"
}

字段说明：
- workpiece_type: "square"（方形）/ "circle"（圆形）
- value_a: 必填
- value_b: 圆形必填，方形不传
- value_c: 圆形必填，方形不传
- category: 分类（可选）

响应：

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 2
  }
}

接口 4：获取工单号下拉列表（可选，用于工单查询时的选择）

路径：GET /api/v1/work-order/list
入参：
- keyword (string, 可选): 工单号关键词
- limit (int, 默认 20): 返回数量

响应：

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "work_order_no": "WO-2024001-001",
      "description": "工单描述"
    }
  ]
}

待决策事项：

工件类型扩展：除了"方形"和"圆形"，是否还有其他工件类型？如果有，需要补充对应的数据字段和卡片布局。答：没了
表格列动态显示：当前设计表格列根据工件类型动态显示（方形5列，圆形7列），是否需要额外的"分类"列？答：需要，在托盘码后面
提交按钮数据：点击"提交"按钮时，需要提交哪些数据？目前设计包含订单号、工单号、工件号、托盘码、测量值，是否还有其他必填字段（如操作员ID）？答：不需要了。说明：1、把“托盘码”全删除吧，没有这个数据。2、订单号，就是顶部那个订单号，如果没填，页面提示先填写再提交
订单号与工单号关系：订单号和工单号是什么关系？一个订单对应多个工单？查询工单时是否需要同时输入两个字段？答：我描述错了，请全部修改：订单就是工单，全部改成工单号。一个工单号，对应多个工件号
筛选按钮行为：工件号输入框旁的"筛选"按钮是前端本地过滤表格数据，还是重新调用8888接口查询？答： 8888查询
工件号清除按钮：工件号输入框的"小X杠"清除按钮，govcl TEdit不原生支持，需要自定义实现（如在输入框右侧叠加小按钮），是否确认需要此功能？答：不必实现，不要 "小X杠" 啦
测量数据来源：仪表盘卡片的测量值是千分尺自动采集填入，还是手动输入？如果是自动采集，是否需要实时显示采集值？答：自动显示。参考”原git“，本项目要把 “原git” 作为公共库，引入
8888接口鉴权：8888后端接口是否需要鉴权（如Token验证）？如果需要，客户端如何获取和携带Token？答：不需要鉴权
托盘码来源：托盘码字段如何获取？是手动输入还是从工单信息中关联获取？答：没有这个字段了，删除吧
提交后表格刷新：提交测量数据成功后，是否需要自动刷新底部表格数据？答：刷新

8888 后端实际实现与文档差异（千分尺项目需同步修改）

以下是 8888（当前项目 spherical）实际实现的接口，与文档中定义的接口有差异，千分尺项目需按此调整调用：

差异 1：API 路径前缀统一收拢

文档中接口分散在不同路径下，实际实现统一收拢到 /api/v1/micrometer/ 前缀下：

文档路径	实际路径
`GET /api/v1/work-order/query`	`GET /api/v1/micrometer/work-order/query`
`GET /api/v1/measurement/list`	`GET /api/v1/micrometer/measurements`
`POST /api/v1/measurement/upload`	`POST /api/v1/micrometer/measurements`
`GET /api/v1/work-order/list`	`GET /api/v1/micrometer/work-orders`

差异 2：响应格式

文档使用 msg 字段，实际项目统一使用 message 字段：

{ "code": 0, "message": "success", "data": {...} }

差异 3：接口 1 查询工单信息 - 入参字段名

文档使用 work_order_no（下划线），实际使用 workOrderNo（驼峰）：

GET /api/v1/micrometer/work-order/query?workOrderNo=WO-2024001-001

差异 4：接口 2 查询测量记录 - 路径和入参名

路径：GET /api/v1/micrometer/measurements
入参使用驼峰：workOrderNo, workpieceNo, page, limit
分页参数使用项目通用 PageReq（page 从 1 开始，limit 默认 10）

示例：

GET /api/v1/micrometer/measurements?workOrderNo=WO-2024001-001&workpieceNo=WP-001&page=1&limit=20

差异 5：接口 3 提交测量数据 - 路径和字段名

路径：POST /api/v1/micrometer/measurements
请求体字段使用驼峰命名（workOrderNo, workpieceNo, workpieceType, valueA, valueB, valueC）
响应使用 message 而非 msg

差异 6：接口 4 工单列表 - 路径

路径：GET /api/v1/micrometer/work-orders?keyword=xxx&limit=20
description 字段当前返回工单号（后续可扩展）

差异 7：数据存储

测量数据存储在独立的 micrometer_measurement 表中，而非复用现有 job 表。工件号（workpiece_no）是手动录入的唯一编码，不设唯一约束，同一工件号可多次录入测量数据。

差异 8：无需鉴权

所有千分尺接口无需 JWT Token 鉴权，可直接调用。

差异 9：工件类型映射

8888 项目的 product_type.category 字段与千分尺工件类型映射关系：

SQUARE → square（方形）
GENERAL → circle（圆形）

UI 优化修改记录（需 8888 同步调整）

修改 1：默认全屏显示

窗口启动时自动最大化（WsMaximized）

修改 2：输入框点击弹出软键盘

Windows 系统下通过系统输入法自动弹出软键盘
输入框已设置 TextHint 提示

修改 3：卡片样式优化

增大卡片高度（180px）
增大字号：名称16px，数值28px，单位16px
使用 BvRaised 凸起效果

修改 4：工件号输入框调整

移到清除按钮同行，左侧位置
尺寸与按钮一致（高44px），字体14px
失去焦点时自动查询下方列表（OnExit 事件）
仍作为过滤条件传给 8888

修改 5：提交按钮提示增强

工单号为空：提示"请先输入工单号"
未查询工单：提示"请先查询工单"
工件号为空：提示"请输入工件号"

修改 6：工单查询失败提示

查询不到工单时提示："未查询到工单信息，请检查工单号是否正确"
清空当前工单信息显示

修改 7：触控屏优化

增大模块A/B行高（44px）
增大字号（14px）
增大按钮宽度和输入框宽度

修改 8：关闭窗口二次确认

点击右上角关闭时弹出确认对话框
"确定要退出程序吗？"

修改 9：列表默认显示全部数据

未填写工单号/工件号时，调用查询接口传入空参数
8888 需支持无参数时返回全部记录
要求按时间倒序排列（最新录入在第一条）

修改 10：新增导出功能

在"工件号"输入框右侧新增"导出"按钮
按钮尺寸：宽120px，高44px
导出格式：CSV（可直接用Excel打开）
文件名格式：20060102_150405.csv（年月日时分秒）
导出内容：当前表格所有行数据

修改 11：工件类型映射

后端返回 GENERAL → 前端显示为"圆形"（circle）
后端返回 SQUARE → 前端显示为"方形"（square）

23 KiB Raw Blame History Unescape Escape