壹遇YI YU
项目架构

壹遇技术架构与核心功能

用户客户端、运营管理端与统一业务服务共同支撑语音社交、即时消息和服务交易。以下按当前源码与本机测试记录整理。

01 / 架构

四层组成，一套业务体系

客户端与管理端通过 HTTPS 接入 Go 服务；消息与房间状态使用独立 WebSocket 通道，房间音频接入 Agora RTC。

01 用户客户端
Dart + Flutter

Android、iOS 共用业务代码；当前另有 macOS 本地测试版。使用 GetX、Provider、Dio 组织路由、状态和网络请求。

02 Web 管理端
TypeScript + Vue 3

Vite 构建，Element Plus 提供管理界面组件；Pinia 与 Vue Router 管理状态、菜单和路由。

03 统一服务端
Go 1.22 + Gin + GORM

提供客户端与管理端 REST API、即时消息和房间 WebSocket、业务规则及后台任务。

04 数据与外部服务
MySQL 8 + Redis 7

存储业务数据与临时状态；语音、短信、支付和对象存储需在目标环境配置相应第三方服务。

Flutter 客户端 / Vue 管理端 HTTPS REST + WebSocket Go 服务 MySQL / Redis / 第三方服务

当前官方网站由 HTML、CSS 和 JavaScript 构成，可作为独立静态站点部署。

02 / 用户端

客户端核心功能

以下功能在移动端源码中有页面或业务调用链；具体账号权限、数据和外部服务仍取决于运行环境。

账号与发现

  • 手机号验证码、密码登录和个人资料
  • 首页推荐、分类浏览与用户、房间、服务搜索
  • 关注、好友及个人设置

语聊房间

  • 房间浏览、进入、创建与关注
  • 上麦、下麦、静音、成员与麦位管理
  • 房间礼物、背景、音乐及实时状态

即时消息

  • 单聊文字、图片和语音消息
  • 会话、历史记录、未读与已读状态
  • 置顶、免打扰和离线消息同步

广场社区

  • 浏览、发布图文动态与话题
  • 点赞、评论、回复及动态通知
  • 个人动态和可见范围管理

技能与服务

  • 服务分类、服务者资料与技能详情
  • 技能申请、派单与接单入口
  • 服务订单、状态查询和售后流程

钱包与互动

  • 金币、余额、收益和交易记录
  • 礼物、道具商城、背包与穿戴
  • 充值和提现流程依赖渠道配置与审核

公会与俱乐部

  • 公会申请、成员与分成管理
  • 俱乐部浏览、创建和服务选择
  • 俱乐部订单及状态查询

服务与安全

  • 客服、协议、版本检查与通知
  • 实名认证、拉黑和账号安全设置
  • 图片、视频、语音等媒体上传入口
03 / 运营端

管理后台核心功能

运营人员使用独立 Web 后台，按角色和菜单权限访问管理功能。

用户与内容

  • 用户、主播/服务者及账号状态管理
  • 动态、文章、广告、素材与通知管理
  • 举报、审核和运营配置入口

房间与服务

  • 房间、技能分类、服务资料管理
  • 技能申请和公会申请审核
  • 俱乐部、礼物及场景道具维护

订单与财务

  • 服务订单、充值、退款和资金流水
  • 提现审核、支付配置与统计查询
  • 金币套餐与推广规则管理

平台与权限

  • 工作台、页面装修和渠道设置
  • 管理员、角色、菜单和操作日志
  • 短信、存储、RTC 等系统配置
04 / 服务端

统一服务端的关键能力

Go 服务按业务模块组织客户端 API、管理 API 和实时通信，统一处理身份、数据与外部服务接入。

业务接口

  • 账号、房间、动态、技能、订单和钱包接口
  • 管理端用户、内容、审核、财务及配置接口
  • 文件上传、静态资源与统一响应处理

实时通信

  • 单聊消息与房间状态使用独立 WebSocket 通道
  • 会话、历史消息与未读数由接口配合查询
  • 消息补拉扩展需完成目标数据库迁移后启用

身份与运营

  • 用户端和管理端 JWT 登录态隔离
  • 管理端角色权限与写操作日志
  • 订单超时、道具到期和空闲房间定时处理

外部服务接入

  • Agora 房间音频 Token 与客户端 RTC 接入
  • 短信、支付、退款和文件存储的服务端代码
  • 正式可用性依赖账号、密钥、回调与目标环境联调
05 / 验证状态

各端的当前证据与待验收项

页面或接口存在，表示源码覆盖；能否在正式环境完成业务，需要按平台和账号继续验证。

Android / iOS

当前证据

共享 Flutter 移动端源码，官网展示了 Android 真机的非登录界面。

仍需验证

iOS 设备流程、第三方音视频、支付与真实账号业务闭环。

macOS 测试版

当前证据

本机检查过发现、进出房、搜索导航、广场和钱包只读界面。

仍需验证

真实消息收发、音频设备、通知、交易及跨端同步。

Windows 客户端

当前证据

Flutter 工程包含 Windows 目标与桌面页面代码。

仍需验证

Windows 构建安装、设备兼容、完整桌面流程与签名分发。

Web 管理端

当前证据

Vue 页面与 Go 管理接口覆盖运营、审核和配置业务。

仍需验证

目标环境的角色权限、审核流程和资金操作。

Go 服务端

当前证据

REST、WebSocket、权限和定时任务均有源码实现。

仍需验证

目标数据库迁移、真实支付回调与多端业务联调。

依据：当前项目源码及 2026-10-09 macOS 本机功能测试记录。第三方服务和正式发布状态会随部署环境变化。

客户端下载

按设备查看演示下载入口

下载页提供项目方的安卓、苹果和 PC 端演示包汇总地址；macOS 测试包不在本站分发。

查看下载方式