工作手机部署文档

后端 · 前端 · APK 构建 · 版本管理 · SSO 接入

一、系统入口

项	地址
管理后台（前端）	https://hr.guobiao.xin/work-phone/
后端 API	https://hr.guobiao.xin/work-phone-api/api/v1/
APK 下载	https://hr.guobiao.xin/work-phone/download
APK 源码	/opt/work-phone-system/android/（服务器可复现构建）

二、服务架构

/opt/work-phone-system/
  ├── backend/          # Python FastAPI 后端 (systemd: work-phone, 端口 8200)
  ├── frontend-src/     # Vue3 + Vite 前端源码
  ├── frontend/dist/    # 构建产物 (nginx 托管)
  ├── android/          # Android APK 工程 (Kotlin, v1.2.0)
  └── recordings/       # 通话录音文件

三、APK 构建与发布

# 环境: Android SDK /opt/android-sdk + Gradle 8.9 /opt/gradle

# 一条龙发布 (构建→签名→部署)
bash /opt/scripts/wp_apk_publish.sh

# 签名密钥
/opt/keystores/guobiao-workphone.jks
(alias: guobiao-workphone, 30年有效期, 密码见密码管理清单)

# 新版本发布后, 更新后端版本配置
GET/PUT /api/v1/app/version/config

四、版本管理机制

接口	说明
GET /app/version?current_version=1.0.0	版本检查，返回 needs_update / force_update / 下载地址
GET /app/version/config	管理员查看当前版本配置
PUT /app/version/config	管理员发布新版本

五、SSO 统一认证

已接入郭标统一认证（SSO）：登录优先走 auth.guobiao.xin/sso/login，后端校验 SSO 签发的 JWT（共享密钥 GUOBIAO_SSO_SECRET），同一账号密码全平台通用。

六、核心能力

设备管理：注册 / 心跳 / 在线状态 / 品牌 IMEI
MDM：远程锁机（lock）/ 数据擦除（wipe）/ 更新策略
采集：通话、短信、联系人、位置、微信消息、应用使用、录音
合规：知情同意记录 / 数据删除请求（个保法）
AI：话术推荐 / 客户画像 / SOP 规划 / 销售周报（千问 qwen-plus）
安全：手机号加密 + 查看审批流 / 注册防刷 / 审计日志

七、备份

每日 2:30 全量备份（含工作手机库 + 录音 + APK）
每日 3:00 工作手机专项备份 /opt/scripts/wp_backup.sh
备份中心: 管理后台 → 备份中心 (总览/下载/日志)