完善生产异常维修与备件管理功能

docs/2026-09-01/1-更新异常提报工序步骤.md

@@ -0,0 +1,11 @@
+# 异常提报自动提交工序步骤
+
+## 更新内容
+
+- 后台生产配置新增“异常提报工序”和“异常提报步骤”选项，管理员可选择有效的工序步骤。
+- 异常提报接口读取后台配置，将工序步骤直接保存到异常记录中。
+- 异常页面保持原有表单，提交时只调用异常提报接口，不在前端维护工序步骤数据。
+
+## 行为说明
+
+未配置或配置无效时，异常提报会提示管理员先完成工序步骤配置；配置有效时查询列表会在异常记录行直接展示对应工序和步骤。

docs/2026-09-01/10-用户编码样式优化.md

@@ -0,0 +1,5 @@
+# 用户编码样式优化
+
+- 优化异常提报和维修页面用户编码输入区域的宽度、字号、内边距和行间距。
+- 输入框使用更明显的圆角边框和 40px 高度，标签不再窄小换行。
+- 模板源与 Web 运行目录同步。

docs/2026-09-01/12-责任人员文字间距优化.md

@@ -0,0 +1,5 @@
+# 责任人员文字间距优化
+
+- 调整责任人员卡片姓名与工序步骤之间的间距。
+- 姓名固定单行显示并支持超长省略，工序步骤增加行高，提升可读性。
+- 模板源与 Web 运行目录同步。

docs/2026-09-01/13-维修备件搜索弹窗.md

@@ -0,0 +1,22 @@
+# 维修备件搜索弹窗
+
+## 变更内容
+
+- 新增公开物料选项接口 `/produce/material/options`，支持按商品编码或商品名称模糊搜索及分页。
+- 维修记录的“添加备件”改为弹窗选择模式，展示商品编码、商品名称和物料分类。
+- 已添加备件在列表中显示“已添加”并禁止重复选择，选择后自动加载对应故障点。
+- 模板源页面与前端 Web 运行目录已同步。
+
+## 涉及文件
+
+- `backend/plugin/produce/app/api/controller/DataEntryController.php`
+- `backend/plugin/produce/resource/template/web/api/exception.ts`
+- `backend/plugin/produce/resource/template/web/pages/repair/index.vue`
+- `frontend/web/app/apps/produce/api/exception.ts`
+- `frontend/web/app/apps/produce/pages/repair/index.vue`
+
+## 验证
+
+- `php -l backend/plugin/produce/app/api/controller/DataEntryController.php` 通过。
+- 模板源与运行目录页面、API 文件 SHA256 校验一致。
+- 前端类型检查仍受项目既有无关类型错误影响，维修页面及生产 API 未出现新增错误。

docs/2026-09-01/14-维修备件多条件筛选.md

@@ -0,0 +1,13 @@
+# 维修备件多条件筛选
+
+## 变更内容
+
+- 备件弹窗搜索区拆分为商品编码、商品名称两个独立输入框。
+- 新增物料分类下拉筛选，复用维修页面已加载的物料分类数据。
+- `/produce/material/options` 接口支持 `product_code`、`product_name`、`category_id` 三个筛选参数。
+- 模板源与 Web 运行目录页面、接口文件已同步。
+
+## 验证
+
+- `php -l backend/plugin/produce/app/api/controller/DataEntryController.php` 通过。
+- 模板源与运行目录文件 SHA256 校验一致。

docs/2026-09-01/15-维修备件按频率排序.md

@@ -0,0 +1,7 @@
+# 维修备件按使用频率排序
+
+维修备件选项接口现在统计历史维修记录中各备件的使用数量，按使用频率从高到低排序；频率相同时按商品编码升序排列，保证列表稳定。
+
+统计来源为维修记录 `parts` JSON 中的商品编码和数量字段，筛选、分页仍按原有接口参数执行。
+
+验证：`php -l backend/plugin/produce/app/api/controller/DataEntryController.php` 通过。

docs/2026-09-01/16-物料分类下拉显示修复.md

