【自研】壹信Go高并发IM即时通讯源码｜仿TG聊天客服系统通话红包VIP｜离线推送保上TF

产品介绍：壹信 (Yixin) 您私有的企业级“微信”系统

一、 简单一句话，壹信是做什么的？

您有没有想过，拥有一套完全属于自己的“微信”？

在这个软件里，所有用户数据是您的，聊天记录存在您自己的服务器上，没人能封您的号，也没人能窥探您的商业机密。壹信（Yixin） 就是这样一套已经开发好的成品软件。

我们把写好的代码卖给您，您只需要把它装在服务器上，改个名字、换个Logo，它就是您的专属APP了。安卓手机、苹果手机、Windows电脑、苹果电脑，全部都能用，而且数据实时互通。

二、 为什么壹信比别人的系统更稳？

很多老板买源码最怕什么？怕用户一多，软件就卡死、转圈圈，甚至服务器直接瘫痪。壹信之所以敢卖这个价格，是因为我们在“地基”上下了大功夫。真正的万人并发，主要是看技术栈很多老版本代码虽然是Java都是几年前的SDK，老SDK虽然可以用但是现在的手机换代版本内核也在升级，会出现各种不兼容的问题，不能要求客户换个老手机进行使用吧！

为了让您听懂，我打几个比方：

1. 关于“64分片锁”：就像开了64个超市收银台

普通的聊天软件，就像一家超市只有一个收银台。平时还好，一旦来100个人同时结账，队伍就排长龙了，后面的人就卡住了。

壹信不一样，我们设计了“64分片锁”。这相当于我们一开门就为您准备了64个收银台。不管来了多少人发消息，系统会自动把他们分配到不同的窗口办理。所以，哪怕几万人同时聊天，感觉也像只有两个人在聊天一样顺畅，完全不拥堵。

2. 关于“多Worker处理”：雇佣了专业的快递分拣队

在这个系统后台，我们安排了两种“电子员工”：

• 接待员（注册Worker）：专门盯着门口，谁上线了，谁断网了，反应极快。
• 快递员（广播Worker）：专门负责送信。不管是群发通知，还是私聊，他们即使面对几万条消息，也能兵分多路，瞬间送到用户手机上。这就是为什么有些软件发消息一直转圈，而壹信全都是秒回。

3. 关于“Redis消息队列”：给服务器装了个大水库

如果突然搞活动，几十万条消息瞬间涌进来，普通服务器的硬盘根本来不及写进去，直接就崩了。

我们做了一个巨大的“水库”（Redis队列）。洪水（海量消息）来了，水库先兜住，然后慢慢放水给下游处理。这样既保证了每一滴水（每一条消息）都不丢失，又保护了您的服务器不会被冲垮。

三、 功能展示：不仅能聊天，还是个热闹的社区

拿到壹信这套软件，您不需要再开发任何功能，因为该有的我们都做好了

• 像打电话一样清晰的视频通话：我们接入了行业里最好的声网（Agora）技术。两个人视频聊天，就像打系统电话一样，画质高清，声音不卡，而且支持手机锁屏的时候直接弹出来电界面，不需要解锁手机就能接听。
• 不仅是聊天，还有“朋友圈”：软件里自带一个“社交广场”。您的用户可以像发微信朋友圈一样，发照片、发视频、写心情。其他人可以点赞、评论。这个功能非常重要，因为它能让用户没事也想打开您的APP刷一刷，留住用户。
• 超级群组管理：想做社群运营？没问题。您可以建几千人的大群，可以设置管理员，可以禁言那些发广告的人，还可以生成二维码海报，让大家扫码进群。
• 全能的消息体验：发图片、发语音、发视频、发文件、发定位，甚至不想让别人看见的消息，还可以撤回。所有主流社交软件有的体验，这里都有。

四、 给老板省钱的技术选择

我们在开发壹信时，特意选择了目前最先进的技术，目的就是为了帮您省钱：

1. 省服务器费（后端用 Go 语言）：Go语言运行效率极高，原本需要租5台服务器才能带动的用户量，用壹信的系统，可能2台服务器就够了。每年帮您省下的服务器租金都不是小数目。
2. 省人工费（前端用 Flutter）：这是一套谷歌的技术。简单说，以前开发APP，您得招一个安卓程序员，再招一个苹果程序员。现在用壹信的源码，您只需要招一个程序员，写一次代码，安卓和苹果端都能更新。这就是实打实的人力成本节省。

方案一：我想赶紧上线赚钱（私有化部署版）

• 适合谁：如果您不懂技术，也不想招程序员，只想赶紧有个自己的聊天软件投入运营。
• 我们做什么：您把服务器准备好，剩下的交给我们。我们帮您把软件装好，调试通，给您打包好安卓和苹果的安装包。您直接拿去推广就行。
• 缺点：不给源代码，后续如果您想改功能（比如把图标换个位置），得找我们要付费服务。

方案二：我想把技术抓在自己手里

• 适合谁：如果您打算长期做大，或者公司内部有技术团队，想拥有软件的绝对控制权。
• 我们做什么：把壹信这套系统的所有源代码（前端、后端、数据库设计图）全部给您，毫无保留。我们会教您的技术人员怎么部署，还提供一个“一键部署脚本”，哪怕是新手程序员也能轻松搞定。
• 优点：代码是您的资产。您想怎么改就怎么改，想加什么功能就加什么功能，完全不受制于人。

这不只是一套代码，这是您进入互联网社交领域的入场券。

不用花几十万组建团队研发半年，今天下单，明天您就能拥有一个属于自己的、能够承载百万用户的即时通讯平台。

更新日志

