# bank_fie_sync

**Repository Path**: pigTear/bank_fie_sync

## Basic Information

- **Project Name**: bank_fie_sync
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-13
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# bank-file-sync 银行文件同步与下载服务

每日定时从银行 SFTP（私钥认证）拉取 zip + RSA 签名文件，验签后按业务日期落盘，
并提供 REST 接口供 ERP 按日期查询下载。

## 环境要求

- JDK 1.8+ / Maven 3.6+
- Spring Boot 2.7.18

## 启动

```bash
mvn spring-boot:run -Dspring-boot.run.profiles=dev
```

## 配置

见 `application.yml`，关键项：
- `bank.sftp.*`：SFTP 连接、私钥、远程目录、文件名正则、定时 cron
- `bank.rsa.*`：验签公钥、算法、签名编码
- `bank.storage.*`：本地存储与隔离目录

上线前需放入：`config/bank_sftp_key`（SFTP 私钥）、`config/bank_public_key.pem`（银行公钥），
并按真实文件名调整 `file-name-regex`。

## 接口

| 接口 | 说明 |
|------|------|
| GET /api/files?date=2026-08-12 | 查询某日期文件列表 |
| GET /api/files/{id}/download | 下载 zip（id 见列表返回） |
| POST /api/sync?date=2026-08-12 | 手动触发同步（补拉） |
| GET /api/health | 健康检查 |

## 手动验证流程

1. 启动服务（dev profile）
2. 配置临时 SFTP（或用本地 SFTP 服务），放置样例 `对账单_20260812.zip` + `.sig`
3. 调 `POST /api/sync?date=2026-08-12` 验证同步
4. 调 `GET /api/files?date=2026-08-12` 与 download 验证下载
5. 确认无误后，将 `sync-cron` 从 `-` 改回正式 cron，切换 prod 配置