Files
XHChat/docs/architecture.md

2.6 KiB

XHChat 技术可行性与总体架构

Windows 和 Web 可共用 Vue 3、TypeScript、Pinia 和 Vue Router。Go 服务以模块化单体起步,按身份、设备、联系人、投递、群组、文件、信令、动态与管理划定接口。PostgreSQL 保存权威状态,Redis 负责限流、短期票据和实时事件分发,S3 兼容存储承载附件密文。服务按部署量拆分时保持相同的 REST 和 WebSocket 契约。桌面端使用随包发布的受信任应用资源,网页通过 Nginx 与 API 同源部署。Android、iOS 和其他桌面系统使用同一协议,各自实现平台密钥存储。

功能交付按需求的八阶段推进。阶段一优先闭环用户名注册、密码登录、独立设备身份、设备列表与撤销、WebSocket 会话及容器部署。阶段二到三交付加密私聊、附件、离线投递、加密群组、可信设备授权和备份。阶段四交付 WebRTC、TURN、SFU 与媒体 E2EE。阶段五交付内置浏览器。阶段六到八交付社交、扩展生态、独立管理后台完善、发布与运维。短信、邮件、支付和推送使用各部署方的凭据,验收使用实际接通的服务。

端到端加密的可行性取决于同一协议库在浏览器和桌面的兼容性,以及设备认证、密钥持久化和撤销的集成验证。音视频需要验证目标浏览器的编码帧变换支持及跨网络 TURN 转发。普通网页浏览与通讯端的密钥和会话数据使用不同 Electron 会话。网页客户端通过系统浏览器打开第三方链接。

目录设计

XHChat/
  Desktop/                       Electron 主进程、preload、打包、独立浏览器
  web/                           Vue 客户端与可打包的渲染层
  Android/                       后续 Android 客户端
  server/
    cmd/api/                     API 入口
    internal/config/             环境配置
    internal/account/            账号、会话、设备身份
    internal/httpapi/            HTTP 和 WebSocket 边界
    internal/database/           迁移与连接
    internal/{contacts,delivery,groups,files,calls,social,admin}/   后续模块
  admin/                         独立管理前端
  deploy/                        Nginx、TLS、TURN、SFU、备份恢复
  tests/                         双端集成、隔离和验收脚本
  docs/                          API、数据库、安全设计与验收记录
  docker-compose.yml

管理端计划使用独立域名、凭据和数据库角色。指标聚合使用投递计数、调用状态和基础设施容量。管理角色只需接触运营元数据。