# flask-app-mock

**Repository Path**: panc-test/flask-app-mock

## Basic Information

- **Project Name**: flask-app-mock
- **Description**: 使用flask+python搭建接口mock
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-23
- **Last Updated**: 2025-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 一、项目介绍：  
使用Python+flask框架搭建一套接口mock服务，模拟资方接口返回，以实现放款和还款功能。  
生成项目依赖包：pip freeze > requirements.txt    
安装项目依赖包：pip install -r requirements.txt  

### 二、项目结构（分层设计+单一性原则+易拓展+可测性）:   
flask-mock/  
├── app/                    # 主应用目录  
│   ├── db/                 # 数据库连接池  
│   ├── routes/             # 路由模块,使用Blueprint来组织。  
│   ├── encryption/         # 加密模块,存放加解密相关的函数。  
│   ├── services/           # 业务逻辑模块,将路由和业务逻辑分离，便于维护和测试。  
│   ├── ├── utils/          # 业务模块的专属工具，例如还款计划处理等  
│   ├── utils/              # 通用工具,例如封装http请求，日志设置、配置管理等。   
│   ├── config/             # 配置文件  
│   ├── __init__.py         # 应用工厂  
├── logs/                   # 日志目录  
├── tests/                  # 测试用例  
├── requirements.txt        # 项目依赖  
├── run.py                  # 启动脚本  
└── README.md               # 项目说明

### 三、MOCK规则：  
银行卡预留手机尾号0，授信处理中  
银行卡预留手机尾号1，授信失败  
银行卡预留手机尾号9，用信失败    
身份证最后一位0，还款处理中   
身份证最后一位1，9，还款失败

### 四、项目部署：  
健康检查接口（get请求):/health

项目地址: xxxxxxxxxxxxxx

Jenkins: xxxxxxxxxxxxxx

项目已经集成argus日志平台，日志关键字: serviceName:funder-mock

测试环境（项目部署地址）: xxxxxxxxxxx

项目部署路径: /usr/local/services/funder-mock  

python解释器路径: /usr/local/python3.12/lib/python3.12/site-packages  

启动run.py脚本: /usr/local/python3.12/bin/python3.12 /usr/local/services/funder-mock/run.py 

### 五、登录服务器查看mock日志：  
1、登录堡垒机  

2、登录主机IP（没有权限的自己找运维申请）  

3、切换日志目录  
cd /usr/local/services/funder-mock/logs  

4、查看日志  
cat app.log  
more app.log | grep 日志关键字

### 六、新渠道接入流程（中信消金为例）：  
1、对接新渠道的加解密接口，编写加密和解密模块：encryption/zhxxj_encrypt.py  
2、编写新渠道的路由：routes/zhxxj_route.py  
3、编写新渠道的业务逻辑：services/zhxxj_service.py  
4、在启动程序run.py文件中注册新渠道的路由蓝图。  
5、本地启动应用，使用postman测试新渠道mock接口。  
6、部署到测试环境，修改ops配置中的接口请求地址和公私钥。代码提交后会自动调用钩子函数触发Jenkins部署。  
7、本地调用资金平台的授信和用信申请接口，测试授信和用信流程。  
8、从app端发起放款全流程测试。