业务账号与用户映射

客户业务系统是账号主数据的来源。IM 中保存用于通信的用户资料与关系，不要求客户把原有登录流程、业务组织和权限迁入 IM 数据库。

用户 ID 的规则

服务端用户标识采用 64 位有符号整数。Flutter 公共模型以字符串承载用户 ID；业务系统使用 UUID 等字符串主键时，由业务后端维护对应的数值映射。

现有账号类型	接入方式
已有稳定数值 ID	确认范围和唯一性后建立对应关系
UUID、工号或其他字符串主键	业务后端维护稳定的一对一数值映射
多个业务系统接入	在业务层统一命名与 ID 分配，避免跨系统碰撞

IM 用户 ID 在账号生命周期内保持稳定。用户改名、换设备或重新登录时沿用同一标识。

同步哪些资料

基本接入通常同步 userId、account、nickname，以及按需提供的头像。首次创建需要明确账号状态。头像应使用部署环境允许的存储对象或自有地址。

业务组织与权限由客户系统管理，IM 保存通信所需的用户资料和关系。项目群成员通过相应群接口同步。

后端接口与示例见 同步用户与业务群。

账号状态与权限

资料同步与账号解封分别处理。受限账号需通过授权的管理流程解除限制后再登录，普通资料更新和登录续期保持原有访问限制。

好友关系、群角色与业务访问权限分别生效。业务卡片中的订单、工单和项目资料由客户业务接口校验当前账号的访问权限。

设备与登录态

deviceCode 是宿主维护的稳定设备标识，platform 使用服务端约定的平台值。各设备独立取得与用户、设备和平台匹配的 IM Session。

设备码用于绑定和失效管理，本身不是硬件身份认证。退出某台设备与撤销用户全部设备是不同动作；业务登录态和 IM 登录态应一并处理，详见 登录与 IM Session。

联调建议

使用普通用户、群管理员和受限用户串联改名、换设备、重复同步及权限处理流程，检查用户映射、角色展示和账号状态是否一致。