OPC/goauto
2
0
Fork 0
Code Issues 192 Pull Requests Actions Packages Projects Releases Wiki Activity

档口入库码：总体交互原型与产品权限确认 #118

New Issue
Closed
opened 2026-08-27 23:30:17 +08:00 by ila · 4 comments
ila commented 2026-08-27 23:30:17 +08:00
Owner
Copy Link
Copy Source

所属与来源

  • 父 MVP：#117。
  • 来源：用户于 2026-08-27 要求先建立工单并制作总原型，审核通过后才能实施；2026-08-28 进一步确认导入后自动匹配，并采用批量物理删除。
  • 类型：设计证据 / 新独立管理页面。
  • 当前阶段：只制作线上原型，不编写 Server/Web 生产代码；#119～#122 均受本工单审核门禁约束。

目标

为“Excel 导入 → 自动只读匹配 → 人工确认回写 → 异步执行 → 结果不明确只读复核”提供统一线上交互原型，作为 #119～#122 的共同实现依据。

已确认交互

导入与自动匹配

  • 主列表工具栏从左到右固定为：选择 Excel → 导入 → 营业日期范围 → 订单号或入库码统一关键词 → 清除 → 搜索 → 同行最右侧回写（N）、删除（N）。
  • “清除”只清除营业日期与关键词筛选，不清除已经选择的 Excel 文件；文件名、大小和选择状态在工具栏下方显示。
  • 页面不提供常驻“批量匹配”按钮；Excel 导入成功后，服务端自动创建只读匹配任务，浏览器关闭后任务继续。
  • 统一关键词只搜索订单号和关联入库码子记录；服务端目标实现使用父记录订单号条件或入库码子记录 EXISTS，避免一条业务记录因多个入库码重复返回。
  • 页面展示匹配进度、可回写、匹配失败和等待匹配数量。
  • 只有临时读取失败或计划失效记录提供“重新匹配”；证据冲突、订单不存在、规格歧义提示修正 Excel。
  • 自动匹配不调用删除旧码、创建明细或写码接口。

回写

  • 列表表头和每一行最左侧均有独立勾选框；表头支持全选当前页，部分选择显示中间态。
  • 同行最右侧按钮显示服务端预检后的可回写数量，例如回写（2）；没有可回写记录时禁用并说明原因。
  • 点击回写必须先弹窗确认，标题提示确认回写已选择的 N 条业务记录吗？，确认按钮显示回写 N 条。
  • 确认弹窗继续展示业务记录数、入库码总数、预计占位明细数、替换旧码数，不以客户端勾选数量代替服务端预检。
  • 明确提示远端写入串行执行，结果不明确不会自动重试。
  • needs_check 只提供只读复核，不提供直接重试。

批量物理删除

  • 采购员通过每行最左侧勾选框选择记录，同行最右侧按钮显示可删除数量，例如删除（2）。
  • 点击删除必须先弹窗确认；弹窗文案：确定删除已选择的 N 条数据吗？删除后不可恢复，可重新导入 Excel。
  • 弹窗分别展示选中数量、可删除数量和阻塞数量，确认按钮直接显示删除 X 条，不静默扩大范围。
  • 确认后物理删除业务记录、关联入库码子记录和匹配计划；不做软删除、回收站或恢复。
  • 仅 queued、applying、needs_check 禁止删除，并在弹窗/结果中列出阻塞项；其他状态允许物理删除。

列表字段

  • 列顺序固定为：勾选框、营业日期、订单号、入库码、档口、本地规格、SYB 规格、状态、操作。
  • 删除“单件码”和“店铺”列；店铺仍保留在服务端匹配证据和详情中，不从数据模型删除。
  • 入库码列展示具体值；超过 2 个时显示前两个和总数，详情展示完整列表。
  • 本地规格保持 Excel 导入原值；SYB 规格展示最近一次成功读取或匹配证据，两者不互相覆盖。
  • 尚未匹配、正在读取、读取失败、计划失效和需复核均显示明确文字，不用空值表示状态。
  • 面向采购员的界面统一使用“入库码”，回写确认四项数字中的“入库码总数”改为“入库码总数”。

权限

  • 系统为内部采购员使用；采购员具备查看、导入、自动匹配、回写、只读复核和批量删除全部运营权限。
  • 服务端仍执行登录认证和采购员角色校验，不建立无认证接口。
  • 原型不再设计采购员内部的只读/写入权限拆分。