1V5.0 2026.06.27 近期功能收官版2壹信 IM V5.0 更新日志：深色体验、消息通话可靠性、推送补拉、H5 与后台运维全面收口3 4本版本围绕真实运营和上线交付做最后一轮功能补齐：既强化用户每天可感知的聊天、表情、资料、暗黑模式，也加固消息、通话、推送、后台处置和发布验证链路。5客户端体验升级6 7全局深色模式打磨：保留黑灰品牌方向，拆分深色界面控件与强调色，修复按钮、钱包、会员、设置、群资料、发现页等深色场景可读性。8 9    聊天视觉统一：消息列表、私聊详情、群聊详情、频道资料和群资料页按新版视觉收口，弱化突兀边框，强化内容层级与点击反馈。10 11    贴纸与表情能力增强：优化 WebP/GIF 表情包展示、安装包入口、表情面板和发送链路，让聊天表达更完整。12 13    资料与设置页升级：个人主页、资料背景、会员样式、昵称颜色和设置页头图兼容旧数据，老用户升级后也能正常展示。14 15    H5 / PC 响应式体验：统一使用根 Flutter Web 产物，适配 H5 与 PC 浏览器预览，演示入口切换到新版 imh5.66demo.cn。16 17可靠性与后台能力18 19    通话状态机加固：修复异常通话态、二次拉起、拒绝/取消/挂断后的状态清理问题，降低卡在通话中和无法再次发起的风险。20 21    后台强制结束通话：管理后台新增异常通话处置能力，可对超时、残留、异常通话记录进行人工强制结束，便于运营兜底。22 23    漏消息补拉机制：登录、启动、前后台恢复和 WebSocket 重连后主动同步漏掉的消息，减少弱网、后台和切换设备导致的消息缺口。24 25    华为 HMS 推送增强：保留已验证的系统通知 payload，补齐点击动作、前台展示和后台通知可达性，兼顾真机厂商通道。26 27    线上演示入口统一：官网、接口、后台、H5、客服和下载地址统一切换到 66demo 新域名，后台演示账号固定为 demo / demo123。

壹信 (Yixin) 企业级全平台 IM 即时通讯解决方案技术白皮书

1## 1. 产品综述2 3壹信是一款基于 **Golang + Flutter** 技术栈构建的云原生级即时通讯系统。采用“一次编写，四端运行”的跨平台策略，完美覆盖 iOS、Android、macOS 及 Windows。系统设计之初即对标百万级并发场景，通过精细化的锁设计、多级缓冲与异步消息队列，实现了高吞吐、低延迟的消息分发能力。4 5## 2. 核心架构解析：百万级并发的底层逻辑6 7为了突破传统单体 IM 的性能瓶颈，壹信重构了核心消息处理链路，采用 **“分片锁 + Actor模型变种 + 异步削峰”** 的组合架构。8 9### 2.1. 细粒度并发控制：64 分片锁设计10 11针对高并发场景下的资源竞争痛点，摒弃了传统的全局锁或粗粒度互斥锁，实施了细粒度的**分片锁（Sharded Locks）**策略：12 13* **FNV 哈希算法路由**：通过 FNV 算法将请求精确映射至 64 个独立的锁分片中。14* **锁竞争指数级降低**：理论上将锁竞争概率降低 64 倍，实现不同用户的操作完全并行，互不阻塞。15* **原子性保障**：在分片内部保证消息序号（SeqID）生成的原子性与严格有序，确保消息不乱序、不丢失。16 17### 2.2. 高吞吐并行处理模型：多 Worker 集群18 19引入类似 Reactor 模式的多 Worker 设计，将 **连接维护** 与 **业务逻辑** 解耦，配合 **50,000+ 容量的消息缓冲通道（Buffered Channel）**，从容应对流量洪峰。20 21* **Registry Workers (x8)**：专注于 WebSocket 连接的建立、鉴权与断开，保障连接层的极速响应。22* **Broadcast Workers (x16)**：专注于消息的扇出（Fan-out）与推送，实现并行化 I/O 操作。23 24### 2.3. 高可靠异步消息总线：Redis MQ25 26构建基于 Redis 的高性能消息队列，部署 **100+ Consumer Worker** 进行并行消费，不仅作为削峰填谷的缓冲区，更提供了企业级的消息可靠性保障：27 28* **QoS 优先级队列**：系统级通知与信令消息通过 Priority Queue 优先抢占资源，保障核心业务零延迟。29* **延迟队列（Delay Queue）**：基于时间轮或 ZSet 实现定时消息的毫秒级精准触达。30* **死信队列（DLQ）与指数退避**：异常消息自动进入死信队列，并采用指数退避算法（Exponential Backoff）进行自动重试，确保消息必达。31* **批量 I/O 优化**：Consumer 采用 Batch Processing 机制（100条/批），显著减少网络 I/O 与数据库 I/O 开销，提升整体吞吐量。32 33> **架构公式**：分片锁 (无锁化) + 多 Worker (并行计算) + Redis MQ (异步削峰) + 连接池复用 + MongoDB 分表 = **百万级稳定 IM 架构**

1## 3. 全栈技术选型2 3壹信采用了目前业界最前沿且经过验证的技术栈，兼顾了开发效率与运行性能。4 5| 层次 | 技术选型 | 核心优势 |6| --- | --- | --- |7| **客户端 (Client)** | **Flutter 3.x** | Google 新一代 UI 框架，一套代码编译四端，原生级渲染性能 (Impeller 引擎)。 |8| **状态管理** | **Riverpod** | 编译时安全、可组合的响应式状态管理，逻辑与 UI 完美分离。 |9| **本地存储** | **Isar** | 超高性能 NoSQL 本地数据库，全异步 ACID 事务，支持复杂查询。 |10| **服务端 (Server)** | **Go + Gin** | 协程 (Goroutine) 模型天然适配高并发 IM 场景，Gin 框架轻量且高效。 |11| **通讯协议** | **WebSocket** | 全双工实时通讯，二进制/Protobuf 协议封装（可选优化）。 |12| **核心存储** | **MySQL 8.0** | 强一致性业务数据存储（用户信息、关系链）。 |13| **海量存储** | **MongoDB** | 利用其 Sharding 特性存储海量消息历史，支持横向扩展。 |14| **缓存/中间件** | **Redis** | 消息队列、在线状态维护、高频热点数据缓存。 |15 16---17 18## 4. 业务功能矩阵19 20系统模块化设计，解耦清晰，具备高度可扩展性。21 22### 4.1 IM 核心交互23 24* **全场景覆盖**：支持单聊、普通群组、超大频道（Channel）。25* **富媒体消息**：文本、图片（缩略/原图）、语音（Opus编码）、视频、文件流。26* **交互增强**：支持消息物理撤回、引用回复（Reply）、@提及功能、全文检索。27* **状态同步**：消息已读/未读回执、多端实时同步、会话置顶。28 29### 4.2 RTC 音视频通讯30 31* **底层集成**：基于 **声网 (Agora) SDK** 深度封装，保障全球弱网环境下的低延迟与高可用。32* **系统级体验**：33* **iOS**：完整集成 **CallKit**，支持系统电话界面的接听与挂断。34* **Android**：支持锁屏下全屏来电唤起、后台保活。35* 支持画中画（PIP）与通话悬浮窗，实现多任务并行。36 37 38 39### 4.3 社群与发现40 41* **社交广场（Moments）**：类微信朋友圈架构，支持图文/视频发布流、点赞、评论、异步即时通知。42* **群组治理**：支持公开群/私密群模式，具备细粒度的 RBAC 权限管理（群主/管理员/成员），支持全员/单人禁言、群二维码/链接邀请机制。

