Files
yunke/yunke-server/migrations/versions/f7a8b9c0d1e2_customer_account_link_table.py
T

79 lines
3.1 KiB
Python
Raw Normal View History

"""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)