feat: migrate IM identity and snowflake primary keys

docs/IM-系统设计文档.md

@@ -205,7 +205,7 @@ HTTP API 通用规则：
 | 模块 | 目标表 | 主要职责 |
 | --- | --- | --- |
 | 好友关系 | `im_friendships`、`im_friend_requests`、`im_user_blocks` | 好友申请、同意、拒绝、删除、拉黑 |
-| 用户资料 | `im_user_profiles`、`im_user_privacy_settings` | 昵称、生日、签名、可见性和添加方式 |
+| 用户资料 | `im_users`、`im_user_profiles`、`im_user_privacy_settings` | 注册手机号、昵称、邮箱、生日、签名、可见性和添加方式 |
 | 群治理 | `im_group_settings`、`im_group_join_requests`、`im_group_announcements`、`im_group_mutes`、`im_group_admin_logs` | 入群审批、公告、禁言、管理员、转让群主 |
 | 群文件 | `im_group_files` | 群文件目录、搜索、删除权限 |
 | 收藏 | `im_favorites` | 收藏去重、分类、来源、搜索和分享 |
@@ -234,6 +234,10 @@ HTTP API 通用规则：
 | 群成员 | `im_group_members` | 群成员业务状态、角色、入群来源和操作者 |
 | 消息版本 | `im_message_revisions` | 编辑前内容、版本、操作者和变更原因 |
 
+MySQL 表主键约定：所有 `im_*` 基础表必须具有独立的 `id` 主键。`im_user_security`、`im_kvmeta`、用户资料/隐私、设备 Push Token、好友/黑名单、青少年模式以及群设置/公告已读/禁言等原先使用自然键或复合主键的表，统一改为服务端雪花算法生成的 `BIGINT id` 主键；原业务键保留唯一索引，查询和幂等语义不变。服务启动时会对当前租户库执行幂等迁移，为存量行补齐雪花 ID 后再替换主键。迁移期间不得同时运行不写入 `id` 的旧版本服务。
+
+用户身份字段约定：`im_users.phone` 是注册、密码找回和敏感操作验证使用的手机号真源，新注册必须提供已验证手机号；历史无手机号账号迁移后允许暂时为 `NULL`。`im_user_profiles.email` 仅是未验证的资料字段，不参与登录和密码找回。旧 `im_users.tags` 与 `im_usertags` 已废弃，启动迁移会先从已验证凭证和旧标签回填手机号/邮箱，再删除两者。群组发现仍使用 `im_topics.tags` 与 `im_topictags`，不受本次调整影响。
+
 ### 7.3 企业码与登录流程
 
 1. 未认证客户端先通过 `hi.tenant` 提交企业码；服务端只按 `im_tenant.code` 查找启用租户并把 `TenantID` 固定到 Session。
@@ -506,6 +510,8 @@ end_reason, created_at, updated_at
 | --- | --- |
 | 头像、昵称、签名 | User Public + `im_user_profiles` |
 | 生日、地区、性别 | `im_user_profiles`，按隐私设置返回 |
+| 注册手机号 | `im_users.phone`，仅账号安全流程内部使用 |
+| 邮箱 | `im_user_profiles.email`，仅作为个人资料，不作为认证凭证 |
 | 实名姓名、证件号 | 实名表加密存储，不进入 Public |
 | 群昵称 | `im_group_members`，按需投影到 Subscription Private |