浅念
d42895337d
用户报「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>
79 lines
3.1 KiB
Python
79 lines
3.1 KiB
Python
"""customer_account_link 账号↔客户多对多关联表
|
|
|
|
Revision ID: f7a8b9c0d1e2
|
|
Revises: e6f7a8b9c0d1
|
|
Create Date: 2026-09-08
|
|
|
|
内容
|
|
----
|
|
customer 表 PK=friend_id 全局一客户一行、归属=最后抓取员工(last-wins)。
|
|
共享客户(同一人加多个员工)在镜像里只挂在最后抓的员工名下——实测 Lily
|
|
云客好友 36,镜像员工客户页只有 12,其余 24 个全在另外 9 个员工名下
|
|
(2026-09-08 用户报「好友数与点进去的数量不一致」真机探明)。
|
|
|
|
云客口径是**每个账号各算一个**(per-employee 列表连备注/收发计数都按
|
|
关系各一份)。本表每个「渠道×账号×客户」一行:
|
|
|
|
- 写:repos.upsert_customer 随档案同事务维护(所有好友抓取路径一处挂全);
|
|
- 读:/api/customers?owner_account_id= 改读本表(员工维度列表/计数),
|
|
与云客 contacts_num 完全对齐;
|
|
- 对账:scrape_friends 逐员工整批 upsert 后删除该员工名下不在最新名单
|
|
里的 link(云客 isDel=0 返回当前好友,删链=已不是好友)。
|
|
|
|
**上线后需重跑 friends + wa-friends 各一次回填 link**(server:
|
|
`docker compose exec backend python scripts/scrape_via_page.py --entity friends`)
|
|
——存量关系无法从单行档案反推。
|
|
|
|
幂等:sa.inspect 先查表存在则跳过。SQLite/MySQL 通用。
|
|
"""
|
|
from collections.abc import Sequence
|
|
|
|
import sqlalchemy as sa
|
|
from alembic import op
|
|
|
|
# revision identifiers, used by Alembic.
|
|
revision: str = 'f7a8b9c0d1e2'
|
|
down_revision: str | Sequence[str] | None = 'e6f7a8b9c0d1'
|
|
branch_labels: str | Sequence[str] | None = None
|
|
depends_on: str | Sequence[str] | None = None
|
|
|
|
_TABLE = 'customer_account_link'
|
|
|
|
|
|
def _has_table(table: str) -> bool:
|
|
insp = sa.inspect(op.get_bind())
|
|
return table in insp.get_table_names()
|
|
|
|
|
|
def upgrade() -> None:
|
|
"""Upgrade schema."""
|
|
if _has_table(_TABLE):
|
|
return # 已建过(或先手工建过),幂等跳过
|
|
op.create_table(
|
|
_TABLE,
|
|
sa.Column('channel', sa.String(16), primary_key=True),
|
|
sa.Column('owner_account_id', sa.String(128), primary_key=True),
|
|
sa.Column('friend_id', sa.String(128), primary_key=True),
|
|
sa.Column('friend_nickname', sa.String(255), nullable=True),
|
|
sa.Column('friend_remark', sa.String(255), nullable=True),
|
|
sa.Column('head_image_url', sa.String(1024), nullable=True),
|
|
sa.Column('real_name', sa.String(64), nullable=True),
|
|
sa.Column('phone', sa.String(64), nullable=True),
|
|
sa.Column('last_chat_time', sa.BigInteger(), nullable=True),
|
|
sa.Column('add_time', sa.BigInteger(), nullable=True),
|
|
sa.Column('send_num', sa.Integer(), nullable=True),
|
|
sa.Column('receive_num', sa.Integer(), nullable=True),
|
|
sa.Column('message_count', sa.Integer(), nullable=True),
|
|
sa.Column('from_type', sa.Integer(), nullable=True),
|
|
sa.Column('delete_flag', sa.Integer(), nullable=True),
|
|
sa.Column('fetched_at', sa.DateTime(), nullable=True),
|
|
sa.Column('updated_at', sa.DateTime(), nullable=True),
|
|
)
|
|
|
|
|
|
def downgrade() -> None:
|
|
"""Downgrade schema."""
|
|
if not _has_table(_TABLE):
|
|
return
|
|
op.drop_table(_TABLE)
|