# loan_docker

**Repository Path**: kinggen_tt/loan_docker

## Basic Information

- **Project Name**: loan_docker
- **Description**: 可视化统计借贷信息
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-16
- **Last Updated**: 2025-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# loan_docker

#### 介绍
可视化统计借贷信息

#### 软件架构
软件架构说明
使用 3个docker 
1. 数据处理服务 (loan-processor)
- 技术栈：Python + Pandas + FastAPI
- 功能：
    - 解析 CSV/Excel 借贷数据
    - 计算关键指标（总金额、逾期率、利率分布等）
    - 生成结构化 JSON 输出
Dockerfile：

```dockerfile
FROM python:3.9-slim
RUN pip install pandas fastapi uvicorn
COPY app.py /app/
CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "8000"]
```

2. 数据库服务 (loan-db)
- 技术栈：PostgreSQL + TimescaleDB（时间序列扩展）
- 功能：
    - 存储原始借贷数据和统计结果
    - 支持时间序列分析（如每日借贷趋势）
    - Docker Compose 配置：
```yaml
services:
  loan-db:
    image: timescale/timescaledb:latest-pg14
    environment:
      POSTGRES_USER: loan_admin
      POSTGRES_PASSWORD: secure_password
      POSTGRES_DB: loan_data
    volumes:
      - loan-db-data:/var/lib/postgresql/data
```

3. 可视化服务 (loan-dashboard)
- 技术栈：Grafana + Prometheus
- 功能：
    - 实时展示借贷统计图表（折线图、热力图、甘特图）
    - 支持邮件 / 短信预警（如逾期率突增）
Dockerfile：
```dockerfile
FROM grafana/grafana:latest
COPY dashboards/ /etc/grafana/provisioning/dashboards/
```


#### 安装教程

1.  win系统安装wsl 2.0
2.  运行 ubuntu 22.04
```
PS C:\Users\user> wsl -l -v
  NAME            STATE           VERSION
* Ubuntu-20.04    Stopped         2      
  Ubuntu-22.04    Stopped         2      
  kali-linux      Stopped         2      
PS C:\Users\user> wsl -d  Ubuntu-22.04
```
3.  下载代码，并进入目录
```
git clone https://gitee.com/kinggen_tt/loan_docker.git
cd loan_docker
docker compose up -d
```


#### 使用说明

1. 编写 loans.csv 并将其更新到库中, loans.csv 的格式按照 loans_20250401.csv 格式编写。
```csv
loan_id,loan_amount,borrower_name,loan_date,repayment_date,repayment_date_of_m,repayment_times,repayment_loan_once
1,15100.00,美团,2024-12-26,2025-02-01,01,12,1423.47
```
```
curl -X POST "http://localhost:8000/upload" -H "Content-Type: multipart/form-data" -F "file=@loans.csv"
```
2. 打开grafana
在浏览器中输入 "http://localhost:3000" 回车，既可以看到登入界面。
- 账号：admin
- 密码：grafana_admin

3. 配置连接数据库
点击《连接》--》 《 数据源》  选择《postgresql》 
- Host URL : loan-db:5432
- Database name : loan_data
- Username: loan_admin
- Password: secure_password
- TLS/SSL Mode: disable


#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)