feat(api): /api/customers 加 q 文本搜索(昵称/备注/ID/手机号,LIKE转义) + /api/groups 加 q 群名搜索

Co-Authored-By: Claude <noreply@anthropic.com>

yunke-server/tests/test_api_customers.py

@@ -73,3 +73,78 @@ async def test_customers_today_send_receive(make_client):
     assert by_fid["f1"]["receive_today"] == 2
     assert by_fid["f2"]["send_today"] == 0
     assert by_fid["f2"]["receive_today"] == 0
+
+
+# ---------------------------------------------------------------------------
+# GET /api/customers?q= — 文本搜索(昵称/备注/friend_id/手机号,LIKE 通配转义)
+# 对齐云客通讯录搜索框「支持微信昵称、微信号、备注名、手机号搜索」。
+# ---------------------------------------------------------------------------
+
+async def _seed_q(session):
+    from app.db.models import Customer as C
+
+    session.add_all([
+        # 昵称命中「阿里」
+        C(channel="wechat", owner_account_id="o1", friend_id="wx_nick",
+          friend_nickname="阿里巴巴顾问"),
+        # 备注命中「阿里」
+        C(channel="wechat", owner_account_id="o1", friend_id="wx_remark",
+          friend_nickname="腾讯小哥", friend_remark="阿里系客户"),
+        # 不含词;手机号唯一可命中
+        C(channel="wechat", owner_account_id="o1", friend_id="wx_plain",
+          friend_nickname="网易产品", friend_remark="同行", phone="13900002222"),
+        # friend_id 唯一可命中;顺带另一手机号
+        C(channel="wechat", owner_account_id="o1", friend_id="wxid_ali888",
+          friend_nickname="字节跳动", phone="13866668888"),
+    ])
+    await session.commit()
+
+
+async def test_q_matches_nickname_and_remark(make_client):
+    """q=阿里 -> 昵称命中 + 备注命中(2 行),其余行不回。"""
+    client = await make_client(_seed_q)
+    r = await client.get("/api/customers", params={"q": "阿里"})
+    assert r.status_code == 200
+    body = r.json()
+    assert body["total"] == 2
+    assert {it["friend_id"] for it in body["items"]} == {"wx_nick", "wx_remark"}
+
+
+async def test_q_matches_friend_id_and_phone(make_client):
+    """q 命中 friend_id / phone 两列。"""
+    client = await make_client(_seed_q)
+    r = await client.get("/api/customers", params={"q": "ali888"})
+    assert r.status_code == 200
+    assert {it["friend_id"] for it in r.json()["items"]} == {"wxid_ali888"}
+    r2 = await client.get("/api/customers", params={"q": "1390000"})
+    assert r2.status_code == 200
+    assert {it["friend_id"] for it in r2.json()["items"]} == {"wx_plain"}
+
+
+async def test_q_empty_no_filter(make_client):
+    """q 空串 -> 不过滤,全量返回。"""
+    client = await make_client(_seed_q)
+    r = await client.get("/api/customers", params={"q": ""})
+    assert r.status_code == 200
+    assert r.json()["total"] == 4
+
+
+async def test_q_escapes_like_wildcards(make_client):
+    """q 里的 % 按字面匹配(镜像 messages 的 q 转义行为)。"""
+
+    async def seed(session):
+        from app.db.models import Customer as C
+
+        session.add_all([
+            C(channel="wechat", friend_id="wx_pct", friend_nickname="折扣100%off"),
+            C(channel="wechat", friend_id="wx_digit", friend_nickname="折扣1001off"),
+        ])
+        await session.commit()
+
+    client = await make_client(seed)
+    r = await client.get("/api/customers", params={"q": "100%"})
+    assert r.status_code == 200
+    body = r.json()
+    # 只命中字面含 "100%" 的行;不因 % 通配漏扩到 "1001"
+    assert body["total"] == 1
+    assert [it["friend_id"] for it in body["items"]] == ["wx_pct"]