原型范围

  • GoAuto 左侧导航新增“档口入库码”。
  • 列表支持营业日期范围、订单号或入库码统一关键词筛选与分页；主筛选区不再放店铺、档口、SKU 和规格输入框。列表列为勾选框、营业日期、订单号、入库码、档口、本地规格、SYB 规格、状态、操作。
  • 覆盖正常、空、加载、失败、禁用、匹配进度、部分失败、回写确认、执行进度、服务重启中断和 needs_check。
  • 复用 go-admin-ui / Element Plus 的侧栏、表格、标签、对话框和分页规范。
  • 原型不调用真实 API、不连接 SYB、不修改数据库，不模拟采购下单或付款。

线上设计证据

  • 在线链接：GoAuto #118 - 档口入库码总原型 v1。
  • QuantUX App ID：6a90ddb6191a826306a7f3b1。
  • 审核版本：v1 修订稿（revision 3，2026-08-28）；每个页面右上角显示 #118 · v1 · r3。
  • 创建/校验时间：2026-08-28；状态：线上待审核草稿。
  • 访问边界：正式入口使用 qux.ilapage.cn；原型为项目私有应用，需使用已有 QuantUX 账号登录后查看，不开放匿名访问。
  • 页面：10 个 1440×900 桌面页面、425 个控件、26 条交互跳转；页面最大边界未超出 1440px 画布。
  • 覆盖：主工作台、Excel 校验与导入、导入后自动匹配、匹配进度、部分失败与受限重新匹配、四项风险数字回写确认、串行执行进度、批量物理删除与阻塞项、needs_check 只读复核、服务重启分流、空/加载/失败/禁用状态。
  • QuantUX 结构与运行时校验：PASS；10 屏、425 控件、26 条流程线，0 运行时错误、0 不支持控件类型。
  • 专项检查：工具栏顺序符合最终决策；旧三个组合输入框已移除；表头和每行最左侧均有勾选控件；主表已移除店铺和单件码列并按最终列序展示具体入库码、本地规格和 SYB 规格；全原型不存在面向用户的“单件码”术语；无常驻“批量匹配”；回写与删除均先确认并显示数量；四项回写风险数字保留；needs_check 无直接重试；未发现凭据、账号或生产数据。
  • 本次未生成、未下载、未写入新的本地 HTML，也未创建 Git 提交。此前 prototypes/118/v1/index.html / 本地提交 9e3761e 仍不是权威审核版本；只有用户明确执行“导出原型 #118”时才另行处理本地导出。

验收标准

  • 线上原型链接可访问且审核版本可明确识别。
  • 工具栏顺序为选择 Excel、导入、营业日期范围、统一关键词、清除、搜索，回写与删除位于同行最右侧。
  • 表头和每行最左侧均有勾选框，回写与删除按钮显示实际数量并先弹窗确认。
  • 主列表列序为勾选框、营业日期、订单号、入库码、档口、本地规格、SYB 规格、状态、操作；无店铺和单件码列。
  • 导入后自动匹配，页面无常驻批量匹配按钮。
  • 自动匹配进度、失败原因和异常重新匹配路径完整。
  • 写入确认准确展示四项风险数字。
  • 批量删除弹窗、物理删除语义和三个禁止删除状态清楚。
  • 正常、空、加载、失败、禁用、部分成功和 needs_check 状态完整。
  • 所有数据均为虚构，不包含凭据、账号或生产数据。
  • 用户明确审核线上原型通过。

文档影响

原型阶段无长期事实变化，跳过 Wiki。

