2.6 KiB
2.6 KiB
ADDED Requirements
Requirement: Shop Contact Phone Search Input
The shop management list SHALL provide a 联系电话 search input in its filter area. The input MUST only accept an 11-digit numeric phone number for a contact phone search.
Scenario: Enter a valid contact phone
- GIVEN 用户正在查看店铺列表筛选区
- WHEN 用户输入 11 位数字联系电话
- THEN 页面 MUST retain the entered phone number as the
contact_phonesearch value - AND 用户 MUST be able to use the existing query action to search
Scenario: Prevent invalid contact phone query
- GIVEN 用户输入的联系电话不是 11 位数字
- WHEN 用户发起查询
- THEN 页面 MUST NOT send a shop list request
- AND 页面 MUST display an input validation error
Requirement: Shop Contact Phone Query Contract
The shop management list SHALL use contact_phone as an optional exact-match query parameter of GET /api/admin/shops while preserving the existing shop pagination response structure.
Scenario: Query shops by exact contact phone
- GIVEN 用户输入有效的 11 位联系电话
- WHEN 用户发起店铺列表查询
- THEN 系统 MUST request
GET /api/admin/shopswithcontact_phoneequal to the entered value - AND 系统 MUST reset the list to the first page
- AND 页面 MUST render the returned shop pagination result
Scenario: Omit empty contact phone from query
- GIVEN 联系电话筛选值为空
- WHEN 系统加载店铺列表
- THEN 请求 MUST NOT include
contact_phone
Requirement: Shop Contact Phone Search Reset and Result States
The shop management list SHALL clear the contact phone search through its existing reset or input clear interaction without affecting other selected filters. The page SHALL preserve existing loading and empty-result behavior.
Scenario: Clear contact phone while preserving other filters
- GIVEN 用户已按联系电话和其他店铺条件查询
- WHEN 用户清空联系电话并重新查询
- THEN 系统 MUST request the list without
contact_phone - AND 系统 MUST retain the other selected filters
Scenario: Display no matching shop result
- GIVEN 用户输入有效的 11 位联系电话
- WHEN 店铺接口返回空分页结果
- THEN 页面 MUST render the existing empty table result state
Scenario: Display loading while querying contact phone
- WHEN 系统正在按有效联系电话请求店铺列表
- THEN 页面 MUST render the existing list loading state until the request completes