1## 5. 交付与支持2 3为满足不同技术团队的需求，提供标准化的交付流程。4 5* **平台兼容性**：6*  iOS (iPhone / iPad)7* Android (Mobile / Tablet)8* macOS (Intel / Apple Silicon Universal)9* Windows 10 / 1110 11 12 13* **交付物清单 (源码版)**：14* Front-end: 完整 Flutter 工程源码15* Back-end: 完整 Golang 工程源码16* Docs: 完整的数据库 ER 图与架构设计文档17* Ops: Docker/Shell 一键部署脚本

1================================================================================2                     壹信 IM — 即时通讯系统 · 项目目录结构3================================================================================4 5全功能即时通讯系统，包含三大模块：6  • backend/  — Go 后端（Gin + GORM + MongoDB + Redis + WebSocket）7  • lib/      — Flutter 跨平台客户端（Riverpod + Isar + GoRouter）8  • admin/    — Vue3 管理后台（Vite + ElementPlus + Pinia + ECharts）9 10================================================================================11 12壹信im/13├── pubspec.yaml                                    # Flutter项目配置（依赖/资源声明）14├── analysis_options.yaml                           # Dart静态分析规则配置15├── build_apk.sh                                    # Android APK自动打包脚本16├── install_ios.sh                                  # iOS安装/部署脚本17├── README.md                                       # 项目说明文档18├── AUDIT_REPORT.md                                 # 安全审计报告19│20├── backend/                                        # ===== Go 后端服务 =====21│   ├── go.mod                                      # Go模块依赖声明22│   ├── config.yaml                                 # 本地开发环境配置（MySQL/MongoDB/Redis/JWT/声网）23│   ├── build.sh                                    # 后端交叉编译打包脚本24│   ├── README.md                                   # 后端说明文档25│   │26│   ├── cmd/server/27│   │   └── main.go                                 # 服务入口（初始化数据库/路由注册/WebSocket/优雅关闭）28│   │29│   ├── internal/30│   │   ├── config/31│   │   │   └── config.go                           # YAML配置加载与结构体映射32│   │   │33│   │   ├── cache/34│   │   │   └── cache.go                            # Redis缓存封装层（用户/会话/在线状态/限流）35│   │   │36│   │   ├── middleware/37│   │   │   └── middleware.go                        # HTTP中间件（JWT鉴权/CORS/限流/管理员权限）38│   │   │39│   │   ├── handlers/                               # --- HTTP 请求处理器 ---40│   │   │   ├── auth_handler.go                     # 用户认证（注册/登录/登出/Token刷新/修改密码）41│   │   │   ├── user_handler.go                     # 用户信息（资料/搜索/隐私设置/屏蔽/设备/会话管理）42│   │   │   ├── admin_handler.go                    # 管理员认证与信息管理43│   │   │   ├── user_mgmt_handler.go                # 后台用户管理（封禁/解封/数据统计）44│   │   │   ├── contact_handler.go                  # 联系人（添加/删除/好友请求/列表）45│   │   │   ├── chat_handler.go                     # 会话管理（创建私聊/群聊/频道/成员/置顶/免打扰）46│   │   │   ├── chat_mgmt_handler.go                # 后台会话管理（查看/解散群聊/移除成员）47│   │   │   ├── message_handler.go                  # 消息处理（发送/撤回/编辑/已读回执/转发/历史记录）48│   │   │   ├── moment_handler.go                   # 朋友圈（发布动态/点赞/评论/话题/违禁词过滤）49│   │   │   ├── moment_mgmt_handler.go              # 后台朋友圈管理（审核/删除/话题/敏感词管理）50│   │   │   ├── call_handler.go                     # 音视频通话（发起/接听/挂断/Agora Token生成）51│   │   │   ├── call_admin_handler.go               # 后台通话记录管理52│   │   │   ├── upload_handler.go                   # 文件上传（图片/视频/语音/头像/通用文件）53│   │   │   ├── setting_handler.go                  # 系统设置（全局配置/官方用户/群组/频道管理）54│   │   │   ├── stats_handler.go                    # 数据统计（用户增长/在线人数/消息量/类型分布）55│   │   │   ├── report_handler.go                   # 举报处理（提交/列表/审核处理）56│   │   │   ├── wallet_handler.go                   # 钱包（余额/充值/提现/转账/红包收发）57│   │   │   ├── wallet_admin_handler.go             # 后台钱包管理（审核提现/充值/交易记录/费率设置）58│   │   │   └── ws_handler.go                       # WebSocket连接升级与处理入口59│   │   │60│   │   ├── models/                                 # --- 数据模型 ---61│   │   │   ├── user.go                             # 用户模型（User/设备/隐私设置/屏蔽/会话）62│   │   │   ├── admin.go                            # 管理员模型（Admin/登录日志）63│   │   │   ├── chat.go                             # 会话模型（Chat/成员/用户会话/加入申请）64│   │   │   ├── message.go                          # 消息模型（MongoDB文档/消息类型常量）65│   │   │   ├── moment.go                           # 朋友圈模型（动态/评论/点赞/话题/敏感词）66│   │   │   ├── call.go                             # 通话记录模型67│   │   │   ├── report.go                           # 举报模型68│   │   │   ├── system_setting.go                   # 系统设置模型（配置/官方用户/群组/频道）69│   │   │   └── wallet.go                           # 钱包模型（钱包/交易/红包/转账/充值/提现）70│   │   │71│   │   ├── services/                               # --- 业务服务 ---72│   │   │   ├── message_service.go                  # 消息存储服务（MongoDB读写/月度分集合）73│   │   │   ├── push_service.go                     # APNs推送通知服务（HTTP/2 + JWT认证）74│   │   │   ├── agora_service.go                    # 声网Agora RTC Token生成服务75│   │   │   └── wallet_cron_service.go              # 钱包定时任务（红包/转账过期自动退款）76│   │   │77│   │   ├── mq/78│   │   │   └── queue.go                            # Redis消息队列（优先级/延迟/重试/死信队列）79│   │   │80│   │   ├── ws/                                     # --- WebSocket 基础设施 ---81│   │   │   ├── hub.go                              # 连接管理中心（64分片/广播/在线统计/成员鉴权）82│   │   │   └── client.go                           # 客户端连接（读写pump/心跳/订阅/正在输入）83│   │   │84│   │   └── shard/85│   │       └── shard_lock.go                       # 分片锁与分片Map（FNV哈希分散锁竞争）86│   │87│   ├── pkg/                                        # --- 公共工具包 ---88│   │   ├── jwt/89│   │   │   └── jwt.go                              # JWT Token生成与验证（用户+管理员双Token）90│   │   └── response/91│   │       └── response.go                         # 统一HTTP响应格式封装92│   │93│   ├── scripts/94│   │   └── init.sql                                # 数据库表结构初始化SQL95│   │96│   ├── deployments/                                # --- 容器化部署 ---97│   │   ├── Dockerfile                              # Go服务Docker镜像构建98│   │   └── docker-compose.yaml                     # 容器编排（MySQL+MongoDB+Redis+API）99│   │100│   └── baota/                                      # --- 宝塔面板部署 ---101│       ├── README.md                               # 宝塔部署说明102│       ├── config.yaml                             # 生产环境配置103│       ├── nginx.conf                              # Nginx反向代理（WebSocket/静态文件）104│       ├── init.sql                                # 生产环境数据库初始化105│       ├── start.sh                                # 启动脚本106│       ├── stop.sh                                 # 停止脚本107│       └── restart.sh                              # 重启脚本108│109│110├── lib/                                            # ===== Flutter 客户端 (Dart) =====111│   ├── main.dart                                   # 应用入口（Isar/桌面窗口/离线队列/后台服务初始化）112│   ├── app.dart                                    # 根组件（路由/主题/国际化/通话监听/推送回调）113│   │114│   ├── core/115│   │   ├── constants/116│   │   │   └── emoji_animations.dart               # Lottie动画表情名称与文件映射表117│   │   │118│   │   ├── i18n/119│   │   │   └── app_localizations.dart              # 国际化多语言（简中/繁中/英文）120│   │   │121│   │   ├── router/122│   │   │   └── app_router.dart                     # GoRouter路由表（~30个页面路径/认证重定向）123│   │   │124│   │   ├── services/125│   │   │   ├── api/                                # --- 网络层 ---126│   │   │   │   ├── api_client.dart                 # Dio HTTP客户端（请求去重/节流/Token刷新拦截器）127│   │   │   │   ├── auth_service.dart               # 认证服务（登录/注册/自动刷新/登出清理）128│   │   │   │   ├── chat_service.dart               # 聊天API（会话CRUD/消息发送/成员管理/~80个接口）129│   │   │   │   ├── system_settings_service.dart    # 系统设置API（全局配置/官方用户同步）130│   │   │   │   └── websocket_service.dart          # WebSocket（连接/指数退避重连/心跳/消息队列/订阅）131│   │   │   │132│   │   │   ├── storage/models/                     # --- 本地存储 (Isar) ---133│   │   │   │   ├── chat_model.dart                 # 聊天会话本地缓存模型134│   │   │   │   ├── message_model.dart              # 消息本地缓存模型135│   │   │   │   ├── user_model.dart                 # 用户本地缓存模型136│   │   │   │   └── hash_utils.dart                 # FNV-1a哈希（字符串→Isar ID）137│   │   │   │138│   │   │   ├── desktop/                            # --- 桌面端专属服务 ---139│   │   │   │   ├── window_service.dart             # 窗口管理（大小/位置/置顶/持久化）140│   │   │   │   ├── tray_service.dart               # 系统托盘图标与右键菜单141│   │   │   │   └── hotkey_service.dart             # 全局快捷键（Cmd+N新建/Cmd+W关闭等）142│   │   │   │143│   │   │   ├── background_service.dart             # Android后台保活前台服务144│   │   │   ├── call_service.dart                   # 声网Agora音视频通话（发起/接听/挂断/PiP）145│   │   │   ├── device_service.dart                 # 设备信息检测（ID/名称/类型）146│   │   │   ├── notification_sound_service.dart     # 消息通知音效与震动反馈147│   │   │   ├── desktop_notification_service.dart   # 桌面端系统通知（macOS/Windows/Linux）148│   │   │   ├── push_notification_service.dart      # iOS APNs推送通知（MethodChannel桥接）149│   │   │   ├── offline_message_queue.dart          # 离线消息队列（断网缓存/恢复重发/持久化）150│   │   │   ├── upload_service.dart                 # 文件上传服务（图片/视频/头像/压缩）151│   │   │   └── voice_record_service.dart           # 语音录制（振幅监测/时长控制）152│   │   │153│   │   ├── theme/                                  # --- 主题系统 ---154│   │   │   ├── app_colors.dart                     # 颜色常量（品牌色/状态色/头像渐变/聊天背景）155│   │   │   ├── app_text_styles.dart                # 排版样式定义156│   │   │   ├── app_theme.dart                      # Material3 ThemeData（亮色+暗色+OLED黑）157│   │   │   └── theme_provider.dart                 # 主题状态管理（模式切换/背景/持久化）158│   │   │159│   │   └── utils/                                  # --- 工具函数 ---160│   │       ├── image_compress_util.dart            # 图片压缩（>1MB自动JPEG压缩）161│   │       ├── link_utils.dart                     # URL解析与应用内浏览器打开162│   │       └── platform_utils.dart                 # 跨平台能力检测163│   │164│   ├── features/                                   # --- 功能模块（Feature-First架构）---165│   │   │166│   │   ├── auth/pages/                             # 认证模块167│   │   │   ├── login_page.dart                     #   登录页面168│   │   │   ├── register_page.dart                  #   注册页面169│   │   │   └── agreement_page.dart                 #   用户协议/隐私政策页面170│   │   │171│   │   ├── splash/pages/172│   │   │   └── splash_page.dart                    # 启动闪屏（自动登录/Token校验）173│   │   │174│   │   ├── home/pages/                             # 首页模块175│   │   │   ├── home_page.dart                      #   移动端主页（底部4Tab导航）176│   │   │   └── home_desktop_page.dart              #   桌面端主页（侧边栏导航）177│   │   │178│   │   ├── chat/                                   # 聊天模块（核心）179│   │   │   ├── pages/180│   │   │   │   ├── chat_page.dart                  #   聊天列表页（会话/文件夹/搜索入口）181│   │   │   │   ├── chat_detail_page.dart           #   聊天详情页（消息收发/输入栏/附件）182│   │   │   │   ├── channel_page.dart               #   频道页面183│   │   │   │   ├── channel_profile_page.dart       #   频道资料详情184│   │   │   │   ├── group_edit_page.dart            #   群组编辑185│   │   │   │   ├── group_profile_page.dart         #   群组资料详情186│   │   │   │   ├── user_profile_page.dart          #   用户资料页187│   │   │   │   ├── folder_edit_page.dart           #   文件夹编辑188│   │   │   │   ├── search_page.dart                #   全局搜索189│   │   │   │   └── qr_scanner_page.dart            #   二维码扫描190│   │   │   ├── providers/191│   │   │   │   ├── chat_provider.dart              #   聊天列表状态（~1750行，Isar缓存+WS事件）192│   │   │   │   ├── message_provider.dart           #   消息状态（~2100行，发送/接收/同步/媒体上传）193│   │   │   │   └── folder_provider.dart            #   文件夹状态194│   │   │   └── widgets/195│   │   │       ├── chat_list_item.dart             #   聊天列表项（头像/最后消息/未读/置顶）196│   │   │       ├── chat_input_bar.dart             #   输入栏（文字/表情/附件/语音按钮）197│   │   │       ├── message_bubble.dart             #   消息气泡（文字/图片/视频/语音/文件/红包/转账）198│   │   │       ├── message_context_menu.dart       #   消息长按菜单（复制/转发/撤回/删除/回复）199│   │   │       ├── emoji_picker.dart               #   表情选择器（Emoji/Lottie动画/贴纸Tab）200│   │   │       ├── chat_background.dart            #   聊天背景（24种渐变/纯色/自定义）201│   │   │       ├── create_sheets.dart              #   创建群聊/频道底部弹窗202│   │   │       └── voice_record_overlay.dart       #   语音录制浮层（按住说话/波形动画）203│   │   │204│   │   ├── contacts/                               # 联系人模块205│   │   │   ├── pages/206│   │   │   │   ├── contacts_page.dart              #   联系人列表（字母索引分组）207│   │   │   │   └── new_contact_page.dart           #   添加联系人208│   │   │   └── providers/209│   │   │       └── contact_provider.dart           #   联系人状态管理（Isar缓存）210│   │   │211│   │   ├── moments/                                # 朋友圈模块212│   │   │   ├── pages/213│   │   │   │   └── moments_page.dart               #   朋友圈页面（图文动态/视频/点赞/评论）214│   │   │   └── providers/215│   │   │       └── moment_provider.dart            #   朋友圈状态管理216│   │   │217│   │   ├── call/                                   # 通话模块218│   │   │   ├── pages/219│   │   │   │   ├── call_page.dart                  #   通话主页面（语音/视频界面）220│   │   │   │   └── incoming_call_page.dart         #   来电接听页（接听/拒绝/全屏）221│   │   │   └── widgets/222│   │   │       └── call_overlay.dart               #   通话悬浮窗（PiP画中画）223│   │   │224│   │   ├── settings/pages/                         # 设置模块225│   │   │   ├── settings_page.dart                  #   设置主页面226│   │   │   ├── profile_page.dart                   #   个人资料编辑227│   │   │   ├── chat_settings_page.dart             #   聊天设置（字体/气泡/背景）228│   │   │   ├── notification_settings_page.dart     #   通知设置（声音/振动/免打扰时段）229│   │   │   ├── privacy_settings_page.dart          #   隐私安全设置230│   │   │   ├── blocked_users_page.dart             #   黑名单管理231│   │   │   ├── personalization_page.dart           #   个性化（主题/聊天背景选择）232│   │   │   ├── devices_page.dart                   #   设备管理（在线设备列表/踢出）233│   │   │   ├── data_storage_page.dart              #   数据存储管理（缓存统计/清理）234│   │   │   ├── faq_page.dart                       #   常见问题235│   │   │   └── stickers_page.dart                  #   表情贴纸管理236│   │   │237│   │   └── wallet/                                 # 钱包模块238│   │       ├── pages/239│   │       │   ├── wallet_page.dart                #   钱包主页（余额/快捷入口）240│   │       │   ├── recharge_page.dart              #   充值页面（选择方式/上传凭证）241│   │       │   ├── withdraw_page.dart              #   提现页面（填写账户/手续费计算）242│   │       │   ├── transfer_page.dart              #   转账页面（选择对象/输入金额）243│   │       │   ├── send_red_packet_page.dart       #   发红包页面（普通/拼手气）244│   │       │   ├── set_pay_password_page.dart      #   支付密码设置/修改245│   │       │   └── transaction_list_page.dart      #   交易流水记录246│   │       ├── providers/247│   │       │   └── wallet_provider.dart            #   钱包状态（余额/交易列表）248│   │       ├── services/249│   │       │   └── wallet_service.dart             #   钱包API服务250│   │       └── widgets/251│   │           ├── amount_input.dart               #   金额输入组件252│   │           ├── pay_password_input.dart          #   6位支付密码输入253│   │           ├── red_packet_bubble.dart           #   红包消息气泡254│   │           └── transfer_bubble.dart            #   转账消息气泡255│   │256│   └── shared/                                     # --- 共享组件与工具 ---257│       ├── constants/258│       │   └── breakpoints.dart                    # 响应式断点（手机/平板/桌面）259│       ├── utils/260│       │   └── snackbar_utils.dart                 # SnackBar消息提示261│       └── widgets/262│           ├── avatar_widget.dart                  # 头像组件（网络缓存/渐变占位/圆形裁剪）263│           ├── avatar_crop_page.dart               # 头像裁剪页264│           ├── animated_emoji_text.dart            # 内联Lottie动画表情文字265│           ├── colored_name_widget.dart            # 彩色渐变用户名266│           ├── emoji_status_widget.dart            # 表情状态指示器267│           ├── empty_state.dart                    # 空状态占位（无数据/无网络）268│           ├── in_app_browser.dart                 # 应用内WebView269│           ├── link_preview_card.dart              # 链接预览卡片（OG元数据）270│           ├── official_badge.dart                 # 官方认证蓝标271│           ├── page_transitions.dart               # iOS风格页面转场动画272│           ├── platform_blur.dart                  # 跨平台毛玻璃效果273│           ├── shimmer_loading.dart                # 骨架屏闪烁加载274│           ├── visible_lottie.dart                 # 可见性感知Lottie（离屏暂停省性能）275│           └── desktop/276│               ├── auth_desktop_layout.dart        # 桌面端登录布局277│               ├── desktop_layout.dart             # 桌面端三栏布局278│               └── responsive_scaffold.dart        # 响应式Scaffold（自动适配）279│280│281├── admin/                                          # ===== Vue3 管理后台 =====282│   ├── package.json                                # NPM依赖（Vue3+ElementPlus+ECharts+TailwindCSS）283│   ├── vite.config.ts                              # Vite构建配置（代理/自动导入/Gzip压缩）284│   ├── tsconfig.json                               # TypeScript编译配置285│   ├── index.html                                  # HTML入口模板286│   ├── .env                                        # 环境变量（API地址/版本号/应用标题）287│   │288│   └── src/289│       ├── main.ts                                 # Vue应用入口（Store/Router/指令/错误处理）290│       ├── App.vue                                 # 根组件（ElementPlus/国际化/主题初始化）291│       │292│       ├── api/                                    # --- API 接口定义 ---293│       │   ├── admin.ts                            # 管理接口（用户/聊天/钱包/统计/朋友圈/举报）294│       │   ├── auth.ts                             # 认证接口（管理员登录/验证）295│       │   ├── report.ts                           # 举报管理接口296│       │   └── system-manage.ts                    # 系统管理接口297│       │298│       ├── router/                                 # --- 路由系统 ---299│       │   ├── index.ts                            # Router实例300│       │   ├── routesAlias.ts                      # 路径别名301│       │   ├── core/                               # 路由核心（懒加载/权限/动态注册/格式转换）302│       │   ├── guards/                             # 路由守卫（前置登录检查/后置进度条）303│       │   ├── modules/                            # 路由模块（仪表盘/系统管理/异常页）304│       │   └── routes/                             # 静态路由 + 动态权限路由305│       │306│       ├── store/modules/                          # --- Pinia 状态管理 ---307│       │   ├── user.ts                             # 用户（Token/角色/权限/持久化）308│       │   ├── menu.ts                             # 菜单（折叠/展开/权限过滤）309│       │   ├── setting.ts                          # 设置（主题/布局/语言）310│       │   ├── table.ts                            # 表格配置（列宽/分页/缓存）311│       │   └── worktab.ts                          # 工作标签页312│       │313│       ├── hooks/                                  # --- 组合式 Hooks ---314│       │   ├── usePermission.ts                    # 权限判断（按钮级/演示账号拦截）315│       │   └── core/                               # 核心Hooks（表格/图表/认证/主题/布局等）316│       │317│       ├── views/                                  # --- 页面视图 ---318│       │   ├── dashboard/console/                  # 控制台仪表盘319│       │   │   ├── index.vue                       #   主页（统计卡片/在线用户/增长图表）320│       │   │   └── modules/                        #   仪表盘子模块组件321│       │   │322│       │   ├── system/                             # 系统管理323│       │   │   ├── user/index.vue                  #   用户管理（列表/搜索/封禁/编辑）324│       │   │   ├── chat/index.vue                  #   会话管理（私聊/群聊/频道Tab切换）325│       │   │   ├── report/index.vue                #   举报管理（审核/处理）326│       │   │   ├── settings/index.vue              #   系统设置（全局配置/协议/官方用户）327│       │   │   └── user-center/index.vue           #   管理员个人中心328│       │   │329│       │   ├── moment/                             # 朋友圈管理330│       │   │   ├── list/index.vue                  #   动态列表（查看/删除/审核）331│       │   │   ├── topics/index.vue                #   话题管理（增删/启用/排序）332│       │   │   └── banned-words/index.vue          #   敏感词管理（添加/等级/过滤/拦截）333│       │   │334│       │   ├── wallet/                             # 钱包管理335│       │   │   ├── user-wallets/index.vue          #   用户钱包管理（余额调整/锁定/密码重置）336│       │   │   ├── recharge/index.vue              #   充值订单审核337│       │   │   ├── withdraw/index.vue              #   提现申请审核338│       │   │   ├── transfers/index.vue             #   转账记录管理339│       │   │   ├── red-packets/index.vue           #   红包记录管理340│       │   │   └── settings/index.vue              #   钱包参数设置（币种/过期时间/费率/二维码）341│       │   │342│       │   ├── call/list/index.vue                 # 通话记录管理343│       │   │344│       │   ├── auth/                               # 认证页面345│       │   │   ├── login/index.vue                 #   管理员登录346│       │   │   ├── register/index.vue              #   注册347│       │   │   └── forget-password/index.vue       #   忘记密码348│       │   │349│       │   └── exception/                          # 异常页350│       │       ├── 403/index.vue                   #   无权限351│       │       ├── 404/index.vue                   #   页面不存在352│       │       └── 500/index.vue                   #   服务器错误353│       │354│       ├── components/                             # --- 公共组件库 ---355│       │   ├── core/base/                          # 基础组件（Logo/SVG图标/回到顶部）356│       │   ├── core/cards/                         # 卡片组件（统计/图表/进度/时间线）357│       │   ├── core/charts/                        # ECharts图表（柱状/折线/环形/雷达/K线/地图）358│       │   ├── core/forms/                         # 表单组件（搜索栏/表格按钮/Excel导入导出）359│       │   ├── core/tables/                        # 表格组件（通用表格/表头操作栏）360│       │   ├── core/layouts/                       # 布局组件（面包屑/菜单/顶栏/标签页/设置面板）361│       │   ├── core/media/                         # 媒体组件（图片裁剪/视频播放）362│       │   └── core/text-effect/                   # 文字特效（数字滚动/文字滚动/节日横幅）363│       │364│       ├── utils/                                  # --- 工具函数 ---365│       │   ├── http/                               # Axios封装（拦截器/Token注入/错误处理）366│       │   ├── storage/                            # LocalStorage封装（过期/前缀/Key管理）367│       │   ├── navigation/                         # 路由导航工具368│       │   ├── table/                              # 表格工具（配置缓存/默认值）369│       │   ├── form/                               # 表单工具（响应式/校验规则）370│       │   ├── ui/                                 # UI工具（主题动画/颜色计算/Loading）371│       │   ├── sys/                                # 系统工具（错误处理/事件总线/版本检测）372│       │   └── socket/                             # WebSocket客户端（自动重连/心跳）373│       │374│       ├── types/                                  # TypeScript 类型定义375│       ├── enums/                                  # 枚举定义376│       ├── directives/                             # 自定义指令（v-auth权限/v-ripple水波纹）377│       ├── plugins/                                # 插件（ECharts按需引入）378│       ├── locales/                                # 国际化语言包（中/英）379│       └── assets/                                 # 静态资源（样式/SVG图标）380│381│382├── assets/                                         # ===== Flutter 静态资源 =====383│   ├── emoji/lottie/                               # 120+ Lottie动画表情JSON文件384│   ├── icons/                                      # 底部导航Tab图标（普通/选中态）385│   ├── images/backgrounds/                         # 聊天背景SVG386│   ├── fonts/                                      # 自定义字体（ZiHunXinQuHei）387│   ├── sounds/                                     # 通知音效（coin.mp3/crisp.mp3/ringtone.mp3）388│   └── stickers/                                   # 贴纸（红包/转账图标）389│390├── android/                                        # Android 平台配置391├── ios/                                            # iOS 平台配置392├── macos/                                          # macOS 桌面端配置393├── windows/                                        # Windows 桌面端配置394├── linux/                                          # Linux 桌面端配置395├── web/                                            # Web 平台配置396│397├── download/                                       # App 下载引导页398│   └── index.html                                  # 下载页面（含二维码/多平台链接）399│400└── test/401    └── widget_test.dart                            # Flutter Widget 测试