## 所属与来源 - 父 MVP：#117。 - 来源：用户于 2026-08-27 要求先建立工单并制作总原型，审核通过后才能实施；2026-08-28 进一步确认导入后自动匹配，并采用批量物理删除。 - 类型：设计证据 / 新独立管理页面。 - 当前阶段：只制作线上原型，不编写 Server/Web 生产代码；#119～#122 均受本工单审核门禁约束。 ## 目标 为“Excel 导入 → 自动只读匹配 → 人工确认回写 → 异步执行 → 结果不明确只读复核”提供统一线上交互原型，作为 #119～#122 的共同实现依据。 ## 已确认交互 ### 导入与自动匹配 - 主列表工具栏从左到右固定为：`选择 Excel` → `导入` → 营业日期范围 → `订单号或入库码`统一关键词 → `清除` → `搜索` → 同行最右侧`回写（N）`、`删除（N）`。 - “清除”只清除营业日期与关键词筛选，不清除已经选择的 Excel 文件；文件名、大小和选择状态在工具栏下方显示。 - 页面不提供常驻“批量匹配”按钮；Excel 导入成功后，服务端自动创建只读匹配任务，浏览器关闭后任务继续。 - 统一关键词只搜索订单号和关联入库码子记录；服务端目标实现使用父记录订单号条件或入库码子记录 `EXISTS`，避免一条业务记录因多个入库码重复返回。 - 页面展示匹配进度、可回写、匹配失败和等待匹配数量。 - 只有临时读取失败或计划失效记录提供“重新匹配”；证据冲突、订单不存在、规格歧义提示修正 Excel。 - 自动匹配不调用删除旧码、创建明细或写码接口。 ### 回写 - 列表表头和每一行最左侧均有独立勾选框；表头支持全选当前页，部分选择显示中间态。 - 同行最右侧按钮显示服务端预检后的可回写数量，例如`回写（2）`；没有可回写记录时禁用并说明原因。 - 点击回写必须先弹窗确认，标题提示`确认回写已选择的 N 条业务记录吗？`，确认按钮显示`回写 N 条`。 - 确认弹窗继续展示业务记录数、入库码总数、预计占位明细数、替换旧码数，不以客户端勾选数量代替服务端预检。 - 明确提示远端写入串行执行，结果不明确不会自动重试。 - `needs_check` 只提供只读复核，不提供直接重试。 ### 批量物理删除 - 采购员通过每行最左侧勾选框选择记录，同行最右侧按钮显示可删除数量，例如`删除（2）`。 - 点击删除必须先弹窗确认；弹窗文案：`确定删除已选择的 N 条数据吗？删除后不可恢复，可重新导入 Excel。` - 弹窗分别展示选中数量、可删除数量和阻塞数量，确认按钮直接显示`删除 X 条`，不静默扩大范围。 - 确认后物理删除业务记录、关联入库码子记录和匹配计划；不做软删除、回收站或恢复。 - 仅 `queued`、`applying`、`needs_check` 禁止删除，并在弹窗/结果中列出阻塞项；其他状态允许物理删除。 ### 列表字段 - 列顺序固定为：勾选框、营业日期、订单号、入库码、档口、本地规格、SYB 规格、状态、操作。 - 删除“单件码”和“店铺”列；店铺仍保留在服务端匹配证据和详情中，不从数据模型删除。 - 入库码列展示具体值；超过 2 个时显示前两个和总数，详情展示完整列表。 - 本地规格保持 Excel 导入原值；SYB 规格展示最近一次成功读取或匹配证据，两者不互相覆盖。 - 尚未匹配、正在读取、读取失败、计划失效和需复核均显示明确文字，不用空值表示状态。 - 面向采购员的界面统一使用“入库码”，回写确认四项数字中的“入库码总数”改为“入库码总数”。 ### 权限 - 系统为内部采购员使用；采购员具备查看、导入、自动匹配、回写、只读复核和批量删除全部运营权限。 - 服务端仍执行登录认证和采购员角色校验，不建立无认证接口。 - 原型不再设计采购员内部的只读/写入权限拆分。 ## 原型范围 - GoAuto 左侧导航新增“档口入库码”。 - 列表支持营业日期范围、订单号或入库码统一关键词筛选与分页；主筛选区不再放店铺、档口、SKU 和规格输入框。列表列为勾选框、营业日期、订单号、入库码、档口、本地规格、SYB 规格、状态、操作。 - 覆盖正常、空、加载、失败、禁用、匹配进度、部分失败、回写确认、执行进度、服务重启中断和 `needs_check`。 - 复用 go-admin-ui / Element Plus 的侧栏、表格、标签、对话框和分页规范。 - 原型不调用真实 API、不连接 SYB、不修改数据库，不模拟采购下单或付款。 ## 线上设计证据 - 在线链接：[GoAuto #118 - 档口入库码总原型 v1](https://qux.ilapage.cn/#/apps/6a90ddb6191a826306a7f3b1.html)。 - QuantUX App ID：`6a90ddb6191a826306a7f3b1`。 - 审核版本：`v1` 修订稿（revision 3，2026-08-28）；每个页面右上角显示 `#118 · v1 · r3`。 - 创建/校验时间：2026-08-28；状态：线上待审核草稿。 - 访问边界：正式入口使用 `qux.ilapage.cn`；原型为项目私有应用，需使用已有 QuantUX 账号登录后查看，不开放匿名访问。 - 页面：10 个 1440×900 桌面页面、425 个控件、26 条交互跳转；页面最大边界未超出 1440px 画布。 - 覆盖：主工作台、Excel 校验与导入、导入后自动匹配、匹配进度、部分失败与受限重新匹配、四项风险数字回写确认、串行执行进度、批量物理删除与阻塞项、`needs_check` 只读复核、服务重启分流、空/加载/失败/禁用状态。 - QuantUX 结构与运行时校验：`PASS`；10 屏、425 控件、26 条流程线，0 运行时错误、0 不支持控件类型。 - 专项检查：工具栏顺序符合最终决策；旧三个组合输入框已移除；表头和每行最左侧均有勾选控件；主表已移除店铺和单件码列并按最终列序展示具体入库码、本地规格和 SYB 规格；全原型不存在面向用户的“单件码”术语；无常驻“批量匹配”；回写与删除均先确认并显示数量；四项回写风险数字保留；`needs_check` 无直接重试；未发现凭据、账号或生产数据。 - 本次未生成、未下载、未写入新的本地 HTML，也未创建 Git 提交。此前 `prototypes/118/v1/index.html` / 本地提交 `9e3761e` 仍不是权威审核版本；只有用户明确执行“导出原型 #118”时才另行处理本地导出。 ## 验收标准 - [x] 线上原型链接可访问且审核版本可明确识别。 - [x] 工具栏顺序为选择 Excel、导入、营业日期范围、统一关键词、清除、搜索，回写与删除位于同行最右侧。 - [x] 表头和每行最左侧均有勾选框，回写与删除按钮显示实际数量并先弹窗确认。 - [x] 主列表列序为勾选框、营业日期、订单号、入库码、档口、本地规格、SYB 规格、状态、操作；无店铺和单件码列。 - [x] 导入后自动匹配，页面无常驻批量匹配按钮。 - [x] 自动匹配进度、失败原因和异常重新匹配路径完整。 - [x] 写入确认准确展示四项风险数字。 - [x] 批量删除弹窗、物理删除语义和三个禁止删除状态清楚。 - [x] 正常、空、加载、失败、禁用、部分成功和 `needs_check` 状态完整。 - [x] 所有数据均为虚构，不包含凭据、账号或生产数据。 - [ ] 用户明确审核线上原型通过。 ## 文档影响 原型阶段无长期事实变化，跳过 Wiki。
ila commented 2026-08-28 09:09:26 +08:00
Author
Owner
Copy Link
Copy Source

