feat: customer full-field display (raw_json + cloud-matching list + all-fields drawer)

Backend:
- CustomerOut now exposes raw_json (verbatim upstream friend record) so the
  frontend can render every 云客 field without per-field structured columns.
- The verbatim blob round-trips via from_attributes; no model change needed.

Frontend:
- CustomerList table mirrors the 云客 客户列表 column set (头像/微信昵称/微信号/
  备注/真实姓名/手机/性别/地区/描述/销售员工/部门/来源/添加方式/添加时间/最近
  聊天/消息数/渠道). A readField helper reads the structured column first and
  falls back to raw_json.<camelCase>.
- Row click opens an all-fields drawer (right side) rendering EVERY field of
  the record with Chinese labels, grouped (基本信息/联系方式/归属员工与部门/时间
  与来源/消息统计/好友状态/其他). Timestamps format to local datetime, flags
  render 是/否, image URLs render as el-image thumbnails, empty values show —.
- New src/utils/customerFields.ts holds the camelCase→中文 label map, the
  structured-column alias map, group definitions, and value-type formatters;
  unknown raw_json keys auto-flow into an 其他 section so new upstream fields
  surface without code changes.
- Drawer 查看聊天记录 action navigates to /chat/:channel/:ownerId/:talkerId
  (owner_account_id + friend_id + channel), preserving the existing path.

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

yunke-server/app/api/schemas.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 import datetime as dt
-from typing import Generic, TypeVar
+from typing import Any, Generic, TypeVar
 
 from pydantic import BaseModel, ConfigDict
 
@@ -13,8 +13,10 @@ T = TypeVar("T")
 class CustomerOut(BaseModel):
     """Public Customer view — a subset of :class:`app.db.models.Customer`.
 
-    Only the fields the viewing frontend needs today are exposed; the verbatim
-    ``raw_json`` blob and internal audit columns stay server-side.
+    The structured columns power the list table; the verbatim upstream record
+    is exposed as ``raw_json`` so the frontend can render the full ~60-field
+    云客 客户详情 (all-fields drawer) without a second endpoint. The model's
+    ``raw_json`` column is picked up automatically via ``from_attributes``.
     """
 
     model_config = ConfigDict(from_attributes=True)
@@ -33,6 +35,11 @@ class CustomerOut(BaseModel):
     last_chat_time: int | None = None
     message_count: int | None = None
     version: str | None = None
+    # Verbatim upstream friend record (~60 camelCase fields). Surfaced so the
+    # all-fields drawer can render every column the 云客 source page shows
+    # (friendWxAlias/addTime/createTime/fromType/addType/...) without the
+    # backend having to enumerate each one as a structured column.
+    raw_json: dict[str, Any] | None = None
 
 
 class Page(BaseModel, Generic[T]):

yunke-server/tests/test_api_customer.py

@@ -56,6 +56,16 @@ async def client():
                     last_chat_time=2000,
                     message_count=10,
                     version="v1",
+                    # Verbatim upstream record — the all-fields drawer reads
+                    # these camelCase keys off raw_json.
+                    raw_json={
+                        "friendWxId": "wx_a",
+                        "friendWxAlias": "alice_wx",
+                        "friendWxNickname": "Alice",
+                        "saleName": "Tom",
+                        "addTime": 1690000000000,
+                        "fromType": "qrcode",
+                    },
                 ),
                 Customer(
                     friend_id="wx_b",
@@ -65,6 +75,7 @@ async def client():
                     friend_nickname="Bob",
                     last_chat_time=1000,
                     version="v1",
+                    raw_json=None,
                 ),
                 Customer(
                     friend_id="wa_c",
@@ -112,7 +123,8 @@ async def test_list_default_page_returns_all(client: AsyncClient):
     assert body["page_size"] == 20
     assert body["total"] == 3
     assert len(body["items"]) == 3
-    # Shape: every documented CustomerOut field is present.
+    # Shape: every documented CustomerOut field is present, including the
+    # verbatim upstream record exposed for the all-fields drawer.
     item = body["items"][0]
     for key in (
         "friend_id",
@@ -129,10 +141,37 @@ async def test_list_default_page_returns_all(client: AsyncClient):
         "last_chat_time",
         "message_count",
         "version",
+        "raw_json",
     ):
         assert key in item
 
 
+async def test_raw_json_serializes_verbatim(client: AsyncClient):
+    """``raw_json`` round-trips the verbatim upstream record unmolested.
+
+    Seeded ``wx_a`` carries a populated blob; ``wx_b``/``wa_c`` have NULL
+    raw_json (omitted on the model). Both must serialize: present dict vs null.
+    """
+    r = await client.get("/api/customers", params={"channel": "wechat"})
+    assert r.status_code == 200
+    by_id = {it["friend_id"]: it for it in r.json()["items"]}
+
+    # Populated blob: every camelCase key preserved verbatim.
+    alice = by_id["wx_a"]
+    assert alice["raw_json"] == {
+        "friendWxId": "wx_a",
+        "friendWxAlias": "alice_wx",
+        "friendWxNickname": "Alice",
+        "saleName": "Tom",
+        "addTime": 1690000000000,
+        "fromType": "qrcode",
+    }
+
+    # NULL raw_json serializes as JSON null (not omitted, not an error).
+    bob = by_id["wx_b"]
+    assert bob["raw_json"] is None
+
+
 async def test_list_filters_by_channel_wechat(client: AsyncClient):
     """``?channel=wechat`` -> total 2, both wechat rows."""
     r = await client.get(