BUG-0376project-48低已修复backend-logic

列表接口只回 ID 不回展示字段 —— 前端到处拼名字/SKU 的结构性返工

发现：2026-10-01验证：2026-10-09置信度：85%

症状

多个页面各自实现『ID→名称』的拼凑逻辑；每加一个展示页就多一份映射代码，后端最终补 product_name/product_sku/component_name/component_sku 字段统一解决。

接口设计以存储结构为视角（给 ID），没有以渲染视角（给可读字段）设计；N+1 查询或前端映射的隐性成本被转嫁给每个消费方。

1) 列表/详情接口按『页面渲染所需』补展示字段（后端 join 一次，全体消费方受益）； 2) 接口评审用『前端拿到数据能直接渲染吗』做验收问题； 3) 权衡记录：展示字段是冗余但稳定（名称变更频率低），比每次额外查询划算。

grep -rn 'product_name\|sku' <前端各列表页> | 若存在多处本地映射即结构问题

BOM/Order 接口只回 product_id/component_id，前端展示名称/SKU 需要额外请求或本地映射

来源项目

project-48

标签

api-design, display-fields, join, frontend-n-plus-one, render-perspective