# CPH-Server

**Repository Path**: cctvbtx/cph-server

## Basic Information

- **Project Name**: CPH-Server
- **Description**: 呼叫平台助手，提供对VOS外部接口的支持，目前主要是账户费用管理，费用数据报表，服务端
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-08-20
- **Last Updated**: 2025-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Call Platform Helper Server - CPH

## CPH 呼叫平台助手，提供VOS三方接口的支持，提供账户管理、优化金额管理、数据报表等功能

``` 
1.可动态增加多个VOS服务器

2.对所有VOS账户进行充值、部分信息修改

3.提供账户组管理，可优化多账户的金额管理，缓解费率问题建的多个账号费用管理麻烦的问题

4.提供账户费用报表以及网关费用报表

看情况可能持续更新其他功能
账号/网关接通率查询、费用/接通率/服务器状态预警推送、创建账号、创建落地/对接网关 ......

``` 

### 阉割部分功能

``` 
完全版系统CPC除了VOS的管理相关功能还有云平台账号管理、外呼机器人、预测式外呼、集成电话条等呼叫中心相关功能
```

``` 
原版本用户管理为云服务提供的统一登陆，该系统使用简化版本
简化版本用户管理，使用 reources/user/accounts.txt 管理账户信息
登陆采用的JwtToken，相关的安全性还是很高的，仅简化了数据库
``` 

``` 
权限方面，去除了接口权限，仅保留了数据权限和页面权限
菜单权限 cn.italkcloud.cph.constants.enums.PermViewEnum
数据权限 cn.italkcloud.cph.constants.enums.PermDataEnum
``` 

``` 
去除缓存中间价Redis，减少中间件使用，降低系统运行标准
如果项换层Redis等中间间可以查看修改 cn.italkcloud.cph.utils.CacheUtil
``` 

### 配置使用

``` 
推荐使用版本
Java 11
MySQL 8.0.38
``` 

``` 
数据库文件为 CPH.sql
``` 

``` 
增加环境变量时注意修改日志文件 logback-cph.xml
``` 

``` 
环境配置文件 application-*.yml 只需要配置运行端口、MySQL、VOS费用同步时间、JWTToken加密密钥

更换JWTToken加密密钥可通过 src/test/cn.italkcloud.cph.helper.UserHelperDebug.loadUser() 进行测试
```

### 编译及运行

``` bash
# 执行Maven构建编译
mvn clean install -Dmaven.test.skip=true

# 编译后项目文件
target/CPH.jar

# 清理端口占用 
# port：根据 application-*.yml 中 server.port，确保端口未被占用
sudo netstat -nlp | grep -q :${port} && sudo netstat -nlp | grep :${port} | awk '{print $7}' | awk -F '[ / ]' '{print $1}' | xargs sudo kill -9

# 运行项目 
# active：启用的配置文件环境变量名 application-*.yml   
# pathFolder：项目文件的绝对路径（例 /usr/local/CPH/）
sudo nohup java -Dspring.profiles.active=${active} -jar CPH.jar > ${pathFolder}nohup.out 2>&1 & exit & disown
```