1# 功能核心分类明细2 3> 目标：按「Flutter 客户端 + Go 后端 + Vue 管理端」核心功能归类源码入口。4 5## 0) 工程/文档/脚本6- `README.md`: 项目总览、API 约定与模块说明7- `PROJECT_STRUCTURE.md`: 目录结构与功能说明书8- `安装依赖教程.txt`: 环境依赖与运行步骤9- `项目目录结构.txt`: 目录树说明（交付清单）10- `免责协议.txt`: 交付与使用免责条款11- `pubspec.yaml`: Flutter 依赖与资源声明12- `analysis_options.yaml`: Dart 静态分析规则13- `build_apk.sh`: Android 打包脚本14- `install_ios.sh`: iOS 安装/部署脚本15 16## 1) 基础设施（后端框架/鉴权/配置/中间件）17**后端（Go / Gin）**18- `backend/cmd/server/main.go`: 服务入口（初始化 MySQL/Mongo/Redis/WS）19- `backend/internal/config/config.go`: 配置加载与结构体映射20- `backend/internal/middleware/middleware.go`: JWT/CORS/限流/管理员权限21- `backend/pkg/jwt/jwt.go`: JWT 生成与校验22- `backend/pkg/response/response.go`: 统一响应体封装23 24**客户端（Flutter 基础能力）**25- `lib/main.dart`: Flutter 入口（初始化应用）26- `lib/app.dart`: App 壳（路由/主题/全局注入）27- `lib/core/router/app_router.dart`: 路由表（go_router）28- `lib/core/theme/`: 主题系统（明暗色/字体/Provider）29- `lib/core/i18n/app_localizations.dart`: 多语言加载30 31**管理端（Vue 基础能力）**32- `admin/src/main.ts`: 管理端入口（创建应用/挂载）33- `admin/src/router/`: 路由、菜单与权限守卫34- `admin/src/store/`: Pinia 状态模块（用户/菜单/设置）35- `admin/src/utils/http/`: Axios 封装与错误处理36 37## 2) 实时连接（WebSocket / 心跳 / 订阅 / 推送）38**后端（WS Hub）**39- `backend/internal/ws/hub.go`: 连接池、订阅映射、广播分发40- `backend/internal/ws/client.go`: 客户端读写、心跳、断线回收41- `backend/internal/handlers/ws_handler.go`: WS 升级与鉴权入口42 43**客户端（WS 连接维系）**44- `lib/core/services/api/websocket_service.dart`: 心跳/重连/订阅/事件分发45- `lib/core/services/offline_message_queue.dart`: 离线队列与网络恢复重发46 47**管理端（可选 WS）**48- `admin/src/utils/socket/index.ts`: 管理端 WS 客户端封装49 50## 3) 会话与聊天（Chat / 成员 / 置顶 / 静音）51**后端（MySQL 为主）**52- `backend/internal/handlers/chat_handler.go`: 会话创建、成员与权限管理53- `backend/internal/models/chat.go`: chats/chat_members/user_chats 表模型（MySQL）54 55**客户端（UI + 状态）**56- `lib/features/chat/pages/`: 会话列表/聊天详情/群频道资料等页面57- `lib/features/chat/providers/`: 会话与消息状态（Riverpod）58- `lib/features/chat/widgets/`: 聊天输入栏、消息气泡、表情等组件59- `lib/core/services/api/chat_service.dart`: 会话/消息 REST API 封装60- `lib/core/services/storage/models/chat_model.dart`: Isar 会话缓存61 62**管理端（会话管理）**63- `backend/internal/handlers/chat_mgmt_handler.go`: 后台会话管理 API64- `admin/src/views/`:（通常在）会话/用户相关管理页面65 66## 4) 消息系统（发送/序号/历史/已读/撤回/回应）67**后端（Mongo + Redis + MySQL）**68- `backend/internal/handlers/message_handler.go`: 发送、同步、已读、撤回等 API69- `backend/internal/services/message_service.go`: 入库、序号、广播、同步编排70- `backend/internal/models/message.go`: 消息文档模型（MongoDB）71- `backend/internal/cache/cache.go`: 消息序号/缓存/限流（Redis）72- `backend/internal/shard/shard_lock.go`: 分片锁（序号原子性）73- `backend/internal/mq/queue.go`: 异步队列（可用于延迟/补偿）74 75**客户端（本地缓存 + UI）**76- `lib/core/services/storage/models/message_model.dart`: Isar 消息缓存77- `lib/features/chat/widgets/message_bubble.dart`: 消息渲染入口（气泡）78- `lib/features/chat/providers/message_provider.dart`: 消息流与同步状态79 80## 5) 用户与联系人（资料/设备/黑名单/联系人）81**后端（MySQL）**82- `backend/internal/handlers/auth_handler.go`: 注册/登录/Token 刷新83- `backend/internal/handlers/user_handler.go`: 用户资料、隐私与设置84- `backend/internal/handlers/contact_handler.go`: 联系人/好友关系85- `backend/internal/models/user.go`: 用户表与关联模型（MySQL）86 87**客户端（页面/设置）**88- `lib/features/auth/pages/`: 登录/注册/协议页面89- `lib/features/contacts/pages/`: 联系人列表/添加联系人90- `lib/features/contacts/providers/contact_provider.dart`: 联系人状态管理91- `lib/core/services/api/auth_service.dart`: Token 与用户态管理92- `lib/core/services/device_service.dart`: 设备信息采集/上报93- `lib/features/settings/pages/blocked_users_page.dart`: 黑名单管理入口94 95**管理端**96- `backend/internal/handlers/user_mgmt_handler.go`: 后台用户管理 API97- `admin/src/views/auth/`: 管理端登录/注册页面98 99## 6) 动态/朋友圈（Moments：发布/点赞/评论/话题/屏蔽）100**后端（MySQL）**101- `backend/internal/handlers/moment_handler.go`: 动态发布/点赞/评论/话题等 API102- `backend/internal/handlers/moment_mgmt_handler.go`: 后台审核/删除/敏感词等103- `backend/internal/models/moment.go`: 动态与互动数据模型（MySQL）104 105**客户端**106- `lib/features/moments/pages/moments_page.dart`: 动态流页面107- `lib/features/moments/providers/moment_provider.dart`: 动态状态管理108 109**管理端**110- `admin/src/views/moment/`: 动态管理页面111 112## 7) 钱包与交易（余额/流水/充值/提现/转账/红包）113**后端（MySQL + Redis 定时/补偿）**114- `backend/internal/handlers/wallet_handler.go`: 钱包用户侧 API115- `backend/internal/handlers/wallet_admin_handler.go`: 后台审核/管理 API116- `backend/internal/models/wallet.go`: 钱包/交易/订单模型（MySQL）117- `backend/internal/services/wallet_cron_service.go`: 红包过期退款等定时任务118 119**客户端**120- `lib/features/wallet/wallet.dart`: 钱包模块聚合导出121- `lib/features/wallet/pages/`: 余额、流水、充值、提现、转账、红包页面122- `lib/features/wallet/providers/wallet_provider.dart`: 钱包状态管理123- `lib/features/wallet/services/wallet_service.dart`: 钱包 API 封装124- `lib/features/wallet/widgets/`: 金额/支付密码/红包气泡组件125 126**管理端**127- `admin/src/views/wallet/`: 钱包与交易管理页面128 129## 8) 音视频通话（Agora：发起/接听/挂断/来电）130**后端**131- `backend/internal/handlers/call_handler.go`: 通话创建/接听/拒绝/结束 API132- `backend/internal/handlers/call_admin_handler.go`: 通话记录后台管理133- `backend/internal/models/call.go`: 通话记录与状态模型（MySQL）134- `backend/internal/services/agora_service.go`: Agora Token/配置获取135 136**客户端**137- `lib/core/services/call_service.dart`: Agora/CallKit 业务封装138- `lib/features/call/pages/`: 通话中/来电页面139- `lib/features/call/widgets/call_overlay.dart`: 通话浮层组件140 141**管理端**142- `admin/src/views/call/`: 通话管理页面143 144## 9) 系统设置/统计/举报（运营能力）145**后端（MySQL）**146- `backend/internal/handlers/setting_handler.go`: 系统开关/配置管理 API147- `backend/internal/handlers/stats_handler.go`: 统计面板数据 API148- `backend/internal/handlers/report_handler.go`: 举报提交与处理 API149- `backend/internal/models/system_setting.go`: 系统设置模型（MySQL）150- `backend/internal/models/report.go`: 举报模型（MySQL）151 152**客户端**153- `lib/core/services/api/system_settings_service.dart`: 系统设置拉取154- `lib/features/settings/pages/`: 隐私/通知/设备/FAQ 等设置页155 156**管理端**157- `admin/src/api/system-manage.ts`: 系统管理相关接口封装158- `admin/src/views/system/`: 系统配置、日志或权限相关页面159- `admin/src/views/dashboard/`: 运营统计面板160 161## 10) 媒体与文件（上传/压缩/语音/通知）162**后端**163- `backend/internal/handlers/upload_handler.go`: 图片/视频/文件上传 API164- `backend/uploads/` 上传文件落盘目录165 166**客户端**167- `lib/core/services/upload_service.dart`: 上传服务封装168- `lib/core/utils/image_compress_util.dart`: 图片压缩169- `lib/core/services/voice_record_service.dart`: 语音录制/编码170- `lib/core/services/notification_sound_service.dart`: 通知音效播放171- `lib/core/services/push_notification_service.dart`: 推送注册与处理172- `lib/core/services/desktop_notification_service.dart`: 桌面通知封装173 174## 11) 部署与初始化（Docker/宝塔/SQL）175- `backend/deployments/`: Dockerfile + docker-compose（含 DB 组件）176- `backend/scripts/init.sql`: MySQL 初始化表结构177- `backend/baota/`: 宝塔部署脚本、配置与一键服务文件

感谢您的来访，获取更多精彩文章请收藏。