@@ -0,0 +1,7 @@
+# 物料分类下拉显示修复
+
+修复物料库页面物料分类下拉选项为空白的问题。
+
+原因是分类接口在 `format=select` 模式下返回标准字段 `label`、`value`，页面却按 `category_name`、`id` 读取。现已统一搜索条件和新增/编辑表单的 `ApiSelect` 字段映射为 `label`、`value`。
+
+模板源与 Admin 运行目录已同步。

docs/2026-09-01/2-更新异常记录展示工序步骤.md

@@ -0,0 +1,3 @@
+# 异常记录直接展示工序步骤
+
+异常提报不再创建额外的扫码记录，后台配置的工序和步骤改为直接保存到异常记录，并由记录查询接口展示在异常记录行中。这样查询列表只显示一条红色异常记录，不会重复出现一条扫码数据。

docs/2026-09-01/3-维修流程配置页.md

@@ -0,0 +1,6 @@
+# 维修流程配置页
+
+- 在生产配置中新增“维修流程”页签。
+- 使用现有工序、工序步骤接口选择维修流程节点。
+- 配置保存至 `repair_flow` 配置组；读取时兼容回退到 `basic_setting` 中的同名字段。
+- 模板源与 `frontend/admin/src/apps/produce` 运行目录保持同步。

docs/2026-09-01/4-基础设置字段调整.md

@@ -0,0 +1,5 @@
+# 基础设置字段调整
+
+- 基础设置页保留“异常提报工序”和“异常提报步骤”配置，用于异常提报自动记录工序节点。
+- 维修流程工序、步骤由独立的“维修流程”配置页维护，保存至 `repair_flow` 配置组。
+- 模板源与 `frontend/admin/src/apps/produce` 运行目录保持一致。

docs/2026-09-01/4-维修数据CRUD修复.md

@@ -0,0 +1,6 @@
+# 维修数据 CRUD 修复
+
+- 修复维修数据列表关键词查询未启用的问题。
+- 增强维修记录唯一单号校验，更新时忽略当前记录。
+- 支持分类、备件、图片及责任快照字段以 JSON 字符串提交并转换为数组。
+- 修复详情表单隐藏 ID 字段被 `ifDetail` 排除，导致更新地址缺少 ID 的问题。

docs/2026-09-01/5-维修记录工序步骤展示修复.md

@@ -0,0 +1,5 @@
+# 维修记录工序步骤展示修复
+
+- 维修记录时间线此前固定返回空工序和步骤，导致提交后显示为“-”。
+- 查询维修记录时读取基础设置中的 `repair_process_id`、`repair_step_id`，并兼容维修流程配置组 `repair_flow`。
+- 根据配置的工序、步骤 ID 查询名称后返回给前台时间线。

docs/2026-09-01/6-查询记录数量显示.md

@@ -0,0 +1,5 @@
+# 查询记录数量显示
+
+- 异常提报和维修记录属于单条业务记录，查询接口统一返回数量 `1`。
+- 查询页面继续使用 `quantity` 字段展示，避免显示破折号。
+- Web 查询页模板源与运行目录保持同步。

docs/2026-09-01/7-模板源运行目录一致性检查.md

@@ -0,0 +1,6 @@
+# 模板源运行目录一致性检查
+
+- 已递归核对 produce 插件 Admin、Web 模板源与前端运行目录。
+- Web 目录文件全部一致。
+- Admin 异常数据 Schema 以运行目录最新内容同步回模板源。
+- 运行目录中的扁平异常页面属于兼容路径，模板源保留正式嵌套目录结构，未删除任何文件。

docs/2026-09-01/8-维修记录工号显示修复.md

@@ -0,0 +1,5 @@
+# 维修记录工号显示修复
+
+- 修复订单全流程时间线中维修记录工号为空的问题。
+- 维修记录通过关联异常记录读取提报人工号，并统一返回 `user_code` 字段。
+- 查询页面无需额外改动，操作人区域会与扫码、异常记录一样显示工号。

docs/2026-09-01/9-异常维修用户编码录入.md

@@ -0,0 +1,6 @@
+# 异常维修用户编码录入
+
+- 异常提报和维修页面新增用户编码输入框。
+- 输入后调用生产录入使用的 `/produce/member-user/check` 接口校验，并显示对应用户名。
+- 提交时使用录入并校验通过的用户编码，不再强制使用当前登录账号。
+- 模板源与 Web 运行目录同步。