Admin:顺运宝页与采集采购页搜索框收窄 #34

Closed
opened 2026-08-07 17:11:23 +08:00 by ila · 2 comments
Owner

基本信息

  • 类型:需求(界面微调)
  • 父级大工单:#14
  • 所属 MVP / 版本:#15 / MVP
  • 关联:#23(PDD 页已用同样做法)、#19(采集采购页)

要解决什么

#23 把 PDD 商品页的搜索框收到 30%、搜索按钮紧挨输入框,
但另外四个页面没动。#23 的归档里记了这条遗留:

另外四个页面的搜索框仍是撑满的,与 PDD 页不一致,
而 docs/admin/05 §2 要求五页布局统一。是否统一改过来待定。

现在确定:顺运宝数据页和采集采购页跟上,蝦皮数据页和客户端列表页暂不动。

做什么 / 不做什么

做:

  1. /syb 的「订单号」搜索框收到 30%,搜索按钮紧挨它
  2. /tasks 的「关键词」搜索框收到 30%,搜索按钮紧挨它
  3. 更新 .search-narrow 的注释和 docs/admin/05

不做:

  • 不改 /shopee 和 /clients(用户明确只要这两页)
  • 不改任何行为、路由、查询逻辑
  • 不改筛选下拉框的宽度

怎么做

复用 #23 已有的类,不要新写规则

admin/static/css/app.css 里已经有:

.toolbar input[type="text"].search-narrow { flex: 0 0 30%; }

[必须] 直接给这两个输入框加 class="search-narrow" 就行,
不要为这两页各写一条新 CSS 规则。多写一条就多一处将来要同步的地方。

[必须] 不得修改 .toolbar input[type="text"] 那条通用规则。
五个页面共用它,改了会把 /shopee 和 /clients 一起改掉,
而「不做」清单里排除了它们。

[必须] .search-narrow 的注释里现在写着「目前只有 PDD 页用」,
要改成实际情况(PDD / 顺运宝 / 采集采购三页),否则下一个人会以为
改它只影响 PDD 页。

搜索按钮靠左是收窄的自然结果

两个页面的搜索表单都是 .inline.grow,输入框继承 flex: 1 所以撑满,
把按钮顶到最右。加上 search-narrow 变成 flex: 0 0 30% 之后,
表单里没有会伸展的元素了,多余空间留在按钮之后,按钮自然贴着输入框。

[必须] 不要额外加对齐样式(margin-right: auto、justify-content 之类)。
不需要,而且会和 grow 的行为叠加出难预料的结果。

[必须] 两个表单上的 grow 类都要保留——它负责把右边的
「删除」按钮顶到工具条最右侧。去掉的话删除按钮会跑到搜索按钮旁边。

具体位置

admin/templates/syb/list.html:

<input id="q" type="text" name="order_no" value="{{.Keyword}}" placeholder="订单号">

admin/templates/task/list.html:

<input id="q" type="text" name="q" value="{{.Keyword}}"
       placeholder="任务编号 / 订单号 / PDD 商品 ID">

[注意] /tasks 的 placeholder 比较长(「任务编号 / 订单号 / PDD 商品 ID」)。
收到 30% 后可能显示不全。min-width: 160px 会兜底,但仍要在验收时
目视确认一下是不是短得看不出能搜什么。真不行就缩短 placeholder,
不要为此把宽度调回去——那样就和本工单的目的相反了。

预计修改文件

文件 改什么
admin/templates/syb/list.html 搜索框加 search-narrow
admin/templates/task/list.html 搜索框加 search-narrow
admin/static/css/app.css 更新 .search-narrow 的注释(哪几页在用)
docs/admin/05-ui-specification.md §6.1 和 §7.1 补上宽度说明;§5.1 那条说明改成三页共用

