iijicarus/user-portal-recording

user-portal-recording 镜像文档

镜像概述

user-portal-recording 是一个专为用户门户系统设计的录音服务镜像，旨在提供用户与门户交互过程中的音频数据采集、存储、管理及检索能力。该镜像可无缝集成至各类用户门户平台，支持标准化接口对接，满足***、客服、***等行业对用户交互录音的合规性要求，同时为用户行为分析和服务质量优化提供数据支持。

核心功能与特性

1. 音频录制能力

• 支持实时录制用户在门户系统中的语音交互（如语音通话、语音指令）及操作过程中的音频反馈
• 提供多种音频编码格式（如MP3、WAV），可通过配置参数调整录制质量
• 支持静音检测与自动启停录制，减少无效录音数据

2. 存储与管理

• 内置本地存储模块，支持录音文件按用户ID、时间戳分类存储
• 提供对接外部存储服务的接口（如S3兼容对象存储、FTP服务器），支持录音文件异地备份
• 支持录音文件生命周期管理，可配置自动清理过期文件策略

3. 集成与兼容性

• 提供RESTful API接口，支持与用户门户系统（如Web门户、移动端门户）通过HTTP/HTTPS协议集成
• 兼容主流用户认证机制（如JWT、OAuth2.0），确保录音数据与用户身份安全绑定
• 支持Docker Compose编排，可与门户后端服务、数据库等组件联动部署

4. 合规与安全

• 支持录音文件加密存储，保障用户音频数据隐私安全
• 提供录音元数据记录（如录制时间、用户ID、会话ID），满足审计与合规追溯需求
• 符合GDPR、PCI DSS等数据保护标准对用户音频数据的管理要求

使用场景与适用范围

典型应用场景

• 客服门户系统：录制用户与在线客服的语音对话，用于服务质量监控与纠纷处理
• 用户自助服务平台：记录用户通过语音指令操作门户的过程，辅助优化自助服务流程
• 服务门户：满足监管要求，对用户理财产品咨询、交易确认等环节进行合规录音
• 咨询门户：录制医患在线咨询语音，用于纠纷举证与诊疗过程复盘

适用行业

• ***（银行、证券、保险）
• 电信与客服
• ***健康
• 电子商务（售后服务）
• ***公共服务

使用方法与配置说明

基础部署（Docker Run）

通过以下命令快速启动录音服务容器：

bash
docker run -d \
  --name user-portal-recording \
  -p 8080:8080 \
  -v /local/recording/storage:/app/storage \
  -e RECORDING_FORMAT=mp3 \
  -e STORAGE_TYPE=local \
  -e AUTH_ENABLED=true \
  -e JWT_SECRET=your_jwt_secret \
  user-portal-recording:latest

参数说明：

• -p 8080:8080：映射容器内服务端口（默认8080）至主机
• -v /local/recording/storage:/app/storage：挂载本地目录作为录音文件存储路径
• 环境变量（-e）配置见下文详细说明

环境变量配置

Docker Compose 示例

yaml
version: '3.8'
services:
  user-portal-recording:
    image: user-portal-recording:latest
    container_name: user-portal-recording
    ports:
      - "8080:8080"
    volumes:
      - ./recording-storage:/app/storage
    environment:
      - RECORDING_FORMAT=wav
      - STORAGE_TYPE=local
      - AUTH_ENABLED=true
      - JWT_SECRET=your_secure_jwt_key_here
      - RECORDING_QUALITY=192k
    restart: unless-stopped

集成接口示例（RESTful API）

开始录音

http
POST /api/v1/recordings/start
Headers:
  Authorization: Bearer {jwt_token}
Body:
{
  "userId": "user123",
  "sessionId": "session_456",
  "metadata": {"portalPage": "customer_service", "interactionType": "voice_call"}
}

停止录音

http
POST /api/v1/recordings/stop
Headers:
  Authorization: Bearer {jwt_token}
Body:
{
  "recordingId": "rec_789"  // 从开始录音接口返回获取
}

注意事项

• 生产环境部署时，建议使用外部存储服务（如S3）替代本地存储，提高数据可靠性
• 需确保JWT密钥等敏感配置通过安全方式注入（如Docker Secrets、Kubernetes Secrets）
• 录音文件存储需符合当地数据保护***，对用户音频数据进行脱敏或加密处理
• 高并发场景下，建议通过水平扩展容器实例并配置负载均衡提升服务容量