docs: 归档任务 #239

2026-08-15 11:04:39 +08:00
parent d79bdb10d3
commit 5d72141f2f
1 changed files with 53 additions and 0 deletions
@@ -0,0 +1,53 @@
+# 239 Admin：压缩档口入库码筛选工具栏并调整控件顺序
+
+- 类型：需求
+- 父级大工单：#14
+- 所属 MVP / 版本：#224
+- 状态：已完成
+- 日期：2026-08-15
+- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/239
+
+## 背景与目标
+
+档口入库码工具栏的搜索框占用空间偏大，业务日期与状态、关键词分散，“搜索”位于“清除”之前也削弱了主次操作顺序。本任务在不修改筛选行为的前提下压缩并重排工具栏。
+
+## 最终方案
+
+- 筛选表单按“状态 → 业务日期 → 搜索输入框 → 清除 → 搜索”排列，DOM 和键盘 Tab 顺序一致。
+- 业务日期从工具栏独立容器移入 GET 筛选表单，直接使用可见 `name="date"` 字段提交，不保留重复隐藏字段。
+- 搜索输入框由原先可扩展的约 220px 调整为固定 150px；没有按字面缩到约 66px，避免订单号和规格无法查看。
+- 日期控件保持 138px，不允许被 flex 压缩。
+- 筛选表单允许内部换行；小于 760px 时整组占满一行，再按现有 flex 规则自然换行。
+- 保留 `data-inner-code-date`，因此日期变化仍同步到匹配、回写和删除隐藏表单。
+- 没有修改 Handler、Service、Repository、数据库或接口。
+
+## 改了哪些
+
+- `admin/templates/inner_code/list.html`：移动业务日期并调整清除、搜索顺序。
+- `admin/static/css/app.css`：搜索框改为 150px，补充日期最小宽度和窄窗口换行规则。
+- `admin/inner_code_template_test.go`：守卫筛选顺序、日期提交方式、紧凑宽度和响应式规则。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 筛选顺序为“状态 → 业务日期 → 搜索输入框 → 清除 → 搜索” | 通过 |
+| 搜索输入框桌面宽度约 150px，不再扩展为 220px | 通过 |
+| 业务日期保留可见 label，GET 搜索直接提交 `date` | 通过 |
+| 日期变化继续同步到匹配、回写和删除表单 | 通过 |
+| 窄窗口筛选组占满一行并允许自然换行 | 通过（静态规则） |
+| 后端、数据库和业务行为不变 | 通过 |
+| 固定 Go 1.23.0 build/test/vet 通过 | 通过 |
+
+## 测试
+
+- 执行的命令：
+  - `go test -count=1 . ./handler/web ./service`
+  - `$env:GOTOOLCHAIN='go1.23.0'; go build ./...; go test -count=1 ./...; go vet ./...`
+  - `git diff --check`
+- 结果：全部通过。
+- **没验证到的部分**：未启动浏览器执行 1366×768 和小于 760px 的视觉截图检查；未部署生产服务器。
+
+## 相关提交
+
+- `d79bdb1` style: 压缩档口入库码筛选工具栏 (#239)