验收标准

  • /syb 搜索框明显变窄(约占搜索表单 30%)
  • /syb 搜索按钮紧挨输入框,删除按钮仍在最右
  • /tasks 搜索框明显变窄
  • /tasks 搜索按钮紧挨输入框,删除按钮仍在最右
  • /shopee 和 /clients 的搜索框宽度不变
  • 全局规则 .toolbar input[type="text"] 未被修改
  • 没有为这两页新增额外的 CSS 规则
  • .search-narrow 的注释已更新为三页共用
  • 两个页面的搜索功能不受影响(带关键词能筛出结果)
  • /tasks 的 placeholder 在收窄后仍能看出可以搜什么
  • 五个页面均返回 200
  • docs/admin/05 已同步
  • go vet / gofmt -l . / go test ./... 全过

怎么验证

cd D:\chengma\cmautobuy\admin
go vet ./...; gofmt -l .; go test ./... -count=1
go run .

浏览器逐个打开 /syb /tasks 目视确认两点,
再打开 /shopee /clients 确认宽度没变。

风险和回退

风险 应对
顺手改了全局规则,波及 /shopee /clients 已列为验收项,逐页比对
/tasks 的长 placeholder 显示不全 验收时目视;不行就缩短文案,不许调回宽度

回退:git revert,纯前端改动,无数据影响。

## 基本信息 - 类型:需求(界面微调) - 父级大工单:#14 - 所属 MVP / 版本:#15 / MVP - 关联:#23(PDD 页已用同样做法)、#19(采集采购页) ## 要解决什么 #23 把 PDD 商品页的搜索框收到 30%、搜索按钮紧挨输入框, 但另外四个页面没动。#23 的归档里记了这条遗留: > 另外四个页面的搜索框仍是撑满的,与 PDD 页不一致, > 而 `docs/admin/05` §2 要求五页布局统一。是否统一改过来待定。 现在确定:**顺运宝数据页和采集采购页跟上,蝦皮数据页和客户端列表页暂不动。** ## 做什么 / 不做什么 做: 1. `/syb` 的「订单号」搜索框收到 30%,搜索按钮紧挨它 2. `/tasks` 的「关键词」搜索框收到 30%,搜索按钮紧挨它 3. 更新 `.search-narrow` 的注释和 `docs/admin/05` 不做: - **不改 `/shopee` 和 `/clients`**(用户明确只要这两页) - 不改任何行为、路由、查询逻辑 - 不改筛选下拉框的宽度 ## 怎么做 ### 复用 #23 已有的类,不要新写规则 `admin/static/css/app.css` 里已经有: ```css .toolbar input[type="text"].search-narrow { flex: 0 0 30%; } ``` `[必须]` **直接给这两个输入框加 `class="search-narrow"` 就行**, 不要为这两页各写一条新 CSS 规则。多写一条就多一处将来要同步的地方。 `[必须]` **不得修改 `.toolbar input[type="text"]` 那条通用规则**。 五个页面共用它,改了会把 `/shopee` 和 `/clients` 一起改掉, 而「不做」清单里排除了它们。 `[必须]` `.search-narrow` 的注释里现在写着「目前只有 PDD 页用」, 要改成实际情况(PDD / 顺运宝 / 采集采购三页),否则下一个人会以为 改它只影响 PDD 页。 ### 搜索按钮靠左是收窄的自然结果 两个页面的搜索表单都是 `.inline.grow`,输入框继承 `flex: 1` 所以撑满, 把按钮顶到最右。加上 `search-narrow` 变成 `flex: 0 0 30%` 之后, 表单里没有会伸展的元素了,多余空间留在按钮之后,按钮自然贴着输入框。 `[必须]` **不要额外加对齐样式**(`margin-right: auto`、`justify-content` 之类)。 不需要,而且会和 `grow` 的行为叠加出难预料的结果。 `[必须]` 两个表单上的 `grow` 类**都要保留**——它负责把右边的 「删除」按钮顶到工具条最右侧。去掉的话删除按钮会跑到搜索按钮旁边。 ### 具体位置 `admin/templates/syb/list.html`: ```html <input id="q" type="text" name="order_no" value="{{.Keyword}}" placeholder="订单号"> ``` `admin/templates/task/list.html`: ```html <input id="q" type="text" name="q" value="{{.Keyword}}" placeholder="任务编号 / 订单号 / PDD 商品 ID"> ``` `[注意]` `/tasks` 的 placeholder 比较长(「任务编号 / 订单号 / PDD 商品 ID」)。 收到 30% 后可能显示不全。`min-width: 160px` 会兜底,但仍要在验收时 目视确认一下是不是短得看不出能搜什么。真不行就缩短 placeholder, **不要为此把宽度调回去**——那样就和本工单的目的相反了。 ## 预计修改文件 | 文件 | 改什么 | |---|---| | `admin/templates/syb/list.html` | 搜索框加 `search-narrow` | | `admin/templates/task/list.html` | 搜索框加 `search-narrow` | | `admin/static/css/app.css` | 更新 `.search-narrow` 的注释(哪几页在用) | | `docs/admin/05-ui-specification.md` | §6.1 和 §7.1 补上宽度说明;§5.1 那条说明改成三页共用 | ## 验收标准 - [ ] `/syb` 搜索框明显变窄(约占搜索表单 30%) - [ ] `/syb` 搜索按钮紧挨输入框,删除按钮仍在最右 - [ ] `/tasks` 搜索框明显变窄 - [ ] `/tasks` 搜索按钮紧挨输入框,删除按钮仍在最右 - [ ] **`/shopee` 和 `/clients` 的搜索框宽度不变** - [ ] **全局规则 `.toolbar input[type="text"]` 未被修改** - [ ] 没有为这两页新增额外的 CSS 规则 - [ ] `.search-narrow` 的注释已更新为三页共用 - [ ] 两个页面的搜索功能不受影响(带关键词能筛出结果) - [ ] `/tasks` 的 placeholder 在收窄后仍能看出可以搜什么 - [ ] 五个页面均返回 200 - [ ] `docs/admin/05` 已同步 - [ ] `go vet` / `gofmt -l .` / `go test ./...` 全过 ## 怎么验证 ```powershell cd D:\chengma\cmautobuy\admin go vet ./...; gofmt -l .; go test ./... -count=1 go run . ``` 浏览器逐个打开 `/syb` `/tasks` 目视确认两点, 再打开 `/shopee` `/clients` 确认宽度**没变**。 ## 风险和回退 | 风险 | 应对 | |---|---| | 顺手改了全局规则,波及 `/shopee` `/clients` | 已列为验收项,逐页比对 | | `/tasks` 的长 placeholder 显示不全 | 验收时目视;不行就缩短文案,不许调回宽度 | 回退:`git revert`,纯前端改动,无数据影响。
Author
Owner

