2026年底特惠IM即时通讯/聊天/通话/社交/新款即时通讯GO语言开发源码原生四端

产品介绍：壹信 (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，您得招一个安卓程序员，再招一个苹果程序员。现在用壹信的源码，您只需要招一个程序员，写一次代码，安卓和苹果端都能更新。这就是实打实的人力成本节省。

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

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

方案二：我想把技术抓在自己手里（源码交付版 – 10万元）现在特惠仅仅出售4W元过完年涨价

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

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

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

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

## 1. 产品综述

壹信是一款基于 **Golang + Flutter** 技术栈构建的云原生级即时通讯系统。采用“一次编写，四端运行”的跨平台策略，完美覆盖 iOS、Android、macOS 及 Windows。系统设计之初即对标百万级并发场景，通过精细化的锁设计、多级缓冲与异步消息队列，实现了高吞吐、低延迟的消息分发能力。

## 2. 核心架构解析：百万级并发的底层逻辑

为了突破传统单体 IM 的性能瓶颈，壹信重构了核心消息处理链路，采用 **“分片锁 + Actor模型变种 + 异步削峰”** 的组合架构。

### 2.1. 细粒度并发控制：64 分片锁设计

针对高并发场景下的资源竞争痛点，摒弃了传统的全局锁或粗粒度互斥锁，实施了细粒度的**分片锁（Sharded Locks）**策略：

* **FNV 哈希算法路由**：通过 FNV 算法将请求精确映射至 64 个独立的锁分片中。
* **锁竞争指数级降低**：理论上将锁竞争概率降低 64 倍，实现不同用户的操作完全并行，互不阻塞。
* **原子性保障**：在分片内部保证消息序号（SeqID）生成的原子性与严格有序，确保消息不乱序、不丢失。

### 2.2. 高吞吐并行处理模型：多 Worker 集群

引入类似 Reactor 模式的多 Worker 设计，将 **连接维护** 与 **业务逻辑** 解耦，配合 **50,000+ 容量的消息缓冲通道（Buffered Channel）**，从容应对流量洪峰。

* **Registry Workers (x8)**：专注于 WebSocket 连接的建立、鉴权与断开，保障连接层的极速响应。
* **Broadcast Workers (x16)**：专注于消息的扇出（Fan-out）与推送，实现并行化 I/O 操作。

### 2.3. 高可靠异步消息总线：Redis MQ

构建基于 Redis 的高性能消息队列，部署 **100+ Consumer Worker** 进行并行消费，不仅作为削峰填谷的缓冲区，更提供了企业级的消息可靠性保障：

* **QoS 优先级队列**：系统级通知与信令消息通过 Priority Queue 优先抢占资源，保障核心业务零延迟。
* **延迟队列（Delay Queue）**：基于时间轮或 ZSet 实现定时消息的毫秒级精准触达。
* **死信队列（DLQ）与指数退避**：异常消息自动进入死信队列，并采用指数退避算法（Exponential Backoff）进行自动重试，确保消息必达。
* **批量 I/O 优化**：Consumer 采用 Batch Processing 机制（100条/批），显著减少网络 I/O 与数据库 I/O 开销，提升整体吞吐量。

> **架构公式**：分片锁 (无锁化) + 多 Worker (并行计算) + Redis MQ (异步削峰) + 连接池复用 + MongoDB 分表 = **百万级稳定 IM 架构**

## 3. 全栈技术选型

壹信采用了目前业界最前沿且经过验证的技术栈，兼顾了开发效率与运行性能。

| 层次 | 技术选型 | 核心优势 |
| --- | --- | --- |
| **客户端 (Client)** | **Flutter 3.x** | Google 新一代 UI 框架，一套代码编译四端，原生级渲染性能 (Impeller 引擎)。 |
| **状态管理** | **Riverpod** | 编译时安全、可组合的响应式状态管理，逻辑与 UI 完美分离。 |
| **本地存储** | **Isar** | 超高性能 NoSQL 本地数据库，全异步 ACID 事务，支持复杂查询。 |
| **服务端 (Server)** | **Go + Gin** | 协程 (Goroutine) 模型天然适配高并发 IM 场景，Gin 框架轻量且高效。 |
| **通讯协议** | **WebSocket** | 全双工实时通讯，二进制/Protobuf 协议封装（可选优化）。 |
| **核心存储** | **MySQL 8.0** | 强一致性业务数据存储（用户信息、关系链）。 |
| **海量存储** | **MongoDB** | 利用其 Sharding 特性存储海量消息历史，支持横向扩展。 |
| **缓存/中间件** | **Redis** | 消息队列、在线状态维护、高频热点数据缓存。 |

---

## 4. 业务功能矩阵

系统模块化设计，解耦清晰，具备高度可扩展性。

### 4.1 IM 核心交互

* **全场景覆盖**：支持单聊、普通群组、超大频道（Channel）。
* **富媒体消息**：文本、图片（缩略/原图）、语音（Opus编码）、视频、文件流。
* **交互增强**：支持消息物理撤回、引用回复（Reply）、@提及功能、全文检索。
* **状态同步**：消息已读/未读回执、多端实时同步、会话置顶。

### 4.2 RTC 音视频通讯

* **底层集成**：基于 **声网 (Agora) SDK** 深度封装，保障全球弱网环境下的低延迟与高可用。
* **系统级体验**：
* **iOS**：完整集成 **CallKit**，支持系统电话界面的接听与挂断。
* **Android**：支持锁屏下全屏来电唤起、后台保活。
* 支持画中画（PIP）与通话悬浮窗，实现多任务并行。



### 4.3 社群与发现

* **社交广场（Moments）**：类微信朋友圈架构，支持图文/视频发布流、点赞、评论、异步即时通知。
* **群组治理**：支持公开群/私密群模式，具备细粒度的 RBAC 权限管理（群主/管理员/成员），支持全员/单人禁言、群二维码/链接邀请机制。

## 5. 交付与支持

为满足不同技术团队的需求，提供标准化的交付流程。

* **平台兼容性**：
*  iOS (iPhone / iPad)
* Android (Mobile / Tablet)
* macOS (Intel / Apple Silicon Universal)
* Windows 10 / 11



* **交付物清单 (源码版)**：
* Front-end: 完整 Flutter 工程源码
* Back-end: 完整 Golang 工程源码
* Docs: 完整的数据库 ER 图与架构设计文档
* Ops: Docker/Shell 一键部署脚本

================================================================================
                     壹信 IM — 即时通讯系统 · 项目目录结构
================================================================================

全功能即时通讯系统，包含三大模块：
  • backend/  — Go 后端（Gin + GORM + MongoDB + Redis + WebSocket）
  • lib/      — Flutter 跨平台客户端（Riverpod + Isar + GoRouter）
  • admin/    — Vue3 管理后台（Vite + ElementPlus + Pinia + ECharts）

================================================================================

壹信im/
├── pubspec.yaml                                    # Flutter项目配置（依赖/资源声明）
├── analysis_options.yaml                           # Dart静态分析规则配置
├── build_apk.sh                                    # Android APK自动打包脚本
├── install_ios.sh                                  # iOS安装/部署脚本
├── README.md                                       # 项目说明文档
├── AUDIT_REPORT.md                                 # 安全审计报告
│
├── backend/                                        # ===== Go 后端服务 =====
│   ├── go.mod                                      # Go模块依赖声明
│   ├── config.yaml                                 # 本地开发环境配置（MySQL/MongoDB/Redis/JWT/声网）
│   ├── build.sh                                    # 后端交叉编译打包脚本
│   ├── README.md                                   # 后端说明文档
│   │
│   ├── cmd/server/
│   │   └── main.go                                 # 服务入口（初始化数据库/路由注册/WebSocket/优雅关闭）
│   │
│   ├── internal/
│   │   ├── config/
│   │   │   └── config.go                           # YAML配置加载与结构体映射
│   │   │
│   │   ├── cache/
│   │   │   └── cache.go                            # Redis缓存封装层（用户/会话/在线状态/限流）
│   │   │
│   │   ├── middleware/
│   │   │   └── middleware.go                        # HTTP中间件（JWT鉴权/CORS/限流/管理员权限）
│   │   │
│   │   ├── handlers/                               # --- HTTP 请求处理器 ---
│   │   │   ├── auth_handler.go                     # 用户认证（注册/登录/登出/Token刷新/修改密码）
│   │   │   ├── user_handler.go                     # 用户信息（资料/搜索/隐私设置/屏蔽/设备/会话管理）
│   │   │   ├── admin_handler.go                    # 管理员认证与信息管理
│   │   │   ├── user_mgmt_handler.go                # 后台用户管理（封禁/解封/数据统计）
│   │   │   ├── contact_handler.go                  # 联系人（添加/删除/好友请求/列表）
│   │   │   ├── chat_handler.go                     # 会话管理（创建私聊/群聊/频道/成员/置顶/免打扰）
│   │   │   ├── chat_mgmt_handler.go                # 后台会话管理（查看/解散群聊/移除成员）
│   │   │   ├── message_handler.go                  # 消息处理（发送/撤回/编辑/已读回执/转发/历史记录）
│   │   │   ├── moment_handler.go                   # 朋友圈（发布动态/点赞/评论/话题/违禁词过滤）
│   │   │   ├── moment_mgmt_handler.go              # 后台朋友圈管理（审核/删除/话题/敏感词管理）
│   │   │   ├── call_handler.go                     # 音视频通话（发起/接听/挂断/Agora Token生成）
│   │   │   ├── call_admin_handler.go               # 后台通话记录管理
│   │   │   ├── upload_handler.go                   # 文件上传（图片/视频/语音/头像/通用文件）
│   │   │   ├── setting_handler.go                  # 系统设置（全局配置/官方用户/群组/频道管理）
│   │   │   ├── stats_handler.go                    # 数据统计（用户增长/在线人数/消息量/类型分布）
│   │   │   ├── report_handler.go                   # 举报处理（提交/列表/审核处理）
│   │   │   ├── wallet_handler.go                   # 钱包（余额/充值/提现/转账/红包收发）
│   │   │   ├── wallet_admin_handler.go             # 后台钱包管理（审核提现/充值/交易记录/费率设置）
│   │   │   └── ws_handler.go                       # WebSocket连接升级与处理入口
│   │   │
│   │   ├── models/                                 # --- 数据模型 ---
│   │   │   ├── user.go                             # 用户模型（User/设备/隐私设置/屏蔽/会话）
│   │   │   ├── admin.go                            # 管理员模型（Admin/登录日志）
│   │   │   ├── chat.go                             # 会话模型（Chat/成员/用户会话/加入申请）
│   │   │   ├── message.go                          # 消息模型（MongoDB文档/消息类型常量）
│   │   │   ├── moment.go                           # 朋友圈模型（动态/评论/点赞/话题/敏感词）
│   │   │   ├── call.go                             # 通话记录模型
│   │   │   ├── report.go                           # 举报模型
│   │   │   ├── system_setting.go                   # 系统设置模型（配置/官方用户/群组/频道）
│   │   │   └── wallet.go                           # 钱包模型（钱包/交易/红包/转账/充值/提现）
│   │   │
│   │   ├── services/                               # --- 业务服务 ---
│   │   │   ├── message_service.go                  # 消息存储服务（MongoDB读写/月度分集合）
│   │   │   ├── push_service.go                     # APNs推送通知服务（HTTP/2 + JWT认证）
│   │   │   ├── agora_service.go                    # 声网Agora RTC Token生成服务
│   │   │   └── wallet_cron_service.go              # 钱包定时任务（红包/转账过期自动退款）
│   │   │
│   │   ├── mq/
│   │   │   └── queue.go                            # Redis消息队列（优先级/延迟/重试/死信队列）
│   │   │
│   │   ├── ws/                                     # --- WebSocket 基础设施 ---
│   │   │   ├── hub.go                              # 连接管理中心（64分片/广播/在线统计/成员鉴权）
│   │   │   └── client.go                           # 客户端连接（读写pump/心跳/订阅/正在输入）
│   │   │
│   │   └── shard/
│   │       └── shard_lock.go                       # 分片锁与分片Map（FNV哈希分散锁竞争）
│   │
│   ├── pkg/                                        # --- 公共工具包 ---
│   │   ├── jwt/
│   │   │   └── jwt.go                              # JWT Token生成与验证（用户+管理员双Token）
│   │   └── response/
│   │       └── response.go                         # 统一HTTP响应格式封装
│   │
│   ├── scripts/
│   │   └── init.sql                                # 数据库表结构初始化SQL
│   │
│   ├── deployments/                                # --- 容器化部署 ---
│   │   ├── Dockerfile                              # Go服务Docker镜像构建
│   │   └── docker-compose.yaml                     # 容器编排（MySQL+MongoDB+Redis+API）
│   │
│   └── baota/                                      # --- 宝塔面板部署 ---
│       ├── README.md                               # 宝塔部署说明
│       ├── config.yaml                             # 生产环境配置
│       ├── nginx.conf                              # Nginx反向代理（WebSocket/静态文件）
│       ├── init.sql                                # 生产环境数据库初始化
│       ├── start.sh                                # 启动脚本
│       ├── stop.sh                                 # 停止脚本
│       └── restart.sh                              # 重启脚本
│
│
├── lib/                                            # ===== Flutter 客户端 (Dart) =====
│   ├── main.dart                                   # 应用入口（Isar/桌面窗口/离线队列/后台服务初始化）
│   ├── app.dart                                    # 根组件（路由/主题/国际化/通话监听/推送回调）
│   │
│   ├── core/
│   │   ├── constants/
│   │   │   └── emoji_animations.dart               # Lottie动画表情名称与文件映射表
│   │   │
│   │   ├── i18n/
│   │   │   └── app_localizations.dart              # 国际化多语言（简中/繁中/英文）
│   │   │
│   │   ├── router/
│   │   │   └── app_router.dart                     # GoRouter路由表（~30个页面路径/认证重定向）
│   │   │
│   │   ├── services/
│   │   │   ├── api/                                # --- 网络层 ---
│   │   │   │   ├── api_client.dart                 # Dio HTTP客户端（请求去重/节流/Token刷新拦截器）
│   │   │   │   ├── auth_service.dart               # 认证服务（登录/注册/自动刷新/登出清理）
│   │   │   │   ├── chat_service.dart               # 聊天API（会话CRUD/消息发送/成员管理/~80个接口）
│   │   │   │   ├── system_settings_service.dart    # 系统设置API（全局配置/官方用户同步）
│   │   │   │   └── websocket_service.dart          # WebSocket（连接/指数退避重连/心跳/消息队列/订阅）
│   │   │   │
│   │   │   ├── storage/models/                     # --- 本地存储 (Isar) ---
│   │   │   │   ├── chat_model.dart                 # 聊天会话本地缓存模型
│   │   │   │   ├── message_model.dart              # 消息本地缓存模型
│   │   │   │   ├── user_model.dart                 # 用户本地缓存模型
│   │   │   │   └── hash_utils.dart                 # FNV-1a哈希（字符串→Isar ID）
│   │   │   │
│   │   │   ├── desktop/                            # --- 桌面端专属服务 ---
│   │   │   │   ├── window_service.dart             # 窗口管理（大小/位置/置顶/持久化）
│   │   │   │   ├── tray_service.dart               # 系统托盘图标与右键菜单
│   │   │   │   └── hotkey_service.dart             # 全局快捷键（Cmd+N新建/Cmd+W关闭等）
│   │   │   │
│   │   │   ├── background_service.dart             # Android后台保活前台服务
│   │   │   ├── call_service.dart                   # 声网Agora音视频通话（发起/接听/挂断/PiP）
│   │   │   ├── device_service.dart                 # 设备信息检测（ID/名称/类型）
│   │   │   ├── notification_sound_service.dart     # 消息通知音效与震动反馈
│   │   │   ├── desktop_notification_service.dart   # 桌面端系统通知（macOS/Windows/Linux）
│   │   │   ├── push_notification_service.dart      # iOS APNs推送通知（MethodChannel桥接）
│   │   │   ├── offline_message_queue.dart          # 离线消息队列（断网缓存/恢复重发/持久化）
│   │   │   ├── upload_service.dart                 # 文件上传服务（图片/视频/头像/压缩）
│   │   │   └── voice_record_service.dart           # 语音录制（振幅监测/时长控制）
│   │   │
│   │   ├── theme/                                  # --- 主题系统 ---
│   │   │   ├── app_colors.dart                     # 颜色常量（品牌色/状态色/头像渐变/聊天背景）
│   │   │   ├── app_text_styles.dart                # 排版样式定义
│   │   │   ├── app_theme.dart                      # Material3 ThemeData（亮色+暗色+OLED黑）
│   │   │   └── theme_provider.dart                 # 主题状态管理（模式切换/背景/持久化）
│   │   │
│   │   └── utils/                                  # --- 工具函数 ---
│   │       ├── image_compress_util.dart            # 图片压缩（>1MB自动JPEG压缩）
│   │       ├── link_utils.dart                     # URL解析与应用内浏览器打开
│   │       └── platform_utils.dart                 # 跨平台能力检测
│   │
│   ├── features/                                   # --- 功能模块（Feature-First架构）---
│   │   │
│   │   ├── auth/pages/                             # 认证模块
│   │   │   ├── login_page.dart                     #   登录页面
│   │   │   ├── register_page.dart                  #   注册页面
│   │   │   └── agreement_page.dart                 #   用户协议/隐私政策页面
│   │   │
│   │   ├── splash/pages/
│   │   │   └── splash_page.dart                    # 启动闪屏（自动登录/Token校验）
│   │   │
│   │   ├── home/pages/                             # 首页模块
│   │   │   ├── home_page.dart                      #   移动端主页（底部4Tab导航）
│   │   │   └── home_desktop_page.dart              #   桌面端主页（侧边栏导航）
│   │   │
│   │   ├── chat/                                   # 聊天模块（核心）
│   │   │   ├── pages/
│   │   │   │   ├── chat_page.dart                  #   聊天列表页（会话/文件夹/搜索入口）
│   │   │   │   ├── chat_detail_page.dart           #   聊天详情页（消息收发/输入栏/附件）
│   │   │   │   ├── channel_page.dart               #   频道页面
│   │   │   │   ├── channel_profile_page.dart       #   频道资料详情
│   │   │   │   ├── group_edit_page.dart            #   群组编辑
│   │   │   │   ├── group_profile_page.dart         #   群组资料详情
│   │   │   │   ├── user_profile_page.dart          #   用户资料页
│   │   │   │   ├── folder_edit_page.dart           #   文件夹编辑
│   │   │   │   ├── search_page.dart                #   全局搜索
│   │   │   │   └── qr_scanner_page.dart            #   二维码扫描
│   │   │   ├── providers/
│   │   │   │   ├── chat_provider.dart              #   聊天列表状态（~1750行，Isar缓存+WS事件）
│   │   │   │   ├── message_provider.dart           #   消息状态（~2100行，发送/接收/同步/媒体上传）
│   │   │   │   └── folder_provider.dart            #   文件夹状态
│   │   │   └── widgets/
│   │   │       ├── chat_list_item.dart             #   聊天列表项（头像/最后消息/未读/置顶）
│   │   │       ├── chat_input_bar.dart             #   输入栏（文字/表情/附件/语音按钮）
│   │   │       ├── message_bubble.dart             #   消息气泡（文字/图片/视频/语音/文件/红包/转账）
│   │   │       ├── message_context_menu.dart       #   消息长按菜单（复制/转发/撤回/删除/回复）
│   │   │       ├── emoji_picker.dart               #   表情选择器（Emoji/Lottie动画/贴纸Tab）
│   │   │       ├── chat_background.dart            #   聊天背景（24种渐变/纯色/自定义）
│   │   │       ├── create_sheets.dart              #   创建群聊/频道底部弹窗
│   │   │       └── voice_record_overlay.dart       #   语音录制浮层（按住说话/波形动画）
│   │   │
│   │   ├── contacts/                               # 联系人模块
│   │   │   ├── pages/
│   │   │   │   ├── contacts_page.dart              #   联系人列表（字母索引分组）
│   │   │   │   └── new_contact_page.dart           #   添加联系人
│   │   │   └── providers/
│   │   │       └── contact_provider.dart           #   联系人状态管理（Isar缓存）
│   │   │
│   │   ├── moments/                                # 朋友圈模块
│   │   │   ├── pages/
│   │   │   │   └── moments_page.dart               #   朋友圈页面（图文动态/视频/点赞/评论）
│   │   │   └── providers/
│   │   │       └── moment_provider.dart            #   朋友圈状态管理
│   │   │
│   │   ├── call/                                   # 通话模块
│   │   │   ├── pages/
│   │   │   │   ├── call_page.dart                  #   通话主页面（语音/视频界面）
│   │   │   │   └── incoming_call_page.dart         #   来电接听页（接听/拒绝/全屏）
│   │   │   └── widgets/
│   │   │       └── call_overlay.dart               #   通话悬浮窗（PiP画中画）
│   │   │
│   │   ├── settings/pages/                         # 设置模块
│   │   │   ├── settings_page.dart                  #   设置主页面
│   │   │   ├── profile_page.dart                   #   个人资料编辑
│   │   │   ├── chat_settings_page.dart             #   聊天设置（字体/气泡/背景）
│   │   │   ├── notification_settings_page.dart     #   通知设置（声音/振动/免打扰时段）
│   │   │   ├── privacy_settings_page.dart          #   隐私安全设置
│   │   │   ├── blocked_users_page.dart             #   黑名单管理
│   │   │   ├── personalization_page.dart           #   个性化（主题/聊天背景选择）
│   │   │   ├── devices_page.dart                   #   设备管理（在线设备列表/踢出）
│   │   │   ├── data_storage_page.dart              #   数据存储管理（缓存统计/清理）
│   │   │   ├── faq_page.dart                       #   常见问题
│   │   │   └── stickers_page.dart                  #   表情贴纸管理
│   │   │
│   │   └── wallet/                                 # 钱包模块
│   │       ├── pages/
│   │       │   ├── wallet_page.dart                #   钱包主页（余额/快捷入口）
│   │       │   ├── recharge_page.dart              #   充值页面（选择方式/上传凭证）
│   │       │   ├── withdraw_page.dart              #   提现页面（填写账户/手续费计算）
│   │       │   ├── transfer_page.dart              #   转账页面（选择对象/输入金额）
│   │       │   ├── send_red_packet_page.dart       #   发红包页面（普通/拼手气）
│   │       │   ├── set_pay_password_page.dart      #   支付密码设置/修改
│   │       │   └── transaction_list_page.dart      #   交易流水记录
│   │       ├── providers/
│   │       │   └── wallet_provider.dart            #   钱包状态（余额/交易列表）
│   │       ├── services/
│   │       │   └── wallet_service.dart             #   钱包API服务
│   │       └── widgets/
│   │           ├── amount_input.dart               #   金额输入组件
│   │           ├── pay_password_input.dart          #   6位支付密码输入
│   │           ├── red_packet_bubble.dart           #   红包消息气泡
│   │           └── transfer_bubble.dart            #   转账消息气泡
│   │
│   └── shared/                                     # --- 共享组件与工具 ---
│       ├── constants/
│       │   └── breakpoints.dart                    # 响应式断点（手机/平板/桌面）
│       ├── utils/
│       │   └── snackbar_utils.dart                 # SnackBar消息提示
│       └── widgets/
│           ├── avatar_widget.dart                  # 头像组件（网络缓存/渐变占位/圆形裁剪）
│           ├── avatar_crop_page.dart               # 头像裁剪页
│           ├── animated_emoji_text.dart            # 内联Lottie动画表情文字
│           ├── colored_name_widget.dart            # 彩色渐变用户名
│           ├── emoji_status_widget.dart            # 表情状态指示器
│           ├── empty_state.dart                    # 空状态占位（无数据/无网络）
│           ├── in_app_browser.dart                 # 应用内WebView
│           ├── link_preview_card.dart              # 链接预览卡片（OG元数据）
│           ├── official_badge.dart                 # 官方认证蓝标
│           ├── page_transitions.dart               # iOS风格页面转场动画
│           ├── platform_blur.dart                  # 跨平台毛玻璃效果
│           ├── shimmer_loading.dart                # 骨架屏闪烁加载
│           ├── visible_lottie.dart                 # 可见性感知Lottie（离屏暂停省性能）
│           └── desktop/
│               ├── auth_desktop_layout.dart        # 桌面端登录布局
│               ├── desktop_layout.dart             # 桌面端三栏布局
│               └── responsive_scaffold.dart        # 响应式Scaffold（自动适配）
│
│
├── admin/                                          # ===== Vue3 管理后台 =====
│   ├── package.json                                # NPM依赖（Vue3+ElementPlus+ECharts+TailwindCSS）
│   ├── vite.config.ts                              # Vite构建配置（代理/自动导入/Gzip压缩）
│   ├── tsconfig.json                               # TypeScript编译配置
│   ├── index.html                                  # HTML入口模板
│   ├── .env                                        # 环境变量（API地址/版本号/应用标题）
│   │
│   └── src/
│       ├── main.ts                                 # Vue应用入口（Store/Router/指令/错误处理）
│       ├── App.vue                                 # 根组件（ElementPlus/国际化/主题初始化）
│       │
│       ├── api/                                    # --- API 接口定义 ---
│       │   ├── admin.ts                            # 管理接口（用户/聊天/钱包/统计/朋友圈/举报）
│       │   ├── auth.ts                             # 认证接口（管理员登录/验证）
│       │   ├── report.ts                           # 举报管理接口
│       │   └── system-manage.ts                    # 系统管理接口
│       │
│       ├── router/                                 # --- 路由系统 ---
│       │   ├── index.ts                            # Router实例
│       │   ├── routesAlias.ts                      # 路径别名
│       │   ├── core/                               # 路由核心（懒加载/权限/动态注册/格式转换）
│       │   ├── guards/                             # 路由守卫（前置登录检查/后置进度条）
│       │   ├── modules/                            # 路由模块（仪表盘/系统管理/异常页）
│       │   └── routes/                             # 静态路由 + 动态权限路由
│       │
│       ├── store/modules/                          # --- Pinia 状态管理 ---
│       │   ├── user.ts                             # 用户（Token/角色/权限/持久化）
│       │   ├── menu.ts                             # 菜单（折叠/展开/权限过滤）
│       │   ├── setting.ts                          # 设置（主题/布局/语言）
│       │   ├── table.ts                            # 表格配置（列宽/分页/缓存）
│       │   └── worktab.ts                          # 工作标签页
│       │
│       ├── hooks/                                  # --- 组合式 Hooks ---
│       │   ├── usePermission.ts                    # 权限判断（按钮级/演示账号拦截）
│       │   └── core/                               # 核心Hooks（表格/图表/认证/主题/布局等）
│       │
│       ├── views/                                  # --- 页面视图 ---
│       │   ├── dashboard/console/                  # 控制台仪表盘
│       │   │   ├── index.vue                       #   主页（统计卡片/在线用户/增长图表）
│       │   │   └── modules/                        #   仪表盘子模块组件
│       │   │
│       │   ├── system/                             # 系统管理
│       │   │   ├── user/index.vue                  #   用户管理（列表/搜索/封禁/编辑）
│       │   │   ├── chat/index.vue                  #   会话管理（私聊/群聊/频道Tab切换）
│       │   │   ├── report/index.vue                #   举报管理（审核/处理）
│       │   │   ├── settings/index.vue              #   系统设置（全局配置/协议/官方用户）
│       │   │   └── user-center/index.vue           #   管理员个人中心
│       │   │
│       │   ├── moment/                             # 朋友圈管理
│       │   │   ├── list/index.vue                  #   动态列表（查看/删除/审核）
│       │   │   ├── topics/index.vue                #   话题管理（增删/启用/排序）
│       │   │   └── banned-words/index.vue          #   敏感词管理（添加/等级/过滤/拦截）
│       │   │
│       │   ├── wallet/                             # 钱包管理
│       │   │   ├── user-wallets/index.vue          #   用户钱包管理（余额调整/锁定/密码重置）
│       │   │   ├── recharge/index.vue              #   充值订单审核
│       │   │   ├── withdraw/index.vue              #   提现申请审核
│       │   │   ├── transfers/index.vue             #   转账记录管理
│       │   │   ├── red-packets/index.vue           #   红包记录管理
│       │   │   └── settings/index.vue              #   钱包参数设置（币种/过期时间/费率/二维码）
│       │   │
│       │   ├── call/list/index.vue                 # 通话记录管理
│       │   │
│       │   ├── auth/                               # 认证页面
│       │   │   ├── login/index.vue                 #   管理员登录
│       │   │   ├── register/index.vue              #   注册
│       │   │   └── forget-password/index.vue       #   忘记密码
│       │   │
│       │   └── exception/                          # 异常页
│       │       ├── 403/index.vue                   #   无权限
│       │       ├── 404/index.vue                   #   页面不存在
│       │       └── 500/index.vue                   #   服务器错误
│       │
│       ├── components/                             # --- 公共组件库 ---
│       │   ├── core/base/                          # 基础组件（Logo/SVG图标/回到顶部）
│       │   ├── core/cards/                         # 卡片组件（统计/图表/进度/时间线）
│       │   ├── core/charts/                        # ECharts图表（柱状/折线/环形/雷达/K线/地图）
│       │   ├── core/forms/                         # 表单组件（搜索栏/表格按钮/Excel导入导出）
│       │   ├── core/tables/                        # 表格组件（通用表格/表头操作栏）
│       │   ├── core/layouts/                       # 布局组件（面包屑/菜单/顶栏/标签页/设置面板）
│       │   ├── core/media/                         # 媒体组件（图片裁剪/视频播放）
│       │   └── core/text-effect/                   # 文字特效（数字滚动/文字滚动/节日横幅）
│       │
│       ├── utils/                                  # --- 工具函数 ---
│       │   ├── http/                               # Axios封装（拦截器/Token注入/错误处理）
│       │   ├── storage/                            # LocalStorage封装（过期/前缀/Key管理）
│       │   ├── navigation/                         # 路由导航工具
│       │   ├── table/                              # 表格工具（配置缓存/默认值）
│       │   ├── form/                               # 表单工具（响应式/校验规则）
│       │   ├── ui/                                 # UI工具（主题动画/颜色计算/Loading）
│       │   ├── sys/                                # 系统工具（错误处理/事件总线/版本检测）
│       │   └── socket/                             # WebSocket客户端（自动重连/心跳）
│       │
│       ├── types/                                  # TypeScript 类型定义
│       ├── enums/                                  # 枚举定义
│       ├── directives/                             # 自定义指令（v-auth权限/v-ripple水波纹）
│       ├── plugins/                                # 插件（ECharts按需引入）
│       ├── locales/                                # 国际化语言包（中/英）
│       └── assets/                                 # 静态资源（样式/SVG图标）
│
│
├── assets/                                         # ===== Flutter 静态资源 =====
│   ├── emoji/lottie/                               # 120+ Lottie动画表情JSON文件
│   ├── icons/                                      # 底部导航Tab图标（普通/选中态）
│   ├── images/backgrounds/                         # 聊天背景SVG
│   ├── fonts/                                      # 自定义字体（ZiHunXinQuHei）
│   ├── sounds/                                     # 通知音效（coin.mp3/crisp.mp3/ringtone.mp3）
│   └── stickers/                                   # 贴纸（红包/转账图标）
│
├── android/                                        # Android 平台配置
├── ios/                                            # iOS 平台配置
├── macos/                                          # macOS 桌面端配置
├── windows/                                        # Windows 桌面端配置
├── linux/                                          # Linux 桌面端配置
├── web/                                            # Web 平台配置
│
├── download/                                       # App 下载引导页
│   └── index.html                                  # 下载页面（含二维码/多平台链接）
│
└── test/
    └── widget_test.dart                            # Flutter Widget 测试

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