feat(huya): 礼包名默认空白,改用「常用礼包」备选按钮

新建协作单以前会把「上次选的礼包」自动填进礼包名(localStorage
huya.collab.lastGift)。连开几单同一个礼包是省事,但每开一单都顶着上一次的
选择,稍不留神就按错礼包建单;而且这个自动值会被草稿自动保存吃进去,
下次打开又「恢复」出来。

- 新建弹窗**不再预填礼包名**:删掉 lastGift 的读写,字段默认空白。
- 草稿恢复只带订单号 / 店铺 / CK / 截图 / 备注,礼包名留空;
  hasDraftContent() 也不再认「只有礼包名」的草稿(否则被旧逻辑自动填过的
  那份草稿会一直弹「已恢复上次未提交的草稿」)。
- 新增 GET /external-orders/gifts/frequent:按台账里的使用次数排序
  (次数相同看最近一次使用),新建与补资料弹窗在字段上方渲染最多 6 个按钮,
  只显示**当前礼包缓存里还有的**(活动换 SID 后老礼包会整批下架)。
- 新增 5 例测试,并做了 3 次反向验证(去掉次数排序 / 改成升序 / 去掉空名过滤)。

补资料弹窗的初值仍是「这一单自己的礼包」,详情抽屉编辑也不动 —— 那不是
「上次选的」。
This commit is contained in:
yml2213
2026-10-18 10:53:04 +08:00
parent c441b6c663
commit 21f7ee3f3f
8 changed files with 244 additions and 28 deletions
+18
View File
@@ -36,6 +36,7 @@ from ...permissions import get_user_permissions
from ...schemas import (
HuyaCollabCkPreviewOut,
HuyaCollabCkPreviewRequest,
HuyaCollabFrequentGiftOut,
HuyaCollabMetricOut,
HuyaCollabShopCreate,
HuyaCollabShopOut,
@@ -138,6 +139,23 @@ def external_orders_gifts(
return collab.list_gift_names(db)
@router.get(
"/external-orders/gifts/frequent",
response_model=list[HuyaCollabFrequentGiftOut],
)
def external_orders_frequent_gifts(
limit: int = Query(8, ge=1, le=20),
db: Session = Depends(get_db),
_current: User = Depends(require_permission("huya:collab:view")),
):
"""「常用礼包」:台账里用得最多的几个礼包名(新建/补资料时的快捷按钮)。
只回答"历史上哪些用得多";**当前活动还有没有这个礼包由前端拿礼包缓存比对**
—— 活动换 SID 后礼包列表会整批变,这里不该替前端猜。字号限制见 ``limit``。
"""
return collab.frequent_gift_names(db, limit=limit)
# --------------------------------------------------------------------------
# 店铺字典(新建协作单时点选;也支持自定义输入后自动登记)
# --------------------------------------------------------------------------
+11
View File
@@ -1389,6 +1389,17 @@ class HuyaCollabMetricOut(BaseModel):
created_at: datetime | None = None
class HuyaCollabFrequentGiftOut(BaseModel):
"""「常用礼包」:台账里出现过的礼包名 + 用过几次(新建/补资料时的快捷按钮)。
只有 ``name`` 与 ``used`` —— 当前活动还剩多少是礼包列表那边的事,
两边混在一起会让人以为这个数字是库存(见设计文档 §11.4 的 SID 教训)。
"""
name: str
used: int = 0
class HuyaExternalOrderActivityItemOut(BaseModel):
"""批量查询里的一行结论。"""
@@ -2217,6 +2217,37 @@ def list_gift_names(db: Session) -> list[str]:
)
def frequent_gift_names(db: Session, *, limit: int = 8) -> list[dict]:
"""台账里用得最多的礼包名(新建 / 补资料时的「常用礼包」快捷按钮)。
口径:**按出现次数降序,次数相同按最近一次使用(最大 id)降序**。
空礼包名不统计 —— 那是"还没填",不是一种礼包。
**这里不判断"当前活动还有没有这个礼包"**:活动换 SID 之后礼包列表会整批变
(见设计文档 §11.4),那件事由前端拿礼包缓存去比对;服务层只回答
"历史上哪些用得多"。
"""
rows = (
db.query(
HuyaExternalOrder.gift_name.label("name"),
func.count(HuyaExternalOrder.id).label("used"),
)
.filter(
HuyaExternalOrder.gift_name.isnot(None),
HuyaExternalOrder.gift_name != "",
)
.group_by(HuyaExternalOrder.gift_name)
.order_by(
func.count(HuyaExternalOrder.id).desc(),
func.max(HuyaExternalOrder.id).desc(),
)
.limit(max(1, min(20, int(limit))))
.all()
)
# 空名在 SQL 里已经滤掉(见上面的 filter):这里只做类型收口。
return [{"name": str(name), "used": int(used)} for name, used in rows]
# --------------------------------------------------------------------------
# CRUD
# --------------------------------------------------------------------------