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