线上原型 v1 已完成，等待审核

  • QuantUX App ID：6a90ddb6191a826306a7f3b1
  • 在线入口：http://124.222.27.183:8082/#/apps/6a90ddb6191a826306a7f3b1.html
  • 规模：10 个 1440×900 页面、416 个控件、25 条交互跳转
  • 校验：QuantUX PASS，0 运行时错误，0 不支持控件
  • 已落实：导入后自动匹配且无常驻匹配按钮；四项数字回写确认；queued/applying/needs_check 删除阻塞；批量物理删除；needs_check 只读复核且不直接重试；空/加载/失败/禁用/重启中断状态
  • 本次没有生成或提交新的本地 HTML，未修改生产代码、数据库、API 或 Wiki。

原型保持草稿、工单保持打开，等待用户明确审核通过。

## 线上原型 v1 已完成，等待审核 - QuantUX App ID：`6a90ddb6191a826306a7f3b1` - 在线入口：http://124.222.27.183:8082/#/apps/6a90ddb6191a826306a7f3b1.html - 规模：10 个 1440×900 页面、416 个控件、25 条交互跳转 - 校验：QuantUX `PASS`，0 运行时错误，0 不支持控件 - 已落实：导入后自动匹配且无常驻匹配按钮；四项数字回写确认；`queued/applying/needs_check` 删除阻塞；批量物理删除；`needs_check` 只读复核且不直接重试；空/加载/失败/禁用/重启中断状态 - 本次没有生成或提交新的本地 HTML，未修改生产代码、数据库、API 或 Wiki。 原型保持草稿、工单保持打开，等待用户明确审核通过。
ila commented 2026-08-28 09:24:14 +08:00
Author
Owner
Copy Link
Copy Source

