# 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 会话。网页客户端通过系统浏览器打开第三方链接。 ## 目录设计 ```text 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 ``` 管理端计划使用独立域名、凭据和数据库角色。指标聚合使用投递计数、调用状态和基础设施容量。管理角色只需接触运营元数据。