feat(clothes): 支持通过社区公开穿搭只读查看衣物

新增 outfit_uuid 查询参数，非属主可通过社区公开穿搭查看衣物详情。同时调整点赞通知逻辑，仅在首次点赞时发送通知。
2026-09-16 02:28:59 +08:00
parent e9b9754b57
commit c2519c4b6d
5 changed files with 64 additions and 9 deletions
@@ -817,15 +817,19 @@ Authorization: Bearer <access_token>
 | --- | --- | --- | --- |
 | uuid | string | ✅ | 衣物 UUID |
 | share_uuid | string | 否 | 穿搭分享 UUID：非属主通过穿搭分享只读查看该分享穿搭内的衣物时必传 |
+| outfit_uuid | string | 否 | 穿搭 UUID：非属主通过**社区公开穿搭**只读查看该穿搭内的衣物时必传 |

 **响应** `data` = [衣物对象](#42-衣物对象-clothesitem)

 **业务逻辑（可见性）**

 - 属主：始终可见。
- 非属主：**仅当携带有效 `share_uuid`**（该分享正常、穿搭未被删除 / 封禁、且该衣物属于该分享的穿搭明细）时返回**只读**衣物信息；否则 `50005`。
+- 非属主：两个只读入口，**二选一携带即可**，都不携带则 `50005`。
+  1. `share_uuid`：该分享正常、穿搭未被删除 / 封禁、且该衣物属于该分享的穿搭明细 → 返回**只读**衣物信息。
+  2. `outfit_uuid`：该穿搭**公开可见**（`is_public=2` 且 `audit_status=2` 且 `status=1`，与 `GET /outfit/:uuid` 非属主口径一致）且该衣物属于该穿搭明细 → 返回**只读**衣物信息。
+- 只读场景下响应不含失败原因（`fail_reason` 恒为空）；通过 `outfit_uuid`（社区公开穿搭）进入时，属主**私有备注 `remark` 也不下发**，避免暴露给陌生人（`share_uuid` 好友分享场景保持原样）。

-**错误码**：`10000` 参数错误（uuid 为空）· `50000` 衣物不存在 · `50005` 无权操作该衣物 · `90103` 穿搭分享不存在（含穿搭已删除 / 已封禁）· `90104` 穿搭分享已取消
+**错误码**：`10000` 参数错误（uuid 为空）· `50000` 衣物不存在 · `50005` 无权操作该衣物（含未携带凭证 / 穿搭不可见 / 衣物不属于该穿搭）· `90103` 穿搭分享不存在（含穿搭已删除 / 已封禁）· `90104` 穿搭分享已取消

 ---