实施完成,待验收

提交: 6a7cde2 feat: 顺运宝页与采集采购页搜索框收窄 (#34)

验证结果

go vet / gofmt -l . 无输出;go test ./... -count=1 全过。

服务端渲染逐页核对 search-narrow 出现次数:

页面 实际 期望
/pdd 1 1
/syb 1 1
/tasks 1 1
/shopee 0 0
/clients 0 0

其余:全局规则 .toolbar input[type="text"] 仍是 flex: 1; min-width: 160px 未被修改;app.css 里只有 1 条 search-narrow 规则,没有为这两页新增;两个表单的 grow 都保留;五页全 200;/tasks?q=COL 和 /syb?order_no=SO 搜索仍可用。

两处主动的判断

1. 缩短了 /tasks 的 placeholder,从「任务编号 / 订单号 / PDD 商品 ID」改成「任务编号 / 订单号 / 商品 ID」。工单里 [注意] 提到收窄后长文案可能显示不全,并写明「真不行就缩短 placeholder,不要为此把宽度调回去」。按这条处理了。

2. 文档规则从 §5.1 提到 §3.1。原来这条写在「PDD 商品页」那一节里,另外两页要用时根本看不到。现在放进「表格通用规则」,三页都指向它,并写清了哪两页暂未统一、为什么不要改通用规则、为什么不要额外加对齐样式。

未验证到的部分

  • 没有在真实浏览器里目视确认。只验证了服务端 HTML 和 CSS 规则,30% 的实际视觉宽度、/syb 的「订单号」和 /tasks 缩短后的 placeholder 是否还看得清,需要你打开页面看一眼。
  • 深色/浅色主题、1366×768、显示缩放未实测。

遗留

/shopee 和 /clients 的搜索框仍是撑满的(按你要求本次不动),与其余三页不一致。docs/admin/05 §3.1 已如实标注。

## 实施完成,待验收 **提交:** `6a7cde2` feat: 顺运宝页与采集采购页搜索框收窄 (#34) ### 验证结果 `go vet` / `gofmt -l .` 无输出;`go test ./... -count=1` 全过。 服务端渲染逐页核对 `search-narrow` 出现次数: | 页面 | 实际 | 期望 | |---|---|---| | `/pdd` | 1 | 1 | | `/syb` | 1 | 1 | | `/tasks` | 1 | 1 | | **`/shopee`** | **0** | 0 | | **`/clients`** | **0** | 0 | 其余:全局规则 `.toolbar input[type="text"]` 仍是 `flex: 1; min-width: 160px` 未被修改;`app.css` 里只有 1 条 `search-narrow` 规则,没有为这两页新增;两个表单的 `grow` 都保留;五页全 200;`/tasks?q=COL` 和 `/syb?order_no=SO` 搜索仍可用。 ### 两处主动的判断 **1. 缩短了 `/tasks` 的 placeholder**,从「任务编号 / 订单号 / PDD 商品 ID」改成「任务编号 / 订单号 / 商品 ID」。工单里 `[注意]` 提到收窄后长文案可能显示不全,并写明「真不行就缩短 placeholder,不要为此把宽度调回去」。按这条处理了。 **2. 文档规则从 §5.1 提到 §3.1**。原来这条写在「PDD 商品页」那一节里,另外两页要用时根本看不到。现在放进「表格通用规则」,三页都指向它,并写清了哪两页暂未统一、为什么不要改通用规则、为什么不要额外加对齐样式。 ### 未验证到的部分 - **没有在真实浏览器里目视确认**。只验证了服务端 HTML 和 CSS 规则,30% 的实际视觉宽度、`/syb` 的「订单号」和 `/tasks` 缩短后的 placeholder 是否还看得清,需要你打开页面看一眼。 - 深色/浅色主题、1366×768、显示缩放未实测。 ### 遗留 `/shopee` 和 `/clients` 的搜索框仍是撑满的(按你要求本次不动),与其余三页不一致。`docs/admin/05` §3.1 已如实标注。
Author
Owner

验收通过,关闭

用户实机确认通过。

  • 实现提交: 6a7cde2 feat: 顺运宝页与采集采购页搜索框收窄 (#34)
  • 归档提交: 34b4b54
  • 归档: docs/task/34-admin-顺运宝页与采集采购页搜索框收窄.md

11 项验收标准全部通过,其中三项防回归的:/shopee 与 /clients 不含 search-narrow(各 0 次);全局规则 .toolbar input[type="text"] 未被修改;app.css 里只有 1 条 search-narrow 规则,没有为这两页新增。

遗留

/shopee 和 /clients 的搜索框仍是撑满的(按要求本次不动),与其余三页不一致。docs/admin/05 §3.1 已如实标注为暂未统一。

## 验收通过,关闭 用户实机确认通过。 - **实现提交:** `6a7cde2` feat: 顺运宝页与采集采购页搜索框收窄 (#34) - **归档提交:** `34b4b54` - **归档:** `docs/task/34-admin-顺运宝页与采集采购页搜索框收窄.md` 11 项验收标准全部通过,其中三项防回归的:`/shopee` 与 `/clients` 不含 `search-narrow`(各 0 次);全局规则 `.toolbar input[type="text"]` 未被修改;`app.css` 里只有 1 条 `search-narrow` 规则,没有为这两页新增。 ### 遗留 `/shopee` 和 `/clients` 的搜索框仍是撑满的(按要求本次不动),与其余三页不一致。`docs/admin/05` §3.1 已如实标注为暂未统一。
ila closed this issue 2026-08-07 17:23:51 +08:00
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: chengma/cmautobuy#34