即时通讯im产品系统

本项目为解决即时通讯（IM）自研需求而立项，旨在摆脱对第三方 IM 云服务的依赖，打造一套可自主掌控、数据私有化的社交聊天系统。随着社交类应用对消息实时性、可靠性及隐私合规要求日益提高，通用 SDK 难以满足深度定制与成本控制。本项目面向移动端社交场景，为用户提供单聊、群聊、好友关系、多媒体消息等完整社交沟通能力，业务背景覆盖熟人社交与陌生人添加，支撑高并发实时消息收发与离线可靠触达。

项目采用「内核 SDK + 业务层」分层架构，包含以下核心功能模块：一、账号与认证模块，支持注册、登录、密码管理、Token 持久化及多账号本地库物理隔离。二、消息模块，支持文本、图片、语音、视频、名片、@消息、消息引用、撤回、已读回执等多种消息类型。三、会话模块，提供会话列表、未读计数、左滑标记/删除、消息摘要。四、联系人与好友模块，支持好友申请、二维码加好友、扫码识别、拼音/首字母搜索。五、群聊模块，涵盖建群、群成员管理、群管理员、禁言、群公告事件、群二维码等完整群能力。六、多媒体模块，集成相册选择、拍照录像、图片裁剪压缩转 WebP、视频压缩抽帧、语音录制播放、媒体直传 COS 与本地缓存。七、消息可靠性模块，实现发送状态机、离线消息分页同步、断线重连补发、本地通知提醒。

技术栈上采用 Flutter 3.5 跨平台开发，Provider 做状态管理（全局 + 页面级），网络层基于 WebSocket 长连接实现实时消息双向通道、http/dio 处理接口与 COS 直传，本地存储以 sqflite（自带 sqlite3 原生库，按 uid 独立分库物理隔离）为消息主力存储，shared_preferences 持久化登录态。
实现亮点：一、可靠发送机制，设计全局单例 SendManager 管理消息从创建到成败的完整生命周期，每条消息独立并行不阻塞，有网 15s 等 ack、断网 30s 等重连、重连自动捞取本地未确认消息补发。二、离线同步引擎，上线收到 offline_ready 信号后分页拉取、单事务批量入库，解决"离线几万条瞬间砸库"的锁死难点，媒体仅入元数据懒加载避免带宽爆炸。三、WebSocket 稳定性，实现指数退避重连、断网暂停盲试、网络恢复重置退避即时重连，对标腾讯/融云连接策略。四、启动体验，原生 Splash 钉住覆盖引擎加载全过程，初始化只等本地毫秒级操作，消除白屏与空态闪现。难点在于弱网下消息不重不漏（唯一索引去重 + 本地 globalMaxMsgId 增量推导）与大批量离线消息的性能优化。