v1 revision 2 已按最终方案修订

  • 正式入口：https://qux.ilapage.cn/#/apps/6a90ddb6191a826306a7f3b1.html
  • 主工具栏顺序：选择 Excel → 导入 → 营业日期范围 → 订单号或入库码 → 清除 → 搜索 → 右侧回写（N）/删除（N）
  • “清除”不清除已选 Excel，文件名与大小单独显示
  • 旧的三个组合输入框已移除
  • 表头和五条示例记录最左侧均为独立勾选控件，表头部分选择显示中间态
  • 回写弹窗提示回写业务记录数并保留四项风险数字；删除弹窗提示选中、可删除和阻塞数量
  • QuantUX 校验：PASS，10 屏、425 控件、26 条流程线，0 运行时错误、0 不支持控件
  • 未修改生产代码、Wiki 或本地 HTML，工单继续等待用户审核。
## v1 revision 2 已按最终方案修订 - 正式入口：https://qux.ilapage.cn/#/apps/6a90ddb6191a826306a7f3b1.html - 主工具栏顺序：选择 Excel → 导入 → 营业日期范围 → 订单号或入库码 → 清除 → 搜索 → 右侧回写（N）/删除（N） - “清除”不清除已选 Excel，文件名与大小单独显示 - 旧的三个组合输入框已移除 - 表头和五条示例记录最左侧均为独立勾选控件，表头部分选择显示中间态 - 回写弹窗提示回写业务记录数并保留四项风险数字；删除弹窗提示选中、可删除和阻塞数量 - QuantUX 校验：`PASS`，10 屏、425 控件、26 条流程线，0 运行时错误、0 不支持控件 - 未修改生产代码、Wiki 或本地 HTML，工单继续等待用户审核。
ila commented 2026-08-28 09:35:28 +08:00
Author
Owner
Copy Link
Copy Source

v1 revision 3：列表字段修订完成

  • 正式入口：https://qux.ilapage.cn/#/apps/6a90ddb6191a826306a7f3b1.html
  • 最终列序：勾选框｜营业日期｜订单号｜入库码｜档口｜本地规格｜SYB 规格｜状态｜操作
  • 已删除主列表“店铺”和“单件码”列
  • 入库码列展示虚构具体编码；超过 2 个时展示前两个和总数
  • 本地规格与 SYB 规格并列展示，读取中、未匹配和需复核均有明确文字状态
  • 导入、回写、执行、删除和只读复核页面的用户术语已全部由“单件码”统一为“入库码”
  • QuantUX 校验：PASS，10 屏、425 控件、26 条流程线，0 运行时错误、0 不支持控件
  • 未修改生产代码、Wiki 或本地 HTML；继续等待用户审核。
## v1 revision 3：列表字段修订完成 - 正式入口：https://qux.ilapage.cn/#/apps/6a90ddb6191a826306a7f3b1.html - 最终列序：勾选框｜营业日期｜订单号｜入库码｜档口｜本地规格｜SYB 规格｜状态｜操作 - 已删除主列表“店铺”和“单件码”列 - 入库码列展示虚构具体编码；超过 2 个时展示前两个和总数 - 本地规格与 SYB 规格并列展示，读取中、未匹配和需复核均有明确文字状态 - 导入、回写、执行、删除和只读复核页面的用户术语已全部由“单件码”统一为“入库码” - QuantUX 校验：`PASS`，10 屏、425 控件、26 条流程线，0 运行时错误、0 不支持控件 - 未修改生产代码、Wiki 或本地 HTML；继续等待用户审核。
ila commented 2026-08-28 09:42:43 +08:00
Author
Owner
Copy Link
Copy Source

用户于 2026-08-28 明确确认“原型通过”。#118 v1 revision 3 验收通过，确认范围包括最终工具栏顺序、列表字段、导入后自动匹配、四项风险数字回写确认、批量物理删除及 needs_check 只读复核。原型门禁解除，允许按依赖顺序实施 #119～#122。无长期事实变化，本设计工单不触发 Wiki 同步。

用户于 2026-08-28 明确确认“原型通过”。#118 v1 revision 3 验收通过，确认范围包括最终工具栏顺序、列表字段、导入后自动匹配、四项风险数字回写确认、批量物理删除及 `needs_check` 只读复核。原型门禁解除，允许按依赖顺序实施 #119～#122。无长期事实变化，本设计工单不触发 Wiki 同步。
ila closed this issue 2026-08-28 09:42:44 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/goauto#118