3.0 KiB
3.0 KiB
ADDED Requirements
Requirement: Asset Exchange Generation Trace Display
The asset information page SHALL display exchange generation relationships exclusively from exchange_trace.previous_asset and exchange_trace.next_asset returned by GET /api/admin/assets/resolve/{identifier}. The frontend MUST NOT infer the exchange chain from asset status, generation, or exchange status.
Scenario: Display previous asset for a replacement asset
- GIVEN 用户正在查看资产信息页
- WHEN 解析响应包含非空的
exchange_trace.previous_asset - THEN 页面 MUST 显示“换货新资产”标签
- AND 页面 MUST 展示前代资产的标识符和换货单号
Scenario: Display next asset for a replaced asset
- GIVEN 用户正在查看资产信息页
- WHEN 解析响应包含非空的
exchange_trace.next_asset - THEN 页面 MUST 显示“已换出旧资产”标签
- AND 页面 MUST 展示后代资产的标识符和换货单号
Scenario: Display both relationships for an intermediate asset
- GIVEN 用户正在查看位于换货链中间的资产
- WHEN 解析响应同时包含非空的
previous_asset和next_asset - THEN 页面 MUST 同时展示“换货新资产”和“已换出旧资产”两个关联区域
Scenario: Hide absent exchange relationship
- GIVEN 用户正在查看资产信息页
- WHEN
previous_asset或next_asset为null、空值或未返回 - THEN 页面 MUST NOT 展示对应的换货关联区域
- AND 前端 MUST NOT 根据资产状态、世代编号、换货单状态或其他字段推导该区域
Requirement: Exchange Related Asset Navigation Authorization
The asset information page SHALL allow navigation to a related exchange asset only when that relationship item has can_view=true.
Scenario: Navigate to authorized related asset
- GIVEN 换货关联资产项的
can_view=true - WHEN 用户点击关联资产标识符
- THEN 系统 MUST 跳转到该关联资产的资产详情
- AND 跳转 MUST 使用关联项返回的
identifier
Scenario: Render unauthorized related asset as text
- GIVEN 换货关联资产项的
can_view=false - WHEN 页面渲染换货关联区域
- THEN 页面 MUST 展示关联资产标识符和换货单号
- AND 页面 MUST NOT 将关联资产标识符渲染为可点击跳转操作
Requirement: Exchange Trace Response Contract
The frontend asset resolve contract SHALL support optional exchange_trace.previous_asset and exchange_trace.next_asset items, each with asset_type, asset_id, identifier, exchange_no, and can_view.
Scenario: Read exchange trace response fields
- WHEN 前端解析
GET /api/admin/assets/resolve/{identifier}响应 - THEN 前端类型 MUST 支持
exchange_trace.previous_asset和exchange_trace.next_asset - AND 每个非空关联项 MUST 支持读取
asset_type、asset_id、identifier、exchange_no、can_view