feat(link): customer_account_link 账号↔客户多对多——共享好友员工维度对齐云客

用户报「Lily 好友数 36,点进员工客户页只有 12」。真机探明根因:那 24 个
是共享客户(同一人加多个员工),云客 per-employee 各算一个;而 customer
表 PK=friend_id 全局单行、归属 last-wins,其他员工名下必然「消失」。
抓取器本身每员工都拿全了(日志 declared=36 rows=36),丢在入库模型层。

- 新表 customer_account_link(渠道×账号×客户一行,per-relation 快照:
  昵称/备注/头像/手机号/收发计数/最近沟通/add_time/fromType/isDel)
- 写:repos.upsert_customer 随档案同事务维护(所有好友抓取路径一处挂全);
  新增 prune_customer_links 对账
- 读:/api/customers?owner_account_id= 改读 link(与云客 contacts_num 口径
  一致);该账号 link 为空时回退档案路径(过渡安全);与 dept/user 等
  过滤组合时维持旧行为;CustomerOut 透传 from_type
- 抓取器:friends/wa-friends 逐员工整批 upsert 后按名单对账(取满声明
  total 才删,防半份名单误删)
- 前端:StaffFriends 数据来源列优先 link 的 from_type

611 测试绿(link 新 6 例);本地验证空表回退/造数接管/from_type 透传。
上线后需重跑 friends+wa-friends 回填 link(存量关系无法从档案反推)。

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

yunke-server/app/db/models.py

@@ -262,6 +262,46 @@ class Customer(Base):
     )
 
 
+class CustomerAccountLink(Base):
+    """账号↔客户 多对多关联(customer_account_link,2026-09-08)。
+
+    ``customer`` 表 PK=``friend_id`` 全局一客户一行,归属=最后抓取员工
+    (last-wins)——共享客户(同一人加多个员工)在其他员工名下「消失」:
+    实测 Lily 云客好友 36 vs 镜像页面 12,24 个全在别的员工名下。云客
+    的口径是**每个账号各算一个**(per-employee 列表连备注/收发计数都按
+    关系各存一份);本表每个「渠道×账号×客户」一行,由
+    :func:`app.storage.repos.upsert_customer` 随档案同事务维护,员工维度
+    的列表/计数(`/api/customers?owner_account_id=`)读这里。
+
+    快照列为员工客户页所需(昵称/备注/头像 per-relation);全字段档案
+    (raw_json/60 列)仍在 ``customer`` 表按 friend_id 关联。
+    """
+
+    __tablename__ = "customer_account_link"
+
+    channel: Mapped[str] = mapped_column(String(16), primary_key=True)
+    owner_account_id: Mapped[str] = mapped_column(String(128), primary_key=True)
+    friend_id: Mapped[str] = mapped_column(String(128), primary_key=True)
+    # per-relation 展示快照(云客好友记录按员工各一份;备注是员工自己的)
+    friend_nickname: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    friend_remark: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    head_image_url: Mapped[str | None] = mapped_column(String(1024), nullable=True)
+    real_name: Mapped[str | None] = mapped_column(String(64), nullable=True)
+    phone: Mapped[str | None] = mapped_column(String(64), nullable=True)
+    last_chat_time: Mapped[int | None] = mapped_column(BigInteger, nullable=True)
+    add_time: Mapped[int | None] = mapped_column(BigInteger, nullable=True)
+    send_num: Mapped[int | None] = mapped_column(Integer, nullable=True)
+    receive_num: Mapped[int | None] = mapped_column(Integer, nullable=True)
+    message_count: Mapped[int | None] = mapped_column(Integer, nullable=True)
+    # 云客 fromType 代码(数据来源列;int,前端 fromTypeLabel 映射)
+    from_type: Mapped[int | None] = mapped_column(Integer, nullable=True)
+    # 同 customer.delete_flag 口径(int 0/1)
+    delete_flag: Mapped[int | None] = mapped_column(Integer, nullable=True)
+
+    fetched_at: Mapped[dt.datetime] = _fetched_at()
+    updated_at: Mapped[dt.datetime] = _updated_at()
+
+
 class ChatGroup(Base):
     """聊天群 — source: ``POST /wechatweb/chatroom/getChatroomList``.