基于 ASR 语音转写 + LLM AI 评分的自动化催收通话质检平台，支持录音上传、自动转写、智能评分与报告导出。
- 🎙️ 自动转写：FunASR 语音识别，支持说话人分离与时间戳，新增通过不同声道区分说话人身份
- 🤖 AI 评分：LLM 智能分析，根据规则描述自动打分
- 📋 规则管理：版本化管理，支持历史回滚与复合评分
- 📊 统计分析：多维度评分统计与可视化报表
- 📄 报告导出：一键生成 Word 格式评分报告
- ☁️ 对象存储：MinIO / 腾讯云 COS 录音文件管理
- ⚙️ 系统设置：支持在界面配置 ASR、LLM、OSS 等全部参数，无需手动修改配置文件
| 层级 | 技术选型 |
|---|---|
| 后端 | FastAPI + SQLAlchemy 2.0 (async) |
| 前端 | Vue 3 + Element Plus + ECharts |
| 数据库 | MySQL (TDSQL) |
| 对象存储 | MinIO / 腾讯云 COS |
| 语音转写 | FunASR API |
| AI评分 | LLM API (MiniMax 等) |
| 部署 | Docker + Docker Compose + Nginx |
┌─────────────────────────────────────────────────────────┐
│ 客户端层 │
│ Vue 3 + Element Plus + ECharts │
└─────────────────────────┬───────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ Nginx 网关层 │
│ (负载均衡 / 静态资源 / SSL) │
└─────────────────────────┬───────────────────────────────┘
│
┌───────────────┼───────────────┐
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 后端服务 │ │ ASR 服务 │ │ 数据库 │
│ FastAPI │ │ FunASR API │ │ MySQL/TDSQL │
│ + SQLAlchemy │ │ │ │ │
└──────────────┘ └──────────────┘ └──────────────┘
│
▼
┌──────────────────┐
│ 对象存储 │
│ MinIO / COS │
└──────────────────┘
- Docker & Docker Compose
# 1. 复制编排模板和示例配置
cp docker/docker-compose-template.yml docker/docker-compose.yml
cp docker/.env.example docker/.env
# 2. 编辑 docker/.env 填入实际配置
# 特别注意以下敏感信息不要提交到代码仓库：
# - DB_PASSWORD（数据库密码）
# - ADMIN_PASSWORD（管理后台密码）
# - OSS_SECRET_KEY（对象存储密钥）
# - OA_SECRET_KEY（OA认证密钥）
# - DB_SECRET_KEY（加密密钥，用于解密 DB_PASSWORD）
# 生产环境建议通过环境变量注入而非写在 .env 文件中
# 3. 启动服务 (首次构建较慢)
cd docker
docker-compose up -d --build
# 4. 访问系统
# 前端: http://localhost:8888
# 后端API: http://localhost:8000
# API文档: http://localhost:8000/docs# 查看服务状态
docker-compose -f docker/docker-compose.yml ps
# 查看后端日志
docker-compose -f docker/docker-compose.yml logs -f backend
# 重启服务
docker-compose -f docker/docker-compose.yml restart
# 停止并删除容器
docker-compose -f docker/docker-compose.yml downVoxAudit/
├── backend/ # 后端服务
│ ├── api/ # API 路由
│ ├── core/ # 核心模块（配置/数据库/初始化）
│ ├── models/ # 数据模型
│ ├── schemas/ # Pydantic 模型
│ ├── services/ # 业务服务（AI评分/ASR/OSS）
│ └── main.py # 应用入口
├── frontend/ # 前端应用
│ ├── src/
│ │ ├── api/ # Axios 封装
│ │ ├── views/ # 页面组件
│ │ └── router/ # 路由配置
│ └── package.json
├── docker/ # Docker 配置
│ ├── docker-compose-template.yml # 编排模板（需复制为 docker-compose.yml）
│ ├── docker-compose.yml # 编排配置（由模板复制）
│ ├── Dockerfile.backend # 后端镜像
│ ├── Dockerfile.frontend # 前端镜像 (Nginx)
│ ├── nginx.conf # Nginx 配置
│ └── .env.example # 环境变量示例
└── docs/ # 设计文档
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ 上传录音 │───▶│ 存储录音 │───▶│ ASR转写 │───▶│ AI评分 │───▶│ 完成存档 │
└──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
uploading uploaded transcribing scoring scored
│
▼
transcribed
核心配置项（详见 docker/.env.example）：
| 变量 | 说明 |
|---|---|
DB_HOST/DB_PORT/DB_USER/DB_PASSWORD |
数据库连接 |
OSS_ENDPOINT/OSS_ACCESS_KEY/OSS_SECRET_KEY |
对象存储 |
OA_BASE_URL/OA_SECRET_KEY |
OA 认证配置 |
Q: ASR 转写失败怎么排查？
A: 检查 ASR_API_URL 配置是否可达，确认录音文件格式为 WAV/MP3 且编码正确。
Q: AI 评分返回空结果？
A: 检查 LLM_API_KEY 是否有效，确认规则描述是否清晰完整。
Q: 前端无法上传录音？
A: 检查 Nginx 配置的 client_max_body_size，默认最大支持 100MB 文件上传。
本项目采用 MIT License 开源。
欢迎提交 Issue 和 Pull Request！
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request