cloudnativedata/bank-account-rest-service

银行账户REST服务镜像文档

镜像概述

本镜像是一个基于https://spring.io/projects/spring-boot%E6%A1%86%E6%9E%B6%E5%BC%80%E5%8F%91%E7%9A%84REST%E6%9C%8D%E5%8A%A1%EF%BC%8C%E5%AE%9E%E7%8E%B0%E4%BA%86Open Bank Project 银行账户服务接口的基本读写功能，用于处理银行账户相关的API请求。

核心功能与特性

• 基于Spring Boot构建，提供RESTful API接口
• 遵循Open Bank Project OBPv4.0.0账户服务规范
• 支持账户创建(POST)和账户查询(GET)操作
• 依赖Apache Geode/GemFire分布式集群作为数据存储
• 支持本地环境和Kubernetes环境部署

使用场景

适用于需要集成Open Bank Project账户服务接口的***科技应用，可作为银行账户管理的后端服务组件，支持账户信息的存储与查询操作。

部署与配置说明

环境依赖

• Apache Geode或GemFire集群（用于数据存储）
• JDK 8+环境
• Kubernetes集群（如采用容器化部署）

本地环境部署

1. 部署Apache Geode集群

参考https://geode.apache.org/docs/guide/114/getting_started/15_minute_quickstart_gfsh.html%E5%AE%89%E8%A3%85%E5%B9%B6%E5%90%AF%E5%8A%A8Geode%E9%9B%86%E7%BE%A4%E3%80%82

2. 创建数据区域

使用https://geode.apache.org/docs/guide/114/tools_modules/gfsh/chapter_overview.html%E8%BF%9E%E6%8E%A5%E9%9B%86%E7%BE%A4%E5%B9%B6%E5%88%9B%E5%BB%BA%E5%BF%85%E8%A6%81%E7%9A%84%E6%95%B0%E6%8D%AE%E5%8C%BA%E5%9F%9F%EF%BC%9A

shell
create region --name=BankAccount --type=PARTITION

3. 启动服务

（此处需补充服务启动命令，原文档未提供，可根据Spring Boot应用常规启动方式执行）

Kubernetes环境部署

1. 部署GemFire集群

安装并部署GemFire集群（具体步骤需参考GemFire Kubernetes部署文档）。

2. 创建数据区域

执行以下命令在GemFire集群中创建数据区域：

shell
kubectl exec gemfire1-locator-0 -- gfsh -e "connect" -e "create region --name=BankAccount --type=PARTITION"

3. 部署服务

shell
kubectl apply -f cloud/k8/apps/account-rest-service

4. 删除服务（如需）

shell
kubectl delete -f cloud/k8/apps/account-rest-service

5. 端口转发

将服务端口映射到本地：

shell
kubectl port-forward deployments/account-rest-service 4001:4001

接口测试

创建账户（POST）

shell
curl -X 'POST' \
  'http://localhost:4001/obp/v4.0.0/banks/gh.29.uk/accounts' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{  
  "user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",  
  "label":"My Account",  
  "product_code":"AC",  
  "balance":{    "currency":"EUR",    "amount":"0"  },  
  "branch_id":"DERBY6",  
  "account_routings":[{    "scheme":"AccountNumber",    "address":"4930396"  }]}'

查询账户（GET）

shell
curl -X 'GET' \
  'http://localhost:4001/obp/v4.0.0/banks/gh.29.uk/accounts/20211130162851787-571565789/account' \
  -H 'accept: */*';echo

注：查询时需将20211130162851787-571565789替换为实际创建的账户ID