Admin：实现档口入库码独立页面与列表交互 #233

New Issue

2026-08-24T11:28:30+08:00

ila commented

2026-08-24 11:28:30 +08:00

基本信息

类型：需求
父级大工单：#14
所属 MVP / 版本：#224
阶段：页面交互

要解决什么

用户已确认 docs/prototypes/admin-inner-code.html 原型，但正式 Admin 尚无独立入口，无法导入、筛选、匹配或选择待回写记录。

做什么 / 不做什么

做：在“客户端列表”后增加一级 Tab“档口入库码”；实现业务日期、Excel 导入、状态、关键词、清除、匹配、分页和列表展示。
做：仅“可回写”行可勾选；回写已选按钮展示数量并二次确认；需核对行提供只读重新核对入口。
做：所有写表单使用 POST + CSRF，页面在 1366×768 可用，表格独立横向/纵向滚动并有明确空态、失败和加载反馈。
不做：不保留原型演示数据或模拟定时器；不新增前端框架、npm、自动轮询；本工单不实现真实顺运宝写接口。

怎么做

新增 admin/templates/inner_code/list.html、admin/handler/web/inner_code.go，在 admin/handler/web/web.go 注册路由，在 admin/templates/partials/header.html 增加导航。
复用现有公共 header/footer、分页和 UI 状态保持约定，样式追加到 admin/static/css/app.css；仅在勾选与确认弹窗需要时使用原生 JavaScript。
页面后端调用 service，不直接拼 SQL；关键词同时搜索订单号、档口、规格和入库码。

验收标准

“档口入库码”位于“客户端列表”之后，登录用户可访问且导航高亮正确。
业务日期、状态和关键词筛选可组合，清除按钮恢复默认条件，分页保持筛选参数。
Excel 导入和匹配均为 CSRF 保护的 POST，成功/失败反馈可读。
只有可回写行可勾选；确认弹窗准确显示选中数量和需替换旧值数量。
1366×768 下工具条、可滚动表格和右侧底栏分页均可操作，键盘焦点和弹窗关闭行为可用。

怎么验证

在 admin/ 执行 go test ./handler/web ./... -count=1；浏览器用 1366×768 验证导航、导入错误、组合筛选、分页、全选/半选、确认弹窗和键盘操作。

风险和回退

风险：表格列多导致小屏操作困难；保持表格最小列宽并让滚动条属于中间表格区域。
回退：移除导航与页面路由即可隐藏入口，数据库记录不受影响。

## 基本信息 - 类型：需求 - 父级大工单：#14 - 所属 MVP / 版本：#224 - 阶段：页面交互 ## 要解决什么用户已确认 `docs/prototypes/admin-inner-code.html` 原型，但正式 Admin 尚无独立入口，无法导入、筛选、匹配或选择待回写记录。 ## 做什么 / 不做什么 - 做：在“客户端列表”后增加一级 Tab“档口入库码”；实现业务日期、Excel 导入、状态、关键词、清除、匹配、分页和列表展示。 - 做：仅“可回写”行可勾选；回写已选按钮展示数量并二次确认；需核对行提供只读重新核对入口。 - 做：所有写表单使用 POST + CSRF，页面在 1366×768 可用，表格独立横向/纵向滚动并有明确空态、失败和加载反馈。 - 不做：不保留原型演示数据或模拟定时器；不新增前端框架、npm、自动轮询；本工单不实现真实顺运宝写接口。 ## 怎么做 - 新增 `admin/templates/inner_code/list.html`、`admin/handler/web/inner_code.go`，在 `admin/handler/web/web.go` 注册路由，在 `admin/templates/partials/header.html` 增加导航。 - 复用现有公共 header/footer、分页和 UI 状态保持约定，样式追加到 `admin/static/css/app.css`；仅在勾选与确认弹窗需要时使用原生 JavaScript。 - 页面后端调用 service，不直接拼 SQL；关键词同时搜索订单号、档口、规格和入库码。 ## 验收标准 - [ ] “档口入库码”位于“客户端列表”之后，登录用户可访问且导航高亮正确。 - [ ] 业务日期、状态和关键词筛选可组合，清除按钮恢复默认条件，分页保持筛选参数。 - [ ] Excel 导入和匹配均为 CSRF 保护的 POST，成功/失败反馈可读。 - [ ] 只有可回写行可勾选；确认弹窗准确显示选中数量和需替换旧值数量。 - [ ] 1366×768 下工具条、可滚动表格和右侧底栏分页均可操作，键盘焦点和弹窗关闭行为可用。 ## 怎么验证在 `admin/` 执行 `go test ./handler/web ./... -count=1`；浏览器用 1366×768 验证导航、导入错误、组合筛选、分页、全选/半选、确认弹窗和键盘操作。 ## 风险和回退 - 风险：表格列多导致小屏操作困难；保持表格最小列宽并让滚动条属于中间表格区域。 - 回退：移除导航与页面路由即可隐藏入口，数据库记录不受影响。

ila commented

2026-08-24 11:42:04 +08:00