后台商品管理

docs/api.md

@@ -57,6 +57,7 @@ API 规划以 [项目计划](project-plan.md) 第 10 章为准。
 - `GET /api/admin/orders`
 - `GET /api/admin/orders/{id}`
 - `GET /api/admin/orders/{id}/handoff-records`
+- `GET /api/admin/listings`
 - `GET /api/admin/listings/pending`
 - `POST /api/admin/listings/{id}/approve`
 - `POST /api/admin/listings/{id}/reject`
@@ -67,4 +68,4 @@ API 规划以 [项目计划](project-plan.md) 第 10 章为准。
 - `PUT /api/admin/system-configs/{key}`
 - `GET /api/admin/audit-logs`
 
-说明：`GET /api/admin/wallet/ledger` 支持按 `user_id`、`order_id`、`biz_type` 和 `limit` 查询最近资金流水。`GET /api/admin/audit-logs` 支持按 `actor_id`、`action`、`biz_type` 和 `limit` 查询最近审计日志。`/api/admin/*` 当前已使用独立后台登录，后续接入 RBAC 和 Casbin 权限后再按角色收紧访问控制。
+说明：`GET /api/admin/listings` 支持按 `owner_id`、`status`、`review_status` 和 `limit` 查询商品。`GET /api/admin/wallet/ledger` 支持按 `user_id`、`order_id`、`biz_type` 和 `limit` 查询最近资金流水。`GET /api/admin/audit-logs` 支持按 `actor_id`、`action`、`biz_type` 和 `limit` 查询最近审计日志。`/api/admin/*` 当前已使用独立后台登录，后续接入 RBAC 和 Casbin 权限后再按角色收紧访问控制。

docs/business-rules.md

@@ -129,6 +129,13 @@
 - 订单详情页 `/admin/orders/:id` 展示订单状态、双方用户、租期、交接记录和账号资产快照。
 - 当前后台订单管理先做只读能力，后续再补后台关闭订单、标记异常和客服介入操作。
 
+## 开发态商品管理
+
+- 商品管理接口为 `/api/admin/listings`，前端页面为 `/admin/listings`。
+- 后台可查看全量商品、号主、账号 ID、区服、平台、段位、哈夫币、时租、押金、商品状态和审核状态。
+- 当前支持按号主 ID、商品状态、审核状态和查询条数筛选。
+- 商品管理先做只读能力，强制下架、标记异常和后台改价等高风险操作后续接 RBAC 和审计后再做。
+
 ## 开发态审计日志
 
 - 审计日志接口为 `/api/admin/audit-logs`，前端页面为 `/admin/audit-logs`。